Bug 54571 - Kconfig doc correction: RTC can be in local timezone.
Summary: Kconfig doc correction: RTC can be in local timezone.
Status: NEW
Alias: None
Product: Timers
Classification: Unclassified
Component: Realtime Clock (show other bugs)
Hardware: All Linux
: P1 low
Assignee: timers_realtime-clock
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-02-28 04:26 UTC by teika kazura
Modified: 2013-02-28 04:26 UTC (History)
0 users

See Also:
Kernel Version:
Subsystem:
Regression: No
Bisected commit-id:


Attachments

Description teika kazura 2013-02-28 04:26:53 UTC
1. Main issue.

The Kconfig doc for RTC_HCTOSYS_DEVICE says the RTC should be in UTC, but it can be in the local timezone, at least for most practical uses. So an explanation like this should be added: "In boots, the kernel interprets the date as UTC. If the device is in a local timezone, the timezone info should be set to the kernel before mounting any writable filesystems. Resuming is always correct independent of the timezone." (Sorry, I only know x86/amd64 personal desktops, and can show only the direction of fix.)

I'd like this fix since RTC_HCTOSYS=y is very useful, including resumes from s2ram and s2disk, and local TZ shouldn't be a reason to give it up. (Though it's irrelevant to the users of most distros.)

2. The doc location.

The doc line "Initialization is done when the system starts up, and when it resumes from a low power state." (and/or the fixed new sentence above) should be moved from RTC_HCTOSYS_DEVICE to RTC_HCTOSYS, since it's independent of the device, and has nothing to do with RTC_SYSTOHC, either.

Note You need to log in before you can comment on or make changes to this bug.