ntpd.html revision 1.1.1.2.2.4
1 1.1.1.2.2.2 snj <html lang="en"> 2 1.1.1.2.2.2 snj <head> 3 1.1.1.2.2.2 snj <title>ntpd: Network Time Protocol (NTP) Daemon User's Manual</title> 4 1.1.1.2.2.2 snj <meta http-equiv="Content-Type" content="text/html"> 5 1.1.1.2.2.2 snj <meta name="description" content="ntpd: Network Time Protocol (NTP) Daemon User's Manual"> 6 1.1.1.2.2.2 snj <meta name="generator" content="makeinfo 4.7"> 7 1.1.1.2.2.2 snj <link title="Top" rel="top" href="#Top"> 8 1.1.1.2.2.2 snj <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> 9 1.1.1.2.2.2 snj <meta http-equiv="Content-Style-Type" content="text/css"> 10 1.1.1.2.2.2 snj <style type="text/css"><!-- 11 1.1.1.2.2.2 snj pre.display { font-family:inherit } 12 1.1.1.2.2.2 snj pre.format { font-family:inherit } 13 1.1.1.2.2.2 snj pre.smalldisplay { font-family:inherit; font-size:smaller } 14 1.1.1.2.2.2 snj pre.smallformat { font-family:inherit; font-size:smaller } 15 1.1.1.2.2.2 snj pre.smallexample { font-size:smaller } 16 1.1.1.2.2.2 snj pre.smalllisp { font-size:smaller } 17 1.1.1.2.2.2 snj span.sc { font-variant:small-caps } 18 1.1.1.2.2.2 snj span.roman { font-family: serif; font-weight: normal; } 19 1.1.1.2.2.2 snj --></style> 20 1.1.1.2.2.2 snj </head> 21 1.1.1.2.2.2 snj <body> 22 1.1.1.2.2.2 snj <h1 class="settitle">ntpd: Network Time Protocol (NTP) Daemon User's Manual</h1> 23 1.1.1.2.2.2 snj <div class="node"> 24 1.1.1.2.2.2 snj <p><hr> 25 1.1.1.2.2.2 snj <a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Description">ntpd Description</a>, 26 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>, 27 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> 28 1.1.1.2.2.2 snj <br> 29 1.1.1.2.2.2 snj </div> 30 1.1.1.2.2.2 snj 31 1.1.1.2.2.2 snj <h2 class="unnumbered">ntpd: Network Time Protocol (NTP) Daemon User Manual</h2> 32 1.1.1.2.2.2 snj 33 1.1.1.2.2.2 snj <p>The <code>ntpd</code> program is an operating system daemon that synchronizes the 34 1.1.1.2.2.2 snj system clock to remote NTP time servers or local reference clocks. 35 1.1.1.2.2.2 snj It is a complete implementation of NTP version 4 defined by RFC-5905, but 36 1.1.1.2.2.2 snj also retains compatible with version 3 defined by RFC-1305 and versions 37 1.1.1.2.2.2 snj 1 and 2, defined by RFC-1059 and RFC-1119, respectively. 38 1.1.1.2.2.2 snj The program can operate in any of several modes, including client/server, 39 1.1.1.2.2.2 snj symmetric and broadcast modes, and with both symmetric-key and public-key 40 1.1.1.2.2.2 snj cryptography. 41 1.1.1.2.2.2 snj 42 1.1.1.2.2.4 snj <p>This document applies to version 4.2.8p7 of <code>ntpd</code>. 43 1.1.1.2.2.2 snj 44 1.1.1.2.2.2 snj <ul class="menu"> 45 1.1.1.2.2.2 snj <li><a accesskey="1" href="#ntpd-Description">ntpd Description</a>: Description 46 1.1.1.2.2.2 snj <li><a accesskey="2" href="#ntpd-Invocation">ntpd Invocation</a>: Invoking ntpd 47 1.1.1.2.2.2 snj <li><a accesskey="3" href="#Usage">Usage</a>: Usage 48 1.1.1.2.2.2 snj </ul> 49 1.1.1.2.2.2 snj 50 1.1.1.2.2.2 snj <div class="node"> 51 1.1.1.2.2.2 snj <p><hr> 52 1.1.1.2.2.2 snj <a name="ntpd-Description"></a> 53 1.1.1.2.2.2 snj <br> 54 1.1.1.2.2.2 snj </div> 55 1.1.1.2.2.2 snj 56 1.1.1.2.2.2 snj <!-- node-name, next, previous, up --> 57 1.1.1.2.2.2 snj <h3 class="section">Description</h3> 58 1.1.1.2.2.2 snj 59 1.1.1.2.2.2 snj <p>The <code>ntpd</code> program ordinarily requires 60 1.1.1.2.2.2 snj a configuration file described at <a href="#ntp_002econf">ntp.conf</a>. 61 1.1.1.2.2.2 snj This configuration file contains configuration commands described on 62 1.1.1.2.2.2 snj the pages listed above. 63 1.1.1.2.2.2 snj However a client can discover remote servers and configure them 64 1.1.1.2.2.2 snj automatically. 65 1.1.1.2.2.2 snj This makes it possible to deploy a fleet of workstations without 66 1.1.1.2.2.2 snj specifying configuration details specific to the local environment. 67 1.1.1.2.2.2 snj 68 1.1.1.2.2.2 snj <p>The <code>ntpd</code> program normally operates continuously while adjusting the 69 1.1.1.2.2.2 snj system time and frequency, but in some cases this might not be 70 1.1.1.2.2.2 snj practical. 71 1.1.1.2.2.2 snj With the <code>-q</code> option <code>ntpd</code> operates as in continuous mode, but 72 1.1.1.2.2.2 snj exits just after setting the clock for the first time. 73 1.1.1.2.2.2 snj Most applications will probably want to specify the <code>iburst</code> 74 1.1.1.2.2.2 snj option with the <code>server</code> command. 75 1.1.1.2.2.2 snj With this option an initial volley of messages is exchanged to 76 1.1.1.2.2.2 snj groom the data and set the clock in about ten seconds' time. 77 1.1.1.2.2.2 snj If nothing is heard after a few minutes' time, 78 1.1.1.2.2.2 snj the daemon times out and exits without setting the clock. 79 1.1.1.2.2.2 snj 80 1.1.1.2.2.2 snj <div class="node"> 81 1.1.1.2.2.2 snj <p><hr> 82 1.1.1.2.2.2 snj <a name="ntpd-Invocation"></a> 83 1.1.1.2.2.2 snj <br> 84 1.1.1.2.2.2 snj </div> 85 1.1.1.2.2.2 snj 86 1.1.1.2.2.2 snj <h3 class="section">Invoking ntpd</h3> 87 1.1.1.2.2.2 snj 88 1.1.1.2.2.2 snj <p><a name="index-ntpd-1"></a><a name="index-NTP-daemon-program-2"></a> 89 1.1.1.2.2.2 snj 90 1.1.1.2.2.2 snj <p>The 91 1.1.1.2.2.2 snj <code>ntpd</code> 92 1.1.1.2.2.2 snj utility is an operating system daemon which sets 93 1.1.1.2.2.2 snj and maintains the system time of day in synchronism with Internet 94 1.1.1.2.2.2 snj standard time servers. 95 1.1.1.2.2.2 snj It is a complete implementation of the 96 1.1.1.2.2.2 snj Network Time Protocol (NTP) version 4, as defined by RFC-5905, 97 1.1.1.2.2.2 snj but also retains compatibility with 98 1.1.1.2.2.2 snj version 3, as defined by RFC-1305, and versions 1 99 1.1.1.2.2.2 snj and 2, as defined by RFC-1059 and RFC-1119, respectively. 100 1.1.1.2.2.2 snj 101 1.1.1.2.2.2 snj <p>The 102 1.1.1.2.2.2 snj <code>ntpd</code> 103 1.1.1.2.2.2 snj utility does most computations in 64-bit floating point 104 1.1.1.2.2.2 snj arithmetic and does relatively clumsy 64-bit fixed point operations 105 1.1.1.2.2.2 snj only when necessary to preserve the ultimate precision, about 232 106 1.1.1.2.2.2 snj picoseconds. 107 1.1.1.2.2.2 snj While the ultimate precision is not achievable with 108 1.1.1.2.2.2 snj ordinary workstations and networks of today, it may be required 109 1.1.1.2.2.2 snj with future gigahertz CPU clocks and gigabit LANs. 110 1.1.1.2.2.2 snj 111 1.1.1.2.2.2 snj <p>Ordinarily, 112 1.1.1.2.2.2 snj <code>ntpd</code> 113 1.1.1.2.2.2 snj reads the 114 1.1.1.2.2.2 snj <code>ntp.conf(5)</code> 115 1.1.1.2.2.2 snj configuration file at startup time in order to determine the 116 1.1.1.2.2.2 snj synchronization sources and operating modes. 117 1.1.1.2.2.2 snj It is also possible to 118 1.1.1.2.2.2 snj specify a working, although limited, configuration entirely on the 119 1.1.1.2.2.2 snj command line, obviating the need for a configuration file. 120 1.1.1.2.2.2 snj This may 121 1.1.1.2.2.2 snj be particularly useful when the local host is to be configured as a 122 1.1.1.2.2.2 snj broadcast/multicast client, with all peers being determined by 123 1.1.1.2.2.2 snj listening to broadcasts at run time. 124 1.1.1.2.2.2 snj 125 1.1.1.2.2.2 snj <p>If NetInfo support is built into 126 1.1.1.2.2.2 snj <code>ntpd</code> 127 1.1.1.2.2.2 snj then 128 1.1.1.2.2.2 snj <code>ntpd</code> 129 1.1.1.2.2.2 snj will attempt to read its configuration from the 130 1.1.1.2.2.2 snj NetInfo if the default 131 1.1.1.2.2.2 snj <code>ntp.conf(5)</code> 132 1.1.1.2.2.2 snj file cannot be read and no file is 133 1.1.1.2.2.2 snj specified by the 134 1.1.1.2.2.2 snj <code>-c</code> 135 1.1.1.2.2.2 snj option. 136 1.1.1.2.2.2 snj 137 1.1.1.2.2.2 snj <p>Various internal 138 1.1.1.2.2.2 snj <code>ntpd</code> 139 1.1.1.2.2.2 snj variables can be displayed and 140 1.1.1.2.2.2 snj configuration options altered while the 141 1.1.1.2.2.2 snj <code>ntpd</code> 142 1.1.1.2.2.2 snj is running 143 1.1.1.2.2.2 snj using the 144 1.1.1.2.2.2 snj <code>ntpq(1ntpqmdoc)</code> 145 1.1.1.2.2.2 snj and 146 1.1.1.2.2.2 snj <code>ntpdc(1ntpdcmdoc)</code> 147 1.1.1.2.2.2 snj utility programs. 148 1.1.1.2.2.2 snj 149 1.1.1.2.2.2 snj <p>When 150 1.1.1.2.2.2 snj <code>ntpd</code> 151 1.1.1.2.2.2 snj starts it looks at the value of 152 1.1.1.2.2.2 snj <code>umask(2)</code>, 153 1.1.1.2.2.2 snj and if zero 154 1.1.1.2.2.2 snj <code>ntpd</code> 155 1.1.1.2.2.2 snj will set the 156 1.1.1.2.2.2 snj <code>umask(2)</code> 157 1.1.1.2.2.2 snj to 022. 158 1.1.1.2.2.2 snj 159 1.1.1.2.2.2 snj <p>This section was generated by <strong>AutoGen</strong>, 160 1.1.1.2.2.2 snj using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntpd</code> program. 161 1.1.1.2.2.2 snj This software is released under the NTP license, <http://ntp.org/license>;. 162 1.1.1.2.2.2 snj 163 1.1.1.2.2.2 snj <ul class="menu"> 164 1.1.1.2.2.2 snj <li><a accesskey="1" href="#ntpd-usage">ntpd usage</a>: ntpd help/usage (<span class="option">--help</span>) 165 1.1.1.2.2.2 snj <li><a accesskey="2" href="#ntpd-ipv4">ntpd ipv4</a>: ipv4 option (-4) 166 1.1.1.2.2.2 snj <li><a accesskey="3" href="#ntpd-ipv6">ntpd ipv6</a>: ipv6 option (-6) 167 1.1.1.2.2.2 snj <li><a accesskey="4" href="#ntpd-authreq">ntpd authreq</a>: authreq option (-a) 168 1.1.1.2.2.2 snj <li><a accesskey="5" href="#ntpd-authnoreq">ntpd authnoreq</a>: authnoreq option (-A) 169 1.1.1.2.2.2 snj <li><a accesskey="6" href="#ntpd-configfile">ntpd configfile</a>: configfile option (-c) 170 1.1.1.2.2.2 snj <li><a accesskey="7" href="#ntpd-driftfile">ntpd driftfile</a>: driftfile option (-f) 171 1.1.1.2.2.2 snj <li><a accesskey="8" href="#ntpd-panicgate">ntpd panicgate</a>: panicgate option (-g) 172 1.1.1.2.2.3 snj <li><a accesskey="9" href="#ntpd-force_002dstep_002donce">ntpd force-step-once</a>: force-step-once option (-G) 173 1.1.1.2.2.3 snj <li><a href="#ntpd-jaildir">ntpd jaildir</a>: jaildir option (-i) 174 1.1.1.2.2.2 snj <li><a href="#ntpd-interface">ntpd interface</a>: interface option (-I) 175 1.1.1.2.2.2 snj <li><a href="#ntpd-keyfile">ntpd keyfile</a>: keyfile option (-k) 176 1.1.1.2.2.2 snj <li><a href="#ntpd-logfile">ntpd logfile</a>: logfile option (-l) 177 1.1.1.2.2.2 snj <li><a href="#ntpd-novirtualips">ntpd novirtualips</a>: novirtualips option (-L) 178 1.1.1.2.2.2 snj <li><a href="#ntpd-modifymmtimer">ntpd modifymmtimer</a>: modifymmtimer option (-M) 179 1.1.1.2.2.2 snj <li><a href="#ntpd-nice">ntpd nice</a>: nice option (-N) 180 1.1.1.2.2.2 snj <li><a href="#ntpd-pidfile">ntpd pidfile</a>: pidfile option (-p) 181 1.1.1.2.2.2 snj <li><a href="#ntpd-priority">ntpd priority</a>: priority option (-P) 182 1.1.1.2.2.2 snj <li><a href="#ntpd-quit">ntpd quit</a>: quit option (-q) 183 1.1.1.2.2.2 snj <li><a href="#ntpd-propagationdelay">ntpd propagationdelay</a>: propagationdelay option (-r) 184 1.1.1.2.2.2 snj <li><a href="#ntpd-saveconfigquit">ntpd saveconfigquit</a>: saveconfigquit option 185 1.1.1.2.2.2 snj <li><a href="#ntpd-statsdir">ntpd statsdir</a>: statsdir option (-s) 186 1.1.1.2.2.2 snj <li><a href="#ntpd-trustedkey">ntpd trustedkey</a>: trustedkey option (-t) 187 1.1.1.2.2.2 snj <li><a href="#ntpd-user">ntpd user</a>: user option (-u) 188 1.1.1.2.2.2 snj <li><a href="#ntpd-updateinterval">ntpd updateinterval</a>: updateinterval option (-U) 189 1.1.1.2.2.2 snj <li><a href="#ntpd-wait_002dsync">ntpd wait-sync</a>: wait-sync option (-w) 190 1.1.1.2.2.2 snj <li><a href="#ntpd-slew">ntpd slew</a>: slew option (-x) 191 1.1.1.2.2.2 snj <li><a href="#ntpd-usepcc">ntpd usepcc</a>: usepcc option 192 1.1.1.2.2.2 snj <li><a href="#ntpd-pccfreq">ntpd pccfreq</a>: pccfreq option 193 1.1.1.2.2.2 snj <li><a href="#ntpd-mdns">ntpd mdns</a>: mdns option (-m) 194 1.1.1.2.2.2 snj <li><a href="#ntpd-config">ntpd config</a>: presetting/configuring ntpd 195 1.1.1.2.2.2 snj <li><a href="#ntpd-exit-status">ntpd exit status</a>: exit status 196 1.1.1.2.2.2 snj <li><a href="#ntpd-Usage">ntpd Usage</a>: Usage 197 1.1.1.2.2.2 snj <li><a href="#ntpd-Files">ntpd Files</a>: Files 198 1.1.1.2.2.2 snj <li><a href="#ntpd-See-Also">ntpd See Also</a>: See Also 199 1.1.1.2.2.2 snj <li><a href="#ntpd-Bugs">ntpd Bugs</a>: Bugs 200 1.1.1.2.2.2 snj <li><a href="#ntpd-Notes">ntpd Notes</a>: Notes 201 1.1.1.2.2.2 snj </ul> 202 1.1.1.2.2.2 snj 203 1.1.1.2.2.2 snj <div class="node"> 204 1.1.1.2.2.2 snj <p><hr> 205 1.1.1.2.2.2 snj <a name="ntpd-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpd-ipv4">ntpd ipv4</a>, 206 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 207 1.1.1.2.2.2 snj <br> 208 1.1.1.2.2.2 snj </div> 209 1.1.1.2.2.2 snj 210 1.1.1.2.2.2 snj <h4 class="subsection">ntpd help/usage (<span class="option">--help</span>)</h4> 211 1.1.1.2.2.2 snj 212 1.1.1.2.2.2 snj <p><a name="index-ntpd-help-3"></a> 213 1.1.1.2.2.2 snj This is the automatically generated usage text for ntpd. 214 1.1.1.2.2.2 snj 215 1.1.1.2.2.2 snj <p>The text printed is the same whether selected with the <code>help</code> option 216 1.1.1.2.2.2 snj (<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print 217 1.1.1.2.2.2 snj the usage text by passing it through a pager program. 218 1.1.1.2.2.2 snj <code>more-help</code> is disabled on platforms without a working 219 1.1.1.2.2.2 snj <code>fork(2)</code> function. The <code>PAGER</code> environment variable is 220 1.1.1.2.2.2 snj used to select the program, defaulting to <span class="file">more</span>. Both will exit 221 1.1.1.2.2.2 snj with a status code of 0. 222 1.1.1.2.2.2 snj 223 1.1.1.2.2.4 snj <pre class="example">ntpd - NTP daemon program - Ver. 4.2.8p6 224 1.1.1.2.2.2 snj Usage: ntpd [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \ 225 1.1.1.2.2.2 snj [ <server1> ... <serverN> ] 226 1.1.1.2.2.2 snj Flg Arg Option-Name Description 227 1.1.1.2.2.2 snj -4 no ipv4 Force IPv4 DNS name resolution 228 1.1.1.2.2.2 snj - prohibits the option 'ipv6' 229 1.1.1.2.2.2 snj -6 no ipv6 Force IPv6 DNS name resolution 230 1.1.1.2.2.2 snj - prohibits the option 'ipv4' 231 1.1.1.2.2.2 snj -a no authreq Require crypto authentication 232 1.1.1.2.2.2 snj - prohibits the option 'authnoreq' 233 1.1.1.2.2.2 snj -A no authnoreq Do not require crypto authentication 234 1.1.1.2.2.2 snj - prohibits the option 'authreq' 235 1.1.1.2.2.2 snj -b no bcastsync Allow us to sync to broadcast servers 236 1.1.1.2.2.2 snj -c Str configfile configuration file name 237 1.1.1.2.2.2 snj -d no debug-level Increase debug verbosity level 238 1.1.1.2.2.2 snj - may appear multiple times 239 1.1.1.2.2.2 snj -D Num set-debug-level Set the debug verbosity level 240 1.1.1.2.2.2 snj - may appear multiple times 241 1.1.1.2.2.2 snj -f Str driftfile frequency drift file name 242 1.1.1.2.2.2 snj -g no panicgate Allow the first adjustment to be Big 243 1.1.1.2.2.2 snj - may appear multiple times 244 1.1.1.2.2.3 snj -G no force-step-once Step any initial offset correction. 245 1.1.1.2.2.2 snj -i Str jaildir Jail directory 246 1.1.1.2.2.2 snj -I Str interface Listen on an interface name or address 247 1.1.1.2.2.2 snj - may appear multiple times 248 1.1.1.2.2.2 snj -k Str keyfile path to symmetric keys 249 1.1.1.2.2.2 snj -l Str logfile path to the log file 250 1.1.1.2.2.2 snj -L no novirtualips Do not listen to virtual interfaces 251 1.1.1.2.2.2 snj -n no nofork Do not fork 252 1.1.1.2.2.2 snj - prohibits the option 'wait-sync' 253 1.1.1.2.2.2 snj -N no nice Run at high priority 254 1.1.1.2.2.2 snj -p Str pidfile path to the PID file 255 1.1.1.2.2.2 snj -P Num priority Process priority 256 1.1.1.2.2.2 snj -q no quit Set the time and quit 257 1.1.1.2.2.2 snj - prohibits these options: 258 1.1.1.2.2.2 snj saveconfigquit 259 1.1.1.2.2.2 snj wait-sync 260 1.1.1.2.2.2 snj -r Str propagationdelay Broadcast/propagation delay 261 1.1.1.2.2.2 snj Str saveconfigquit Save parsed configuration and quit 262 1.1.1.2.2.2 snj - prohibits these options: 263 1.1.1.2.2.2 snj quit 264 1.1.1.2.2.2 snj wait-sync 265 1.1.1.2.2.2 snj -s Str statsdir Statistics file location 266 1.1.1.2.2.2 snj -t Str trustedkey Trusted key number 267 1.1.1.2.2.2 snj - may appear multiple times 268 1.1.1.2.2.2 snj -u Str user Run as userid (or userid:groupid) 269 1.1.1.2.2.2 snj -U Num updateinterval interval in seconds between scans for new or dropped interfaces 270 1.1.1.2.2.2 snj Str var make ARG an ntp variable (RW) 271 1.1.1.2.2.2 snj - may appear multiple times 272 1.1.1.2.2.2 snj Str dvar make ARG an ntp variable (RW|DEF) 273 1.1.1.2.2.2 snj - may appear multiple times 274 1.1.1.2.2.2 snj -w Num wait-sync Seconds to wait for first clock sync 275 1.1.1.2.2.2 snj - prohibits these options: 276 1.1.1.2.2.2 snj nofork 277 1.1.1.2.2.2 snj quit 278 1.1.1.2.2.2 snj saveconfigquit 279 1.1.1.2.2.2 snj -x no slew Slew up to 600 seconds 280 1.1.1.2.2.2 snj opt version output version information and exit 281 1.1.1.2.2.2 snj -? no help display extended usage information and exit 282 1.1.1.2.2.2 snj -! no more-help extended usage information passed thru pager 283 1.1.1.2.2.2 snj 284 1.1.1.2.2.2 snj Options are specified by doubled hyphens and their name or by a single 285 1.1.1.2.2.2 snj hyphen and the flag character. 286 1.1.1.2.2.2 snj 287 1.1.1.2.2.2 snj 288 1.1.1.2.2.2 snj The following option preset mechanisms are supported: 289 1.1.1.2.2.2 snj - examining environment variables named NTPD_* 290 1.1.1.2.2.2 snj 291 1.1.1.2.2.2 snj Please send bug reports to: <http://bugs.ntp.org, bugs (a] ntp.org> 292 1.1.1.2.2.2 snj </pre> 293 1.1.1.2.2.2 snj <div class="node"> 294 1.1.1.2.2.2 snj <p><hr> 295 1.1.1.2.2.2 snj <a name="ntpd-ipv4"></a>Next: <a rel="next" accesskey="n" href="#ntpd-ipv6">ntpd ipv6</a>, 296 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-usage">ntpd usage</a>, 297 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 298 1.1.1.2.2.2 snj <br> 299 1.1.1.2.2.2 snj </div> 300 1.1.1.2.2.2 snj 301 1.1.1.2.2.2 snj <h4 class="subsection">ipv4 option (-4)</h4> 302 1.1.1.2.2.2 snj 303 1.1.1.2.2.2 snj <p><a name="index-ntpd_002dipv4-4"></a> 304 1.1.1.2.2.2 snj This is the “force ipv4 dns name resolution” option. 305 1.1.1.2.2.2 snj 306 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 307 1.1.1.2.2.2 snj <ul> 308 1.1.1.2.2.2 snj <li>must not appear in combination with any of the following options: 309 1.1.1.2.2.2 snj ipv6. 310 1.1.1.2.2.2 snj </ul> 311 1.1.1.2.2.2 snj 312 1.1.1.2.2.2 snj <p>Force DNS resolution of following host names on the command line 313 1.1.1.2.2.2 snj to the IPv4 namespace. 314 1.1.1.2.2.2 snj <div class="node"> 315 1.1.1.2.2.2 snj <p><hr> 316 1.1.1.2.2.2 snj <a name="ntpd-ipv6"></a>Next: <a rel="next" accesskey="n" href="#ntpd-authreq">ntpd authreq</a>, 317 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-ipv4">ntpd ipv4</a>, 318 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 319 1.1.1.2.2.2 snj <br> 320 1.1.1.2.2.2 snj </div> 321 1.1.1.2.2.2 snj 322 1.1.1.2.2.2 snj <h4 class="subsection">ipv6 option (-6)</h4> 323 1.1.1.2.2.2 snj 324 1.1.1.2.2.2 snj <p><a name="index-ntpd_002dipv6-5"></a> 325 1.1.1.2.2.2 snj This is the “force ipv6 dns name resolution” option. 326 1.1.1.2.2.2 snj 327 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 328 1.1.1.2.2.2 snj <ul> 329 1.1.1.2.2.2 snj <li>must not appear in combination with any of the following options: 330 1.1.1.2.2.2 snj ipv4. 331 1.1.1.2.2.2 snj </ul> 332 1.1.1.2.2.2 snj 333 1.1.1.2.2.2 snj <p>Force DNS resolution of following host names on the command line 334 1.1.1.2.2.2 snj to the IPv6 namespace. 335 1.1.1.2.2.2 snj <div class="node"> 336 1.1.1.2.2.2 snj <p><hr> 337 1.1.1.2.2.2 snj <a name="ntpd-authreq"></a>Next: <a rel="next" accesskey="n" href="#ntpd-authnoreq">ntpd authnoreq</a>, 338 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-ipv6">ntpd ipv6</a>, 339 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 340 1.1.1.2.2.2 snj <br> 341 1.1.1.2.2.2 snj </div> 342 1.1.1.2.2.2 snj 343 1.1.1.2.2.2 snj <h4 class="subsection">authreq option (-a)</h4> 344 1.1.1.2.2.2 snj 345 1.1.1.2.2.2 snj <p><a name="index-ntpd_002dauthreq-6"></a> 346 1.1.1.2.2.2 snj This is the “require crypto authentication” option. 347 1.1.1.2.2.2 snj 348 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 349 1.1.1.2.2.2 snj <ul> 350 1.1.1.2.2.2 snj <li>must not appear in combination with any of the following options: 351 1.1.1.2.2.2 snj authnoreq. 352 1.1.1.2.2.2 snj </ul> 353 1.1.1.2.2.2 snj 354 1.1.1.2.2.2 snj <p>Require cryptographic authentication for broadcast client, 355 1.1.1.2.2.2 snj multicast client and symmetric passive associations. 356 1.1.1.2.2.2 snj This is the default. 357 1.1.1.2.2.2 snj <div class="node"> 358 1.1.1.2.2.2 snj <p><hr> 359 1.1.1.2.2.2 snj <a name="ntpd-authnoreq"></a>Next: <a rel="next" accesskey="n" href="#ntpd-configfile">ntpd configfile</a>, 360 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-authreq">ntpd authreq</a>, 361 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 362 1.1.1.2.2.2 snj <br> 363 1.1.1.2.2.2 snj </div> 364 1.1.1.2.2.2 snj 365 1.1.1.2.2.2 snj <h4 class="subsection">authnoreq option (-A)</h4> 366 1.1.1.2.2.2 snj 367 1.1.1.2.2.2 snj <p><a name="index-ntpd_002dauthnoreq-7"></a> 368 1.1.1.2.2.2 snj This is the “do not require crypto authentication” option. 369 1.1.1.2.2.2 snj 370 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 371 1.1.1.2.2.2 snj <ul> 372 1.1.1.2.2.2 snj <li>must not appear in combination with any of the following options: 373 1.1.1.2.2.2 snj authreq. 374 1.1.1.2.2.2 snj </ul> 375 1.1.1.2.2.2 snj 376 1.1.1.2.2.2 snj <p>Do not require cryptographic authentication for broadcast client, 377 1.1.1.2.2.2 snj multicast client and symmetric passive associations. 378 1.1.1.2.2.2 snj This is almost never a good idea. 379 1.1.1.2.2.2 snj <div class="node"> 380 1.1.1.2.2.2 snj <p><hr> 381 1.1.1.2.2.2 snj <a name="ntpd-configfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-driftfile">ntpd driftfile</a>, 382 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-authnoreq">ntpd authnoreq</a>, 383 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 384 1.1.1.2.2.2 snj <br> 385 1.1.1.2.2.2 snj </div> 386 1.1.1.2.2.2 snj 387 1.1.1.2.2.2 snj <h4 class="subsection">configfile option (-c)</h4> 388 1.1.1.2.2.2 snj 389 1.1.1.2.2.2 snj <p><a name="index-ntpd_002dconfigfile-8"></a> 390 1.1.1.2.2.2 snj This is the “configuration file name” option. 391 1.1.1.2.2.2 snj This option takes a string argument. 392 1.1.1.2.2.2 snj The name and path of the configuration file, 393 1.1.1.2.2.2 snj <span class="file">/etc/ntp.conf</span> 394 1.1.1.2.2.2 snj by default. 395 1.1.1.2.2.2 snj <div class="node"> 396 1.1.1.2.2.2 snj <p><hr> 397 1.1.1.2.2.2 snj <a name="ntpd-driftfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-panicgate">ntpd panicgate</a>, 398 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-configfile">ntpd configfile</a>, 399 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 400 1.1.1.2.2.2 snj <br> 401 1.1.1.2.2.2 snj </div> 402 1.1.1.2.2.2 snj 403 1.1.1.2.2.2 snj <h4 class="subsection">driftfile option (-f)</h4> 404 1.1.1.2.2.2 snj 405 1.1.1.2.2.2 snj <p><a name="index-ntpd_002ddriftfile-9"></a> 406 1.1.1.2.2.2 snj This is the “frequency drift file name” option. 407 1.1.1.2.2.2 snj This option takes a string argument. 408 1.1.1.2.2.2 snj The name and path of the frequency file, 409 1.1.1.2.2.2 snj <span class="file">/etc/ntp.drift</span> 410 1.1.1.2.2.2 snj by default. 411 1.1.1.2.2.2 snj This is the same operation as the 412 1.1.1.2.2.2 snj <code>driftfile</code> <kbd>driftfile</kbd> 413 1.1.1.2.2.2 snj configuration specification in the 414 1.1.1.2.2.2 snj <span class="file">/etc/ntp.conf</span> 415 1.1.1.2.2.2 snj file. 416 1.1.1.2.2.2 snj <div class="node"> 417 1.1.1.2.2.2 snj <p><hr> 418 1.1.1.2.2.3 snj <a name="ntpd-panicgate"></a>Next: <a rel="next" accesskey="n" href="#ntpd-force_002dstep_002donce">ntpd force-step-once</a>, 419 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-driftfile">ntpd driftfile</a>, 420 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 421 1.1.1.2.2.2 snj <br> 422 1.1.1.2.2.2 snj </div> 423 1.1.1.2.2.2 snj 424 1.1.1.2.2.2 snj <h4 class="subsection">panicgate option (-g)</h4> 425 1.1.1.2.2.2 snj 426 1.1.1.2.2.2 snj <p><a name="index-ntpd_002dpanicgate-10"></a> 427 1.1.1.2.2.2 snj This is the “allow the first adjustment to be big” option. 428 1.1.1.2.2.2 snj 429 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 430 1.1.1.2.2.2 snj <ul> 431 1.1.1.2.2.2 snj <li>may appear an unlimited number of times. 432 1.1.1.2.2.2 snj </ul> 433 1.1.1.2.2.2 snj 434 1.1.1.2.2.2 snj <p>Normally, 435 1.1.1.2.2.2 snj <code>ntpd</code> 436 1.1.1.2.2.2 snj exits with a message to the system log if the offset exceeds the panic threshold, which is 1000 s by default. This option allows the time to be set to any value without restriction; however, this can happen only once. If the threshold is exceeded after that, 437 1.1.1.2.2.2 snj <code>ntpd</code> 438 1.1.1.2.2.2 snj will exit with a message to the system log. This option can be used with the 439 1.1.1.2.2.2 snj <code>-q</code> 440 1.1.1.2.2.2 snj and 441 1.1.1.2.2.2 snj <code>-x</code> 442 1.1.1.2.2.2 snj options. 443 1.1.1.2.2.2 snj See the 444 1.1.1.2.2.2 snj <code>tinker</code> 445 1.1.1.2.2.2 snj configuration file directive for other options. 446 1.1.1.2.2.2 snj <div class="node"> 447 1.1.1.2.2.2 snj <p><hr> 448 1.1.1.2.2.3 snj <a name="ntpd-force_002dstep_002donce"></a>Next: <a rel="next" accesskey="n" href="#ntpd-jaildir">ntpd jaildir</a>, 449 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-panicgate">ntpd panicgate</a>, 450 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 451 1.1.1.2.2.2 snj <br> 452 1.1.1.2.2.2 snj </div> 453 1.1.1.2.2.2 snj 454 1.1.1.2.2.3 snj <h4 class="subsection">force-step-once option (-G)</h4> 455 1.1.1.2.2.3 snj 456 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dforce_002dstep_002donce-11"></a> 457 1.1.1.2.2.3 snj This is the “step any initial offset correction.” option. 458 1.1.1.2.2.3 snj Normally, 459 1.1.1.2.2.3 snj <code>ntpd</code> 460 1.1.1.2.2.3 snj steps the time if the time offset exceeds the step threshold, 461 1.1.1.2.2.3 snj which is 128 ms by default, and otherwise slews the time. 462 1.1.1.2.2.3 snj This option forces the initial offset correction to be stepped, 463 1.1.1.2.2.3 snj so the highest time accuracy can be achieved quickly. 464 1.1.1.2.2.3 snj However, this may also cause the time to be stepped back 465 1.1.1.2.2.3 snj so this option must not be used if 466 1.1.1.2.2.3 snj applications requiring monotonic time are running. 467 1.1.1.2.2.3 snj See the <code>tinker</code> configuration file directive for other options. 468 1.1.1.2.2.3 snj <div class="node"> 469 1.1.1.2.2.3 snj <p><hr> 470 1.1.1.2.2.3 snj <a name="ntpd-jaildir"></a>Next: <a rel="next" accesskey="n" href="#ntpd-interface">ntpd interface</a>, 471 1.1.1.2.2.3 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-force_002dstep_002donce">ntpd force-step-once</a>, 472 1.1.1.2.2.3 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 473 1.1.1.2.2.3 snj <br> 474 1.1.1.2.2.3 snj </div> 475 1.1.1.2.2.3 snj 476 1.1.1.2.2.2 snj <h4 class="subsection">jaildir option (-i)</h4> 477 1.1.1.2.2.2 snj 478 1.1.1.2.2.3 snj <p><a name="index-ntpd_002djaildir-12"></a> 479 1.1.1.2.2.2 snj This is the “jail directory” option. 480 1.1.1.2.2.2 snj This option takes a string argument. 481 1.1.1.2.2.2 snj 482 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 483 1.1.1.2.2.2 snj <ul> 484 1.1.1.2.2.2 snj <li>must be compiled in by defining <code>HAVE_DROPROOT</code> during the compilation. 485 1.1.1.2.2.2 snj </ul> 486 1.1.1.2.2.2 snj 487 1.1.1.2.2.2 snj <p>Chroot the server to the directory 488 1.1.1.2.2.2 snj <kbd>jaildir</kbd> 489 1.1.1.2.2.2 snj . 490 1.1.1.2.2.2 snj This option also implies that the server attempts to drop root privileges at startup. 491 1.1.1.2.2.2 snj You may need to also specify a 492 1.1.1.2.2.2 snj <code>-u</code> 493 1.1.1.2.2.2 snj option. 494 1.1.1.2.2.2 snj This option is only available if the OS supports adjusting the clock 495 1.1.1.2.2.2 snj without full root privileges. 496 1.1.1.2.2.2 snj This option is supported under NetBSD (configure with 497 1.1.1.2.2.2 snj <code>--enable-clockctl</code>) or Linux (configure with 498 1.1.1.2.2.2 snj <code>--enable-linuxcaps</code>) or Solaris (configure with <code>--enable-solarisprivs</code>). 499 1.1.1.2.2.2 snj <div class="node"> 500 1.1.1.2.2.2 snj <p><hr> 501 1.1.1.2.2.2 snj <a name="ntpd-interface"></a>Next: <a rel="next" accesskey="n" href="#ntpd-keyfile">ntpd keyfile</a>, 502 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-jaildir">ntpd jaildir</a>, 503 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 504 1.1.1.2.2.2 snj <br> 505 1.1.1.2.2.2 snj </div> 506 1.1.1.2.2.2 snj 507 1.1.1.2.2.2 snj <h4 class="subsection">interface option (-I)</h4> 508 1.1.1.2.2.2 snj 509 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dinterface-13"></a> 510 1.1.1.2.2.2 snj This is the “listen on an interface name or address” option. 511 1.1.1.2.2.2 snj This option takes a string argument <span class="file">iface</span>. 512 1.1.1.2.2.2 snj 513 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 514 1.1.1.2.2.2 snj <ul> 515 1.1.1.2.2.2 snj <li>may appear an unlimited number of times. 516 1.1.1.2.2.2 snj </ul> 517 1.1.1.2.2.2 snj 518 1.1.1.2.2.2 snj <p>Open the network address given, or all the addresses associated with the 519 1.1.1.2.2.2 snj given interface name. This option may appear multiple times. This option 520 1.1.1.2.2.2 snj also implies not opening other addresses, except wildcard and localhost. 521 1.1.1.2.2.2 snj This option is deprecated. Please consider using the configuration file 522 1.1.1.2.2.2 snj <code>interface</code> command, which is more versatile. 523 1.1.1.2.2.2 snj <div class="node"> 524 1.1.1.2.2.2 snj <p><hr> 525 1.1.1.2.2.2 snj <a name="ntpd-keyfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-logfile">ntpd logfile</a>, 526 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-interface">ntpd interface</a>, 527 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 528 1.1.1.2.2.2 snj <br> 529 1.1.1.2.2.2 snj </div> 530 1.1.1.2.2.2 snj 531 1.1.1.2.2.2 snj <h4 class="subsection">keyfile option (-k)</h4> 532 1.1.1.2.2.2 snj 533 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dkeyfile-14"></a> 534 1.1.1.2.2.2 snj This is the “path to symmetric keys” option. 535 1.1.1.2.2.2 snj This option takes a string argument. 536 1.1.1.2.2.2 snj Specify the name and path of the symmetric key file. 537 1.1.1.2.2.2 snj <span class="file">/etc/ntp.keys</span> 538 1.1.1.2.2.2 snj is the default. 539 1.1.1.2.2.2 snj This is the same operation as the 540 1.1.1.2.2.2 snj <code>keys</code> <kbd>keyfile</kbd> 541 1.1.1.2.2.2 snj configuration file directive. 542 1.1.1.2.2.2 snj <div class="node"> 543 1.1.1.2.2.2 snj <p><hr> 544 1.1.1.2.2.2 snj <a name="ntpd-logfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-novirtualips">ntpd novirtualips</a>, 545 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-keyfile">ntpd keyfile</a>, 546 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 547 1.1.1.2.2.2 snj <br> 548 1.1.1.2.2.2 snj </div> 549 1.1.1.2.2.2 snj 550 1.1.1.2.2.2 snj <h4 class="subsection">logfile option (-l)</h4> 551 1.1.1.2.2.2 snj 552 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dlogfile-15"></a> 553 1.1.1.2.2.2 snj This is the “path to the log file” option. 554 1.1.1.2.2.2 snj This option takes a string argument. 555 1.1.1.2.2.2 snj Specify the name and path of the log file. 556 1.1.1.2.2.2 snj The default is the system log file. 557 1.1.1.2.2.2 snj This is the same operation as the 558 1.1.1.2.2.2 snj <code>logfile</code> <kbd>logfile</kbd> 559 1.1.1.2.2.2 snj configuration file directive. 560 1.1.1.2.2.2 snj <div class="node"> 561 1.1.1.2.2.2 snj <p><hr> 562 1.1.1.2.2.2 snj <a name="ntpd-novirtualips"></a>Next: <a rel="next" accesskey="n" href="#ntpd-modifymmtimer">ntpd modifymmtimer</a>, 563 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-logfile">ntpd logfile</a>, 564 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 565 1.1.1.2.2.2 snj <br> 566 1.1.1.2.2.2 snj </div> 567 1.1.1.2.2.2 snj 568 1.1.1.2.2.2 snj <h4 class="subsection">novirtualips option (-L)</h4> 569 1.1.1.2.2.2 snj 570 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dnovirtualips-16"></a> 571 1.1.1.2.2.2 snj This is the “do not listen to virtual interfaces” option. 572 1.1.1.2.2.2 snj Do not listen to virtual interfaces, defined as those with 573 1.1.1.2.2.2 snj names containing a colon. This option is deprecated. Please 574 1.1.1.2.2.2 snj consider using the configuration file <code>interface</code> command, which 575 1.1.1.2.2.2 snj is more versatile. 576 1.1.1.2.2.2 snj <div class="node"> 577 1.1.1.2.2.2 snj <p><hr> 578 1.1.1.2.2.2 snj <a name="ntpd-modifymmtimer"></a>Next: <a rel="next" accesskey="n" href="#ntpd-nice">ntpd nice</a>, 579 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-novirtualips">ntpd novirtualips</a>, 580 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 581 1.1.1.2.2.2 snj <br> 582 1.1.1.2.2.2 snj </div> 583 1.1.1.2.2.2 snj 584 1.1.1.2.2.2 snj <h4 class="subsection">modifymmtimer option (-M)</h4> 585 1.1.1.2.2.2 snj 586 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dmodifymmtimer-17"></a> 587 1.1.1.2.2.2 snj This is the “modify multimedia timer (windows only)” option. 588 1.1.1.2.2.2 snj 589 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 590 1.1.1.2.2.2 snj <ul> 591 1.1.1.2.2.2 snj <li>must be compiled in by defining <code>SYS_WINNT</code> during the compilation. 592 1.1.1.2.2.2 snj </ul> 593 1.1.1.2.2.2 snj 594 1.1.1.2.2.2 snj <p>Set the Windows Multimedia Timer to highest resolution. This 595 1.1.1.2.2.2 snj ensures the resolution does not change while ntpd is running, 596 1.1.1.2.2.2 snj avoiding timekeeping glitches associated with changes. 597 1.1.1.2.2.2 snj <div class="node"> 598 1.1.1.2.2.2 snj <p><hr> 599 1.1.1.2.2.2 snj <a name="ntpd-nice"></a>Next: <a rel="next" accesskey="n" href="#ntpd-pidfile">ntpd pidfile</a>, 600 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-modifymmtimer">ntpd modifymmtimer</a>, 601 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 602 1.1.1.2.2.2 snj <br> 603 1.1.1.2.2.2 snj </div> 604 1.1.1.2.2.2 snj 605 1.1.1.2.2.2 snj <h4 class="subsection">nice option (-N)</h4> 606 1.1.1.2.2.2 snj 607 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dnice-18"></a> 608 1.1.1.2.2.2 snj This is the “run at high priority” option. 609 1.1.1.2.2.2 snj To the extent permitted by the operating system, run 610 1.1.1.2.2.2 snj <code>ntpd</code> 611 1.1.1.2.2.2 snj at the highest priority. 612 1.1.1.2.2.2 snj <div class="node"> 613 1.1.1.2.2.2 snj <p><hr> 614 1.1.1.2.2.2 snj <a name="ntpd-pidfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-priority">ntpd priority</a>, 615 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-nice">ntpd nice</a>, 616 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 617 1.1.1.2.2.2 snj <br> 618 1.1.1.2.2.2 snj </div> 619 1.1.1.2.2.2 snj 620 1.1.1.2.2.2 snj <h4 class="subsection">pidfile option (-p)</h4> 621 1.1.1.2.2.2 snj 622 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dpidfile-19"></a> 623 1.1.1.2.2.2 snj This is the “path to the pid file” option. 624 1.1.1.2.2.2 snj This option takes a string argument. 625 1.1.1.2.2.2 snj Specify the name and path of the file used to record 626 1.1.1.2.2.2 snj <code>ntpd</code>'s 627 1.1.1.2.2.2 snj process ID. 628 1.1.1.2.2.2 snj This is the same operation as the 629 1.1.1.2.2.2 snj <code>pidfile</code> <kbd>pidfile</kbd> 630 1.1.1.2.2.2 snj configuration file directive. 631 1.1.1.2.2.2 snj <div class="node"> 632 1.1.1.2.2.2 snj <p><hr> 633 1.1.1.2.2.2 snj <a name="ntpd-priority"></a>Next: <a rel="next" accesskey="n" href="#ntpd-quit">ntpd quit</a>, 634 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-pidfile">ntpd pidfile</a>, 635 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 636 1.1.1.2.2.2 snj <br> 637 1.1.1.2.2.2 snj </div> 638 1.1.1.2.2.2 snj 639 1.1.1.2.2.2 snj <h4 class="subsection">priority option (-P)</h4> 640 1.1.1.2.2.2 snj 641 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dpriority-20"></a> 642 1.1.1.2.2.2 snj This is the “process priority” option. 643 1.1.1.2.2.2 snj This option takes a number argument. 644 1.1.1.2.2.2 snj To the extent permitted by the operating system, run 645 1.1.1.2.2.2 snj <code>ntpd</code> 646 1.1.1.2.2.2 snj at the specified 647 1.1.1.2.2.2 snj <code>sched_setscheduler(SCHED_FIFO)</code> 648 1.1.1.2.2.2 snj priority. 649 1.1.1.2.2.2 snj <div class="node"> 650 1.1.1.2.2.2 snj <p><hr> 651 1.1.1.2.2.2 snj <a name="ntpd-quit"></a>Next: <a rel="next" accesskey="n" href="#ntpd-propagationdelay">ntpd propagationdelay</a>, 652 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-priority">ntpd priority</a>, 653 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 654 1.1.1.2.2.2 snj <br> 655 1.1.1.2.2.2 snj </div> 656 1.1.1.2.2.2 snj 657 1.1.1.2.2.2 snj <h4 class="subsection">quit option (-q)</h4> 658 1.1.1.2.2.2 snj 659 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dquit-21"></a> 660 1.1.1.2.2.2 snj This is the “set the time and quit” option. 661 1.1.1.2.2.2 snj 662 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 663 1.1.1.2.2.2 snj <ul> 664 1.1.1.2.2.2 snj <li>must not appear in combination with any of the following options: 665 1.1.1.2.2.2 snj saveconfigquit, wait-sync. 666 1.1.1.2.2.2 snj </ul> 667 1.1.1.2.2.2 snj 668 1.1.1.2.2.2 snj <p><code>ntpd</code> 669 1.1.1.2.2.2 snj will not daemonize and will exit after the clock is first 670 1.1.1.2.2.2 snj synchronized. This behavior mimics that of the 671 1.1.1.2.2.2 snj <code>ntpdate</code> 672 1.1.1.2.2.2 snj program, which will soon be replaced with a shell script. 673 1.1.1.2.2.2 snj The 674 1.1.1.2.2.2 snj <code>-g</code> 675 1.1.1.2.2.2 snj and 676 1.1.1.2.2.2 snj <code>-x</code> 677 1.1.1.2.2.2 snj options can be used with this option. 678 1.1.1.2.2.2 snj Note: The kernel time discipline is disabled with this option. 679 1.1.1.2.2.2 snj <div class="node"> 680 1.1.1.2.2.2 snj <p><hr> 681 1.1.1.2.2.2 snj <a name="ntpd-propagationdelay"></a>Next: <a rel="next" accesskey="n" href="#ntpd-saveconfigquit">ntpd saveconfigquit</a>, 682 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-quit">ntpd quit</a>, 683 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 684 1.1.1.2.2.2 snj <br> 685 1.1.1.2.2.2 snj </div> 686 1.1.1.2.2.2 snj 687 1.1.1.2.2.2 snj <h4 class="subsection">propagationdelay option (-r)</h4> 688 1.1.1.2.2.2 snj 689 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dpropagationdelay-22"></a> 690 1.1.1.2.2.2 snj This is the “broadcast/propagation delay” option. 691 1.1.1.2.2.2 snj This option takes a string argument. 692 1.1.1.2.2.2 snj 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. 693 1.1.1.2.2.2 snj <div class="node"> 694 1.1.1.2.2.2 snj <p><hr> 695 1.1.1.2.2.2 snj <a name="ntpd-saveconfigquit"></a>Next: <a rel="next" accesskey="n" href="#ntpd-statsdir">ntpd statsdir</a>, 696 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-propagationdelay">ntpd propagationdelay</a>, 697 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 698 1.1.1.2.2.2 snj <br> 699 1.1.1.2.2.2 snj </div> 700 1.1.1.2.2.2 snj 701 1.1.1.2.2.2 snj <h4 class="subsection">saveconfigquit option</h4> 702 1.1.1.2.2.2 snj 703 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dsaveconfigquit-23"></a> 704 1.1.1.2.2.2 snj This is the “save parsed configuration and quit” option. 705 1.1.1.2.2.2 snj This option takes a string argument. 706 1.1.1.2.2.2 snj 707 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 708 1.1.1.2.2.2 snj <ul> 709 1.1.1.2.2.2 snj <li>must be compiled in by defining <code>SAVECONFIG</code> during the compilation. 710 1.1.1.2.2.2 snj <li>must not appear in combination with any of the following options: 711 1.1.1.2.2.2 snj quit, wait-sync. 712 1.1.1.2.2.2 snj </ul> 713 1.1.1.2.2.2 snj 714 1.1.1.2.2.2 snj <p>Cause <code>ntpd</code> to parse its startup configuration file and save an 715 1.1.1.2.2.2 snj equivalent to the given filename and exit. This option was 716 1.1.1.2.2.2 snj designed for automated testing. 717 1.1.1.2.2.2 snj <div class="node"> 718 1.1.1.2.2.2 snj <p><hr> 719 1.1.1.2.2.2 snj <a name="ntpd-statsdir"></a>Next: <a rel="next" accesskey="n" href="#ntpd-trustedkey">ntpd trustedkey</a>, 720 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-saveconfigquit">ntpd saveconfigquit</a>, 721 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 722 1.1.1.2.2.2 snj <br> 723 1.1.1.2.2.2 snj </div> 724 1.1.1.2.2.2 snj 725 1.1.1.2.2.2 snj <h4 class="subsection">statsdir option (-s)</h4> 726 1.1.1.2.2.2 snj 727 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dstatsdir-24"></a> 728 1.1.1.2.2.2 snj This is the “statistics file location” option. 729 1.1.1.2.2.2 snj This option takes a string argument. 730 1.1.1.2.2.2 snj Specify the directory path for files created by the statistics facility. 731 1.1.1.2.2.2 snj This is the same operation as the 732 1.1.1.2.2.2 snj <code>statsdir</code> <kbd>statsdir</kbd> 733 1.1.1.2.2.2 snj configuration file directive. 734 1.1.1.2.2.2 snj <div class="node"> 735 1.1.1.2.2.2 snj <p><hr> 736 1.1.1.2.2.2 snj <a name="ntpd-trustedkey"></a>Next: <a rel="next" accesskey="n" href="#ntpd-user">ntpd user</a>, 737 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-statsdir">ntpd statsdir</a>, 738 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 739 1.1.1.2.2.2 snj <br> 740 1.1.1.2.2.2 snj </div> 741 1.1.1.2.2.2 snj 742 1.1.1.2.2.2 snj <h4 class="subsection">trustedkey option (-t)</h4> 743 1.1.1.2.2.2 snj 744 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dtrustedkey-25"></a> 745 1.1.1.2.2.2 snj This is the “trusted key number” option. 746 1.1.1.2.2.2 snj This option takes a string argument <span class="file">tkey</span>. 747 1.1.1.2.2.2 snj 748 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 749 1.1.1.2.2.2 snj <ul> 750 1.1.1.2.2.2 snj <li>may appear an unlimited number of times. 751 1.1.1.2.2.2 snj </ul> 752 1.1.1.2.2.2 snj 753 1.1.1.2.2.2 snj <p>Add the specified key number to the trusted key list. 754 1.1.1.2.2.2 snj <div class="node"> 755 1.1.1.2.2.2 snj <p><hr> 756 1.1.1.2.2.2 snj <a name="ntpd-user"></a>Next: <a rel="next" accesskey="n" href="#ntpd-updateinterval">ntpd updateinterval</a>, 757 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-trustedkey">ntpd trustedkey</a>, 758 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 759 1.1.1.2.2.2 snj <br> 760 1.1.1.2.2.2 snj </div> 761 1.1.1.2.2.2 snj 762 1.1.1.2.2.2 snj <h4 class="subsection">user option (-u)</h4> 763 1.1.1.2.2.2 snj 764 1.1.1.2.2.3 snj <p><a name="index-ntpd_002duser-26"></a> 765 1.1.1.2.2.2 snj This is the “run as userid (or userid:groupid)” option. 766 1.1.1.2.2.2 snj This option takes a string argument. 767 1.1.1.2.2.2 snj 768 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 769 1.1.1.2.2.2 snj <ul> 770 1.1.1.2.2.2 snj <li>must be compiled in by defining <code>HAVE_DROPROOT</code> during the compilation. 771 1.1.1.2.2.2 snj </ul> 772 1.1.1.2.2.2 snj 773 1.1.1.2.2.2 snj <p>Specify a user, and optionally a group, to switch to. 774 1.1.1.2.2.2 snj This option is only available if the OS supports adjusting the clock 775 1.1.1.2.2.2 snj without full root privileges. 776 1.1.1.2.2.2 snj This option is supported under NetBSD (configure with 777 1.1.1.2.2.2 snj <code>--enable-clockctl</code>) or Linux (configure with 778 1.1.1.2.2.2 snj <code>--enable-linuxcaps</code>) or Solaris (configure with <code>--enable-solarisprivs</code>). 779 1.1.1.2.2.2 snj <div class="node"> 780 1.1.1.2.2.2 snj <p><hr> 781 1.1.1.2.2.2 snj <a name="ntpd-updateinterval"></a>Next: <a rel="next" accesskey="n" href="#ntpd-wait_002dsync">ntpd wait-sync</a>, 782 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-user">ntpd user</a>, 783 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 784 1.1.1.2.2.2 snj <br> 785 1.1.1.2.2.2 snj </div> 786 1.1.1.2.2.2 snj 787 1.1.1.2.2.2 snj <h4 class="subsection">updateinterval option (-U)</h4> 788 1.1.1.2.2.2 snj 789 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dupdateinterval-27"></a> 790 1.1.1.2.2.2 snj This is the “interval in seconds between scans for new or dropped interfaces” option. 791 1.1.1.2.2.2 snj This option takes a number argument. 792 1.1.1.2.2.2 snj Give the time in seconds between two scans for new or dropped interfaces. 793 1.1.1.2.2.2 snj For systems with routing socket support the scans will be performed shortly after the interface change 794 1.1.1.2.2.2 snj has been detected by the system. 795 1.1.1.2.2.2 snj Use 0 to disable scanning. 60 seconds is the minimum time between scans. 796 1.1.1.2.2.2 snj <div class="node"> 797 1.1.1.2.2.2 snj <p><hr> 798 1.1.1.2.2.2 snj <a name="ntpd-wait_002dsync"></a>Next: <a rel="next" accesskey="n" href="#ntpd-slew">ntpd slew</a>, 799 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-updateinterval">ntpd updateinterval</a>, 800 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 801 1.1.1.2.2.2 snj <br> 802 1.1.1.2.2.2 snj </div> 803 1.1.1.2.2.2 snj 804 1.1.1.2.2.2 snj <h4 class="subsection">wait-sync option (-w)</h4> 805 1.1.1.2.2.2 snj 806 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dwait_002dsync-28"></a> 807 1.1.1.2.2.2 snj This is the “seconds to wait for first clock sync” option. 808 1.1.1.2.2.2 snj This option takes a number argument. 809 1.1.1.2.2.2 snj 810 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 811 1.1.1.2.2.2 snj <ul> 812 1.1.1.2.2.2 snj <li>must be compiled in by defining <code>HAVE_WORKING_FORK</code> during the compilation. 813 1.1.1.2.2.2 snj <li>must not appear in combination with any of the following options: 814 1.1.1.2.2.2 snj nofork, quit, saveconfigquit. 815 1.1.1.2.2.2 snj </ul> 816 1.1.1.2.2.2 snj 817 1.1.1.2.2.2 snj <p>If greater than zero, alters <code>ntpd</code>'s behavior when forking to 818 1.1.1.2.2.2 snj daemonize. Instead of exiting with status 0 immediately after 819 1.1.1.2.2.2 snj the fork, the parent waits up to the specified number of 820 1.1.1.2.2.2 snj seconds for the child to first synchronize the clock. The exit 821 1.1.1.2.2.2 snj status is zero (success) if the clock was synchronized, 822 1.1.1.2.2.2 snj otherwise it is <code>ETIMEDOUT</code>. 823 1.1.1.2.2.2 snj This provides the option for a script starting <code>ntpd</code> to easily 824 1.1.1.2.2.2 snj wait for the first set of the clock before proceeding. 825 1.1.1.2.2.2 snj <div class="node"> 826 1.1.1.2.2.2 snj <p><hr> 827 1.1.1.2.2.2 snj <a name="ntpd-slew"></a>Next: <a rel="next" accesskey="n" href="#ntpd-usepcc">ntpd usepcc</a>, 828 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-wait_002dsync">ntpd wait-sync</a>, 829 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 830 1.1.1.2.2.2 snj <br> 831 1.1.1.2.2.2 snj </div> 832 1.1.1.2.2.2 snj 833 1.1.1.2.2.2 snj <h4 class="subsection">slew option (-x)</h4> 834 1.1.1.2.2.2 snj 835 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dslew-29"></a> 836 1.1.1.2.2.2 snj This is the “slew up to 600 seconds” option. 837 1.1.1.2.2.2 snj 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. 838 1.1.1.2.2.2 snj This option sets the threshold to 600 s, which is well within the accuracy window to set the clock manually. 839 1.1.1.2.2.2 snj Note: Since the slew rate of typical Unix kernels is limited to 0.5 ms/s, each second of adjustment requires an amortization interval of 2000 s. 840 1.1.1.2.2.2 snj Thus, an adjustment as much as 600 s will take almost 14 days to complete. 841 1.1.1.2.2.2 snj This option can be used with the 842 1.1.1.2.2.2 snj <code>-g</code> 843 1.1.1.2.2.2 snj and 844 1.1.1.2.2.2 snj <code>-q</code> 845 1.1.1.2.2.2 snj options. 846 1.1.1.2.2.2 snj See the 847 1.1.1.2.2.2 snj <code>tinker</code> 848 1.1.1.2.2.2 snj configuration file directive for other options. 849 1.1.1.2.2.2 snj Note: The kernel time discipline is disabled with this option. 850 1.1.1.2.2.2 snj <div class="node"> 851 1.1.1.2.2.2 snj <p><hr> 852 1.1.1.2.2.2 snj <a name="ntpd-usepcc"></a>Next: <a rel="next" accesskey="n" href="#ntpd-pccfreq">ntpd pccfreq</a>, 853 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-slew">ntpd slew</a>, 854 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 855 1.1.1.2.2.2 snj <br> 856 1.1.1.2.2.2 snj </div> 857 1.1.1.2.2.2 snj 858 1.1.1.2.2.2 snj <h4 class="subsection">usepcc option</h4> 859 1.1.1.2.2.2 snj 860 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dusepcc-30"></a> 861 1.1.1.2.2.2 snj This is the “use cpu cycle counter (windows only)” option. 862 1.1.1.2.2.2 snj 863 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 864 1.1.1.2.2.2 snj <ul> 865 1.1.1.2.2.2 snj <li>must be compiled in by defining <code>SYS_WINNT</code> during the compilation. 866 1.1.1.2.2.2 snj </ul> 867 1.1.1.2.2.2 snj 868 1.1.1.2.2.2 snj <p>Attempt to substitute the CPU counter for <code>QueryPerformanceCounter</code>. 869 1.1.1.2.2.2 snj The CPU counter and <code>QueryPerformanceCounter</code> are compared, and if 870 1.1.1.2.2.2 snj they have the same frequency, the CPU counter (RDTSC on x86) is 871 1.1.1.2.2.2 snj used directly, saving the overhead of a system call. 872 1.1.1.2.2.2 snj <div class="node"> 873 1.1.1.2.2.2 snj <p><hr> 874 1.1.1.2.2.2 snj <a name="ntpd-pccfreq"></a>Next: <a rel="next" accesskey="n" href="#ntpd-mdns">ntpd mdns</a>, 875 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-usepcc">ntpd usepcc</a>, 876 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 877 1.1.1.2.2.2 snj <br> 878 1.1.1.2.2.2 snj </div> 879 1.1.1.2.2.2 snj 880 1.1.1.2.2.2 snj <h4 class="subsection">pccfreq option</h4> 881 1.1.1.2.2.2 snj 882 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dpccfreq-31"></a> 883 1.1.1.2.2.2 snj This is the “force cpu cycle counter use (windows only)” option. 884 1.1.1.2.2.2 snj This option takes a string argument. 885 1.1.1.2.2.2 snj 886 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 887 1.1.1.2.2.2 snj <ul> 888 1.1.1.2.2.2 snj <li>must be compiled in by defining <code>SYS_WINNT</code> during the compilation. 889 1.1.1.2.2.2 snj </ul> 890 1.1.1.2.2.2 snj 891 1.1.1.2.2.2 snj <p>Force substitution the CPU counter for <code>QueryPerformanceCounter</code>. 892 1.1.1.2.2.2 snj The CPU counter (RDTSC on x86) is used unconditionally with the 893 1.1.1.2.2.2 snj given frequency (in Hz). 894 1.1.1.2.2.2 snj <div class="node"> 895 1.1.1.2.2.2 snj <p><hr> 896 1.1.1.2.2.2 snj <a name="ntpd-mdns"></a>Next: <a rel="next" accesskey="n" href="#ntpd-config">ntpd config</a>, 897 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-pccfreq">ntpd pccfreq</a>, 898 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 899 1.1.1.2.2.2 snj <br> 900 1.1.1.2.2.2 snj </div> 901 1.1.1.2.2.2 snj 902 1.1.1.2.2.2 snj <h4 class="subsection">mdns option (-m)</h4> 903 1.1.1.2.2.2 snj 904 1.1.1.2.2.3 snj <p><a name="index-ntpd_002dmdns-32"></a> 905 1.1.1.2.2.2 snj This is the “register with mdns as a ntp server” option. 906 1.1.1.2.2.2 snj 907 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 908 1.1.1.2.2.2 snj <ul> 909 1.1.1.2.2.2 snj <li>must be compiled in by defining <code>HAVE_DNSREGISTRATION</code> during the compilation. 910 1.1.1.2.2.2 snj </ul> 911 1.1.1.2.2.2 snj 912 1.1.1.2.2.2 snj <p>Registers as an NTP server with the local mDNS server which allows 913 1.1.1.2.2.2 snj the server to be discovered via mDNS client lookup. 914 1.1.1.2.2.2 snj 915 1.1.1.2.2.2 snj <div class="node"> 916 1.1.1.2.2.2 snj <p><hr> 917 1.1.1.2.2.2 snj <a name="ntpd-config"></a>Next: <a rel="next" accesskey="n" href="#ntpd-exit-status">ntpd exit status</a>, 918 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-mdns">ntpd mdns</a>, 919 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 920 1.1.1.2.2.2 snj <br> 921 1.1.1.2.2.2 snj </div> 922 1.1.1.2.2.2 snj 923 1.1.1.2.2.2 snj <h4 class="subsection">presetting/configuring ntpd</h4> 924 1.1.1.2.2.2 snj 925 1.1.1.2.2.2 snj <p>Any option that is not marked as <i>not presettable</i> may be preset by 926 1.1.1.2.2.2 snj loading values from environment variables named <code>NTPD</code> and <code>NTPD_<OPTION_NAME></code>. <code><OPTION_NAME></code> must be one of 927 1.1.1.2.2.2 snj the options listed above in upper case and segmented with underscores. 928 1.1.1.2.2.2 snj The <code>NTPD</code> variable will be tokenized and parsed like 929 1.1.1.2.2.2 snj the command line. The remaining variables are tested for existence and their 930 1.1.1.2.2.2 snj values are treated like option arguments. 931 1.1.1.2.2.2 snj 932 1.1.1.2.2.2 snj <p>The command line options relating to configuration and/or usage help are: 933 1.1.1.2.2.2 snj 934 1.1.1.2.2.2 snj <h5 class="subsubheading">version (-)</h5> 935 1.1.1.2.2.2 snj 936 1.1.1.2.2.2 snj <p>Print the program version to standard out, optionally with licensing 937 1.1.1.2.2.2 snj information, then exit 0. The optional argument specifies how much licensing 938 1.1.1.2.2.2 snj detail to provide. The default is to print just the version. The licensing infomation may be selected with an option argument. 939 1.1.1.2.2.2 snj Only the first letter of the argument is examined: 940 1.1.1.2.2.2 snj 941 1.1.1.2.2.2 snj <dl> 942 1.1.1.2.2.2 snj <dt><span class="samp">version</span><dd>Only print the version. This is the default. 943 1.1.1.2.2.2 snj <br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms. 944 1.1.1.2.2.2 snj <br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms. 945 1.1.1.2.2.2 snj </dl> 946 1.1.1.2.2.2 snj 947 1.1.1.2.2.2 snj <div class="node"> 948 1.1.1.2.2.2 snj <p><hr> 949 1.1.1.2.2.2 snj <a name="ntpd-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Usage">ntpd Usage</a>, 950 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-config">ntpd config</a>, 951 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 952 1.1.1.2.2.2 snj <br> 953 1.1.1.2.2.2 snj </div> 954 1.1.1.2.2.2 snj 955 1.1.1.2.2.2 snj <h4 class="subsection">ntpd exit status</h4> 956 1.1.1.2.2.2 snj 957 1.1.1.2.2.2 snj <p>One of the following exit values will be returned: 958 1.1.1.2.2.2 snj <dl> 959 1.1.1.2.2.2 snj <dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution. 960 1.1.1.2.2.2 snj <br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid. 961 1.1.1.2.2.2 snj </dl> 962 1.1.1.2.2.2 snj <div class="node"> 963 1.1.1.2.2.2 snj <p><hr> 964 1.1.1.2.2.2 snj <a name="ntpd-Usage"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Files">ntpd Files</a>, 965 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-exit-status">ntpd exit status</a>, 966 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 967 1.1.1.2.2.2 snj <br> 968 1.1.1.2.2.2 snj </div> 969 1.1.1.2.2.2 snj 970 1.1.1.2.2.2 snj <h4 class="subsection">ntpd Usage</h4> 971 1.1.1.2.2.2 snj 972 1.1.1.2.2.2 snj <div class="node"> 973 1.1.1.2.2.2 snj <p><hr> 974 1.1.1.2.2.2 snj <a name="ntpd-Files"></a>Next: <a rel="next" accesskey="n" href="#ntpd-See-Also">ntpd See Also</a>, 975 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-Usage">ntpd Usage</a>, 976 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 977 1.1.1.2.2.2 snj <br> 978 1.1.1.2.2.2 snj </div> 979 1.1.1.2.2.2 snj 980 1.1.1.2.2.2 snj <h4 class="subsection">ntpd Files</h4> 981 1.1.1.2.2.2 snj 982 1.1.1.2.2.2 snj <div class="node"> 983 1.1.1.2.2.2 snj <p><hr> 984 1.1.1.2.2.2 snj <a name="ntpd-See-Also"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Bugs">ntpd Bugs</a>, 985 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-Files">ntpd Files</a>, 986 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 987 1.1.1.2.2.2 snj <br> 988 1.1.1.2.2.2 snj </div> 989 1.1.1.2.2.2 snj 990 1.1.1.2.2.2 snj <h4 class="subsection">ntpd See Also</h4> 991 1.1.1.2.2.2 snj 992 1.1.1.2.2.2 snj <div class="node"> 993 1.1.1.2.2.2 snj <p><hr> 994 1.1.1.2.2.2 snj <a name="ntpd-Bugs"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Notes">ntpd Notes</a>, 995 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpd-See-Also">ntpd See Also</a>, 996 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 997 1.1.1.2.2.2 snj <br> 998 1.1.1.2.2.2 snj </div> 999 1.1.1.2.2.2 snj 1000 1.1.1.2.2.2 snj <h4 class="subsection">ntpd Bugs</h4> 1001 1.1.1.2.2.2 snj 1002 1.1.1.2.2.2 snj <div class="node"> 1003 1.1.1.2.2.2 snj <p><hr> 1004 1.1.1.2.2.2 snj <a name="ntpd-Notes"></a>Previous: <a rel="previous" accesskey="p" href="#ntpd-Bugs">ntpd Bugs</a>, 1005 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a> 1006 1.1.1.2.2.2 snj <br> 1007 1.1.1.2.2.2 snj </div> 1008 1.1.1.2.2.2 snj 1009 1.1.1.2.2.2 snj <h4 class="subsection">ntpd Notes</h4> 1010 1.1.1.2.2.2 snj 1011 1.1.1.2.2.2 snj <div class="node"> 1012 1.1.1.2.2.2 snj <p><hr> 1013 1.1.1.2.2.2 snj <a name="Usage"></a> 1014 1.1.1.2.2.2 snj <br> 1015 1.1.1.2.2.2 snj </div> 1016 1.1.1.2.2.2 snj 1017 1.1.1.2.2.2 snj <!-- node-name, next, previous, up --> 1018 1.1.1.2.2.2 snj <h3 class="section">Usage</h3> 1019 1.1.1.2.2.2 snj 1020
Indexes created Tue Apr 14 00:22:26 UTC 2026