summaryrefslogtreecommitdiffstats
path: root/sbin/adjkerntz/adjkerntz.8
diff options
context:
space:
mode:
Diffstat (limited to 'sbin/adjkerntz/adjkerntz.8')
-rw-r--r--sbin/adjkerntz/adjkerntz.851
1 files changed, 20 insertions, 31 deletions
diff --git a/sbin/adjkerntz/adjkerntz.8 b/sbin/adjkerntz/adjkerntz.8
index 9678bf2..1ddd72b 100644
--- a/sbin/adjkerntz/adjkerntz.8
+++ b/sbin/adjkerntz/adjkerntz.8
@@ -30,28 +30,21 @@
.Nd "adjusts the kernel time if the machine runs wall CMOS clock"
.Sh SYNOPSIS
.Nm adjkerntz
-.Fl i
-.Op Fl v
-.Nm adjkerntz
-.Fl a
-.Op Fl v
.Sh DESCRIPTION
.Nm Adjkerntz
+daemon
fixes kernel time (makes it UTC) using the current wall CMOS clock value,
the current time zone rule and the kernel timezone value. The adjustment is
enabled only if the file
.Pa /etc/wall_cmos_clock
exists, in other cases it is assumed that the machine runs UTC CMOS clock and
.Nm adjkerntz
-does nothing.
+does nothing and exits immediately.
.Pp
-The adjustment is needed at boot stage and when a time zone
-change occurs, so
-.Nm adjkerntz
-can be called in two forms:
-.Bl -tag -width 4n
-.It Cm Fl i
-initialization call from
+The adjustment is usually needed at boot stage and when a time zone
+change occurs.
+.Nm Adjkerntz
+started in
.Pa /etc/rc
(before any daemons are started).
.Nm Adjkerntz
@@ -60,27 +53,16 @@ makes the first adjustment and the initial time zone offset is stored into
kernel variable
for following subsequent
.Nm adjkerntz
-calls.
-.It Cm Fl a
-This form is needed, when time zone changes occur.
+time zone change spying.
+When time zone changes occur,
.Nm Adjkerntz
uses the previously stored
time zone offset and the changed time zone rule to
-produce the new time zone offset, fix the kernel time and store the new
+produce the new time zone offset, fix RTC clock and store the new
offset into
.Pa adjkerntz
kernel variable
too.
-It is recommended to use this form in root's
-.Xr crontab 5
-near 3am,
-since this time matches most modern time zone changes.
-.It Cm Fl v
-This option is for diagnostic purposes. It causes
-.Nm adjkerntz
-to print differences between the old and new time zone offsets
-to stdout.
-.El
.Pp
.Nm Adjkerntz
clears the kernel timezone structure and makes kernel always run at UTC
@@ -92,12 +74,16 @@ Super-user privilege is required for all operations.
Time zone change rule, see
.Xr tzset 3 ;
not needed when
+.Xr /usr/sbin/tzsetup
+or
.Xr zic 8
is used.
.Sh FILES
.Bl -tag -width /etc/wall_cmos_clock -compact
.It Pa /etc/localtime
-Link to the current zone info file, see
+current zoneinfo file, see
+.Xr /usr/sbin/tzsetup
+and
.Xr zic 8 .
.It Pa /etc/wall_cmos_clock
Empty file.
@@ -107,10 +93,13 @@ absence indicates UTC CMOS clock.
.Xr tzset 3 ,
.Xr zic 8 ,
.Xr rc 8 ,
-.Xr crontab 5
+.Xr sysctl 8 ,
+.Xr /usr/sbin/tzsetup
.Sh DIAGNOSTICS
-No diagnostics, unless \-v option is specified.
-If any error occurs, an error message printed to stderr and
+No diagnostics.
+If any error occurs, an error message printed via
+.Xr syslog 3
+and
.Nm adjkerntz
exits with return code greater than zero.
.Sh AUTHOR
OpenPOWER on IntegriCloud