Home | History | Annotate | Line # | Download | only in update-leap
update-leap.html revision 1.1.1.13
      1  1.1.1.11  christos <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
      2  1.1.1.11  christos <html>
      3  1.1.1.13  christos <!-- Created by GNU Texinfo 6.6, http://www.gnu.org/software/texinfo/ -->
      4       1.1  christos <head>
      5  1.1.1.11  christos <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
      6  1.1.1.11  christos <title>update-leap User&rsquo;s Manual</title>
      7  1.1.1.11  christos 
      8  1.1.1.11  christos <meta name="description" content="update-leap User&rsquo;s Manual">
      9  1.1.1.11  christos <meta name="keywords" content="update-leap User&rsquo;s Manual">
     10  1.1.1.11  christos <meta name="resource-type" content="document">
     11  1.1.1.11  christos <meta name="distribution" content="global">
     12  1.1.1.11  christos <meta name="Generator" content="makeinfo">
     13  1.1.1.11  christos <link href="#Top" rel="start" title="Top">
     14  1.1.1.11  christos <link href="dir.html#Top" rel="up" title="(dir)">
     15  1.1.1.11  christos <style type="text/css">
     16  1.1.1.11  christos <!--
     17  1.1.1.11  christos a.summary-letter {text-decoration: none}
     18  1.1.1.11  christos blockquote.indentedblock {margin-right: 0em}
     19  1.1.1.11  christos div.display {margin-left: 3.2em}
     20  1.1.1.11  christos div.example {margin-left: 3.2em}
     21  1.1.1.11  christos div.lisp {margin-left: 3.2em}
     22  1.1.1.11  christos kbd {font-style: oblique}
     23  1.1.1.11  christos pre.display {font-family: inherit}
     24  1.1.1.11  christos pre.format {font-family: inherit}
     25  1.1.1.11  christos pre.menu-comment {font-family: serif}
     26  1.1.1.11  christos pre.menu-preformatted {font-family: serif}
     27  1.1.1.11  christos span.nolinebreak {white-space: nowrap}
     28  1.1.1.11  christos span.roman {font-family: initial; font-weight: normal}
     29  1.1.1.11  christos span.sansserif {font-family: sans-serif; font-weight: normal}
     30  1.1.1.11  christos ul.no-bullet {list-style: none}
     31  1.1.1.11  christos -->
     32  1.1.1.11  christos </style>
     33  1.1.1.11  christos 
     34  1.1.1.11  christos 
     35       1.1  christos </head>
     36       1.1  christos 
     37  1.1.1.11  christos <body lang="en">
     38  1.1.1.11  christos <h1 class="settitle" align="center">update-leap User&rsquo;s Manual</h1>
     39  1.1.1.11  christos 
     40       1.1  christos 
     41  1.1.1.11  christos 
     42  1.1.1.11  christos 
     43  1.1.1.11  christos 
     44  1.1.1.13  christos <span id="Top"></span><div class="header">
     45  1.1.1.11  christos <p>
     46  1.1.1.11  christos Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> &nbsp; </p>
     47  1.1.1.11  christos </div>
     48  1.1.1.11  christos <h1 class="node-heading">Top</h1>
     49  1.1.1.11  christos 
     50  1.1.1.11  christos <p>This document describes the use of the NTP Project&rsquo;s <code>update-leap</code> program.
     51  1.1.1.11  christos </p>
     52  1.1.1.13  christos <p>This document applies to version 4.2.8p18 of <code>update-leap</code>.
     53  1.1.1.11  christos </p>
     54  1.1.1.13  christos <span id="SEC_Overview"></span>
     55  1.1.1.11  christos <h2 class="shortcontents-heading">Short Table of Contents</h2>
     56       1.1  christos 
     57       1.1  christos <div class="shortcontents">
     58  1.1.1.13  christos <li><a id="stoc-Invoking-update_002dleap" href="#toc-Invoking-update_002dleap">1 Invoking update-leap</a></li>
     59  1.1.1.11  christos 
     60       1.1  christos </div>
     61       1.1  christos 
     62       1.1  christos 
     63  1.1.1.11  christos <table class="menu" border="0" cellspacing="0">
     64  1.1.1.13  christos <tr><td align="left" valign="top">&bull; update-leap Description</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Description
     65  1.1.1.11  christos </td></tr>
     66  1.1.1.13  christos <tr><td align="left" valign="top">&bull; <a href="#update_002dleap-Invocation" accesskey="2">update-leap Invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Invoking update-leap
     67  1.1.1.11  christos </td></tr>
     68  1.1.1.11  christos </table>
     69  1.1.1.11  christos 
     70  1.1.1.11  christos <hr>
     71  1.1.1.13  christos <span id="update_002dleap-Invocation"></span><div class="header">
     72  1.1.1.11  christos <p>
     73  1.1.1.11  christos Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; </p>
     74       1.1  christos </div>
     75  1.1.1.13  christos <span id="Invoking-update_002dleap"></span><h3 class="section">1 Invoking update-leap</h3>
     76  1.1.1.13  christos <span id="index-update_002dleap"></span>
     77  1.1.1.13  christos <span id="index-leap_002dseconds-file-manager_002fupdater"></span>
     78       1.1  christos 
     79       1.1  christos 
     80       1.1  christos 
     81  1.1.1.11  christos <p><code>update-leap</code>
     82       1.1  christos will validate the file currently on the local system
     83       1.1  christos and if necessary, updates leap-second definition file.
     84  1.1.1.11  christos </p>
     85  1.1.1.11  christos <p>Ordinarily, the file is found using the &quot;leapfile&quot; directive in
     86  1.1.1.11  christos <code>ntp.conf(5)</code>.
     87       1.1  christos However, an alternate location can be specified on the command line.
     88  1.1.1.11  christos </p>
     89  1.1.1.11  christos <p>If the file does not exist, is not valid, has expired, or is expiring soon,
     90       1.1  christos a new copy will be downloaded.  If the new copy validates, it is installed and
     91       1.1  christos NTP is (optionally) restarted.
     92  1.1.1.11  christos </p>
     93  1.1.1.11  christos <p>If the current file is acceptable, no download or restart occurs.
     94  1.1.1.11  christos </p>
     95  1.1.1.11  christos <p>-c can also be used to invoke another script to perform administrative
     96  1.1.1.11  christos functions, e.g. to copy the file to other local systems.
     97       1.1  christos .PP
     98       1.1  christos This can be run as a cron job.  As the file is rarely updated, and leap
     99       1.1  christos seconds are announced at least one month in advance (usually longer), it
    100  1.1.1.11  christos need not be run more frequently than about once every three weeks.
    101       1.1  christos .PP
    102  1.1.1.11  christos For cron-friendly behavior, define CRONJOB=1 in the crontab.
    103       1.1  christos .PP
    104       1.1  christos This script depends on$REQUIREDCMDS
    105  1.1.1.11  christos </p>
    106  1.1.1.11  christos <p>This section was generated by <strong>AutoGen</strong>,
    107       1.1  christos using the <code>agtexi-cmd</code> template and the option descriptions for the <code>update-leap</code> program.
    108  1.1.1.11  christos </p>
    109  1.1.1.11  christos <table class="menu" border="0" cellspacing="0">
    110  1.1.1.13  christos <tr><td align="left" valign="top">&bull; <a href="#update_002dleap-usage" accesskey="1">update-leap usage</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">update-leap help/usage (<samp>--help</samp>)
    111  1.1.1.11  christos </td></tr>
    112  1.1.1.13  christos <tr><td align="left" valign="top">&bull; <a href="#update_002dleap-source_002durl" accesskey="2">update-leap source-url</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">source-url option (-s)
    113  1.1.1.11  christos </td></tr>
    114  1.1.1.13  christos <tr><td align="left" valign="top">&bull; <a href="#update_002dleap-ipv4" accesskey="3">update-leap ipv4</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">ipv4 option (-4)
    115  1.1.1.11  christos </td></tr>
    116  1.1.1.13  christos <tr><td align="left" valign="top">&bull; <a href="#update_002dleap-destination" accesskey="4">update-leap destination</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">destination option (-d)
    117  1.1.1.11  christos </td></tr>
    118  1.1.1.13  christos <tr><td align="left" valign="top">&bull; <a href="#update_002dleap-expiration" accesskey="5">update-leap expiration</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">expiration option (-e)
    119  1.1.1.11  christos </td></tr>
    120  1.1.1.13  christos <tr><td align="left" valign="top">&bull; <a href="#update_002dleap-ntp_002dconf_002dfile" accesskey="6">update-leap ntp-conf-file</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">ntp-conf-file option (-f)
    121  1.1.1.11  christos </td></tr>
    122  1.1.1.13  christos <tr><td align="left" valign="top">&bull; <a href="#update_002dleap-force_002dupdate" accesskey="7">update-leap force-update</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">force-update option (-F)
    123  1.1.1.11  christos </td></tr>
    124  1.1.1.13  christos <tr><td align="left" valign="top">&bull; <a href="#update_002dleap-exit-status" accesskey="8">update-leap exit status</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">exit status
    125  1.1.1.11  christos </td></tr>
    126  1.1.1.13  christos <tr><td align="left" valign="top">&bull; <a href="#update_002dleap-Usage" accesskey="9">update-leap Usage</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Usage
    127  1.1.1.11  christos </td></tr>
    128  1.1.1.13  christos <tr><td align="left" valign="top">&bull; <a href="#update_002dleap-Authors">update-leap Authors</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Authors
    129  1.1.1.11  christos </td></tr>
    130  1.1.1.11  christos </table>
    131  1.1.1.11  christos 
    132  1.1.1.11  christos <hr>
    133  1.1.1.13  christos <span id="update_002dleap-usage"></span><div class="header">
    134  1.1.1.11  christos <p>
    135  1.1.1.11  christos Next: <a href="#update_002dleap-source_002durl" accesskey="n" rel="next">update-leap source-url</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> &nbsp; </p>
    136  1.1.1.11  christos </div>
    137  1.1.1.13  christos <span id="update_002dleap-help_002fusage-_0028_002d_002dhelp_0029"></span><h4 class="subsection">1.1 update-leap help/usage (<samp>--help</samp>)</h4>
    138  1.1.1.13  christos <span id="index-update_002dleap-help"></span>
    139  1.1.1.11  christos 
    140  1.1.1.11  christos <p>This is the automatically generated usage text for update-leap.
    141  1.1.1.11  christos </p>
    142  1.1.1.11  christos <p>The text printed is the same whether selected with the <code>help</code> option
    143  1.1.1.11  christos (<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</samp>).  <code>more-help</code> will print
    144  1.1.1.11  christos the usage text by passing it through a pager program.
    145       1.1  christos <code>more-help</code> is disabled on platforms without a working
    146       1.1  christos <code>fork(2)</code> function.  The <code>PAGER</code> environment variable is
    147  1.1.1.11  christos used to select the program, defaulting to <samp>more</samp>.  Both will exit
    148       1.1  christos with a status code of 0.
    149  1.1.1.11  christos </p>
    150  1.1.1.11  christos <div class="example">
    151   1.1.1.9  christos <pre class="example">
    152  1.1.1.11  christos 
    153  1.1.1.10  christos Usage: update-leap [options]
    154  1.1.1.10  christos 
    155  1.1.1.10  christos Verifies and if necessary, updates leap-second definition file
    156  1.1.1.10  christos 
    157  1.1.1.10  christos All arguments are optional:  Default (or current value) shown:
    158  1.1.1.10  christos     -C    Absolute path to CA Cert (see SSL/TLS Considerations)
    159  1.1.1.10  christos     -D    Path to a CAdir (see SSL/TLS Considerations)
    160  1.1.1.10  christos     -e    Specify how long (in days) before expiration the file is to be
    161  1.1.1.10  christos               refreshed.  Note that larger values imply more frequent refreshes.
    162  1.1.1.10  christos           60
    163  1.1.1.10  christos     -F    Force update even if current file is OK and not close to expiring.
    164  1.1.1.10  christos     -f    Absolute path ntp.conf file (default /etc/ntp.conf)
    165  1.1.1.10  christos           /etc/ntp.conf
    166  1.1.1.10  christos     -h    show help
    167  1.1.1.10  christos     -i    Specify number of minutes between retries
    168  1.1.1.10  christos           10
    169  1.1.1.10  christos     -L    Absolute path to leapfile on the local system
    170  1.1.1.10  christos           (overrides value in ntp.conf)
    171  1.1.1.10  christos     -l    Specify the syslog(3) facility for logging
    172  1.1.1.10  christos           LOG_USER
    173  1.1.1.10  christos     -q    Only report errors (cannot be used with -v)
    174  1.1.1.10  christos     -r    Specify number of attempts to retrieve file
    175  1.1.1.10  christos           6
    176  1.1.1.10  christos     -s    Send output to syslog(3) - implied if STDOUT has no tty or redirected
    177  1.1.1.10  christos     -t    Send output to terminal - implied if STDOUT attached to terminal
    178  1.1.1.10  christos     -u    Specify the URL of the master copy to download
    179  1.1.1.10  christos           https://www.ietf.org/timezones/data/leap-seconds.list
    180  1.1.1.10  christos     -v    Verbose - show debug messages (cannot be used with -q)
    181  1.1.1.10  christos 
    182  1.1.1.10  christos The following options are not (yet) implemented in the perl version:
    183  1.1.1.10  christos     -4    Use only IPv4
    184  1.1.1.10  christos     -6    Use only IPv6
    185  1.1.1.10  christos     -c    Command to restart NTP after installing a new file
    186  1.1.1.10  christos           &lt;none&gt; - ntpd checks file daily
    187  1.1.1.10  christos     -p 4|6
    188  1.1.1.10  christos           Prefer IPv4 or IPv6 (as specified) addresses, but use either
    189  1.1.1.10  christos 
    190  1.1.1.10  christos update-leap will validate the file currently on the local system.
    191  1.1.1.10  christos 
    192  1.1.1.10  christos Ordinarily, the leapfile is found using the 'leapfile' directive in
    193  1.1.1.10  christos /etc/ntp.conf.  However, an alternate location can be specified on the
    194  1.1.1.10  christos command line with the -L flag.
    195  1.1.1.10  christos 
    196  1.1.1.10  christos If the leapfile does not exist, is not valid, has expired, or is
    197  1.1.1.10  christos expiring soon, a new copy will be downloaded.  If the new copy is
    198  1.1.1.10  christos valid, it is installed.
    199  1.1.1.10  christos 
    200  1.1.1.10  christos If the current file is acceptable, no download or restart occurs.
    201  1.1.1.10  christos 
    202  1.1.1.10  christos This can be run as a cron job.  As the file is rarely updated, and
    203  1.1.1.10  christos leap seconds are announced at least one month in advance (usually
    204  1.1.1.10  christos longer), it need not be run more frequently than about once every
    205  1.1.1.10  christos three weeks.
    206  1.1.1.10  christos 
    207  1.1.1.10  christos SSL/TLS Considerations
    208  1.1.1.10  christos -----------------------
    209  1.1.1.10  christos The perl modules can usually locate the CA certificate used to verify
    210  1.1.1.10  christos the peer's identity.
    211  1.1.1.10  christos 
    212  1.1.1.10  christos On BSDs, the default is typically the file /etc/ssl/certs.pem.  On
    213  1.1.1.10  christos Linux, the location is typically a path to a CAdir - a directory of
    214  1.1.1.10  christos symlinks named according to a hash of the certificates' subject names.
    215  1.1.1.10  christos 
    216  1.1.1.10  christos The -C or -D options are available to pass in a location if no CA cert
    217  1.1.1.10  christos is found in the default location.
    218  1.1.1.10  christos 
    219  1.1.1.10  christos External Dependencies
    220  1.1.1.10  christos ---------------------
    221  1.1.1.10  christos The following perl modules are required:
    222  1.1.1.10  christos HTTP::Tiny         - version &gt;= 0.056
    223  1.1.1.10  christos IO::Socket::SSL - version &gt;= 1.56
    224  1.1.1.10  christos NET::SSLeay         - version &gt;= 1.49
    225  1.1.1.10  christos 
    226  1.1.1.10  christos Version: 1.004
    227  1.1.1.11  christos </pre></div>
    228       1.1  christos 
    229  1.1.1.11  christos <hr>
    230  1.1.1.13  christos <span id="update_002dleap-source_002durl"></span><div class="header">
    231  1.1.1.11  christos <p>
    232  1.1.1.11  christos Next: <a href="#update_002dleap-ipv4" accesskey="n" rel="next">update-leap ipv4</a>, Previous: <a href="#update_002dleap-usage" accesskey="p" rel="prev">update-leap usage</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> &nbsp; </p>
    233  1.1.1.11  christos </div>
    234  1.1.1.13  christos <span id="source_002durl-option-_0028_002ds_0029"></span><h4 class="subsection">1.2 source-url option (-s)</h4>
    235  1.1.1.13  christos <span id="index-update_002dleap_002dsource_002durl"></span>
    236  1.1.1.11  christos 
    237  1.1.1.11  christos <p>This is the &ldquo;the url of the master copy of the leapseconds file&rdquo; option.
    238  1.1.1.11  christos This option takes a string argument.
    239       1.1  christos Specify the URL of the master copy to download
    240       1.1  christos $LEAPSRC
    241  1.1.1.11  christos </p><hr>
    242  1.1.1.13  christos <span id="update_002dleap-ipv4"></span><div class="header">
    243  1.1.1.11  christos <p>
    244  1.1.1.11  christos Next: <a href="#update_002dleap-destination" accesskey="n" rel="next">update-leap destination</a>, Previous: <a href="#update_002dleap-source_002durl" accesskey="p" rel="prev">update-leap source-url</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> &nbsp; </p>
    245  1.1.1.11  christos </div>
    246  1.1.1.13  christos <span id="ipv4-option-_0028_002d4_0029"></span><h4 class="subsection">1.3 ipv4 option (-4)</h4>
    247  1.1.1.13  christos <span id="index-update_002dleap_002dipv4"></span>
    248  1.1.1.11  christos 
    249  1.1.1.11  christos <p>This is the &ldquo;use only ipv4 addresses for dns name resolution&rdquo; option.
    250  1.1.1.11  christos </p>
    251  1.1.1.11  christos <p>This option has some usage constraints.  It:
    252  1.1.1.11  christos </p><ul>
    253  1.1.1.11  christos <li> must not appear in combination with any of the following options:
    254  1.1.1.11  christos ipv6.
    255  1.1.1.11  christos </li></ul>
    256       1.1  christos 
    257  1.1.1.11  christos <p>Force DNS resolution of following host names on the command line
    258  1.1.1.11  christos         to the IPv4 namespace.
    259       1.1  christos         _EndOfDoc_;
    260       1.1  christos ;
    261  1.1.1.11  christos </p>
    262  1.1.1.11  christos <p>flag = 
    263       1.1  christos     name      = ipv6;
    264       1.1  christos     flags-cant = ipv4, prefer;
    265       1.1  christos     value     = 6;
    266  1.1.1.11  christos     descrip   = &quot;Use only IPv6 addresses for DNS name resolution&quot;;
    267       1.1  christos     doc = &lt;&lt;-  _EndOfDoc_
    268       1.1  christos         Force DNS resolution of following host names on the command line
    269  1.1.1.11  christos         to the IPv6 namespace.
    270       1.1  christos         _EndOfDoc_;
    271       1.1  christos ;
    272  1.1.1.11  christos </p>
    273  1.1.1.11  christos <p>flag = 
    274       1.1  christos     name        = prefer;
    275       1.1  christos     flags-cant	= ipv4, ipv6;
    276       1.1  christos     value	= p;
    277       1.1  christos     arg-type    = keyword;
    278       1.1  christos     keyword	= 4, 6;
    279  1.1.1.11  christos     descrip     = &rsquo;Prefer IPv4 or IPv6 (as specified) addresses, but use either&rsquo;;
    280       1.1  christos     doc         = &lt;&lt;-  _EndOfDoc_
    281  1.1.1.11  christos Prefer IPv4 or IPv6 (as specified) addresses, but use either.
    282  1.1.1.11  christos </p><hr>
    283  1.1.1.13  christos <span id="update_002dleap-destination"></span><div class="header">
    284  1.1.1.11  christos <p>
    285  1.1.1.11  christos Next: <a href="#update_002dleap-expiration" accesskey="n" rel="next">update-leap expiration</a>, Previous: <a href="#update_002dleap-ipv4" accesskey="p" rel="prev">update-leap ipv4</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> &nbsp; </p>
    286  1.1.1.11  christos </div>
    287  1.1.1.13  christos <span id="destination-option-_0028_002dd_0029"></span><h4 class="subsection">1.4 destination option (-d)</h4>
    288  1.1.1.13  christos <span id="index-update_002dleap_002ddestination"></span>
    289  1.1.1.11  christos 
    290  1.1.1.11  christos <p>This is the &ldquo;filename on the local system&rdquo; option.
    291  1.1.1.11  christos This option takes a string argument <samp>float</samp>.
    292  1.1.1.11  christos The name to use to store the leapfile on the local system.
    293       1.1  christos $LEAPFILE
    294  1.1.1.11  christos </p><hr>
    295  1.1.1.13  christos <span id="update_002dleap-expiration"></span><div class="header">
    296  1.1.1.11  christos <p>
    297  1.1.1.11  christos Next: <a href="#update_002dleap-ntp_002dconf_002dfile" accesskey="n" rel="next">update-leap ntp-conf-file</a>, Previous: <a href="#update_002dleap-destination" accesskey="p" rel="prev">update-leap destination</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> &nbsp; </p>
    298  1.1.1.11  christos </div>
    299  1.1.1.13  christos <span id="expiration-option-_0028_002de_0029"></span><h4 class="subsection">1.5 expiration option (-e)</h4>
    300  1.1.1.13  christos <span id="index-update_002dleap_002dexpiration"></span>
    301       1.1  christos 
    302  1.1.1.11  christos <p>This is the &ldquo;refresh the leapfile this long before it expires&rdquo; option.
    303  1.1.1.11  christos This option takes a string argument.
    304       1.1  christos Specify how long before expiration the file is to be refreshed
    305  1.1.1.11  christos Units are required, e.g. &quot;-e 60 days&quot;  Note that larger values
    306  1.1.1.11  christos imply more frequent refreshes.
    307  1.1.1.11  christos &quot;$PREFETCH&quot;
    308  1.1.1.11  christos </p><hr>
    309  1.1.1.13  christos <span id="update_002dleap-ntp_002dconf_002dfile"></span><div class="header">
    310  1.1.1.11  christos <p>
    311  1.1.1.11  christos Next: <a href="#update_002dleap-force_002dupdate" accesskey="n" rel="next">update-leap force-update</a>, Previous: <a href="#update_002dleap-expiration" accesskey="p" rel="prev">update-leap expiration</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> &nbsp; </p>
    312  1.1.1.11  christos </div>
    313  1.1.1.13  christos <span id="ntp_002dconf_002dfile-option-_0028_002df_0029"></span><h4 class="subsection">1.6 ntp-conf-file option (-f)</h4>
    314  1.1.1.13  christos <span id="index-update_002dleap_002dntp_002dconf_002dfile"></span>
    315  1.1.1.11  christos 
    316  1.1.1.11  christos <p>This is the &ldquo;location of the ntp.conf file&rdquo; option.
    317  1.1.1.11  christos This option takes a string argument.
    318       1.1  christos Specify location of ntp.conf (used to make sure leapfile directive is
    319       1.1  christos present and to default  leapfile)
    320       1.1  christos /etc/ntp.conf
    321  1.1.1.11  christos </p><hr>
    322  1.1.1.13  christos <span id="update_002dleap-force_002dupdate"></span><div class="header">
    323  1.1.1.11  christos <p>
    324  1.1.1.11  christos Next: <a href="#update_002dleap-exit-status" accesskey="n" rel="next">update-leap exit status</a>, Previous: <a href="#update_002dleap-ntp_002dconf_002dfile" accesskey="p" rel="prev">update-leap ntp-conf-file</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> &nbsp; </p>
    325  1.1.1.11  christos </div>
    326  1.1.1.13  christos <span id="force_002dupdate-option-_0028_002dF_0029"></span><h4 class="subsection">1.7 force-update option (-F)</h4>
    327  1.1.1.13  christos <span id="index-update_002dleap_002dforce_002dupdate"></span>
    328  1.1.1.11  christos 
    329  1.1.1.11  christos <p>This is the &ldquo;force update of the leapfile&rdquo; option.
    330  1.1.1.11  christos Force update even if current file is OK and not close to expiring.
    331  1.1.1.11  christos </p><hr>
    332  1.1.1.13  christos <span id="update_002dleap-exit-status"></span><div class="header">
    333  1.1.1.11  christos <p>
    334  1.1.1.11  christos Next: <a href="#update_002dleap-Usage" accesskey="n" rel="next">update-leap Usage</a>, Previous: <a href="#update_002dleap-force_002dupdate" accesskey="p" rel="prev">update-leap force-update</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> &nbsp; </p>
    335       1.1  christos </div>
    336  1.1.1.13  christos <span id="update_002dleap-exit-status-1"></span><h4 class="subsection">1.8 update-leap exit status</h4>
    337       1.1  christos 
    338       1.1  christos <p>One of the following exit values will be returned:
    339  1.1.1.11  christos </p><dl compact="compact">
    340  1.1.1.11  christos <dt>&lsquo;<samp>0 (EXIT_SUCCESS)</samp>&rsquo;</dt>
    341  1.1.1.11  christos <dd><p>Successful program execution.
    342  1.1.1.11  christos </p></dd>
    343  1.1.1.11  christos <dt>&lsquo;<samp>1 (EXIT_FAILURE)</samp>&rsquo;</dt>
    344  1.1.1.11  christos <dd><p>The operation failed or the command syntax was not valid.
    345  1.1.1.11  christos </p></dd>
    346       1.1  christos </dl>
    347  1.1.1.11  christos <hr>
    348  1.1.1.13  christos <span id="update_002dleap-Usage"></span><div class="header">
    349  1.1.1.11  christos <p>
    350  1.1.1.11  christos Next: <a href="#update_002dleap-Authors" accesskey="n" rel="next">update-leap Authors</a>, Previous: <a href="#update_002dleap-exit-status" accesskey="p" rel="prev">update-leap exit status</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> &nbsp; </p>
    351  1.1.1.11  christos </div>
    352  1.1.1.13  christos <span id="update_002dleap-Usage-1"></span><h4 class="subsection">1.9 update-leap Usage</h4>
    353  1.1.1.11  christos <hr>
    354  1.1.1.13  christos <span id="update_002dleap-Authors"></span><div class="header">
    355  1.1.1.11  christos <p>
    356  1.1.1.11  christos Previous: <a href="#update_002dleap-Usage" accesskey="p" rel="prev">update-leap Usage</a>, Up: <a href="#update_002dleap-Invocation" accesskey="u" rel="up">update-leap Invocation</a> &nbsp; </p>
    357  1.1.1.11  christos </div>
    358  1.1.1.13  christos <span id="update_002dleap-Authors-1"></span><h4 class="subsection">1.10 update-leap Authors</h4>
    359  1.1.1.11  christos <hr>
    360       1.1  christos 
    361       1.1  christos 
    362       1.1  christos 
    363  1.1.1.11  christos </body>
    364  1.1.1.11  christos </html>
    365