Skip to content

Commit

Permalink
adjkerntz.8: use machine independent language
Browse files Browse the repository at this point in the history
Reported by:	emaste
  • Loading branch information
concussious committed Jul 24, 2024
1 parent 12ec33c commit 0f09682
Showing 1 changed file with 10 additions and 10 deletions.
20 changes: 10 additions & 10 deletions sbin/adjkerntz/adjkerntz.8
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@
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, which may be set to local time.
The
.Nm
utility also informs the kernel about machine timezone shifts in order to
Expand All @@ -54,9 +54,9 @@ installed on the same system rather than fixing broken MS-DOS file
timestamps.
If the file
.Pa /etc/wall_cmos_clock
exists, it means that the CMOS clock keeps local time
exists, it means that the real-time clock keeps local time
.Pq MS-DOS and MS-Windows compatible mode .
If that file does not exist, it means that the CMOS clock keeps UTC time.
If that file does not exist, it means that the real-time clock keeps UTC time.
The
.Nm
utility passes this state to the
Expand All @@ -79,7 +79,7 @@ on entry to multi-user mode, before any other daemons have been started.
The
.Nm
utility puts itself into the background.
Then, for a local time CMOS clock,
Then, for a local time real-time clock,
.Nm
reads the local time from it
and sets the kernel clock to the corresponding UTC time.
Expand All @@ -91,7 +91,7 @@ kernel variable, for use by subsequent invocations of
.Ql adjkerntz -a
and by local time file systems.
.Pp
For a local time CMOS clock
For a local time real-time clock
.Ql adjkerntz -i
pauses and remains inactive as a background daemon until it
receives a SIGTERM.
Expand All @@ -101,13 +101,13 @@ when the system leaves multi-user mode
.Pq usually, because the system 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 real-time clock, 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
This form is used to update the local time real-time clock and
.Va machdep.adjkerntz
kernel variable when time zone changes occur,
e.g., when entering or leaving daylight savings time.
Expand All @@ -118,7 +118,7 @@ the previously stored time zone offset,
and the changed time zone rule to calculate a new time zone offset.
It stores the new offset into the
.Va machdep.adjkerntz
kernel variable and updates the wall CMOS clock to the new local time.
kernel variable and updates the wall real-time clock to the new local time.
If
.Ql adjkerntz -a
was started at a nonexistent time
Expand Down Expand Up @@ -167,8 +167,8 @@ and
.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.

Check warning on line 174 in sbin/adjkerntz/adjkerntz.8

View workflow job for this annotation

GitHub Actions / Style Checker

Missing Signed-off-by: line
Expand Down

0 comments on commit 0f09682

Please sign in to comment.