From: Harlan Stenn Date: Wed, 25 Jul 2018 07:41:01 +0000 (+0000) Subject: updates X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4538ddeabe136bf48a251d5bd2767b0b4e9d3a44;p=thirdparty%2Fntp.git updates bk: 5b58298dlKpPvNaIKnJ_Huyni03FlQ --- diff --git a/ntpd/ntp.conf.html b/ntpd/ntp.conf.html index 132659199..36b5905c2 100644 --- a/ntpd/ntp.conf.html +++ b/ntpd/ntp.conf.html @@ -3,7 +3,7 @@ NTP Configuration File User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

NTP Configuration File User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

NTP's Configuration File User Manual

@@ -48,10 +50,12 @@ Up: (dir)
+ +


-Previous: Top, +Previous: Top, Up: Top -
+
@@ -61,9 +65,11 @@ Up: Top by default ntp.conf.
-


+ -
+


+ +

Notes about ntp.conf

@@ -77,7 +83,7 @@ configuration file is read at initial startup by the daemon in order to specify the synchronization sources, modes and other related information. Usually, it is installed in the -/etc +/etc directory, but could be installed elsewhere (see the daemon's @@ -88,7 +94,7 @@ command line option). unix configuration files. Comments begin with a -# +‘#’ character and extend to the end of the line; blank lines are ignored. Configuration commands consist of an initial keyword @@ -106,7 +112,7 @@ The page (available as part of the HTML documentation provided in -/usr/share/doc/ntp) +/usr/share/doc/ntp) contains an extended discussion of these options. In addition to the discussion of general Configuration Options, @@ -133,9 +139,10 @@ or manycastclient commands.
-


-
+


+ +

Configuration Support

@@ -176,7 +183,7 @@ or ntpdc(1ntpdcmdoc), IPv6 addresses are automatically generated. IPv6 addresses can be identified by the presence of colons -: +“:” in the address field. IPv6 addresses can be used almost everywhere where IPv4 addresses can be used, @@ -206,7 +213,7 @@ Additional information on association behavior can be found in the page (available as part of the HTML documentation provided in -/usr/share/doc/ntp). +/usr/share/doc/ntp).
pool
For type s addresses, this command mobilizes a persistent client mode association with a number of remote servers. @@ -357,7 +364,7 @@ See the page (available as part of the HTML documentation provided in -/usr/share/doc/ntp) +/usr/share/doc/ntp) for further information.
true
Forces the association to always survive the selection and clustering algorithms. This option should almost certainly @@ -440,9 +447,10 @@ The default value for is 5.
-


-
+


+ +

Authentication Support

@@ -592,7 +600,7 @@ authenticate NTP packets. Keys and related information are specified in a key file, usually called -ntp.keys, +ntp.keys, which must be distributed and stored using secure means beyond the scope of the NTP protocol itself. Besides the keys used @@ -889,34 +897,34 @@ location of a file is relative to the keys directory specified in the keysdir command or default -/usr/local/etc. +/usr/local/etc. Following are the subcommands:
cert file
Specifies the location of the required host public certificate file. This overrides the link -ntpkey_cert_hostname +ntpkey_cert_hostname in the keys directory.
gqpar file
Specifies the location of the optional GQ parameters file. This overrides the link -ntpkey_gq_hostname +ntpkey_gq_hostname in the keys directory.
host file
Specifies the location of the required host key file. This overrides the link -ntpkey_key_hostname +ntpkey_key_hostname in the keys directory.
iffpar file
Specifies the location of the optional IFF parameters file. This overrides the link -ntpkey_iff_hostname +ntpkey_iff_hostname in the keys directory.
leap file
Specifies the location of the optional leapsecond file. This overrides the link -ntpkey_leap +ntpkey_leap in the keys directory.
mvpar file
Specifies the location of the optional MV parameters file. This overrides the link -ntpkey_mv_hostname +ntpkey_mv_hostname in the keys directory.
pw password
Specifies the password to decrypt files containing private keys and identity parameters. @@ -928,7 +936,7 @@ The defaults are described in the main text above.
sign file
Specifies the location of the optional sign key file. This overrides the link -ntpkey_sign_hostname +ntpkey_sign_hostname in the keys directory. If this file is not found, the host key is also the sign key. @@ -946,7 +954,7 @@ command line option.
keysdir path
This command specifies the default directory path for cryptographic keys, parameters and certificates. The default is -/usr/local/etc/. +/usr/local/etc/.
requestkey key
Specifies the key identifier to use with the ntpdc(1ntpdcmdoc) utility program, which uses a @@ -1024,9 +1032,10 @@ The certificate is missing, corrupted or bogus. The identity key is missing, corrupt or bogus.
-


-
+


+ +

Monitoring Support

@@ -1042,7 +1051,7 @@ for a listing and example of each type of statistics currently supported. Statistic files are managed using file generation sets and scripts in the -./scripts +./scripts directory of the source code distribution. Using these facilities and @@ -1064,8 +1073,7 @@ Each update received from a clock driver appends a line of the following form to the file generation set named clockstats: -
          
-          49213 525.624 127.127.4.1 93 226 00:08:29.606 D
+
          49213 525.624 127.127.4.1 93 226 00:08:29.606 D
      

The first two fields show the date (Modified Julian Day) and time @@ -1085,8 +1093,7 @@ enables recording of cryptographic public key protocol information. Each message received by the protocol module appends a line of the following form to the file generation set named cryptostats: -

          
-          49213 525.624 127.127.4.1 message
+
          49213 525.624 127.127.4.1 message
      

The first two fields show the date (Modified Julian Day) and time @@ -1102,8 +1109,7 @@ Each update of the local clock outputs a line of the following form to the file generation set named loopstats: -

          
-          50935 75440.031 0.000006019 13.778190 0.000351733 0.0133806
+
          50935 75440.031 0.000006019 13.778190 0.000351733 0.0133806
      

The first two fields show the date (Modified Julian Day) and @@ -1120,8 +1126,7 @@ Each valid update appends a line of the following form to the current element of a file generation set named peerstats: -

          
-          48773 10847.650 127.127.4.1 9714 -0.001605376 0.000000000 0.001424877 0.000958674
+
          48773 10847.650 127.127.4.1 9714 -0.001605376 0.000000000 0.001424877 0.000958674
      

The first two fields show the date (Modified Julian Day) and @@ -1141,8 +1146,7 @@ Each NTP message received from a peer or clock driver appends a line of the following form to the file generation set named rawstats: -

          
-          50928 2132.543 128.4.1.1 128.4.1.20 3102453281.584327000 3102453281.58622800031 02453332.540806000 3102453332.541458000
+
          50928 2132.543 128.4.1.1 128.4.1.20 3102453281.584327000 3102453281.58622800031 02453332.540806000 3102453332.541458000
      

The first two fields show the date (Modified Julian Day) and @@ -1160,8 +1164,7 @@ Each hour a line of the following form is appended to the file generation set named sysstats: -

          
-          50928 2132.543 36000 81965 0 9546 56 71793 512 540 10 147
+
          50928 2132.543 36000 81965 0 9546 56 71793 512 540 10 147
      

The first two fields show the date (Modified Julian Day) and time @@ -1239,13 +1242,13 @@ generation can be configured using the option explained above.

