Network Time Protocol

Not to be confused with Daytime Protocol, Time Protocol, or NNTP.

The Network Time Protocol (NTP) is a networking protocol for clock synchronization between computer systems over packet-switched, variable-latency data networks. In operation since before 1985, NTP is one of the oldest Internet protocols in current use. NTP was designed by David L. Mills of the University of Delaware.

Network Time Protocol

International standard	RFC 5905
Developed by	David L. Mills, Harlan Stenn, Network Time Foundation
Introduced	1985; 40 years ago (1985)

NTP is intended to synchronize participating computers to within a few milliseconds of Coordinated Universal Time (UTC).^[1]: 3 It uses the intersection algorithm, a modified version of Marzullo's algorithm, to select accurate time servers and is designed to mitigate the effects of variable network latency. NTP can usually maintain time to within tens of milliseconds over the public Internet, and can achieve better than one millisecond accuracy in local area networks under ideal conditions. Asymmetric routes and network congestion can cause errors of 100 ms or more.^[2][3]

The protocol is usually described in terms of a client–server model, but can as easily be used in peer-to-peer relationships where both peers consider the other to be a potential time source.^[1]: 20 Implementations send and receive timestamps using the User Datagram Protocol (UDP) on port number 123.^[4][5]: 16 They can also use broadcasting or multicasting, where clients passively listen to time updates after an initial round-trip calibrating exchange.^[3] NTP supplies a warning of any impending leap second adjustment, but no information about local time zones or daylight saving time is transmitted.^[2][3]

The current protocol is version 4 (NTPv4),^[5] which is backward compatible with version 3.^[6]

NTP packet header format

NTP packet header format^[5] (section 7.3)

Offset	Octet	0								1								2								3
Octet	Bit	0	1	2	3	4	5	6	7	8	9	10	11	12	13	14	15	16	17	18	19	20	21	22	23	24	25	26	27	28	29	30	31
0	0	LI		VN			Mode			Stratum								Poll								Precision
4	32	Root Delay
8	64	Root Dispersion
12	96	Reference ID
16	128	Reference Timestamp (64-bits)
20	160
24	192	Origin Timestamp (64-bits)
28	224
32	256	Receive Timestamp (64-bits)
36	288
40	320	Transmit Timestamp (64-bits)
44	352
48	384	Optional: Extension Field(s) (n * 32 bits)
52	416	Optional: Key Identifier (If a MAC is present)
56	448	Optional: Message Digest (dgst) (If a MAC is present)
60	480
64	512
68	544

LI (Leap Indicator): 2 bits:Warning of leap second insertion or deletion:

• 0 = no warning
• 1 = last minute has 61 seconds
• 2 = last minute has 59 seconds
• 3 = unknown (clock unsynchronized)

VN (Version Number): 3 bits:NTP version number, typically 4.

Mode: 3 bits:Association mode:

• 0 = reserved
• 1 = symmetric active
• 2 = symmetric passive
• 3 = client
• 4 = server
• 5 = broadcast
• 6 = control
• 7 = private

Stratum: 8 bits:Indicates the distance from the reference clock.

• 0 = invalid
• 1 = primary server
• 2–15 = secondary
• 16 = unsynchronized

Poll: 8 bits:Maximum interval between successive messages, in log₂(seconds). Typical range is 6 to 10.

Precision: 8 bits:Signed log₂(seconds) of system clock precision (e.g., –18 ≈ 1 microsecond).

Root Delay: 32 bits:Total round-trip delay to the reference clock, in NTP short format.

Root Dispersion: 32 bits:Total dispersion to the reference clock, in NTP short format.

Reference ID: 32 bits:Identifies the specific server or reference clock; interpretation depends on Stratum.

Reference Timestamp: 64 bits:Time when the system clock was last set or corrected, in NTP timestamp format.

Origin Timestamp (org): 64 bits:Time at the client when the request departed, in NTP timestamp format.

Receive Timestamp (rec): 64 bits:Time at the server when the request arrived, in NTP timestamp format.

Transmit Timestamp (xmt): 64 bits:Time at the server when the response left, in NTP timestamp format.

Extension Field: variable:Optional field(s) for NTP extensions (see ^[5], Section 7.5).

