diff options
Diffstat (limited to 'sbin/adjkerntz/adjkerntz.8')
-rw-r--r-- | sbin/adjkerntz/adjkerntz.8 | 51 |
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 |