NAME¶
ntpd - "Network Time Protocol daemon"
SYNOPSIS¶
ntpd [
-dnSsv] [
-f file] [
-p file]
DESCRIPTION¶
The
ntpd daemon synchronizes the local clock to one or more remote NTP
servers or local timedelta sensors.
ntpd can also act as an NTP server
itself, redistributing the local time. It implements the Simple Network Time
Protocol version 4, as described in RFC 2030, and the Network Time Protocol
version 3, as described in RFC 1305.
ntpd uses the
adjtime(2) system call to correct the local system
time without causing time jumps. Adjustments larger than 128ms are logged
using
syslog(3) with LOG_INFO priority. The threshold value is chosen
to avoid having local clock drift thrash the log files. Should
ntpd be
started with the
-d option, all calls to
adjtime(2) will be
logged.
When
ntpd starts up, it reads settings from a configuration file,
typically
ntpd.conf(5).
The options are as follows:
- -d
- Do not daemonize. If this option is specified, ntpd
will run in the foreground and log to stderr.
- -p file
- Write pid to file
- -f file
- Use file as the configuration file, instead of the
default /etc/openntpd/ntpd.conf.
- -n
- Configtest mode. Only check the configuration file for
validity.
- -S
- Do not set the time immediately at startup. This is the
default.
- -s
- Set the time immediately at startup if the local clock is
off by more than 180 seconds. Allows for a large time correction,
eliminating the need to run rdate(8) before starting .
- -v
- This option allows ntpd to send DEBUG priority
messages to syslog.
When ntpd receives a SIGINFO signal, it will write its peer
and sensor status to syslog.
FILES¶
- /etc/openntpd/ntpd.conf
- default ntpd configuration file
- /var/lib/openntpd/ntpd.drift
- drift file, written by ntpd periodically and used at
startup to get the initial clock drift
SEE ALSO¶
date(1),
adjfreq(2),
adjtime(2),
ntpd.conf(5),
rdate(8),
timed(8)
,
Network Time Protocol (Version 3), March 1992.
,
Simple Network Time Protocol (SNTP) Version 4, October 1996.
HISTORY¶
The
ntpd program first appeared in OpenBSD 3.6 .