Index: sbin/adjkerntz/adjkerntz.8 =================================================================== --- sbin/adjkerntz/adjkerntz.8 +++ sbin/adjkerntz/adjkerntz.8 @@ -22,12 +22,12 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd March 8, 2012 +.Dd June 12, 2024 .Dt ADJKERNTZ 8 .Os .Sh NAME .Nm adjkerntz -.Nd adjust the local time CMOS clock to reflect time zone changes and keep the current timezone offset for the kernel +.Nd adjust the kernel and real-time clock timezone and offset .Sh SYNOPSIS .Nm .Fl i @@ -37,7 +37,9 @@ The .Nm utility 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. +is always set to UTC and the Real-Time Clock (RTC), which may be set to local +time. +The Real-Time Clock may also be called the CMOS Clock. The .Nm utility also informs the kernel about machine timezone shifts in order to @@ -51,9 +53,9 @@ timestamps. If the file .Pa /etc/wall_cmos_clock -exists, it means that the 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. +exists, it means that the real-time clock keeps local time (MS-DOS and +MS-Windows default compatible mode). +If that file does not exist, it means that the real-time clock keeps UTC time. The .Nm utility passes this state to the @@ -76,7 +78,7 @@ The .Nm utility puts itself into the background. -Then, for a local time CMOS clock, +Then, for a local time RTC, .Nm reads the local time from it and sets the kernel clock to the corresponding UTC time. @@ -88,7 +90,7 @@ .Em "'adjkerntz -a'" and by local time file systems. .Pp -For a local time CMOS clock +For a local time RTC .Em "'adjkerntz -i'" pauses and remains inactive as a background daemon until it receives a SIGTERM. @@ -98,13 +100,13 @@ is being shut down). After receiving the SIGTERM, .Nm -reads the UTC kernel clock and updates the CMOS clock, if necessary, +reads the UTC kernel clock and updates the RTC, if necessary, to ensure that it reflects the current local time zone. Then .Nm exits. .It Fl a Op Fl s -This form is used to update the local time CMOS clock and kernel +This form is used to update the local time RTC and kernel .Pa machdep.adjkerntz variable when time zone changes occur, e.g., when entering or leaving daylight savings time. @@ -116,7 +118,7 @@ calculate a new time zone offset. It stores the new offset into the .Pa machdep.adjkerntz -kernel variable and updates the wall CMOS clock to the new local time. +kernel variable and updates the RTC to the new local time. If .Em "'adjkerntz -a'" was started at a nonexistent time (during a timezone change), it exits @@ -164,8 +166,8 @@ .Xr zic 8 . .It Pa /etc/wall_cmos_clock Empty file. -Its presence indicates that the machine's CMOS clock is set to local -time, while its absence indicates a UTC CMOS clock. +Its presence indicates that the machine's real-time clock is set to local +time, while its absence indicates a UTC real-time clock. .El .Sh DIAGNOSTICS No diagnostics.