Skip to content

Commit

Permalink
feat: How_to_Guides: Add section on Y2K38
Browse files Browse the repository at this point in the history
Y2K38 issue has been fixed in Scarthgap, but is still present in
Kirkstone, and hence also in Kirkstone images of AM335x and AM437x.
Since 9.3 release is going to be a Kirkstone one, add a How_to_Guide
section of the presence of this issue, and some solutions on how to
deal with it.

Signed-off-by: Suhaas Joshi <[email protected]>
  • Loading branch information
jsuhaas22 committed Nov 26, 2024
1 parent 3fd6c25 commit 7bc1e97
Show file tree
Hide file tree
Showing 4 changed files with 47 additions and 0 deletions.
1 change: 1 addition & 0 deletions configs/AM335X/AM335X_linux_toc.txt
Original file line number Diff line number Diff line change
Expand Up @@ -143,6 +143,7 @@ linux/How_to_Guides/Target/Processor_SDK_Linux_File_System_Optimization_Customiz
linux/How_to_Guides/Target/How_to_add_a_JVM
linux/How_to_Guides/Target/How_to_use_a_Mouse_instead_of_the_Touchscreen_with_Matrix
linux/How_to_Guides/Target/Update_U-Boot_Environment_Variables_stored_in_SPI_Flash_from_Linux
linux/How_to_Guides/Target/How_to_fix_y2k38
linux/How_to_Guides/Target/How_to_Change_dtb_File
linux/How_to_Guides/Target/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux
linux/How_to_Guides/Target/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card
Expand Down
1 change: 1 addition & 0 deletions configs/AM437X/AM437X_linux_toc.txt
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,7 @@ linux/How_to_Guides/Target/How_to_add_a_JVM
linux/How_to_Guides/Target/How_to_use_a_Mouse_instead_of_the_Touchscreen_with_Matrix
linux/How_to_Guides/Target/Update_U-Boot_Environment_Variables_stored_in_SPI_Flash_from_Linux
linux/How_to_Guides/Target/How_to_Change_dtb_File
linux/How_to_Guides/Target/How_to_fix_y2k38
linux/How_to_Guides_Hardware_Setup_with_CCS
linux/How_to_Guides/Hardware_Setup_with_CCS/EVMK2H_Hardware_Setup
linux/How_to_Guides_Board_Port
Expand Down
44 changes: 44 additions & 0 deletions source/linux/How_to_Guides/Target/How_to_fix_y2k38.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
.. include:: /_replacevars.rst

How to Fix Y2K38 Issue
======================

What is the Y2K38 Issue?
------------------------

The Y2K38 issue is a bug which disallows a date from exceeding 03:14:07 UTC on January 19, 2038, on 32-bit systems. This
is because the structures used to store the date experience an integer overflow when the date is set beyond the mentioned
one. This causes the system to crash.
For more information, see: https://en.wikipedia.org/wiki/Year_2038_problem

There are new data structures that are used on 32-bit systems to store date/time in longer fields, thereby avoiding the
overflow and the crash. However, since setting and displaying date/time uses multiple software components (such as the
kernel, glibc etc), **all** code on a filesystem must be Y2K38-compliant (i.e. all code must be using the new data
structures and functions) for the filesystem to be Y2K38-friendly. If any piece of software uses the older structures
and functions, it makes the whole filesystem vulnerable.

To understand how the problem was fixed in Scarthgap filesystem, refer:
https://static.sched.com/hosted_files/osseu2024/8b/EOSS%20Vienna%202024%20-%20Surviving%20Y2038.pdf

Building a Y2K38-friendly Image
-------------------------------

In SDK 9.3, TI's 32-bit platforms are still based on Kirkstone filesystem, which is NOT Y2K38-friendly. The Y2K38 issue
is fixed in OE-core Scarthgap, on which the next release will be based.

Until then, if a Y2K38-friendly filesystem is required, obtain a :file:`tisdk-thinlinux-image` from the latest
:file:`cicd.scarthgap.x` link from latest `cicd.scarthgap.x`:

.. ifconfig:: CONFIG_part_variant in ('AM335X')

https://software-dl.ti.com/cicd-report/linux/index.html?section=platform&platform=am335x

.. ifconfig:: CONFIG_part_variant in ('AM437X')

https://software-dl.ti.com/cicd-report/linux/index.html?section=platform&platform=am437x

Unlike the :file:`tisdk-default-image`, this image is based on the 6.6 Kernel and Scarthgap filesystem, and
thus has the Y2K38 issue fixed.

To build a Y2K38-friendly image on the 6.6 Kernel and Scarthgap filesystem baseline, follow the "Build Instructions"
section present in the above link.
1 change: 1 addition & 0 deletions source/linux/How_to_Guides_Target.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,3 +19,4 @@ Target
How_to_Guides/Target/How_to_Use_K3Conf_Tool
How_to_Guides/Target/How_to_Tune_Real_Time_Linux
How_to_Guides/Target/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card
How_to_Guides/Target/How_to_fix_y2k38

0 comments on commit 7bc1e97

Please sign in to comment.