filename
This string is directly concatenated to the prefix mentioned above (no intervening -/). +‘/’). This can be modified using the file argument to the filegen statement. No -.. +.. elements are allowed in this component to prevent filenames referring to parts outside the filesystem hierarchy denoted by @@ -1267,7 +1270,7 @@ separating files belonging to different ntpd(1ntpdmdoc) server incarnations. The set member filename is built by appending a -. +‘.’ to concatenated prefix and @@ -1281,7 +1284,7 @@ A day is defined as the period between 00:00 and 24:00 UTC. The file set member suffix consists of a -. +‘.’ and a day specification in the form YYYYMMdd. @@ -1353,9 +1356,10 @@ allows the current file to be accessed by a constant name.
-


-
+


+ +

Access Control Support

@@ -1377,7 +1381,7 @@ Additional information and examples can be found in the page (available as part of the HTML documentation provided in -/usr/share/doc/ntp). +/usr/share/doc/ntp).

The restriction facility was implemented in conformance with the access policies for the original NSFnet backbone @@ -1549,7 +1553,7 @@ be overridden by later requests for normal priority traps. even if they come from an authenticated source. Note that the ability to use a symmetric key for authentication may be restricted to one or more IPs or subnets via the third field of the -ntp.keys +ntp.keys file. This restriction is not enabled by default, to maintain backward compatability. @@ -1627,9 +1631,10 @@ with the default entry (i.e., everything besides your own NTP server is unrestricted).

-


-
+


+ +

Automatic NTP Configuration Options

@@ -2025,9 +2030,10 @@ The default is eight multiples of 32 starting at 31.
-


-
+


+ +

Reference Clock Support

@@ -2041,7 +2047,7 @@ be found in the page (available as part of the HTML documentation provided in -/usr/share/doc/ntp). +/usr/share/doc/ntp). Additional information can be found in the pages linked there, including the "Debugging Hints for Reference Clock Drivers" @@ -2050,14 +2056,14 @@ and pages (available as part of the HTML documentation provided in -/usr/share/doc/ntp). +/usr/share/doc/ntp). In addition, support for a PPS signal is available as described in the "Pulse-per-second (PPS) Signal Interfacing" page (available as part of the HTML documentation provided in -/usr/share/doc/ntp). +/usr/share/doc/ntp). Many drivers support special line discipline/streams modules which can significantly improve the accuracy using the driver. @@ -2067,7 +2073,7 @@ described in the page (available as part of the HTML documentation provided in -/usr/share/doc/ntp). +/usr/share/doc/ntp).

A reference clock will generally (though not always) be a radio timecode receiver which is synchronized to a source of standard @@ -2133,7 +2139,7 @@ information on this option can be found in the "Mitigation Rules and the prefer Keyword" (available as part of the HTML documentation provided in -/usr/share/doc/ntp) +/usr/share/doc/ntp) page. The minpoll @@ -2203,7 +2209,7 @@ See the page (available as part of the HTML documentation provided in -/usr/share/doc/ntp) +/usr/share/doc/ntp) for further information.

mode int
Specifies a mode number which is interpreted in a device-specific fashion. @@ -2265,7 +2271,7 @@ page and operates as described in the page (available as part of the HTML documentation provided in -/usr/share/doc/ntp). +/usr/share/doc/ntp).
time2 secs
Specifies a fixed-point decimal number in seconds, which is interpreted in a driver-dependent way. See the descriptions of @@ -2274,7 +2280,7 @@ specific drivers in the page (available as part of the HTML documentation provided in -/usr/share/doc/ntp ). +/usr/share/doc/ntp ).
stratum int
Specifies the stratum number assigned to the driver, an integer between 0 and 15. This number overrides the default stratum number @@ -2310,9 +2316,10 @@ command can be found in
-


-
+


+ +

Miscellaneous Options

@@ -2598,18 +2605,18 @@ By default, all output is turned on. All configkeyword keywords can be prefixed with -=, -+ +‘=’, +‘+’ and --, +‘-’, where -= +‘=’ sets the syslog(3) priority mask, -+ +‘+’ adds and -- +‘-’ removes messages. syslog(3) @@ -2639,8 +2646,7 @@ keyword to enable/disable all messages of the respective message class. Thus, a minimal log configuration could look like this: -
     
-     logconfig =syncstatus +sysevents
+
     logconfig =syncstatus +sysevents
 

This would just list the synchronizations state of @@ -2648,8 +2654,7 @@ could look like this: and the major system events. For a simple reference server, the following minimum message configuration could be useful: -

     
-     logconfig =syncall +clockall
+
     logconfig =syncall +clockall
 

This configuration will list all clock information and @@ -2940,24 +2945,28 @@ This software is released under the NTP license, <http://ntp.org/license>.

-


+ -
+


+ +

ntp.conf Files

-
/etc/ntp.conf
the default name of the configuration file -
ntp.keys
private MD5 keys -
ntpkey
RSA private key -
ntpkey_host
RSA public key -
ntp_dh
Diffie-Hellman agreement parameters +
/etc/ntp.conf
the default name of the configuration file +
ntp.keys
private MD5 keys +
ntpkey
RSA private key +
ntpkey_host
RSA public key +
ntp_dh
Diffie-Hellman agreement parameters
-


+ -
+


+ +

ntp.conf See Also

@@ -2971,15 +2980,17 @@ comprehensive documentation is available on the world wide web at http://www.ntp.org/. A snapshot of this documentation is available in HTML format in -/usr/share/doc/ntp. +/usr/share/doc/ntp.


David L. Mills, Network Time Protocol (Version 4), RFC5905

-


+ -
+


+ +

ntp.conf Bugs

@@ -2989,15 +3000,17 @@ ridiculous and even hilarious options and modes may not be detected.

The -ntpkey_host +ntpkey_host files are really digital certificates. These should be obtained via secure directory services when they become universally available.

-


+ -
+


+ +

ntp.conf Notes

diff --git a/ntpd/ntp.keys.html b/ntpd/ntp.keys.html index 66a6bc3f9..eddde2bff 100644 --- a/ntpd/ntp.keys.html +++ b/ntpd/ntp.keys.html @@ -3,7 +3,7 @@ NTP Symmetric Key - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

NTP Symmetric Key

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

NTP's Symmetric Key File User Manual

@@ -48,10 +50,12 @@ Up: (dir)
+ +


-Previous: Top, +Previous: Top, Up: Top -
+
@@ -61,9 +65,11 @@ Up: Top be specified in a configuration file, by default /etc/ntp.keys.
-


+ -
+


+ +

Notes about ntp.keys

@@ -175,23 +181,27 @@ This software is released under the NTP license, <http://ntp.org/license>.
+ +


-Next: , +Next: , Up: ntp.keys Notes -
+

ntp.keys Files

-
/etc/ntp.keys
the default name of the configuration file +
/etc/ntp.keys
the default name of the configuration file
+ +


-Next: , +Next: , Previous: ntp.keys Files, Up: ntp.keys Notes -
+

ntp.keys See Also

@@ -202,10 +212,12 @@ Up: ntp.keys Notes ntpdc(1ntpdcmdoc), sntp(1sntpmdoc)
+ +


