diff options
Diffstat (limited to 'ntpd/ntpd.html')
| -rw-r--r-- | ntpd/ntpd.html | 76 |
1 files changed, 50 insertions, 26 deletions
diff --git a/ntpd/ntpd.html b/ntpd/ntpd.html index 25b6caa..8919ee9 100644 --- a/ntpd/ntpd.html +++ b/ntpd/ntpd.html @@ -39,7 +39,7 @@ The program can operate in any of several modes, including client/server, symmetric and broadcast modes, and with both symmetric-key and public-key cryptography. - <p>This document applies to version 4.2.7p482 of <code>ntpd</code>. + <p>This document applies to version 4.2.8p2 of <code>ntpd</code>. <ul class="menu"> <li><a accesskey="1" href="#ntpd-Description">ntpd Description</a>: Description @@ -169,7 +169,8 @@ This software is released under the NTP license, <http://ntp.org/license>. <li><a accesskey="6" href="#ntpd-configfile">ntpd configfile</a>: configfile option (-c) <li><a accesskey="7" href="#ntpd-driftfile">ntpd driftfile</a>: driftfile option (-f) <li><a accesskey="8" href="#ntpd-panicgate">ntpd panicgate</a>: panicgate option (-g) -<li><a accesskey="9" href="#ntpd-jaildir">ntpd jaildir</a>: jaildir option (-i) +<li><a accesskey="9" href="#ntpd-force_002dstep_002donce">ntpd force-step-once</a>: force-step-once option (-G) +<li><a href="#ntpd-jaildir">ntpd jaildir</a>: jaildir option (-i) <li><a href="#ntpd-interface">ntpd interface</a>: interface option (-I) <li><a href="#ntpd-keyfile">ntpd keyfile</a>: keyfile option (-k) <li><a href="#ntpd-logfile">ntpd logfile</a>: logfile option (-l) @@ -219,7 +220,7 @@ the usage text by passing it through a pager program. 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.7p481 +<pre class="example">ntpd - NTP daemon program - Ver. 4.2.8p2-RC3 Usage: ntpd [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \ [ <server1> ... <serverN> ] Flg Arg Option-Name Description @@ -240,6 +241,7 @@ Usage: ntpd [ -<flag> [<val>] | --<name>[{=| }<val>] ]. -f Str driftfile frequency drift file name -g no panicgate Allow the first adjustment to be Big - may appear multiple times + -G no force-step-once Step any initial offset correction. -i Str jaildir Jail directory -I Str interface Listen on an interface name or address - may appear multiple times @@ -413,7 +415,7 @@ configuration specification in the file. <div class="node"> <p><hr> -<a name="ntpd-panicgate"></a>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-force_002dstep_002donce">ntpd force-step-once</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> @@ -443,15 +445,37 @@ See the configuration file directive for other options. <div class="node"> <p><hr> -<a name="ntpd-jaildir"></a>Next: <a rel="next" accesskey="n" href="#ntpd-interface">ntpd interface</a>, +<a name="ntpd-force_002dstep_002donce"></a>Next: <a rel="next" accesskey="n" href="#ntpd-jaildir">ntpd jaildir</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">force-step-once option (-G)</h4> + +<p><a name="index-ntpd_002dforce_002dstep_002donce-11"></a> +This is the “step any initial offset correction.” option. +Normally, +<code>ntpd</code> +steps the time if the time offset exceeds the step threshold, +which is 128 ms by default, and otherwise slews the time. +This option forces the initial offset correction to be stepped, +so the highest time accuracy can be achieved quickly. +However, this may also cause the time to be stepped back +so this option must not be used if +applications requiring monotonic time are running. +See the <code>tinker</code> configuration file directive for other options. +<div class="node"> +<p><hr> +<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-force_002dstep_002donce">ntpd force-step-once</a>, +Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> +<br> +</div> + <h4 class="subsection">jaildir option (-i)</h4> -<p><a name="index-ntpd_002djaildir-11"></a> +<p><a name="index-ntpd_002djaildir-12"></a> This is the “jail directory” option. This option takes a string argument. @@ -482,7 +506,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">interface option (-I)</h4> -<p><a name="index-ntpd_002dinterface-12"></a> +<p><a name="index-ntpd_002dinterface-13"></a> This is the “listen on an interface name or address” option. This option takes a string argument <span class="file">iface</span>. @@ -506,7 +530,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">keyfile option (-k)</h4> -<p><a name="index-ntpd_002dkeyfile-13"></a> +<p><a name="index-ntpd_002dkeyfile-14"></a> This is the “path to symmetric keys” option. This option takes a string argument. Specify the name and path of the symmetric key file. @@ -525,7 +549,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">logfile option (-l)</h4> -<p><a name="index-ntpd_002dlogfile-14"></a> +<p><a name="index-ntpd_002dlogfile-15"></a> This is the “path to the log file” option. This option takes a string argument. Specify the name and path of the log file. @@ -543,7 +567,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">novirtualips option (-L)</h4> -<p><a name="index-ntpd_002dnovirtualips-15"></a> +<p><a name="index-ntpd_002dnovirtualips-16"></a> This is the “do not listen to virtual interfaces” option. Do not listen to virtual interfaces, defined as those with names containing a colon. This option is deprecated. Please @@ -559,7 +583,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">modifymmtimer option (-M)</h4> -<p><a name="index-ntpd_002dmodifymmtimer-16"></a> +<p><a name="index-ntpd_002dmodifymmtimer-17"></a> This is the “modify multimedia timer (windows only)” option. <p class="noindent">This option has some usage constraints. It: @@ -580,7 +604,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">nice option (-N)</h4> -<p><a name="index-ntpd_002dnice-17"></a> +<p><a name="index-ntpd_002dnice-18"></a> This is the “run at high priority” option. To the extent permitted by the operating system, run <code>ntpd</code> @@ -595,7 +619,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">pidfile option (-p)</h4> -<p><a name="index-ntpd_002dpidfile-18"></a> +<p><a name="index-ntpd_002dpidfile-19"></a> This is the “path to the pid file” option. This option takes a string argument. Specify the name and path of the file used to record @@ -614,7 +638,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">priority option (-P)</h4> -<p><a name="index-ntpd_002dpriority-19"></a> +<p><a name="index-ntpd_002dpriority-20"></a> This is the “process priority” option. This option takes a number argument. To the extent permitted by the operating system, run @@ -632,7 +656,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">quit option (-q)</h4> -<p><a name="index-ntpd_002dquit-20"></a> +<p><a name="index-ntpd_002dquit-21"></a> This is the “set the time and quit” option. <p class="noindent">This option has some usage constraints. It: @@ -662,7 +686,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">propagationdelay option (-r)</h4> -<p><a name="index-ntpd_002dpropagationdelay-21"></a> +<p><a name="index-ntpd_002dpropagationdelay-22"></a> This is the “broadcast/propagation delay” option. This option takes a string argument. Specify the default propagation delay from the broadcast/multicast server to this client. This is necessary only if the delay cannot be computed automatically by the protocol. @@ -676,7 +700,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">saveconfigquit option</h4> -<p><a name="index-ntpd_002dsaveconfigquit-22"></a> +<p><a name="index-ntpd_002dsaveconfigquit-23"></a> This is the “save parsed configuration and quit” option. This option takes a string argument. @@ -700,7 +724,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">statsdir option (-s)</h4> -<p><a name="index-ntpd_002dstatsdir-23"></a> +<p><a name="index-ntpd_002dstatsdir-24"></a> This is the “statistics file location” option. This option takes a string argument. Specify the directory path for files created by the statistics facility. @@ -717,7 +741,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">trustedkey option (-t)</h4> -<p><a name="index-ntpd_002dtrustedkey-24"></a> +<p><a name="index-ntpd_002dtrustedkey-25"></a> This is the “trusted key number” option. This option takes a string argument <span class="file">tkey</span>. @@ -737,7 +761,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">user option (-u)</h4> -<p><a name="index-ntpd_002duser-25"></a> +<p><a name="index-ntpd_002duser-26"></a> This is the “run as userid (or userid:groupid)” option. This option takes a string argument. @@ -762,7 +786,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">updateinterval option (-U)</h4> -<p><a name="index-ntpd_002dupdateinterval-26"></a> +<p><a name="index-ntpd_002dupdateinterval-27"></a> This is the “interval in seconds between scans for new or dropped interfaces” option. This option takes a number argument. Give the time in seconds between two scans for new or dropped interfaces. @@ -779,7 +803,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">wait-sync option (-w)</h4> -<p><a name="index-ntpd_002dwait_002dsync-27"></a> +<p><a name="index-ntpd_002dwait_002dsync-28"></a> This is the “seconds to wait for first clock sync” option. This option takes a number argument. @@ -808,7 +832,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">slew option (-x)</h4> -<p><a name="index-ntpd_002dslew-28"></a> +<p><a name="index-ntpd_002dslew-29"></a> This is the “slew up to 600 seconds” option. Normally, the time is slewed if the offset is less than the step threshold, which is 128 ms by default, and stepped if above the threshold. This option sets the threshold to 600 s, which is well within the accuracy window to set the clock manually. @@ -833,7 +857,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">usepcc option</h4> -<p><a name="index-ntpd_002dusepcc-29"></a> +<p><a name="index-ntpd_002dusepcc-30"></a> This is the “use cpu cycle counter (windows only)” option. <p class="noindent">This option has some usage constraints. It: @@ -855,7 +879,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">pccfreq option</h4> -<p><a name="index-ntpd_002dpccfreq-30"></a> +<p><a name="index-ntpd_002dpccfreq-31"></a> This is the “force cpu cycle counter use (windows only)” option. This option takes a string argument. @@ -877,7 +901,7 @@ Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> <h4 class="subsection">mdns option (-m)</h4> -<p><a name="index-ntpd_002dmdns-31"></a> +<p><a name="index-ntpd_002dmdns-32"></a> This is the “register with mdns as a ntp server” option. <p class="noindent">This option has some usage constraints. It: |