From: J William Piggott <elseifthen@gmx.com>
To: Karel Zak <kzak@redhat.com>
Cc: util-linux@vger.kernel.org
Subject: [PATCH 4/5] hwclock: add '11 minute mode' information
Date: Fri, 13 Mar 2015 15:22:26 -0400 [thread overview]
Message-ID: <550338F2.2000908@gmx.com> (raw)
In-Reply-To: <5503364E.6010302@gmx.com>
Add that '11 minute mode' is a kernel compile time
option. Add details regarding its activation and
how to check its status.
Signed-off-by: J William Piggott <elseifthen@gmx.com>
---
sys-utils/hwclock.8.in | 25 +++++++++++++++----------
1 file changed, 15 insertions(+), 10 deletions(-)
diff --git a/sys-utils/hwclock.8.in b/sys-utils/hwclock.8.in
index 0c294af..8cf86a3 100644
--- a/sys-utils/hwclock.8.in
+++ b/sys-utils/hwclock.8.in
@@ -758,25 +758,30 @@ You can use an adjtime file that was previously used with the
.PP
You should be aware of another way that the Hardware Clock is kept
synchronized in some systems. The Linux kernel has a mode wherein it
-copies the System Time to the Hardware Clock every 11 minutes.
+copies the System Time to the Hardware Clock every 11 minutes. This mode
+is a compile time option, so not all kernels will have this capability.
This is a good mode to use when you are using something sophisticated
like NTP to keep your System Clock synchronized. (NTP is a way to keep
your System Time synchronized either to a time server somewhere on the
network or to a radio clock hooked up to your system. See RFC 1305.)
.PP
-This mode (we'll call it \%'11\ minute\ mode') is off until something
-turns it on. The NTP daemon ntpd is one thing that turns it on. You
-can turn it off by running anything, including
+If the kernel is compiled with the \%'11\ minute\ mode' option it will
+be active when the kernel's clock discipline is in a synchronized state.
+When in this state the binary 64's bit of the kernel's
+.I \%time_status
+variable is unset (10111111). This value is output as the 'status' line of the
+.BR \%adjtimex\ --print " or " \%ntptime " commands."
+.PP
+It takes an outside influence, like the NTP daemon
+.BR ntpd (1),
+to put the kernel's clock discipline into a synchronized state, and
+therefore turn on \%'11\ minute\ mode'.
+It can be turned off by running anything, including
.BR \%hwclock\ \-\-hctosys ,
that sets the System Clock the old fashioned way. However, if the NTP daemon is
-still running, it will turn 11 minute mode back on again the next time it
+still running, it will turn \%'11\ minute\ mode' back on again the next time it
synchronizes the System Clock.
.PP
-When \%'11\ minute\ mode' is active the 64 bit of the kernel's
-.I time_status
-variable is unset. The status variable can be checked with the
-.BR \%adjtimex\ --print " or " \%ntptime " commands."
-.PP
If your system runs with \%'11\ minute\ mode' on, it may need to use either
.BR \%\-\-hctosys " or " \%\-\-systz
in a startup script, especially if the Hardware Clock is configured to use
next prev parent reply other threads:[~2015-03-13 19:22 UTC|newest]
Thread overview: 19+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-03-13 19:11 [PATCH 1/5] hwclock: add TZDIR J William Piggott
2015-03-13 19:15 ` [PATCH 2/5] hwclock: Improve FILES section J William Piggott
2015-03-13 19:18 ` [PATCH 3/5] hwclock: remove depreciated ntpdate J William Piggott
2015-03-15 15:26 ` Benno Schulenberg
2015-03-16 0:19 ` Isaac Dunham
2015-03-16 10:33 ` Karel Zak
2015-03-17 3:37 ` J William Piggott
2015-03-17 9:29 ` Karel Zak
2015-03-17 21:10 ` J William Piggott
2015-03-13 19:22 ` J William Piggott [this message]
2015-03-15 15:47 ` [PATCH 4/5] hwclock: add '11 minute mode' information Benno Schulenberg
2015-03-17 9:57 ` Karel Zak
2015-03-18 1:16 ` J William Piggott
2015-03-18 9:43 ` Karel Zak
2015-03-13 19:26 ` [PATCH 5/5] hwclock: man-page errata J William Piggott
2015-03-15 15:51 ` Benno Schulenberg
2015-03-15 15:20 ` [PATCH 1/5] hwclock: add TZDIR Benno Schulenberg
2015-03-16 10:30 ` Karel Zak
2015-03-17 9:58 ` Karel Zak
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=550338F2.2000908@gmx.com \
--to=elseifthen@gmx.com \
--cc=kzak@redhat.com \
--cc=util-linux@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox