ntpd.texi revision 275970
1275970Scy\input texinfo @c -*-texinfo-*- 2275970Scy@c %**start of header 3275970Scy@setfilename ntpd.info 4275970Scy@settitle ntpd: Network Time Protocol (NTP) Daemon User's Manual 5275970Scy@include ../sntp/include/version.texi 6275970Scy@paragraphindent 2 7275970Scy@c %**end of header 8275970Scy 9275970Scy@ifinfo 10275970ScyThis file documents the use of the NTP Project's ntpd, a program for 11275970Scycontrolling ntpd. 12275970Scy@end ifinfo 13275970Scy 14275970Scy@direntry 15275970Scy* ntpd: (ntpd). NTP Daemon program 16275970Scy@end direntry 17275970Scy 18275970Scy@titlepage 19275970Scy@title ntpd: Network Time Protocol (NTP) Daemon User's Manual 20275970Scy@subtitle ntpd, version @value{VERSION}, @value{UPDATED} 21275970Scy@c @author Max @email{foo@ntp.org} 22275970Scy@end titlepage 23275970Scy 24275970Scy@c @page 25275970Scy@c @vskip 0pt plus 1filll 26275970Scy 27275970Scy@node Top, ntpd Description, (dir), (dir) 28275970Scy@top ntpd: Network Time Protocol (NTP) Daemon User Manual 29275970Scy 30275970ScyThe @code{ntpd} program is an operating system daemon that synchronizes the 31275970Scysystem clock to remote NTP time servers or local reference clocks. 32275970ScyIt is a complete implementation of NTP version 4 defined by RFC-5905, but 33275970Scyalso retains compatible with version 3 defined by RFC-1305 and versions 34275970Scy1 and 2, defined by RFC-1059 and RFC-1119, respectively. 35275970ScyThe program can operate in any of several modes, including client/server, 36275970Scysymmetric and broadcast modes, and with both symmetric-key and public-key 37275970Scycryptography. 38275970Scy 39275970ScyThis document applies to version @value{VERSION} of @code{ntpd}. 40275970Scy 41275970Scy@shortcontents 42275970Scy 43275970Scy@menu 44275970Scy* ntpd Description:: Description 45275970Scy* ntpd Invocation:: Invoking ntpd 46275970Scy* Usage:: Usage 47275970Scy@end menu 48275970Scy 49275970Scy@node ntpd Description 50275970Scy@comment node-name, next, previous, up 51275970Scy@section Description 52275970Scy 53275970ScyThe @code{ntpd} program ordinarily requires 54275970Scya configuration file described at @ref{ntp.conf}. 55275970ScyThis configuration file contains configuration commands described on 56275970Scythe pages listed above. 57275970ScyHowever a client can discover remote servers and configure them 58275970Scyautomatically. 59275970ScyThis makes it possible to deploy a fleet of workstations without 60275970Scyspecifying configuration details specific to the local environment. 61275970Scy 62275970ScyThe @code{ntpd} program normally operates continuously while adjusting the 63275970Scysystem time and frequency, but in some cases this might not be 64275970Scypractical. 65275970ScyWith the @code{-q} option @code{ntpd} operates as in continuous mode, but 66275970Scyexits just after setting the clock for the first time. 67275970ScyMost applications will probably want to specify the @code{iburst} 68275970Scyoption with the @code{server} command. 69275970ScyWith this option an initial volley of messages is exchanged to 70275970Scygroom the data and set the clock in about ten seconds' time. 71275970ScyIf nothing is heard after a few minutes' time, 72275970Scythe daemon times out and exits without setting the clock. 73275970Scy 74275970Scy@include invoke-ntpd.texi 75275970Scy 76275970Scy@node Usage 77275970Scy@comment node-name, next, previous, up 78275970Scy@section Usage 79275970Scy 80275970Scy@multitable @columnfractions .23 .23 .05 .15 81275970Scy@headitem What @tab Default @tab Flag @tab Option 82275970Scy@item configuration file 83275970Scy@tab @code{/etc/ntp.conf} 84275970Scy@tab @code{-c} 85275970Scy@tab @code{conffile} 86275970Scy@item frequency file 87275970Scy@tab none 88275970Scy@tab @code{-f} 89275970Scy@tab @code{driftfile} 90275970Scy@item leapseconds file 91275970Scy@tab none 92275970Scy@tab 93275970Scy@tab @code{leapfile} 94275970Scy@item process ID file 95275970Scy@tab none 96275970Scy@tab @code{-p} 97275970Scy@tab @code{pidfile} 98275970Scy@item log file 99275970Scy@tab system log 100275970Scy@tab @code{-l} 101275970Scy@tab @code{logfile} 102275970Scy@item include file 103275970Scy@tab none 104275970Scy@tab none 105275970Scy@tab @code{includefile} 106275970Scy@item statistics path 107275970Scy@tab @code{/var/NTP} 108275970Scy@tab @code{-s} 109275970Scy@tab @code{statsdir} 110275970Scy@item keys path 111275970Scy@tab @code{/usr/local/etc} 112275970Scy@tab @code{-k} 113275970Scy@tab @code{keysdir} 114