-Previous: ntp.keys See Also, +Previous: ntp.keys See Also, Up: ntp.keys Notes -
+

ntp.keys Notes

diff --git a/ntpd/ntpd.html b/ntpd/ntpd.html index 3af0cc546..df1eb325f 100644 --- a/ntpd/ntpd.html +++ b/ntpd/ntpd.html @@ -3,7 +3,7 @@ ntpd: Network Time Protocol (NTP) Daemon User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

ntpd: Network Time Protocol (NTP) Daemon User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

ntpd: Network Time Protocol (NTP) Daemon User Manual

@@ -48,9 +50,10 @@ cryptography.
-


-
+


+ +
@@ -78,9 +81,10 @@ If nothing is heard after a few minutes' time, the daemon times out and exits without setting the clock.
-


-
+


+ +

Invoking ntpd

@@ -161,7 +165,7 @@ using the agtexi-cmd template and the option descriptions for the < This software is released under the NTP license, <http://ntp.org/license>.
+


-Next: , +Next: , Up: ntpd Invocation -
+
-

ntpd help/usage (--help)

+

ntpd help/usage (--help)

This is the automatically generated usage text for ntpd.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. -

ntpd - NTP daemon program - Ver. 4.2.8p10
+
ntpd - NTP daemon program - Ver. 4.2.8p11
 Usage:  ntpd [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
                 [ <server1> ... <serverN> ]
   Flg Arg Option-Name    Description
@@ -291,11 +296,12 @@ The following option preset mechanisms are supported:
 Please send bug reports to:  <http://bugs.ntp.org, bugs@ntp.org>
 
+


-Next: , +Next: , Previous: ntpd usage, Up: ntpd Invocation -
+

ipv4 option (-4)

@@ -312,11 +318,12 @@ ipv6.

Force DNS resolution of following host names on the command line to the IPv4 namespace.

+


-Next: , +Next: , Previous: ntpd ipv4, Up: ntpd Invocation -
+

ipv6 option (-6)

@@ -333,11 +340,12 @@ ipv4.

Force DNS resolution of following host names on the command line to the IPv6 namespace.

+


-Next: , +Next: , Previous: ntpd ipv6, Up: ntpd Invocation -
+

authreq option (-a)

@@ -355,11 +363,12 @@ authnoreq. multicast client and symmetric passive associations. This is the default.
+


-Next: , +Next: , Previous: ntpd authreq, Up: ntpd Invocation -
+

authnoreq option (-A)

@@ -377,11 +386,12 @@ authreq. multicast client and symmetric passive associations. This is almost never a good idea.
+


-Next: , +Next: , Previous: ntpd authnoreq, Up: ntpd Invocation -
+

configfile option (-c)

@@ -390,14 +400,15 @@ Up: ntpd Invocation This is the “configuration file name” option. This option takes a string argument. The name and path of the configuration file, -/etc/ntp.conf +/etc/ntp.conf by default.
+


-Next: , +Next: , Previous: ntpd configfile, Up: ntpd Invocation -
+

driftfile option (-f)

@@ -406,19 +417,20 @@ Up: ntpd Invocation This is the “frequency drift file name” option. This option takes a string argument. The name and path of the frequency file, -/etc/ntp.drift +/etc/ntp.drift by default. This is the same operation as the driftfile driftfile configuration specification in the -/etc/ntp.conf +/etc/ntp.conf file.
+


-Next: , +Next: , Previous: ntpd driftfile, Up: ntpd Invocation -
+

panicgate option (-g)

@@ -444,11 +456,13 @@ See the tinker configuration file directive for other options.
+ +


-Next: , +Next: , Previous: ntpd panicgate, Up: ntpd Invocation -
+

force-step-once option (-G)

@@ -466,11 +480,12 @@ so this option must not be used if applications requiring monotonic time are running. See the tinker configuration file directive for other options.
+


-Next: , +Next: , Previous: ntpd force-step-once, Up: ntpd Invocation -
+

jaildir option (-i)

@@ -497,18 +512,19 @@ This option is supported under NetBSD (configure with --enable-clockctl) or Linux (configure with --enable-linuxcaps) or Solaris (configure with --enable-solarisprivs).
+


-Next: , +Next: , Previous: ntpd jaildir, Up: ntpd Invocation -
+

interface option (-I)

This is the “listen on an interface name or address” option. -This option takes a string argument iface. +This option takes a string argument iface.

This option has some usage constraints. It:

    @@ -521,11 +537,12 @@ also implies not opening other addresses, except wildcard and localhost. This option is deprecated. Please consider using the configuration file interface command, which is more versatile.
    +


    -Next: , +Next: , Previous: ntpd interface, Up: ntpd Invocation -
    +

    keyfile option (-k)

    @@ -534,17 +551,18 @@ Up: ntpd Invocation This is the “path to symmetric keys” option. This option takes a string argument. Specify the name and path of the symmetric key file. -/etc/ntp.keys +/etc/ntp.keys is the default. This is the same operation as the keys keyfile configuration file directive.
    +


    -Next: , +Next: , Previous: ntpd keyfile, Up: ntpd Invocation -
    +

    logfile option (-l)

    @@ -558,11 +576,12 @@ This is the same operation as the logfile logfile configuration file directive.
    +


    -Next: , +Next: , Previous: ntpd logfile, Up: ntpd Invocation -
    +

    novirtualips option (-L)

    @@ -574,11 +593,12 @@ names containing a colon. This option is deprecated. Please consider using the configuration file interface command, which is more versatile.
    +


    -Next: , +Next: , Previous: ntpd novirtualips, Up: ntpd Invocation -
    +

    modifymmtimer option (-M)

    @@ -595,11 +615,12 @@ This is the “modify multimedia timer (windows only)” option. ensures the resolution does not change while ntpd is running, avoiding timekeeping glitches associated with changes.
    +


    -Next: , +Next: , Previous: ntpd modifymmtimer, Up: ntpd Invocation -
    +

    nice option (-N)

    @@ -610,11 +631,12 @@ To the extent permitted by the operating system, run ntpd at the highest priority.
    +


    -Next: , +Next: , Previous: ntpd nice, Up: ntpd Invocation -
    +

    pidfile option (-p)

    @@ -629,11 +651,12 @@ This is the same operation as the pidfile pidfile configuration file directive.
    +


    -Next: , +Next: , Previous: ntpd pidfile, Up: ntpd Invocation -
    +

    priority option (-P)

    @@ -647,11 +670,12 @@ at the specified sched_setscheduler(SCHED_FIFO) priority.

    quit option (-q)

    @@ -677,11 +701,12 @@ and options can be used with this option. Note: The kernel time discipline is disabled with this option.
    +


    -Next: , +Next: , Previous: ntpd quit, Up: ntpd Invocation -
    +

    propagationdelay option (-r)

    @@ -691,11 +716,12 @@ This is the “broadcast/propagation delay” option. This option takes a string argument. Specify the default propagation delay from the broadcast/multicast server to this client. This is necessary only if the delay cannot be computed automatically by the protocol.
    +


    -Next: , +Next: , Previous: ntpd propagationdelay, Up: ntpd Invocation -
    +

    saveconfigquit option

    @@ -715,11 +741,12 @@ quit, wait-sync. equivalent to the given filename and exit. This option was designed for automated testing.
    +


    -Next: , +Next: , Previous: ntpd saveconfigquit, Up: ntpd Invocation -
    +

    statsdir option (-s)

    @@ -732,18 +759,19 @@ This is the same operation as the statsdir statsdir configuration file directive.
    +


    -Next: , +Next: , Previous: ntpd statsdir, Up: ntpd Invocation -
    +

    trustedkey option (-t)

    This is the “trusted key number” option. -This option takes a string argument tkey. +This option takes a string argument tkey.

    This option has some usage constraints. It:

      @@ -752,11 +780,12 @@ This option takes a string argument tkey.

      Add the specified key number to the trusted key list.

      +


      -Next: , +Next: , Previous: ntpd trustedkey, Up: ntpd Invocation -
      +

      user option (-u)

      @@ -777,11 +806,12 @@ This option is supported under NetBSD (configure with --enable-clockctl) or Linux (configure with --enable-linuxcaps) or Solaris (configure with --enable-solarisprivs).
      +


      -Next: , +Next: , Previous: ntpd user, Up: ntpd Invocation -
      +

      updateinterval option (-U)

      @@ -794,11 +824,13 @@ For systems with routing socket support the scans will be performed shortly afte has been detected by the system. Use 0 to disable scanning. 60 seconds is the minimum time between scans.
      + +


      -Next: , +Next: , Previous: ntpd updateinterval, Up: ntpd Invocation -
      +

      wait-sync option (-w)

      @@ -823,11 +855,12 @@ otherwise it is ETIMEDOUT. This provides the option for a script starting ntpd to easily wait for the first set of the clock before proceeding.
      +


      -Next: , +Next: , Previous: ntpd wait-sync, Up: ntpd Invocation -
      +

      slew option (-x)

      @@ -848,11 +881,12 @@ See the configuration file directive for other options. Note: The kernel time discipline is disabled with this option.
      +


      -Next: , +Next: , Previous: ntpd slew, Up: ntpd Invocation -
      +

      usepcc option

      @@ -870,11 +904,12 @@ The CPU counter and QueryPerformanceCounter are compared, and if they have the same frequency, the CPU counter (RDTSC on x86) is used directly, saving the overhead of a system call.
      +


      -Next: , +Next: , Previous: ntpd usepcc, Up: ntpd Invocation -
      +

      pccfreq option

      @@ -892,11 +927,12 @@ This option takes a string argument. The CPU counter (RDTSC on x86) is used unconditionally with the given frequency (in Hz).
      +


      -Next: , +Next: , Previous: ntpd pccfreq, Up: ntpd Invocation -
      +

      mdns option (-m)

      @@ -913,11 +949,12 @@ This is the “register with mdns as a ntp server” option. the server to be discovered via mDNS client lookup.
      +


      -Next: , +Next: , Previous: ntpd mdns, Up: ntpd Invocation -
      +

      presetting/configuring ntpd

      @@ -939,79 +976,86 @@ detail to provide. The default is to print just the version. The licensing inf Only the first letter of the argument is examined:
      -
      version
      Only print the version. This is the default. -
      copyright
      Name the copyright usage licensing terms. -
      verbose
      Print the full copyright usage licensing terms. +
      version
      Only print the version. This is the default. +
      copyright
      Name the copyright usage licensing terms. +
      verbose
      Print the full copyright usage licensing terms.
      +


      -Next: , +Next: , Previous: ntpd config, Up: ntpd Invocation -
      +

      ntpd 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. +
      0 (EXIT_SUCCESS)
      Successful program execution. +
      1 (EXIT_FAILURE)
      The operation failed or the command syntax was not valid.
      +


      -Next: , +Next: , Previous: ntpd exit status, Up: ntpd Invocation -
      +

      ntpd Usage

      +


      -Next: , +Next: , Previous: ntpd Usage, Up: ntpd Invocation -
      +

      ntpd Files

      +


      -Next: , +Next: , Previous: ntpd Files, Up: ntpd Invocation -
      +

      ntpd See Also

      +


      -Next: , +Next: , Previous: ntpd See Also, Up: ntpd Invocation -
      +

      ntpd Bugs

      +


      -Previous: ntpd Bugs, +Previous: ntpd Bugs, Up: ntpd Invocation -
      +

      ntpd Notes

      -


      -
      +


      + +
      diff --git a/ntpdc/ntpdc.html b/ntpdc/ntpdc.html index e133ec7b0..a5b01f69b 100644 --- a/ntpdc/ntpdc.html +++ b/ntpdc/ntpdc.html @@ -3,7 +3,7 @@ ntpdc: NTPD Control User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

      ntpdc: NTPD Control User's Manual

      +


      -Next: , +Next: , Previous: (dir), Up: (dir) -
      +

      ntpdc: NTPD Control User Manual

      @@ -55,9 +57,10 @@ IETF specification.
    -


    -
    +


    + +
    @@ -76,9 +79,10 @@ the +4.567 +/- 0.089 secs indicates the time offset and error bound of the system clock relative to the server clock.
    -


    -
    +


    + +

    Invoking ntpdc

    @@ -115,7 +119,7 @@ using the agtexi-cmd template and the option descriptions for the < This software is released under the NTP license, <http://ntp.org/license>.
    +


    -Next: , +Next: , Up: ntpdc Invocation -
    +
    -

    ntpdc help/usage (--help)

    +

    ntpdc help/usage (--help)

    This is the automatically generated usage text for ntpdc.

    The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0.

    ntpdc - vendor-specific NTPD control program - Ver. 4.2.8p11
    @@ -198,11 +203,12 @@ The following option preset mechanisms are supported:
     Please send bug reports to:  <http://bugs.ntp.org, bugs@ntp.org>
     
    +


    -Next: , +Next: , Previous: ntpdc usage, Up: ntpdc Invocation -
    +

    ipv4 option (-4)

    @@ -219,11 +225,12 @@ ipv6.

    Force DNS resolution of following host names on the command line to the IPv4 namespace.

    +


    -Next: , +Next: , Previous: ntpdc ipv4, Up: ntpdc Invocation -
    +

    ipv6 option (-6)

    @@ -240,18 +247,19 @@ ipv4.

    Force DNS resolution of following host names on the command line to the IPv6 namespace.

    +


    -Next: , +Next: , Previous: ntpdc ipv6, Up: ntpdc Invocation -
    +

    command option (-c)

    This is the “run a command and exit” option. -This option takes a string argument cmd. +This option takes a string argument cmd.

    This option has some usage constraints. It:

      @@ -262,11 +270,12 @@ This option takes a string argument cmd. and is added to the list of commands to be executed on the specified host(s).
      +


      -Next: , +Next: , Previous: ntpdc command, Up: ntpdc Invocation -
      +

      interactive option (-i)

      @@ -283,11 +292,12 @@ command, listpeers, peers, showpeers.

      Force ntpq to operate in interactive mode. Prompts will be written to the standard output and commands read from the standard input.

      +


      -Next: , +Next: , Previous: ntpdc interactive, Up: ntpdc Invocation -
      +

      listpeers option (-l)

      @@ -304,11 +314,12 @@ command.

      Print a list of the peers known to the server as well as a summary of their state. This is equivalent to the 'listpeers' interactive command.

      +


      -Next: , +Next: , Previous: ntpdc listpeers, Up: ntpdc Invocation -
      +

      numeric option (-n)

      @@ -318,11 +329,12 @@ This is the “numeric host addresses” option. Output all host addresses in dotted-quad numeric format rather than converting to the canonical host names.
      +


      -Next: , +Next: , Previous: ntpdc numeric, Up: ntpdc Invocation -
      +

      peers option (-p)

      @@ -339,11 +351,12 @@ command.

      Print a list of the peers known to the server as well as a summary of their state. This is equivalent to the 'peers' interactive command.

      +


      -Next: , +Next: , Previous: ntpdc peers, Up: ntpdc Invocation -
      +

      showpeers option (-s)

      @@ -361,11 +374,12 @@ command. of their state. This is equivalent to the 'dmpeers' interactive command.
      +


      -Next: , +Next: , Previous: ntpdc showpeers, Up: ntpdc Invocation -
      +

      presetting/configuring ntpdc

      @@ -383,9 +397,9 @@ values are treated like option arguments.
    • $PWD
    The environment variables HOME, and PWD -are expanded and replaced when ntpdc runs. +are expanded and replaced when ntpdc runs. For any of these that are plain files, they are simply processed. -For any that are directories, then a file named .ntprc is searched for +For any that are directories, then a file named .ntprc is searched for within that directory and processed.

    Configuration files may be in a wide variety of formats. @@ -427,72 +441,78 @@ detail to provide. The default is to print just the version. The licensing inf Only the first letter of the argument is examined:

    -
    version
    Only print the version. This is the default. -
    copyright
    Name the copyright usage licensing terms. -
    verbose
    Print the full copyright usage licensing terms. +
    version
    Only print the version. This is the default. +
    copyright
    Name the copyright usage licensing terms. +
    verbose
    Print the full copyright usage licensing terms.
    +


    -Next: , +Next: , Previous: ntpdc config, Up: ntpdc Invocation -
    +

    ntpdc 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. -
    66 (EX_NOINPUT)
    A specified configuration file could not be loaded. -
    70 (EX_SOFTWARE)
    libopts had an internal operational error. Please report +
    0 (EXIT_SUCCESS)
    Successful program execution. +
    1 (EXIT_FAILURE)
    The operation failed or the command syntax was not valid. +
    66 (EX_NOINPUT)
    A specified configuration file could not be loaded. +
    70 (EX_SOFTWARE)
    libopts had an internal operational error. Please report it to autogen-users@lists.sourceforge.net. Thank you.
    +


    -Next: , +Next: , Previous: ntpdc exit status, Up: ntpdc Invocation -
    +

    ntpdc Usage

    +


    -Next: , +Next: , Previous: ntpdc Usage, Up: ntpdc Invocation -
    +

    ntpdc See Also

    +


    -Next: , +Next: , Previous: ntpdc See Also, Up: ntpdc Invocation -
    +

    ntpdc Authors

    +


    -Previous: ntpdc Authors, +Previous: ntpdc Authors, Up: ntpdc Invocation -
    +

    ntpdc Bugs

    -


    -
    +


    + +
    diff --git a/ntpsnmpd/ntpsnmpd.html b/ntpsnmpd/ntpsnmpd.html index c12d7669b..509d81511 100644 --- a/ntpsnmpd/ntpsnmpd.html +++ b/ntpsnmpd/ntpsnmpd.html @@ -3,7 +3,7 @@ ntpsnmpd: Network Time Protocol SNMP Daemon User's Manual - + @@ -14,8 +14,9 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } --> @@ -30,11 +31,12 @@
    +


    -Next: , +Next: , Previous: (dir), Up: (dir) -
    +

    ntpsnmpd: Network Time Protocol Query User Manual

    @@ -51,11 +53,12 @@ operations and determine performance. It uses the standard NTP mode 6 control
+


-Next: , +Next: , Previous: Top, Up: Top -
+
@@ -64,10 +67,11 @@ Up: Top

The ntpsnmpd utility program provides an SNMP MIB agent for ntpd.

+


-Previous: ntpsnmpd Description, +Previous: ntpsnmpd Description, Up: Top -
+
diff --git a/scripts/ntp-wait/ntp-wait.html b/scripts/ntp-wait/ntp-wait.html index ef8e53e88..68ae26e4d 100644 --- a/scripts/ntp-wait/ntp-wait.html +++ b/scripts/ntp-wait/ntp-wait.html @@ -3,7 +3,7 @@ Ntp-wait User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

Ntp-wait User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

This document describes the use of the NTP Project's ntp-wait program. @@ -53,9 +55,11 @@ accurate and stable time.

-


+ -
+


+ +

0.1 Invoking ntp-wait

@@ -85,7 +89,7 @@ has set the time. using the agtexi-cmd template and the option descriptions for the ntp-wait program.
+ +


-Next: , +Next: , Up: ntp-wait Invocation -
+
-

0.1.1 ntp-wait help/usage (--help)

+

0.1.1 ntp-wait help/usage (--help)

This is the automatically generated usage text for ntp-wait.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0.

ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p11
@@ -127,11 +133,13 @@ Options are specified by doubled hyphens and their name or by a single
 hyphen and the flag character.
 
+ +


-Next: , +Next: , Previous: ntp-wait usage, Up: ntp-wait Invocation -
+

0.1.2 tries option (-n)

@@ -142,26 +150,30 @@ This option takes a number argument. The maximum number of times we will check ntpd to see if it has been able to synchronize and stabilize the system clock.
+ +


-Next: , +Next: , Previous: ntp-wait tries, Up: ntp-wait Invocation -
+

0.1.3 sleep option (-s)

This is the “how long to sleep between tries” option. -This option takes a number argument secs-between-tries. - We will sleep for secs-between-tries after each query +This option takes a number argument secs-between-tries. + We will sleep for secs-between-tries after each query of ntpd that returns "the time is not yet stable".

0.1.4 verbose option (-v)

@@ -171,35 +183,41 @@ This is the “be verbose” option. By default, ntp-wait is silent. With this option, ntp-wait will provide status information.
+ +


-Next: , +Next: , Previous: ntp-wait verbose, Up: ntp-wait Invocation -
+

0.1.5 ntp-wait 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. +
0 (EXIT_SUCCESS)
Successful program execution. +
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
+ +


-Next: , +Next: , Previous: ntp-wait exit status, Up: ntp-wait Invocation -
+

0.1.6 ntp-wait Authors

+ +


-Previous: ntp-wait Authors, +Previous: ntp-wait Authors, Up: ntp-wait Invocation -
+

0.1.7 ntp-wait Notes

diff --git a/scripts/ntpsweep/ntpsweep.html b/scripts/ntpsweep/ntpsweep.html index b44457bc5..1b54ca04b 100644 --- a/scripts/ntpsweep/ntpsweep.html +++ b/scripts/ntpsweep/ntpsweep.html @@ -3,7 +3,7 @@ ntpsweep User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

ntpsweep User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

This document describes the use of the NTP Project's ntpsweep program. @@ -44,9 +46,10 @@ Up: (dir)

-


-
+


+ +

0.1 Invoking ntpsweep

@@ -61,7 +64,7 @@ all peers. using the agtexi-cmd template and the option descriptions for the ntpsweep program. -

0.1.1 ntpsweep help/usage (--help)

+

0.1.1 ntpsweep help/usage (--help)

This is the automatically generated usage text for ntpsweep.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0.

ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p11
@@ -105,11 +109,13 @@ Options are specified by doubled hyphens and their name or by a single
 hyphen and the flag character.
 
+ +


-Next: , +Next: , Previous: ntpsweep usage, Up: ntpsweep Invocation -
+

0.1.2 host-list option (-l)

@@ -126,24 +132,26 @@ This option takes a string argument.

Use this option to specify the host on which this script operates. May appear multiple times.

0.1.3 peers option (-p)

This is the “recursively list all peers a host synchronizes to” option. -This option has no doc documentation. +This option has no ‘doc’ documentation.

+


-Next: , +Next: , Previous: ntpsweep peers, Up: ntpsweep Invocation -
+

0.1.4 maxlevel option (-m)

@@ -151,13 +159,14 @@ Up: ntpsweep Invocati

This is the “traverse peers up to this level (4 is a reasonable number)” option. This option takes a number argument. -This option has no doc documentation. +This option has no ‘doc’ documentation.

+


-Next: , +Next: , Previous: ntpsweep maxlevel, Up: ntpsweep Invocation -
+

0.1.5 strip option (-s)

@@ -165,13 +174,14 @@ Up: ntpsweep Invocati

This is the “strip this string from hostnames” option. This option takes a string argument. -This option has no doc documentation. +This option has no ‘doc’ documentation.

0.1.6 host option (-h)

@@ -179,22 +189,23 @@ Up: ntpsweep Invocati

This is the “specify a single host” option. This option takes a string argument. -This option has no doc documentation. +This option has no ‘doc’ documentation.

NOTE: THIS OPTION IS DEPRECATED

+


-Previous: ntpsweep host, +Previous: ntpsweep host, Up: ntpsweep Invocation -
+

0.1.7 ntpsweep 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. +
0 (EXIT_SUCCESS)
Successful program execution. +
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
diff --git a/scripts/ntptrace/ntptrace.html b/scripts/ntptrace/ntptrace.html index 53a16e9e0..a4d558406 100644 --- a/scripts/ntptrace/ntptrace.html +++ b/scripts/ntptrace/ntptrace.html @@ -3,7 +3,7 @@ Ntptrace User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

Ntptrace User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

Simple Network Time Protocol User Manual

@@ -46,10 +48,11 @@ This document applies to version 4.2.8p11 of ntptrace.
+


-Previous: ntptrace Description, +Previous: ntptrace Description, Up: Top -
+

Invoking ntptrace

@@ -80,7 +83,7 @@ defined in RFC-1305. using the agtexi-cmd template and the option descriptions for the ntptrace program. -

ntptrace help/usage (--help)

+

ntptrace help/usage (--help)

This is the automatically generated usage text for ntptrace.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0.

ntptrace - Trace peers of an NTP server - Ver. 4.2.8p11
@@ -120,11 +124,12 @@ Options are specified by doubled hyphens and their name or by a single
 hyphen and the flag character.
 
+


-Next: , +Next: , Previous: ntptrace usage, Up: ntptrace Invocation -
+

numeric option (-n)

@@ -134,11 +139,13 @@ This is the “print ip addresses instead of hostnames” option. Output hosts as dotted-quad numeric format rather than converting to the canonical host names.
+ +


-Next: , +Next: , Previous: ntptrace numeric, Up: ntptrace Invocation -
+

max-hosts option (-m)

@@ -146,13 +153,14 @@ Up: ntptrace Invocati

This is the “maximum number of peers to trace” option. This option takes a number argument. -This option has no doc documentation. +This option has no ‘doc’ documentation.

host option (-r)

@@ -160,20 +168,21 @@ Up: ntptrace Invocati

This is the “single remote host” option. This option takes a string argument. -This option has no doc documentation. +This option has no ‘doc’ documentation.

+


-Previous: ntptrace host, +Previous: ntptrace host, Up: ntptrace Invocation -
+

ntptrace 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. +
0 (EXIT_SUCCESS)
Successful program execution. +
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
diff --git a/scripts/plot_summary.html b/scripts/plot_summary.html index 6a2fac5ee..dd5b2f0bb 100644 --- a/scripts/plot_summary.html +++ b/scripts/plot_summary.html @@ -3,7 +3,7 @@ Plot_summary User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

Plot_summary User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

Plot_summary User Manual

@@ -46,10 +48,12 @@ This document applies to version 4.2.8p11 of plot_summary.
+ +


-Previous: plot_summary Description, +Previous: plot_summary Description, Up: Top -
+

Invoking plot_summary

@@ -60,7 +64,7 @@ Up: Top using the agtexi-cmd template and the option descriptions for the plot_summary program. -

plot_summary help/usage (--help)

+

plot_summary help/usage (--help)

This is the automatically generated usage text for plot_summary.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0.

plot_summary - plot statistics generated by summary script - Ver. 4.2.8p11
@@ -107,11 +113,13 @@ Options are specified by doubled hyphens and their name or by a single
 hyphen and the flag character.
 

directory option

@@ -122,11 +130,13 @@ This option takes a string argument. The directory where the plot_summary will search for the *_summary files generated by summary script.

identifier option

@@ -137,11 +147,13 @@ This option takes a string argument. Where does the plotted data come from, default to string "host" plus current hostname

peer option

@@ -158,11 +170,13 @@ This option takes a string argument.

By default the peer_summary plots are not generated. Use this option to specify list of peers if you want to generate plots for them.

plot-term option

@@ -175,11 +189,13 @@ This option takes a string argument. dumb is it's not'. See output from -e "set terminal") for the list of available options.

output-file option

@@ -189,18 +205,20 @@ This is the “output file” option. This option takes a str argument. Output file for gnuplot, default to stdout.

plot_summary 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. +
0 (EXIT_SUCCESS)
Successful program execution. +
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
diff --git a/scripts/summary.html b/scripts/summary.html index b6c226c04..25d064a93 100644 --- a/scripts/summary.html +++ b/scripts/summary.html @@ -3,7 +3,7 @@ Summary User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

Summary User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

Summary User Manual

@@ -46,10 +48,11 @@ This document applies to version 4.2.8p11 of summary.
+


-Previous: summary Description, +Previous: summary Description, Up: Top -
+

Invoking summary

@@ -60,7 +63,7 @@ Up: Top using the agtexi-cmd template and the option descriptions for the summary program. -

summary help/usage (--help)

+

summary help/usage (--help)

This is the automatically generated usage text for summary.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0.

summary - compute various stastics from NTP stat files - Ver. 4.2.8p11
@@ -104,11 +108,12 @@ Options are specified by doubled hyphens and their name or by a single
 hyphen and the flag character.
 
+


-Next: , +Next: , Previous: summary usage, Up: summary Invocation -
+

directory option

@@ -119,11 +124,13 @@ This option takes a string argument. The directory where ntpd will search for .stat files generated by ntpd.

end-date option

@@ -135,11 +142,13 @@ This option takes a number argument. option. Defaults to today minus one day (Use date -u +%Y%m%d) to get the timestamp.
+ +


-Next: , +Next: , Previous: summary end-date, Up: summary Invocation -
+

output-directory option

@@ -149,11 +158,13 @@ This is the “output directory” option. This option takes a str argument. The output directory summary will write all output files to.

start-date option

@@ -164,18 +175,19 @@ This option takes a num argument. Process all files with the date suffix more or equal to value of this option. Defaults to 197000101.
+


-Previous: summary start-date, +Previous: summary start-date, Up: summary Invocation -
+

summary 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. +
0 (EXIT_SUCCESS)
Successful program execution. +
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
diff --git a/scripts/update-leap/update-leap.html b/scripts/update-leap/update-leap.html index 030353037..935b80d4e 100644 --- a/scripts/update-leap/update-leap.html +++ b/scripts/update-leap/update-leap.html @@ -3,7 +3,7 @@ update-leap User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

update-leap User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

This document describes the use of the NTP Project's update-leap program. @@ -44,9 +46,11 @@ Up: (dir)

-


+ -
+


+ +

0.1 Invoking update-leap

@@ -82,7 +86,7 @@ This script depends on$REQUIREDCMDS using the agtexi-cmd template and the option descriptions for the update-leap program. -

0.1.1 update-leap help/usage (--help)

+

0.1.1 update-leap help/usage (--help)

This is the automatically generated usage text for update-leap.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0.

+Usage: update-leap [options]
+
+Verifies and if necessary, updates leap-second definition file
+
+All arguments are optional:  Default (or current value) shown:
+    -C    Absolute path to CA Cert (see SSL/TLS Considerations)
+    -D    Path to a CAdir (see SSL/TLS Considerations)
+    -e    Specify how long (in days) before expiration the file is to be
+              refreshed.  Note that larger values imply more frequent refreshes.
+          60
+    -F    Force update even if current file is OK and not close to expiring.
+    -f    Absolute path ntp.conf file (default /etc/ntp.conf)
+          /etc/ntp.conf
+    -h    show help
+    -i    Specify number of minutes between retries
+          10
+    -L    Absolute path to leapfile on the local system
+          (overrides value in ntp.conf)
+    -l    Specify the syslog(3) facility for logging
+          LOG_USER
+    -q    Only report errors (cannot be used with -v)
+    -r    Specify number of attempts to retrieve file
+          6
+    -s    Send output to syslog(3) - implied if STDOUT has no tty or redirected
+    -t    Send output to terminal - implied if STDOUT attached to terminal
+    -u    Specify the URL of the master copy to download
+          https://www.ietf.org/timezones/data/leap-seconds.list
+    -v    Verbose - show debug messages (cannot be used with -q)
+
+The following options are not (yet) implemented in the perl version:
+    -4    Use only IPv4
+    -6    Use only IPv6
+    -c    Command to restart NTP after installing a new file
+          <none> - ntpd checks file daily
+    -p 4|6
+          Prefer IPv4 or IPv6 (as specified) addresses, but use either
+
+update-leap will validate the file currently on the local system.
+
+Ordinarily, the leapfile is found using the 'leapfile' directive in
+/etc/ntp.conf.  However, an alternate location can be specified on the
+command line with the -L flag.
+
+If the leapfile does not exist, is not valid, has expired, or is
+expiring soon, a new copy will be downloaded.  If the new copy is
+valid, it is installed.
+
+If the current file is acceptable, no download or restart occurs.
+
+This can be run as a cron job.  As the file is rarely updated, and
+leap seconds are announced at least one month in advance (usually
+longer), it need not be run more frequently than about once every
+three weeks.
+
+SSL/TLS Considerations
+-----------------------
+The perl modules can usually locate the CA certificate used to verify
+the peer's identity.
+
+On BSDs, the default is typically the file /etc/ssl/certs.pem.  On
+Linux, the location is typically a path to a CAdir - a directory of
+symlinks named according to a hash of the certificates' subject names.
+
+The -C or -D options are available to pass in a location if no CA cert
+is found in the default location.
+
+External Dependencies
+---------------------
+The following perl modules are required:
+HTTP::Tiny         - version >= 0.056
+IO::Socket::SSL - version >= 1.56
+NET::SSLeay         - version >= 1.49
+
+Version: 1.004
 
