ntpd.1ntpdman revision 310419
1189049Srnoland.de1 NOP 2189049Srnoland. it 1 an-trap 3189049Srnoland. if \\n[.$] \,\\$*\/ 4189049Srnoland.. 5189049Srnoland.ie t \ 6189049Srnoland.ds B-Font [CB] 7189049Srnoland.ds I-Font [CI] 8189049Srnoland.ds R-Font [CR] 9189049Srnoland.el \ 10189049Srnoland.ds B-Font B 11189049Srnoland.ds I-Font I 12189049Srnoland.ds R-Font R 13189049Srnoland.TH ntpd 1ntpdman "21 Nov 2016" "4.2.8p9" "User Commands" 14189049Srnoland.\" 15189049Srnoland.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-giaGkh/ag-tiayjh) 16189049Srnoland.\" 17189049Srnoland.\" It has been AutoGen-ed November 21, 2016 at 08:01:50 AM by AutoGen 5.18.5 18189049Srnoland.\" From the definitions ntpd-opts.def 19189049Srnoland.\" and the template file agman-cmd.tpl 20189049Srnoland.SH NAME 21189049Srnoland\f\*[B-Font]ntpd\fP 22189049Srnoland\- NTP daemon program 23189049Srnoland.SH SYNOPSIS 24189049Srnoland\f\*[B-Font]ntpd\fP 25189049Srnoland.\" Mixture of short (flag) options and long options 26189049Srnoland[\f\*[B-Font]\-flags\f[]] 27189049Srnoland[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]] 28189049Srnoland[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]] 29189049Srnoland[ <server1> ... <serverN> ] 30189049Srnoland.sp \n(Ppu 31189049Srnoland.ne 2 32189049Srnoland 33189049Srnoland.SH DESCRIPTION 34189049SrnolandThe 35189049Srnoland\f\*[B-Font]ntpd\fP 36189049Srnolandutility is an operating system daemon which sets 37189049Srnolandand maintains the system time of day in synchronism with Internet 38189049Srnolandstandard time servers. 39189049SrnolandIt is a complete implementation of the 40189049SrnolandNetwork Time Protocol (NTP) version 4, as defined by RFC-5905, 41190020Srnolandbut also retains compatibility with 42189049Srnolandversion 3, as defined by RFC-1305, and versions 1 43189049Srnolandand 2, as defined by RFC-1059 and RFC-1119, respectively. 44189049Srnoland.sp \n(Ppu 45189049Srnoland.ne 2 46189049Srnoland 47189049SrnolandThe 48189049Srnoland\f\*[B-Font]ntpd\fP 49189049Srnolandutility does most computations in 64-bit floating point 50189049Srnolandarithmetic and does relatively clumsy 64-bit fixed point operations 51190020Srnolandonly when necessary to preserve the ultimate precision, about 232 52190020Srnolandpicoseconds. 53190020SrnolandWhile the ultimate precision is not achievable with 54190020Srnolandordinary workstations and networks of today, it may be required 55190020Srnolandwith future gigahertz CPU clocks and gigabit LANs. 56190020Srnoland.sp \n(Ppu 57189049Srnoland.ne 2 58189049Srnoland 59189049SrnolandOrdinarily, 60189049Srnoland\f\*[B-Font]ntpd\fP 61189049Srnolandreads the 62189049Srnoland\fCntp.conf\f[]\fR(5)\f[] 63189049Srnolandconfiguration file at startup time in order to determine the 64189049Srnolandsynchronization sources and operating modes. 65189049SrnolandIt is also possible to 66189049Srnolandspecify a working, although limited, configuration entirely on the 67189049Srnolandcommand line, obviating the need for a configuration file. 68189049SrnolandThis may 69189049Srnolandbe particularly useful when the local host is to be configured as a 70189049Srnolandbroadcast/multicast client, with all peers being determined by 71189049Srnolandlistening to broadcasts at run time. 72189049Srnoland.sp \n(Ppu 73189049Srnoland.ne 2 74189049Srnoland 75189049SrnolandIf NetInfo support is built into 76189049Srnoland\f\*[B-Font]ntpd\fP, 77189049Srnolandthen 78189049Srnoland\f\*[B-Font]ntpd\fP 79189049Srnolandwill attempt to read its configuration from the 80189049SrnolandNetInfo if the default 81189049Srnoland\fCntp.conf\f[]\fR(5)\f[] 82189049Srnolandfile cannot be read and no file is 83189049Srnolandspecified by the 84189049Srnoland\f\*[B-Font]\-c\f[] 85189049Srnolandoption. 86189049Srnoland.sp \n(Ppu 87189049Srnoland.ne 2 88189049Srnoland 89189049SrnolandVarious internal 90189049Srnoland\f\*[B-Font]ntpd\fP 91189049Srnolandvariables can be displayed and 92189049Srnolandconfiguration options altered while the 93189049Srnoland\f\*[B-Font]ntpd\fP 94189049Srnolandis running 95189049Srnolandusing the 96189049Srnoland\fCntpq\f[]\fR(1ntpqmdoc)\f[] 97189049Srnolandand 98189049Srnoland\fCntpdc\f[]\fR(1ntpdcmdoc)\f[] 99189049Srnolandutility programs. 100189049Srnoland.sp \n(Ppu 101189049Srnoland.ne 2 102189049Srnoland 103189049SrnolandWhen 104189049Srnoland\f\*[B-Font]ntpd\fP 105189049Srnolandstarts it looks at the value of 106189049Srnoland\fCumask\f[]\fR(2)\f[], 107189049Srnolandand if zero 108189049Srnoland\f\*[B-Font]ntpd\fP 109189049Srnolandwill set the 110189049Srnoland\fCumask\f[]\fR(2)\f[] 111189049Srnolandto 022. 112189049Srnoland.SH "OPTIONS" 113189049Srnoland.TP 114189049Srnoland.NOP \f\*[B-Font]\-4\f[], \f\*[B-Font]\-\-ipv4\f[] 115189049SrnolandForce IPv4 DNS name resolution. 116189049SrnolandThis option must not appear in combination with any of the following options: 117189049Srnolandipv6. 118189049Srnoland.sp 119189049SrnolandForce DNS resolution of following host names on the command line 120189049Srnolandto the IPv4 namespace. 121189049Srnoland.TP 122189049Srnoland.NOP \f\*[B-Font]\-6\f[], \f\*[B-Font]\-\-ipv6\f[] 123189049SrnolandForce IPv6 DNS name resolution. 124189049SrnolandThis option must not appear in combination with any of the following options: 125189049Srnolandipv4. 126189049Srnoland.sp 127189049SrnolandForce DNS resolution of following host names on the command line 128189049Srnolandto the IPv6 namespace. 129189049Srnoland.TP 130189049Srnoland.NOP \f\*[B-Font]\-a\f[], \f\*[B-Font]\-\-authreq\f[] 131189049SrnolandRequire crypto authentication. 132189049SrnolandThis option must not appear in combination with any of the following options: 133189049Srnolandauthnoreq. 134189049Srnoland.sp 135189049SrnolandRequire cryptographic authentication for broadcast client, 136189049Srnolandmulticast client and symmetric passive associations. 137189049SrnolandThis is the default. 138189049Srnoland.TP 139189049Srnoland.NOP \f\*[B-Font]\-A\f[], \f\*[B-Font]\-\-authnoreq\f[] 140189049SrnolandDo not require crypto authentication. 141189049SrnolandThis option must not appear in combination with any of the following options: 142189049Srnolandauthreq. 143189049Srnoland.sp 144189049SrnolandDo not require cryptographic authentication for broadcast client, 145189049Srnolandmulticast client and symmetric passive associations. 146189049SrnolandThis is almost never a good idea. 147189049Srnoland.TP 148189049Srnoland.NOP \f\*[B-Font]\-b\f[], \f\*[B-Font]\-\-bcastsync\f[] 149189049SrnolandAllow us to sync to broadcast servers. 150189049Srnoland.sp 151189049Srnoland.TP 152189049Srnoland.NOP \f\*[B-Font]\-c\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-configfile\f[]=\f\*[I-Font]string\f[] 153189049Srnolandconfiguration file name. 154189049Srnoland.sp 155189049SrnolandThe name and path of the configuration file, 156189049Srnoland\fI/etc/ntp.conf\fP 157189049Srnolandby default. 158189049Srnoland.TP 159189049Srnoland.NOP \f\*[B-Font]\-d\f[], \f\*[B-Font]\-\-debug\-level\f[] 160189049SrnolandIncrease debug verbosity level. 161189049SrnolandThis option may appear an unlimited number of times. 162189049Srnoland.sp 163189049Srnoland.TP 164189049Srnoland.NOP \f\*[B-Font]\-D\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-set\-debug\-level\f[]=\f\*[I-Font]number\f[] 165189049SrnolandSet the debug verbosity level. 166189049SrnolandThis option may appear an unlimited number of times. 167189049SrnolandThis option takes an integer number as its argument. 168189049Srnoland.sp 169189049Srnoland.TP 170189049Srnoland.NOP \f\*[B-Font]\-f\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-driftfile\f[]=\f\*[I-Font]string\f[] 171189049Srnolandfrequency drift file name. 172189049Srnoland.sp 173189049SrnolandThe name and path of the frequency file, 174189049Srnoland\fI/etc/ntp.drift\fP 175189049Srnolandby default. 176189049SrnolandThis is the same operation as the 177189049Srnoland\fBdriftfile\fP \fIdriftfile\fP 178189049Srnolandconfiguration specification in the 179189049Srnoland\fI/etc/ntp.conf\fP 180189049Srnolandfile. 181189049Srnoland.TP 182189049Srnoland.NOP \f\*[B-Font]\-g\f[], \f\*[B-Font]\-\-panicgate\f[] 183189049SrnolandAllow the first adjustment to be Big. 184189049SrnolandThis option may appear an unlimited number of times. 185189049Srnoland.sp 186189049SrnolandNormally, 187190020Srnoland\fBntpd\fP 188190020Srnolandexits 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, 189190020Srnoland\fBntpd\fP 190190020Srnolandwill exit with a message to the system log. This option can be used with the 191190020Srnoland\fB-q\fP 192190020Srnolandand 193190020Srnoland\fB-x\fP 194190020Srnolandoptions. 195190020SrnolandSee the 196190020Srnoland\fBtinker\fP 197190020Srnolandconfiguration file directive for other options. 198190020Srnoland.TP 199190020Srnoland.NOP \f\*[B-Font]\-G\f[], \f\*[B-Font]\-\-force\-step\-once\f[] 200190020SrnolandStep any initial offset correction.. 201190020Srnoland.sp 202190020SrnolandNormally, 203190020Srnoland\fBntpd\fP 204190020Srnolandsteps the time if the time offset exceeds the step threshold, 205190020Srnolandwhich is 128 ms by default, and otherwise slews the time. 206189049SrnolandThis option forces the initial offset correction to be stepped, 207189049Srnolandso the highest time accuracy can be achieved quickly. 208189049SrnolandHowever, this may also cause the time to be stepped back 209189049Srnolandso this option must not be used if 210189049Srnolandapplications requiring monotonic time are running. 211189049SrnolandSee the \fBtinker\fP configuration file directive for other options. 212189049Srnoland.TP 213189049Srnoland.NOP \f\*[B-Font]\-i\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-jaildir\f[]=\f\*[I-Font]string\f[] 214189049SrnolandJail directory. 215189049Srnoland.sp 216189049SrnolandChroot the server to the directory 217189049Srnoland\fIjaildir\fP 218189049Srnoland. 219189049SrnolandThis option also implies that the server attempts to drop root privileges at startup. 220189049SrnolandYou may need to also specify a 221189049Srnoland\fB-u\fP 222189049Srnolandoption. 223189049SrnolandThis option is only available if the OS supports adjusting the clock 224189049Srnolandwithout full root privileges. 225189049SrnolandThis option is supported under NetBSD (configure with 226189049Srnoland\fB--enable-clockctl\fP) or Linux (configure with 227189049Srnoland\fB--enable-linuxcaps\fP) or Solaris (configure with \fB--enable-solarisprivs\fP). 228189049Srnoland.TP 229189049Srnoland.NOP \f\*[B-Font]\-I\f[] \f\*[I-Font]iface\f[], \f\*[B-Font]\-\-interface\f[]=\f\*[I-Font]iface\f[] 230189049SrnolandListen on an interface name or address. 231189049SrnolandThis option may appear an unlimited number of times. 232189049Srnoland.sp 233189049SrnolandOpen the network address given, or all the addresses associated with the 234189049Srnolandgiven interface name. This option may appear multiple times. This option 235189049Srnolandalso implies not opening other addresses, except wildcard and localhost. 236189049SrnolandThis option is deprecated. Please consider using the configuration file 237189049Srnoland\fBinterface\fP command, which is more versatile. 238189049Srnoland.TP 239189049Srnoland.NOP \f\*[B-Font]\-k\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-keyfile\f[]=\f\*[I-Font]string\f[] 240189049Srnolandpath to symmetric keys. 241189049Srnoland.sp 242189049SrnolandSpecify the name and path of the symmetric key file. 243189049Srnoland\fI/etc/ntp.keys\fP 244189049Srnolandis the default. 245189049SrnolandThis is the same operation as the 246189049Srnoland\fBkeys\fP \fIkeyfile\fP 247189049Srnolandconfiguration file directive. 248189049Srnoland.TP 249189049Srnoland.NOP \f\*[B-Font]\-l\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-logfile\f[]=\f\*[I-Font]string\f[] 250189049Srnolandpath to the log file. 251189049Srnoland.sp 252189049SrnolandSpecify the name and path of the log file. 253189049SrnolandThe default is the system log file. 254189049SrnolandThis is the same operation as the 255189049Srnoland\fBlogfile\fP \fIlogfile\fP 256189049Srnolandconfiguration file directive. 257189049Srnoland.TP 258189049Srnoland.NOP \f\*[B-Font]\-L\f[], \f\*[B-Font]\-\-novirtualips\f[] 259189049SrnolandDo not listen to virtual interfaces. 260189049Srnoland.sp 261189049SrnolandDo not listen to virtual interfaces, defined as those with 262189049Srnolandnames containing a colon. This option is deprecated. Please 263189049Srnolandconsider using the configuration file \fBinterface\fP command, which 264189049Srnolandis more versatile. 265189049Srnoland.TP 266189049Srnoland.NOP \f\*[B-Font]\-M\f[], \f\*[B-Font]\-\-modifymmtimer\f[] 267189049SrnolandModify Multimedia Timer (Windows only). 268189049Srnoland.sp 269189049SrnolandSet the Windows Multimedia Timer to highest resolution. This 270189049Srnolandensures the resolution does not change while ntpd is running, 271189049Srnolandavoiding timekeeping glitches associated with changes. 272189049Srnoland.TP 273189049Srnoland.NOP \f\*[B-Font]\-n\f[], \f\*[B-Font]\-\-nofork\f[] 274189049SrnolandDo not fork. 275190020SrnolandThis option must not appear in combination with any of the following options: 276189049Srnolandwait-sync. 277189049Srnoland.sp 278189049Srnoland.TP 279189049Srnoland.NOP \f\*[B-Font]\-N\f[], \f\*[B-Font]\-\-nice\f[] 280189049SrnolandRun at high priority. 281189049Srnoland.sp 282189049SrnolandTo the extent permitted by the operating system, run 283189049Srnoland\fBntpd\fP 284189049Srnolandat the highest priority. 285189049Srnoland.TP 286189049Srnoland.NOP \f\*[B-Font]\-p\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-pidfile\f[]=\f\*[I-Font]string\f[] 287189049Srnolandpath to the PID file. 288189049Srnoland.sp 289189049SrnolandSpecify the name and path of the file used to record 290189049Srnoland\fBntpd\fP's 291189049Srnolandprocess ID. 292189049SrnolandThis is the same operation as the 293189049Srnoland\fBpidfile\fP \fIpidfile\fP 294189049Srnolandconfiguration file directive. 295189049Srnoland.TP 296189049Srnoland.NOP \f\*[B-Font]\-P\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-priority\f[]=\f\*[I-Font]number\f[] 297189049SrnolandProcess priority. 298189049SrnolandThis option takes an integer number as its argument. 299189049Srnoland.sp 300189049SrnolandTo the extent permitted by the operating system, run 301189049Srnoland\fBntpd\fP 302189049Srnolandat the specified 303189049Srnoland\fBsched_setscheduler(SCHED_FIFO)\fP 304189049Srnolandpriority. 305189049Srnoland.TP 306189049Srnoland.NOP \f\*[B-Font]\-q\f[], \f\*[B-Font]\-\-quit\f[] 307189049SrnolandSet the time and quit. 308189049SrnolandThis option must not appear in combination with any of the following options: 309189049Srnolandsaveconfigquit, wait-sync. 310189049Srnoland.sp 311189049Srnoland\fBntpd\fP 312189049Srnolandwill not daemonize and will exit after the clock is first 313189049Srnolandsynchronized. This behavior mimics that of the 314189049Srnoland\fBntpdate\fP 315189049Srnolandprogram, which will soon be replaced with a shell script. 316189049SrnolandThe 317189049Srnoland\fB-g\fP 318189049Srnolandand 319189049Srnoland\fB-x\fP 320189049Srnolandoptions can be used with this option. 321189049SrnolandNote: The kernel time discipline is disabled with this option. 322189049Srnoland.TP 323189049Srnoland.NOP \f\*[B-Font]\-r\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-propagationdelay\f[]=\f\*[I-Font]string\f[] 324189049SrnolandBroadcast/propagation delay. 325189049Srnoland.sp 326189049SrnolandSpecify 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. 327189049Srnoland.TP 328189049Srnoland.NOP \f\*[B-Font]\-\-saveconfigquit\f[]=\f\*[I-Font]string\f[] 329189049SrnolandSave parsed configuration and quit. 330189049SrnolandThis option must not appear in combination with any of the following options: 331189049Srnolandquit, wait-sync. 332189049Srnoland.sp 333189049SrnolandCause \fBntpd\fP to parse its startup configuration file and save an 334189049Srnolandequivalent to the given filename and exit. This option was 335189049Srnolanddesigned for automated testing. 336189049Srnoland.TP 337189049Srnoland.NOP \f\*[B-Font]\-s\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-statsdir\f[]=\f\*[I-Font]string\f[] 338189049SrnolandStatistics file location. 339189049Srnoland.sp 340189049SrnolandSpecify the directory path for files created by the statistics facility. 341189049SrnolandThis is the same operation as the 342189049Srnoland\fBstatsdir\fP \fIstatsdir\fP 343189049Srnolandconfiguration file directive. 344189049Srnoland.TP 345189049Srnoland.NOP \f\*[B-Font]\-t\f[] \f\*[I-Font]tkey\f[], \f\*[B-Font]\-\-trustedkey\f[]=\f\*[I-Font]tkey\f[] 346189049SrnolandTrusted key number. 347189049SrnolandThis option may appear an unlimited number of times. 348189049Srnoland.sp 349189049SrnolandAdd the specified key number to the trusted key list. 350189049Srnoland.TP 351189049Srnoland.NOP \f\*[B-Font]\-u\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-user\f[]=\f\*[I-Font]string\f[] 352261455SeadlerRun as userid (or userid:groupid). 353189049Srnoland.sp 354189049SrnolandSpecify a user, and optionally a group, to switch to. 355189049SrnolandThis option is only available if the OS supports adjusting the clock 356189049Srnolandwithout full root privileges. 357189049SrnolandThis option is supported under NetBSD (configure with 358189049Srnoland\fB--enable-clockctl\fP) or Linux (configure with 359189049Srnoland\fB--enable-linuxcaps\fP) or Solaris (configure with \fB--enable-solarisprivs\fP). 360189049Srnoland.TP 361189049Srnoland.NOP \f\*[B-Font]\-U\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-updateinterval\f[]=\f\*[I-Font]number\f[] 362189049Srnolandinterval in seconds between scans for new or dropped interfaces. 363189049SrnolandThis option takes an integer number as its argument. 364189049Srnoland.sp 365205120SrnolandGive the time in seconds between two scans for new or dropped interfaces. 366189049SrnolandFor systems with routing socket support the scans will be performed shortly after the interface change 367189049Srnolandhas been detected by the system. 368189049SrnolandUse 0 to disable scanning. 60 seconds is the minimum time between scans. 369189049Srnoland.TP 370189049Srnoland.NOP \f\*[B-Font]\-\-var\f[]=\f\*[I-Font]nvar\f[] 371189049Srnolandmake ARG an ntp variable (RW). 372189049SrnolandThis option may appear an unlimited number of times. 373189049Srnoland.sp 374189049Srnoland.TP 375189049Srnoland.NOP \f\*[B-Font]\-\-dvar\f[]=\f\*[I-Font]ndvar\f[] 376189049Srnolandmake ARG an ntp variable (RW|DEF). 377189049SrnolandThis option may appear an unlimited number of times. 378189049Srnoland.sp 379189049Srnoland.TP 380189049Srnoland.NOP \f\*[B-Font]\-w\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-wait\-sync\f[]=\f\*[I-Font]number\f[] 381189049SrnolandSeconds to wait for first clock sync. 382189049SrnolandThis option must not appear in combination with any of the following options: 383189049Srnolandnofork, quit, saveconfigquit. 384189049SrnolandThis option takes an integer number as its argument. 385189049Srnoland.sp 386189049SrnolandIf greater than zero, alters \fBntpd\fP's behavior when forking to 387189049Srnolanddaemonize. Instead of exiting with status 0 immediately after 388189049Srnolandthe fork, the parent waits up to the specified number of 389189049Srnolandseconds for the child to first synchronize the clock. The exit 390189049Srnolandstatus is zero (success) if the clock was synchronized, 391189049Srnolandotherwise it is \fBETIMEDOUT\fP. 392189049SrnolandThis provides the option for a script starting \fBntpd\fP to easily 393189049Srnolandwait for the first set of the clock before proceeding. 394189049Srnoland.TP 395189049Srnoland.NOP \f\*[B-Font]\-x\f[], \f\*[B-Font]\-\-slew\f[] 396189049SrnolandSlew up to 600 seconds. 397189049Srnoland.sp 398189049SrnolandNormally, 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. 399189049SrnolandThis option sets the threshold to 600 s, which is well within the accuracy window to set the clock manually. 400189049SrnolandNote: 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. 401189049SrnolandThus, an adjustment as much as 600 s will take almost 14 days to complete. 402189049SrnolandThis option can be used with the 403189049Srnoland\fB-g\fP 404189049Srnolandand 405189049Srnoland\fB-q\fP 406189049Srnolandoptions. 407189049SrnolandSee the 408189049Srnoland\fBtinker\fP 409189049Srnolandconfiguration file directive for other options. 410189049SrnolandNote: The kernel time discipline is disabled with this option. 411189049Srnoland.TP 412189049Srnoland.NOP \f\*[B-Font]\-\-usepcc\f[] 413189049SrnolandUse CPU cycle counter (Windows only). 414189049Srnoland.sp 415189049SrnolandAttempt to substitute the CPU counter for \fBQueryPerformanceCounter\fP. 416189049SrnolandThe CPU counter and \fBQueryPerformanceCounter\fP are compared, and if 417189049Srnolandthey have the same frequency, the CPU counter (RDTSC on x86) is 418189049Srnolandused directly, saving the overhead of a system call. 419189049Srnoland.TP 420189049Srnoland.NOP \f\*[B-Font]\-\-pccfreq\f[]=\f\*[I-Font]string\f[] 421189049SrnolandForce CPU cycle counter use (Windows only). 422189049Srnoland.sp 423189049SrnolandForce substitution the CPU counter for \fBQueryPerformanceCounter\fP. 424189049SrnolandThe CPU counter (RDTSC on x86) is used unconditionally with the 425189049Srnolandgiven frequency (in Hz). 426189049Srnoland.TP 427189049Srnoland.NOP \f\*[B-Font]\-m\f[], \f\*[B-Font]\-\-mdns\f[] 428189049SrnolandRegister with mDNS as a NTP server. 429189049Srnoland.sp 430189049SrnolandRegisters as an NTP server with the local mDNS server which allows 431189049Srnolandthe server to be discovered via mDNS client lookup. 432189049Srnoland.TP 433189049Srnoland.NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[] 434189049SrnolandDisplay usage information and exit. 435189049Srnoland.TP 436189049Srnoland.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[] 437189049SrnolandPass the extended usage information through a pager. 438189049Srnoland.TP 439189049Srnoland.NOP \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}] 440189049SrnolandOutput version of program and exit. The default mode is `v', a simple 441189049Srnolandversion. The `c' mode will print copyright information and `n' will 442205120Srnolandprint the full copyright notice. 443189049Srnoland.PP 444189049Srnoland.SH "OPTION PRESETS" 445189049SrnolandAny option that is not marked as \fInot presettable\fP may be preset 446189049Srnolandby loading values from environment variables named: 447189049Srnoland.nf 448189049Srnoland \fBNTPD_<option-name>\fP or \fBNTPD\fP 449189049Srnoland.fi 450189049Srnoland.ad 451189049Srnoland.SH USAGE 452189049Srnoland.SS "How NTP Operates" 453189049SrnolandThe 454189049Srnoland\f\*[B-Font]ntpd\fP 455189049Srnolandutility operates by exchanging messages with 456189049Srnolandone or more configured servers over a range of designated poll intervals. 457189049SrnolandWhen 458189049Srnolandstarted, whether for the first or subsequent times, the program 459189049Srnolandrequires several exchanges from the majority of these servers so 460189049Srnolandthe signal processing and mitigation algorithms can accumulate and 461189049Srnolandgroom the data and set the clock. 462189049SrnolandIn order to protect the network 463189049Srnolandfrom bursts, the initial poll interval for each server is delayed 464189049Srnolandan interval randomized over a few seconds. 465189049SrnolandAt the default initial poll 466189049Srnolandinterval of 64s, several minutes can elapse before the clock is 467189049Srnolandset. 468189049SrnolandThis initial delay to set the clock 469189049Srnolandcan be safely and dramatically reduced using the 470189049Srnoland\f\*[B-Font]iburst\f[] 471189049Srnolandkeyword with the 472189049Srnoland\f\*[B-Font]server\f[] 473189049Srnolandconfiguration 474189049Srnolandcommand, as described in 475189049Srnoland\fCntp.conf\f[]\fR(5)\f[]. 476189049Srnoland.sp \n(Ppu 477189049Srnoland.ne 2 478189049Srnoland 479189049SrnolandMost operating systems and hardware of today incorporate a 480189049Srnolandtime-of-year (TOY) chip to maintain the time during periods when 481189049Srnolandthe power is off. 482189049SrnolandWhen the machine is booted, the chip is used to 483189049Srnolandinitialize the operating system time. 484189049SrnolandAfter the machine has 485189049Srnolandsynchronized to a NTP server, the operating system corrects the 486189049Srnolandchip from time to time. 487189049SrnolandIn the default case, if 488189049Srnoland\f\*[B-Font]ntpd\fP 489189049Srnolanddetects that the time on the host 490189049Srnolandis more than 1000s from the server time, 491189049Srnoland\f\*[B-Font]ntpd\fP 492189049Srnolandassumes something must be terribly wrong and the only 493189049Srnolandreliable action is for the operator to intervene and set the clock 494189049Srnolandby hand. 495189049Srnoland(Reasons for this include there is no TOY chip, 496189049Srnolandor its battery is dead, or that the TOY chip is just of poor quality.) 497189049SrnolandThis causes 498189049Srnoland\f\*[B-Font]ntpd\fP 499189049Srnolandto exit with a panic message to 500189049Srnolandthe system log. 501189049SrnolandThe 502189049Srnoland\f\*[B-Font]\-g\f[] 503189049Srnolandoption overrides this check and the 504189049Srnolandclock will be set to the server time regardless of the chip time 505189049Srnoland(up to 68 years in the past or future \(em 506189049Srnolandthis is a limitation of the NTPv4 protocol). 507189049SrnolandHowever, and to protect against broken hardware, such as when the 508189049SrnolandCMOS battery fails or the clock counter becomes defective, once the 509205120Srnolandclock has been set an error greater than 1000s will cause 510189049Srnoland\f\*[B-Font]ntpd\fP 511189049Srnolandto exit anyway. 512189049Srnoland.sp \n(Ppu 513189049Srnoland.ne 2 514205120Srnoland 515189049SrnolandUnder ordinary conditions, 516189049Srnoland\f\*[B-Font]ntpd\fP 517189049Srnolandadjusts the clock in 518189049Srnolandsmall steps so that the timescale is effectively continuous and 519189049Srnolandwithout discontinuities. 520189049SrnolandUnder conditions of extreme network 521189049Srnolandcongestion, the roundtrip delay jitter can exceed three seconds and 522189049Srnolandthe synchronization distance, which is equal to one-half the 523189049Srnolandroundtrip delay plus error budget terms, can become very large. 524189049SrnolandThe 525189049Srnoland\f\*[B-Font]ntpd\fP 526189049Srnolandalgorithms discard sample offsets exceeding 128 ms, 527189049Srnolandunless the interval during which no sample offset is less than 128 528189049Srnolandms exceeds 900s. 529189049SrnolandThe first sample after that, no matter what the 530189049Srnolandoffset, steps the clock to the indicated time. 531189049SrnolandIn practice this 532189049Srnolandreduces the false alarm rate where the clock is stepped in error to 533189049Srnolanda vanishingly low incidence. 534189049Srnoland.sp \n(Ppu 535189049Srnoland.ne 2 536189049Srnoland 537189049SrnolandAs the result of this behavior, once the clock has been set it 538189049Srnolandvery rarely strays more than 128 ms even under extreme cases of 539189049Srnolandnetwork path congestion and jitter. 540189049SrnolandSometimes, in particular when 541189049Srnoland\f\*[B-Font]ntpd\fP 542189049Srnolandis first started without a valid drift file 543189049Srnolandon a system with a large intrinsic drift 544189049Srnolandthe error might grow to exceed 128 ms, 545189049Srnolandwhich would cause the clock to be set backwards 546189049Srnolandif the local clock time is more than 128 s 547189049Srnolandin the future relative to the server. 548189049SrnolandIn some applications, this behavior may be unacceptable. 549189049SrnolandThere are several solutions, however. 550189049SrnolandIf the 551189049Srnoland\f\*[B-Font]\-x\f[] 552189049Srnolandoption is included on the command line, the clock will 553189049Srnolandnever be stepped and only slew corrections will be used. 554189049SrnolandBut this choice comes with a cost that 555189049Srnolandshould be carefully explored before deciding to use 556189049Srnolandthe 557190020Srnoland\f\*[B-Font]\-x\f[] 558189049Srnolandoption. 559189049SrnolandThe maximum slew rate possible is limited 560189049Srnolandto 500 parts-per-million (PPM) as a consequence of the correctness 561189049Srnolandprinciples on which the NTP protocol and algorithm design are 562189049Srnolandbased. 563190020SrnolandAs a result, the local clock can take a long time to 564190020Srnolandconverge to an acceptable offset, about 2,000 s for each second the 565190020Srnolandclock is outside the acceptable range. 566190020SrnolandDuring this interval the 567190020Srnolandlocal clock will not be consistent with any other network clock and 568189049Srnolandthe system cannot be used for distributed applications that require 569189049Srnolandcorrectly synchronized network time. 570189049Srnoland.sp \n(Ppu 571189049Srnoland.ne 2 572189049Srnoland 573189049SrnolandIn spite of the above precautions, sometimes when large 574189049Srnolandfrequency errors are present the resulting time offsets stray 575189049Srnolandoutside the 128-ms range and an eventual step or slew time 576189049Srnolandcorrection is required. 577189049SrnolandIf following such a correction the 578189049Srnolandfrequency error is so large that the first sample is outside the 579189049Srnolandacceptable range, 580189049Srnoland\f\*[B-Font]ntpd\fP 581189049Srnolandenters the same state as when the 582189049Srnoland\fIntp.drift\f[] 583189049Srnolandfile is not present. 584189049SrnolandThe intent of this behavior 585189049Srnolandis to quickly correct the frequency and restore operation to the 586189049Srnolandnormal tracking mode. 587189049SrnolandIn the most extreme cases 588189049Srnoland(the host 589189049Srnoland\f\*[B-Font]time.ien.it\f[] 590189049Srnolandcomes to mind), there may be occasional 591189049Srnolandstep/slew corrections and subsequent frequency corrections. 592189049SrnolandIt 593189049Srnolandhelps in these cases to use the 594189049Srnoland\f\*[B-Font]burst\f[] 595189049Srnolandkeyword when 596189049Srnolandconfiguring the server, but 597189049SrnolandONLY 598189049Srnolandwhen you have permission to do so from the owner of the target host. 599189049Srnoland.sp \n(Ppu 600189049Srnoland.ne 2 601189049Srnoland 602189049SrnolandFinally, 603189049Srnolandin the past many startup scripts would run 604189049Srnoland\fCntpdate\f[]\fR(1ntpdatemdoc)\f[] 605189049Srnolandor 606189049Srnoland\fCsntp\f[]\fR(1sntpmdoc)\f[] 607189049Srnolandto get the system clock close to correct before starting 608189049Srnoland\fCntpd\f[]\fR(1ntpdmdoc)\f[], 609189049Srnolandbut this was never more than a mediocre hack and is no longer needed. 610189049SrnolandIf you are following the instructions in 611189049Srnoland\fIStarting NTP (Best Current Practice)\f[] 612189049Srnolandand you still need to set the system time before starting 613189049Srnoland\f\*[B-Font]ntpd\fP, 614189049Srnolandplease open a bug report and document what is going on, 615189049Srnolandand then look at using 616189049Srnoland\fCsntp\f[]\fR(1sntpmdoc)\f[] 617189049Srnolandif you really need to set the clock before starting 618189049Srnoland\f\*[B-Font]ntpd\fP. 619189049Srnoland.sp \n(Ppu 620189049Srnoland.ne 2 621189049Srnoland 622189049SrnolandThere is a way to start 623189049Srnoland\fCntpd\f[]\fR(1ntpdmdoc)\f[] 624189049Srnolandthat often addresses all of the problems mentioned above. 625189049Srnoland.SS "Starting NTP (Best Current Practice)" 626189049SrnolandFirst, use the 627189049Srnoland\f\*[B-Font]iburst\f[] 628189049Srnolandoption on your 629189049Srnoland\f\*[B-Font]server\f[] 630189049Srnolandentries. 631190020Srnoland.sp \n(Ppu 632190020Srnoland.ne 2 633190020Srnoland 634189049SrnolandIf you can also keep a good 635189049Srnoland\fIntp.drift\f[] 636189049Srnolandfile then 637189049Srnoland\fCntpd\f[]\fR(1ntpdmdoc)\f[] 638189049Srnolandwill effectively "warm-start" and your system's clock will 639189049Srnolandbe stable in under 11 seconds' time. 640189049Srnoland.sp \n(Ppu 641190020Srnoland.ne 2 642190020Srnoland 643190020SrnolandAs soon as possible in the startup sequence, start 644189049Srnoland\fCntpd\f[]\fR(1ntpdmdoc)\f[] 645189049Srnolandwith at least the 646189049Srnoland\f\*[B-Font]\-g\f[] 647189049Srnolandand perhaps the 648189049Srnoland\f\*[B-Font]\-N\f[] 649189049Srnolandoptions. 650189049SrnolandThen, 651189049Srnolandstart the rest of your "normal" processes. 652189049SrnolandThis will give 653189049Srnoland\fCntpd\f[]\fR(1ntpdmdoc)\f[] 654189049Srnolandas much time as possible to get the system's clock synchronized and stable. 655189049Srnoland.sp \n(Ppu 656261455Seadler.ne 2 657189049Srnoland 658189049SrnolandFinally, 659189049Srnolandif you have processes like 660189049Srnoland\f\*[B-Font]dovecot\f[] 661189049Srnolandor database servers 662189049Srnolandthat require 663189049Srnolandmonotonically-increasing time, 664189049Srnolandrun 665189049Srnoland\fCntp-wait\f[]\fR(1ntp-waitmdoc)\f[] 666189049Srnolandas late as possible in the boot sequence 667189049Srnoland(perhaps with the 668189049Srnoland\f\*[B-Font]\-v\f[] 669189049Srnolandflag) 670189049Srnolandand after 671189049Srnoland\fCntp-wait\f[]\fR(1ntp-waitmdoc)\f[] 672189049Srnolandexits successfully 673190020Srnolandit is as safe as it will ever be to start any process that require 674190020Srnolandstable time. 675190020Srnoland.SS "Frequency Discipline" 676190020SrnolandThe 677189049Srnoland\f\*[B-Font]ntpd\fP 678190020Srnolandbehavior at startup depends on whether the 679190020Srnolandfrequency file, usually 680190020Srnoland\fIntp.drift\f[], 681190020Srnolandexists. 682190020SrnolandThis file 683189049Srnolandcontains the latest estimate of clock frequency error. 684189049SrnolandWhen the 685189049Srnoland\f\*[B-Font]ntpd\fP 686189049Srnolandis started and the file does not exist, the 687189049Srnoland\f\*[B-Font]ntpd\fP 688189049Srnolandenters a special mode designed to quickly adapt to 689189049Srnolandthe particular system clock oscillator time and frequency error. 690189049SrnolandThis takes approximately 15 minutes, after which the time and 691189049Srnolandfrequency are set to nominal values and the 692189049Srnoland\f\*[B-Font]ntpd\fP 693261455Seadlerenters 694189049Srnolandnormal mode, where the time and frequency are continuously tracked 695189049Srnolandrelative to the server. 696189049SrnolandAfter one hour the frequency file is 697189049Srnolandcreated and the current frequency offset written to it. 698189049SrnolandWhen the 699189049Srnoland\f\*[B-Font]ntpd\fP 700189049Srnolandis started and the file does exist, the 701189049Srnoland\f\*[B-Font]ntpd\fP 702189049Srnolandfrequency is initialized from the file and enters normal mode 703189049Srnolandimmediately. 704189049SrnolandAfter that the current frequency offset is written to 705189049Srnolandthe file at hourly intervals. 706189049Srnoland.SS "Operating Modes" 707189049SrnolandThe 708189049Srnoland\f\*[B-Font]ntpd\fP 709189049Srnolandutility can operate in any of several modes, including 710189049Srnolandsymmetric active/passive, client/server broadcast/multicast and 711189049Srnolandmanycast, as described in the 712189049Srnoland"Association Management" 713189049Srnolandpage 714189049Srnoland(available as part of the HTML documentation 715189049Srnolandprovided in 716189049Srnoland\fI/usr/share/doc/ntp\f[]). 717189049SrnolandIt normally operates continuously while 718189049Srnolandmonitoring for small changes in frequency and trimming the clock 719189049Srnolandfor the ultimate precision. 720189049SrnolandHowever, it can operate in a one-time 721189049Srnolandmode where the time is set from an external server and frequency is 722189049Srnolandset from a previously recorded frequency file. 723189049SrnolandA 724189049Srnolandbroadcast/multicast or manycast client can discover remote servers, 725189049Srnolandcompute server-client propagation delay correction factors and 726189049Srnolandconfigure itself automatically. 727189049SrnolandThis makes it possible to deploy a 728189049Srnolandfleet of workstations without specifying configuration details 729261455Seadlerspecific to the local environment. 730189049Srnoland.sp \n(Ppu 731189049Srnoland.ne 2 732189049Srnoland 733189049SrnolandBy default, 734189049Srnoland\f\*[B-Font]ntpd\fP 735189049Srnolandruns in continuous mode where each of 736189049Srnolandpossibly several external servers is polled at intervals determined 737189049Srnolandby an intricate state machine. 738189049SrnolandThe state machine measures the 739189049Srnolandincidental roundtrip delay jitter and oscillator frequency wander 740189049Srnolandand determines the best poll interval using a heuristic algorithm. 741189049SrnolandOrdinarily, and in most operating environments, the state machine 742189049Srnolandwill start with 64s intervals and eventually increase in steps to 743189049Srnoland1024s. 744189049SrnolandA small amount of random variation is introduced in order to 745189049Srnolandavoid bunching at the servers. 746189049SrnolandIn addition, should a server become 747189049Srnolandunreachable for some time, the poll interval is increased in steps 748189049Srnolandto 1024s in order to reduce network overhead. 749189049Srnoland.sp \n(Ppu 750189049Srnoland.ne 2 751189049Srnoland 752189049SrnolandIn some cases it may not be practical for 753189049Srnoland\f\*[B-Font]ntpd\fP 754189049Srnolandto run continuously. 755189049SrnolandA common workaround has been to run the 756189049Srnoland\fCntpdate\f[]\fR(1ntpdatemdoc)\f[] 757189049Srnolandor 758189049Srnoland\fCsntp\f[]\fR(1sntpmdoc)\f[] 759189049Srnolandprograms from a 760189049Srnoland\fCcron\f[]\fR(8)\f[] 761189049Srnolandjob at designated 762189049Srnolandtimes. 763189049SrnolandHowever, these programs do not have the crafted signal 764189049Srnolandprocessing, error checking or mitigation algorithms of 765261455Seadler\f\*[B-Font]ntpd\fP. 766189049SrnolandThe 767189049Srnoland\f\*[B-Font]\-q\f[] 768189049Srnolandoption is intended for this purpose. 769189049SrnolandSetting this option will cause 770189049Srnoland\f\*[B-Font]ntpd\fP 771189049Srnolandto exit just after 772189049Srnolandsetting the clock for the first time. 773189049SrnolandThe procedure for initially 774189049Srnolandsetting the clock is the same as in continuous mode; most 775189049Srnolandapplications will probably want to specify the 776189049Srnoland\f\*[B-Font]iburst\f[] 777189049Srnolandkeyword with the 778189049Srnoland\f\*[B-Font]server\f[] 779189049Srnolandconfiguration command. 780189049SrnolandWith this 781189049Srnolandkeyword a volley of messages are exchanged to groom the data and 782189049Srnolandthe clock is set in about 10 s. 783189049SrnolandIf nothing is heard after a 784189049Srnolandcouple of minutes, the daemon times out and exits. 785189049SrnolandAfter a suitable 786261455Seadlerperiod of mourning, the 787189049Srnoland\fCntpdate\f[]\fR(1ntpdatemdoc)\f[] 788189049Srnolandprogram will be 789189049Srnolandretired. 790189049Srnoland.sp \n(Ppu 791189049Srnoland.ne 2 792189049Srnoland 793189049SrnolandWhen kernel support is available to discipline the clock 794189049Srnolandfrequency, which is the case for stock Solaris, Tru64, Linux and 795189049SrnolandFreeBSD, 796189049Srnolanda useful feature is available to discipline the clock 797189049Srnolandfrequency. 798189049SrnolandFirst, 799189049Srnoland\f\*[B-Font]ntpd\fP 800189049Srnolandis run in continuous mode with 801189049Srnolandselected servers in order to measure and record the intrinsic clock 802189049Srnolandfrequency offset in the frequency file. 803189049SrnolandIt may take some hours for 804189049Srnolandthe frequency and offset to settle down. 805189049SrnolandThen the 806189049Srnoland\f\*[B-Font]ntpd\fP 807189049Srnolandis 808189049Srnolandstopped and run in one-time mode as required. 809189049SrnolandAt each startup, the 810189049Srnolandfrequency is read from the file and initializes the kernel 811189049Srnolandfrequency. 812189049Srnoland.SS "Poll Interval Control" 813189049SrnolandThis version of NTP includes an intricate state machine to 814189049Srnolandreduce the network load while maintaining a quality of 815189049Srnolandsynchronization consistent with the observed jitter and wander. 816189049SrnolandThere are a number of ways to tailor the operation in order enhance 817189049Srnolandaccuracy by reducing the interval or to reduce network overhead by 818189049Srnolandincreasing it. 819189049SrnolandHowever, the user is advised to carefully consider 820189049Srnolandthe consequences of changing the poll adjustment range from the 821189049Srnolanddefault minimum of 64 s to the default maximum of 1,024 s. 822189049SrnolandThe 823189049Srnolanddefault minimum can be changed with the 824189049Srnoland\f\*[B-Font]tinker\f[] 825189049Srnoland\f\*[B-Font]minpoll\f[] 826189049Srnolandcommand to a value not less than 16 s. 827189049SrnolandThis value is used for all 828189049Srnolandconfigured associations, unless overridden by the 829261455Seadler\f\*[B-Font]minpoll\f[] 830189049Srnolandoption on the configuration command. 831189049SrnolandNote that most device drivers 832189049Srnolandwill not operate properly if the poll interval is less than 64 s 833189049Srnolandand that the broadcast server and manycast client associations will 834189049Srnolandalso use the default, unless overridden. 835189049Srnoland.sp \n(Ppu 836189049Srnoland.ne 2 837189049Srnoland 838189049SrnolandIn some cases involving dial up or toll services, it may be 839189049Srnolanduseful to increase the minimum interval to a few tens of minutes 840189049Srnolandand maximum interval to a day or so. 841189049SrnolandUnder normal operation 842189049Srnolandconditions, once the clock discipline loop has stabilized the 843189049Srnolandinterval will be increased in steps from the minimum to the 844189049Srnolandmaximum. 845189049SrnolandHowever, this assumes the intrinsic clock frequency error 846189049Srnolandis small enough for the discipline loop correct it. 847189049SrnolandThe capture 848189049Srnolandrange of the loop is 500 PPM at an interval of 64s decreasing by a 849189049Srnolandfactor of two for each doubling of interval. 850189049SrnolandAt a minimum of 1,024 851189049Srnolands, for example, the capture range is only 31 PPM. 852189049SrnolandIf the intrinsic 853189049Srnolanderror is greater than this, the drift file 854189049Srnoland\fIntp.drift\f[] 855189049Srnolandwill 856189049Srnolandhave to be specially tailored to reduce the residual error below 857189049Srnolandthis limit. 858189049SrnolandOnce this is done, the drift file is automatically 859189049Srnolandupdated once per hour and is available to initialize the frequency 860189049Srnolandon subsequent daemon restarts. 861189049Srnoland.SS "The huff-n'-puff Filter" 862189049SrnolandIn scenarios where a considerable amount of data are to be 863189049Srnolanddownloaded or uploaded over telephone modems, timekeeping quality 864189049Srnolandcan be seriously degraded. 865189049SrnolandThis occurs because the differential 866189049Srnolanddelays on the two directions of transmission can be quite large. 867189049SrnolandIn 868189049Srnolandmany cases the apparent time errors are so large as to exceed the 869189049Srnolandstep threshold and a step correction can occur during and after the 870189049Srnolanddata transfer is in progress. 871189049Srnoland.sp \n(Ppu 872189049Srnoland.ne 2 873189049Srnoland 874189049SrnolandThe huff-n'-puff filter is designed to correct the apparent time 875189049Srnolandoffset in these cases. 876189049SrnolandIt depends on knowledge of the propagation 877189049Srnolanddelay when no other traffic is present. 878189049SrnolandIn common scenarios this 879189049Srnolandoccurs during other than work hours. 880189049SrnolandThe filter maintains a shift 881189049Srnolandregister that remembers the minimum delay over the most recent 882189049Srnolandinterval measured usually in hours. 883189049SrnolandUnder conditions of severe 884189049Srnolanddelay, the filter corrects the apparent offset using the sign of 885189049Srnolandthe offset and the difference between the apparent delay and 886189049Srnolandminimum delay. 887189049SrnolandThe name of the filter reflects the negative (huff) 888189049Srnolandand positive (puff) correction, which depends on the sign of the 889189049Srnolandoffset. 890189049Srnoland.sp \n(Ppu 891189049Srnoland.ne 2 892189049Srnoland 893189049SrnolandThe filter is activated by the 894189049Srnoland\f\*[B-Font]tinker\f[] 895189049Srnolandcommand and 896189049Srnoland\f\*[B-Font]huffpuff\f[] 897189049Srnolandkeyword, as described in 898189049Srnoland\fCntp.conf\f[]\fR(5)\f[]. 899189049Srnoland.SH "ENVIRONMENT" 900261455SeadlerSee \fBOPTION PRESETS\fP for configuration environment variables. 901189049Srnoland.SH FILES 902189049Srnoland.TP 15 903189049Srnoland.NOP \fI/etc/ntp.conf\f[] 904189049Srnolandthe default name of the configuration file 905189049Srnoland.br 906189049Srnoland.ns 907189049Srnoland.TP 15 908189049Srnoland.NOP \fI/etc/ntp.drift\f[] 909189049Srnolandthe default name of the drift file 910189049Srnoland.br 911189049Srnoland.ns 912189049Srnoland.TP 15 913189049Srnoland.NOP \fI/etc/ntp.keys\f[] 914189049Srnolandthe default name of the key file 915189049Srnoland.PP 916189049Srnoland.SH "EXIT STATUS" 917189049SrnolandOne of the following exit values will be returned: 918189049Srnoland.TP 919189049Srnoland.NOP 0 " (EXIT_SUCCESS)" 920189049SrnolandSuccessful program execution. 921189049Srnoland.TP 922189049Srnoland.NOP 1 " (EXIT_FAILURE)" 923189049SrnolandThe operation failed or the command syntax was not valid. 924189049Srnoland.TP 925189049Srnoland.NOP 70 " (EX_SOFTWARE)" 926189049Srnolandlibopts had an internal operational error. Please report 927189049Srnolandit to autogen-users@lists.sourceforge.net. Thank you. 928189049Srnoland.PP 929189049Srnoland.SH "SEE ALSO" 930189049Srnoland\fCntp.conf\f[]\fR(5)\f[], 931189049Srnoland\fCntpdate\f[]\fR(1ntpdatemdoc)\f[], 932189049Srnoland\fCntpdc\f[]\fR(1ntpdcmdoc)\f[], 933189049Srnoland\fCntpq\f[]\fR(1ntpqmdoc)\f[], 934189049Srnoland\fCsntp\f[]\fR(1sntpmdoc)\f[] 935189049Srnoland.sp \n(Ppu 936189049Srnoland.ne 2 937189049Srnoland 938189049SrnolandIn addition to the manual pages provided, 939189049Srnolandcomprehensive documentation is available on the world wide web 940189049Srnolandat 941189049Srnoland\f[C]http://www.ntp.org/\f[]. 942189049SrnolandA snapshot of this documentation is available in HTML format in 943189049Srnoland\fI/usr/share/doc/ntp\f[]. 944189049SrnolandDavid L. Mills, 945189049Srnoland\fINetwork Time Protocol (Version 1)\fR, 946189049SrnolandRFC1059 947189049Srnoland.PP 948189049Srnoland 949189049SrnolandDavid L. Mills, 950189049Srnoland\fINetwork Time Protocol (Version 2)\fR, 951189049SrnolandRFC1119 952189049Srnoland.PP 953189049Srnoland 954189049SrnolandDavid L. Mills, 955189049Srnoland\fINetwork Time Protocol (Version 3)\fR, 956189049SrnolandRFC1305 957189049Srnoland.PP 958189049Srnoland 959189049SrnolandDavid L. Mills and J. Martin, Ed. and J. Burbank and W. Kasch, 960189049Srnoland\fINetwork Time Protocol Version 4: Protocol and Algorithms Specification\fR, 961189049SrnolandRFC5905 962189049Srnoland.PP 963189049Srnoland 964189049SrnolandDavid L. Mills and B. Haberman, Ed., 965189049Srnoland\fINetwork Time Protocol Version 4: Autokey Specification\fR, 966189049SrnolandRFC5906 967189049Srnoland.PP 968189049Srnoland 969189049SrnolandH. Gerstung and C. Elliott and B. Haberman, Ed., 970189049Srnoland\fIDefinitions of Managed Objects for Network Time Protocol Version 4: (NTPv4)\fR, 971189049SrnolandRFC5907 972189049Srnoland.PP 973189049Srnoland 974189049SrnolandR. Gayraud and B. Lourdelet, 975189049Srnoland\fINetwork Time Protocol (NTP) Server Option for DHCPv6\fR, 976189049SrnolandRFC5908 977189049Srnoland.PP 978189049Srnoland 979189049Srnoland.SH "AUTHORS" 980189049SrnolandThe University of Delaware and Network Time Foundation 981189049Srnoland.SH "COPYRIGHT" 982189049SrnolandCopyright (C) 1992-2016 The University of Delaware and Network Time Foundation all rights reserved. 983189049SrnolandThis program is released under the terms of the NTP license, <http://ntp.org/license>. 984189049Srnoland.SH BUGS 985189049SrnolandThe 986189049Srnoland\f\*[B-Font]ntpd\fP 987189049Srnolandutility has gotten rather fat. 988189049SrnolandWhile not huge, it has gotten 989189049Srnolandlarger than might be desirable for an elevated-priority 990189049Srnoland\f\*[B-Font]ntpd\fP 991189049Srnolandrunning on a workstation, particularly since many of 992189049Srnolandthe fancy features which consume the space were designed more with 993189049Srnolanda busy primary server, rather than a high stratum workstation in 994189049Srnolandmind. 995189049Srnoland.sp \n(Ppu 996189049Srnoland.ne 2 997189049Srnoland 998189049SrnolandPlease send bug reports to: http://bugs.ntp.org, bugs@ntp.org 999189049Srnoland.SH NOTES 1000189049SrnolandPortions of this document came from FreeBSD. 1001189049Srnoland.sp \n(Ppu 1002189049Srnoland.ne 2 1003189049Srnoland 1004189049SrnolandThis manual page was \fIAutoGen\fP-erated from the \fBntpd\fP 1005189049Srnolandoption definitions. 1006189049Srnoland