diff options
author | delphij <delphij@FreeBSD.org> | 2015-07-15 19:21:26 +0000 |
---|---|---|
committer | delphij <delphij@FreeBSD.org> | 2015-07-15 19:21:26 +0000 |
commit | 2a25cee78ab1d37e7d2bc40ae675646974d99f56 (patch) | |
tree | b0302ac4be59e104f4e1e54014561a1389397192 /contrib/ntp/ntpd/ntpd.texi | |
parent | a0741a75537b2e0514472ac3b28afc55a7846c30 (diff) | |
download | FreeBSD-src-2a25cee78ab1d37e7d2bc40ae675646974d99f56.zip FreeBSD-src-2a25cee78ab1d37e7d2bc40ae675646974d99f56.tar.gz |
MFC r280849,280915-280916,281015-281016,282097,282408,282415,283542,
284864,285169-285170,285435:
ntp 4.2.8p3.
Relnotes: yes
Approved by: re (?)
Diffstat (limited to 'contrib/ntp/ntpd/ntpd.texi')
-rw-r--r-- | contrib/ntp/ntpd/ntpd.texi | 113 |
1 files changed, 113 insertions, 0 deletions
diff --git a/contrib/ntp/ntpd/ntpd.texi b/contrib/ntp/ntpd/ntpd.texi new file mode 100644 index 0000000..0ac091b --- /dev/null +++ b/contrib/ntp/ntpd/ntpd.texi @@ -0,0 +1,113 @@ +\input texinfo @c -*-texinfo-*- +@c %**start of header +@setfilename ntpd.info +@settitle ntpd: Network Time Protocol (NTP) Daemon User's Manual +@include ../sntp/include/version.texi +@paragraphindent 2 +@c %**end of header + +@ifinfo +This file documents the use of the NTP Project's ntpd, a program for +controlling ntpd. +@end ifinfo + +@direntry +* ntpd: (ntpd). NTP Daemon program +@end direntry + +@titlepage +@title ntpd: Network Time Protocol (NTP) Daemon User's Manual +@subtitle ntpd, version @value{VERSION}, @value{UPDATED} +@c @author Max @email{foo@ntp.org} +@end titlepage + +@c @page +@c @vskip 0pt plus 1filll + +@node Top, ntpd Description, (dir), (dir) +@top ntpd: Network Time Protocol (NTP) Daemon User Manual + +The @code{ntpd} program is an operating system daemon that synchronizes the +system clock to remote NTP time servers or local reference clocks. +It is a complete implementation of NTP version 4 defined by RFC-5905, but +also retains compatible with version 3 defined by RFC-1305 and versions +1 and 2, defined by RFC-1059 and RFC-1119, respectively. +The program can operate in any of several modes, including client/server, +symmetric and broadcast modes, and with both symmetric-key and public-key +cryptography. + +This document applies to version @value{VERSION} of @code{ntpd}. + +@shortcontents + +@menu +* ntpd Description:: Description +* ntpd Invocation:: Invoking ntpd +* Usage:: Usage +@end menu + +@node ntpd Description +@comment node-name, next, previous, up +@section Description + +The @code{ntpd} program ordinarily requires +a configuration file described at @ref{ntp.conf}. +This configuration file contains configuration commands described on +the pages listed above. +However a client can discover remote servers and configure them +automatically. +This makes it possible to deploy a fleet of workstations without +specifying configuration details specific to the local environment. + +The @code{ntpd} program normally operates continuously while adjusting the +system time and frequency, but in some cases this might not be +practical. +With the @code{-q} option @code{ntpd} operates as in continuous mode, but +exits just after setting the clock for the first time. +Most applications will probably want to specify the @code{iburst} +option with the @code{server} command. +With this option an initial volley of messages is exchanged to +groom the data and set the clock in about ten seconds' time. +If nothing is heard after a few minutes' time, +the daemon times out and exits without setting the clock. + +@include invoke-ntpd.texi + +@node Usage +@comment node-name, next, previous, up +@section Usage + +@multitable @columnfractions .23 .23 .05 .15 +@headitem What @tab Default @tab Flag @tab Option +@item configuration file +@tab @code{/etc/ntp.conf} +@tab @code{-c} +@tab @code{conffile} +@item frequency file +@tab none +@tab @code{-f} +@tab @code{driftfile} +@item leapseconds file +@tab none +@tab +@tab @code{leapfile} +@item process ID file +@tab none +@tab @code{-p} +@tab @code{pidfile} +@item log file +@tab system log +@tab @code{-l} +@tab @code{logfile} +@item include file +@tab none +@tab none +@tab @code{includefile} +@item statistics path +@tab @code{/var/NTP} +@tab @code{-s} +@tab @code{statsdir} +@item keys path +@tab @code{/usr/local/etc} +@tab @code{-k} +@tab @code{keysdir} |