+ +


-Next: , +Next: , Previous: update-leap usage, Up: update-leap Invocation -
+

0.1.2 source-url option (-s)

@@ -132,11 +214,13 @@ This option takes a string argument. Specify the URL of the master copy to download $LEAPSRC

0.1.3 ipv4 option (-4)

@@ -176,26 +260,30 @@ ipv6. doc = <<- _EndOfDoc_ Prefer IPv4 or IPv6 (as specified) addresses, but use either.

0.1.4 destination option (-d)

This is the “filename on the local system” option. -This option takes a string argument float. +This option takes a string argument float. The name to use to store the leapfile on the local system. $LEAPFILE

0.1.5 expiration option (-e)

@@ -208,11 +296,13 @@ Units are required, e.g. "-e 60 days" Note that larger values imply more frequent refreshes. "$PREFETCH"

0.1.6 ntp-conf-file option (-f)

@@ -224,11 +314,13 @@ Specify location of ntp.conf (used to make sure leapfile directive is present and to default leapfile) /etc/ntp.conf

0.1.7 force-update option (-F)

@@ -237,35 +329,41 @@ Up: update-lea This is the “force update of the leapfile” option. Force update even if current file is OK and not close to expiring.

0.1.8 update-leap 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. +
0 (EXIT_SUCCESS)
Successful program execution. +
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.

0.1.9 update-leap Usage

+ +


-Previous: update-leap Usage, +Previous: update-leap Usage, Up: update-leap Invocation -
+

0.1.10 update-leap Authors

diff --git a/sntp/sntp.html b/sntp/sntp.html index 912150474..84613e545 100644 --- a/sntp/sntp.html +++ b/sntp/sntp.html @@ -3,7 +3,7 @@ Sntp User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

Sntp User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

Simple Network Time Protocol User Manual

@@ -55,9 +57,10 @@ IETF specification.
-


-
+


+ +
@@ -76,9 +79,10 @@ the +4.567 +/- 0.089 secs indicates the time offset and error bound of the system clock relative to the server clock.
-


-
+


+ +

Invoking sntp

@@ -135,7 +139,7 @@ using the agtexi-cmd template and the option descriptions for the < This software is released under the NTP license, <http://ntp.org/license>.
+


-Next: , +Next: , Up: sntp Invocation -
+
-

sntp help/usage (--help)

+

sntp help/usage (--help)

This is the automatically generated usage text for sntp.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0.

sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p245
@@ -234,11 +239,12 @@ The following option preset mechanisms are supported:
 please send bug reports to:  http://bugs.ntp.org, bugs@ntp.org
 
+


-Next: , +Next: , Previous: sntp usage, Up: sntp Invocation -
+

ipv4 option (-4)

@@ -255,11 +261,12 @@ ipv6.

Force DNS resolution of the following host names on the command line to the IPv4 namespace.

+


-Next: , +Next: , Previous: sntp ipv4, Up: sntp Invocation -
+

ipv6 option (-6)

@@ -276,35 +283,37 @@ ipv4.

Force DNS resolution of the following host names on the command line to the IPv6 namespace.

