1290001Sglebius\input texinfo @c -*-texinfo-*- 2290001Sglebius@c %**start of header 3290001Sglebius@setfilename ntpd.info 4290001Sglebius@settitle ntpd: Network Time Protocol (NTP) Daemon User's Manual 5290001Sglebius@include ../sntp/include/version.texi 6290001Sglebius@paragraphindent 2 7290001Sglebius@c %**end of header 8290001Sglebius 9290001Sglebius@ifinfo 10290001SglebiusThis file documents the use of the NTP Project's ntpd, a program for 11290001Sglebiuscontrolling ntpd. 12290001Sglebius@end ifinfo 13290001Sglebius 14290001Sglebius@direntry 15290001Sglebius* ntpd: (ntpd). NTP Daemon program 16290001Sglebius@end direntry 17290001Sglebius 18290001Sglebius@titlepage 19290001Sglebius@title ntpd: Network Time Protocol (NTP) Daemon User's Manual 20290001Sglebius@subtitle ntpd, version @value{VERSION}, @value{UPDATED} 21290001Sglebius@c @author Max @email{foo@ntp.org} 22290001Sglebius@end titlepage 23290001Sglebius 24290001Sglebius@c @page 25290001Sglebius@c @vskip 0pt plus 1filll 26290001Sglebius 27290001Sglebius@node Top, ntpd Description, (dir), (dir) 28290001Sglebius@top ntpd: Network Time Protocol (NTP) Daemon User Manual 29290001Sglebius 30290001SglebiusThe @code{ntpd} program is an operating system daemon that synchronizes the 31290001Sglebiussystem clock to remote NTP time servers or local reference clocks. 32290001SglebiusIt is a complete implementation of NTP version 4 defined by RFC-5905, but 33290001Sglebiusalso retains compatible with version 3 defined by RFC-1305 and versions 34290001Sglebius1 and 2, defined by RFC-1059 and RFC-1119, respectively. 35290001SglebiusThe program can operate in any of several modes, including client/server, 36290001Sglebiussymmetric and broadcast modes, and with both symmetric-key and public-key 37290001Sglebiuscryptography. 38290001Sglebius 39290001SglebiusThis document applies to version @value{VERSION} of @code{ntpd}. 40290001Sglebius 41290001Sglebius@shortcontents 42290001Sglebius 43290001Sglebius@menu 44290001Sglebius* ntpd Description:: Description 45290001Sglebius* ntpd Invocation:: Invoking ntpd 46290001Sglebius* Usage:: Usage 47290001Sglebius@end menu 48290001Sglebius 49290001Sglebius@node ntpd Description 50290001Sglebius@comment node-name, next, previous, up 51290001Sglebius@section Description 52290001Sglebius 53290001SglebiusThe @code{ntpd} program ordinarily requires 54290001Sglebiusa configuration file described at @ref{ntp.conf}. 55290001SglebiusThis configuration file contains configuration commands described on 56290001Sglebiusthe pages listed above. 57290001SglebiusHowever a client can discover remote servers and configure them 58290001Sglebiusautomatically. 59290001SglebiusThis makes it possible to deploy a fleet of workstations without 60290001Sglebiusspecifying configuration details specific to the local environment. 61290001Sglebius 62290001SglebiusThe @code{ntpd} program normally operates continuously while adjusting the 63290001Sglebiussystem time and frequency, but in some cases this might not be 64290001Sglebiuspractical. 65290001SglebiusWith the @code{-q} option @code{ntpd} operates as in continuous mode, but 66290001Sglebiusexits just after setting the clock for the first time. 67290001SglebiusMost applications will probably want to specify the @code{iburst} 68290001Sglebiusoption with the @code{server} command. 69290001SglebiusWith this option an initial volley of messages is exchanged to 70290001Sglebiusgroom the data and set the clock in about ten seconds' time. 71290001SglebiusIf nothing is heard after a few minutes' time, 72290001Sglebiusthe daemon times out and exits without setting the clock. 73290001Sglebius 74290001Sglebius@include invoke-ntpd.texi 75290001Sglebius 76290001Sglebius@node Usage 77290001Sglebius@comment node-name, next, previous, up 78290001Sglebius@section Usage 79290001Sglebius 80290001Sglebius@multitable @columnfractions .23 .23 .05 .15 81290001Sglebius@headitem What @tab Default @tab Flag @tab Option 82290001Sglebius@item configuration file 83290001Sglebius@tab @code{/etc/ntp.conf} 84290001Sglebius@tab @code{-c} 85290001Sglebius@tab @code{conffile} 86290001Sglebius@item frequency file 87290001Sglebius@tab none 88290001Sglebius@tab @code{-f} 89290001Sglebius@tab @code{driftfile} 90290001Sglebius@item leapseconds file 91290001Sglebius@tab none 92290001Sglebius@tab 93290001Sglebius@tab @code{leapfile} 94290001Sglebius@item process ID file 95290001Sglebius@tab none 96290001Sglebius@tab @code{-p} 97290001Sglebius@tab @code{pidfile} 98290001Sglebius@item log file 99290001Sglebius@tab system log 100290001Sglebius@tab @code{-l} 101290001Sglebius@tab @code{logfile} 102290001Sglebius@item include file 103290001Sglebius@tab none 104290001Sglebius@tab none 105290001Sglebius@tab @code{includefile} 106290001Sglebius@item statistics path 107290001Sglebius@tab @code{/var/NTP} 108290001Sglebius@tab @code{-s} 109290001Sglebius@tab @code{statsdir} 110290001Sglebius@item keys path 111290001Sglebius@tab @code{/usr/local/etc} 112290001Sglebius@tab @code{-k} 113290001Sglebius@tab @code{keysdir} 114