From: Rasmus Villemoes Date: Wed, 21 Jun 2023 20:18:23 +0000 (+0200) Subject: hwclock: add --vl-read, --vl-clear documentation and bash-completion X-Git-Tag: v2.40-rc1~376 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=ab7fe95ad7495adac41a4d79f4771c1b4cbe1fc0;p=thirdparty%2Futil-linux.git hwclock: add --vl-read, --vl-clear documentation and bash-completion Signed-off-by: Rasmus Villemoes --- diff --git a/bash-completion/hwclock b/bash-completion/hwclock index 6b4c01724d..6240d7d4be 100644 --- a/bash-completion/hwclock +++ b/bash-completion/hwclock @@ -54,6 +54,8 @@ _hwclock_module() --epoch --param-get --param-set + --vl-read + --vl-clear --update-drift --noadjfile --adjfile diff --git a/sys-utils/hwclock.8.adoc b/sys-utils/hwclock.8.adoc index 3e181edd23..0b23a37e8d 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