Key Identifier: 32 bits:Unsigned integer designating an MD5 key shared by the client and server.

Message Digest (MD5): 128 bits:MD5 hash covering the packet header and extension fields, used for authentication.

History

NTP was designed by David L. Mills.

RFC evolution for NTP
1980 — – 1985 — – 1990 — – 1995 — – 2000 — – 2005 — – 2010 — – 2015 — – 2020 — –	v0, RFC 958[7] v1, RFC 1059[8] v2, RFC 1119[9] v3, RFC 1305[6] v4, RFC 5905[5] v3, RFC 1361[10] v3, RFC 1769[11] v4, RFC 2030[12] v4, RFC 4330[13]	← DCNET Internet Clock Service[14] ← SNTP ← SNTP merged ← Ext. fields[15] ← MAC change[16] ← Port randomization[17]

In 1979, network time synchronization technology was used in what was possibly the first public demonstration of Internet services running over a trans-Atlantic satellite network, at the National Computer Conference in New York. The technology was later described in the 1981 Internet Engineering Note (IEN) 173^[18] and a public protocol was developed from it that was documented in RFC 778. The technology was first deployed in a local area network as part of the Hello routing protocol and implemented in the Fuzzball router, an experimental operating system used in network prototyping, where it ran for many years.

Other related network tools were available both then and now. They include the Daytime and Time protocols for recording the time of events, as well as the ICMP Timestamp messages and IP Timestamp option (RFC 781). More complete synchronization systems, although lacking NTP's data analysis and clock disciplining algorithms, include the Unix daemon timed, which uses an election algorithm to appoint a server for all the clients;^[19] and the Digital Time Synchronization Service (DTSS), which uses a hierarchy of servers similar to the NTP stratum model.

In 1985, NTP version 0 (NTPv0) was implemented in both Fuzzball and Unix, and the NTP packet header and round-trip delay and offset calculations, which have persisted into NTPv4, were documented in RFC 958. Despite the relatively slow computers and networks available at the time, accuracy of better than 100 milliseconds was usually obtained on Atlantic spanning links, with accuracy of tens of milliseconds on Ethernet networks.

In 1988, a much more complete specification of the NTPv1 protocol, with associated algorithms, was published in RFC 1059. It drew on the experimental results and clock filter algorithm documented in RFC 956 and was the first version to describe the client–server and peer-to-peer modes. In 1991, the NTPv1 architecture, protocol and algorithms were brought to the attention of a wider engineering community with the publication of an article by David L. Mills in the IEEE Transactions on Communications.^[20]

In 1989, RFC 1119 was published defining NTPv2 by means of a state machine, with pseudocode to describe its operation. It introduced a management protocol and cryptographic authentication scheme which have both survived into NTPv4, along with the bulk of the algorithm. However the design of NTPv2 was criticized for lacking formal correctness by the DTSS community, and the clock selection procedure was modified to incorporate Marzullo's algorithm for NTPv3 onwards.^[21]

In 1992, RFC 1305 defined NTPv3. The RFC included an analysis of all sources of error, from the reference clock down to the final client, which enabled the calculation of a metric that helps choose the best server where several candidates appear to disagree. Broadcast mode was introduced.

In subsequent years, as new features were added and algorithm improvements were made, it became apparent that a new protocol version was required.^[22] In 2010, RFC 5905 was published containing a proposed specification for NTPv4.^[23] Following the retirement of Mills from the University of Delaware, the reference implementation is currently maintained as an open source project led by Harlan Stenn.^[24][25] On the IANA side, a ntp (network time protocols) work group is in charge of reviewing proposed drafts.^[26]

The protocol has significantly progressed since NTPv4.^[23] As of 2022^[update], three RFC documents describing updates to the protocol have been published,^[15][16][17] not counting the numerous peripheral standards^[26] such as Network Time Security.^[27] Mills had mentioned plans for a "NTPv5" on his page, but one was never published.^[23] An unrelated draft termed "NTPv5" by M. Lichvar of chrony was initiated in 2020 and includes security, accuracy, and scaling changes.^[28]

SNTP

As NTP replaced the use of the old Time Protocol, some use cases nevertheless found the full protocol too complicated. In 1992, Simple Network Time Protocol (SNTP) was defined to fill this niche. The SNTPv3 standard describes a way to use NTPv3, such that no storage of state over an extended period is needed. The topology becomes essentially the same as with the Time Protocol, as only one server is used.^[10] In 1996, SNTP was updated to SNTPv4^[12] with some features of the then-in-development NTPv4. The current version of SNTPv4 was merged into the main NTPv4 standard in 2010.^[5] SNTP is fully interoperable with NTP since it does not define a new protocol.^[29]: §14 However, the simple algorithms provide times of reduced accuracy and thus it is inadvisable to sync time from an SNTP source.^[13]

Clock strata

The U.S. Naval Observatory Alternate Master Clock at Schriever AFB (Colorado) is a stratum 0 source for NTP

Yellow arrows indicate a direct connection; red arrows indicate a network connection.

NTP uses a hierarchical, semi-layered system of time sources. Each level of this hierarchy is termed a stratum and is assigned a number starting with zero for the reference clock at the top. A server synchronized to a stratum n server runs at stratum n + 1. The number represents the distance from the reference clock and is used to prevent cyclical dependencies in the hierarchy. Stratum is not always an indication of quality or reliability; it is common to find stratum 3 time sources that are higher quality than other stratum 2 time sources.^[a] A brief description of strata 0, 1, 2 and 3 is provided below.

Stratum 0

These are high-precision timekeeping devices such as atomic clocks, GNSS (including GPS) or other radio clocks, or a PTP-synchronized clock.^[30] They generate a very accurate pulse per second signal that triggers an interrupt and timestamp on a connected computer. Stratum 0 devices are also known as reference clocks. NTP servers cannot advertise themselves as stratum 0. A stratum field set to 0 in NTP packet indicates an unspecified stratum.^[5]: 21

Stratum 1

These are computers whose system time is synchronized to within a few microseconds of their attached stratum 0 devices. Stratum 1 servers may peer with other stratum 1 servers for sanity check and backup.^[31] They are also referred to as primary time servers.^[2][3]

Stratum 2

These are computers that are synchronized over a network to stratum 1 servers. Often a stratum 2 computer queries several stratum 1 servers. Stratum 2 computers may also peer with other stratum 2 computers to provide more stable and robust time for all devices in the peer group.

Stratum 3

These are computers that are synchronized to stratum 2 servers. They employ the same algorithms for peering and data sampling as stratum 2, and can themselves act as servers for stratum 4 computers, and so on.

The upper limit for stratum is 15; stratum 16 is used to indicate that a device is unsynchronized. The NTP algorithms on each computer interact to construct a Bellman–Ford shortest-path spanning tree, to minimize the accumulated round-trip delay to the stratum 1 servers for all the clients.^[1]: 20

In addition to stratum, the protocol is able to identify the synchronization source for each server in terms of a reference identifier (refid).

Common time reference identifiers (refid) codes

Refid[32]	Clock Source
GOES	Geostationary Operational Environmental Satellite (described as “Geosynchronous Orbit Environment Satellite” in RFC 5905)
GPS	Global Positioning System
GAL	Galileo Positioning System
PPS	Generic pulse-per-second
IRIG	Inter-Range Instrumentation Group
WWVB	LF Radio WWVB Fort Collins, Colorado 60 kHz
DCF	LF Radio DCF77 Mainflingen, DE 77.5 kHz
HBG	LF Radio HBG Prangins, HB 75 kHz (ceased operation)
MSF	LF Radio MSF Anthorn, UK 60 kHz
JJY	LF Radio JJY Fukushima, JP 40 kHz, Saga, JP 60 kHz
LORC	MF Radio Loran-C station, 100 kHz
TDF	MF Radio Allouis, FR 162 kHz
CHU	HF Radio CHU Ottawa, Ontario
WWV	HF Radio WWV Fort Collins, Colorado
WWVH	HF Radio WWVH Kauai, Hawaii
NIST	NIST telephone modem
ACTS	NIST telephone modem
USNO	USNO telephone modem
PTB	German PTB time standard telephone modem
MRS	(Informal) Multi Reference Sources
GOOG	(Unofficial) Google Refid used by Google NTP servers as time4.google.com

For servers on stratum 2 and below, the refid is an encoded form of the upstream time server's IP address. For IPv4, this is simply the 32-bit address; for IPv6, it would be the first 32 bits of the MD5 hash of the source address. Refids serve to detect and prevent timing loops to the first degree.^[5]

The refid field is filled with status words in the case of kiss-o'-death (KoD) packets, which tell the client to stop sending requests so that the server can rest.^[5] Some examples are INIT (initialization), STEP (step time change), and RATE (client requesting too fast).^[33] The program output may additionally use codes not transmitted in the packet to indicate error, such as XFAC to indicate a network disconnection.^[32]

The IANA maintains a registry for refid source names and KoD codes. Informal assignments can still appear.^[34]

Timestamps

The 64-bit binary fixed-point timestamps used by NTP consist of a 32-bit part for seconds and a 32-bit part for fractional second, giving a time scale that rolls over every 2³² seconds (136 years) and a theoretical resolution of 2⁻³² seconds (233 picoseconds). NTP uses an epoch of January 1, 1900. Therefore, the first rollover occurs on February 7, 2036.^[35][36]

NTPv4 introduces a 128-bit date format: 64 bits for the second and 64 bits for the fractional-second. The most-significant 32 bits of this format is the Era Number which resolves rollover ambiguity in most cases.^[37] According to Mills, "The 64-bit value for the fraction is enough to resolve the amount of time it takes a photon to pass an electron at the speed of light. The 64-bit second value is enough to provide unambiguous time representation until the universe goes dim."^[38][b]

Clock synchronization algorithm

Round-trip delay time δ

A typical NTP client regularly polls one or more NTP servers. The client must compute its time offset and round-trip delay. Time offset θ is positive or negative (client time > server time) difference in absolute time between the two clocks. It is defined by

$${\displaystyle \theta ={\frac {(t_{1}-t_{0})+(t_{2}-t_{3})}{2}},}$$ and the round-trip delay δ by $${\displaystyle \delta ={(t_{3}-t_{0})-(t_{2}-t_{1})},}$$ where

• t₀ is the client's timestamp of the request packet transmission,
• t₁ is the server's timestamp of the request packet reception,
• t₂ is the server's timestamp of the response packet transmission and
• t₃ is the client's timestamp of the response packet reception.^[1]: 19

To derive the expression for the offset, note that for the request packet, $${\displaystyle t_{0}+\theta +\delta /2=t_{1}}$$ and for the response packet, $${\displaystyle t_{3}+\theta -\delta /2=t_{2}}$$ Solving for θ yields the definition of the time offset.

The values for θ and δ are passed through filters and subjected to statistical analysis ("mitigation"). Outliers are discarded and an estimate of time offset is derived from the best three remaining candidates. The clock frequency is then adjusted to reduce the offset gradually ("discipline"), creating a feedback loop.^[1]: 20

Accurate synchronization is achieved when both the incoming and outgoing routes between the client and the server have symmetrical nominal delay. If the routes do not have a common nominal delay, a systematic bias exists of half the difference between the forward and backward travel times. A number of approaches have been proposed to measure asymmetry,^[39] but among practical implementations only chrony seems to have one included.^[40][41]

Software implementations

Further information: ntpd § Implementations

The NTP management protocol utility ntpq under Windows 11 being used to query the state of stratum 1 time servers and verify proper operation of the client.

Reference implementation

The NTP reference implementation, along with the protocol, has been continuously developed for over 20 years. Backwards compatibility has been maintained as new features have been added. It contains several sensitive algorithms, especially to discipline the clock, that can misbehave when synchronized to servers that use different algorithms. The software has been ported to almost every computing platform, including personal computers. It runs as a daemon called ntpd under Unix or as a service under Windows. Reference clocks are supported and their offsets are filtered and analysed in the same way as remote servers, although they are usually polled more frequently.^{[1]: 15–19} This implementation was audited in 2017, finding 14 potential security issues.^[42]

Windows Time

All Microsoft Windows versions since Windows 2000 include the Windows Time service (W32Time),^[43] which has the ability to synchronize the computer clock to an NTP server.

W32Time was originally implemented for the purpose of the Kerberos version 5 authentication protocol, which required time to be within 5 minutes of the correct value to prevent replay attacks. The network time server in Windows 2000 Server (and Windows XP) does not implement NTP disciplined synchronization, only locally disciplined synchronization with NTP/SNTP correction.^[44]

Beginning with Windows Server 2003 and Windows Vista, the NTP provider for W32Time became compatible with a significant subset of NTPv3.^[45] Microsoft states that W32Time cannot reliably maintain time synchronization with one second accuracy.^[46] If higher accuracy is desired, Microsoft recommends using a newer version of Windows or different NTP implementation.^[47]

Beginning with Windows 10 version 1607 and Windows Server 2016, W32Time can be configured to reach time accuracy of 1 s, 50 ms or 1 ms under certain specified operating conditions.^[48][46][49]

OpenNTPD

In 2004, Henning Brauer of OpenBSD presented OpenNTPD, an NTPv3/SNTPv4^[50] implementation with a focus on security and encompassing a privilege separated design. Whilst it is aimed more closely at the simpler generic needs of OpenBSD users, it also includes some protocol security improvements while still being compatible with existing NTP servers. The simpler code base sacrifices accuracy, deemed unnecessary in this use case.^[51] A portable version is available in Linux package repositories.

NTPsec

NTPsec is a fork of the reference implementation that has been systematically security-hardened. The fork point was in June 2015 and was in response to a series of compromises in 2014.^[52] The first production release shipped in October 2017.^[53] Between removal of unsafe features, removal of support for obsolete hardware, and removal of support for obsolete Unix variants, NTPsec has been able to pare away 75% of the original codebase, making the remainder easier to audit.^[54] A 2017 audit of the code showed eight security issues, including two that were not present in the original reference implementation, but NTPsec did not suffer from eight other issues that remained in the reference implementation.^[55]

chrony

Main article: chrony

chronyc, showing Network Time Security (NTS) sources and activity information.

chrony is an independent NTP implementation mainly sponsored by Red Hat, who uses it as the default time program in their distributions.^[56] Being written from scratch, chrony has a simpler codebase allowing for better security^[57] and lower resource consumption.^[58] It does not however compromise on accuracy, instead syncing faster and better than the reference ntpd in many circumstances. It is versatile enough for ordinary computers, which are unstable, go into sleep mode or have intermittent connection to the Internet. It is also designed for virtual machines, a more unstable environment.^[59]

chrony has been evaluated as "trustworthy", with only a few incidents.^[60] It is able to achieve improved precision on LAN connections, using hardware timestamping on the network adapter.^[40] Support for Network Time Security (NTS) was added on version 4.0.^[61] chrony is available under GNU General Public License version 2, was created by Richard Curnow in 1997 and is currently maintained by Miroslav Lichvar.^[58]

ntpd-rs

ntp-ctl (part of ntpd-rs), showing synchronization information and NTS sources.

ntpd-rs is a security-focused implementation of the NTP protocol, founded by the Internet Security Research Group as part of their Prossimo initiative for the creation of memory safe Internet infrastructure. ntpd-rs is implemented in Rust programming language which offers memory safety guarantees in addition to the Real-time computing capabilities which are required for an NTP implementation. ntpd-rs is used in security-sensitive environments such as the Let's Encrypt non-profit Certificate Authority.^[62] Support for NTS is available.^[63] ntpd-rs is part of the "Pendulum" project which also includes a Precision Time Protocol implementation "statime". Both projects are available under Apache and MIT software licenses.

Others

• Ntimed was started by Poul-Henning Kamp of FreeBSD in 2014 and abandoned in 2015.^[64] The implementation was sponsored by the Linux Foundation.^[65]
• systemd-timesyncd is the SNTP client built into systemd. It is used by Debian since version "bookworm"^[66] and the downstream Ubuntu.

Leap seconds

On the day of a leap second event, ntpd receives notification from either a configuration file, an attached reference clock, or a remote server. Although the NTP clock is actually halted during the event, because of the requirement that time must appear to be strictly increasing, any processes that query the system time cause it to increase by a tiny amount, preserving the order of events. If a negative leap second should ever become necessary, it would be deleted with the sequence 23:59:58, 00:00:00, skipping 23:59:59.^[67]

An alternative implementation, called leap smearing, consists in introducing the leap second incrementally during a period of 24 hours, from noon to noon in UTC time. This implementation is used by Google (both internally and on their public NTP servers), Amazon AWS,^[68] and Facebook.^[69] chrony supports leap smear in smoothtime and leapsecmode configurations, but such use is not to be mixed with a public NTP pool as leap smear is non-standard and will throw off client calculation in a mix.^[70]

Security concerns

See also: NTP server misuse and abuse

Because adjusting system time is generally a privileged operation, part or all of NTP code has to be run with some privileges in order to support its core functionality. Only a few other security problems have been identified in the reference implementation of the NTP codebase, but those that appeared in 2009^[which?] were cause for significant concern.^[71][72] The protocol has been undergoing revision and review throughout its history. The codebase for the reference implementation has undergone security audits from several sources for several years.^[73]

A stack buffer overflow exploit was discovered and patched in 2014.^[74] Apple was concerned enough about this vulnerability that it used its auto-update capability for the first time.^[75] On systems using the reference implementation, which is running with root user's credential, this could allow unlimited access. Some other implementations, such as OpenNTPD, have smaller code base and adopted other mitigation measures like privilege separation, are not subject to this flaw.^[76]

A 2017 security audit of three NTP implementations, conducted on behalf of the Linux Foundation's Core Infrastructure Initiative, suggested that both NTP^[77][78] and NTPsec^[79] were more problematic than chrony^[80] from a security standpoint.^[81]

NTP servers can be susceptible to man-in-the-middle attacks unless packets are cryptographically signed for authentication.^[82] The computational overhead involved can make this impractical on busy servers, particularly during denial of service attacks.^[83] NTP message spoofing from a man-in-the-middle attack can be used to alter clocks on client computers and allow a number of attacks based on bypassing of cryptographic key expiration.^[84] Some of the services affected by fake NTP messages identified are TLS, DNSSEC, various caching schemes (such as DNS cache), Border Gateway Protocol (BGP), Bitcoin ^{[citation needed]}and a number of persistent login schemes.^[85][86]

NTP has been used in distributed denial of service attacks.^[87][88] A small query is sent to an NTP server with the return IP address spoofed to be the target address. Similar to the DNS amplification attack, the server responds with a much larger reply that allows an attacker to substantially increase the amount of data being sent to the target. To avoid participating in an attack, NTP server software can be upgraded or servers can be configured to ignore external queries.^[89]

Secure extensions

NTP itself includes support for authenticating servers to clients. NTPv3 supports a symmetric key mode, which is not useful against MITM. The public key system known as "autokey" in NTPv4 adapted from IPSec offers useful authentication,^[82] but is not practical for a busy server.^[83] Autokey was also later found to suffer from several design flaws,^[90] with no correction published, save for a change in the message authentication code.^[16] Autokey should no longer be used.^[91]

Network Time Security (NTS) is a secure version of NTPv4 with TLS and AEAD.^[92] The main improvement over previous attempts is that a separate "key establishment" server handles the heavy asymmetric cryptography, which needs to be done only once. If the server goes down, previous users would still be able to fetch time without fear of MITM.^[27] NTS is supported by several NTP servers including Cloudflare and Netnod.^[93][94] It can be enabled on chrony, NTPsec, and ntpd-rs.^[95]

Microsoft also has an approach to authenticate NTPv3/SNTPv4 packets using a Windows domain identity, known as MS-SNTP.^[96] This system is implemented in the reference ntpd and chrony, using samba for the domain connection.^[97]

See also

• Allan variance – Measure of frequency stability in clocks and oscillators
• Clock network – Set of clocks that synchronized to same time
• International Atomic Time – Time standard based on atomic clocks
• IRIG timecode – Standard formats for transferring time information
• NITZ – Mechanism for time synchronisation on mobile devices
• NTP pool – Networked computers providing time synchronization
• Ntpdate – Software to synchronize computer time
• Precision Time Protocol – Network time synchronization protocol

Notes

1. Telecommunication systems use a different definition for clock strata.
2. 2⁻⁶⁴ seconds is about 54 zeptoseconds (light would travel 16.26 picometers, or approximately 0.31 × Bohr radius), and 2⁶⁴ seconds is about 585 billion years.