1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2:
3: <html>
4:
5: <head>
6: <meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
7: <meta name="generator" content="HTML Tidy, see www.w3.org">
8: <title>The Network Time Protocol (NTP) Distribution</title>
9: <link href="scripts/style.css" type="text/css" rel="stylesheet">
10: </head>
11:
12: <body>
13: <h3>The Network Time Protocol (NTP) Distribution</h3>
14: <img src="pic/barnstable.gif" alt="gif" align="left"><a href="http://www.eecis.udel.edu/%7emills/pictures.html"><i>P.T. Bridgeport Bear</i>; from <i>Pogo</i>, Walt Kelly</a>
15: <p>Pleased to meet you.</p>
16: <p>Last update:
17: <!-- #BeginDate format:En2m -->07-Nov-2009 20:43<!-- #EndDate -->
18: UTC</p>
19: <br clear="left">
20: <h4>Related Links</h4>
21: <ul>
22: <li>A list of all links is on the <a href="sitemap.html">Site Map</a> page.</li>
23: </ul>
24: <h4>Table of Contents</h4>
25: <ul>
26: <li class="inline"><a href="#intro">Introduction</a></li>
27: <li class="inline"><a href="#build">Building and Installing NTP</a></li>
28: <li class="inline"><a href="#conf">Configuring Clients and Servers</a></li>
29: <li class="inline"><a href="#opt">Features and Options</a></li>
30: <li class="inline"><a href="#prob">Resolving Problems</a></li>
31: <li class="inline"><a href="#info">Further Information</a></li>
32: </ul>
33: <hr>
34: <h4 id="intro">Introduction</h4>
35: <p>Note: The NTP Version 4 software contained in this distribution is available without charge under the conditions set forth in the <a href="copyright.html">Copyright Notice</a>.</p>
36: <dl>
37: <dd>It is very important that readers understand that the NTP document collection began 25 years ago and remains today a work in progress. It has evolved as new features were invented and old features retired. It has been widely copied, cached and morphed to other formats, including man pages, with varying loss of fidelity. However, these HTML pages are the ONLY authoritative and definitive reference. Readers should always use the collection that comes with the distribution they use. A copy of the online collection at <a href="http://www.ntp.org">www.ntp.org</a> is normally included in the most recent snapshot, but might not agree with an earlier snapshot or release version.</dd>
38: </dl>
39: <p>The Network Time Protocol (NTP) is widely used to synchronize a computer
40: to Internet time servers or other sources, such as a radio or satellite
41: receiver or telephone modem service. It can also be used as a server
42: for dependent clients. It provides accuracies typically less than
43: a millisecond on LANs and up to a few milliseconds on WANs. Typical
44: NTP configurations utilize multiple redundant servers and diverse
45: network paths in order to achieve high accuracy and reliability.
46: Authentication is provided using symmetric key cryptography and
47: the MD5 message digest algorithm included in the distribution. If
48: the OpenSSL cryptographic library is installed, the SHA or SHA1 message
49: digest algorithms can be used. If the OpenSSL library is installed,
50: additional options based on public key cryptography are available.</p>
51: <p>NTP time synchronization services are widely available in the public Internet.
52: The public NTP subnet in early 2008 includes several thousand servers
53: in most countries and on every continent of the globe, including Antarctica.
54: These servers support a total population estimated at over 25 million computers
55: in the global Internet. The NTP subnet operates with a hierarchy of levels,
56: where each level is assigned a number called the stratum. Stratum 1 (primary)
57: servers at the lowest level are directly synchronized to national time services.
58: Stratum 2 (secondary) servers at the next higher level are synchronize to stratum
59: 1 servers and so on. Normally, NTP clients and servers with a relatively small
60: number of clients do not synchronize to public primary servers. There
61: are several hundred public secondary servers operating at higher strata and
62: are the preferred choice. </p>
63: <p>Background information on computer network time synchronization is on the <a href="http://www.eecis.udel.edu/%7emills/exec.html">Executive Summary - Computer Network Time Synchronization</a> page. Discussion on new features and interoperability with previous NTP versions is on the <a href="release.html">NTP Version 4 Release Notes</a> page. Background information, bibliography and briefing slides suitable for presentations are on the <a href="http://www.eecis.udel.edu/%7emills/ntp.html">Network Time Synchronization Research Project</a> page. Additional information is at the NTP web site <a href="http://www.ntp.org">www.ntp.org</a>.</p>
64: <h4 id="build">Building and Installing NTP</h4>
65: <p>NTP supports Unix, VMS and Windows (Vista, XP, NT4 and 2000) systems. The <a href="build.html">Building and Installing the Distribution</a> page details the procedures for building and installing on a typical system. This distribution includes drivers for 44 radio and satellite receivers and telephone modem services in the US, Canada and Europe. A list of supported drivers is on the <a href="refclock.html">Reference Clock Drivers</a> page. The default build includes the debugging options and all drivers that run on the target machine; however, options and drivers can be included or excluded using options on the <a href="config.html">Configuration Options</a> page.</p>
66: <h4 id="conf">Configuring Clients and Servers</h4>
67: <p>NTP is by its very nature a complex distributed network application and can be configured for widely divergent timekeeping scenarios. The documentation on these pages attempts to cover the entire suite of configuration, operation and maintenance features which this distribution supports. However, most applications will need only a few of these features. The <a href="quick.html">Quick Start</a> page may be useful to get a simple workstation on the air with existing servers.</p>
68: <p>The most important factor in providing accurate, reliable time is the selection of modes and servers in the configuration file. A discussion on the available modes is on the <a href="assoc.html">Association Management</a> page. The current public server list is maintained at the <a href="http://www.ntp.org">www.ntp.org</a> web site. In many cases the configuration can be automated using the schemes described on the <a href="manyopt.html">Automatic Server Discovery Schemes</a> page.</p>
69: <h4 id="opt">Features and Options</h4>
70: <p>This distribution includes a statistics data recording facility which can record performance statistics and events of various types for retrospective analysis. These include time and frequency statistics, significant events and usage statistics described on the <a href="monopt.html">Monitoring Options</a> page.</p>
71: <p>Some programs included in this distribution use cryptographic algorithms to verify server authenticity. Where local security policy permits relatively weak symmetric key cryptography, the required software is included in this distribution. Where local policy requires stronger public key cryptography, the OpenSSL library available from <a href="http://www.openssl.org">http://www.openssl.org</a> is required. This library is also used by the Secure Shell facility, so is often already installed. Additional details are on the <a href="authopt.html">Authentication Options</a> page.</p>
72: <p>This distribution includes features that can restrict access in various ways as described on the <a href="accopt.html">Access Control Options</a> page. This can be used to deny service if not authenticated, deny service requiring persistent resources or deny service altogether.</p>
73: <p>This distribution includes a simulation framework in which substantially
74: all the runtime NTP operations and most features can be tested and
75: evaluated. This has been very useful in exploring in vitro response
76: to unusual circumstances or over time periods impractical in vivo. Details
77: are on the <a href="ntpdsim.html">Network
78: Time Protocol (NTP) Simulator</a> page.</p>
79: <h4 id="prob">Resolving Problems</h4>
80: <p>Like other things in modern Internet life, NTP problems can be devilishly intricate. This distribution includes a number of utilities designed to identify and repair problems using an integrated management protocol supported by the <a href="ntpq.html"><tt>ntpq</tt></a> utility program In addition, the <a href="ntpdc.html"><tt>ntpdc</tt></a> utility program can be useful in some cases.</p>
81: <p>The <a href="debug.html">NTP Debugging Techniques</a> and <a href="hints.html">Hints and Kinks</a> pages contain useful information for identifying problems and devising solutions. Additional information on reference clock driver construction and debugging is in the <a href="rdebug.html">Debugging Hints for Reference Clock Drivers</a> page.</p>
82: <p>Users are invited to report bugs and offer suggestions via the <a href="bugs.html">NTP Bug Reporting Procedures</a> page.</p>
83: <h4 id="info">Further Information</h4>
84: <p>The <a href="sitemap.html">Site Map</a> page contains a list of document collections arranged by topic. The Program Manual Pages collection may be the best place to start, followed by the <a href="comdex.html"></a>Configuration Commands and Options collection. The <a href="comdex.html">Command Index</a> collection contains a list of all configuration file commands together with a short function description. A great wealth of additional information is available via the External Links collection, including a book and numerous background papers and briefing presentations.</p>
85: <hr>
86: <div align="center">
87: <img src="pic/pogo1a.gif" alt="gif"></div>
88: <br>
89: <script type="text/javascript" language="javascript" src="scripts/footer.txt"></script>
90: </body>
91:
92: </html>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>