1 /* -*- Mode: Text -*- */
2 autogen definitions perlopt;
4 #include autogen-version.def
6 prog-name = 'update-leap';
7 prog-title = 'leap-seconds file manager/updater';
18 descrip = 'The URL of the master copy of the leapseconds file';
20 Specify the URL of the master copy to download
28 descrip = "Use only IPv4 addresses for DNS name resolution";
30 Force DNS resolution of following host names on the command line
31 to the IPv4 namespace.
37 flags-cant = ipv4, prefer;
39 descrip = "Use only IPv6 addresses for DNS name resolution";
41 Force DNS resolution of following host names on the command line
42 to the IPv6 namespace.
48 flags-cant = ipv4, ipv6;
52 descrip = 'Prefer IPv4 or IPv6 (as specified) addresses, but use either';
54 Prefer IPv4 or IPv6 (as specified) addresses, but use either.
63 descrip = 'Filename on the local system';
65 The name to use to store the leapfile on the local system.
74 descrip = 'Refresh the leapfile this long before it expires';
76 Specify how long before expiration the file is to be refreshed
77 Units are required, e.g. "-e 60 days" Note that larger values
78 imply more frequent refreshes.
87 descrip = 'Location of the ntp.conf file';
89 Specify location of ntp.conf (used to make sure leapfile directive is
90 present and to default leapfile)
98 descrip = 'Force update of the leapfile';
100 Force update even if current file is OK and not close to expiring.
106 descrip = "Don't wait for keystroke between plots";
111 /* explain: Additional information whenever the usage routine is invoked */
112 explain = <<- _END_EXPLAIN
116 ds-type = 'DESCRIPTION';
118 ds-text = <<- _END_PROG_MDOC_DESCRIP
120 will validate the file currently on the local system
121 and if necessary, updates leap-second definition file.
123 Ordinarily, the file is found using the "leapfile" directive in
125 However, an alternate location can be specified on the command line.
127 If the file does not exist, is not valid, has expired, or is expiring soon,
128 a new copy will be downloaded. If the new copy validates, it is installed and
129 NTP is (optionally) restarted.
131 If the current file is acceptable, no download or restart occurs.
133 -c can also be used to invoke another script to perform administrative
134 functions, e.g. to copy the file to other local systems.
136 This can be run as a cron job. As the file is rarely updated, and leap
137 seconds are announced at least one month in advance (usually longer), it
138 need not be run more frequently than about once every three weeks.
140 For cron-friendly behavior, define CRONJOB=1 in the crontab.
142 This script depends on$REQUIREDCMDS
143 _END_PROG_MDOC_DESCRIP;
150 ds-text = <<- _END_MDOC_USAGE
160 ds-text = <<- _END_MDOC_AUTHORS