-
Notifications
You must be signed in to change notification settings - Fork 33
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat: How_to_Guides: Add section on Y2K38
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
Showing
4 changed files
with
47 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters