1181834Sroberto@node ntpd Invocation 2181834Sroberto@section Invoking ntpd 3181834Sroberto@pindex ntpd 4181834Sroberto@cindex NTP daemon program 5181834Sroberto@ignore 6181834Sroberto# 7181834Sroberto# EDIT THIS FILE WITH CAUTION (ntpd-opts.texi) 8181834Sroberto# 9200576Sroberto# It has been AutoGen-ed Tuesday December 8, 2009 at 08:13:12 AM EST 10181834Sroberto# From the definitions ntpd-opts.def 11181834Sroberto# and the template file aginfo.tpl 12181834Sroberto@end ignore 13181834SrobertoThis program has no explanation. 14181834Sroberto 15181834Sroberto 16181834Sroberto 17181834SrobertoThis section was generated by @strong{AutoGen}, 18181834Srobertothe aginfo template and the option descriptions for the @command{ntpd} program. It documents the ntpd usage text and option meanings. 19181834Sroberto 20181834SrobertoThis software is released under a specialized copyright license. 21181834Sroberto 22181834Sroberto@menu 23181834Sroberto* ntpd usage:: ntpd usage help (-?) 24181834Sroberto* ntpd authnoreq:: authnoreq option (-A) 25181834Sroberto* ntpd authreq:: authreq option (-a) 26181834Sroberto* ntpd bcastsync:: bcastsync option (-b) 27181834Sroberto* ntpd configfile:: configfile option (-c) 28181834Sroberto* ntpd debug-level:: debug-level option (-d) 29181834Sroberto* ntpd driftfile:: driftfile option (-f) 30181834Sroberto* ntpd dvar:: dvar option (-V) 31181834Sroberto* ntpd interface:: interface option (-I) 32181834Sroberto* ntpd ipv4:: ipv4 option (-4) 33181834Sroberto* ntpd ipv6:: ipv6 option (-6) 34181834Sroberto* ntpd jaildir:: jaildir option (-i) 35181834Sroberto* ntpd keyfile:: keyfile option (-k) 36181834Sroberto* ntpd logfile:: logfile option (-l) 37181834Sroberto* ntpd modifymmtimer:: modifymmtimer option (-M) 38181834Sroberto* ntpd nice:: nice option (-N) 39181834Sroberto* ntpd nofork:: nofork option (-n) 40181834Sroberto* ntpd novirtualips:: novirtualips option (-L) 41181834Sroberto* ntpd panicgate:: panicgate option (-g) 42181834Sroberto* ntpd pidfile:: pidfile option (-p) 43181834Sroberto* ntpd priority:: priority option (-P) 44181834Sroberto* ntpd propagationdelay:: propagationdelay option (-r) 45181834Sroberto* ntpd quit:: quit option (-q) 46181834Sroberto* ntpd set-debug-level:: set-debug-level option (-D) 47181834Sroberto* ntpd slew:: slew option (-x) 48181834Sroberto* ntpd statsdir:: statsdir option (-s) 49181834Sroberto* ntpd trustedkey:: trustedkey option (-t) 50181834Sroberto* ntpd updateinterval:: updateinterval option (-U) 51181834Sroberto* ntpd user:: user option (-u) 52181834Sroberto* ntpd var:: var option (-v) 53181834Sroberto@end menu 54181834Sroberto 55181834Sroberto@node ntpd usage 56181834Sroberto@subsection ntpd usage help (-?) 57181834Sroberto@cindex ntpd usage 58181834Sroberto 59181834SrobertoThis is the automatically generated usage text for ntpd: 60181834Sroberto 61181834Sroberto@exampleindent 0 62181834Sroberto@example 63200576Srobertontpd - NTP daemon program - Ver. 4.2.5p247-RC 64181834SrobertoUSAGE: ntpd [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... 65181834Sroberto Flg Arg Option-Name Description 66181834Sroberto -4 no ipv4 Force IPv4 DNS name resolution 67200576Sroberto - prohibits these options: 68200576Sroberto ipv6 69181834Sroberto -6 no ipv6 Force IPv6 DNS name resolution 70200576Sroberto - prohibits these options: 71200576Sroberto ipv4 72181834Sroberto -a no authreq Require crypto authentication 73181834Sroberto - prohibits these options: 74181834Sroberto authnoreq 75181834Sroberto -A no authnoreq Do not require crypto authentication 76181834Sroberto - prohibits these options: 77181834Sroberto authreq 78181834Sroberto -b no bcastsync Allow us to sync to broadcast servers 79181834Sroberto -c Str configfile configuration file name 80181834Sroberto -d no debug-level Increase output debug message level 81181834Sroberto - may appear multiple times 82181834Sroberto -D Str set-debug-level Set the output debug message level 83181834Sroberto - may appear multiple times 84181834Sroberto -f Str driftfile frequency drift file name 85181834Sroberto -g no panicgate Allow the first adjustment to be Big 86181834Sroberto - may appear multiple times 87200576Sroberto -i --- jaildir built without --enable-clockctl or --enable-linuxcaps 88200576Sroberto -I Str interface Listen on an interface name or address 89200576Sroberto - may appear multiple times 90181834Sroberto -k Str keyfile path to symmetric keys 91181834Sroberto -l Str logfile path to the log file 92200576Sroberto -L no novirtualips Do not listen to virtual interfaces 93181834Sroberto -n no nofork Do not fork 94181834Sroberto -N no nice Run at high priority 95181834Sroberto -p Str pidfile path to the PID file 96181834Sroberto -P Num priority Process priority 97181834Sroberto -q no quit Set the time and quit 98181834Sroberto -r Str propagationdelay Broadcast/propagation delay 99200576Sroberto Str saveconfigquit Save parsed configuration and quit 100181834Sroberto -s Str statsdir Statistics file location 101181834Sroberto -t Str trustedkey Trusted key number 102181834Sroberto - may appear multiple times 103200576Sroberto -u --- user built without --enable-clockctl or --enable-linuxcaps 104181834Sroberto -U Num updateinterval interval in seconds between scans for new or dropped interfaces 105181834Sroberto Str var make ARG an ntp variable (RW) 106181834Sroberto - may appear multiple times 107181834Sroberto Str dvar make ARG an ntp variable (RW|DEF) 108181834Sroberto - may appear multiple times 109181834Sroberto -x no slew Slew up to 600 seconds 110181834Sroberto opt version Output version information and exit 111200576Sroberto -? no help Display extended usage information and exit 112181834Sroberto -! no more-help Extended usage information passed thru pager 113181834Sroberto 114181834SrobertoOptions are specified by doubled hyphens and their name 115181834Srobertoor by a single hyphen and the flag character. 116181834Sroberto 117181834SrobertoThe following option preset mechanisms are supported: 118181834Sroberto - examining environment variables named NTPD_* 119181834Sroberto 120181834Sroberto 121181834Sroberto 122181834Srobertoplease send bug reports to: http://bugs.ntp.org, bugs@@ntp.org 123181834Sroberto@end example 124181834Sroberto@exampleindent 4 125181834Sroberto 126181834Sroberto@node ntpd ipv4 127181834Sroberto@subsection ipv4 option (-4) 128181834Sroberto@cindex ntpd-ipv4 129181834Sroberto 130181834SrobertoThis is the ``force ipv4 dns name resolution'' option. 131181834Sroberto 132181834SrobertoThis option has some usage constraints. It: 133181834Sroberto@itemize @bullet 134181834Sroberto@item 135181834Srobertois a member of the ipv4 class of options. 136181834Sroberto@end itemize 137181834Sroberto 138181834SrobertoForce DNS resolution of following host names on the command line 139181834Srobertoto the IPv4 namespace. 140181834Sroberto 141181834Sroberto@node ntpd ipv6 142181834Sroberto@subsection ipv6 option (-6) 143181834Sroberto@cindex ntpd-ipv6 144181834Sroberto 145181834SrobertoThis is the ``force ipv6 dns name resolution'' option. 146181834Sroberto 147181834SrobertoThis option has some usage constraints. It: 148181834Sroberto@itemize @bullet 149181834Sroberto@item 150181834Srobertois a member of the ipv4 class of options. 151181834Sroberto@end itemize 152181834Sroberto 153181834SrobertoForce DNS resolution of following host names on the command line 154181834Srobertoto the IPv6 namespace. 155181834Sroberto 156181834Sroberto@node ntpd authreq 157181834Sroberto@subsection authreq option (-a) 158181834Sroberto@cindex ntpd-authreq 159181834Sroberto 160181834SrobertoThis is the ``require crypto authentication'' option. 161181834Sroberto 162181834SrobertoThis option has some usage constraints. It: 163181834Sroberto@itemize @bullet 164181834Sroberto@item 165181834Srobertomust not appear in combination with any of the following options: 166181834Srobertoauthnoreq. 167181834Sroberto@end itemize 168181834Sroberto 169181834SrobertoRequire cryptographic authentication for broadcast client, 170181834Srobertomulticast client and symmetric passive associations. 171181834SrobertoThis is the default. 172181834Sroberto 173181834Sroberto@node ntpd authnoreq 174181834Sroberto@subsection authnoreq option (-A) 175181834Sroberto@cindex ntpd-authnoreq 176181834Sroberto 177181834SrobertoThis is the ``do not require crypto authentication'' option. 178181834Sroberto 179181834SrobertoThis option has some usage constraints. It: 180181834Sroberto@itemize @bullet 181181834Sroberto@item 182181834Srobertomust not appear in combination with any of the following options: 183181834Srobertoauthreq. 184181834Sroberto@end itemize 185181834Sroberto 186181834SrobertoDo not require cryptographic authentication for broadcast client, 187181834Srobertomulticast client and symmetric passive associations. 188181834SrobertoThis is almost never a good idea. 189181834Sroberto 190181834Sroberto@node ntpd bcastsync 191181834Sroberto@subsection bcastsync option (-b) 192181834Sroberto@cindex ntpd-bcastsync 193181834Sroberto 194181834SrobertoThis is the ``allow us to sync to broadcast servers'' option. 195181834Sroberto 196181834Sroberto 197181834Sroberto@node ntpd configfile 198181834Sroberto@subsection configfile option (-c) 199181834Sroberto@cindex ntpd-configfile 200181834Sroberto 201181834SrobertoThis is the ``configuration file name'' option. 202181834SrobertoThe name and path of the configuration file, 203181834Sroberto/etc/ntp.conf 204181834Srobertoby default. 205181834Sroberto 206181834Sroberto@node ntpd debug-level 207181834Sroberto@subsection debug-level option (-d) 208181834Sroberto@cindex ntpd-debug-level 209181834Sroberto 210181834SrobertoThis is the ``increase output debug message level'' option. 211181834Sroberto 212181834SrobertoThis option has some usage constraints. It: 213181834Sroberto@itemize @bullet 214181834Sroberto@item 215181834Srobertomay appear an unlimited number of times. 216181834Sroberto@item 217181834Srobertomust be compiled in by defining @code{DEBUG} during the compilation. 218181834Sroberto@end itemize 219181834Sroberto 220181834SrobertoIncrease the debugging message output level. 221181834Sroberto 222181834Sroberto@node ntpd set-debug-level 223181834Sroberto@subsection set-debug-level option (-D) 224181834Sroberto@cindex ntpd-set-debug-level 225181834Sroberto 226181834SrobertoThis is the ``set the output debug message level'' option. 227181834Sroberto 228181834SrobertoThis option has some usage constraints. It: 229181834Sroberto@itemize @bullet 230181834Sroberto@item 231181834Srobertomay appear an unlimited number of times. 232181834Sroberto@item 233181834Srobertomust be compiled in by defining @code{DEBUG} during the compilation. 234181834Sroberto@end itemize 235181834Sroberto 236181834SrobertoSet the output debugging level. Can be supplied multiple times, 237181834Srobertobut each overrides the previous value(s). 238181834Sroberto 239181834Sroberto@node ntpd driftfile 240181834Sroberto@subsection driftfile option (-f) 241181834Sroberto@cindex ntpd-driftfile 242181834Sroberto 243181834SrobertoThis is the ``frequency drift file name'' option. 244181834SrobertoThe name and path of the frequency file, 245181834Sroberto/etc/ntp.drift 246181834Srobertoby default. 247181834SrobertoThis is the same operation as the 248181834Srobertodriftfile driftfile 249181834Srobertoconfiguration specification in the 250181834Sroberto/etc/ntp.conf 251181834Srobertofile. 252181834Sroberto 253181834Sroberto@node ntpd panicgate 254181834Sroberto@subsection panicgate option (-g) 255181834Sroberto@cindex ntpd-panicgate 256181834Sroberto 257181834SrobertoThis is the ``allow the first adjustment to be big'' option. 258181834SrobertoNormally, 259181834Srobertontpd 260181834Srobertoexits 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, 261181834Srobertontpd 262181834Srobertowill exit with a message to the system log. This option can be used with the 263181834Sroberto-q 264181834Srobertoand 265181834Sroberto-x 266181834Srobertooptions. 267181834SrobertoSee the 268181834Srobertotinker 269181834Srobertoconfiguration file directive for other options. 270181834Sroberto 271181834Sroberto@node ntpd jaildir 272181834Sroberto@subsection jaildir option (-i) 273181834Sroberto@cindex ntpd-jaildir 274181834Sroberto 275181834SrobertoThis is the ``jail directory'' option. 276181834SrobertoChroot the server to the directory 277181834Srobertojaildir 278181834Sroberto. 279181834SrobertoThis option also implies that the server attempts to drop root privileges at startup (otherwise, chroot gives very little additional security), and it is only available if the OS supports to run the server without full root privileges. 280181834SrobertoYou may need to also specify a 281181834Sroberto-u 282181834Srobertooption. 283181834Sroberto 284181834Sroberto@node ntpd interface 285181834Sroberto@subsection interface option (-I) 286181834Sroberto@cindex ntpd-interface 287181834Sroberto 288181834SrobertoThis is the ``listen on interface'' option. 289181834Sroberto 290181834SrobertoThis option has some usage constraints. It: 291181834Sroberto@itemize @bullet 292181834Sroberto@item 293181834Srobertomay appear an unlimited number of times. 294181834Sroberto@end itemize 295181834Sroberto 296181834Sroberto 297181834Sroberto 298181834Sroberto@node ntpd keyfile 299181834Sroberto@subsection keyfile option (-k) 300181834Sroberto@cindex ntpd-keyfile 301181834Sroberto 302181834SrobertoThis is the ``path to symmetric keys'' option. 303181834SrobertoSpecify the name and path of the symmetric key file. 304181834Sroberto/etc/ntp.keys 305181834Srobertois the default. 306181834SrobertoThis is the same operation as the 307181834Srobertokeys keyfile 308181834Srobertoconfiguration file directive. 309181834Sroberto 310181834Sroberto@node ntpd logfile 311181834Sroberto@subsection logfile option (-l) 312181834Sroberto@cindex ntpd-logfile 313181834Sroberto 314181834SrobertoThis is the ``path to the log file'' option. 315181834SrobertoSpecify the name and path of the log file. 316181834SrobertoThe default is the system log file. 317181834SrobertoThis is the same operation as the 318181834Srobertologfile logfile 319181834Srobertoconfiguration file directive. 320181834Sroberto 321181834Sroberto@node ntpd novirtualips 322181834Sroberto@subsection novirtualips option (-L) 323181834Sroberto@cindex ntpd-novirtualips 324181834Sroberto 325181834SrobertoThis is the ``do not listen to virtual ips'' option. 326181834SrobertoDo not listen to virtual IPs. The default is to listen. 327181834Sroberto 328181834Sroberto@node ntpd modifymmtimer 329181834Sroberto@subsection modifymmtimer option (-M) 330181834Sroberto@cindex ntpd-modifymmtimer 331181834Sroberto 332181834SrobertoThis is the ``modify multimedia timer (windows only)'' option. 333181834Sroberto 334181834SrobertoThis option has some usage constraints. It: 335181834Sroberto@itemize @bullet 336181834Sroberto@item 337181834Srobertomust be compiled in by defining @code{SYS_WINNT} during the compilation. 338181834Sroberto@end itemize 339181834Sroberto 340181834SrobertoSet the Windows Multimedia Timer to highest resolution. 341181834Sroberto 342181834Sroberto@node ntpd nofork 343181834Sroberto@subsection nofork option (-n) 344181834Sroberto@cindex ntpd-nofork 345181834Sroberto 346181834SrobertoThis is the ``do not fork'' option. 347181834Sroberto 348181834Sroberto 349181834Sroberto@node ntpd nice 350181834Sroberto@subsection nice option (-N) 351181834Sroberto@cindex ntpd-nice 352181834Sroberto 353181834SrobertoThis is the ``run at high priority'' option. 354181834SrobertoTo the extent permitted by the operating system, run 355181834Srobertontpd 356181834Srobertoat the highest priority. 357181834Sroberto 358181834Sroberto@node ntpd pidfile 359181834Sroberto@subsection pidfile option (-p) 360181834Sroberto@cindex ntpd-pidfile 361181834Sroberto 362181834SrobertoThis is the ``path to the pid file'' option. 363181834SrobertoSpecify the name and path of the file used to record 364181834Srobertontpd's 365181834Srobertoprocess ID. 366181834SrobertoThis is the same operation as the 367181834Srobertopidfile pidfile 368181834Srobertoconfiguration file directive. 369181834Sroberto 370181834Sroberto@node ntpd priority 371181834Sroberto@subsection priority option (-P) 372181834Sroberto@cindex ntpd-priority 373181834Sroberto 374181834SrobertoThis is the ``process priority'' option. 375181834SrobertoTo the extent permitted by the operating system, run 376181834Srobertontpd 377181834Srobertoat the specified 378181834Srobertosched_setscheduler(SCHED_FIFO) 379181834Srobertopriority. 380181834Sroberto 381181834Sroberto@node ntpd quit 382181834Sroberto@subsection quit option (-q) 383181834Sroberto@cindex ntpd-quit 384181834Sroberto 385181834SrobertoThis is the ``set the time and quit'' option. 386181834Srobertontpd 387181834Srobertowill exit just after the first time the clock is set. This behavior mimics that of the 388181834Srobertontpdate 389181834Srobertoprogram, which is to be retired. 390181834SrobertoThe 391181834Sroberto-g 392181834Srobertoand 393181834Sroberto-x 394181834Srobertooptions can be used with this option. 395181834SrobertoNote: The kernel time discipline is disabled with this option. 396181834Sroberto 397181834Sroberto@node ntpd propagationdelay 398181834Sroberto@subsection propagationdelay option (-r) 399181834Sroberto@cindex ntpd-propagationdelay 400181834Sroberto 401181834SrobertoThis is the ``broadcast/propagation delay'' option. 402181834SrobertoSpecify 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. 403181834Sroberto 404181834Sroberto@node ntpd updateinterval 405181834Sroberto@subsection updateinterval option (-U) 406181834Sroberto@cindex ntpd-updateinterval 407181834Sroberto 408181834SrobertoThis is the ``interval in seconds between scans for new or dropped interfaces'' option. 409181834SrobertoGive the time in seconds between two scans for new or dropped interfaces. 410181834SrobertoFor systems with routing socket support the scans will be performed shortly after the interface change 411181834Srobertohas been detected by the system. 412181834SrobertoUse 0 to disable scanning. 413181834Sroberto 414181834Sroberto@node ntpd statsdir 415181834Sroberto@subsection statsdir option (-s) 416181834Sroberto@cindex ntpd-statsdir 417181834Sroberto 418181834SrobertoThis is the ``statistics file location'' option. 419181834SrobertoSpecify the directory path for files created by the statistics facility. 420181834SrobertoThis is the same operation as the 421181834Srobertostatsdir statsdir 422181834Srobertoconfiguration file directive. 423181834Sroberto 424181834Sroberto@node ntpd trustedkey 425181834Sroberto@subsection trustedkey option (-t) 426181834Sroberto@cindex ntpd-trustedkey 427181834Sroberto 428181834SrobertoThis is the ``trusted key number'' option. 429181834Sroberto 430181834SrobertoThis option has some usage constraints. It: 431181834Sroberto@itemize @bullet 432181834Sroberto@item 433181834Srobertomay appear an unlimited number of times. 434181834Sroberto@end itemize 435181834Sroberto 436181834SrobertoAdd a key number to the trusted key list. 437181834Sroberto 438181834Sroberto@node ntpd user 439181834Sroberto@subsection user option (-u) 440181834Sroberto@cindex ntpd-user 441181834Sroberto 442181834SrobertoThis is the ``run as userid (or userid:groupid)'' option. 443181834SrobertoSpecify a user, and optionally a group, to switch to. 444181834SrobertoThis option is only available if the OS supports to run the server without full root privileges. 445181834SrobertoCurrently, this option is supported under NetBSD (configure with 446181834Sroberto--enable-clockctl 447181834Sroberto) and Linux (configure with 448181834Sroberto--enable-linuxcaps 449181834Sroberto). 450181834Sroberto 451181834Sroberto@node ntpd var 452181834Sroberto@subsection var option (-v) 453181834Sroberto@cindex ntpd-var 454181834Sroberto 455181834SrobertoThis is the ``make arg an ntp variable (rw)'' option. 456181834Sroberto 457181834SrobertoThis option has some usage constraints. It: 458181834Sroberto@itemize @bullet 459181834Sroberto@item 460181834Srobertomay appear an unlimited number of times. 461181834Sroberto@end itemize 462181834Sroberto 463181834Sroberto 464181834Sroberto 465181834Sroberto@node ntpd dvar 466181834Sroberto@subsection dvar option (-V) 467181834Sroberto@cindex ntpd-dvar 468181834Sroberto 469181834SrobertoThis is the ``make arg an ntp variable (rw|def)'' option. 470181834Sroberto 471181834SrobertoThis option has some usage constraints. It: 472181834Sroberto@itemize @bullet 473181834Sroberto@item 474181834Srobertomay appear an unlimited number of times. 475181834Sroberto@end itemize 476181834Sroberto 477181834Sroberto 478181834Sroberto 479181834Sroberto@node ntpd slew 480181834Sroberto@subsection slew option (-x) 481181834Sroberto@cindex ntpd-slew 482181834Sroberto 483181834SrobertoThis is the ``slew up to 600 seconds'' option. 484181834SrobertoNormally, 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. 485181834SrobertoThis option sets the threshold to 600 s, which is well within the accuracy window to set the clock manually. 486181834SrobertoNote: 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. 487181834SrobertoThus, an adjustment as much as 600 s will take almost 14 days to complete. 488181834SrobertoThis option can be used with the 489181834Sroberto-g 490181834Srobertoand 491181834Sroberto-q 492181834Srobertooptions. 493181834SrobertoSee the 494181834Srobertotinker 495181834Srobertoconfiguration file directive for other options. 496181834SrobertoNote: The kernel time discipline is disabled with this option. 497