diff options
Diffstat (limited to '')
| -rw-r--r-- | sys-utils/hwclock.8 | 13 | ||||
| -rw-r--r-- | sys-utils/hwclock.8.adoc | 5 |
2 files changed, 15 insertions, 3 deletions
diff --git a/sys-utils/hwclock.8 b/sys-utils/hwclock.8 index 070db51..425d967 100644 --- a/sys-utils/hwclock.8 +++ b/sys-utils/hwclock.8 @@ -2,12 +2,12 @@ .\" Title: hwclock .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.20 -.\" Date: 2023-12-01 +.\" Date: 2024-03-20 .\" Manual: System Administration -.\" Source: util-linux 2.39.3 +.\" Source: util-linux 2.40 .\" Language: English .\" -.TH "HWCLOCK" "8" "2023-12-01" "util\-linux 2.39.3" "System Administration" +.TH "HWCLOCK" "8" "2024-03-20" "util\-linux 2.40" "System Administration" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 @@ -157,6 +157,13 @@ The first two are only available on the first call of \fBsettimeofday\fP(2) afte Set the Hardware Clock from the System Clock, and update the timestamps in \fI/etc/adjtime\fP. With the \fB\-\-update\-drift\fP option also (re)calculate the drift factor. Try it without the option if \fB\-\-systohc\fP fails. See \fB\-\-update\-drift\fP below. .RE .sp +\fB\-\-vl\-read\fP, \fB\-\-vl\-clear\fP +.RS 4 +Some RTC devices are able to monitor the voltage of the backup battery and thus provide a way for the user to know that the battery should be replaced. The \fB\-\-vl\-read\fP function retrieves the Voltage Low information and decodes the result into human\-readable form. The \fB\-\-vl\-clear\fP function resets the Voltage Low information, which is necessary for some RTC devices after a battery replacement. +.sp +See the Kernel\(cqs \fIinclude/uapi/linux/rtc.h\fP for details on which pieces of information may be returned. Note that not all RTC devices have this monitoring capability, nor do all drivers necessarily support reading the information. +.RE +.sp \fB\-h\fP, \fB\-\-help\fP .RS 4 Display help text and exit. diff --git a/sys-utils/hwclock.8.adoc b/sys-utils/hwclock.8.adoc index 3e181ed..0b23a37 100644 --- a/sys-utils/hwclock.8.adoc +++ b/sys-utils/hwclock.8.adoc @@ -101,6 +101,11 @@ The first two are only available on the first call of *settimeofday*(2) after bo *-w*, *--systohc*:: Set the Hardware Clock from the System Clock, and update the timestamps in _{ADJTIME_PATH}_. With the *--update-drift* option also (re)calculate the drift factor. Try it without the option if *--systohc* fails. See *--update-drift* below. +*--vl-read*, *--vl-clear*:: +Some RTC devices are able to monitor the voltage of the backup battery and thus provide a way for the user to know that the battery should be replaced. The *--vl-read* function retrieves the Voltage Low information and decodes the result into human-readable form. The *--vl-clear* function resets the Voltage Low information, which is necessary for some RTC devices after a battery replacement. ++ +See the Kernel's _include/uapi/linux/rtc.h_ for details on which pieces of information may be returned. Note that not all RTC devices have this monitoring capability, nor do all drivers necessarily support reading the information. + include::man-common/help-version.adoc[] == OPTIONS |