From d1d944b32e5e9e0eb932ef9b0ba70f7e2811f631 Mon Sep 17 00:00:00 2001 From: ache Date: Tue, 9 Apr 1996 11:31:34 +0000 Subject: English corrections from jdp. Add main purpose description (MSDOS timestamps) --- sbin/adjkerntz/adjkerntz.8 | 41 +++++++++++++++++++++++------------------ 1 file changed, 23 insertions(+), 18 deletions(-) (limited to 'sbin/adjkerntz') diff --git a/sbin/adjkerntz/adjkerntz.8 b/sbin/adjkerntz/adjkerntz.8 index 5c79c66..eb72fc6 100644 --- a/sbin/adjkerntz/adjkerntz.8 +++ b/sbin/adjkerntz/adjkerntz.8 @@ -39,15 +39,20 @@ maintains the proper relationship between the kernel clock, which is always set to UTC, and the CMOS clock, which may be set to local time. .Nm Adjkerntz -also informs the kernel about machine timezone shift to -maintain proper timestamps for local time file systems like MS-DOS one. +also informs the kernel about machine timezone shifts to +maintain proper timestamps for local time file systems such as the MS-DOS +file system. The main purpose of this thing is not general fixing of +initially broken MS-DOS file timestamp idea but keeping +the same timestamps between FreeBSD MS-DOS file system +and MS-DOS operating system installed on the same +machine. If the file .Pa /etc/wall_cmos_clock -exists, it means that CMOS clock keep local time (MS-DOS and MS-Windows -compatible mode), -if that file does not exist it means that CMOS clock keep UTC time. +exists, it means that CMOS clock keeps local time (MS-DOS and MS-Windows +compatible mode). +If that file does not exist, it means that the CMOS clock keeps UTC time. .Nm Adjkerntz -passes this state to +passes this state to the .Pa machdep.wall_cmos_clock kernel variable. .Pp @@ -65,7 +70,7 @@ is invoked with this option from on entry to multi-user mode, before any other daemons have been started. .Nm Adjkerntz puts itself into the background. -Then for wall CMOS clock +Then, for a local time CMOS clock, .Nm adjkerntz reads the local time from it and sets the kernel clock to the corresponding UTC time. @@ -76,7 +81,7 @@ kernel variable, for use by subsequent invocations of .Nm "'adjkerntz -a'" and by local time file systems. .Pp -For wall CMOS clock +For a local time CMOS clock .Nm "'adjkerntz -i'" pauses, and remains inactive as a background daemon until it receives a SIGTERM. @@ -92,7 +97,7 @@ Then .Nm adjkerntz exits. .It Cm Fl a Op Fl s -This form is used to update the wall CMOS clock and kernel +This form is used to update the local time CMOS clock and kernel .Pa machdep.adjkerntz variable when time zone changes occur, e.g., when entering or leaving daylight savings time. @@ -106,24 +111,24 @@ It stores the new offset into the kernel variable, and updates the wall CMOS clock to the new local time. If .Nm "'adjkerntz -a'" -was started at nonexisten time (inside timezone change), it exits -with warning diagnostic unless +was started at a nonexistent time (during a timezone change), it exits +with a warning diagnostic unless the .Fl s -option is used, in this case +option was used, in which case .Nm adjkerntz -sleep 30 minutes and tries again. +sleeps 30 minutes and tries again. .Pp This form should be invoked from root's .Xr crontab 5 every half hour between midnight and 4am, when most modern time zone changes occur. -Warning: don't use +Warning: don't use the .Fl s -option in +option in a .Xr crontab 5 -command line or multiply +command line, or multiple .Nm "'adjkerntz -a'" -copies can conflict with each other. +instances could conflict with each other. .El .Pp .Nm Adjkerntz @@ -155,6 +160,7 @@ time, while its absence indicates a UTC CMOS clock. .Xr tzset 3 , .Xr crontab 5 , .Xr rc 8 , +.Xr mount_msdos 8 , .Xr sysctl 8 , .Xr tzsetup 8 , .Xr zic 8 . @@ -171,4 +177,3 @@ Andrey A. Chernov The .Nm adjkerntz command appeared in FreeBSD 1.0.1. - -- cgit v1.1