Lines Matching +full:system +full:- +full:clock +full:- +full:direction +full:- +full:out
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
3 <!-- Created by GNU Texinfo 6.6, http://www.gnu.org/software/texinfo/ -->
5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
10 <meta name="resource-type" content="document">
16 <!--
17 a.summary-letter {text-decoration: none}
18 blockquote.indentedblock {margin-right: 0em}
19 div.display {margin-left: 3.2em}
20 div.example {margin-left: 3.2em}
21 div.lisp {margin-left: 3.2em}
22 kbd {font-style: oblique}
23 pre.display {font-family: inherit}
24 pre.format {font-family: inherit}
25 pre.menu-comment {font-family: serif}
26 pre.menu-preformatted {font-family: serif}
27 span.nolinebreak {white-space: nowrap}
28 span.roman {font-family: initial; font-weight: normal}
29 span.sansserif {font-family: sans-serif; font-weight: normal}
30 ul.no-bullet {list-style: none}
31 -->
46 Next: <a href="#ntp_002econf-Description" accesskey="n" rel="next">ntp.conf Description</a>, Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> </p>
48 <span id="NTP_0027s-Configuration-File-User-Manual"></span><h1 class="top">NTP’s Configuration File User Manual</h1>
56 <h2 class="shortcontents-heading">Short Table of Contents</h2>
59 <ul class="no-bullet">
60 <li><a id="stoc-Description" href="#toc-Description">1 Description</a></li>
66 <tr><td align="left" valign="top">• <a href="#ntp_002econf-Description" accesskey="1">ntp.conf Description</a></td><td> </td><td align="left" valign="top">
68 <tr><td align="left" valign="top">• <a href="#ntp_002econf-Notes" accesskey="2">ntp.conf Notes</a></td><td> </td><td align="left" valign="top">
73 <span id="ntp_002econf-Description"></span><div class="header">
83 <tr><td align="left" valign="top">• <a href="#ntp_002econf-Notes" accesskey="1">Notes about ntp.conf</a></td><td> </td><td align="left" valign="top">
88 <span id="ntp_002econf-Notes"></span><div class="header">
90 Previous: <a href="#ntp_002econf-Bugs" accesskey="p" rel="prev">ntp.conf Bugs</a>, Up: <a href="#ntp_002econf-Description" accesskey="u" rel="up">ntp.conf Description</a> </p>
92 <span id="Notes-about-ntp_002econf"></span><h3 class="section">1.1 Notes about ntp.conf</h3>
93 <span id="index-ntp_002econf"></span>
94 <span id="index-Network-Time-Protocol-_0028NTP_0029-daemon-configuration-file-format"></span>
109 <code>-c</code>
124 host addresses written in numeric, dotted-quad form,
141 <li> <a href="#Authentication-Support">Authentication Support</a>
142 </li><li> <a href="#Monitoring-Support">Monitoring Support</a>
143 </li><li> <a href="#Access-Control-Support">Access Control Support</a>
144 </li><li> <a href="#Automatic-NTP-Configuration-Options">Automatic NTP Configuration Options</a>
145 </li><li> <a href="#Reference-Clock-Support">Reference Clock Support</a>
146 </li><li> <a href="#Miscellaneous-Options">Miscellaneous Options</a>
150 <a href="#Miscellaneous-Options">Miscellaneous Options</a>.
161 <tr><td align="left" valign="top">• <a href="#Configuration-Support" accesskey="1">Configuration Support</a></td><td> </td><td align="left" valign="top">
163 <tr><td align="left" valign="top">• <a href="#Authentication-Support" accesskey="2">Authentication Support</a></td><td> </td><td align="left" valign="top">
165 <tr><td align="left" valign="top">• <a href="#Monitoring-Support" accesskey="3">Monitoring Support</a></td><td> </td><td align="left" valign="top">
167 <tr><td align="left" valign="top">• <a href="#Access-Control-Support" accesskey="4">Access Control Support</a></td><td> </td><td align="left" valign="top">
169 <tr><td align="left" valign="top">• <a href="#Automatic-NTP-Configuration-Options" accesskey="5">Automatic NTP Configuration Options</a></td><td> </td><td align="left" valign="top">
171 <tr><td align="left" valign="top">• <a href="#Reference-Clock-Support" accesskey="6">Reference Clock Support</a></td><td> </td><td align="left" valign="top">
173 <tr><td align="left" valign="top">• <a href="#Miscellaneous-Options" accesskey="7">Miscellaneous Options</a></td><td> </td><td align="left" valign="top">
175 <tr><td align="left" valign="top">• <a href="#ntp_002econf-Files" accesskey="8">ntp.conf Files</a></td><td> </td><td align="left" valign="top">
177 <tr><td align="left" valign="top">• <a href="#ntp_002econf-See-Also" accesskey="9">ntp.conf See Also</a></td><td> </td><td align="left" valign="top">
179 <tr><td align="left" valign="top">• <a href="#ntp_002econf-Bugs">ntp.conf Bugs</a></td><td> </td><td align="left" valign="top">
186 <span id="Configuration-Support"></span><div class="header">
188 Next: <a href="#Authentication-Support" accesskey="n" rel="next">Authentication Support</a>, Up: <a href="#ntp_002econf-Notes" accesskey="u" rel="up">ntp.conf Notes</a> </p>
190 <span id="Configuration-Support-1"></span><h4 class="subsection">1.1.1 Configuration Support</h4>
198 clock, and auxiliary commands that specify environmental variables
200 </p><span id="Configuration-Commands"></span><h4 class="subsubsection">1.1.1.1 Configuration Commands</h4>
206 class D), or (r) a reference clock address (127.127.x.x).
213 <p>If the Basic Socket Interface Extensions for IPv6 (RFC-2553)
229 with the exception of reference clock addresses,
233 <code>-4</code>
237 <code>-6</code>
254 either a DNS name or an IP address in dotted-quad notation.
265 In this mode the local clock can synchronized to the
267 the local clock.
272 radio clock.
273 In this mode the local clock can synchronized to the
275 the local clock.
283 persistent symmetric-active mode association with the specified
285 In this mode the local clock can be synchronized to
287 clock.
381 <code>-q</code>
436 It specifies the time-to-live
450 Versions 1-4 are the choices, with version 4 the
469 <span id="Auxiliary-Commands"></span><h4 class="subsubsection">1.1.1.2 Auxiliary Commands</h4>
481 server and client should operate using symmetric-key or public-key
495 and client should operate using symmetric-key or public-key
509 both the server and client should operate using symmetric-key or
510 public-key authentication as described in
516 we attempt to register with the mDNS system.
530 <span id="Authentication-Support"></span><div class="header">
532 Next: <a href="#Monitoring-Support" accesskey="n" rel="next">Monitoring Support</a>, Previous: <a href="#Configuration-Support" accesskey="p" rel="prev">Configuration Support</a>, Up: <a href="#ntp_002econf-Notes" accesskey="u" rel="up">ntp.conf Notes</a> </p>
534 <span id="Authentication-Support-1"></span><h4 class="subsection">1.1.2 Authentication Support</h4>
539 specification RFC-1305 defines a scheme which provides
544 DES-CBC.
546 5 (MD5) algorithm using a private key, commonly called keyed-MD5.
547 Either algorithm computes a message digest, or one-way hash, which
638 disrupt system timekeeping.
651 <a href="#Automatic-NTP-Configuration-Options">Automatic NTP Configuration Options</a>
668 </p><span id="Symmetric_002dKey-Cryptography"></span><h4 class="subsubsection">1.1.2.1 Symmetric-Key Cryptography</h4>
669 <p>The original RFC-1305 specification allows any one of possibly
670 65,535 keys, each distinguished by a 32-bit key identifier, to
716 </p><span id="Public-Key-Cryptography"></span><h4 class="subsubsection">1.1.2.2 Public Key Cryptography</h4>
718 described in RFC-1305 and in addition the Autokey protocol,
736 All modes use in addition a variant of the S-KEY scheme,
737 in which a pseudo-random key list is generated and used
747 <code>ntp-keygen(1ntpkeygenmdoc)</code>
777 </p><span id="Naming-and-Addressing"></span><h4 class="subsubsection">1.1.2.3 Naming and Addressing</h4>
791 system call or equivalent in other systems.
792 By the system design
877 Bob sends Cathy a thing called a crypto-NAK, which tells her
887 If all comes out okay, Denise and Bob continue as described above.
898 </p><span id="Key-Management"></span><h4 class="subsubsection">1.1.2.5 Key Management</h4>
901 <code>ntp-keygen(1ntpkeygenmdoc)</code>
933 </p><span id="Authentication-Commands"></span><h4 class="subsubsection">1.1.2.6 Authentication Commands</h4>
950 protocol defined in RFC-1305.
1033 <code>-k</code>
1055 <dd><p>Specifies the interval between re-randomization of certain
1059 deflect brute-force attacks on the algorithms of the scheme;
1080 arguments are 32-bit unsigned
1084 <span id="Error-Codes"></span><h4 class="subsubsection">1.1.2.7 Error Codes</h4>
1095 This could be due to a replay or a server clock time step.
1151 <span id="Monitoring-Support"></span><div class="header">
1153 Next: <a href="#Access-Control-Support" accesskey="n" rel="next">Access Control Support</a>, Previous: <a href="#Authentication-Support" accesskey="p" rel="prev">Authentication Support</a>, Up: <a href="#ntp_002econf-Notes" accesskey="u" rel="up">ntp.conf Notes</a> </p>
1155 <span id="Monitoring-Support-1"></span><h4 class="subsection">1.1.3 Monitoring Support</h4>
1175 </p><span id="Monitoring-Commands"></span><h4 class="subsubsection">1.1.3.1 Monitoring Commands</h4>
1184 <dd><p>Enables recording of clock driver statistics information.
1186 received from a clock driver appends a line of the following form to
1194 clock address in dotted-quad notation.
1196 timecode received from the clock in decoded ASCII format, where
1198 In some clock drivers a good deal of additional information
1201 clock for further details.
1215 address in dotted-quad notation, The final message field includes the
1224 update of the local clock outputs a line of the following form to
1232 show time offset (seconds), frequency offset (parts per million -
1233 PPM), RMS jitter (seconds), Allan deviation (PPM) and clock
1245 </p><pre class="verbatim">48773 10847.650 127.127.4.1 9714 -0.001605376 0.000000000 0.001424877 0.000958674
1250 show the peer address in dotted-quad notation and status,
1258 <dd><p>Enables recording of raw-timestamp statistics information.
1263 received from a peer or clock driver appends a line of the
1271 show the remote peer or clock address followed by the local address
1272 in dotted-quad notation.
1294 <dd><p>Time in hours since the system was last rebooted.
1377 server, usually specified as a compile-time constant.
1449 is a 4-digit year number (e.g., 1992).
1462 The term week is defined by computing day-of-year
1466 filename base: A dot, a 4-digit year number, the letter
1468 and a 2-digit week number.
1476 file name suffix consists of a dot, a 4-digit year number, and
1477 a 2-digit month.
1490 and an 8-digit number.
1492 running at the start of the corresponding 24-hour period.
1532 <span id="Access-Control-Support"></span><div class="header">
1534 Next: <a href="#Automatic-NTP-Configuration-Options" accesskey="n" rel="next">Automatic NTP Configuration Options</a>, Previous: <a href="#Monitoring-Support" accesskey="p" rel="prev">Monitoring Support</a>, Up: <a href="#ntp_002econf-Notes" accesskey="u" rel="up">ntp.conf Notes</a> </p>
1536 <span id="Access-Control-Support-1"></span><h4 class="subsection">1.1.4 Access Control Support</h4>
1585 </p><span id="The-Kiss_002dof_002dDeath-Packet"></span><h4 class="subsubsection">1.1.4.1 The Kiss-of-Death Packet</h4>
1591 for the system operator.
1593 for this purpose called the "kiss-of-death" (KoD) packet.
1595 to zero and the reference identifier field set to a four-byte
1618 happens automatically at the client when the association times out.
1620 </p><span id="Access-Control-Commands"></span><h4 class="subsubsection">1.1.4.2 Access Control Commands</h4>
1635 and a kiss-o’-death packet returned if enabled.
1681 where a value of -1 means "unlimited", the current default.
1696 restrict informational queries and attempts to do run-time
1709 <dd><p>If this flag is set when a rate violation occurs, a kiss-o’-death
1751 to become the default in ntp-4.4.
1847 <dd><p>Remove a previously-set restriction. This is useful for
1861 <span id="Automatic-NTP-Configuration-Options"></span><div class="header">
1863 Next: <a href="#Reference-Clock-Support" accesskey="n" rel="next">Reference Clock Support</a>, Previous: <a href="#Access-Control-Support" accesskey="p" rel="prev">Access Control Support</a>, Up: <a href="#ntp_002econf-Notes" accesskey="u" rel="up">ntp.conf Notes</a> </p>
1865 <span id="Automatic-NTP-Configuration-Options-1"></span><h4 class="subsection">1.1.5 Automatic NTP Configuration Options</h4>
1880 with the anycast paradigm described in RFC-1546,
1912 and minimum feasible time-to-live (TTL) hops, depending
1939 in burst mode in order to reliably set the host clock
1942 in a volley of eight client/server at 2-s intervals
1955 and the effects of implosion due to near-simultaneous
1964 normally eight times the system poll interval,
1965 which starts out at the
1995 survivors in order to synchronize the clock.
2025 it the system poll interval.
2122 will time out the corresponding association and
2123 re-associate accordingly.
2131 <code>-q</code>
2139 <code>-q</code>.
2142 the rascals, sets the clock and then departs.
2146 </p><span id="Manycast-Interactions-with-Autokey"></span><h4 class="subsubsection">1.1.5.2 Manycast Interactions with Autokey</h4>
2176 </p><span id="Broadcast-Options"></span><h4 class="subsubsection">1.1.5.3 Broadcast Options</h4>
2193 <span id="Manycast-Options"></span><h4 class="subsubsection">1.1.5.4 Manycast Options</h4>
2196 <dd><p>This command affects the clock selection and clustering
2199 quantity of peers used to synchronize the system clock
2232 <dd><p>The clustering algorithm repeatedly casts out outlier
2242 to the clock selection algorithm in order to produce
2244 If fewer than this number are available, the clock is
2260 in an expanding-ring search.
2266 <span id="Reference-Clock-Support"></span><div class="header">
2268 Next: <a href="#Miscellaneous-Options" accesskey="n" rel="next">Miscellaneous Options</a>, Previous: <a href="#Automatic-NTP-Configuration-Options" accesskey="p" rel="prev">Automatic NTP Configuration Options</a>, Up: <a href="#ntp_002econf-Notes" accesskey="u" rel="up">ntp.conf Notes</a> </p>
2270 <span id="Reference-Clock-Support-1"></span><h4 class="subsection">1.1.6 Reference Clock Support</h4>
2272 satellite and modem reference clocks plus a special pseudo-clock
2273 used for backup or when no other clock source is available.
2276 "Reference Clock Drivers"
2283 "Debugging Hints for Reference Clock Drivers"
2285 "How To Write a Reference Clock Driver"
2292 "Pulse-per-second (PPS) Signal Interfacing"
2308 <p>A reference clock will generally (though not always) be a radio
2315 device driver specific to each reference clock must be selected and
2319 configure a reference clock when the driver has not been compiled
2321 in a scalding remark to the system log file, but is otherwise non
2332 Reference clock addresses are of the form
2337 denoting the clock type and
2340 number in the range 0-3.
2348 clock, where the
2351 is the clock address.
2357 options are not used for reference clock support.
2360 option is added for reference clock support, as
2365 persuade the server to cherish a reference clock with somewhat more
2379 meaning only for selected clock drivers.
2380 See the individual clock
2386 information for individual clock drivers and normally follows
2392 argument specifies the clock address.
2400 device-dependent time offsets and four flags that can be included
2405 <p>The stratum number of a reference clock is by default zero.
2412 specify the reference clock stratum as greater than zero.
2417 involving both a reference clock and a pulse-per-second (PPS)
2418 discipline signal, it is useful to specify the reference clock
2424 these options apply to all clock drivers.
2425 </p><span id="Reference-Clock-Commands"></span><h4 class="subsubsection">1.1.6.1 Reference Clock Commands</h4>
2433 <dd><p>Marks the reference clock as preferred.
2447 device-specific fashion.
2456 for reference clock messages, as a power of 2 in seconds
2487 the driver, a fixed-point decimal number in seconds.
2490 particular clock to agree with an external standard, such as a
2493 systematic error or bias due to serial port or operating system
2499 for an individual system and driver is available, an approximate
2502 radio clock or PPS signal is supported, a special calibration
2507 <a href="#Miscellaneous-Options">Miscellaneous Options</a>
2509 "Reference Clock Drivers"
2516 <dd><p>Specifies a fixed-point decimal number in seconds, which is
2517 interpreted in a driver-dependent way.
2520 "Reference Clock Drivers"
2541 device-specific fashion.
2551 <dd><p>These four flags are used for customizing the clock driver.
2554 is a function of the particular clock driver.
2573 <span id="Miscellaneous-Options"></span><div class="header">
2575 Next: <a href="#ntp_002econf-Files" accesskey="n" rel="next">ntp.conf Files</a>, Previous: <a href="#Reference-Clock-Support" accesskey="p" rel="prev">Reference Clock Support</a>, Up: <a href="#ntp_002econf-Notes" accesskey="u" rel="up">ntp.conf Notes</a> </p>
2577 <span id="Miscellaneous-Options-1"></span><h4 class="subsection">1.1.7 Miscellaneous Options</h4>
2597 record the frequency of the local clock oscillator.
2600 <code>-f</code>
2613 in parts-per-million (PPM).
2620 drift file is located in, and that file system links, symbolic or
2625 a 6-bit code.
2668 <dd><p>Enables processing of NTP mode 7 implementation-specific requests
2705 receives a crypto-NAK packet that
2710 a properly forged and appropriately delivered crypto-NAK packet
2756 receives a crypto-NAK packet that
2761 a properly forged and appropriately delivered crypto-NAK packet
2834 <code>-I</code>,
2835 <code>--interface</code>,
2836 <code>-L</code>,
2838 <code>--novirtualips</code>
2839 command-line options are specified in the configuration file,
2851 <code>https://hpiers.obspm.fr/iers/bul/bulc/ntp/leap-seconds.list</code>
2853 <code>ftp://hpiers.obspm.fr/iers/bul/bulc/ntp/leap-seconds.list</code>.
2868 <code>update-leap(1update_leapmdoc)</code>
2877 <code>--enable-leap-smear</code>
2884 .Sy DO NOT USE THIS OPTION ON PUBLIC-ACCESS SERVERS!
2889 the system
2901 ‘-’,
2909 ‘-’
2915 (<code>clock</code>, <code>peer</code>, <code>sys</code> and <code>sync</code>).
2943 and the major system events.
2948 <p>This configuration will list all clock information and
2951 peers, system events and so on is suppressed.
2955 be used instead of the default system
2959 <code>-l</code>
3022 (frequency file) will be written, with a default value of 1e-7 (0.1 PPM).
3035 or the JJY driver (type 40, mode 100 - 180).
3039 For the JJY driver (type 40 mode 100 - 180), the argument is
3053 The next two numbers must be between 0 and one-half of the poll interval,
3077 <code>-i</code>
3079 The default is 32 megabytes on non-Linux machines, and -1 under Linux.
3080 -1 means "do not lock the process into memory".
3091 Defaults to the system default.
3113 <code>config-from-file</code>
3130 <code>saveconfig\ ntp-%Y%m%d-%H%M%S.conf</code>.
3131 The filename used is stored in the system variable
3136 <dd><p>This command adds an additional system variable.
3145 variable will be listed as part of the default system variables
3160 the names of all system variables.
3166 holds the names of the reference clock variables.
3175 <dd><p>This command can be used to alter several system variables in
3196 intercept, which is a parameter of the PLL/FLL clock discipline
3207 parts-per-million.
3213 huff-n’-puff filter span, which determines the most recent interval
3224 the panic sanity check is disabled and a clock offset of any value will
3238 <dd><p>The argument is the step threshold for the backward direction,
3246 each direction of step threshold are either
3250 <dd><p>As for stepback, but for the forward direction.
3266 system variables
3291 mode these values are used in-turn in an expanding-ring search.
3305 an expanding-ring search.
3312 using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntp.conf</code> program.
3316 <tr><td align="left" valign="top">• <a href="#ntp_002econf-Files" accesskey="1">ntp.conf Files</a></td><td> </td><td align="left" valign="top">Files
3318 <tr><td align="left" valign="top">• <a href="#ntp_002econf-See-Also" accesskey="2">ntp.conf See Also</a></td><td> </td><td align="left" valign="top">See Also
3320 <tr><td align="left" valign="top">• <a href="#ntp_002econf-Bugs" accesskey="3">ntp.conf Bugs</a></td><td> </td><td align="left" valign="top">Bugs
3322 <tr><td align="left" valign="top">• <a href="#ntp_002econf-Notes" accesskey="4">ntp.conf Notes</a></td><td> </td><td align="left" valign="top">Notes
3327 <span id="ntp_002econf-Files"></span><div class="header">
3329 Next: <a href="#ntp_002econf-See-Also" accesskey="n" rel="next">ntp.conf See Also</a>, Previous: <a href="#Miscellaneous-Options" accesskey="p" rel="prev">Miscellaneous Options</a>, Up: <a href="#ntp_002econf-Notes" accesskey="u" rel="up">ntp.conf Notes</a> </p>
3331 <span id="ntp_002econf-Files-1"></span><h4 class="subsection">1.1.8 ntp.conf Files</h4>
3346 <dd><p>Diffie-Hellman agreement parameters
3350 <span id="ntp_002econf-See-Also"></span><div class="header">
3352 Next: <a href="#ntp_002econf-Bugs" accesskey="n" rel="next">ntp.conf Bugs</a>, Previous: <a href="#ntp_002econf-Files" accesskey="p" rel="prev">ntp.conf Files</a>, Up: <a href="#ntp_002econf-Notes" accesskey="u" rel="up">ntp.conf Notes</a> </p>
3354 <span id="ntp_002econf-See-Also-1"></span><h4 class="subsection">1.1.9 ntp.conf See Also</h4>
3370 <span id="ntp_002econf-Bugs"></span><div class="header">
3372 Previous: <a href="#ntp_002econf-See-Also" accesskey="p" rel="prev">ntp.conf See Also</a>, Up: <a href="#ntp_002econf-Notes" accesskey="u" rel="up">ntp.conf Notes</a> </p>
3374 <span id="ntp_002econf-Bugs-1"></span><h4 class="subsection">1.1.10 ntp.conf Bugs</h4>
3390 <span id="ntp_002econf-Notes-1"></span><h4 class="subsection">1.1.11 ntp.conf Notes</h4>