FreeBSD Manual Pages
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 be- havior, define CRONJOB=1 in the crontab. This script depends on$REQUIRED- CMDS 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 command line to the IPv4 namespace. _EndOfDoc_; }; flag = { name = ipv6; flags-cant = ipv4, prefer; value = 6; descrip = "Use only IPv6 addresses for DNS name resolution"; doc = <<- _EndOfDoc_ Force DNS resolution of following host names on the command 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. $LEAP- FILE -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 im- ply 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 directive 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 expiring. --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 au- togen-users@lists.sourceforge.net. Thank you. AUTHORS Timothe Litt NOTES This manual page was AutoGen-erated from the update-leap option defini- tions. FreeBSD ports 15.quarterly May 25 2024 UPDATE_LEAP(1update-leapmdoc)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE | EXIT STATUS | AUTHORS | NOTES
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=update-leap&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>