UPDATE_LEAP(1update-leapmdoc) User UPDATE_LEAP(1update-leapmdoc)
NAME
update-leap -- leap-seconds file manager/updater
SYNOPSIS
update-leap [-flags] [-flag [value]] [--option-name[[=| ]value]]
All arguments must be options.
DESCRIPTION
update-leap will validate the file currently on the local system and if
necessary, updates leap-second definition file.
Ordinarily, the file is found using the "leapfile" directive in
ntp.conf(5). However, an alternate location can be specified on the com-
mand line.
If the file does not exist, is not valid, has expired, or is expiring
soon, a new copy will be downloaded. If the new copy validates, it is
installed and NTP is (optionally) restarted.
If the current file is acceptable, no download or restart occurs.
-c can also be used to invoke another script to perform administrative
functions, e.g. to copy the file to other local systems. This can be run
as a cron job. As the file is rarely updated, and leap seconds are an-
nounced at least one month in advance (usually longer), it need not be
run more frequently than about once every three weeks. For cron-friendly
behavior, define CRONJOB=1 in the crontab. This script depends on$RE-
QUIREDCMDS
OPTIONS
-s string, --source-url=string
The URL of the master copy of the leapseconds file.
Specify the URL of the master copy to download $LEAPSRC
-4, --ipv4
Use only IPv4 addresses for DNS name resolution. This option
must not appear in combination with any of the following options:
ipv6.
Force DNS resolution of following host names on the com-
mand line
to the IPv4 namespace.
_EndOfDoc_; };
flag = {
name = ipv6;
flags-cant = ipv4, prefer;
value = 6;
descrip = "Use only IPv6 addresses for DNS name resolu-
tion";
doc = <<- _EndOfDoc_
Force DNS resolution of following host names on the com-
mand line
to the IPv6 namespace.
_EndOfDoc_; };
flag = {
name = prefer;
flags-cant = ipv4, ipv6;
value = p;
arg-type = keyword;
keyword = 4, 6;
descrip = 'Prefer IPv4 or IPv6 (as specified) addresses,
but use either';
doc = <<- _EndOfDoc_ Prefer IPv4 or IPv6 (as speci-
fied) addresses, but use either.
-d float, --destination=float
Filename on the local system.
The name to use to store the leapfile on the local system.
$LEAPFILE
-e string, --expiration=string
Refresh the leapfile this long before it expires.
Specify how long before expiration the file is to be refreshed
Units are required, e.g. "-e 60 days" Note that larger values
imply more frequent refreshes. "$PREFETCH"
-f string, --ntp-conf-file=string
Location of the ntp.conf file.
Specify location of ntp.conf (used to make sure leapfile direc-
tive is present and to default leapfile) /etc/ntp.conf
-F, --force-update
Force update of the leapfile.
Force update even if current file is OK and not close to expir-
ing.
--dont-wait
Don't wait for keystroke between plots.
-?, --help
Display usage information and exit.
-!, --more-help
Pass the extended usage information through a pager.
-v [{v|c|n --version [{v|c|n}]}]
Output version of program and exit. The default mode is `v', a
simple version. The `c' mode will print copyright information
and `n' will print the full copyright notice.
USAGE
Usage stuff
EXIT STATUS
One of the following exit values will be returned:
0 (EXIT_SUCCESS)
Successful program execution.
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
70 (EX_SOFTWARE)
libopts had an internal operational error. Please report it to
autogen-users@lists.sourceforge.net. Thank you.
AUTHORS
Timothe Litt
NOTES
This manual page was AutoGen-erated from the update-leap option defini-
tions.
BSD March 3 2020 BSD