Page MenuHomeFreeBSD
Files F103144454

D45572.id.diff
No OneTemporary
Actions

D45572.id.diff
View Options

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.

File Metadata

Mime Type
text/plain
Expires
Fri, Nov 22, 2:12 PM (1 h, 18 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
14777896
Default Alt Text
D45572.id.diff (3 KB)

Event Timeline