+(4.2.7p339) 2012/12/26 Released by Harlan Stenn <stenn@ntp.org>
* mdoc2texi fixes: parseQuote, closing of list item tables.
* ntp-wait, ntpd, ntpdc, ntpq, ntpsnmpd autogen documentation updates.
(4.2.7p338) 2012/12/25 Released by Harlan Stenn <stenn@ntp.org>
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp.conf.texi)
#
-# It has been AutoGen-ed December 25, 2012 at 11:32:50 AM by AutoGen 5.16.2
+# It has been AutoGen-ed December 25, 2012 at 12:49:13 PM by AutoGen 5.16.2
# From the definitions ntp.conf.def
# and the template file agtexi-file.tpl
@end ignore
@sc{UNIX}
configuration files.
Comments begin with a
-@quoteleft{}#@quoteright{}
+@quoteleft{}@quoteright{}#
+#
character and extend to the end of the line;
blank lines are ignored.
Configuration commands consist of an initial keyword
[@code{minpoll} @code{minpoll} ]
[@code{maxpoll} @code{maxpoll} ]
[@code{ttl} @code{ttl} ]
-
-@end multitable
+@end table
These five commands specify the time server name or address to
be used and the mode in which to operate.
@code{server} command.
The remaining servers are discarded as if never
heard.
-
-@end multitable
+@end table
Options:
@table @samp
packets.
Versions 1-4 are the choices, with version 4 the
default.
-
-@end multitable
+@end table
@node Auxiliary
@section Auxiliary
@ref{Authentication}Authentication
Options
.
-
-@end multitable
+@end table
@node Authentication
@section Authentication
in the keys directory.
If this file is
not found, the host key is also the sign key.
-
-@end multitable
+@end table
.It
Ic
keys
@item 114
(bad or missing identity)
The identity key is missing, corrupt or bogus.
-
-@end multitable
+@end table
@node Monitoring
@section Monitoring
Number of packets not verified as authentic.
@item Rate
Number of packets discarded due to rate limitation.
-
-@end multitable
+@end table
.It
Cm
statsdir
@item Cm
This string is directly concatenated to the prefix mentioned
above (no intervening
-@quoteleft{}/ ) .@quoteright{}
+@quoteleft{}@quoteright{}/).
+/
+)
+.
This can be modified using
the file argument to the
@code{filegen} statement.
This part is reflects individual elements of a file set.
It is
generated according to the type of a file set.
-
-@end multitable
+@end table
.It
Cm
type
running at the start of the corresponding 24-hour period.
Information is only written to a file generation by specifying
@code{enable}; output is prevented by specifying
-@code{disable}.
-@end multitable
+@code{disable}. @end table
.It
Cm
link
is sorted later in the list.
@item Cm
Deny packets that do not match the current NTP version.
-
-@end multitable
+@end table
Default restriction list entries with the flags ignore, interface,
ntpport, for each of the local host's interface addresses are
Byzantine agreement,
@code{minsane} should be at least 4 in order to detect and discard
a single falseticker.
-
-@end multitable
+@end table
.It
Cm
ttl
@code{minpoll} defaults to 10 (17.1 m) and
@code{maxpoll} defaults to 14 (4.5 h).
The allowable range is 4 (16 s) to 17 (36.4 h) inclusive.
-
-@end multitable
+@end table
.It
Xo
Ic
@ref{Monitoring}Monitoring
Options
.
-
-@end multitable
+@end table
@end multitable
@node Miscellaneous
Options
section for further information.
The default for this flag is
-@code{disable}.
-@end multitable
+@code{disable}. @end table
.It
Ic
includefile
By default, all output is turned on.
All
@code{configkeyword} keywords can be prefixed with
-@quoteleft{}= ,@quoteright{}
-@quoteleft{}+@quoteright{}
+@quoteleft{}@quoteright{}=,
+=
+,
+@quoteleft{}@quoteright{}+
++
and
-@quoteleft{}- ,@quoteright{}
+@quoteleft{}@quoteright{}-,
+-
+,
where
-@quoteleft{}=@quoteright{}
+@quoteleft{}@quoteright{}=
+=
sets the
@code{syslog(3)}
priority mask,
-@quoteleft{}+@quoteright{}
+@quoteleft{}@quoteright{}+
++
adds and
-@quoteleft{}-@quoteright{}
+@quoteleft{}@quoteright{}-
+-
removes
messages.
@code{syslog(3)}
be set to any positive number in seconds.
If set to zero, the stepout
pulses will not be suppressed.
-
-@end multitable
+@end table
.It
Xo
Ic
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp.keys.texi)
#
-# It has been AutoGen-ed December 25, 2012 at 11:34:16 AM by AutoGen 5.16.2
+# It has been AutoGen-ed December 26, 2012 at 04:09:53 AM by AutoGen 5.16.2
# From the definitions ntp.keys.def
# and the template file agtexi-file.tpl
@end ignore
@item Li
The key is a hex-encoded ASCII string of 40 characters,
which is truncated as necessary.
-
-@end multitable
+@end table
Note that the keys used by the
@code{ntpq(8)}
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpd.texi)
#
-# It has been AutoGen-ed December 25, 2012 at 11:34:26 AM by AutoGen 5.16.2
+# It has been AutoGen-ed December 26, 2012 at 04:10:31 AM by AutoGen 5.16.2
# From the definitions ntpd-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntpd - NTP daemon program - Ver. 4.2.7p338
+ntpd - NTP daemon program - Ver. 4.2.7p339
USAGE: ntpd [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
[ <server1> ... <serverN> ]
Flg Arg Option-Name Description
the default name of the drift file
@item Pa
the default name of the key file
-
-@end multitable
+@end table
@node ntpd See Also
@subsection ntpd See Also
@code{ntp.conf(5)},
-.TH ntp.conf 5man "25 Dec 2012" "4.2.7p338" "File Formats"
+.TH ntp.conf 5man "25 Dec 2012" "4.2.7p339" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:32:38 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 25, 2012 at 12:49:00 PM by AutoGen 5.16.2
.\" From the definitions ntp.conf.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTP_CONF 5mdoc File Formats
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:34:28 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:10:33 AM by AutoGen 5.16.2
.\" From the definitions ntp.conf.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<p>This document describes the configuration file for the NTP Project's
<code>ntpd</code> program.
- <p>This document applies to version 4.2.7p338 of <code>ntp.conf</code>.
+ <p>This document applies to version 4.2.7p339 of <code>ntp.conf</code>.
<ul class="menu">
<li><a accesskey="1" href="#ntp_002econf-Description">ntp.conf Description</a>
<p>The rest of this page describes the configuration and control options.
The
-"NotesonConfiguringNTPandSettingupaNTPSubnet"
+"Notes on Configuring NTP and Setting up a NTP Subnet"
page
(available as part of the HTML documentation
provided in
<span class="file">/usr/share/doc/ntp</span>)
-)
contains an extended discussion of these options.
In addition to the discussion of general
<a href="#Configuration">Configuration</a>Configuration
<dl>
<dt><span class="samp">Xo</span><dd>[<code>burst</code> ]
[<code>iburst</code> ]
-[<code>version</code> <code>Ar</code> <code>version</code> ]
+[<code>version</code> <code>version</code> ]
[<code>prefer</code> ]
-[<code>minpoll</code> <code>Ar</code> <code>minpoll</code> ]
-[<code>maxpoll</code> <code>Ar</code> <code>maxpoll</code> ]
-<br><dt><span class="samp">Xo</span><dd>[<code>key</code> <code>Ar</code> <code>key</code>\&| <code>Cm</code> <code>autokey</code> ]
+[<code>minpoll</code> <code>minpoll</code> ]
+[<code>maxpoll</code> <code>maxpoll</code> ]
+<br><dt><span class="samp">Xo</span><dd>[<code>key</code> <code>key</code> <code>\&|</code> <code>Cm</code> <code>autokey</code> ]
[<code>burst</code> ]
[<code>iburst</code> ]
-[<code>version</code> <code>Ar</code> <code>version</code> ]
+[<code>version</code> <code>version</code> ]
[<code>prefer</code> ]
-[<code>minpoll</code> <code>Ar</code> <code>minpoll</code> ]
-[<code>maxpoll</code> <code>Ar</code> <code>maxpoll</code> ]
-<br><dt><span class="samp">Xo</span><dd>[<code>key</code> <code>Ar</code> <code>key</code>\&| <code>Cm</code> <code>autokey</code> ]
-[<code>version</code> <code>Ar</code> <code>version</code> ]
+[<code>minpoll</code> <code>minpoll</code> ]
+[<code>maxpoll</code> <code>maxpoll</code> ]
+<br><dt><span class="samp">Xo</span><dd>[<code>key</code> <code>key</code> <code>\&|</code> <code>Cm</code> <code>autokey</code> ]
+[<code>version</code> <code>version</code> ]
[<code>prefer</code> ]
-[<code>minpoll</code> <code>Ar</code> <code>minpoll</code> ]
-[<code>maxpoll</code> <code>Ar</code> <code>maxpoll</code> ]
-<br><dt><span class="samp">Xo</span><dd>[<code>key</code> <code>Ar</code> <code>key</code>\&| <code>Cm</code> <code>autokey</code> ]
-[<code>version</code> <code>Ar</code> <code>version</code> ]
+[<code>minpoll</code> <code>minpoll</code> ]
+[<code>maxpoll</code> <code>maxpoll</code> ]
+<br><dt><span class="samp">Xo</span><dd>[<code>key</code> <code>key</code> <code>\&|</code> <code>Cm</code> <code>autokey</code> ]
+[<code>version</code> <code>version</code> ]
[<code>prefer</code> ]
-[<code>minpoll</code> <code>Ar</code> <code>minpoll</code> ]
-[<code>ttl</code> <code>Ar</code> <code>ttl</code> ]
-<br><dt><span class="samp">Xo</span><dd>[<code>key</code> <code>Ar</code> <code>key</code>\&| <code>Cm</code> <code>autokey</code> ]
-[<code>version</code> <code>Ar</code> <code>version</code> ]
+[<code>minpoll</code> <code>minpoll</code> ]
+[<code>ttl</code> <code>ttl</code> ]
+<br><dt><span class="samp">Xo</span><dd>[<code>key</code> <code>key</code> <code>\&|</code> <code>Cm</code> <code>autokey</code> ]
+[<code>version</code> <code>version</code> ]
[<code>prefer</code> ]
-[<code>minpoll</code> <code>Ar</code> <code>minpoll</code> ]
-[<code>maxpoll</code> <code>Ar</code> <code>maxpoll</code> ]
-[<code>ttl</code> <code>Ar</code> <code>ttl</code> ]
+[<code>minpoll</code> <code>minpoll</code> ]
+[<code>maxpoll</code> <code>maxpoll</code> ]
+[<code>ttl</code> <code>ttl</code> ]
<p>These five commands specify the time server name or address to
be used and the mode in which to operate.
The
-<kbd>address</kbd> can be
+<code>address</code> can be
either a DNS name or an IP address in dotted-quad notation.
Additional information on association behavior can be found in the
-"AssociationManagement"
+"Association Management"
page
(available as part of the HTML documentation
provided in
-<span class="file">/usr/share/doc/ntp</span>).
-)
-.
+<span class="file">/usr/share/doc/ntp</span>).
<dl>
<dt><span class="samp">Ic</span><dd>For type s addresses, this command mobilizes a persistent
client mode association with a number of remote servers.
subnet specified, but multicast messages go to all interfaces.
In broadcast mode the local server sends periodic broadcast
messages to a client population at the
-<kbd>address</kbd> specified, which is usually the broadcast address on (one of) the
+<code>address</code> specified, which is usually the broadcast address on (one of) the
local network(s) or a multicast address assigned to NTP.
The IANA
has assigned the multicast group address IPv4 224.0.1.1 and
The
client broadcasts a request message to the group address associated
with the specified
-<kbd>address</kbd> and specifically enabled
+<code>address</code> and specifically enabled
servers respond to these messages.
The client selects the servers
providing the best time and continues as with the
<code>-q</code> option.
<br><dt><span class="samp">Cm</span><dd>All packets sent to and received from the server or peer are to
include authentication fields encrypted using the specified
-<kbd>key</kbd> identifier with values from 1 to 65534, inclusive.
+<code>key</code> identifier with values from 1 to 65534, inclusive.
The
default is to include no encryption field.
<br><dt><span class="samp">Cm</span><br><dt><span class="samp">Cm</span><dd>These options specify the minimum and maximum poll intervals
this host will be chosen for synchronization among a set of
correctly operating hosts.
See the
-"MitigationRulesandthepreferKeyword"
+"Mitigation Rules and the prefer Keyword"
page
(available as part of the HTML documentation
provided in
<span class="file">/usr/share/doc/ntp</span>)
-)
for further information.
<br><dt><span class="samp">Cm</span><dd>This option is used only with broadcast server and manycast
client modes.
It specifies the time-to-live
-<kbd>ttl</kbd> to
+<code>ttl</code> to
use on broadcast server and multicast server and the maximum
-<kbd>ttl</kbd> for the expanding ring search with manycast
+<code>ttl</code> for the expanding ring search with manycast
client packets.
Selection of the proper value, which defaults to
127, is something of a black art and should be coordinated with the
related information are specified in a key
file, usually called
<span class="file">ntp.keys</span>,
-,
which must be distributed and stored using
secure means beyond the scope of the NTP protocol itself.
Besides the keys used
utility, which uses the standard
protocol defined in RFC-1305.
The
-<kbd>key</kbd> argument is
+<code>key</code> argument is
the key identifier for a trusted key, where the value can be in the
range 1 to 65,534, inclusive.
-<br><dt><span class="samp">Xo</span><dd>[<code>cert</code> <code>Ar</code> <code>file</code> ]
-[<code>leap</code> <code>Ar</code> <code>file</code> ]
-[<code>randfile</code> <code>Ar</code> <code>file</code> ]
-[<code>host</code> <code>Ar</code> <code>file</code> ]
-[<code>sign</code> <code>Ar</code> <code>file</code> ]
-[<code>gq</code> <code>Ar</code> <code>file</code> ]
-[<code>gqpar</code> <code>Ar</code> <code>file</code> ]
-[<code>iffpar</code> <code>Ar</code> <code>file</code> ]
-[<code>mvpar</code> <code>Ar</code> <code>file</code> ]
-[<code>pw</code> <code>Ar</code> <code>password</code> ]
+<br><dt><span class="samp">Xo</span><dd>[<code>cert</code> <code>file</code> ]
+[<code>leap</code> <code>file</code> ]
+[<code>randfile</code> <code>file</code> ]
+[<code>host</code> <code>file</code> ]
+[<code>sign</code> <code>file</code> ]
+[<code>gq</code> <code>file</code> ]
+[<code>gqpar</code> <code>file</code> ]
+[<code>iffpar</code> <code>file</code> ]
+[<code>mvpar</code> <code>file</code> ]
+[<code>pw</code> <code>password</code> ]
This command requires the OpenSSL library.
It activates public key
cryptography, selects the message digest and signature
in the
<code>keysdir</code> command or default
<span class="file">/usr/local/etc</span>.
-.
Following are the subcommands:
<dl>
<dt><span class="samp">Cm</span><dd>Specifies the location of the required host public certificate file.
This overrides the link
<span class="file">ntpkey_cert_</span>NsArhostname
-Ns
-Ar
-hostname
in the keys directory.
<br><dt><span class="samp">Cm</span><dd>Specifies the location of the optional GQ parameters file.
This
overrides the link
<span class="file">ntpkey_gq_</span>NsArhostname
-Ns
-Ar
-hostname
in the keys directory.
<br><dt><span class="samp">Cm</span><dd>Specifies the location of the required host key file.
This overrides
the link
<span class="file">ntpkey_key_</span>NsArhostname
-Ns
-Ar
-hostname
in the keys directory.
<br><dt><span class="samp">Cm</span><dd>Specifies the location of the optional IFF parameters file.This
overrides the link
<span class="file">ntpkey_iff_</span>NsArhostname
-Ns
-Ar
-hostname
in the keys directory.
<br><dt><span class="samp">Cm</span><dd>Specifies the location of the optional leapsecond file.
This overrides the link
This
overrides the link
<span class="file">ntpkey_mv_</span>NsArhostname
-Ns
-Ar
-hostname
in the keys directory.
<br><dt><span class="samp">Cm</span><dd>Specifies the password to decrypt files containing private keys and
identity parameters.
This overrides
the link
<span class="file">ntpkey_sign_</span>NsArhostname
-Ns
-Ar
-hostname
in the keys directory.
If this file is
not found, the host key is also the sign key.
cryptographic keys, parameters and certificates.
The default is
<span class="file">/usr/local/etc/</span>.
-.
.It
Ic
requestkey
proprietary protocol specific to this implementation of
<code>ntpd(1ntpdmdoc)</code>.
The
-<kbd>key</kbd> argument is a key identifier
+<code>key</code> argument is a key identifier
for the trusted key, where the value can be in the range 1 to
65,534, inclusive.
.It
purpose, although different keys can be used with different
servers.
The
-<kbd>key</kbd> arguments are 32-bit unsigned
+<code>key</code> arguments are 32-bit unsigned
integers with values from 1 to 65,534.
<div class="node">
The following error codes are reported via the NTP control
and monitoring protocol trap mechanism.
<dl>
-<dt><span class="samp">101</span><dd>(badfieldformatorlength)
+<dt><span class="samp">101</span><dd>(bad field format or length)
The packet has invalid version, length or format.
-<br><dt><span class="samp">102</span><dd>(badtimestamp)
+<br><dt><span class="samp">102</span><dd>(bad timestamp)
The packet timestamp is the same or older than the most recent received.
This could be due to a replay or a server clock time step.
-<br><dt><span class="samp">103</span><dd>(badfilestamp)
+<br><dt><span class="samp">103</span><dd>(bad filestamp)
The packet filestamp is the same or older than the most recent received.
This could be due to a replay or a key file generation error.
-<br><dt><span class="samp">104</span><dd>(badormissingpublickey)
+<br><dt><span class="samp">104</span><dd>(bad or missing public key)
The public key is missing, has incorrect format or is an unsupported type.
-<br><dt><span class="samp">105</span><dd>(unsupporteddigesttype)
+<br><dt><span class="samp">105</span><dd>(unsupported digest type)
The server requires an unsupported digest/signature scheme.
-<br><dt><span class="samp">106</span><dd>(mismatcheddigesttypes)
+<br><dt><span class="samp">106</span><dd>(mismatched digest types)
Not used.
-<br><dt><span class="samp">107</span><dd>(badsignaturelength)
+<br><dt><span class="samp">107</span><dd>(bad signature length)
The signature length does not match the current public key.
-<br><dt><span class="samp">108</span><dd>(signaturenotverified)
+<br><dt><span class="samp">108</span><dd>(signature not verified)
The message fails the signature check.
It could be bogus or signed by a
different private key.
-<br><dt><span class="samp">109</span><dd>(certificatenotverified)
+<br><dt><span class="samp">109</span><dd>(certificate not verified)
The certificate is invalid or signed with the wrong key.
-<br><dt><span class="samp">110</span><dd>(certificatenotverified)
+<br><dt><span class="samp">110</span><dd>(certificate not verified)
The certificate is not yet valid or has expired or the signature could not
be verified.
-<br><dt><span class="samp">111</span><dd>(badormissingcookie)
+<br><dt><span class="samp">111</span><dd>(bad or missing cookie)
The cookie is missing, corrupted or bogus.
-<br><dt><span class="samp">112</span><dd>(badormissingleapsecondstable)
+<br><dt><span class="samp">112</span><dd>(bad or missing leapseconds table)
The leapseconds table is missing, corrupted or bogus.
-<br><dt><span class="samp">113</span><dd>(badormissingcertificate)
+<br><dt><span class="samp">113</span><dd>(bad or missing certificate)
The certificate is missing, corrupted or bogus.
-<br><dt><span class="samp">114</span><dd>(badormissingidentity)
+<br><dt><span class="samp">114</span><dd>(bad or missing identity)
The identity key is missing, corrupt or bogus.
<div class="node">
<dl>
<dt><span class="samp">Ic</span><dd>Enables writing of statistics records.
Currently, four kinds of
-<kbd>name</kbd> statistics are supported.
+<code>name</code> statistics are supported.
<dl>
<dt><span class="samp">Cm</span><dd>Enables recording of clock driver statistics information.
Each update
Ar
name
Xo
-[<code>file</code> <code>Ar</code> <code>filename</code> ]
-[<code>type</code> <code>Ar</code> <code>typename</code> ]
+[<code>file</code> <code>filename</code> ]
+[<code>type</code> <code>typename</code> ]
[<code>link</code> | <code>nolink</code> ]
[<code>enable</code> | <code>disable</code> ]
Configures setting of generation file set name.
<br><dt><span class="samp">Cm</span><dd>This is the file name for the statistics records.
Filenames of set
members are built from three concatenated elements
-<kbd>Cm</kbd> <kbd>prefix</kbd>, <kbd>Cm</kbd> <kbd>filename</kbd> and
-<kbd>Cm</kbd> <kbd>suffix</kbd>:
+<code>Cm</code> <code>prefix</code>, <code>Cm</code> <code>filename</code> and
+<code>Cm</code> <code>suffix</code>:
<dl>
<dt><span class="samp">Cm</span><dd>This is a constant filename path.
It is not subject to
modifications via the
-<kbd>filegen</kbd> option.
+<code>filegen</code> option.
It is defined by the
server, usually specified as a compile-time constant.
It may,
however, be configurable for individual file generation sets
via other commands.
For example, the prefix used with
-<kbd>loopstats</kbd> and
-<kbd>peerstats</kbd> generation can be configured using the
-<kbd>statsdir</kbd> option explained above.
+<code>loopstats</code> and
+<code>peerstats</code> generation can be configured using the
+<code>statsdir</code> option explained above.
<br><dt><span class="samp">Cm</span><dd>This string is directly concatenated to the prefix mentioned
above (no intervening
-/).
+/ ) .
This can be modified using
the file argument to the
-<kbd>filegen</kbd> statement.
+<code>filegen</code> statement.
No
<span class="file">..</span>
elements are
allowed in this component to prevent filenames referring to
parts outside the filesystem hierarchy denoted by
-<kbd>prefix</kbd>. <br><dt><span class="samp">Cm</span><dd>This part is reflects individual elements of a file set.
+<code>prefix</code>. <br><dt><span class="samp">Cm</span><dd>This part is reflects individual elements of a file set.
It is
generated according to the type of a file set.
The set member filename is built by appending a
\&.
to concatenated
-<kbd>prefix</kbd> and
-<kbd>filename</kbd> strings, and
+<code>prefix</code> and
+<code>filename</code> strings, and
appending the decimal representation of the process ID of the
<code>ntpd(1ntpdmdoc)</code>
server process.
<code>dd</code> is a two digit day number.
Thus, all information written at 10 December 1992 would end up
in a file named
-<kbd>prefix</kbd> <kbd>filename</kbd> <kbd>Ns</kbd>.19921210. <br><dt><span class="samp">Cm</span><dd>Any file set member contains data related to a certain week of
+<code>prefix</code> <code>filename</code> <code>Ns</code> <code>.19921210</code>. <br><dt><span class="samp">Cm</span><dd>Any file set member contains data related to a certain week of
a year.
The term week is defined by computing day-of-year
modulo 7.
last match found defining the restriction flags associated
with the entry.
Additional information and examples can be found in the
-"NotesonConfiguringNTPandSettingupaNTPSubnet"
+"Notes on Configuring NTP and Setting up a NTP Subnet"
page
(available as part of the HTML documentation
provided in
-<span class="file">/usr/share/doc/ntp</span>).
-)
-.
+<span class="file">/usr/share/doc/ntp</span>).
<p>The restriction facility was implemented in conformance
with the access policies for the original NSFnet backbone
Control
Commands
<dl>
-<dt><span class="samp">Xo</span><dd>[<code>average</code> <code>Ar</code> <code>avg</code> ]
-[<code>minimum</code> <code>Ar</code> <code>min</code> ]
-[<code>monitor</code> <code>Ar</code> <code>prob</code> ]
+<dt><span class="samp">Xo</span><dd>[<code>average</code> <code>avg</code> ]
+[<code>minimum</code> <code>min</code> ]
+[<code>monitor</code> <code>prob</code> ]
Set the parameters of the
<code>limited</code> facility which protects the server from
client abuse.
minimum average and minimum are 5 and 2, respectively.
The monitor subcommand specifies the probability of discard
for packets that overflow the rate-control window.
-<br><dt><span class="samp">Xo</span><dd>[<code>mask</code> <code>Ar</code> <code>mask</code> ]
-[<kbd>flag</kbd>... ]
+<br><dt><span class="samp">Xo</span><dd>[<code>mask</code> <code>mask</code> ]
+[<code>flag</code> <code>...</code> ]
The
-<kbd>address</kbd> argument expressed in
+<code>address</code> argument expressed in
dotted-quad form is the address of a host or network.
Alternatively, the
-<kbd>address</kbd> argument can be a valid host DNS name.
+<code>address</code> argument can be a valid host DNS name.
The
-<kbd>mask</kbd> argument expressed in dotted-quad form defaults to
-255.255.255.255, meaning that the
-<kbd>address</kbd> is treated as the address of an individual host.
+<code>mask</code> argument expressed in dotted-quad form defaults to
+<code>255.255.255.255</code>, meaning that the
+<code>address</code> is treated as the address of an individual host.
A default entry (address
-0.0.0.0, mask
-0.0.0.0) is always included and is always the first entry in the list.
+<code>0.0.0.0</code>, mask
+<code>0.0.0.0</code>) is always included and is always the first entry in the list.
Note that text string
<code>default</code>, with no mask option, may
be used to indicate the default entry.
Options
<dl>
<dt><span class="samp">Xo</span><dd>.Oo
-<code>ceiling</code> <code>Ar</code> <code>ceiling</code> | <code>cohort</code> <code>0</code> | <code>1</code> | <code>floor</code> <code>Ar</code> <code>floor</code> | <code>minclock</code> <code>Ar</code> <code>minclock</code> | <code>minsane</code> <code>Ar</code> <code>minsane</code> .Oc
+<code>ceiling</code> <code>ceiling</code> | <code>cohort</code> <code>0</code> | <code>1</code> | <code>floor</code> <code>floor</code> | <code>minclock</code> <code>minclock</code> | <code>minsane</code> <code>minsane</code> .Oc
This command affects the clock selection and clustering
algorithms.
It can be used to select the quality and
used for backup or when no other clock source is available.
Detailed descriptions of individual device drivers and options can
be found in the
-"ReferenceClockDrivers"
+"Reference Clock Drivers"
page
(available as part of the HTML documentation
provided in
<span class="file">/usr/share/doc/ntp</span>).
-)
-.
Additional information can be found in the pages linked
there, including the
-"DebuggingHintsforReferenceClockDrivers"
+"Debugging Hints for Reference Clock Drivers"
and
-"HowToWriteaReferenceClockDriver"
+"How To Write a Reference Clock Driver"
pages
(available as part of the HTML documentation
provided in
<span class="file">/usr/share/doc/ntp</span>).
-)
-.
In addition, support for a PPS
signal is available as described in the
-"Pulse-per-second(PPS)SignalInterfacing"
+"Pulse-per-second (PPS) Signal Interfacing"
page
(available as part of the HTML documentation
provided in
<span class="file">/usr/share/doc/ntp</span>).
-)
-.
Many
drivers support special line discipline/streams modules which can
significantly improve the accuracy using the driver.
These are
described in the
-"LineDisciplinesandStreamsDrivers"
+"Line Disciplines and Streams Drivers"
page
(available as part of the HTML documentation
provided in
-<span class="file">/usr/share/doc/ntp</span>).
-)
-.
+<span class="file">/usr/share/doc/ntp</span>).
<p>A reference clock will generally (though not always) be a radio
timecode receiver which is synchronized to a source of standard
.Sm
on
where
-<kbd>t</kbd> is an integer
+<code>t</code> is an integer
denoting the clock type and
-<kbd>u</kbd> indicates the unit
+<code>u</code> indicates the unit
number in the range 0-3.
While it may seem overkill, it is in fact
sometimes useful to configure multiple reference clocks of the same
<p>The
<code>server</code> command is used to configure a reference
clock, where the
-<kbd>address</kbd> argument in that command
+<code>address</code> argument in that command
is the clock address.
The
<code>key</code>, <code>version</code> and
enthusiasm than other reference clocks or peers.
Further
information on this option can be found in the
-"MitigationRulesandthepreferKeyword"
+"Mitigation Rules and the prefer Keyword"
(available as part of the HTML documentation
provided in
<span class="file">/usr/share/doc/ntp</span>)
-)
page.
The
<code>minpoll</code> and
immediately after the
<code>server</code> command.
The
-<kbd>address</kbd> argument specifies the clock address.
+<code>address</code> argument specifies the clock address.
The
<code>refid</code> and
<code>stratum</code> options can be used to
.Sm
on
[<code>prefer</code> ]
-[<code>mode</code> <code>Ar</code> <code>int</code> ]
-[<code>minpoll</code> <code>Ar</code> <code>int</code> ]
-[<code>maxpoll</code> <code>Ar</code> <code>int</code> ]
+[<code>mode</code> <code>int</code> ]
+[<code>minpoll</code> <code>int</code> ]
+[<code>maxpoll</code> <code>int</code> ]
This command can be used to configure reference clocks in
special ways.
The options are interpreted as follows:
equal, this host will be chosen for synchronization among a set of
correctly operating hosts.
See the
-"MitigationRulesandthepreferKeyword"
+"Mitigation Rules and the prefer Keyword"
page
(available as part of the HTML documentation
provided in
<span class="file">/usr/share/doc/ntp</span>)
-)
for further information.
<br><dt><span class="samp">Cm</span><dd>Specifies a mode number which is interpreted in a
device-specific fashion.
u
.Sm
on
-[<code>time1</code> <code>Ar</code> <code>sec</code> ]
-[<code>time2</code> <code>Ar</code> <code>sec</code> ]
-[<code>stratum</code> <code>Ar</code> <code>int</code> ]
-[<code>refid</code> <code>Ar</code> <code>string</code> ]
-[<code>mode</code> <code>Ar</code> <code>int</code> ]
-[<code>flag1</code> <code>Cm</code> <code>0</code>\&| <code>Cm</code> <code>1</code> ]
-[<code>flag2</code> <code>Cm</code> <code>0</code>\&| <code>Cm</code> <code>1</code> ]
-[<code>flag3</code> <code>Cm</code> <code>0</code>\&| <code>Cm</code> <code>1</code> ]
-[<code>flag4</code> <code>Cm</code> <code>0</code>\&| <code>Cm</code> <code>1</code> ]
+[<code>time1</code> <code>sec</code> ]
+[<code>time2</code> <code>sec</code> ]
+[<code>stratum</code> <code>int</code> ]
+[<code>refid</code> <code>string</code> ]
+[<code>mode</code> <code>int</code> ]
+[<code>flag1</code> <code>Cm</code> <code>0</code> <code>\&|</code> <code>Cm</code> <code>1</code> ]
+[<code>flag2</code> <code>Cm</code> <code>0</code> <code>\&|</code> <code>Cm</code> <code>1</code> ]
+[<code>flag3</code> <code>Cm</code> <code>0</code> <code>\&|</code> <code>Cm</code> <code>1</code> ]
+[<code>flag4</code> <code>Cm</code> <code>0</code> <code>\&|</code> <code>Cm</code> <code>1</code> ]
This command can be used to configure reference clocks in
special ways.
It must immediately follow the
<a href="#Miscellaneous">Miscellaneous</a>Miscellaneous
Options
page and operates as described in the
-"ReferenceClockDrivers"
+"Reference Clock Drivers"
page
(available as part of the HTML documentation
provided in
<span class="file">/usr/share/doc/ntp</span>).
-)
-.
<br><dt><span class="samp">Cm</span><dd>Specifies a fixed-point decimal number in seconds, which is
interpreted in a driver-dependent way.
See the descriptions of
specific drivers in the
-"ReferenceClockDrivers"
+"Reference Clock Drivers"
page
(available as part of the HTML documentation
provided in
<span class="file">/usr/share/doc/ntp</span>).
-)
-.
<br><dt><span class="samp">Cm</span><dd>Specifies the stratum number assigned to the driver, an integer
between 0 and 15.
This number overrides the default stratum number
-.TH ntp.conf 5 "25 Dec 2012" "4.2.7p338" "File Formats"
+.TH ntp.conf 5 "25 Dec 2012" "4.2.7p339" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:32:38 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 25, 2012 at 12:49:00 PM by AutoGen 5.16.2
.\" From the definitions ntp.conf.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTP_CONF 5 File Formats
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:34:28 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:10:33 AM by AutoGen 5.16.2
.\" From the definitions ntp.conf.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
-.TH ntp.keys 5man "25 Dec 2012" "4.2.7p338" "File Formats"
+.TH ntp.keys 5man "25 Dec 2012" "4.2.7p339" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:32:41 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 25, 2012 at 12:49:03 PM by AutoGen 5.16.2
.\" From the definitions ntp.keys.def
.\" and the template file agman-file.tpl
.\"
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTP_KEYS 5mdoc File Formats
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:34:30 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:10:35 AM by AutoGen 5.16.2
.\" From the definitions ntp.keys.def
.\" and the template file agmdoc-file.tpl
.Sh NAME
<p>This document describes the symmetric key file for the NTP Project's
<code>ntpd</code> program.
- <p>This document applies to version 4.2.7p338 of <code>ntp.keys</code>.
+ <p>This document applies to version 4.2.7p339 of <code>ntp.keys</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
<p>This document describes the format of an NTP symmetric key file.
For a description of the use of this type of file, see the
-"AuthenticationSupport"
+"Authentication Support"
section of the
<code>ntp.conf(5)</code>
page.
key
<p>where
-<kbd>keyno</kbd> is a positive integer (between 1 and 65534),
-<kbd>type</kbd> is the message digest algorithm,
+<code>keyno</code> is a positive integer (between 1 and 65534),
+<code>type</code> is the message digest algorithm,
and
-<kbd>key</kbd> is the key itself.
+<code>key</code> is the key itself.
<p>The
-<kbd>key</kbd> may be given in a format
+<code>key</code> may be given in a format
controlled by the
-<kbd>type</kbd> field.
+<code>type</code> field.
The
-<kbd>type</kbd> .Li
+<code>type</code> .Li
MD5
is always supported.
If
was built with the OpenSSL library
then any digest library supported by that library may be specified.
However, if compliance with FIPS 140-2 is required the
-<kbd>type</kbd> must be either
+<code>type</code> must be either
.Li
SHA
or
-.TH ntp.keys 5 "25 Dec 2012" "4.2.7p338" "File Formats"
+.TH ntp.keys 5 "25 Dec 2012" "4.2.7p339" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:32:41 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 25, 2012 at 12:49:03 PM by AutoGen 5.16.2
.\" From the definitions ntp.keys.def
.\" and the template file agman-file.tpl
.\"
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTP_KEYS 5 File Formats
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:34:30 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:10:35 AM by AutoGen 5.16.2
.\" From the definitions ntp.keys.def
.\" and the template file agmdoc-file.tpl
.Sh NAME
/*
* EDIT THIS FILE WITH CAUTION (ntpd-opts.c)
*
- * It has been AutoGen-ed December 25, 2012 at 11:31:45 AM by AutoGen 5.16.2
+ * It has been AutoGen-ed December 25, 2012 at 12:48:11 PM by AutoGen 5.16.2
* From the definitions ntpd-opts.def
* and the template file options
*
* ntpd option static const strings
*/
static char const ntpd_opt_strs[2987] =
-/* 0 */ "ntpd 4.2.7p338\n"
+/* 0 */ "ntpd 4.2.7p339\n"
"Copyright (C) 1970-2012 The University of Delaware, all rights reserved.\n"
"This is free software. It is licensed for use, modification and\n"
"redistribution under the terms of the NTP License, copies of which\n"
/* 2753 */ "Output version information and exit\0"
/* 2789 */ "version\0"
/* 2797 */ "NTPD\0"
-/* 2802 */ "ntpd - NTP daemon program - Ver. 4.2.7p338\n"
+/* 2802 */ "ntpd - NTP daemon program - Ver. 4.2.7p339\n"
"USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n"
"\t\t[ <server1> ... <serverN> ]\n\0"
/* 2935 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 2969 */ "\n\n\0"
-/* 2972 */ "ntpd 4.2.7p338";
+/* 2972 */ "ntpd 4.2.7p339";
/*
* ipv4 option description with
/*
* EDIT THIS FILE WITH CAUTION (ntpd-opts.h)
*
- * It has been AutoGen-ed December 25, 2012 at 11:31:44 AM by AutoGen 5.16.2
+ * It has been AutoGen-ed December 25, 2012 at 12:48:09 PM by AutoGen 5.16.2
* From the definitions ntpd-opts.def
* and the template file options
*
} teOptIndex;
#define OPTION_CT 37
-#define NTPD_VERSION "4.2.7p338"
-#define NTPD_FULL_VERSION "ntpd 4.2.7p338"
+#define NTPD_VERSION "4.2.7p339"
+#define NTPD_FULL_VERSION "ntpd 4.2.7p339"
/*
* Interface defines for all options. Replace "n" with the UPPER_CASED
-.TH ntpd 1ntpdman "25 Dec 2012" "4.2.7p338" "User Commands"
+.TH ntpd 1ntpdman "25 Dec 2012" "4.2.7p339" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpd-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:32:45 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 25, 2012 at 12:49:07 PM by AutoGen 5.16.2
.\" From the definitions ntpd-opts.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTPD 1ntpdmdoc User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:34:32 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:10:37 AM by AutoGen 5.16.2
.\" From the definitions ntpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>ntpd: Network Time Protocol (NTP) Daemon User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="ntpd: Network Time Protocol (NTP) Daemon User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">ntpd: Network Time Protocol (NTP) Daemon User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-Description">ntpd Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Description">ntpd Description</a>,
Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-
+<br>
</div>
<h2 class="unnumbered">ntpd: Network Time Protocol (NTP) Daemon User Manual</h2>
symmetric and broadcast modes, and with both symmetric-key and public-key
cryptography.
- <p>This document applies to version 4.2.7p337 of <code>ntpd</code>.
+ <p>This document applies to version 4.2.7p339 of <code>ntpd</code>.
<ul class="menu">
<li><a accesskey="1" href="#ntpd-Description">ntpd Description</a>: Description
</ul>
<div class="node">
-<a name="ntpd-Description"></a>
<p><hr>
-
-
+<a name="ntpd-Description"></a>
+<br>
</div>
<!-- node-name, next, previous, up -->
the daemon times out and exits without setting the clock.
<div class="node">
-<a name="ntpd-Invocation"></a>
<p><hr>
-
-
+<a name="ntpd-Invocation"></a>
+<br>
</div>
<h3 class="section">Invoking ntpd</h3>
This software is released under the NTP license, <http://ntp.org/license>.
<ul class="menu">
-<li><a accesskey="1" href="#ntpd-usage">ntpd usage</a>: ntpd help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#ntpd-usage">ntpd usage</a>: ntpd help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#ntpd-ipv4">ntpd ipv4</a>: ipv4 option (-4)
<li><a accesskey="3" href="#ntpd-ipv6">ntpd ipv6</a>: ipv6 option (-6)
<li><a accesskey="4" href="#ntpd-authreq">ntpd authreq</a>: authreq option (-a)
</ul>
<div class="node">
-<a name="ntpd-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-ipv4">ntpd ipv4</a>,
+
<a name="ntpd-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpd-ipv4">ntpd ipv4</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">ntpd help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">ntpd help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-ntpd-help-3"></a>
This is the automatically generated usage text for ntpd.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
-<pre class="example">ntpd - NTP daemon program - Ver. 4.2.7p337
+<pre class="example">ntpd - NTP daemon program - Ver. 4.2.7p338
USAGE: ntpd [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
[ <server1> ... <serverN> ]
Flg Arg Option-Name Description
please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
</pre>
<div class="node">
-<a name="ntpd-ipv4"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-ipv6">ntpd ipv6</a>,
+
<a name="ntpd-ipv4"></a>Next: <a rel="next" accesskey="n" href="#ntpd-ipv6">ntpd ipv6</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-usage">ntpd usage</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ipv4 option (-4)</h4>
<p>Force DNS resolution of following host names on the command line
to the IPv4 namespace.
<div class="node">
-<a name="ntpd-ipv6"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-authreq">ntpd authreq</a>,
+
<a name="ntpd-ipv6"></a>Next: <a rel="next" accesskey="n" href="#ntpd-authreq">ntpd authreq</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-ipv4">ntpd ipv4</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ipv6 option (-6)</h4>
<p>Force DNS resolution of following host names on the command line
to the IPv6 namespace.
<div class="node">
-<a name="ntpd-authreq"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-authnoreq">ntpd authnoreq</a>,
+
<a name="ntpd-authreq"></a>Next: <a rel="next" accesskey="n" href="#ntpd-authnoreq">ntpd authnoreq</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-ipv6">ntpd ipv6</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">authreq option (-a)</h4>
multicast client and symmetric passive associations.
This is the default.
<div class="node">
-<a name="ntpd-authnoreq"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-configfile">ntpd configfile</a>,
+
<a name="ntpd-authnoreq"></a>Next: <a rel="next" accesskey="n" href="#ntpd-configfile">ntpd configfile</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-authreq">ntpd authreq</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">authnoreq option (-A)</h4>
multicast client and symmetric passive associations.
This is almost never a good idea.
<div class="node">
-<a name="ntpd-configfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-driftfile">ntpd driftfile</a>,
+
<a name="ntpd-configfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-driftfile">ntpd driftfile</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-authnoreq">ntpd authnoreq</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">configfile option (-c)</h4>
This is the “configuration file name” option.
This option takes an argument string.
The name and path of the configuration file,
-<samp><span class="file">/etc/ntp.conf</span></samp>
+<span class="file">/etc/ntp.conf</span>
by default.
<div class="node">
-<a name="ntpd-driftfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-panicgate">ntpd panicgate</a>,
+
<a name="ntpd-driftfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-panicgate">ntpd panicgate</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-configfile">ntpd configfile</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">driftfile option (-f)</h4>
This is the “frequency drift file name” option.
This option takes an argument string.
The name and path of the frequency file,
-<samp><span class="file">/etc/ntp.drift</span></samp>
+<span class="file">/etc/ntp.drift</span>
by default.
This is the same operation as the
<code>driftfile</code> <kbd>driftfile</kbd>
configuration specification in the
-<samp><span class="file">/etc/ntp.conf</span></samp>
+<span class="file">/etc/ntp.conf</span>
file.
<div class="node">
-<a name="ntpd-panicgate"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-jaildir">ntpd jaildir</a>,
+
<a name="ntpd-panicgate"></a>Next: <a rel="next" accesskey="n" href="#ntpd-jaildir">ntpd jaildir</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-driftfile">ntpd driftfile</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">panicgate option (-g)</h4>
<code>tinker</code>
configuration file directive for other options.
<div class="node">
-<a name="ntpd-jaildir"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-interface">ntpd interface</a>,
+
<a name="ntpd-jaildir"></a>Next: <a rel="next" accesskey="n" href="#ntpd-interface">ntpd interface</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-panicgate">ntpd panicgate</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">jaildir option (-i)</h4>
<code>--enable-clockctl</code>) and Linux (configure with
<code>--enable-linuxcaps</code>).
<div class="node">
-<a name="ntpd-interface"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-keyfile">ntpd keyfile</a>,
+
<a name="ntpd-interface"></a>Next: <a rel="next" accesskey="n" href="#ntpd-keyfile">ntpd keyfile</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-jaildir">ntpd jaildir</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">interface option (-I)</h4>
<p><a name="index-ntpd_002dinterface-12"></a>
This is the “listen on an interface name or address” option.
-This option takes an argument string <samp><span class="file">iface</span></samp>.
+This option takes an argument string <span class="file">iface</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
This option is deprecated. Please consider using the configuration file
<code>interface</code> command, which is more versatile.
<div class="node">
-<a name="ntpd-keyfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-logfile">ntpd logfile</a>,
+
<a name="ntpd-keyfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-logfile">ntpd logfile</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-interface">ntpd interface</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">keyfile option (-k)</h4>
This is the “path to symmetric keys” option.
This option takes an argument string.
Specify the name and path of the symmetric key file.
-<samp><span class="file">/etc/ntp.keys</span></samp>
+<span class="file">/etc/ntp.keys</span>
is the default.
This is the same operation as the
<code>keys</code> <kbd>keyfile</kbd>
configuration file directive.
<div class="node">
-<a name="ntpd-logfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-novirtualips">ntpd novirtualips</a>,
+
<a name="ntpd-logfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-novirtualips">ntpd novirtualips</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-keyfile">ntpd keyfile</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">logfile option (-l)</h4>
<code>logfile</code> <kbd>logfile</kbd>
configuration file directive.
<div class="node">
-<a name="ntpd-novirtualips"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-modifymmtimer">ntpd modifymmtimer</a>,
+
<a name="ntpd-novirtualips"></a>Next: <a rel="next" accesskey="n" href="#ntpd-modifymmtimer">ntpd modifymmtimer</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-logfile">ntpd logfile</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">novirtualips option (-L)</h4>
consider using the configuration file <code>interface</code> command, which
is more versatile.
<div class="node">
-<a name="ntpd-modifymmtimer"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-nice">ntpd nice</a>,
+
<a name="ntpd-modifymmtimer"></a>Next: <a rel="next" accesskey="n" href="#ntpd-nice">ntpd nice</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-novirtualips">ntpd novirtualips</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">modifymmtimer option (-M)</h4>
ensures the resolution does not change while ntpd is running,
avoiding timekeeping glitches associated with changes.
<div class="node">
-<a name="ntpd-nice"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-pidfile">ntpd pidfile</a>,
+
<a name="ntpd-nice"></a>Next: <a rel="next" accesskey="n" href="#ntpd-pidfile">ntpd pidfile</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-modifymmtimer">ntpd modifymmtimer</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">nice option (-N)</h4>
<code>ntpd</code>
at the highest priority.
<div class="node">
-<a name="ntpd-pidfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-priority">ntpd priority</a>,
+
<a name="ntpd-pidfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-priority">ntpd priority</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-nice">ntpd nice</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">pidfile option (-p)</h4>
<code>pidfile</code> <kbd>pidfile</kbd>
configuration file directive.
<div class="node">
-<a name="ntpd-priority"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-quit">ntpd quit</a>,
+
<a name="ntpd-priority"></a>Next: <a rel="next" accesskey="n" href="#ntpd-quit">ntpd quit</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-pidfile">ntpd pidfile</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">priority option (-P)</h4>
<code>sched_setscheduler(SCHED_FIFO)</code>
priority.
<div class="node">
-<a name="ntpd-quit"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-propagationdelay">ntpd propagationdelay</a>,
+
<a name="ntpd-quit"></a>Next: <a rel="next" accesskey="n" href="#ntpd-propagationdelay">ntpd propagationdelay</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-priority">ntpd priority</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">quit option (-q)</h4>
options can be used with this option.
Note: The kernel time discipline is disabled with this option.
<div class="node">
-<a name="ntpd-propagationdelay"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-saveconfigquit">ntpd saveconfigquit</a>,
+
<a name="ntpd-propagationdelay"></a>Next: <a rel="next" accesskey="n" href="#ntpd-saveconfigquit">ntpd saveconfigquit</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-quit">ntpd quit</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">propagationdelay option (-r)</h4>
This option takes an argument string.
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.
<div class="node">
-<a name="ntpd-saveconfigquit"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-statsdir">ntpd statsdir</a>,
+
<a name="ntpd-saveconfigquit"></a>Next: <a rel="next" accesskey="n" href="#ntpd-statsdir">ntpd statsdir</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-propagationdelay">ntpd propagationdelay</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">saveconfigquit option</h4>
equivalent to the given filename and exit. This option was
designed for automated testing.
<div class="node">
-<a name="ntpd-statsdir"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-trustedkey">ntpd trustedkey</a>,
+
<a name="ntpd-statsdir"></a>Next: <a rel="next" accesskey="n" href="#ntpd-trustedkey">ntpd trustedkey</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-saveconfigquit">ntpd saveconfigquit</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">statsdir option (-s)</h4>
<code>statsdir</code> <kbd>statsdir</kbd>
configuration file directive.
<div class="node">
-<a name="ntpd-trustedkey"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-user">ntpd user</a>,
+
<a name="ntpd-trustedkey"></a>Next: <a rel="next" accesskey="n" href="#ntpd-user">ntpd user</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-statsdir">ntpd statsdir</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">trustedkey option (-t)</h4>
<p><a name="index-ntpd_002dtrustedkey-24"></a>
This is the “trusted key number” option.
-This option takes an argument string <samp><span class="file">tkey</span></samp>.
+This option takes an argument string <span class="file">tkey</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
<p>Add the specified key number to the trusted key list.
<div class="node">
-<a name="ntpd-user"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-updateinterval">ntpd updateinterval</a>,
+
<a name="ntpd-user"></a>Next: <a rel="next" accesskey="n" href="#ntpd-updateinterval">ntpd updateinterval</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-trustedkey">ntpd trustedkey</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">user option (-u)</h4>
<code>--enable-clockctl</code>) and Linux (configure with
<code>--enable-linuxcaps</code>).
<div class="node">
-<a name="ntpd-updateinterval"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-wait_002dsync">ntpd wait-sync</a>,
+
<a name="ntpd-updateinterval"></a>Next: <a rel="next" accesskey="n" href="#ntpd-wait_002dsync">ntpd wait-sync</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-user">ntpd user</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">updateinterval option (-U)</h4>
has been detected by the system.
Use 0 to disable scanning. 60 seconds is the minimum time between scans.
<div class="node">
-<a name="ntpd-wait-sync"></a>
-<a name="ntpd-wait_002dsync"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-slew">ntpd slew</a>,
+
<a name="ntpd-wait_002dsync"></a>Next: <a rel="next" accesskey="n" href="#ntpd-slew">ntpd slew</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-updateinterval">ntpd updateinterval</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">wait-sync option (-w)</h4>
This provides the option for a script starting <code>ntpd</code> to easily
wait for the first set of the clock before proceeding.
<div class="node">
-<a name="ntpd-slew"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-usepcc">ntpd usepcc</a>,
+
<a name="ntpd-slew"></a>Next: <a rel="next" accesskey="n" href="#ntpd-usepcc">ntpd usepcc</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-wait_002dsync">ntpd wait-sync</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">slew option (-x)</h4>
configuration file directive for other options.
Note: The kernel time discipline is disabled with this option.
<div class="node">
-<a name="ntpd-usepcc"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-pccfreq">ntpd pccfreq</a>,
+
<a name="ntpd-usepcc"></a>Next: <a rel="next" accesskey="n" href="#ntpd-pccfreq">ntpd pccfreq</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-slew">ntpd slew</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">usepcc option</h4>
they have the same frequency, the CPU counter (RDTSC on x86) is
used directly, saving the overhead of a system call.
<div class="node">
-<a name="ntpd-pccfreq"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-mdns">ntpd mdns</a>,
+
<a name="ntpd-pccfreq"></a>Next: <a rel="next" accesskey="n" href="#ntpd-mdns">ntpd mdns</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-usepcc">ntpd usepcc</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">pccfreq option</h4>
The CPU counter (RDTSC on x86) is used unconditionally with the
given frequency (in Hz).
<div class="node">
-<a name="ntpd-mdns"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-config">ntpd config</a>,
+
<a name="ntpd-mdns"></a>Next: <a rel="next" accesskey="n" href="#ntpd-config">ntpd config</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-pccfreq">ntpd pccfreq</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">mdns option (-m)</h4>
the server to be discovered via mDNS client lookup.
<div class="node">
-<a name="ntpd-config"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-exit-status">ntpd exit status</a>,
+
<a name="ntpd-config"></a>Next: <a rel="next" accesskey="n" href="#ntpd-exit-status">ntpd exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-mdns">ntpd mdns</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">presetting/configuring ntpd</h4>
first letter of the argument is examined:
<dl>
-<dt>‘<samp><span class="samp">version</span></samp>’<dd>Only print the version. This is the default.
-<br><dt>‘<samp><span class="samp">copyright</span></samp>’<dd>Name the copyright usage licensing terms.
-<br><dt>‘<samp><span class="samp">verbose</span></samp>’<dd>Print the full copyright usage licensing terms.
+<dt><span class="samp">version</span><dd>Only print the version. This is the default.
+<br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms.
+<br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms.
</dl>
<div class="node">
-<a name="ntpd-exit-status"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-Usage">ntpd Usage</a>,
+
<a name="ntpd-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Usage">ntpd Usage</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-config">ntpd config</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpd exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
</dl>
<div class="node">
-<a name="ntpd-Usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-Files">ntpd Files</a>,
+
<a name="ntpd-Usage"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Files">ntpd Files</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-exit-status">ntpd exit status</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpd Usage</h4>
<div class="node">
-<a name="How-NTP-Operates"></a>
<p><hr>
-
-
+<a name="How-NTP-Operates"></a>
+<br>
</div>
<h3 class="section">How NTP Operates</h3>
acceptable range,
<code>ntpd</code>
enters the same state as when the
-<samp><span class="file">ntp.drift</span></samp>
+<span class="file">ntp.drift</span>
file is not present.
The intent of this behavior
is to quickly correct the frequency and restore operation to the
normal tracking mode.
In the most extreme cases
(the host
-time.ien.it comes to mind), there may be occasional
+<code>time.ien.it</code> comes to mind), there may be occasional
step/slew corrections and subsequent frequency corrections.
It
helps in these cases to use the
<code>ntpd(8)</code>
that often addresses all of the problems mentioned above.
<div class="node">
-<a name="Starting-NTP-(Best-Current-Practice)"></a>
-<a name="Starting-NTP-_0028Best-Current-Practice_0029"></a>
<p><hr>
-
-
+<a name="Starting-NTP-_0028Best-Current-Practice_0029"></a>
+<br>
</div>
<h3 class="section">Starting NTP (Best Current Practice)</h3>
<code>server</code> entries.
<p>If you can also keep a good
-<samp><span class="file">ntp.drift</span></samp>
+<span class="file">ntp.drift</span>
file then
<code>ntpd(8)</code>
will effectively "warm-start" and your system's clock will
it is as safe as it will ever be to start any process that require
stable time.
<div class="node">
-<a name="Frequency-Discipline"></a>
<p><hr>
-
-
+<a name="Frequency-Discipline"></a>
+<br>
</div>
<h3 class="section">Frequency Discipline</h3>
<code>ntpd</code>
behavior at startup depends on whether the
frequency file, usually
-<samp><span class="file">ntp.drift</span></samp>,
-,
+<span class="file">ntp.drift</span>,
exists.
This file
contains the latest estimate of clock frequency error.
After that the current frequency offset is written to
the file at hourly intervals.
<div class="node">
-<a name="Operating-Modes"></a>
<p><hr>
-
-
+<a name="Operating-Modes"></a>
+<br>
</div>
<h3 class="section">Operating Modes</h3>
utility can operate in any of several modes, including
symmetric active/passive, client/server broadcast/multicast and
manycast, as described in the
-"AssociationManagement"
+"Association Management"
page
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>).
-)
-.
+<span class="file">/usr/share/doc/ntp</span>).
It normally operates continuously while
monitoring for small changes in frequency and trimming the clock
for the ultimate precision.
frequency is read from the file and initializes the kernel
frequency.
<div class="node">
-<a name="Poll-Interval-Control"></a>
<p><hr>
-
-
+<a name="Poll-Interval-Control"></a>
+<br>
</div>
<h3 class="section">Poll Interval Control</h3>
s, for example, the capture range is only 31 PPM.
If the intrinsic
error is greater than this, the drift file
-<samp><span class="file">ntp.drift</span></samp>
+<span class="file">ntp.drift</span>
will
have to be specially tailored to reduce the residual error below
this limit.
updated once per hour and is available to initialize the frequency
on subsequent daemon restarts.
<div class="node">
-<a name="The-huff-n'-puff-Filter"></a>
-<a name="The-huff_002dn_0027_002dpuff-Filter"></a>
<p><hr>
-
-
+<a name="The-huff_002dn_0027_002dpuff-Filter"></a>
+<br>
</div>
<h3 class="section">The huff-n'-puff Filter</h3>
<code>huffpuff</code> keyword, as described in
<code>ntp.conf(5)</code>.
<div class="node">
-<a name="ntpd-Files"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-See-Also">ntpd See Also</a>,
+
<a name="ntpd-Files"></a>Next: <a rel="next" accesskey="n" href="#ntpd-See-Also">ntpd See Also</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-Usage">ntpd Usage</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpd Files</h4>
<dl>
-<dt>‘<samp><span class="samp">Pa</span></samp>’<dd>the default name of the configuration file
-<br><dt>‘<samp><span class="samp">Pa</span></samp>’<dd>the default name of the drift file
-<br><dt>‘<samp><span class="samp">Pa</span></samp>’<dd>the default name of the key file
+<dt><span class="samp">Pa</span><dd>the default name of the configuration file
+<br><dt><span class="samp">Pa</span><dd>the default name of the drift file
+<br><dt><span class="samp">Pa</span><dd>the default name of the key file
<div class="node">
-<a name="ntpd-See-Also"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-Bugs">ntpd Bugs</a>,
+
<a name="ntpd-See-Also"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Bugs">ntpd Bugs</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-Files">ntpd Files</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpd See Also</h4>
http://www.ntp.org/
.
A snapshot of this documentation is available in HTML format in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>.
-.
+<span class="file">/usr/share/doc/ntp</span>.
.Rs
.%A
David
RFC5908
.Re
<div class="node">
-<a name="ntpd-Bugs"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-Notes">ntpd Notes</a>,
+
<a name="ntpd-Bugs"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Notes">ntpd Notes</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-See-Also">ntpd See Also</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpd Bugs</h4>
a busy primary server, rather than a high stratum workstation in
mind.
<div class="node">
-<a name="ntpd-Notes"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntpd-Bugs">ntpd Bugs</a>,
+
<a name="ntpd-Notes"></a>Previous: <a rel="previous" accesskey="p" href="#ntpd-Bugs">ntpd Bugs</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpd Notes</h4>
Portions of this document came from FreeBSD.
<div class="node">
-<a name="Usage"></a>
<p><hr>
-
-
+<a name="Usage"></a>
+<br>
</div>
<!-- node-name, next, previous, up -->
-.TH ntpd @NTPD_MS@ "25 Dec 2012" "4.2.7p338" "User Commands"
+.TH ntpd @NTPD_MS@ "25 Dec 2012" "4.2.7p339" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpd-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:32:45 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 25, 2012 at 12:49:07 PM by AutoGen 5.16.2
.\" From the definitions ntpd-opts.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTPD @NTPD_MS@ User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:34:32 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:10:37 AM by AutoGen 5.16.2
.\" From the definitions ntpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpdc.texi)
#
-# It has been AutoGen-ed December 25, 2012 at 11:34:55 AM by AutoGen 5.16.2
+# It has been AutoGen-ed December 26, 2012 at 04:11:03 AM by AutoGen 5.16.2
# From the definitions ntpdc-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p338
+ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p339
USAGE: ntpdc [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [ host ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 DNS name resolution
The output of a
command is normally sent to the standard output, but optionally the
output of individual commands may be sent to a file by appending a
-@quoteleft{}\&> ,@quoteright{}
+@quoteleft{}\&>@quoteright{},
+,
followed by a file name, to the command line.
A number of interactive format commands are executed entirely
@code{ntpdc}
retries each query once after a timeout, the total waiting time for
a timeout will be twice the timeout value set.
-
-@end multitable
+@end table
@node Control Message Commands
@section Control Message Commands
This
information is provided only by some clock drivers and is mostly
undecodable without a copy of the driver source in hand.
-
-@end multitable
+@end table
@node Runtime Configuration Requests
@section Runtime Configuration Requests
@code{ntp.conf(5)}
for further information.
The default for this flag is disable.
-
-@end multitable
+@end table
.It
Xo
Ic
/*
* EDIT THIS FILE WITH CAUTION (ntpdc-opts.c)
*
- * It has been AutoGen-ed December 25, 2012 at 11:34:45 AM by AutoGen 5.16.2
+ * It has been AutoGen-ed December 26, 2012 at 04:10:51 AM by AutoGen 5.16.2
* From the definitions ntpdc-opts.def
* and the template file options
*
* ntpdc option static const strings
*/
static char const ntpdc_opt_strs[1862] =
-/* 0 */ "ntpdc 4.2.7p338\n"
+/* 0 */ "ntpdc 4.2.7p339\n"
"Copyright (C) 1970-2012 The University of Delaware, all rights reserved.\n"
"This is free software. It is licensed for use, modification and\n"
"redistribution under the terms of the NTP License, copies of which\n"
/* 1640 */ "no-load-opts\0"
/* 1653 */ "no\0"
/* 1656 */ "NTPDC\0"
-/* 1662 */ "ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p338\n"
+/* 1662 */ "ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p339\n"
"USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n\0"
/* 1794 */ "$HOME\0"
/* 1800 */ ".\0"
/* 1802 */ ".ntprc\0"
/* 1809 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 1843 */ "\n\n\0"
-/* 1846 */ "ntpdc 4.2.7p338";
+/* 1846 */ "ntpdc 4.2.7p339";
/*
* ipv4 option description with
/*
* EDIT THIS FILE WITH CAUTION (ntpdc-opts.h)
*
- * It has been AutoGen-ed December 25, 2012 at 11:34:45 AM by AutoGen 5.16.2
+ * It has been AutoGen-ed December 26, 2012 at 04:10:50 AM by AutoGen 5.16.2
* From the definitions ntpdc-opts.def
* and the template file options
*
} teOptIndex;
#define OPTION_CT 15
-#define NTPDC_VERSION "4.2.7p338"
-#define NTPDC_FULL_VERSION "ntpdc 4.2.7p338"
+#define NTPDC_VERSION "4.2.7p339"
+#define NTPDC_FULL_VERSION "ntpdc 4.2.7p339"
/*
* Interface defines for all options. Replace "n" with the UPPER_CASED
-.TH ntpdc 1ntpdcman "25 Dec 2012" "4.2.7p338" "User Commands"
+.TH ntpdc 1ntpdcman "26 Dec 2012" "4.2.7p339" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:34:51 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:10:58 AM by AutoGen 5.16.2
.\" From the definitions ntpdc-opts.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTPDC 1ntpdcmdoc User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:34:57 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:05 AM by AutoGen 5.16.2
.\" From the definitions ntpdc-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>ntpdc: NTPD Control User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="ntpdc: NTPD Control User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">ntpdc: NTPD Control User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-Description">ntpdc Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Description">ntpdc Description</a>,
Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-
+<br>
</div>
<h2 class="unnumbered">ntpdc: NTPD Control User Manual</h2>
clock. Run as root, it can correct the system clock to this offset as
well. It can be run as an interactive command or from a cron job.
- <p>This document applies to version 4.2.7p338 of <code>ntpdc</code>.
+ <p>This document applies to version 4.2.7p339 of <code>ntpdc</code>.
<p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
IETF specification.
- <div class="shortcontents">
-<h2>Short Contents</h2>
-<ul>
-<a href="#Top">ntpdc: NTPD Control User Manual</a>
-</ul>
-</div>
-
<ul class="menu">
<li><a accesskey="1" href="#ntpdc-Description">ntpdc Description</a>: Description
<li><a accesskey="2" href="#ntpdc-Invocation">ntpdc Invocation</a>: Invoking ntpdc
</ul>
<div class="node">
-<a name="ntpdc-Description"></a>
<p><hr>
-
-
+<a name="ntpdc-Description"></a>
+<br>
</div>
<!-- node-name, next, previous, up -->
error bound of the system clock relative to the server clock.
<div class="node">
-<a name="ntpdc-Invocation"></a>
<p><hr>
-
-
+<a name="ntpdc-Invocation"></a>
+<br>
</div>
<h3 class="section">Invoking ntpdc</h3>
This software is released under the NTP license, <http://ntp.org/license>.
<ul class="menu">
-<li><a accesskey="1" href="#ntpdc-usage">ntpdc usage</a>: ntpdc help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#ntpdc-usage">ntpdc usage</a>: ntpdc help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#ntpdc-ipv4">ntpdc ipv4</a>: ipv4 option (-4)
<li><a accesskey="3" href="#ntpdc-ipv6">ntpdc ipv6</a>: ipv6 option (-6)
<li><a accesskey="4" href="#ntpdc-command">ntpdc command</a>: command option (-c)
</ul>
<div class="node">
-<a name="ntpdc-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-ipv4">ntpdc ipv4</a>,
+
<a name="ntpdc-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-ipv4">ntpdc ipv4</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">ntpdc help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">ntpdc help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-ntpdc-help-3"></a>
This is the automatically generated usage text for ntpdc.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
-<pre class="example">ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p338
+<pre class="example">ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p339
USAGE: ntpdc [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 DNS name resolution
please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
</pre>
<div class="node">
-<a name="ntpdc-ipv4"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-ipv6">ntpdc ipv6</a>,
+
<a name="ntpdc-ipv4"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-ipv6">ntpdc ipv6</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-usage">ntpdc usage</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ipv4 option (-4)</h4>
<p>Force DNS resolution of following host names on the command line
to the IPv4 namespace.
<div class="node">
-<a name="ntpdc-ipv6"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-command">ntpdc command</a>,
+
<a name="ntpdc-ipv6"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-command">ntpdc command</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-ipv4">ntpdc ipv4</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ipv6 option (-6)</h4>
<p>Force DNS resolution of following host names on the command line
to the IPv6 namespace.
<div class="node">
-<a name="ntpdc-command"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-interactive">ntpdc interactive</a>,
+
<a name="ntpdc-command"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-interactive">ntpdc interactive</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-ipv6">ntpdc ipv6</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">command option (-c)</h4>
<p><a name="index-ntpdc_002dcommand-6"></a>
This is the “run a command and exit” option.
-This option takes an argument string <samp><span class="file">cmd</span></samp>.
+This option takes an argument string <span class="file">cmd</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
and is added to the list of commands to be executed on the specified
host(s).
<div class="node">
-<a name="ntpdc-interactive"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-listpeers">ntpdc listpeers</a>,
+
<a name="ntpdc-interactive"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-listpeers">ntpdc listpeers</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-command">ntpdc command</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">interactive option (-i)</h4>
<p>Force ntpq to operate in interactive mode. Prompts will be written
to the standard output and commands read from the standard input.
<div class="node">
-<a name="ntpdc-listpeers"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-numeric">ntpdc numeric</a>,
+
<a name="ntpdc-listpeers"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-numeric">ntpdc numeric</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-interactive">ntpdc interactive</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">listpeers option (-l)</h4>
<p>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.
<div class="node">
-<a name="ntpdc-numeric"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-peers">ntpdc peers</a>,
+
<a name="ntpdc-numeric"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-peers">ntpdc peers</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-listpeers">ntpdc listpeers</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">numeric option (-n)</h4>
Output all host addresses in dotted-quad numeric format rather than
converting to the canonical host names.
<div class="node">
-<a name="ntpdc-peers"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-showpeers">ntpdc showpeers</a>,
+
<a name="ntpdc-peers"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-showpeers">ntpdc showpeers</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-numeric">ntpdc numeric</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">peers option (-p)</h4>
<p>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.
<div class="node">
-<a name="ntpdc-showpeers"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-config">ntpdc config</a>,
+
<a name="ntpdc-showpeers"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-config">ntpdc config</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-peers">ntpdc peers</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">showpeers option (-s)</h4>
of their state. This is equivalent to the 'dmpeers' interactive command.
<div class="node">
-<a name="ntpdc-config"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-exit-status">ntpdc exit status</a>,
+
<a name="ntpdc-config"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-exit-status">ntpdc exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-showpeers">ntpdc showpeers</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">presetting/configuring ntpdc</h4>
<li>$PWD
</ul>
The environment variables <code>HOME</code>, and <code>PWD</code>
-are expanded and replaced when <samp><span class="file">ntpdc</span></samp> runs.
+are expanded and replaced when <span class="file">ntpdc</span> runs.
For any of these that are plain files, they are simply processed.
-For any that are directories, then a file named <samp><span class="file">.ntprc</span></samp> is searched for
+For any that are directories, then a file named <span class="file">.ntprc</span> is searched for
within that directory and processed.
<p>Configuration files may be in a wide variety of formats.
first letter of the argument is examined:
<dl>
-<dt>‘<samp><span class="samp">version</span></samp>’<dd>Only print the version. This is the default.
-<br><dt>‘<samp><span class="samp">copyright</span></samp>’<dd>Name the copyright usage licensing terms.
-<br><dt>‘<samp><span class="samp">verbose</span></samp>’<dd>Print the full copyright usage licensing terms.
+<dt><span class="samp">version</span><dd>Only print the version. This is the default.
+<br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms.
+<br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms.
</dl>
<div class="node">
-<a name="ntpdc-exit-status"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-Usage">ntpdc Usage</a>,
+
<a name="ntpdc-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Usage">ntpdc Usage</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-config">ntpdc config</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpdc exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
-<br><dt>‘<samp><span class="samp">66 (EX_NOINPUT)</span></samp>’<dd>A specified configuration file could not be loaded.
-<br><dt>‘<samp><span class="samp">70 (EX_SOFTWARE)</span></samp>’<dd>libopts had an internal operational error. Please report
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
+<br><dt><span class="samp">66 (EX_NOINPUT)</span><dd>A specified configuration file could not be loaded.
+<br><dt><span class="samp">70 (EX_SOFTWARE)</span><dd>libopts had an internal operational error. Please report
it to autogen-users@lists.sourceforge.net. Thank you.
</dl>
<div class="node">
-<a name="ntpdc-Usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-See-Also">ntpdc See Also</a>,
+
<a name="ntpdc-Usage"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-See-Also">ntpdc See Also</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-exit-status">ntpdc exit status</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpdc Usage</h4>
attempt to read interactive format commands from the standard
input.
<div class="node">
-<a name="Interactive-Commands"></a>
<p><hr>
-
-
+<a name="Interactive-Commands"></a>
+<br>
</div>
<h3 class="section">Interactive Commands</h3>
The output of a
command is normally sent to the standard output, but optionally the
output of individual commands may be sent to a file by appending a
-\&> ,
+\&>,
+,
followed by a file name, to the command line.
<p>A number of interactive format commands are executed entirely
<code>ntpq(8)</code>
than this manual
page.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Specify a time interval to be added to timestamps included in
+<br><dt><span class="samp">Ic</span><dd>Specify a time interval to be added to timestamps included in
requests which require authentication.
This is used to enable
(unreliable) server reconfiguration over long delay network paths
Actually the
server does not now require timestamps in authenticated requests,
so this command may be obsolete.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Set the host to which future queries will be sent.
+<br><dt><span class="samp">Ic</span><dd>Set the host to which future queries will be sent.
Hostname may
be either a host name or a numeric address.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>If
+<br><dt><span class="samp">Ic</span><dd>If
<code>yes</code> is specified, host names are printed in
information displays.
If
<code>yes</code>, unless
modified using the command line
<code>-n</code> switch.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>This command allows the specification of a key number to be
+<br><dt><span class="samp">Ic</span><dd>This command allows the specification of a key number to be
used to authenticate configuration requests.
This must correspond
to a key number the server has been configured to use for this
purpose.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Exit
+<br><dt><span class="samp">Ic</span><dd>Exit
<code>ntpdc</code>.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>This command prompts you to type in a password (which will not
+<br><dt><span class="samp">Ic</span><dd>This command prompts you to type in a password (which will not
be echoed) which will be used to authenticate configuration
requests.
The password must correspond to the key configured for
use by the NTP server for this purpose if such requests are to be
successful.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Specify a timeout period for responses to server queries.
+<br><dt><span class="samp">Ic</span><dd>Specify a timeout period for responses to server queries.
The
default is about 8000 milliseconds.
Note that since
<code>ntpdc</code>
retries each query once after a timeout, the total waiting time for
-a timeout will be twice the timeout value set.
-
-<div class="node">
-<a name="Control-Message-Commands"></a>
+a timeout will be twice the timeout value set.
+</dl>
+ <div class="node">
<p><hr>
-
-
+<a name="Control-Message-Commands"></a>
+<br>
</div>
<h3 class="section">Control Message Commands</h3>
-
<p>Control Message Commands
+<p>Control Message Commands
Query commands result in NTP mode 7 packets containing requests for
information being sent to the server.
These are read-only commands
in that they make no modification of the server configuration
state.
-<dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Obtains and prints a brief list of the peers for which the
+ <dl>
+<dt><span class="samp">Ic</span><dd>Obtains and prints a brief list of the peers for which the
server is maintaining state.
These should include all configured
peer associations as well as those peers whose stratum is such that
they are considered by the server to be possible future
synchronization candidates.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Obtains a list of peers for which the server is maintaining
+<br><dt><span class="samp">Ic</span><dd>Obtains a list of peers for which the server is maintaining
state, along with a summary of that state.
Summary information
includes the address of the remote peer, the local interface
reachability register, in octal, and the current estimated delay,
offset and dispersion of the peer, all in seconds.
-
<p>The character in the left margin indicates the mode this peer
+ <p>The character in the left margin indicates the mode this peer
entry is operating in.
A
-‘\&+’
+\&+
denotes symmetric active, a
-‘\&-’
+\&-
indicates symmetric passive, a
-‘\&=’
+\&=
means the
remote server is being polled in client mode, a
-‘\&^’
+\&^
indicates that the server is broadcasting to this address, a
-‘\&~’
+\&~
denotes that the remote peer is sending broadcasts and a
-‘\&~’
+\&~
denotes that the remote peer is sending broadcasts and a
-‘\&*’
+\&*
marks the peer the server is currently synchronizing
to.
- <p>The contents of the host field may be one of four forms.
-It may
-be a host name, an IP address, a reference clock implementation
-name with its parameter or
-.Fn
-REFCLK
-"implementation_number"
-"parameter"
-.
-On
-<code>hostnames</code> <code>no</code> only IP-addresses
-will be displayed.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>A slightly different peer summary list.
-Identical to the output
-of the
-<code>peers</code> command, except for the character in the
-leftmost column.
-Characters only appear beside peers which were
-included in the final stage of the clock selection algorithm.
-A
-‘\&.’
-indicates that this peer was cast off in the falseticker
-detection, while a
-‘\&+’
-indicates that the peer made it
-through.
-A
-‘\&*’
-denotes the peer the server is currently
-synchronizing with.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Shows a detailed display of the current peer variables for one
-or more peers.
-Most of these values are described in the NTP
-Version 2 specification.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Show per-peer statistic counters associated with the specified
-peer(s).
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Obtain and print information concerning a peer clock.
-The
-values obtained provide information on the setting of fudge factors
-and other clock performance information.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Obtain and print kernel phase-lock loop operating parameters.
-This information is available only if the kernel has been specially
-modified for a precision timekeeping function.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Print the values of selected loop filter variables.
-The loop
-filter is the part of NTP which deals with adjusting the local
-system clock.
-The
-‘offset’
-is the last offset given to the
-loop filter by the packet processing code.
-The
-‘frequency’
-is the frequency error of the local clock in parts-per-million
-(ppm).
-The
-‘time_const’
-controls the stiffness of the
-phase-lock loop and thus the speed at which it can adapt to
-oscillator drift.
-The
-‘watchdogtimer’
-value is the number
-of seconds which have elapsed since the last sample offset was
-given to the loop filter.
-The
-<code>oneline</code> and
-<code>multiline</code> options specify the format in which this
-information is to be printed, with
-<code>multiline</code> as the
-default.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Print a variety of system state variables, i.e., state related
-to the local server.
-All except the last four lines are described
-in the NTP Version 3 specification, RFC-1305.
-
- <p>The
-‘systemflags’
-show various system flags, some of
-which can be set and cleared by the
-<code>enable</code> and
-<code>disable</code> configuration commands, respectively.
-These are
-the
-<code>auth</code>, <code>bclient</code>, <code>monitor</code>, <code>pll</code>, <code>pps</code> and
-<code>stats</code> flags.
-See the
-<code>ntpd(8)</code>
-documentation for the meaning of these flags.
-There
-are two additional flags which are read only, the
-<code>kernel_pll</code> and
-<code>kernel_pps</code>. These flags indicate
-the synchronization status when the precision time kernel
-modifications are in use.
-The
-‘kernel_pll’
-indicates that
-the local clock is being disciplined by the kernel, while the
-‘kernel_pps’
-indicates the kernel discipline is provided by the PPS
-signal.
-
- <p>The
-‘stability’
-is the residual frequency error remaining
-after the system frequency correction is applied and is intended for
-maintenance and debugging.
-In most architectures, this value will
-initially decrease from as high as 500 ppm to a nominal value in
-the range .01 to 0.1 ppm.
-If it remains high for some time after
-starting the daemon, something may be wrong with the local clock,
-or the value of the kernel variable
-.Va
-kern.clockrate.tick
-may be
-incorrect.
-
- <p>The
-‘broadcastdelay’
-shows the default broadcast delay,
-as set by the
-<code>broadcastdelay</code> configuration command.
-
- <p>The
-‘authdelay’
-shows the default authentication delay,
-as set by the
-<code>authdelay</code> configuration command.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Print statistics counters maintained in the protocol
-module.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Print statistics counters related to memory allocation
-code.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Print statistics counters maintained in the input-output
-module.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Print statistics counters maintained in the timer/event queue
-support code.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Obtain and print the server's restriction list.
-This list is
-(usually) printed in sorted order and may help to understand how
-the restrictions are applied.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Obtain and print traffic counts collected and maintained by the
-monitor facility.
-The version number should not normally need to be
-specified.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>Obtain debugging information for a reference clock driver.
-This
-information is provided only by some clock drivers and is mostly
-undecodable without a copy of the driver source in hand.
-
-<div class="node">
-<a name="Runtime-Configuration-Requests"></a>
-<p><hr>
-
-
-</div>
-
-<h3 class="section">Runtime Configuration Requests</h3>
-
- <p>Runtime Configuration Requests
-All requests which cause state changes in the server are
-authenticated by the server using a configured NTP key (the
-facility can also be disabled by the server by not configuring a
-key).
-The key number and the corresponding key must also be made
-known to
-<code>ntpdc</code>.
-This can be done using the
-<code>keyid</code> and
-<code>passwd</code> commands, the latter of which will prompt at the terminal for a
-password to use as the encryption key.
-You will also be prompted
-automatically for both the key number and password the first time a
-command which would result in an authenticated request to the
-server is given.
-Authentication not only provides verification that
-the requester has permission to make such changes, but also gives
-an extra degree of protection again transmission errors.
-
- <p>Authenticated requests always include a timestamp in the packet
-data, which is included in the computation of the authentication
-code.
-This timestamp is compared by the server to its receive time
-stamp.
-If they differ by more than a small amount the request is
-rejected.
-This is done for two reasons.
-First, it makes simple
-replay attacks on the server, by someone who might be able to
-overhear traffic on your LAN, much more difficult.
-Second, it makes
-it more difficult to request configuration changes to your server
-from topologically remote hosts.
-While the reconfiguration facility
-will work well with a server on the local host, and may work
-adequately between time-synchronized hosts on the same LAN, it will
-work very poorly for more distant hosts.
-As such, if reasonable
-passwords are chosen, care is taken in the distribution and
-protection of keys and appropriate source address restrictions are
-applied, the run time reconfiguration facility should provide an
-adequate level of security.
-
- <p>The following commands all make authenticated requests.
- <dl>
-<dt>‘<samp><span class="samp">Xo</span></samp>’<dd>[<kbd>keyid</kbd> ]
-[<kbd>version</kbd> ]
-[<code>prefer</code> ]
-Add a configured peer association at the given address and
-operating in symmetric active mode.
-Note that an existing
-association with the same peer may be deleted when this command is
-executed, or may simply be converted to conform to the new
-configuration, as appropriate.
-If the optional
-<kbd>keyid</kbd> is a
-nonzero integer, all outgoing packets to the remote server will
-have an authentication field attached encrypted with this key.
-If
-the value is 0 (or not given) no authentication will be done.
-The
-<kbd>version</kbd> can be 1, 2 or 3 and defaults to 3.
-The
-<code>prefer</code> keyword indicates a preferred peer (and thus will
-be used primarily for clock synchronisation if possible).
-The
-preferred peer also determines the validity of the PPS signal - if
-the preferred peer is suitable for synchronisation so is the PPS
-signal.
-<br><dt>‘<samp><span class="samp">Xo</span></samp>’<dd>[<kbd>keyid</kbd> ]
-[<kbd>version</kbd> ]
-[<code>prefer</code> ]
-Identical to the addpeer command, except that the operating
-mode is client.
-<br><dt>‘<samp><span class="samp">Xo</span></samp>’<dd>[<kbd>keyid</kbd> ]
-[<kbd>version</kbd> ]
-[<code>prefer</code> ]
-Identical to the addpeer command, except that the operating
-mode is broadcast.
-In this case a valid key identifier and key are
-required.
-The
-<kbd>peer_address</kbd> parameter can be the broadcast
-address of the local network or a multicast group address assigned
-to NTP.
-If a multicast address, a multicast-capable kernel is
-required.
-<br><dt>‘<samp><span class="samp">Ic</span></samp>’<dd>This command causes the configured bit to be removed from the
-specified peer(s).
-In many cases this will cause the peer
-association to be deleted.
-When appropriate, however, the
-association may persist in an unconfigured mode if the remote peer
-is willing to continue on in this fashion.
-<br><dt>‘<samp><span class="samp">Xo</span></samp>’<dd>[<code>time1</code> ]
-[<code>time2</code> ]
-[<kbd>stratum</kbd> ]
-[<kbd>refid</kbd> ]
-This command provides a way to set certain data for a reference
-clock.
-See the source listing for further information.
-<br><dt>‘<samp><span class="samp">Xo</span></samp>’<dd>.Oo
-<code>auth</code> | <code>Cm</code> <code>bclient</code> | <code>calibrate</code> | <code>Cm</code> <code>kernel</code> | <code>monitor</code> | <code>Cm</code> <code>ntp</code> | <code>pps</code> | <code>Cm</code> <code>stats</code> .Oc
-<br><dt>‘<samp><span class="samp">Xo</span></samp>’<dd>.Oo
-<code>auth</code> | <code>Cm</code> <code>bclient</code> | <code>calibrate</code> | <code>Cm</code> <code>kernel</code> | <code>monitor</code> | <code>Cm</code> <code>ntp</code> | <code>pps</code> | <code>Cm</code> <code>stats</code> .Oc
-These commands operate in the same way as the
-<code>enable</code> and
-<code>disable</code> configuration file commands of
-<code>ntpd(8)</code>.
- <dl>
-<dt>‘<samp><span class="samp">Cm</span></samp>’<dd>Enables the server to synchronize with unconfigured peers only
-if the peer has been correctly authenticated using either public key
-or private key cryptography.
-The default for this flag is enable.
-<br><dt>‘<samp><span class="samp">Cm</span></samp>’<dd>Enables the server to listen for a message from a broadcast or
-multicast server, as in the multicastclient command with
-default address.
-The default for this flag is disable.
-<br><dt>‘<samp><span class="samp">Cm</span></samp>’<dd>Enables the calibrate feature for reference clocks.
-The default for this flag is disable.
-<br><dt>‘<samp><span class="samp">Cm</span></samp>’<dd>Enables the kernel time discipline, if available.
-The default for this flag is enable if support is available, otherwise disable.
-<br><dt>‘<samp><span class="samp">Cm</span></samp>’<dd>Enables the monitoring facility.
-See the
-<code>ntpdc(8)</code>.
-program and the monlist command or further information.
-The default for this flag is enable.
-<br><dt>‘<samp><span class="samp">Cm</span></samp>’<dd>Enables time and frequency discipline.
-In effect, this switch opens and closes the feedback loop,
-which is useful for testing.
-The default for this flag is enable.
-<br><dt>‘<samp><span class="samp">Cm</span></samp>’<dd>Enables the pulse-per-second (PPS) signal when frequency
-and time is disciplined by the precision time kernel modifications.
-See the
-"AKernelModelforPrecisionTimekeeping"
-(available as part of the HTML documentation
-provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>)
-)
-page for further information.
-The default for this flag is disable.
-<br><dt>‘<samp><span class="samp">Cm</span></samp>’<dd>Enables the statistics facility.
-See the
-<a href="#Monitoring">Monitoring</a>Monitoring
-Options
-section of
-<code>ntp.conf(5)</code>
-for further information.
-The default for this flag is disable.
-
- <p>.It
-Xo
-Ic
-restrict
-Ar
-address
-Ar
-mask
-<kbd>flag</kbd> <kbd>Oo</kbd> <kbd>Ar</kbd>... <kbd>Oc</kbd> This command operates in the same way as the
-<code>restrict</code> configuration file commands of
-<code>ntpd(8)</code>.
-.It
-Xo
-Ic
-unrestrict
-Ar
-address
-Ar
-mask
-<kbd>flag</kbd> <kbd>Oo</kbd> <kbd>Ar</kbd>... <kbd>Oc</kbd> Unrestrict the matching entry from the restrict list.
-.It
-Xo
-Ic
-delrestrict
-Ar
-address
-Ar
-mask
-[<code>ntpport</code> ]
-Delete the matching entry from the restrict list.
-.It
-Ic
-readkeys
-Causes the current set of authentication keys to be purged and
-a new set to be obtained by rereading the keys file (which must
-have been specified in the
-<code>ntpd(8)</code>
-configuration file).
-This
-allows encryption keys to be changed without restarting the
-server.
-.It
-Ic
-trustedkey
-Ar
-keyid
-Oo
-Ar
-...
-Oc
-.It
-Ic
-untrustedkey
-Ar
-keyid
-Oo
-Ar
-...
-Oc
-These commands operate in the same way as the
-<code>trustedkey</code> and
-<code>untrustedkey</code> configuration file
-commands of
-<code>ntpd(8)</code>.
-.It
-Ic
-authinfo
-Returns information concerning the authentication module,
-including known keys and counts of encryptions and decryptions
-which have been done.
-.It
-Ic
-traps
-Display the traps set in the server.
-See the source listing for
-further information.
-.It
-Xo
-Ic
-addtrap
-Ar
-address
-[<kbd>port</kbd> ]
-[<kbd>interface</kbd> ]
-Set a trap for asynchronous messages.
-See the source listing
-for further information.
-.It
-Xo
-Ic
-clrtrap
-Ar
-address
-[<kbd>port</kbd> ]
-[<kbd>interface</kbd> ]
-Clear a trap for asynchronous messages.
-See the source listing
-for further information.
-.It
-Ic
-reset
-Clear the statistics counters in various modules of the server.
-See the source listing for further information.
-
-<div class="node">
-<a name="ntpdc-See-Also"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-Authors">ntpdc Authors</a>,
-Previous: <a rel="previous" accesskey="p" href="#ntpdc-Usage">ntpdc Usage</a>,
-Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
-</div>
-
-<h4 class="subsection">ntpdc See Also</h4>
-
- <p><code>ntp.conf(5)</code>,
-<code>ntpd(8)</code>
-.Rs
-.%A
-David
-L.
-Mills
-.%T
-Network
-Time
-Protocol
-(Version
-3)
-.%O
-RFC1305
-.Re
-<div class="node">
-<a name="ntpdc-Authors"></a>
-<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-Bugs">ntpdc Bugs</a>,
-Previous: <a rel="previous" accesskey="p" href="#ntpdc-See-Also">ntpdc See Also</a>,
-Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
-</div>
-
-<h4 class="subsection">ntpdc Authors</h4>
-
- <p>The formatting directives in this document came from FreeBSD.
-<div class="node">
-<a name="ntpdc-Bugs"></a>
-<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntpdc-Authors">ntpdc Authors</a>,
-Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
-</div>
-
-<h4 class="subsection">ntpdc Bugs</h4>
-
- <p>The
-<code>ntpdc</code>
-utility is a crude hack.
-Much of the information it shows is
-deadly boring and could only be loved by its implementer.
-The
-program was designed so that new (and temporary) features were easy
-to hack in, at great expense to the program's ease of use.
-Despite
-this, the program is occasionally useful.
-
- <p>Please report bugs to http://bugs.ntp.org .
-
-<div class="node">
-<a name="Usage"></a>
-<p><hr>
-
-
-</div>
-
- <!-- node-name, next, previous, up -->
-<h3 class="section">Usage</h3>
-
- <p>The simplest use of this program is as an unprivileged command to
-check the current time, offset, and error in the local clock.
-For example:
-
- <pre class="example"> ntpdc ntpserver.somewhere
-</pre>
- <p>With suitable privilege, it can be run as a command or in a
-<code>cron</code> job to reset the local clock from a reliable server, like
-the <code>ntpdate</code> and <code>rdate</code> commands.
-For example:
-
- <pre class="example"> ntpdc -a ntpserver.somewhere
-</pre>
- </body></html>
-
-.TH ntpdc @NTPDC_MS@ "25 Dec 2012" "4.2.7p338" "User Commands"
+.TH ntpdc @NTPDC_MS@ "26 Dec 2012" "4.2.7p339" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:34:51 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:10:58 AM by AutoGen 5.16.2
.\" From the definitions ntpdc-opts.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTPDC @NTPDC_MS@ User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:34:57 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:05 AM by AutoGen 5.16.2
.\" From the definitions ntpdc-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpq.texi)
#
-# It has been AutoGen-ed December 25, 2012 at 11:35:11 AM by AutoGen 5.16.2
+# It has been AutoGen-ed December 26, 2012 at 04:11:20 AM by AutoGen 5.16.2
# From the definitions ntpq-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@item Ic
The data carried by NTP mode 6 messages consists of a list of
items of the form
-@quoteleft{}variable_name=value ,@quoteright{}
+@quoteleft{}variable_name=value@quoteright{},
+,
where the
@quoteleft{}=value@quoteright{}
is ignored, and can be omitted,
@code{ntpq}
thinks should have a decodable value but didn't are
marked with a trailing
-@quoteleft{}\&? .@quoteright{}
+@quoteleft{}\&?@quoteright{}.
+.
@item Xo
@code{debug} .Oo
@code{more} | @code{less} | @code{off} .Oc
@exampleindent 0
@example
-ntpq - standard NTP query program - Ver. 4.2.7p338
+ntpq - standard NTP query program - Ver. 4.2.7p339
USAGE: ntpq [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [ host ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 DNS name resolution
/*
* EDIT THIS FILE WITH CAUTION (ntpq-opts.c)
*
- * It has been AutoGen-ed December 25, 2012 at 11:35:01 AM by AutoGen 5.16.2
+ * It has been AutoGen-ed December 26, 2012 at 04:11:08 AM by AutoGen 5.16.2
* From the definitions ntpq-opts.def
* and the template file options
*
* ntpq option static const strings
*/
static char const ntpq_opt_strs[1833] =
-/* 0 */ "ntpq 4.2.7p338\n"
+/* 0 */ "ntpq 4.2.7p339\n"
"Copyright (C) 1970-2012 The University of Delaware, all rights reserved.\n"
"This is free software. It is licensed for use, modification and\n"
"redistribution under the terms of the NTP License, copies of which\n"
/* 1627 */ "no-load-opts\0"
/* 1640 */ "no\0"
/* 1643 */ "NTPQ\0"
-/* 1648 */ "ntpq - standard NTP query program - Ver. 4.2.7p338\n"
+/* 1648 */ "ntpq - standard NTP query program - Ver. 4.2.7p339\n"
"USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n\0"
/* 1769 */ "$HOME\0"
/* 1775 */ ".\0"
/* 1777 */ ".ntprc\0"
/* 1784 */ "http://bugs.ntp.org, bugs@ntp.org\0"
-/* 1818 */ "ntpq 4.2.7p338";
+/* 1818 */ "ntpq 4.2.7p339";
/*
* ipv4 option description with
/*
* EDIT THIS FILE WITH CAUTION (ntpq-opts.h)
*
- * It has been AutoGen-ed December 25, 2012 at 11:35:00 AM by AutoGen 5.16.2
+ * It has been AutoGen-ed December 26, 2012 at 04:11:08 AM by AutoGen 5.16.2
* From the definitions ntpq-opts.def
* and the template file options
*
} teOptIndex;
#define OPTION_CT 14
-#define NTPQ_VERSION "4.2.7p338"
-#define NTPQ_FULL_VERSION "ntpq 4.2.7p338"
+#define NTPQ_VERSION "4.2.7p339"
+#define NTPQ_FULL_VERSION "ntpq 4.2.7p339"
/*
* Interface defines for all options. Replace "n" with the UPPER_CASED
-.TH ntpq 1ntpqman "25 Dec 2012" "4.2.7p338" "User Commands"
+.TH ntpq 1ntpqman "26 Dec 2012" "4.2.7p339" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpq-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:35:07 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:16 AM by AutoGen 5.16.2
.\" From the definitions ntpq-opts.def
.\" and the template file agman-cmd.tpl
.\"
.\" Mixture of short (flag) options and long options
.RB [ \-\fIflag\fP " [\fIvalue\fP]]... [" \-\-\fIopt\-name\fP " [[=| ]\fIvalue\fP]]..." [ host ...]
.SH DESCRIPTION
-The
-.B
-utility program is used to query NTP servers which
-implement the standard NTP mode 6 control message formats defined
-in Appendix B of the NTPv3 specification RFC1305, requesting
-information about current state and/or changes in that state.
-The same formats are used in NTPv4, although some of the
-variables have changed and new ones added. The description on this
-page is for the NTPv4 variables.
-The program may be run either in interactive mode or controlled using
-command line arguments.
-Requests to read and write arbitrary
-variables can be assembled, with raw and pretty-printed output
-options being available.
-The
-.B
-utility can also obtain and print a
-list of peers in a common format by sending multiple queries to the
-server.
-If one or more request options is included on the command line
-when
-.B
-is executed, each of the requests will be sent
-to the NTP servers running on each of the hosts given as command
-line arguments, or on localhost by default.
-If no request options
-are given,
-.B
-will attempt to read commands from the
-standard input and execute these on the NTP server running on the
-first host given on the command line, again defaulting to localhost
-when no other host is specified.
-The
-.B
-utility will prompt for
-commands if the standard input is a terminal device.
-.B
-uses NTP mode 6 packets to communicate with the
-NTP server, and hence can be used to query any compatible server on
-the network which permits it.
-Note that since NTP is a UDP protocol
-this communication will be somewhat unreliable, especially over
-large distances in terms of network topology.
-The
-.B
-utility makes
-one attempt to retransmit requests, and will time requests out if
-the remote host is not heard from within a suitable timeout
-time.
-Specifying a
-command line option other than
-i
-or
-n
-will
-cause the specified query (queries) to be sent to the indicated
-host(s) immediately.
-Otherwise,
-.B
-will attempt to read
-interactive format commands from the standard input.
-.SS "Internal Commands"
-Interactive format commands consist of a keyword followed by zero
-to four arguments.
-Only enough characters of the full keyword to
-uniquely identify the command need be typed.
-A
-number of interactive format commands are executed entirely within
-the
-.B
-utility itself and do not result in NTP mode 6
-requests being sent to a server.
-These are described following.
-.TP
-.BR Ic ? Op Ar command_keyword
-.TP
-.BR Ic help Op Ar command_keyword
-A
-.Ql \&?
-by itself will print a list of all the command
-keywords known to this incarnation of
-.Nm .
-A
-.Ql \&?
-followed by a command keyword will print function and usage
-information about the command.
-This command is probably a better
-source of information about
-.Nm
-than this manual
-page.
-.TP
-.BR Ic addvars Ar variable_name Xo Op Ic =value
-.Ic ...
-.Xc
-.TP
-.BR Ic rmvars Ar variable_name Ic ...
-.TP
-.BR Ic clearvars
-The data carried by NTP mode 6 messages consists of a list of
-items of the form
-.Ql variable_name=value ,
-where the
-.Ql =value
-is ignored, and can be omitted,
-in requests to the server to read variables.
-The
-.Nm
-utility maintains an internal list in which data to be included in control
-messages can be assembled, and sent using the
-.Ic readlist
-and
-.Ic writelist
-commands described below.
-The
-.Ic addvars
-command allows variables and their optional values to be added to
-the list.
-If more than one variable is to be added, the list should
-be comma-separated and not contain white space.
-The
-.Ic rmvars
-command can be used to remove individual variables from the list,
-while the
-.Ic clearlist
-command removes all variables from the
-list.
-.TP
-.BR Ic authenticate Op yes | no
-Normally
-.Nm
-does not authenticate requests unless
-they are write requests.
-The command
-.Ql authenticate yes
-causes
-.Nm
-to send authentication with all requests it
-makes.
-Authenticated requests causes some servers to handle
-requests slightly differently, and can occasionally melt the CPU in
-fuzzballs if you turn authentication on before doing a
-.Ic peer
-display.
-The command
-.Ql authenticate
-causes
-.Nm
-to display whether or not
-.Nm
-is currently autheinticating requests.
-.TP
-.BR Ic cooked
-Causes output from query commands to be "cooked", so that
-variables which are recognized by
-.Nm
-will have their
-values reformatted for human consumption.
-Variables which
-.Nm
-thinks should have a decodable value but didn't are
-marked with a trailing
-.Ql \&? .
-.TP
-.BR Xo
-.Ic debug
-.Oo
-.Cm more |
-.Cm less |
-.Cm off
-.Oc
-.Xc
-With no argument, displays the current debug level.
-Otherwise, the debug level is changed to the indicated level.
-.TP
-.BR Ic delay Ar milliseconds
-Specify a time interval to be added to timestamps included in
-requests which require authentication.
-This is used to enable
-(unreliable) server reconfiguration over long delay network paths
-or between machines whose clocks are unsynchronized.
-Actually the
-server does not now require timestamps in authenticated requests,
-so this command may be obsolete.
-.TP
-.BR Ic host Ar hostname
-Set the host to which future queries will be sent.
-\fIhostname\fR
-may be either a host name or a numeric address.
-.TP
-.BR Ic hostnames Op Cm yes | Cm no
-If
-.Cm yes
-is specified, host names are printed in
-information displays.
-If
-.Cm no
-is specified, numeric
-addresses are printed instead.
-The default is
-.Cm yes ,
-unless
-modified using the command line
-n
-switch.
-.TP
-.BR Ic keyid Ar keyid
-This command allows the specification of a key number to be
-used to authenticate configuration requests.
-This must correspond
-to a key number the server has been configured to use for this
-purpose.
-.TP
-.BR Ic ntpversion Xo Oo
-.Cm 1 |
-.Cm 2 |
-.Cm 3 |
-.Cm 4
-.Oc
-.Xc
-Sets the NTP version number which
-.Nm
-claims in
-packets.
-Defaults to 3, and note that mode 6 control messages (and
-modes, for that matter) didn't exist in NTP version 1.
-There appear
-to be no servers left which demand version 1.
-With no argument, displays the current NTP version that will be used
-when communicating with servers.
-.TP
-.BR Ic quit
-Exit
-.Nm
-.TP
-.BR Ic passwd
-This command prompts you to type in a password (which will not
-be echoed) which will be used to authenticate configuration
-requests.
-The password must correspond to the key configured for
-use by the NTP server for this purpose if such requests are to be
-successful.
-.TP
-.BR Ic raw
-Causes all output from query commands is printed as received
-from the remote server.
-The only formating/interpretation done on
-the data is to transform nonascii data into a printable (but barely
-understandable) form.
-.TP
-.BR Ic timeout Ar milliseconds
-Specify a timeout period for responses to server queries.
-The
-default is about 5000 milliseconds.
-Note that since
-.Nm
-retries each query once after a timeout, the total waiting time for
-a timeout will be twice the timeout value set.
.SH "OPTIONS"
.TP
.BR \-4 ", " -\-ipv4
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTPQ 1ntpqmdoc User Commands
-.Os FreeBSD 6.4-STABLE
+.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpq-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:35:13 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:21 AM by AutoGen 5.16.2
.\" From the definitions ntpq-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
[ host ...]
.Pp
.Sh DESCRIPTION
-The
-.Nm
-utility program is used to query NTP servers which
-implement the standard NTP mode 6 control message formats defined
-in Appendix B of the NTPv3 specification RFC1305, requesting
-information about current state and/or changes in that state.
-The same formats are used in NTPv4, although some of the
-variables have changed and new ones added. The description on this
-page is for the NTPv4 variables.
-The program may be run either in interactive mode or controlled using
-command line arguments.
-Requests to read and write arbitrary
-variables can be assembled, with raw and pretty-printed output
-options being available.
-The
-.Nm
-utility can also obtain and print a
-list of peers in a common format by sending multiple queries to the
-server.
-If one or more request options is included on the command line
-when
-.Nm
-is executed, each of the requests will be sent
-to the NTP servers running on each of the hosts given as command
-line arguments, or on localhost by default.
-If no request options
-are given,
-.Nm
-will attempt to read commands from the
-standard input and execute these on the NTP server running on the
-first host given on the command line, again defaulting to localhost
-when no other host is specified.
-The
-.Nm
-utility will prompt for
-commands if the standard input is a terminal device.
-.Nm
-uses NTP mode 6 packets to communicate with the
-NTP server, and hence can be used to query any compatible server on
-the network which permits it.
-Note that since NTP is a UDP protocol
-this communication will be somewhat unreliable, especially over
-large distances in terms of network topology.
-The
-.Nm
-utility makes
-one attempt to retransmit requests, and will time requests out if
-the remote host is not heard from within a suitable timeout
-time.
-Specifying a
-command line option other than
-.Fl i
-or
-.Fl n
-will
-cause the specified query (queries) to be sent to the indicated
-host(s) immediately.
-Otherwise,
-.Nm
-will attempt to read
-interactive format commands from the standard input.
-.Ss "Internal Commands"
-Interactive format commands consist of a keyword followed by zero
-to four arguments.
-Only enough characters of the full keyword to
-uniquely identify the command need be typed.
-A
-number of interactive format commands are executed entirely within
-the
-.Nm
-utility itself and do not result in NTP mode 6
-requests being sent to a server.
-These are described following.
-.Bl -tag -width "? [command_keyword]" -compact -offset indent
-.It Ic ? Op Ar command_keyword
-.It Ic help Op Ar command_keyword
-A
-.Ql \&?
-by itself will print a list of all the command
-keywords known to this incarnation of
-.Nm .
-A
-.Ql \&?
-followed by a command keyword will print function and usage
-information about the command.
-This command is probably a better
-source of information about
-.Nm
-than this manual
-page.
-.It Ic addvars Ar variable_name Xo Op Ic =value
-.Ic ...
-.Xc
-.It Ic rmvars Ar variable_name Ic ...
-.It Ic clearvars
-The data carried by NTP mode 6 messages consists of a list of
-items of the form
-.Ql variable_name=value ,
-where the
-.Ql =value
-is ignored, and can be omitted,
-in requests to the server to read variables.
-The
-.Nm
-utility maintains an internal list in which data to be included in control
-messages can be assembled, and sent using the
-.Ic readlist
-and
-.Ic writelist
-commands described below.
-The
-.Ic addvars
-command allows variables and their optional values to be added to
-the list.
-If more than one variable is to be added, the list should
-be comma-separated and not contain white space.
-The
-.Ic rmvars
-command can be used to remove individual variables from the list,
-while the
-.Ic clearlist
-command removes all variables from the
-list.
-.It Ic authenticate Op yes | no
-Normally
-.Nm
-does not authenticate requests unless
-they are write requests.
-The command
-.Ql authenticate yes
-causes
-.Nm
-to send authentication with all requests it
-makes.
-Authenticated requests causes some servers to handle
-requests slightly differently, and can occasionally melt the CPU in
-fuzzballs if you turn authentication on before doing a
-.Ic peer
-display.
-The command
-.Ql authenticate
-causes
-.Nm
-to display whether or not
-.Nm
-is currently autheinticating requests.
-.It Ic cooked
-Causes output from query commands to be "cooked", so that
-variables which are recognized by
-.Nm
-will have their
-values reformatted for human consumption.
-Variables which
-.Nm
-thinks should have a decodable value but didn't are
-marked with a trailing
-.Ql \&? .
-.It Xo
-.Ic debug
-.Oo
-.Cm more |
-.Cm less |
-.Cm off
-.Oc
-.Xc
-With no argument, displays the current debug level.
-Otherwise, the debug level is changed to the indicated level.
-.It Ic delay Ar milliseconds
-Specify a time interval to be added to timestamps included in
-requests which require authentication.
-This is used to enable
-(unreliable) server reconfiguration over long delay network paths
-or between machines whose clocks are unsynchronized.
-Actually the
-server does not now require timestamps in authenticated requests,
-so this command may be obsolete.
-.It Ic host Ar hostname
-Set the host to which future queries will be sent.
-.Ar hostname
-may be either a host name or a numeric address.
-.It Ic hostnames Op Cm yes | Cm no
-If
-.Cm yes
-is specified, host names are printed in
-information displays.
-If
-.Cm no
-is specified, numeric
-addresses are printed instead.
-The default is
-.Cm yes ,
-unless
-modified using the command line
-.Fl n
-switch.
-.It Ic keyid Ar keyid
-This command allows the specification of a key number to be
-used to authenticate configuration requests.
-This must correspond
-to a key number the server has been configured to use for this
-purpose.
-.It Ic ntpversion Xo Oo
-.Cm 1 |
-.Cm 2 |
-.Cm 3 |
-.Cm 4
-.Oc
-.Xc
-Sets the NTP version number which
-.Nm
-claims in
-packets.
-Defaults to 3, and note that mode 6 control messages (and
-modes, for that matter) didn't exist in NTP version 1.
-There appear
-to be no servers left which demand version 1.
-With no argument, displays the current NTP version that will be used
-when communicating with servers.
-.It Ic quit
-Exit
-.Nm
-.It Ic passwd
-This command prompts you to type in a password (which will not
-be echoed) which will be used to authenticate configuration
-requests.
-The password must correspond to the key configured for
-use by the NTP server for this purpose if such requests are to be
-successful.
-.It Ic raw
-Causes all output from query commands is printed as received
-from the remote server.
-The only formating/interpretation done on
-the data is to transform nonascii data into a printable (but barely
-understandable) form.
-.It Ic timeout Ar milliseconds
-Specify a timeout period for responses to server queries.
-The
-default is about 5000 milliseconds.
-Note that since
-.Nm
-retries each query once after a timeout, the total waiting time for
-a timeout will be twice the timeout value set.
-.El
.Sh "OPTIONS"
.Bl -tag
.It \-4 ", " -\-ipv4
</head>
<body>
<h1 class="settitle">ntpq: Network Time Protocol Query User's Manual</h1>
-
<div class="shortcontents">
+ <div class="shortcontents">
<h2>Short Contents</h2>
<ul>
<a href="#Top">ntpq: Network Time Protocol Query User Manual</a>
<div class="node">
<p><hr>
-<a name="Top"></a>Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
+<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpq-Description">ntpq Description</a>,
+Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
+Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
<br>
</div>
and determine the performance of
<code>ntpd</code>, the NTP daemon.
- <p>This document applies to version 4.2.7p337 of <code>ntpq</code>.
+ <p>This document applies to version 4.2.7p339 of <code>ntpq</code>.
<ul class="menu">
<li><a accesskey="1" href="#ntpq-Description">ntpq Description</a>
<li><a accesskey="9" href="#Clock-Variables">Clock Variables</a>
</ul>
-<div class="node">
-<p><hr>
-<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpq-Description">ntpq Description</a>,
-Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
-Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-<br>
-</div>
-
-<h2 class="unnumbered">ntpq: Network Time Protocol Query User Manual</h2>
-
-<p>The <code>ntpq</code> utility program is used to monitor NTP daemon <code>ntpd</code>
-operations and determine performance. It uses the standard NTP mode 6 control
-
- <p>This document applies to version {No value for `VERSION'} of <code>ntpq</code>.
-
-<ul class="menu">
-<li><a accesskey="1" href="#ntpq-Description">ntpq Description</a>: Description
-<li><a accesskey="2" href="#ntpq-Invocation">ntpq Invocation</a>: Invoking ntpq
-<li><a accesskey="3" href="#Usage">Usage</a>: Usage
-</ul>
-
<div class="node">
<p><hr>
<a name="ntpq-Description"></a>Next: <a rel="next" accesskey="n" href="#Usage">Usage</a>,
<code>ntpq</code>
than this manual
page.
-<br><dt><span class="samp">Ic</span><dd>... <br><dt><span class="samp">Ic</span><br><dt><span class="samp">Ic</span><dd>The data carried by NTP mode 6 messages consists of a list of
+<br><dt><span class="samp">Ic</span><dd><code>...</code> <br><dt><span class="samp">Ic</span><br><dt><span class="samp">Ic</span><dd>The data carried by NTP mode 6 messages consists of a list of
items of the form
-variable_name=value,
+variable_name=value ,
where the
=value
is ignored, and can be omitted,
does not authenticate requests unless
they are write requests.
The command
-authenticateyes
+authenticate yes
causes
<code>ntpq</code>
to send authentication with all requests it
<code>ntpq</code>
thinks should have a decodable value but didn't are
marked with a trailing
-\&?.
+\&? .
<br><dt><span class="samp">Xo</span><dd><code>debug</code> .Oo
<code>more</code> | <code>less</code> | <code>off</code> .Oc
With no argument, displays the current debug level.
server does not now require timestamps in authenticated requests,
so this command may be obsolete.
<br><dt><span class="samp">Ic</span><dd>Set the host to which future queries will be sent.
-<kbd>hostname</kbd> may be either a host name or a numeric address.
+<code>hostname</code> may be either a host name or a numeric address.
<br><dt><span class="samp">Ic</span><dd>If
<code>yes</code> is specified, host names are printed in
information displays.
Note that since
<code>ntpq</code>
retries each query once after a timeout, the total waiting time for
-a timeout will be twice the timeout value set.
+a timeout will be twice the timeout value set.
+</dl>
-
<p>This section was generated by <strong>AutoGen</strong>,
+ <p>This section was generated by <strong>AutoGen</strong>,
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntpq</code> program.
This software is released under the NTP license, <http://ntp.org/license>.
+<ul class="menu">
<li><a accesskey="1" href="#ntpq-usage">ntpq usage</a>: ntpq help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#ntpq-ipv4">ntpq ipv4</a>: ipv4 option (-4)
<li><a accesskey="3" href="#ntpq-ipv6">ntpq ipv6</a>: ipv6 option (-6)
<h4 class="subsection">ntpq help/usage (<span class="option">--help</span>)</h4>
-
<p><a name="index-ntpq-help-3"></a>
+<p><a name="index-ntpq-help-3"></a>
This is the automatically generated usage text for ntpq.
-
<p>The text printed is the same whether selected with the <code>help</code> option
+ <p>The text printed is the same whether selected with the <code>help</code> option
(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
- <pre class="example"> ntpq - standard NTP query program - Ver. 4.2.7p337
- USAGE: ntpq [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]
- Flg Arg Option-Name Description
- -4 no ipv4 Force IPv4 DNS name resolution
- - prohibits these options:
- ipv6
- -6 no ipv6 Force IPv6 DNS name resolution
- - prohibits these options:
- ipv4
- -c Str command run a command and exit
- - may appear multiple times
- -d no debug-level Increase debug verbosity level
- - may appear multiple times
- -D Num set-debug-level Set the debug verbosity level
- - may appear multiple times
- -p no peers Print a list of the peers
- - prohibits these options:
- interactive
- -i no interactive Force ntpq to operate in interactive mode
- - prohibits these options:
- command
- peers
- -n no numeric numeric host addresses
- no old-rv Always output status line with readvar
- opt version Output version information and exit
- -? no help Display extended usage information and exit
- -! no more-help Extended usage information passed thru pager
- -> opt save-opts Save the option state to a config file
- -< Str load-opts Load options from a config file
- - disabled as --no-load-opts
- - may appear multiple times
-
- Options are specified by doubled hyphens and their name or by a single
- hyphen and the flag character.
-
- The following option preset mechanisms are supported:
- - reading file $HOME/.ntprc
- - reading file ./.ntprc
- - examining environment variables named NTPQ_*
-
- please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
+<pre class="example">ntpq - standard NTP query program - Ver. 4.2.7p338
+USAGE: ntpq [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]
+ Flg Arg Option-Name Description
+ -4 no ipv4 Force IPv4 DNS name resolution
+ - prohibits these options:
+ ipv6
+ -6 no ipv6 Force IPv6 DNS name resolution
+ - prohibits these options:
+ ipv4
+ -c Str command run a command and exit
+ - may appear multiple times
+ -d no debug-level Increase debug verbosity level
+ - may appear multiple times
+ -D Num set-debug-level Set the debug verbosity level
+ - may appear multiple times
+ -p no peers Print a list of the peers
+ - prohibits these options:
+ interactive
+ -i no interactive Force ntpq to operate in interactive mode
+ - prohibits these options:
+ command
+ peers
+ -n no numeric numeric host addresses
+ no old-rv Always output status line with readvar
+ opt version Output version information and exit
+ -? no help Display extended usage information and exit
+ -! no more-help Extended usage information passed thru pager
+ -> opt save-opts Save the option state to a config file
+ -< Str load-opts Load options from a config file
+ - disabled as --no-load-opts
+ - may appear multiple times
+
+Options are specified by doubled hyphens and their name or by a single
+hyphen and the flag character.
+
+The following option preset mechanisms are supported:
+ - reading file $HOME/.ntprc
+ - reading file ./.ntprc
+ - examining environment variables named NTPQ_*
+
+please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
</pre>
+ <div class="node">
<p><hr>
<a name="ntpq-ipv4"></a>Next: <a rel="next" accesskey="n" href="#ntpq-ipv6">ntpq ipv6</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpq-usage">ntpq usage</a>,
<h4 class="subsection">ipv4 option (-4)</h4>
-
<p><a name="index-ntpq_002dipv4-4"></a>
+<p><a name="index-ntpq_002dipv4-4"></a>
This is the “force ipv4 dns name resolution” option.
-
<p class="noindent">This option has some usage constraints. It:
+<p class="noindent">This option has some usage constraints. It:
+ <ul>
<li>must not appear in combination with any of the following options:
ipv6.
</ul>
-
<p>Force DNS resolution of following host names on the command line
+ <p>Force DNS resolution of following host names on the command line
to the IPv4 namespace.
<div class="node">
<p><hr>
<h4 class="subsection">ipv6 option (-6)</h4>
-
<p><a name="index-ntpq_002dipv6-5"></a>
+<p><a name="index-ntpq_002dipv6-5"></a>
This is the “force ipv6 dns name resolution” option.
-
<p class="noindent">This option has some usage constraints. It:
+<p class="noindent">This option has some usage constraints. It:
+ <ul>
<li>must not appear in combination with any of the following options:
ipv4.
</ul>
-
<p>Force DNS resolution of following host names on the command line
+ <p>Force DNS resolution of following host names on the command line
to the IPv6 namespace.
<div class="node">
<p><hr>
<h4 class="subsection">command option (-c)</h4>
-
<p><a name="index-ntpq_002dcommand-6"></a>
+<p><a name="index-ntpq_002dcommand-6"></a>
This is the “run a command and exit” option.
This option takes an argument string <span class="file">cmd</span>.
-
<p class="noindent">This option has some usage constraints. It:
+<p class="noindent">This option has some usage constraints. It:
+ <ul>
<li>may appear an unlimited number of times.
</ul>
-
<p>The following argument is interpreted as an interactive format command
+ <p>The following argument is interpreted as an interactive format command
and is added to the list of commands to be executed on the specified
host(s).
<div class="node">
<h4 class="subsection">peers option (-p)</h4>
-
<p><a name="index-ntpq_002dpeers-7"></a>
+<p><a name="index-ntpq_002dpeers-7"></a>
This is the “print a list of the peers” option.
-
<p class="noindent">This option has some usage constraints. It:
+<p class="noindent">This option has some usage constraints. It:
+ <ul>
<li>must not appear in combination with any of the following options:
interactive.
</ul>
-
<p>Print a list of the peers known to the server as well as a summary
+ <p>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.
<div class="node">
<p><hr>
<h4 class="subsection">interactive option (-i)</h4>
-
<p><a name="index-ntpq_002dinteractive-8"></a>
+<p><a name="index-ntpq_002dinteractive-8"></a>
This is the “force ntpq to operate in interactive mode” option.
-
<p class="noindent">This option has some usage constraints. It:
+<p class="noindent">This option has some usage constraints. It:
+ <ul>
<li>must not appear in combination with any of the following options:
command, peers.
</ul>
-
<p>Force ntpq to operate in interactive mode. Prompts will be written
+ <p>Force ntpq to operate in interactive mode. Prompts will be written
to the standard output and commands read from the standard input.
<div class="node">
<p><hr>
<h4 class="subsection">numeric option (-n)</h4>
-
<p><a name="index-ntpq_002dnumeric-9"></a>
+<p><a name="index-ntpq_002dnumeric-9"></a>
This is the “numeric host addresses” option.
Output all host addresses in dotted-quad numeric format rather than
converting to the canonical host names.
<h4 class="subsection">old-rv option</h4>
-
<p><a name="index-ntpq_002dold_002drv-10"></a>
+<p><a name="index-ntpq_002dold_002drv-10"></a>
This is the “always output status line with readvar” option.
By default, ntpq now suppresses the associd=... line that
precedes the output of "readvar" (alias "rv") when a single
<h4 class="subsection">presetting/configuring ntpq</h4>
-
<p>Any option that is not marked as <i>not presettable</i> may be preset by
+<p>Any option that is not marked as <i>not presettable</i> may be preset by
loading values from configuration ("rc" or "ini") files, and values from environment variables named <code>NTPQ</code> and <code>NTPQ_<OPTION_NAME></code>. <code><OPTION_NAME></code> must be one of
the options listed above in upper case and segmented with underscores.
The <code>NTPQ</code> variable will be tokenized and parsed like
the command line. The remaining variables are tested for existence and their
values are treated like option arguments.
-
<p class="noindent"><code>libopts</code> will search in 2 places for configuration files:
+<p class="noindent"><code>libopts</code> will search in 2 places for configuration files:
+ <ul>
<li>$HOME
<li>$PWD
</ul>
- The environment variables <code>HOME</code>, and <code>PWD</code>
+ The environment variables <code>HOME</code>, and <code>PWD</code>
are expanded and replaced when <span class="file">ntpq</span> runs.
For any of these that are plain files, they are simply processed.
For any that are directories, then a file named <span class="file">.ntprc</span> is searched for
within that directory and processed.
-
<p>Configuration files may be in a wide variety of formats.
+ <p>Configuration files may be in a wide variety of formats.
The basic format is an option name followed by a value (argument) on the
same line. Values may be separated from the option name with a colon,
equal sign or simply white space. Values may be continued across multiple
lines by escaping the newline with a backslash.
-
<p>Multiple programs may also share the same initialization file.
+ <p>Multiple programs may also share the same initialization file.
Common options are collected at the top, followed by program specific
segments. The segments are separated by lines like:
- <pre class="example"> [NTPQ]
- </pre>
-
<p class="noindent">or by
- <pre class="example"> <?program ntpq>
- </pre>
-
<p class="noindent">Do not mix these styles within one configuration file.
-
-
<p>Compound values and carefully constructed string values may also be
+<pre class="example"> [NTPQ]
+</pre>
+ <p class="noindent">or by
+<pre class="example"> <?program ntpq>
+</pre>
+ <p class="noindent">Do not mix these styles within one configuration file.
+
+ <p>Compound values and carefully constructed string values may also be
specified using XML syntax:
- <pre class="example"> <option-name>
- <sub-opt>...&lt;...&gt;...</sub-opt>
- </option-name>
- </pre>
-
<p class="noindent">yielding an <code>option-name.sub-opt</code> string value of
- <pre class="example"> "...<...>..."
- </pre>
-
<p><code>AutoOpts</code> does not track suboptions. You simply note that it is a
+<pre class="example"> <option-name>
+ <sub-opt>...&lt;...&gt;...</sub-opt>
+ </option-name>
+</pre>
+ <p class="noindent">yielding an <code>option-name.sub-opt</code> string value of
+<pre class="example"> "...<...>..."
+</pre>
+ <p><code>AutoOpts</code> does not track suboptions. You simply note that it is a
hierarchicly valued option. <code>AutoOpts</code> does provide a means for searching
the associated name/value pair list (see: optionFindValue).
-
<p>The command line options relating to configuration and/or usage help are:
+ <p>The command line options relating to configuration and/or usage help are:
<h5 class="subsubheading">version (-)</h5>
-
<p>Print the program version to standard out, optionally with licensing
+<p>Print the program version to standard out, optionally with licensing
information, then exit 0. The optional argument specifies how much licensing
detail to provide. The default is to print just the version. The licensing infomation may be selected with an option argument. Only the
first letter of the argument is examined:
+ <dl>
<dt><span class="samp">version</span><dd>Only print the version. This is the default.
<br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms.
<br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms.
<h4 class="subsection">ntpq exit status</h4>
-
<p>One of the following exit values will be returned:
+<p>One of the following exit values will be returned:
+ <dl>
<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
<br><dt><span class="samp">66 (EX_NOINPUT)</span><dd>A specified configuration file could not be loaded.
<br>
</div>
- <!-- node-name, next, previous, up -->
+<!-- node-name, next, previous, up -->
<h3 class="section">Usage</h3>
-
<p><table summary=""><tr align="left"><th valign="top" width="23%">What </th><th valign="top" width="23%">Default </th><th valign="top" width="5%">Flag </th><th valign="top" width="15%">Option
+<p><table summary=""><tr align="left"><th valign="top" width="23%">What </th><th valign="top" width="23%">Default </th><th valign="top" width="5%">Flag </th><th valign="top" width="15%">Option
<br></th></tr><tr align="left"><td valign="top" width="23%">configuration file
</td><td valign="top" width="23%"><code>/etc/ntp.conf</code>
</td><td valign="top" width="5%"><code>-c</code>
<br>
</div>
- <!-- node-name, next, previous, up -->
+<!-- node-name, next, previous, up -->
<h3 class="section">Internal Commands</h3>
-
<p>Interactive format commands consist of a keyword followed by zero to four arguments. Only enough characters of the full keyword to uniquely identify the command need be typed. The output of a command is normally sent to the standard output, but optionally the output of individual commands may be sent to a file by appending a <code>></code>, followed by a file name, to the command line. A number of interactive format commands are executed entirely within the <code>ntpq</code> program itself and do not result in NTP mode-6 requests being sent to a server. These are described following.
+<p>Interactive format commands consist of a keyword followed by zero to four arguments. Only enough characters of the full keyword to uniquely identify the command need be typed. The output of a command is normally sent to the standard output, but optionally the output of individual commands may be sent to a file by appending a <code>></code>, followed by a file name, to the command line. A number of interactive format commands are executed entirely within the <code>ntpq</code> program itself and do not result in NTP mode-6 requests being sent to a server. These are described following.
-<dt><code><a name="help"></a> ? [</code><kbd>command_keyword</kbd><code><dt>help [</code><kbd>command_keyword</kbd><code>]<dd>A ? by itself will print a list of all the command keywords known to ntpq. A ? followed by a command keyword will print function and usage information about the command.
+ <dl>
+<dt><code><a name="help"></a> ? [</code><kbd>command_keyword</kbd><code>]</code><dt><code>help [</code><kbd>command_keyword</kbd><code>]</code><dd>A <code>?</code> by itself will print a list of all the command keywords known to <code>ntpq</code>. A <code>?</code> followed by a command keyword will print function and usage information about the command.
- <br><dt><a name="addvars"></a> >addvars </code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code>] [...]<dt>rmvars </code><kbd>name</kbd><code> [...]<dt>clearvars</dt><dd>The arguments to these commands consist of a list of items of the form
-</code><kbd>name</kbd><code> = </code><kbd>value</kbd><code>, where the = </code><kbd>value</kbd><code> is ignored,
+ <br><dt><code><a name="addvars"></a> >addvars </code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code>] [...]</code><dt><code>rmvars </code><kbd>name</kbd><code> [...]</code><dt><code>clearvars</dt></code><dd>The arguments to these commands consist of a list of items of the form
+<kbd>name</kbd><code> = </code><kbd>value</kbd>, where the <code>= </code><kbd>value</kbd> is ignored,
and can be omitted in read requests.
<code>ntpq</code> maintains an internal list in which data to be included
in control messages can be assembled, and sent using the <code>readlist</code>
from the list,
while the <code>clearlist</code> command removes all variables from the list.
- <br><dt><a name="cooked"></a> cooked<dd>Display server messages in prettyprint format.
- <br><dt><a name="debug"></a> debug more | less | off<dd>Turns internal query program debugging on and off.
- <br><dt><a name="delay"></a> delay </code><kbd>milliseconds</kbd><code><dd>Specify a time interval to be added to timestamps included in requests which require authentication. This is used to enable (unreliable) server reconfiguration over long delay network paths or between machines whose clocks are unsynchronized. Actually the server does not now require timestamps in authenticated requests, so this command may be obsolete.
+ <br><dt><code><a name="cooked"></a> cooked</code><dd>Display server messages in prettyprint format.
+
+ <br><dt><code><a name="debug"></a> debug more | less | off</code><dd>Turns internal query program debugging on and off.
- <br><dt><a name="host"></a> host </code><kbd>name</kbd><code><dd>Set the host to which future queries will be sent.
+ <br><dt><code><a name="delay"></a> delay </code><kbd>milliseconds</kbd><dd>Specify a time interval to be added to timestamps included in requests which require authentication. This is used to enable (unreliable) server reconfiguration over long delay network paths or between machines whose clocks are unsynchronized. Actually the server does not now require timestamps in authenticated requests, so this command may be obsolete.
+
+ <br><dt><code><a name="host"></a> host </code><kbd>name</kbd><dd>Set the host to which future queries will be sent.
The name may be either a DNS name or a numeric address.
- <br><dt><a name="hostnames"></a> hostnames [yes | no]<dd>If yes is specified, host names are printed in information displays.
-If no is specified, numeric addresses are printed instead.
-The default is yes,
-unless modified using the command line -n switch.
+ <br><dt><code><a name="hostnames"></a> hostnames [yes | no]</code><dd>If <code>yes</code> is specified, host names are printed in information displays.
+If <code>no</code> is specified, numeric addresses are printed instead.
+The default is <code>yes</code>,
+unless modified using the command line <code>-n</code> switch.
- <br><dt><a name="keyid"></a> keyid </code><kbd>keyid</kbd><code><dd>This command specifies the key number to be used
+ <br><dt><code><a name="keyid"></a> keyid </code><kbd>keyid</kbd><dd>This command specifies the key number to be used
to authenticate configuration requests.
This must correspond to a key ID configured in <code>ntp.conf</code> for this purpose.
- <br><dt><a name="keytype"></a> keytype<dd>Specify the digest algorithm to use for authenticated requests,
-with default MD5.
+ <br><dt><code><a name="keytype"></a> keytype</code><dd>Specify the digest algorithm to use for authenticated requests,
+with default <code>MD5</code>.
If the OpenSSL library is installed,
digest can be be any message digest algorithm supported by the library.
The current selections are: <code>MD2</code>, <code>MD4</code>, <code>MD5</code>, <code>MDC2</code>, <code>RIPEMD160</code>, <code>SHA</code> and <code>SHA1</code>.
- <br><dt><a name="ntpversion"></a> ntpversion 1 | 2 | 3 | 4<dd>Sets the NTP version number which ntpq claims in packets.
+ <br><dt><code><a name="ntpversion"></a> ntpversion 1 | 2 | 3 | 4</code><dd>Sets the NTP version number which <code>ntpq</code> claims in packets.
Defaults to 2.
Note that mode-6 control messages (and modes, for that matter)
didn't exist in NTP version 1.
- <br><dt><a name="passwd"></a> passwd<dd>This command prompts for a password to authenticate requests.
-The password must correspond to the key ID configured in ntp.conf for this purpose.
+ <br><dt><code><a name="passwd"></a> passwd</code><dd>This command prompts for a password to authenticate requests.
+The password must correspond to the key ID configured in <code>ntp.conf</code> for this purpose.
- <br><dt><a name="quit"></a> quit<dd>Exit ntpq.
+ <br><dt><code><a name="quit"></a> quit</code><dd>Exit <code>ntpq</code>.
- <br><dt><a name="raw"></a> raw<dd>Display server messages as received and without reformatting.
+ <br><dt><code><a name="raw"></a> raw</code><dd>Display server messages as received and without reformatting.
- <br><dt><a name="timeout"></a> timeout </code><kbd>millseconds</kbd><code><dd>Specify a timeout period for responses to server queries.
+ <br><dt><code><a name="timeout"></a> timeout </code><kbd>millseconds</kbd><dd>Specify a timeout period for responses to server queries.
The default is about 5000 milliseconds.
Note that since <code>ntpq</code> retries each query once after a timeout
the total waiting time for a timeout will be twice the timeout value set.
- </dl>
- <p></code><div class="node">
+ </dl>
+
+<div class="node">
<p><hr>
<a name="Control-Message-Commands"></a>Next: <a rel="next" accesskey="n" href="#Status-Words-and-Kiss-Codes">Status Words and Kiss Codes</a>,
Previous: <a rel="previous" accesskey="p" href="#Internal-Commands">Internal Commands</a>,
<br>
</div>
- <!-- node-name, next, previous, up -->
+<!-- node-name, next, previous, up -->
<h3 class="section">Control Message Commands</h3>
-
<p>Association IDs are used to identify system, peer and clock variables.
+<p>Association IDs are used to identify system, peer and clock variables.
System variables are assigned an association ID of zero and system name space,
while each association is assigned a nonzero association ID and peer namespace.
Most control commands send a single mode-6 message to the server
and the <code>mreadlist</code> and <code>mreadvar</code> commands,
which iterate over a range of associations.
+ <p><a name="as"></a>
+ <dl>
<dt><code>associations</code><dd>Display a list of mobilized associations in the form:
<br>
<code>ind assid status conf reach auth condition last_event cnt</code>
-</dl>
- <p><br></td></tr><tr align="left"><th valign="top" width="23%">Variable </th><th valign="top" width="23%">Description
- <p><br></th></tr><tr align="left"><td valign="top" width="23%"><code>ind</code>
-</td><td valign="top" width="23%">index on this list
+ <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="40%">Description
- <p><br></td></tr><tr align="left"><td valign="top" width="23%"><code>assid</code>
-</td><td valign="top" width="23%">association ID
+ <p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>ind</code>
+</td><td valign="top" width="40%">index on this list
- <p><br></td></tr><tr align="left"><td valign="top" width="23%"><code>status</code>
-</td><td valign="top" width="23%"><a href="decode.html#peer">peer status word</a>
+ <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>assid</code>
+</td><td valign="top" width="40%">association ID
- <p><br></td></tr><tr align="left"><td valign="top" width="23%"><code>conf</code>
-</td><td valign="top" width="23%"><code>yes</code>: persistent, <code>no</code>: ephemeral
+ <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>status</code>
+</td><td valign="top" width="40%"><a href="decode.html#peer">peer status word</a>
- <p><br></td></tr><tr align="left"><td valign="top" width="23%"><code>reach</code>
-</td><td valign="top" width="23%"><code>yes</code>: reachable, <code>no</code>: unreachable
+ <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>conf</code>
+</td><td valign="top" width="40%"><code>yes</code>: persistent, <code>no</code>: ephemeral
-<p><br></td></tr><tr align="left"><td valign="top" width="23%"><code>auth</code>
-</td><td valign="top" width="23%"><code>ok</code>, <code>yes</code>, <code>bad</code> and <code>none</code>
- <p><br></td></tr><tr align="left"><td valign="top" width="23%"><code>auth</code>
-</td><td valign="top" width="23%"><code>ok</code>, <code>yes</code>, <code>bad</code> and <code>none</code>
+ <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>reach</code>
+</td><td valign="top" width="40%"><code>yes</code>: reachable, <code>no</code>: unreachable
- <p><br></td></tr><tr align="left"><td valign="top" width="23%"><code>condition</code>
-</td><td valign="top" width="23%">selection status (see the <code>select</code> field of the <a href="decode.html#peer">peer status word</a>)
+ <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>auth</code>
+</td><td valign="top" width="40%"><code>ok</code>, <code>yes</code>, <code>bad</code> and <code>none</code>
- <p><br></td></tr><tr align="left"><td valign="top" width="23%"><code>last_event</code>
-</td><td valign="top" width="
23%">event report (see the <code>event</code> field of the <a href="decode.html#peer">peer status word</a>)
+ <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>condition</code>
+</td><td valign="top" width="
40%">selection status (see the <code>select</code> field of the <a href="decode.html#peer">peer status word</a>)
- <p><br></td></tr><tr align="left"><td valign="top" width="23%"><code>cnt</code>
+ <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>last_event</code>
+</td><td valign="top" width="40%">event report (see the <code>event</code> field of the <a href="decode.html#peer">peer status word</a>)
+
+ <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>cnt</code>
event count (see the <code>count</code> field of the <a href="decode.html#peer">peer status word</a>)
- <br></td></tr></table>
+ <br></td></tr></table>
- <p><a name="cv"></a> clockvar <kbd>assocID</kbd> [<kbd>name</kbd> [ = <kbd>value</kbd> [...]] [...]]
- cv <kbd>assocID</kbd> [<kbd>name</kbd> [ = <kbd>value</kbd> [...] ][...]]
-Display a list of See <a href="#clock">clock variables</a> for those associations supporting a reference clock.
+ <br><dt><code><a name="cv"></a> clockvar </code><kbd>assocID</kbd><code> [</code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code> [...]] [...]]</code><dt><code>cv </code><kbd>assocID</kbd><code> [</code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code> [...] ][...]]</code><dd>Display a list of <a href="#clock">clock variables</a> for those associations supporting a reference clock.
- <p><a name="_003aconfig"></a> :config [...]
-Send the remainder of the command line, including whitespace, to the server
+ <br><dt><code><a name="_003aconfig"></a> :config [...]</code><dd>Send the remainder of the command line, including whitespace, to the server
as a run-time configuration command in the same format
as the configuration file.
This command is experimental until further notice and clarification.
Authentication is of course required.
- <p><a name="config_002dfrom_002dfile"></a> config-from-file <kbd>filename</kbd>
-Send the each line of <kbd>filename</kbd> to the server as
+ <br><dt><code><a name="config_002dfrom_002dfile"></a> config-from-file </code><kbd>filename</kbd><dd>Send the each line of <kbd>filename</kbd> to the server as
run-time configuration commands in the same format as the configuration file.
This command is experimental until further notice and clarification.
Authentication is required.
- <p><a name="ifstats"></a> ifstats
-Display statistics for each local network address.
+ <br><dt><code><a name="ifstats"></a> ifstats</code><dd>Display statistics for each local network address.
Authentication is required.
- <p><a name="iostats"></a> iostats
-Display network and reference clock I/O statistics.
+ <br><dt><code><a name="iostats"></a> iostats</code><dd>Display network and reference clock I/O statistics.
- <p><a name="kerninfo"></a> kerninfo
-Display kernel loop and PPS statistics.
+ <br><dt><code><a name="kerninfo"></a> kerninfo</code><dd>Display kernel loop and PPS statistics.
As with other ntpq output, times are in milliseconds.
The precision value displayed is in milliseconds as well,
unlike the precision system variable.
- <p><a name="lassoc"></a> lassociations
-Perform the same function as the associations command,
+ <br><dt><code><a name="lassoc"></a> lassociations</code><dd>Perform the same function as the associations command,
except display mobilized and unmobilized associations.
- <p><a name="monstats"></a> monstats
-Display monitor facility statistics.
+ <br><dt><code><a name="monstats"></a> monstats</code><dd>Display monitor facility statistics.
- <p><a name="mrulist"></a> mrulist [limited | kod | mincount=<kbd>count</kbd> | laddr=<kbd>localaddr</kbd> | sort=<kbd>sortorder</kbd> | resany=<kbd>hexmask</kbd> | resall=<kbd>hexmask</kbd>]
-Obtain and print traffic counts collected and maintained by
+ <br><dt><code><a name="mrulist"></a> mrulist [limited | kod | mincount=</code><kbd>count</kbd><code> | laddr=</code><kbd>localaddr</kbd><code> | sort=</code><kbd>sortorder</kbd><code> | resany=</code><kbd>hexmask</kbd><code> | resall=</code><kbd>hexmask</kbd><code>]</code><dd>Obtain and print traffic counts collected and maintained by
the monitor facility.
With the exception of <code>sort=</code><kbd>sortorder</kbd>,
the options filter the list returned by <code>ntpd</code>.
any of those preceded by a minus sign (hyphen) to reverse the sort order.
The output columns are:
-
<p><table summary=""><tr align="left"><th valign="top" width="10%">Column </th><th valign="top" width="40%">Description
+ <p><table summary=""><tr align="left"><th valign="top" width="10%">Column </th><th valign="top" width="40%">Description
<p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>lstint</code>
</td><td valign="top" width="40%">
DNS name, numeric address, or address followed by claimed DNS name which
could not be verified in parentheses.
- <br></td></tr></table>
+ <br></td></tr></table>
- <p><a name="mreadvar"></a> <code>mreadvar </code><kbd>assocID</kbd> <kbd>assocID</kbd><code> [ </code><kbd>variable_name</kbd><code> [ = </code><kbd>value</kbd><code>[ ... ]</code>
- <a name="mrv"></a> <code>mrv </code><kbd>assocID</kbd> <kbd>assocID</kbd><code> [ </code><kbd>variable_name</kbd><code> [ = </code><kbd>value</kbd><code>[ ... ]</code>
-Perform the same function as the <code>readvar</code> command,
+ <br><dt><code><a name="mreadvar"></a> mreadvar </code><kbd>assocID</kbd> <kbd>assocID</kbd><code> [ </code><kbd>variable_name</kbd><code> [ = </code><kbd>value</kbd><code>[ ... ]</code><dt><code><a name="mrv"></a> mrv </code><kbd>assocID</kbd> <kbd>assocID</kbd><code> [ </code><kbd>variable_name</kbd><code> [ = </code><kbd>value</kbd><code>[ ... ]</code><dd>Perform the same function as the <code>readvar</code> command,
except for a range of association IDs.
This range is determined from the association list cached by
the most recent <code>associations</code> command.
- <p><a name="passoc"></a> <code>passociations</code>
-Perform the same function as the <code>associations command</code>, except that
+ <br><dt><code><a name="passoc"></a> passociations</code><dd>Perform the same function as the <code>associations command</code>, except that
it uses previously stored data rather than making a new query.
- <p><a name="pe"></a> <code>peers</code>
-Display a list of peers in the form:
+ <br><dt><code><a name="pe"></a> peers</code><dd>Display a list of peers in the form:
<br>
<code>[tally]remote refid st t when pool reach delay offset jitter</code>
-
<p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description
+ <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description
<br></th></tr><tr align="left"><td valign="top" width="10%"><code>[tally]</code>
</td><td valign="top" width="20%">
single-character code indicating current value of the <code>select</code> field
</td><td valign="top" width="20%">
jitter
- <br></td></tr></table>
+ <br></td></tr></table>
- <p><a name="rv"></a> readvar <kbd>assocID</kbd> <kbd>name</kbd> [ = <kbd>value</kbd> ] [,...]
- rv <kbd>assocID</kbd> [ <kbd>name</kbd> ] [,...]
-Display the specified variables.
+ <br><dt><code><a name="rv"></a> readvar </code><kbd>assocID</kbd> <kbd>name</kbd><code> [ = </code><kbd>value</kbd><code> ] [,...]</code><dt><code>rv </code><kbd>assocID</kbd><code> [ </code><kbd>name</kbd><code> ] [,...]</code><dd>Display the specified variables.
If <kbd>assocID</kbd> is zero,
the variables are from the <a href="#system">system variables</a> name space,
otherwise they are from the <a href="#peer">peer variables</a> name space.
where YYYY is the year, MM the month of year, DD the day of month and
TTTT the time of day.
- <p><a name="saveconfig"></a> <code>saveconfig </code><kbd>filename</kbd>
-Write the current configuration, including any runtime modifications
+ <br><dt><code><a name="saveconfig"></a> saveconfig </code><kbd>filename</kbd><dd>Write the current configuration, including any runtime modifications
given with <code>:config</code> or <code>config-from-file</code>,
to the ntpd host's file <kbd>filename</kbd>.
This command will be rejected by the server unless
The filename used is stored in system variable <code>savedconfig</code>.
Authentication is required.
- <p><a name="writevar"></a> writevar <kbd>assocID</kbd> <kbd>name</kbd> = <kbd>value</kbd> [,...]
-Write the specified variables.
+ <br><dt><code><a name="writevar"></a> writevar </code><kbd>assocID</kbd> <kbd>name</kbd><code> = </code><kbd>value</kbd><code> [,...]</code><dd>Write the specified variables.
If the <kbd>assocID</kbd> is zero, the variables are from the
<a href="#system">system variables</a> name space, otherwise they are from the
<a href="#peer">peer variables</a> name space.
The <kbd>assocID</kbd> is required,
as the same name can occur in both spaces.
- <p><a name="sysinfo_0022_003e_0040code_007bsysinfo_007d-Display-operational-summary_002e-_0040item-_0040anchor_007bsysstats_007d-_0040code_007bsysstats_007d-Print-statistics-counters-maintained-in-the-protocol-module_002e-_0040end-table-_0040node-Status-Words-and-Kiss-Codes"></a> System Variables, Control Message Commands, Top
-<!-- node-name, next, previous, up -->
+ <br><dt><code><a name="sysinfo"></a> sysinfo</code><dd>Display operational summary.
+
+ <br><dt><code><a name="sysstats"></a> sysstats</code><dd>Print statistics counters maintained in the protocol module.
+
+ </dl>
+
+<div class="node">
+<p><hr>
+<a name="Status-Words-and-Kiss-Codes"></a>Next: <a rel="next" accesskey="n" href="#System-Variables">System Variables</a>,
+Previous: <a rel="previous" accesskey="p" href="#Control-Message-Commands">Control Message Commands</a>,
+Up: <a rel="up" accesskey="u" href="#Top">Top</a>
+<br>
+</div>
+<!-- node-name, next, previous, up -->
<h3 class="section">Status Words and Kiss Codes</h3>
-
<p>The current state of the operating program is shown
+<p>The current state of the operating program is shown
in a set of status words maintained by the system
and each association separately.
These words are displayed in the <code>rv</code> and <code>as</code> commands
The page also includes a list of system and peer messages,
the code for the latest of which is included in the status word.
-
<p>Information resulting from protocol machine state transitions
+ <p>Information resulting from protocol machine state transitions
is displayed using an informal set of ASCII strings called
<a href="decode.html#kiss">kiss codes</a>.
The original purpose was for kiss-o'-death (KoD) packets sent
<br>
</div>
- <!-- node-name, next, previous, up -->
+<!-- node-name, next, previous, up -->
<h3 class="section">System Variables</h3>
-
<p>The following system variables appear in the <code>rv</code> billboard.
+<p>The following system variables appear in the <code>rv</code> billboard.
Not all variables are displayed in some configurations.
-
<p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description
+ <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description
-
<p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>status</code>
+<p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>status</code>
</td><td valign="top" width="20%">
<a href="decode.html#sys">system status word</a>
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>version</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>version</code>
</td><td valign="top" width="20%">
NTP software version and build time
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>processor</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>processor</code>
</td><td valign="top" width="20%">
hardware platform and version
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>system</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>system</code>
</td><td valign="top" width="20%">
operating system and version
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>leap</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>leap</code>
</td><td valign="top" width="20%">
leap warning indicator (0-3)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>stratum</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>stratum</code>
</td><td valign="top" width="20%">
stratum (1-15)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>precision</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>precision</code>
</td><td valign="top" width="20%">
precision (log(2) s)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rootdelay</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rootdelay</code>
</td><td valign="top" width="20%">
total roundtrip delay to the primary reference clock
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rootdisp</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rootdisp</code>
</td><td valign="top" width="20%">
total dispersion to the primary reference clock
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>peer</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>peer</code>
</td><td valign="top" width="20%">
system peer association ID
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>tc</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>tc</code>
time constant and poll exponent (log(2) s) (3-17)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>mintc</code>
+ <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>mintc</code>
minimum time constant (log(2) s) (3-10)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>clock</code>
+ <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>clock</code>
</td><td valign="top" width="20%">
date and time of day
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>refid</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>refid</code>
reference ID or <a href="decode.html#kiss">kiss code</a>
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>reftime</code>
+ <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>reftime</code>
</td><td valign="top" width="20%">
reference time
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>offset</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>offset</code>
</td><td valign="top" width="20%">
combined offset of server relative to this host
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>sys_jitter</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>sys_jitter</code>
</td><td valign="top" width="20%">
combined system jitter
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>frequency</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>frequency</code>
</td><td valign="top" width="20%">
frequency offset (PPM) relative to hardware clock
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>clk_wander</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>clk_wander</code>
</td><td valign="top" width="20%">
clock frequency wander (PPM)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>clk_jitter</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>clk_jitter</code>
</td><td valign="top" width="20%">
clock jitter
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>tai</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>tai</code>
</td><td valign="top" width="20%">
TAI-UTC offset (s)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>leapsec</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>leapsec</code>
</td><td valign="top" width="20%">
NTP seconds when the next leap second is/was inserted
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>expire</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>expire</code>
</td><td valign="top" width="20%">
NTP seconds when the NIST leapseconds file expires
- <br></td></tr></table>
+ <br></td></tr></table>
-
<p>The jitter and wander statistics are exponentially-weighted RMS averages.
+ <p>The jitter and wander statistics are exponentially-weighted RMS averages.
The system jitter is defined in the NTPv4 specification;
the clock jitter statistic is computed by the clock discipline module.
-
<p>When the NTPv4 daemon is compiled with the OpenSSL software library,
+ <p>When the NTPv4 daemon is compiled with the OpenSSL software library,
additional system variables are displayed, including some or all of the
following, depending on the particular Autokey dance:
-
<p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description
+ <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description
-
<p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>host</code>
+<p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>host</code>
</td><td valign="top" width="20%">
Autokey host name for this host
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>ident</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>ident</code>
</td><td valign="top" width="20%">
Autokey group name for this host
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>flags</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>flags</code>
</td><td valign="top" width="20%">
host flags (see Autokey specification)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>digest</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>digest</code>
</td><td valign="top" width="20%">
OpenSSL message digest algorithm
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>signature</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>signature</code>
</td><td valign="top" width="20%">
OpenSSL digest/signature scheme
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>update</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>update</code>
</td><td valign="top" width="20%">
NTP seconds at last signature update
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>cert</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>cert</code>
</td><td valign="top" width="20%">
certificate subject, issuer and certificate flags
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>until</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>until</code>
</td><td valign="top" width="20%">
NTP seconds when the certificate expires
- <br></td></tr></table>
+ <br></td></tr></table>
<div class="node">
<p><hr>
<br>
</div>
- <!-- node-name, next, previous, up -->
+<!-- node-name, next, previous, up -->
<h3 class="section">Peer Variables</h3>
-
<p>The following peer variables appear in the <code>rv</code> billboard
+<p>The following peer variables appear in the <code>rv</code> billboard
for each association.
Not all variables are displayed in some configurations.
-
<p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description
+ <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description
-
<p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>associd</code>
+<p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>associd</code>
</td><td valign="top" width="20%">
association ID
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>status</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>status</code>
</td><td valign="top" width="20%">
<a href="decode.html#peer">peer status word</a>
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>srcadr</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>srcadr</code>
<br></td></tr><tr align="left"><td valign="top" width="10%"><code>srcport</code>
</td><td valign="top" width="20%">
source (remote) IP address and port
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>dstadr</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>dstadr</code>
<br></td></tr><tr align="left"><td valign="top" width="10%"><code>dstport</code>
</td><td valign="top" width="20%">
destination (local) IP address and port
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>leap</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>leap</code>
</td><td valign="top" width="20%">
leap indicator (0-3)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>stratum</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>stratum</code>
</td><td valign="top" width="20%">
stratum (0-15)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>precision</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>precision</code>
</td><td valign="top" width="20%">
precision (log(2) s)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rootdelay</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rootdelay</code>
</td><td valign="top" width="20%">
total roundtrip delay to the primary reference clock
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rootdisp</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rootdisp</code>
</td><td valign="top" width="20%">total root dispersion to the primary reference clock
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>refid</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>refid</code>
</td><td valign="top" width="20%">
reference ID or <a href="decode.html#kiss">kiss code</a>
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>reftime</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>reftime</code>
</td><td valign="top" width="20%">
reference time
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>reach</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>reach</code>
</td><td valign="top" width="20%">
reach register (octal)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>unreach</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>unreach</code>
</td><td valign="top" width="20%">
unreach counter
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>hmode</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>hmode</code>
</td><td valign="top" width="20%">
host mode (1-6)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>pmode</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>pmode</code>
</td><td valign="top" width="20%">
peer mode (1-5)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>hpoll</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>hpoll</code>
</td><td valign="top" width="20%">
host poll exponent (log(2) s) (3-17)
<br></td></tr><tr align="left"><td valign="top" width="10%"><code>ppoll</code>
</td><td valign="top" width="20%">
peer poll exponent (log(2) s) (3-17)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>headway</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>headway</code>
</td><td valign="top" width="20%">
headway (see <a href="rate.html">Rate Management and the Kiss-o'-Death Packet</a>)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>flash</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>flash</code>
</td><td valign="top" width="20%">
<a href="decode.html#flash">flash status word</a>
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>offset</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>offset</code>
</td><td valign="top" width="20%">
filter offset
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>delay</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>delay</code>
</td><td valign="top" width="20%">
filter delay
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>dispersion</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>dispersion</code>
</td><td valign="top" width="20%">
filter dispersion
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>jitter</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>jitter</code>
</td><td valign="top" width="20%">
filter jitter
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>ident</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>ident</code>
</td><td valign="top" width="20%">
Autokey group name for this association
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>bias</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>bias</code>
</td><td valign="top" width="20%">
unicast/broadcast bias
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>xleave</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>xleave</code>
</td><td valign="top" width="20%">
interleave delay (see <a href="xleave.html">NTP Interleaved Modes</a>)
- <br></td></tr></table>
+ <br></td></tr></table>
-
<p>The bias variable is calculated when the first broadcast packet is received
+ <p>The bias variable is calculated when the first broadcast packet is received
after the calibration volley. It represents the offset of the broadcast
subgraph relative to the unicast subgraph. The xleave variable appears
only the interleaved symmetric and interleaved modes. It represents
the internal queuing, buffering and transmission delays for the preceding
packet.
-
<p>When the NTPv4 daemon is compiled with the OpenSSL software library,
+ <p>When the NTPv4 daemon is compiled with the OpenSSL software library,
additional peer variables are displayed, including the following:
-
<p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description
+ <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description
-
<p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>flags</code>
+<p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>flags</code>
</td><td valign="top" width="20%">
peer flags (see Autokey specification)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>host</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>host</code>
</td><td valign="top" width="20%">
Autokey server name
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>flags</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>flags</code>
</td><td valign="top" width="20%">
peer flags (see Autokey specification)
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>signature</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>signature</code>
</td><td valign="top" width="20%">
OpenSSL digest/signature scheme
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>initsequence</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>initsequence</code>
</td><td valign="top" width="20%">
initial key ID
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>initkey</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>initkey</code>
</td><td valign="top" width="20%">
initial key index
-
<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>timestamp</code>
+<p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>timestamp</code>
</td><td valign="top" width="20%">
Autokey signature timestamp
- <br></td></tr></table>
+ <br></td></tr></table>
<div class="node">
<p><hr>
<br>
</div>
- <!-- node-name, next, previous, up -->
+<!-- node-name, next, previous, up -->
<h3 class="section">Clock Variables</h3>
-
<p>The following clock variables appear in the <code>cv</code> billboard for each association with a reference clock. Not all variables are displayed in some configurations.
+<p>The following clock variables appear in the <code>cv</code> billboard for each association with a reference clock. Not all variables are displayed in some configurations.
-
<p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description
+ <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description
<br></th></tr><tr align="left"><td valign="top" width="10%"><code>associd</code>
</td><td valign="top" width="20%">association ID
<br></td></tr><tr align="left"><td valign="top" width="10%"><code>status</code>
</td><td valign="top" width="20%">driver reference ID
<br></td></tr><tr align="left"><td valign="top" width="10%"><code>flags</code>
</td><td valign="top" width="20%">driver flags
- <br></td></tr></table>
+ <br></td></tr></table>
+ <p>===
-
<p><h4>Synopsis</h4>
+ <p><h4>Synopsis</h4>
<code>ntpq [-inp] [-c </code><kbd>command</kbd><code>] [</code><kbd>host</kbd><code>] [...]</code>
-
<p><p>Command line options are described following. Specifying a command line option other than <code>-i</code> or <code>-n</code> will cause the specified query (queries) to be sent to the indicated host(s) immediately. Otherwise, <code>ntpq</code> will attempt to read interactive format commands from the standard input.</p>
+ <p><p>Command line options are described following. Specifying a command line option other than <code>-i</code> or <code>-n</code> will cause the specified query (queries) to be sent to the indicated host(s) immediately. Otherwise, <code>ntpq</code> will attempt to read interactive format commands from the standard input.</p>
<dl>
<dt><code>-4</code></dt>
<dd>Force DNS resolution of following host names on the command line to the IPv4 namespace.</dd>
-.TH ntpq @NTPQ_MS@ "25 Dec 2012" "4.2.7p338" "User Commands"
+.TH ntpq @NTPQ_MS@ "26 Dec 2012" "4.2.7p339" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpq-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:35:07 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:16 AM by AutoGen 5.16.2
.\" From the definitions ntpq-opts.def
.\" and the template file agman-cmd.tpl
.\"
.\" Mixture of short (flag) options and long options
.RB [ \-\fIflag\fP " [\fIvalue\fP]]... [" \-\-\fIopt\-name\fP " [[=| ]\fIvalue\fP]]..." [ host ...]
.SH DESCRIPTION
-The
-.B
-utility program is used to query NTP servers which
-implement the standard NTP mode 6 control message formats defined
-in Appendix B of the NTPv3 specification RFC1305, requesting
-information about current state and/or changes in that state.
-The same formats are used in NTPv4, although some of the
-variables have changed and new ones added. The description on this
-page is for the NTPv4 variables.
-The program may be run either in interactive mode or controlled using
-command line arguments.
-Requests to read and write arbitrary
-variables can be assembled, with raw and pretty-printed output
-options being available.
-The
-.B
-utility can also obtain and print a
-list of peers in a common format by sending multiple queries to the
-server.
-If one or more request options is included on the command line
-when
-.B
-is executed, each of the requests will be sent
-to the NTP servers running on each of the hosts given as command
-line arguments, or on localhost by default.
-If no request options
-are given,
-.B
-will attempt to read commands from the
-standard input and execute these on the NTP server running on the
-first host given on the command line, again defaulting to localhost
-when no other host is specified.
-The
-.B
-utility will prompt for
-commands if the standard input is a terminal device.
-.B
-uses NTP mode 6 packets to communicate with the
-NTP server, and hence can be used to query any compatible server on
-the network which permits it.
-Note that since NTP is a UDP protocol
-this communication will be somewhat unreliable, especially over
-large distances in terms of network topology.
-The
-.B
-utility makes
-one attempt to retransmit requests, and will time requests out if
-the remote host is not heard from within a suitable timeout
-time.
-Specifying a
-command line option other than
-i
-or
-n
-will
-cause the specified query (queries) to be sent to the indicated
-host(s) immediately.
-Otherwise,
-.B
-will attempt to read
-interactive format commands from the standard input.
-.SS "Internal Commands"
-Interactive format commands consist of a keyword followed by zero
-to four arguments.
-Only enough characters of the full keyword to
-uniquely identify the command need be typed.
-A
-number of interactive format commands are executed entirely within
-the
-.B
-utility itself and do not result in NTP mode 6
-requests being sent to a server.
-These are described following.
-.TP
-.BR Ic ? Op Ar command_keyword
-.TP
-.BR Ic help Op Ar command_keyword
-A
-.Ql \&?
-by itself will print a list of all the command
-keywords known to this incarnation of
-.Nm .
-A
-.Ql \&?
-followed by a command keyword will print function and usage
-information about the command.
-This command is probably a better
-source of information about
-.Nm
-than this manual
-page.
-.TP
-.BR Ic addvars Ar variable_name Xo Op Ic =value
-.Ic ...
-.Xc
-.TP
-.BR Ic rmvars Ar variable_name Ic ...
-.TP
-.BR Ic clearvars
-The data carried by NTP mode 6 messages consists of a list of
-items of the form
-.Ql variable_name=value ,
-where the
-.Ql =value
-is ignored, and can be omitted,
-in requests to the server to read variables.
-The
-.Nm
-utility maintains an internal list in which data to be included in control
-messages can be assembled, and sent using the
-.Ic readlist
-and
-.Ic writelist
-commands described below.
-The
-.Ic addvars
-command allows variables and their optional values to be added to
-the list.
-If more than one variable is to be added, the list should
-be comma-separated and not contain white space.
-The
-.Ic rmvars
-command can be used to remove individual variables from the list,
-while the
-.Ic clearlist
-command removes all variables from the
-list.
-.TP
-.BR Ic authenticate Op yes | no
-Normally
-.Nm
-does not authenticate requests unless
-they are write requests.
-The command
-.Ql authenticate yes
-causes
-.Nm
-to send authentication with all requests it
-makes.
-Authenticated requests causes some servers to handle
-requests slightly differently, and can occasionally melt the CPU in
-fuzzballs if you turn authentication on before doing a
-.Ic peer
-display.
-The command
-.Ql authenticate
-causes
-.Nm
-to display whether or not
-.Nm
-is currently autheinticating requests.
-.TP
-.BR Ic cooked
-Causes output from query commands to be "cooked", so that
-variables which are recognized by
-.Nm
-will have their
-values reformatted for human consumption.
-Variables which
-.Nm
-thinks should have a decodable value but didn't are
-marked with a trailing
-.Ql \&? .
-.TP
-.BR Xo
-.Ic debug
-.Oo
-.Cm more |
-.Cm less |
-.Cm off
-.Oc
-.Xc
-With no argument, displays the current debug level.
-Otherwise, the debug level is changed to the indicated level.
-.TP
-.BR Ic delay Ar milliseconds
-Specify a time interval to be added to timestamps included in
-requests which require authentication.
-This is used to enable
-(unreliable) server reconfiguration over long delay network paths
-or between machines whose clocks are unsynchronized.
-Actually the
-server does not now require timestamps in authenticated requests,
-so this command may be obsolete.
-.TP
-.BR Ic host Ar hostname
-Set the host to which future queries will be sent.
-\fIhostname\fR
-may be either a host name or a numeric address.
-.TP
-.BR Ic hostnames Op Cm yes | Cm no
-If
-.Cm yes
-is specified, host names are printed in
-information displays.
-If
-.Cm no
-is specified, numeric
-addresses are printed instead.
-The default is
-.Cm yes ,
-unless
-modified using the command line
-n
-switch.
-.TP
-.BR Ic keyid Ar keyid
-This command allows the specification of a key number to be
-used to authenticate configuration requests.
-This must correspond
-to a key number the server has been configured to use for this
-purpose.
-.TP
-.BR Ic ntpversion Xo Oo
-.Cm 1 |
-.Cm 2 |
-.Cm 3 |
-.Cm 4
-.Oc
-.Xc
-Sets the NTP version number which
-.Nm
-claims in
-packets.
-Defaults to 3, and note that mode 6 control messages (and
-modes, for that matter) didn't exist in NTP version 1.
-There appear
-to be no servers left which demand version 1.
-With no argument, displays the current NTP version that will be used
-when communicating with servers.
-.TP
-.BR Ic quit
-Exit
-.Nm
-.TP
-.BR Ic passwd
-This command prompts you to type in a password (which will not
-be echoed) which will be used to authenticate configuration
-requests.
-The password must correspond to the key configured for
-use by the NTP server for this purpose if such requests are to be
-successful.
-.TP
-.BR Ic raw
-Causes all output from query commands is printed as received
-from the remote server.
-The only formating/interpretation done on
-the data is to transform nonascii data into a printable (but barely
-understandable) form.
-.TP
-.BR Ic timeout Ar milliseconds
-Specify a timeout period for responses to server queries.
-The
-default is about 5000 milliseconds.
-Note that since
-.Nm
-retries each query once after a timeout, the total waiting time for
-a timeout will be twice the timeout value set.
.SH "OPTIONS"
.TP
.BR \-4 ", " -\-ipv4
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTPQ @NTPQ_MS@ User Commands
-.Os FreeBSD 6.4-STABLE
+.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpq-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:35:13 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:21 AM by AutoGen 5.16.2
.\" From the definitions ntpq-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
[ host ...]
.Pp
.Sh DESCRIPTION
-The
-.Nm
-utility program is used to query NTP servers which
-implement the standard NTP mode 6 control message formats defined
-in Appendix B of the NTPv3 specification RFC1305, requesting
-information about current state and/or changes in that state.
-The same formats are used in NTPv4, although some of the
-variables have changed and new ones added. The description on this
-page is for the NTPv4 variables.
-The program may be run either in interactive mode or controlled using
-command line arguments.
-Requests to read and write arbitrary
-variables can be assembled, with raw and pretty-printed output
-options being available.
-The
-.Nm
-utility can also obtain and print a
-list of peers in a common format by sending multiple queries to the
-server.
-If one or more request options is included on the command line
-when
-.Nm
-is executed, each of the requests will be sent
-to the NTP servers running on each of the hosts given as command
-line arguments, or on localhost by default.
-If no request options
-are given,
-.Nm
-will attempt to read commands from the
-standard input and execute these on the NTP server running on the
-first host given on the command line, again defaulting to localhost
-when no other host is specified.
-The
-.Nm
-utility will prompt for
-commands if the standard input is a terminal device.
-.Nm
-uses NTP mode 6 packets to communicate with the
-NTP server, and hence can be used to query any compatible server on
-the network which permits it.
-Note that since NTP is a UDP protocol
-this communication will be somewhat unreliable, especially over
-large distances in terms of network topology.
-The
-.Nm
-utility makes
-one attempt to retransmit requests, and will time requests out if
-the remote host is not heard from within a suitable timeout
-time.
-Specifying a
-command line option other than
-.Fl i
-or
-.Fl n
-will
-cause the specified query (queries) to be sent to the indicated
-host(s) immediately.
-Otherwise,
-.Nm
-will attempt to read
-interactive format commands from the standard input.
-.Ss "Internal Commands"
-Interactive format commands consist of a keyword followed by zero
-to four arguments.
-Only enough characters of the full keyword to
-uniquely identify the command need be typed.
-A
-number of interactive format commands are executed entirely within
-the
-.Nm
-utility itself and do not result in NTP mode 6
-requests being sent to a server.
-These are described following.
-.Bl -tag -width "? [command_keyword]" -compact -offset indent
-.It Ic ? Op Ar command_keyword
-.It Ic help Op Ar command_keyword
-A
-.Ql \&?
-by itself will print a list of all the command
-keywords known to this incarnation of
-.Nm .
-A
-.Ql \&?
-followed by a command keyword will print function and usage
-information about the command.
-This command is probably a better
-source of information about
-.Nm
-than this manual
-page.
-.It Ic addvars Ar variable_name Xo Op Ic =value
-.Ic ...
-.Xc
-.It Ic rmvars Ar variable_name Ic ...
-.It Ic clearvars
-The data carried by NTP mode 6 messages consists of a list of
-items of the form
-.Ql variable_name=value ,
-where the
-.Ql =value
-is ignored, and can be omitted,
-in requests to the server to read variables.
-The
-.Nm
-utility maintains an internal list in which data to be included in control
-messages can be assembled, and sent using the
-.Ic readlist
-and
-.Ic writelist
-commands described below.
-The
-.Ic addvars
-command allows variables and their optional values to be added to
-the list.
-If more than one variable is to be added, the list should
-be comma-separated and not contain white space.
-The
-.Ic rmvars
-command can be used to remove individual variables from the list,
-while the
-.Ic clearlist
-command removes all variables from the
-list.
-.It Ic authenticate Op yes | no
-Normally
-.Nm
-does not authenticate requests unless
-they are write requests.
-The command
-.Ql authenticate yes
-causes
-.Nm
-to send authentication with all requests it
-makes.
-Authenticated requests causes some servers to handle
-requests slightly differently, and can occasionally melt the CPU in
-fuzzballs if you turn authentication on before doing a
-.Ic peer
-display.
-The command
-.Ql authenticate
-causes
-.Nm
-to display whether or not
-.Nm
-is currently autheinticating requests.
-.It Ic cooked
-Causes output from query commands to be "cooked", so that
-variables which are recognized by
-.Nm
-will have their
-values reformatted for human consumption.
-Variables which
-.Nm
-thinks should have a decodable value but didn't are
-marked with a trailing
-.Ql \&? .
-.It Xo
-.Ic debug
-.Oo
-.Cm more |
-.Cm less |
-.Cm off
-.Oc
-.Xc
-With no argument, displays the current debug level.
-Otherwise, the debug level is changed to the indicated level.
-.It Ic delay Ar milliseconds
-Specify a time interval to be added to timestamps included in
-requests which require authentication.
-This is used to enable
-(unreliable) server reconfiguration over long delay network paths
-or between machines whose clocks are unsynchronized.
-Actually the
-server does not now require timestamps in authenticated requests,
-so this command may be obsolete.
-.It Ic host Ar hostname
-Set the host to which future queries will be sent.
-.Ar hostname
-may be either a host name or a numeric address.
-.It Ic hostnames Op Cm yes | Cm no
-If
-.Cm yes
-is specified, host names are printed in
-information displays.
-If
-.Cm no
-is specified, numeric
-addresses are printed instead.
-The default is
-.Cm yes ,
-unless
-modified using the command line
-.Fl n
-switch.
-.It Ic keyid Ar keyid
-This command allows the specification of a key number to be
-used to authenticate configuration requests.
-This must correspond
-to a key number the server has been configured to use for this
-purpose.
-.It Ic ntpversion Xo Oo
-.Cm 1 |
-.Cm 2 |
-.Cm 3 |
-.Cm 4
-.Oc
-.Xc
-Sets the NTP version number which
-.Nm
-claims in
-packets.
-Defaults to 3, and note that mode 6 control messages (and
-modes, for that matter) didn't exist in NTP version 1.
-There appear
-to be no servers left which demand version 1.
-With no argument, displays the current NTP version that will be used
-when communicating with servers.
-.It Ic quit
-Exit
-.Nm
-.It Ic passwd
-This command prompts you to type in a password (which will not
-be echoed) which will be used to authenticate configuration
-requests.
-The password must correspond to the key configured for
-use by the NTP server for this purpose if such requests are to be
-successful.
-.It Ic raw
-Causes all output from query commands is printed as received
-from the remote server.
-The only formating/interpretation done on
-the data is to transform nonascii data into a printable (but barely
-understandable) form.
-.It Ic timeout Ar milliseconds
-Specify a timeout period for responses to server queries.
-The
-default is about 5000 milliseconds.
-Note that since
-.Nm
-retries each query once after a timeout, the total waiting time for
-a timeout will be twice the timeout value set.
-.El
.Sh "OPTIONS"
.Bl -tag
.It \-4 ", " -\-ipv4
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpsnmpd.texi)
#
-# It has been AutoGen-ed December 25, 2012 at 11:35:26 AM by AutoGen 5.16.2
+# It has been AutoGen-ed December 26, 2012 at 04:11:35 AM by AutoGen 5.16.2
# From the definitions ntpsnmpd-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p338
+ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p339
USAGE: ntpsnmpd [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
Flg Arg Option-Name Description
-n no nofork Do not fork
please fill me in...
@item Li
please fill me in...
-
-@end multitable
+@end table
This document corresponds to version @VERSION@ of NTP.
@node ntpsnmpd Authors
/*
* EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.c)
*
- * It has been AutoGen-ed December 25, 2012 at 11:35:16 AM by AutoGen 5.16.2
+ * It has been AutoGen-ed December 26, 2012 at 04:11:24 AM by AutoGen 5.16.2
* From the definitions ntpsnmpd-opts.def
* and the template file options
*
* ntpsnmpd option static const strings
*/
static char const ntpsnmpd_opt_strs[1561] =
-/* 0 */ "ntpsnmpd 4.2.7p338\n"
+/* 0 */ "ntpsnmpd 4.2.7p339\n"
"Copyright (C) 1970-2012 The University of Delaware, all rights reserved.\n"
"This is free software. It is licensed for use, modification and\n"
"redistribution under the terms of the NTP License, copies of which\n"
/* 1360 */ "no-load-opts\0"
/* 1373 */ "no\0"
/* 1376 */ "NTPSNMPD\0"
-/* 1385 */ "ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p338\n"
+/* 1385 */ "ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p339\n"
"USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n\0"
/* 1490 */ "$HOME\0"
/* 1496 */ ".\0"
/* 1498 */ ".ntprc\0"
/* 1505 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 1539 */ "\n\n\0"
-/* 1542 */ "ntpsnmpd 4.2.7p338";
+/* 1542 */ "ntpsnmpd 4.2.7p339";
/*
* nofork option description:
/*
* EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.h)
*
- * It has been AutoGen-ed December 25, 2012 at 11:35:16 AM by AutoGen 5.16.2
+ * It has been AutoGen-ed December 26, 2012 at 04:11:24 AM by AutoGen 5.16.2
* From the definitions ntpsnmpd-opts.def
* and the template file options
*
} teOptIndex;
#define OPTION_CT 8
-#define NTPSNMPD_VERSION "4.2.7p338"
-#define NTPSNMPD_FULL_VERSION "ntpsnmpd 4.2.7p338"
+#define NTPSNMPD_VERSION "4.2.7p339"
+#define NTPSNMPD_FULL_VERSION "ntpsnmpd 4.2.7p339"
/*
* Interface defines for all options. Replace "n" with the UPPER_CASED
-.TH ntpsnmpd 1ntpsnmpdman "25 Dec 2012" "4.2.7p338" "User Commands"
+.TH ntpsnmpd 1ntpsnmpdman "26 Dec 2012" "4.2.7p339" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:35:22 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:32 AM by AutoGen 5.16.2
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agman-cmd.tpl
.\"
All arguments must be options.
.PP
.SH DESCRIPTION
-.B
-is an SNMP MIB agent designed to interface with
-.Xr ntpd 1ntpdmdoc .
.SH "OPTIONS"
.TP
.BR \-n ", " -\-nofork
If any of these are directories, then the file \fI.ntprc\fP
is searched for within those directories.
.SH USAGE
-.B
-currently uses a private MIB OID,
-.Ql enterprises.5597 ,
-which is the Meinberg top level OEM OID, and
-.Ql 99
-is the temporary working space for this project.
-The final OID has to be registered with IANA
-and this is done by the RFC Editor
-when the NTPv4 MIB RFC is standardized.
-.PP
-If you have
-.Xr snmpwalk 1
-installed you can run
-.Dl % snmpwalk -v2c -c public localhost enterprises.5597.99
-to see a list of all currently supported NTP MIB objects
-and their current values.
.SH "ENVIRONMENT"
See \fBOPTION PRESETS\fP for configuration environment variables.
.SH "FILES"
libopts had an internal operational error. Please report
it to autogen-users@lists.sourceforge.net. Thank you.
.SH AUTHORS
-.An "Heiko Gerstung"
.SH "COPYRIGHT"
Copyright (C) 1970-2012 The University of Delaware all rights reserved.
This program is released under the terms of the NTP license, <http://ntp.org/license>.
.SH "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-The following objects are currently supported:
-.PP
-.TP
-.BR Li ntpEntSoftwareName
-please fill me in...
-.TP
-.BR Li ntpEntSoftwareVersion
-please fill me in...
-.TP
-.BR Li ntpEntSoftwareVersionVal
-please fill me in...
-.TP
-.BR Li ntpEntSoftwareVendor
-please fill me in...
-.TP
-.BR Li ntpEntSystemType
-please fill me in...
-.TP
-.BR Li ntpEntTimeResolution
-please fill me in...
-.TP
-.BR Li ntpEntTimeResolutionVal
-please fill me in...
-.TP
-.BR Li ntpEntTimePrecision
-please fill me in...
-.TP
-.BR Li ntpEntTimePrecisionVal
-please fill me in...
-.TP
-.BR Li ntpEntTimeDistance
-please fill me in...
-.PP
-This document corresponds to version @VERSION@ of NTP.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntpsnmpd\fP
option definitions.
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTPSNMPD 1ntpsnmpdmdoc User Commands
-.Os FreeBSD 6.4-STABLE
+.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:35:28 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:37 AM by AutoGen 5.16.2
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
All arguments must be options.
.Pp
.Sh DESCRIPTION
-.Nm
-is an SNMP MIB agent designed to interface with
-.Xr ntpd 1ntpdmdoc .
.Sh "OPTIONS"
.Bl -tag
.It \-n ", " -\-nofork
If any of these are directories, then the file \fI.ntprc\fP
is searched for within those directories.
.Sh USAGE
-.Nm
-currently uses a private MIB OID,
-.Ql enterprises.5597 ,
-which is the Meinberg top level OEM OID, and
-.Ql 99
-is the temporary working space for this project.
-The final OID has to be registered with IANA
-and this is done by the RFC Editor
-when the NTPv4 MIB RFC is standardized.
-.Pp
-If you have
-.Xr snmpwalk 1
-installed you can run
-.Dl % snmpwalk -v2c -c public localhost enterprises.5597.99
-to see a list of all currently supported NTP MIB objects
-and their current values.
.Sh "ENVIRONMENT"
See \fBOPTION PRESETS\fP for configuration environment variables.
.Sh "FILES"
it to autogen-users@lists.sourceforge.net. Thank you.
.El
.Sh AUTHORS
-.An "Heiko Gerstung"
.Sh "COPYRIGHT"
Copyright (C) 1970-2012 The University of Delaware all rights reserved.
This program is released under the terms of the NTP license, <http://ntp.org/license>.
.Sh "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-The following objects are currently supported:
-.Pp
-.Bl -tag -width ".Li ntpEntSoftwareVersionVal" -compact -offset indent
-.It Li ntpEntSoftwareName
-please fill me in...
-.It Li ntpEntSoftwareVersion
-please fill me in...
-.It Li ntpEntSoftwareVersionVal
-please fill me in...
-.It Li ntpEntSoftwareVendor
-please fill me in...
-.It Li ntpEntSystemType
-please fill me in...
-.It Li ntpEntTimeResolution
-please fill me in...
-.It Li ntpEntTimeResolutionVal
-please fill me in...
-.It Li ntpEntTimePrecision
-please fill me in...
-.It Li ntpEntTimePrecisionVal
-please fill me in...
-.It Li ntpEntTimeDistance
-please fill me in...
-.El
-.Pp
-This document corresponds to version @VERSION@ of NTP.
.Pp
This manual page was \fIAutoGen\fP-erated from the \fBntpsnmpd\fP
option definitions.
<title>ntpsnmpd: Network Time Protocol SNMP Daemon User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="ntpsnmpd: Network Time Protocol SNMP Daemon User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpsnmpd-Description">ntpsnmpd Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpsnmpd-Description">ntpsnmpd Description</a>,
Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-
+<br>
</div>
<h2 class="unnumbered">ntpsnmpd: Network Time Protocol Query User Manual</h2>
<p>The <code>ntpsnmpd</code> utility program is used to monitor NTP daemon <code>ntpd</code>
operations and determine performance. It uses the standard NTP mode 6 control
- <p>This document applies to version 4.2.7p337 of <code>ntpsnmpd</code>.
+ <p>This document applies to version 4.2.7p339 of <code>ntpsnmpd</code>.
<ul class="menu">
<li><a accesskey="1" href="#ntpsnmpd-Description">ntpsnmpd Description</a>: Description
</ul>
<div class="node">
-<a name="ntpsnmpd-Description"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Usage">Usage</a>,
+
<a name="ntpsnmpd-Description"></a>Next: <a rel="next" accesskey="n" href="#Usage">Usage</a>,
Previous: <a rel="previous" accesskey="p" href="#Top">Top</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
<p>The <code>ntpsnmpd</code> utility program provides an SNMP MIB agent for <code>ntpd</code>.
<div class="node">
-<a name="Usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Internal-Commands">Internal Commands</a>,
-Previous: <a rel="previous" accesskey="p" href="#ntpsnmpd-Description">ntpsnmpd Description</a>,
+<a name="Usage"></a>Previous: <a rel="previous" accesskey="p" href="#ntpsnmpd-Description">ntpsnmpd Description</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
-.TH ntpsnmpd @NTPSNMPD_MS@ "25 Dec 2012" "4.2.7p338" "User Commands"
+.TH ntpsnmpd @NTPSNMPD_MS@ "26 Dec 2012" "4.2.7p339" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:35:22 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:32 AM by AutoGen 5.16.2
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agman-cmd.tpl
.\"
All arguments must be options.
.PP
.SH DESCRIPTION
-.B
-is an SNMP MIB agent designed to interface with
-.Xr ntpd @NTPD_MS@ .
.SH "OPTIONS"
.TP
.BR \-n ", " -\-nofork
If any of these are directories, then the file \fI.ntprc\fP
is searched for within those directories.
.SH USAGE
-.B
-currently uses a private MIB OID,
-.Ql enterprises.5597 ,
-which is the Meinberg top level OEM OID, and
-.Ql 99
-is the temporary working space for this project.
-The final OID has to be registered with IANA
-and this is done by the RFC Editor
-when the NTPv4 MIB RFC is standardized.
-.PP
-If you have
-.Xr snmpwalk 1
-installed you can run
-.Dl % snmpwalk -v2c -c public localhost enterprises.5597.99
-to see a list of all currently supported NTP MIB objects
-and their current values.
.SH "ENVIRONMENT"
See \fBOPTION PRESETS\fP for configuration environment variables.
.SH "FILES"
libopts had an internal operational error. Please report
it to autogen-users@lists.sourceforge.net. Thank you.
.SH AUTHORS
-.An "Heiko Gerstung"
.SH "COPYRIGHT"
Copyright (C) 1970-2012 The University of Delaware all rights reserved.
This program is released under the terms of the NTP license, <http://ntp.org/license>.
.SH "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-The following objects are currently supported:
-.PP
-.TP
-.BR Li ntpEntSoftwareName
-please fill me in...
-.TP
-.BR Li ntpEntSoftwareVersion
-please fill me in...
-.TP
-.BR Li ntpEntSoftwareVersionVal
-please fill me in...
-.TP
-.BR Li ntpEntSoftwareVendor
-please fill me in...
-.TP
-.BR Li ntpEntSystemType
-please fill me in...
-.TP
-.BR Li ntpEntTimeResolution
-please fill me in...
-.TP
-.BR Li ntpEntTimeResolutionVal
-please fill me in...
-.TP
-.BR Li ntpEntTimePrecision
-please fill me in...
-.TP
-.BR Li ntpEntTimePrecisionVal
-please fill me in...
-.TP
-.BR Li ntpEntTimeDistance
-please fill me in...
-.PP
-This document corresponds to version @VERSION@ of NTP.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntpsnmpd\fP
option definitions.
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTPSNMPD @NTPSNMPD_MS@ User Commands
-.Os FreeBSD 6.4-STABLE
+.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:35:28 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:37 AM by AutoGen 5.16.2
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
All arguments must be options.
.Pp
.Sh DESCRIPTION
-.Nm
-is an SNMP MIB agent designed to interface with
-.Xr ntpd @NTPD_MS@ .
.Sh "OPTIONS"
.Bl -tag
.It \-n ", " -\-nofork
If any of these are directories, then the file \fI.ntprc\fP
is searched for within those directories.
.Sh USAGE
-.Nm
-currently uses a private MIB OID,
-.Ql enterprises.5597 ,
-which is the Meinberg top level OEM OID, and
-.Ql 99
-is the temporary working space for this project.
-The final OID has to be registered with IANA
-and this is done by the RFC Editor
-when the NTPv4 MIB RFC is standardized.
-.Pp
-If you have
-.Xr snmpwalk 1
-installed you can run
-.Dl % snmpwalk -v2c -c public localhost enterprises.5597.99
-to see a list of all currently supported NTP MIB objects
-and their current values.
.Sh "ENVIRONMENT"
See \fBOPTION PRESETS\fP for configuration environment variables.
.Sh "FILES"
it to autogen-users@lists.sourceforge.net. Thank you.
.El
.Sh AUTHORS
-.An "Heiko Gerstung"
.Sh "COPYRIGHT"
Copyright (C) 1970-2012 The University of Delaware all rights reserved.
This program is released under the terms of the NTP license, <http://ntp.org/license>.
.Sh "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-The following objects are currently supported:
-.Pp
-.Bl -tag -width ".Li ntpEntSoftwareVersionVal" -compact -offset indent
-.It Li ntpEntSoftwareName
-please fill me in...
-.It Li ntpEntSoftwareVersion
-please fill me in...
-.It Li ntpEntSoftwareVersionVal
-please fill me in...
-.It Li ntpEntSoftwareVendor
-please fill me in...
-.It Li ntpEntSystemType
-please fill me in...
-.It Li ntpEntTimeResolution
-please fill me in...
-.It Li ntpEntTimeResolutionVal
-please fill me in...
-.It Li ntpEntTimePrecision
-please fill me in...
-.It Li ntpEntTimePrecisionVal
-please fill me in...
-.It Li ntpEntTimeDistance
-please fill me in...
-.El
-.Pp
-This document corresponds to version @VERSION@ of NTP.
.Pp
This manual page was \fIAutoGen\fP-erated from the \fBntpsnmpd\fP
option definitions.
# - Numeric values increment
# - empty 'increments' to 1
# - NEW 'increments' to empty
-point=338
+point=339
### betapoint is normally modified by script.
# ntp-stable Beta number (betapoint)
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp-wait.texi)
#
-# It has been AutoGen-ed December 25, 2012 at 11:30:28 AM by AutoGen 5.16.2
+# It has been AutoGen-ed December 25, 2012 at 12:47:19 PM by AutoGen 5.16.2
# From the definitions ntp-wait-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@end table
@node ntp-wait Authors
@subsection ntp-wait Authors
+1@*
@node ntp-wait Notes
@subsection ntp-wait Notes
This document corresponds to version @VERSION@ of NTP.
-.TH ntp-wait 1ntp-waitman "25 Dec 2012" "ntp (4.2.7p338)" "User Commands"
+.TH ntp-wait 1ntp-waitman "25 Dec 2012" "ntp (4.2.7p339)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:30:24 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 25, 2012 at 12:47:15 PM by AutoGen 5.16.2
.\" From the definitions ntp-wait-opts.def
.\" and the template file agman-cmd.tpl
.\"
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:30:30 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 25, 2012 at 12:47:21 PM by AutoGen 5.16.2
.\" From the definitions ntp-wait-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>Ntp-wait User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Ntp-wait User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">Ntp-wait User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Description">ntp-wait Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Description">ntp-wait Description</a>,
Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-
+<br>
</div>
<h2 class="unnumbered">Simple Network Time Protocol User Manual</h2>
and only then start any applicaitons (like database servers) that require
accurate and stable time.
- <p>This document applies to version 4.2.7p338 of <code>ntp-wait</code>.
+ <p>This document applies to version 4.2.7p339 of <code>ntp-wait</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
</ul>
<div class="node">
-<a name="ntp-wait-Description"></a>
-<a name="ntp_002dwait-Description"></a>
<p><hr>
-
-
+<a name="ntp_002dwait-Description"></a>
+<br>
</div>
<!-- node-name, next, previous, up -->
<code>ntpd -g</code> has set the time.
<div class="node">
-<a name="ntp-wait-Invocation"></a>
-<a name="ntp_002dwait-Invocation"></a>
<p><hr>
-
-
+<a name="ntp_002dwait-Invocation"></a>
+<br>
</div>
<h3 class="section">Invoking ntp-wait</h3>
This software is released under the NTP license, <http://ntp.org/license>.
<ul class="menu">
-<li><a accesskey="1" href="#ntp_002dwait-usage">ntp-wait usage</a>: ntp-wait help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#ntp_002dwait-usage">ntp-wait usage</a>: ntp-wait help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#ntp_002dwait">ntp-wait </a>: option (-n)
<li><a accesskey="3" href="#ntp_002dwait">ntp-wait </a>: option (-s)
<li><a accesskey="4" href="#ntp_002dwait">ntp-wait </a>: option (-v)
</ul>
<div class="node">
-<a name="ntp-wait-usage"></a>
-<a name="ntp_002dwait-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait">ntp-wait</a>,
+
<a name="ntp_002dwait-usage"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait">ntp-wait</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">ntp-wait help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">ntp-wait help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-ntp_002dwait-help-3"></a>
This is the automatically generated usage text for ntp-wait.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
<pre class="example">/deacon/backroom/snaps/ntp-dev/A.snap/scripts/ntp-wait version [unknown] calling Getopt::Std::getopts (version 1.05 [paranoid]),
See ``perldoc Getopt::Std'' about $Getopt::Std::STANDARD_HELP_VERSION.]
</pre>
<div class="node">
-<a name="ntp-wait"></a>
-<a name="ntp_002dwait"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-config">ntp-wait config</a>,
+
<a name="ntp_002dwait"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-config">ntp-wait config</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait">ntp-wait</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">option (-n)</h4>
<p><a name="index-ntp_002dwait_002d-4"></a>
This is the “number of times to check ntpd” option.
-This option takes an argument number <samp><span class="file">num-tries</span></samp>.
+This option takes an argument number <span class="file">num-tries</span>.
The maximum number of times we will check ntpd to see if it
has been able to synchronize and stabilize the system clock.
<div class="node">
-<a name="ntp-wait"></a>
-<a name="ntp_002dwait"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-config">ntp-wait config</a>,
+
<a name="ntp_002dwait"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-config">ntp-wait config</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait">ntp-wait</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">option (-s)</h4>
<p><a name="index-ntp_002dwait_002d-5"></a>
This is the “how long to sleep between tries” option.
-This option takes an argument number <samp><span class="file">secs-between-tries</span></samp>.
-We will sleep for <samp><span class="file">secs-between-tries</span></samp> after each query of ntpd
+This option takes an argument number <span class="file">secs-between-tries</span>.
+We will sleep for <span class="file">secs-between-tries</span> after each query of ntpd
that returns "the time is not yet stable".
<div class="node">
-<a name="ntp-wait"></a>
-<a name="ntp_002dwait"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-config">ntp-wait config</a>,
+
<a name="ntp_002dwait"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-config">ntp-wait config</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait">ntp-wait</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">option (-v)</h4>
will provide status information.
<div class="node">
-<a name="ntp-wait-config"></a>
-<a name="ntp_002dwait-config"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-exit-status">ntp-wait exit status</a>,
+
<a name="ntp_002dwait-config"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-exit-status">ntp-wait exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait">ntp-wait</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">presetting/configuring ntp-wait</h4>
first letter of the argument is examined:
<dl>
-<dt>‘<samp><span class="samp">version</span></samp>’<dd>Only print the version. This is the default.
-<br><dt>‘<samp><span class="samp">copyright</span></samp>’<dd>Name the copyright usage licensing terms.
-<br><dt>‘<samp><span class="samp">verbose</span></samp>’<dd>Print the full copyright usage licensing terms.
+<dt><span class="samp">version</span><dd>Only print the version. This is the default.
+<br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms.
+<br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms.
</dl>
<div class="node">
-<a name="ntp-wait-exit-status"></a>
-<a name="ntp_002dwait-exit-status"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Authors">ntp-wait Authors</a>,
+
<a name="ntp_002dwait-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Authors">ntp-wait Authors</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-config">ntp-wait config</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntp-wait exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
</dl>
<div class="node">
-<a name="ntp-wait-Authors"></a>
-<a name="ntp_002dwait-Authors"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Notes">ntp-wait Notes</a>,
+
<a name="ntp_002dwait-Authors"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Notes">ntp-wait Notes</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-exit-status">ntp-wait exit status</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntp-wait Authors</h4>
+<p>1<br>
<div class="node">
-<a name="ntp-wait-Notes"></a>
-<a name="ntp_002dwait-Notes"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-Authors">ntp-wait Authors</a>,
+
<a name="ntp_002dwait-Notes"></a>Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-Authors">ntp-wait Authors</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntp-wait Notes</h4>
-.TH ntp-wait @NTP_WAIT_MS@ "25 Dec 2012" "ntp (4.2.7p338)" "User Commands"
+.TH ntp-wait @NTP_WAIT_MS@ "25 Dec 2012" "ntp (4.2.7p339)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:30:24 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 25, 2012 at 12:47:15 PM by AutoGen 5.16.2
.\" From the definitions ntp-wait-opts.def
.\" and the template file agman-cmd.tpl
.\"
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:30:30 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 25, 2012 at 12:47:21 PM by AutoGen 5.16.2
.\" From the definitions ntp-wait-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-sntp.texi)
#
-# It has been AutoGen-ed December 25, 2012 at 11:36:08 AM by AutoGen 5.16.2
+# It has been AutoGen-ed December 26, 2012 at 04:12:19 AM by AutoGen 5.16.2
# From the definitions sntp-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p338
+sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p339
USAGE: sntp [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
[ hostname-or-IP ...]
Flg Arg Option-Name Description
or
@code{rdate(8)}
commands.
-
-@end multitable
+@end table
@node sntp Authors
@subsection sntp Authors
+1@*1@*1@*
@node sntp Notes
@subsection sntp Notes
This document corresponds to version @VERSION@ of
/*
* EDIT THIS FILE WITH CAUTION (sntp-opts.c)
*
- * It has been AutoGen-ed December 25, 2012 at 11:26:58 AM by AutoGen 5.16.2
+ * It has been AutoGen-ed December 25, 2012 at 12:44:42 PM by AutoGen 5.16.2
* From the definitions sntp-opts.def
* and the template file options
*
* sntp option static const strings
*/
static char const sntp_opt_strs[2500] =
-/* 0 */ "sntp 4.2.7p338\n"
+/* 0 */ "sntp 4.2.7p339\n"
"Copyright (C) 1970-2012 The University of Delaware, all rights reserved.\n"
"This is free software. It is licensed for use, modification and\n"
"redistribution under the terms of the NTP License, copies of which\n"
/* 2244 */ "LOAD_OPTS\0"
/* 2254 */ "no-load-opts\0"
/* 2267 */ "SNTP\0"
-/* 2272 */ "sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p338\n"
+/* 2272 */ "sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p339\n"
"USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n"
"\t\t[ hostname-or-IP ...]\n\0"
/* 2433 */ "$HOME\0"
/* 2441 */ ".ntprc\0"
/* 2448 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 2482 */ "\n\n\0"
-/* 2485 */ "sntp 4.2.7p338";
+/* 2485 */ "sntp 4.2.7p339";
/*
* ipv4 option description with
/*
* EDIT THIS FILE WITH CAUTION (sntp-opts.h)
*
- * It has been AutoGen-ed December 25, 2012 at 11:26:57 AM by AutoGen 5.16.2
+ * It has been AutoGen-ed December 25, 2012 at 12:44:42 PM by AutoGen 5.16.2
* From the definitions sntp-opts.def
* and the template file options
*
} teOptIndex;
#define OPTION_CT 23
-#define SNTP_VERSION "4.2.7p338"
-#define SNTP_FULL_VERSION "sntp 4.2.7p338"
+#define SNTP_VERSION "4.2.7p339"
+#define SNTP_FULL_VERSION "sntp 4.2.7p339"
/*
* Interface defines for all options. Replace "n" with the UPPER_CASED
-.TH sntp 1sntpman "25 Dec 2012" "4.2.7p338" "User Commands"
+.TH sntp 1sntpman "26 Dec 2012" "4.2.7p339" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (sntp-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:36:03 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:12:14 AM by AutoGen 5.16.2
.\" From the definitions sntp-opts.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd December 25 2012
+.Dd December 26 2012
.Dt SNTP 1sntpmdoc User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (sntp-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:36:10 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:12:21 AM by AutoGen 5.16.2
.\" From the definitions sntp-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
clock. Run as root, it can correct the system clock to this offset as
well. It can be run as an interactive command or from a cron job.
- <p>This document applies to version 4.2.7p338 of <code>sntp</code>.
+ <p>This document applies to version 4.2.7p339 of <code>sntp</code>.
<p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
IETF specification.
-
<div class="shortcontents">
+ <div class="shortcontents">
<h2>Short Contents</h2>
<ul>
<a href="#Top">Simple Network Time Protocol User Manual</a>
used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
-<pre class="example">sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p338
+<pre class="example">sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p339
USAGE: sntp [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
[ hostname-or-IP ...]
Flg Arg Option-Name Description
<code>ntpdate(1ntpdatemdoc)</code>,
or
<code>rdate(8)</code>
-commands.
-
+commands.
+</dl>
<div class="node">
<p><hr>
<a name="sntp-Authors"></a>Next: <a rel="next" accesskey="n" href="#sntp-Notes">sntp Notes</a>,
<h4 class="subsection">sntp Authors</h4>
+<p>1<br>1<br>1<br>
<div class="node">
<p><hr>
<a name="sntp-Notes"></a>Previous: <a rel="previous" accesskey="p" href="#sntp-Authors">sntp Authors</a>,
<h4 class="subsection">sntp Notes</h4>
-
<p>This document corresponds to version of
+<p>This document corresponds to version of
<code>sntp</code>.
<div class="node">
<br>
</div>
- <!-- node-name, next, previous, up -->
+<!-- node-name, next, previous, up -->
<h3 class="section">Usage</h3>
-
<p>The simplest use of this program is as an unprivileged command to
+<p>The simplest use of this program is as an unprivileged command to
check the current time, offset, and error in the local clock.
For example:
- <pre class="example"> sntp ntpserver.somewhere
- </pre>
-
<p>With suitable privilege, it can be run as a command or in a
+<pre class="example"> sntp ntpserver.somewhere
+</pre>
+ <p>With suitable privilege, it can be run as a command or in a
<code>crom</code> job to reset the local clock from a reliable server, like
the <code>ntpdate</code> and <code>rdate</code> commands.
For example:
- <pre class="example"> sntp -a ntpserver.somewhere
- </pre>
- </body></html>
+<pre class="example"> sntp -a ntpserver.somewhere
+</pre>
+ </body></html>
-.TH sntp @SNTP_MS@ "25 Dec 2012" "4.2.7p338" "User Commands"
+.TH sntp @SNTP_MS@ "26 Dec 2012" "4.2.7p339" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (sntp-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:36:03 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:12:14 AM by AutoGen 5.16.2
.\" From the definitions sntp-opts.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd December 25 2012
+.Dd December 26 2012
.Dt SNTP @SNTP_MS@ User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (sntp-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:36:10 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:12:21 AM by AutoGen 5.16.2
.\" From the definitions sntp-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp-keygen.texi)
#
-# It has been AutoGen-ed December 25, 2012 at 11:35:45 AM by AutoGen 5.16.2
+# It has been AutoGen-ed December 26, 2012 at 04:11:56 AM by AutoGen 5.16.2
# From the definitions ntp-keygen-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
By default, the program generates a non-trusted certificate.
@item Fl
Generate parameters and keys for the Mu-Varadharajan (MV) identification scheme.
-
-@end multitable
+@end table
@node Random
@section Random
which is a printable ASCII string 16 characters or less in length.
Each character is chosen from the 93 printable characters
in the range 0x21 through 0x7f excluding space and the
-@quoteleft{}#@quoteright{}
+@quoteleft{}@quoteright{}#
+#
character.
Note that the keys used by the
@exampleindent 0
@example
-ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p338
+ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p339
USAGE: ntp-keygen [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
Flg Arg Option-Name Description
-b Num imbits identity modulus bits
/*
* EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.c)
*
- * It has been AutoGen-ed December 25, 2012 at 11:35:32 AM by AutoGen 5.16.2
+ * It has been AutoGen-ed December 26, 2012 at 04:11:42 AM by AutoGen 5.16.2
* From the definitions ntp-keygen-opts.def
* and the template file options
*
* ntp-keygen option static const strings
*/
static char const ntp_keygen_opt_strs[2358] =
-/* 0 */ "ntp-keygen (ntp) 4.2.7p338\n"
+/* 0 */ "ntp-keygen (ntp) 4.2.7p339\n"
"Copyright (C) 1970-2012 The University of Delaware, all rights reserved.\n"
"This is free software. It is licensed for use, modification and\n"
"redistribution under the terms of the NTP License, copies of which\n"
/* 2136 */ "no-load-opts\0"
/* 2149 */ "no\0"
/* 2152 */ "NTP_KEYGEN\0"
-/* 2163 */ "ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p338\n"
+/* 2163 */ "ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p339\n"
"USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n\0"
/* 2279 */ "$HOME\0"
/* 2285 */ ".\0"
/* 2287 */ ".ntprc\0"
/* 2294 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 2328 */ "\n\n\0"
-/* 2331 */ "ntp-keygen (ntp) 4.2.7p338";
+/* 2331 */ "ntp-keygen (ntp) 4.2.7p339";
/*
* imbits option description:
/*
* EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.h)
*
- * It has been AutoGen-ed December 25, 2012 at 11:35:32 AM by AutoGen 5.16.2
+ * It has been AutoGen-ed December 26, 2012 at 04:11:41 AM by AutoGen 5.16.2
* From the definitions ntp-keygen-opts.def
* and the template file options
*
} teOptIndex;
#define OPTION_CT 26
-#define NTP_KEYGEN_VERSION "4.2.7p338"
-#define NTP_KEYGEN_FULL_VERSION "ntp-keygen (ntp) 4.2.7p338"
+#define NTP_KEYGEN_VERSION "4.2.7p339"
+#define NTP_KEYGEN_FULL_VERSION "ntp-keygen (ntp) 4.2.7p339"
/*
* Interface defines for all options. Replace "n" with the UPPER_CASED
-.TH ntp-keygen 1ntp-keygenman "25 Dec 2012" "ntp (4.2.7p338)" "User Commands"
+.TH ntp-keygen 1ntp-keygenman "26 Dec 2012" "ntp (4.2.7p339)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:35:40 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:51 AM by AutoGen 5.16.2
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTP_KEYGEN 1ntp-keygenmdoc User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:35:47 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:58 AM by AutoGen 5.16.2
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>Ntp-keygen User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Ntp-keygen User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-
+
<a name="Top"></a>Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
+<br>
</div>
<h2 class="unnumbered">Top</h2>
</ul>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Description">Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#Description">Description</a>,
Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-
+<br>
</div>
<h2 class="unnumbered">NTP Key Generation Program User Manual</h2>
printable ASCII format so they can be embedded as MIME attachments in
mail to other sites.
- <p>This document applies to version 4.2.7p338 of <code>ntp-keygen</code>.
+ <p>This document applies to version 4.2.7p339 of <code>ntp-keygen</code>.
<div class="node">
-<a name="Description"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Running-the-Program">Running the Program</a>,
+
<a name="Description"></a>Next: <a rel="next" accesskey="n" href="#Running-the-Program">Running the Program</a>,
Previous: <a rel="previous" accesskey="p" href="#Top">Top</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
as described in the <a href="#Cryptographic-Data-Files">Cryptographic Data Files</a> section below.
<div class="node">
-<a name="Running-the-Program"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Random-Seed-File">Random Seed File</a>,
+
<a name="Running-the-Program"></a>Next: <a rel="next" accesskey="n" href="#Random-Seed-File">Random Seed File</a>,
Previous: <a rel="previous" accesskey="p" href="#Description">Description</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
Autokey Public-Key Authentication page.
<div class="node">
-<a name="ntp-keygen-Invocation"></a>
-<a name="ntp_002dkeygen-Invocation"></a>
<p><hr>
-
-
+<a name="ntp_002dkeygen-Invocation"></a>
+<br>
</div>
<h3 class="section">Invoking ntp-keygen</h3>
Cryptographic Data Files
section below.
<div class="node">
-<a name="Running"></a>
<p><hr>
-
-
+<a name="Running"></a>
+<br>
</div>
<h3 class="section">Running</h3>
Program
To test and gain experience with Autokey concepts, log in as root and
change to the keys directory, usually
-<samp><span class="file">/usr/local/etc</span></samp>
+<span class="file">/usr/local/etc</span>
When run for the first time, or if all files with names beginning with
<code>ntpkey</code> have been removed, use the
<code>ntp-keygen</code>
at one time, so each generation is distinct and can be readily
recognized in monitoring data.
<div class="node">
-<a name="Running"></a>
<p><hr>
-
-
+<a name="Running"></a>
+<br>
</div>
<h3 class="section">Running</h3>
to the shared keys directory, even as root.
In this case, NFS clients can specify the files in another
directory such as
-<samp><span class="file">/etc</span></samp>
+<span class="file">/etc</span>
using the
<code>keysdir</code> command.
There is no need for one client to read the keys and certificates
at one time, so each generation is distinct and can be readily
recognized in monitoring data.
<div class="node">
-<a name="Running"></a>
<p><hr>
-
-
+<a name="Running"></a>
+<br>
</div>
<h3 class="section">Running</h3>
to the shared keys directory, even as root.
In this case, NFS clients can specify the files in another
directory such as
-<samp><span class="file">/etc</span></samp>
+<span class="file">/etc</span>
using the
<code>keysdir</code> command.
There is no need for one client to read the keys and certificates
Other dependent hosts will continue as usual until signatures are refreshed,
at which time the protocol is restarted.
<div class="node">
-<a name="Identity"></a>
<p><hr>
-
-
+<a name="Identity"></a>
+<br>
</div>
<h3 class="section">Identity</h3>
As the MV scheme is independent of keys and certificates,
these files can be refreshed as needed.
<div class="node">
-<a name="Command"></a>
<p><hr>
-
-
+<a name="Command"></a>
+<br>
</div>
<h3 class="section">Command</h3>
Line
Options
<dl>
-<dt>‘<samp><span class="samp">Fl</span></samp>’<dd>Select certificate message digest/signature encryption scheme.
+<dt><span class="samp">Fl</span><dd>Select certificate message digest/signature encryption scheme.
The
<code>scheme</code> can be one of the following:
.
<code>DSA-SHA1</code>. Note that RSA schemes must be used with a RSA sign key and DSA
schemes must be used with a DSA sign key.
The default without this option is
-<code>RSA-MD5</code>. <br><dt>‘<samp><span class="samp">Fl</span></samp>’<dd>Enable debugging.
+<code>RSA-MD5</code>. <br><dt><span class="samp">Fl</span><dd>Enable debugging.
This option displays the cryptographic data produced in eye-friendly billboards.
-<br><dt>‘<samp><span class="samp">Fl</span></samp>’<dd>Write the IFF client keys to the standard output.
+<br><dt><span class="samp">Fl</span><dd>Write the IFF client keys to the standard output.
This is intended for automatic key distribution by mail.
-<br><dt>‘<samp><span class="samp">Fl</span></samp>’<dd>Generate parameters and keys for the GQ identification scheme,
+<br><dt><span class="samp">Fl</span><dd>Generate parameters and keys for the GQ identification scheme,
obsoleting any that may exist.
-<br><dt>‘<samp><span class="samp">Fl</span></samp>’<dd>Generate keys for the GQ identification scheme
+<br><dt><span class="samp">Fl</span><dd>Generate keys for the GQ identification scheme
using the existing GQ parameters.
If the GQ parameters do not yet exist, create them first.
-<br><dt>‘<samp><span class="samp">Fl</span></samp>’<dd>Generate new host keys, obsoleting any that may exist.
-<br><dt>‘<samp><span class="samp">Fl</span></samp>’<dd>Generate parameters for the IFF identification scheme,
+<br><dt><span class="samp">Fl</span><dd>Generate new host keys, obsoleting any that may exist.
+<br><dt><span class="samp">Fl</span><dd>Generate parameters for the IFF identification scheme,
obsoleting any that may exist.
<br><dt><span class="samp">Fl</span><dd>Set the suject name to
<code>name</code>. This is used as the subject field in certificates
and in the file name for host and sign keys.
-<br><dt>‘<samp><span class="samp">Fl</span></samp>’<dd>Generate MD5 keys, obsoleting any that may exist.
-<br><dt>‘<samp><span class="samp">Fl</span></samp>’<dd>Generate a private certificate.
+<br><dt><span class="samp">Fl</span><dd>Generate MD5 keys, obsoleting any that may exist.
+<br><dt><span class="samp">Fl</span><dd>Generate a private certificate.
By default, the program generates public certificates.
<br><dt><span class="samp">Fl</span><dd>Encrypt generated files containing private data with
<code>password</code> and the DES-CBC algorithm.
<br><dt><span class="samp">Fl</span><dd>Set the issuer name to
<code>name</code>. This is used for the issuer field in certificates
and in the file name for identity files.
-<br><dt>‘<samp><span class="samp">Fl</span></samp>’<dd>Generate a trusted certificate.
+<br><dt><span class="samp">Fl</span><dd>Generate a trusted certificate.
By default, the program generates a non-trusted certificate.
-<br><dt>‘<samp><span class="samp">Fl</span></samp>’<dd>Generate parameters and keys for the Mu-Varadharajan (MV) identification scheme.
+<br><dt><span class="samp">Fl</span><dd>Generate parameters and keys for the Mu-Varadharajan (MV) identification scheme.
<div class="node">
-<a name="Random"></a>
<p><hr>
-
-
+<a name="Random"></a>
+<br>
</div>
<h3 class="section">Random</h3>
the daemon exits with a message to the system log and the program
exits with a suitable error message.
<div class="node">
-<a name="Cryptographic"></a>
<p><hr>
-
-
+<a name="Cryptographic"></a>
+<br>
</div>
<h3 class="section">Cryptographic</h3>
which is a printable ASCII string 16 characters or less in length.
Each character is chosen from the 93 printable characters
in the range 0x21 through 0x7f excluding space and the
-‘#’
+#
character.
<p>Note that the keys used by the
This software is released under the NTP license, <http://ntp.org/license>.
<ul class="menu">
-<li><a accesskey="1" href="#ntp_002dkeygen-usage">ntp-keygen usage</a>: ntp-keygen help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#ntp_002dkeygen-usage">ntp-keygen usage</a>: ntp-keygen help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#ntp_002dkeygen-imbits">ntp-keygen imbits</a>: imbits option (-b)
<li><a accesskey="3" href="#ntp_002dkeygen-certificate">ntp-keygen certificate</a>: certificate option (-c)
<li><a accesskey="4" href="#ntp_002dkeygen-cipher">ntp-keygen cipher</a>: cipher option (-C)
</ul>
<div class="node">
-<a name="ntp-keygen-usage"></a>
-<a name="ntp_002dkeygen-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-imbits">ntp-keygen imbits</a>,
+
<a name="ntp_002dkeygen-usage"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-imbits">ntp-keygen imbits</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
-<h4 class="subsection">ntp-keygen help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">ntp-keygen help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-ntp_002dkeygen-help-3"></a>
This is the automatically generated usage text for ntp-keygen.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
- <pre class="example"> ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p337
+ <pre class="example"> ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p338
USAGE: ntp-keygen [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
Flg Arg Option-Name Description
-b Num imbits identity modulus bits
please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
</pre>
<div class="node">
-<a name="ntp-keygen-imbits"></a>
-<a name="ntp_002dkeygen-imbits"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-certificate">ntp-keygen certificate</a>,
+
<a name="ntp_002dkeygen-imbits"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-certificate">ntp-keygen certificate</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-usage">ntp-keygen usage</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">imbits option (-b)</h4>
<p><a name="index-ntp_002dkeygen_002dimbits-4"></a>
This is the “identity modulus bits” option.
-This option takes an argument number <samp><span class="file">imbits</span></samp>.
+This option takes an argument number <span class="file">imbits</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
<p>The number of bits in the identity modulus. The default is 256.
<div class="node">
-<a name="ntp-keygen-certificate"></a>
-<a name="ntp_002dkeygen-certificate"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-cipher">ntp-keygen cipher</a>,
+
<a name="ntp_002dkeygen-certificate"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-cipher">ntp-keygen cipher</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-imbits">ntp-keygen imbits</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">certificate option (-c)</h4>
<p><a name="index-ntp_002dkeygen_002dcertificate-5"></a>
This is the “certificate scheme” option.
-This option takes an argument string <samp><span class="file">scheme</span></samp>.
+This option takes an argument string <span class="file">scheme</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
schemes must be used with a DSA sign key. The default without
this option is RSA-MD5.
<div class="node">
-<a name="ntp-keygen-cipher"></a>
-<a name="ntp_002dkeygen-cipher"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-id_002dkey">ntp-keygen id-key</a>,
+
<a name="ntp_002dkeygen-cipher"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-id_002dkey">ntp-keygen id-key</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-certificate">ntp-keygen certificate</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">cipher option (-C)</h4>
<p><a name="index-ntp_002dkeygen_002dcipher-6"></a>
This is the “privatekey cipher” option.
-This option takes an argument string <samp><span class="file">cipher</span></samp>.
+This option takes an argument string <span class="file">cipher</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
available in "openssl -h" output.
</code><div class="node">
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-gq_002dparams">ntp-keygen gq-params</a>,
+
<a name="ntp_002dkeygen-id_002dkey"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-gq_002dparams">ntp-keygen gq-params</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-cipher">ntp-keygen cipher</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">id-key option (-e)</h4>
<p>Write the IFF or GQ client keys to the standard output. This is
intended for automatic key distribution by mail.
<div class="node">
-<a name="ntp-keygen-gq-params"></a>
-<a name="ntp_002dkeygen-gq_002dparams"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-host_002dkey">ntp-keygen host-key</a>,
+
<a name="ntp_002dkeygen-gq_002dparams"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-host_002dkey">ntp-keygen host-key</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-id_002dkey">ntp-keygen id-key</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">gq-params option (-G)</h4>
<p>Generate parameters and keys for the GQ identification scheme,
obsoleting any that may exist.
<div class="node">
-<a name="ntp-keygen-host-key"></a>
-<a name="ntp_002dkeygen-host_002dkey"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-iffkey">ntp-keygen iffkey</a>,
+
<a name="ntp_002dkeygen-host_002dkey"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-iffkey">ntp-keygen iffkey</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-gq_002dparams">ntp-keygen gq-params</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">host-key option (-H)</h4>
<p>Generate new host keys, obsoleting any that may exist.
<div class="node">
-<a name="ntp-keygen-iffkey"></a>
-<a name="ntp_002dkeygen-iffkey"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-ident">ntp-keygen ident</a>,
+
<a name="ntp_002dkeygen-iffkey"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-ident">ntp-keygen ident</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-host_002dkey">ntp-keygen host-key</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">iffkey option (-I)</h4>
<p>Generate parameters for the IFF identification scheme, obsoleting
any that may exist.
<div class="node">
-<a name="ntp-keygen-ident"></a>
-<a name="ntp_002dkeygen-ident"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-lifetime">ntp-keygen lifetime</a>,
+
<a name="ntp_002dkeygen-ident"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-lifetime">ntp-keygen lifetime</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-iffkey">ntp-keygen iffkey</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">ident option (-i)</h4>
<p><a name="index-ntp_002dkeygen_002dident-11"></a>
This is the “set autokey group name” option.
-This option takes an argument string <samp><span class="file">group</span></samp>.
+This option takes an argument string <span class="file">group</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
ntpd's configuration file.
</code><div class="node">
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-md5key">ntp-keygen md5key</a>,
+
<a name="ntp_002dkeygen-lifetime"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-md5key">ntp-keygen md5key</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-ident">ntp-keygen ident</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">lifetime option (-l)</h4>
<p>Set the certificate expiration to lifetime days from now.
<div class="node">
-<a name="ntp-keygen-md5key"></a>
-<a name="ntp_002dkeygen-md5key"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-modulus">ntp-keygen modulus</a>,
+
<a name="ntp_002dkeygen-md5key"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-modulus">ntp-keygen modulus</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-lifetime">ntp-keygen lifetime</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">md5key option (-M)</h4>
This is the ``generate md5 keys'' option.
Generate MD5 keys, obsoleting any that may exist.
<div class="node">
-<a name="ntp-keygen-modulus"></a>
-<a name="ntp_002dkeygen-modulus"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-pvt_002dcert">ntp-keygen pvt-cert</a>,
+
<a name="ntp_002dkeygen-modulus"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-pvt_002dcert">ntp-keygen pvt-cert</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-md5key">ntp-keygen md5key</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">modulus option (-m)</h4>
<p>The number of bits in the prime modulus. The default is 512.
<div class="node">
-<a name="ntp-keygen-pvt-cert"></a>
-<a name="ntp_002dkeygen-pvt_002dcert"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-pvt_002dpasswd">ntp-keygen pvt-passwd</a>,
+
<a name="ntp_002dkeygen-pvt_002dcert"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-pvt_002dpasswd">ntp-keygen pvt-passwd</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-modulus">ntp-keygen modulus</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">pvt-cert option (-P)</h4>
<p>Generate a private certificate. By default, the program generates
public certificates.
<div class="node">
-<a name="ntp-keygen-pvt-passwd"></a>
-<a name="ntp_002dkeygen-pvt_002dpasswd"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-get_002dpvt_002dpasswd">ntp-keygen get-pvt-passwd</a>,
+
<a name="ntp_002dkeygen-pvt_002dpasswd"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-get_002dpvt_002dpasswd">ntp-keygen get-pvt-passwd</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-pvt_002dcert">ntp-keygen pvt-cert</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">pvt-passwd option (-p)</h4>
<p>Encrypt generated files containing private data with the specified
password and the cipher selected with <code>-C/--cipher</code>.
<div class="node">
-<a name="ntp-keygen-get-pvt-passwd"></a>
-<a name="ntp_002dkeygen-get_002dpvt_002dpasswd"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-sign_002dkey">ntp-keygen sign-key</a>,
+
<a name="ntp_002dkeygen-get_002dpvt_002dpasswd"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-sign_002dkey">ntp-keygen sign-key</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-pvt_002dpasswd">ntp-keygen pvt-passwd</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">get-pvt-passwd option (-q)</h4>
<p>Set the password for reading files to the specified password.
<div class="node">
-<a name="ntp-keygen-sign-key"></a>
-<a name="ntp_002dkeygen-sign_002dkey"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-subject_002dname">ntp-keygen subject-name</a>,
+
<a name="ntp_002dkeygen-sign_002dkey"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-subject_002dname">ntp-keygen subject-name</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-get_002dpvt_002dpasswd">ntp-keygen get-pvt-passwd</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">sign-key option (-S)</h4>
that may exist. By default, the program uses the host key as the
sign key.
<div class="node">
-<a name="ntp-keygen-subject-name"></a>
-<a name="ntp_002dkeygen-subject_002dname"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-trusted_002dcert">ntp-keygen trusted-cert</a>,
+
<a name="ntp_002dkeygen-subject_002dname"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-trusted_002dcert">ntp-keygen trusted-cert</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-sign_002dkey">ntp-keygen sign-key</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">subject-name option (-s)</h4>
of IFF, GQ, and MV client parameter files.
</code><div class="node">
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-mv_002dparams">ntp-keygen mv-params</a>,
+
<a name="ntp_002dkeygen-trusted_002dcert"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-mv_002dparams">ntp-keygen mv-params</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-subject_002dname">ntp-keygen subject-name</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">trusted-cert option (-T)</h4>
<p>Generate a trusted certificate. By default, the program generates
a non-trusted certificate.
<div class="node">
-<a name="ntp-keygen-mv-params"></a>
-<a name="ntp_002dkeygen-mv_002dparams"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-mv_002dkeys">ntp-keygen mv-keys</a>,
+
<a name="ntp_002dkeygen-mv_002dparams"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-mv_002dkeys">ntp-keygen mv-keys</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-trusted_002dcert">ntp-keygen trusted-cert</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">mv-params option (-V)</h4>
<p>Generate parameters and keys for the Mu-Varadharajan (MV)
identification scheme.
<div class="node">
-<a name="ntp-keygen-mv-keys"></a>
-<a name="ntp_002dkeygen-mv_002dkeys"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-config">ntp-keygen config</a>,
+
<a name="ntp_002dkeygen-mv_002dkeys"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-config">ntp-keygen config</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-mv_002dparams">ntp-keygen mv-params</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">mv-keys option (-v)</h4>
<li>must be compiled in by defining <code>AUTOKEY</code> during the compilation.
</ul>
- <p>This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
+ <p>This option has no <span class="samp">doc</span> documentation.
<div class="node">
-<a name="ntp-keygen-config"></a>
-<a name="ntp_002dkeygen-config"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-exit-status">ntp-keygen exit status</a>,
+
<a name="ntp_002dkeygen-config"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-exit-status">ntp-keygen exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-mv_002dkeys">ntp-keygen mv-keys</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">presetting/configuring ntp-keygen</h4>
<li>$PWD
</ul>
The environment variables <code>HOME</code>, and <code>PWD</code>
-are expanded and replaced when <samp><span class="file">ntp-keygen</span></samp> runs.
+are expanded and replaced when <span class="file">ntp-keygen</span> runs.
For any of these that are plain files, they are simply processed.
-For any that are directories, then a file named <samp><span class="file">.ntprc</span></samp> is searched for
+For any that are directories, then a file named <span class="file">.ntprc</span> is searched for
within that directory and processed.
<p>Configuration files may be in a wide variety of formats.
Common options are collected at the top, followed by program specific
segments. The segments are separated by lines like:
<pre class="example"> [NTP-KEYGEN]
-</pre>
+ </pre>
<p class="noindent">or by
<pre class="example"> <?program ntp-keygen>
-</pre>
+ </pre>
<p class="noindent">Do not mix these styles within one configuration file.
<p>Compound values and carefully constructed string values may also be
<pre class="example"> <option-name>
<sub-opt>...&lt;...&gt;...</sub-opt>
</option-name>
-</pre>
+ </pre>
<p class="noindent">yielding an <code>option-name.sub-opt</code> string value of
<pre class="example"> "...<...>..."
-</pre>
+ </pre>
<p><code>AutoOpts</code> does not track suboptions. You simply note that it is a
hierarchicly valued option. <code>AutoOpts</code> does provide a means for searching
the associated name/value pair list (see: optionFindValue).
first letter of the argument is examined:
<dl>
-<dt>‘<samp><span class="samp">version</span></samp>’<dd>Only print the version. This is the default.
-<br><dt>‘<samp><span class="samp">copyright</span></samp>’<dd>Name the copyright usage licensing terms.
-<br><dt>‘<samp><span class="samp">verbose</span></samp>’<dd>Print the full copyright usage licensing terms.
+<dt><span class="samp">version</span><dd>Only print the version. This is the default.
+<br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms.
+<br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms.
</dl>
<div class="node">
-<a name="ntp-keygen-exit-status"></a>
-<a name="ntp_002dkeygen-exit-status"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-Usage">ntp-keygen Usage</a>,
+
<a name="ntp_002dkeygen-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-Usage">ntp-keygen Usage</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-config">ntp-keygen config</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">ntp-keygen exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
-<br><dt>‘<samp><span class="samp">66 (EX_NOINPUT)</span></samp>’<dd>A specified configuration file could not be loaded.
-<br><dt>‘<samp><span class="samp">70 (EX_SOFTWARE)</span></samp>’<dd>libopts had an internal operational error. Please report
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
+<br><dt><span class="samp">66 (EX_NOINPUT)</span><dd>A specified configuration file could not be loaded.
+<br><dt><span class="samp">70 (EX_SOFTWARE)</span><dd>libopts had an internal operational error. Please report
it to autogen-users@lists.sourceforge.net. Thank you.
</dl>
<div class="node">
-<a name="ntp-keygen-Usage"></a>
-<a name="ntp_002dkeygen-Usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-Notes">ntp-keygen Notes</a>,
+
<a name="ntp_002dkeygen-Usage"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-Notes">ntp-keygen Notes</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-exit-status">ntp-keygen exit status</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">ntp-keygen Usage</h4>
no write password is specified, the read password is used
as the write password by default.
<div class="node">
-<a name="ntp-keygen-Notes"></a>
-<a name="ntp_002dkeygen-Notes"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-Bugs">ntp-keygen Bugs</a>,
+
<a name="ntp_002dkeygen-Notes"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-Bugs">ntp-keygen Bugs</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-Usage">ntp-keygen Usage</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">ntp-keygen Notes</h4>
<p>This document corresponds to version of NTP.
Portions of this document came from FreeBSD.
<div class="node">
-<a name="ntp-keygen-Bugs"></a>
-<a name="ntp_002dkeygen-Bugs"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-Notes">ntp-keygen Notes</a>,
+
<a name="ntp_002dkeygen-Bugs"></a>Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-Notes">ntp-keygen Notes</a>,
Up: <a rel="up" accesskey="u" href="#Cryptographic">Cryptographic</a>
-
+<br>
</div>
<h4 class="subsection">ntp-keygen Bugs</h4>
<p>Please report bugs to http://bugs.ntp.org .
<div class="node">
-<a name="Random-Seed-File"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Cryptographic-Data-Files">Cryptographic Data Files</a>,
+
<a name="Random-Seed-File"></a>Next: <a rel="next" accesskey="n" href="#Cryptographic-Data-Files">Cryptographic Data Files</a>,
Previous: <a rel="previous" accesskey="p" href="#Running-the-Program">Running the Program</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
with a message to the system log.
<div class="node">
-<a name="Cryptographic-Data-Files"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#Random-Seed-File">Random Seed File</a>,
+
<a name="Cryptographic-Data-Files"></a>Previous: <a rel="previous" accesskey="p" href="#Random-Seed-File">Random Seed File</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
18 SHA1 b5520c9fadd7ad3fd8bfa061c8821b65d029bb37 # SHA1 key
19 SHA1 8c74fb440ec80f453ec6aaa62b9baed0ab723b92 # SHA1 key
20 SHA1 6bc05f734306a189326000970c19b3910f403795 # SHA1 key
-</pre>
+ </pre>
<p>Figure 1. Typical Symmetric Key File
<p>Figure 1 shows a typical symmetric keys file used by the reference
-.TH ntp-keygen @NTP_KEYGEN_MS@ "25 Dec 2012" "ntp (4.2.7p338)" "User Commands"
+.TH ntp-keygen @NTP_KEYGEN_MS@ "26 Dec 2012" "ntp (4.2.7p339)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.man)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:35:40 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:51 AM by AutoGen 5.16.2
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd December 25 2012
+.Dd December 26 2012
.Dt NTP_KEYGEN @NTP_KEYGEN_MS@ User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.mdoc)
.\"
-.\" It has been AutoGen-ed December 25, 2012 at 11:35:47 AM by AutoGen 5.16.2
+.\" It has been AutoGen-ed December 26, 2012 at 04:11:58 AM by AutoGen 5.16.2
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
projects / thirdparty / ntp.git / commitdiff