+


-Next: , +Next: , Previous: sntp ipv6, Up: sntp Invocation -
+

authentication option (-a)

This is the “enable authentication with the key auth-keynumber” option. -This option takes a number argument auth-keynumber. +This option takes a number argument auth-keynumber. Enable authentication using the key specified in this option's -argument. The argument of this option is the keyid, a -number specified in the keyfile as this key's identifier. -See the keyfile option (-k) for more details. +argument. The argument of this option is the keyid, a +number specified in the keyfile as this key's identifier. +See the keyfile option (-k) for more details.

+


-Next: , +Next: , Previous: sntp authentication, Up: sntp Invocation -
+

broadcast option (-b)

This is the “listen to the address specified for broadcast time sync” option. -This option takes a string argument broadcast-address. +This option takes a string argument broadcast-address.

This option has some usage constraints. It:

    @@ -313,20 +322,21 @@ This option takes a string argument broadcast-address.

    If specified sntp will listen to the specified address for NTP broadcasts. The default maximum wait time -can (and probably should) be modified with -t. +can (and probably should) be modified with -t.

    +


    -Next: , +Next: , Previous: sntp broadcast, Up: sntp Invocation -
    +

    concurrent option (-c)

    This is the “concurrently query all ips returned for host-name” option. -This option takes a string argument host-name. +This option takes a string argument host-name.

    This option has some usage constraints. It:

      @@ -339,80 +349,85 @@ as part of a DNS lookup are assumed to be for a single instance of ntpd, and therefore sntp will send queries to these IPs one after another, with a 2-second gap in between each query. -

      The -c or --concurrent flag says that any IPs +

      The -c or --concurrent flag says that any IPs returned for the DNS lookup of the supplied host-name are on different machines, so we can send concurrent queries.

      +


      -Next: , +Next: , Previous: sntp concurrent, Up: sntp Invocation -
      +

      gap option (-g)

      This is the “the gap (in milliseconds) between time requests” option. -This option takes a number argument milliseconds. +This option takes a number argument milliseconds. Since we're only going to use the first valid response we get and there is benefit to specifying a good number of servers to query, separate the queries we send out by the specified number of milliseconds.

      +


      -Next: , +Next: , Previous: sntp gap, Up: sntp Invocation -
      +

      kod option (-K)

      This is the “kod history filename” option. -This option takes a file argument file-name. +This option takes a file argument file-name. Specifies the filename to be used for the persistent history of KoD responses received from servers. If the file does not exist, a warning message will be displayed. The file will not be created.

      +


      -Next: , +Next: , Previous: sntp kod, Up: sntp Invocation -
      +

      keyfile option (-k)

      -This is the “look in this file for the key specified with -a” option. -This option takes a file argument file-name. +This is the “look in this file for the key specified with -a” option. +This option takes a file argument file-name. This option specifies the keyfile. -sntp will search for the key specified with -a -keyno in this file. See ntp.keys(5) for more +sntp will search for the key specified with -a +keyno in this file. See ntp.keys(5) for more information.

      +


      -Next: , +Next: , Previous: sntp keyfile, Up: sntp Invocation -
      +

      logfile option (-l)

      This is the “log to specified logfile” option. -This option takes a file argument file-name. +This option takes a file argument file-name. This option causes the client to write log messages to the specified -logfile. +logfile.

      +


      -Next: , +Next: , Previous: sntp logfile, Up: sntp Invocation -
      +

      steplimit option (-M)

      @@ -420,17 +435,18 @@ Up: sntp Invocation

      This is the “adjustments less than steplimit msec will be slewed” option. This option takes a number argument. -If the time adjustment is less than steplimit milliseconds, -slew the amount using adjtime(2). Otherwise, step the -correction using settimeofday(2). The default value is 0, +If the time adjustment is less than steplimit milliseconds, +slew the amount using adjtime(2). Otherwise, step the +correction using settimeofday(2). The default value is 0, which means all adjustments will be stepped. This is a feature, as different situations demand different values.

      +


      -Next: , +Next: , Previous: sntp steplimit, Up: sntp Invocation -
      +

      ntpversion option (-o)

      @@ -439,13 +455,14 @@ Up: sntp Invocation This is the “send int as our ntp protocol version” option. This option takes a number argument. When sending requests to a remote server, tell them we are running -NTP protocol version ntpversion . +NTP protocol version ntpversion .
      +


      -Next: , +Next: , Previous: sntp ntpversion, Up: sntp Invocation -
      +

      usereservedport option (-r)

      @@ -455,29 +472,31 @@ This is the “use the ntp reserved port (port 123)” option. Use port 123, which is reserved for NTP, for our network communications.
      +


      -Next: , +Next: , Previous: sntp usereservedport, Up: sntp Invocation -
      +

      timeout option (-t)

      This is the “the number of seconds to wait for responses” option. -This option takes a number argument seconds. +This option takes a number argument seconds. When waiting for a reply, sntp will wait the number of seconds specified before giving up. The default should be more than enough for a unicast response. If sntp is only waiting for a broadcast response a longer timeout is likely needed.

      +


      -Next: , +Next: , Previous: sntp timeout, Up: sntp Invocation -
      +

      wait option

      @@ -494,11 +513,12 @@ This is the “wait for pending replies (if not setting the time)” opt

      If we are not setting the time, wait for all pending responses.

      +


      -Next: , +Next: , Previous: sntp wait, Up: sntp Invocation -
      +

      presetting/configuring sntp

      @@ -516,9 +536,9 @@ values are treated like option arguments.
    • $PWD
    The environment variables HOME, and PWD -are expanded and replaced when sntp runs. +are expanded and replaced when sntp runs. For any of these that are plain files, they are simply processed. -For any that are directories, then a file named .ntprc is searched for +For any that are directories, then a file named .ntprc is searched for within that directory and processed.

    Configuration files may be in a wide variety of formats. @@ -560,52 +580,56 @@ detail to provide. The default is to print just the version. The licensing inf Only the first letter of the argument is examined:

    -
    version
    Only print the version. This is the default. -
    copyright
    Name the copyright usage licensing terms. -
    verbose
    Print the full copyright usage licensing terms. +
    version
    Only print the version. This is the default. +
    copyright
    Name the copyright usage licensing terms. +
    verbose
    Print the full copyright usage licensing terms.
    +


    -Next: , +Next: , Previous: sntp config, Up: sntp Invocation -
    +

    sntp 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. -
    66 (EX_NOINPUT)
    A specified configuration file could not be loaded. -
    70 (EX_SOFTWARE)
    libopts had an internal operational error. Please report +
    0 (EXIT_SUCCESS)
    Successful program execution. +
    1 (EXIT_FAILURE)
    The operation failed or the command syntax was not valid. +
    66 (EX_NOINPUT)
    A specified configuration file could not be loaded. +
    70 (EX_SOFTWARE)
    libopts had an internal operational error. Please report it to autogen-users@lists.sourceforge.net. Thank you.
    +


    -Next: , +Next: , Previous: sntp exit status, Up: sntp Invocation -
    +

    sntp Usage

    +


    -Previous: sntp Usage, +Previous: sntp Usage, Up: sntp Invocation -
    +

    sntp Authors

    -


    -
    +


    + +