ntp.conf revision 1.17 1 1.17 apb # $NetBSD: ntp.conf,v 1.17 2014/01/06 11:25:03 apb Exp $
2 1.1 fair #
3 1.7 fredb # NetBSD default Network Time Protocol (NTP) configuration file for ntpd
4 1.8 fredb
5 1.8 fredb # This file is intended to be both a usable default, and a Quick-Start
6 1.8 fredb # Guide. The directives and options listed here are not at all complete.
7 1.9 reed # A great deal of additional documentation, including links to FAQS and
8 1.8 fredb # other guides, may be found on the official NTP web site, in particular
9 1.8 fredb #
10 1.8 fredb # http://www.ntp.org/documentation.html
11 1.8 fredb #
12 1.1 fair
13 1.1 fair # Process ID file, so that the daemon can be signalled from scripts
14 1.1 fair
15 1.3 lukem pidfile /var/run/ntpd.pid
16 1.1 fair
17 1.2 simonb # The correction calculated by ntpd(8) for the local system clock's
18 1.7 fredb # drift is stored here.
19 1.1 fair
20 1.3 lukem driftfile /var/db/ntp.drift
21 1.1 fair
22 1.7 fredb # Suppress the syslog(3) message for each peer synchronization change.
23 1.1 fair
24 1.3 lukem logconfig -syncstatus
25 1.5 fredb
26 1.17 apb # Refuse to set the local clock if there are too few good peers or servers.
27 1.17 apb # This may help minimize disruptions due to network congestion. Don't
28 1.5 fredb # do this if you configure only one server!
29 1.5 fredb
30 1.5 fredb tos minsane 2
31 1.1 fair
32 1.10 christos # Set the number of tries to register with mdns. 0 means never
33 1.10 christos #
34 1.10 christos mdnstries 0
35 1.10 christos
36 1.15 christos # New ntpd disables the ntpdc protocol by default, to re-enable uncomment
37 1.15 christos # the following line
38 1.15 christos # enable mode7
39 1.15 christos
40 1.16 apb # Access control restrictions.
41 1.16 apb # See /usr/share/doc/html/ntp/accopt.html for syntax.
42 1.16 apb # See <http://support.ntp.org/bin/view/Support/AccessRestrictions> for advice.
43 1.16 apb # Last match wins.
44 1.16 apb #
45 1.16 apb # Some of the more common keywords are:
46 1.16 apb # ignore Deny packets of all kinds.
47 1.16 apb # kod Send "kiss-o'-death" packets if clients exceed rate
48 1.16 apb # limits.
49 1.16 apb # nomodify Deny attempts to modify the state of the server via
50 1.16 apb # ntpq or ntpdc queries.
51 1.16 apb # noquery Deny all ntpq and ntpdc queries. Does not affect time
52 1.16 apb # synchronisation.
53 1.16 apb # nopeer Prevent establishing an new peer association.
54 1.16 apb # Does not affect preconfigured peer associations.
55 1.16 apb # Does not affect client/server time synchronisation.
56 1.16 apb # noserve Deny all time synchronisation. Does not affect ntpq or
57 1.16 apb # ntpdc queries.
58 1.16 apb # notrap Deny the trap subset of the ntpdc control message protocol.
59 1.16 apb # notrust Deny packets that are not cryptographically authenticated.
60 1.16 apb #
61 1.16 apb # By default, either deny everything, or allow client/server time exchange
62 1.16 apb # but deny configuration changes, queries, and peer associations that were not
63 1.16 apb # explicitly configured.
64 1.16 apb # (Uncomment one of the following "restrict default" lines.)
65 1.16 apb #
66 1.16 apb #restrict default ignore
67 1.16 apb restrict default kod nopeer noquery
68 1.16 apb
69 1.16 apb # Fewer restrictions for the local subnet.
70 1.16 apb # (Uncomment and adjust as appropriate.)
71 1.16 apb #
72 1.16 apb #restrict 192.0.2.0 mask 255.255.255.0 kod nomodify notrap nopeer
73 1.16 apb #restrict 2001:db8:: mask ffff:ffff:: kod nomodify notrap nopeer
74 1.16 apb
75 1.16 apb # No restrictions for localhost.
76 1.16 apb #
77 1.16 apb restrict 127.0.0.1
78 1.16 apb restrict ::1
79 1.16 apb
80 1.7 fredb # Hereafter should be "server" or "peer" statements to configure other
81 1.17 apb # hosts to exchange NTP packets with.
82 1.17 apb #
83 1.17 apb # See <http://support.ntp.org/bin/view/Support/DesigningYourNTPNetwork>
84 1.17 apb # and <http://support.ntp.org/bin/view/Support/SelectingOffsiteNTPServers>
85 1.17 apb # for advice.
86 1.17 apb #
87 1.17 apb # Peers should be selected in such a way that the network path to them
88 1.17 apb # is short, uncongested, and symmetric (that is, the series of links
89 1.17 apb # and routers used to get to the peer is the same one that the peer
90 1.17 apb # uses to get back). The best place to start looking for NTP peers for
91 1.17 apb # your system is within your own network, or at your Internet Service
92 1.17 apb # Provider (ISP).
93 1.1 fair #
94 1.7 fredb # Ideally, you should select at least three other systems to talk NTP
95 1.7 fredb # with, for an "what I tell you three times is true" effect.
96 1.1 fair #
97 1.16 apb # A "restrict" line for each configured peer or server might be necessary,
98 1.16 apb # if the "restrict default" settings are very restrictive. As a courtesy
99 1.16 apb # to configured peers and servers, consider allowing them to query.
100 1.1 fair
101 1.3 lukem #peer an.ntp.peer.goes.here
102 1.3 lukem #server an.ntp.server.goes.here
103 1.16 apb #restrict an.ntp.server.goes.here nomodify notrap
104 1.4 agc
105 1.17 apb # The pool.ntp.org project coordinates public time servers provided by
106 1.17 apb # volunteers. See <http://www.pool.ntp.org>. The *.netbsd.pool.ntp.org
107 1.17 apb # servers are intended to be used by default on NetBSD hosts, but
108 1.17 apb # servers that are closer to you are likely to be better. Consider
109 1.17 apb # using servers specific to your country, a nearby country, or your
110 1.17 apb # continent.
111 1.17 apb #
112 1.6 fredb # The pool.ntp.org project needs more volunteers! The only criteria to
113 1.6 fredb # join are a nailed-up connection and a static IP address. For details,
114 1.6 fredb # see the web page:
115 1.6 fredb #
116 1.14 christos # http://www.pool.ntp.org/join.html
117 1.6 fredb #
118 1.6 fredb
119 1.6 fredb # Depending on the vagaries of DNS can occasionally pull in the same
120 1.6 fredb # server twice. The following CNAMES are guaranteed to be disjoint, at
121 1.13 christos # least over some short interval. The following servers are allocated
122 1.13 christos # to the NetBSD project.
123 1.6 fredb
124 1.13 christos server 0.netbsd.pool.ntp.org
125 1.16 apb restrict 0.netbsd.pool.ntp.org nomodify notrap
126 1.13 christos server 1.netbsd.pool.ntp.org
127 1.16 apb restrict 1.netbsd.pool.ntp.org nomodify notrap
128 1.13 christos server 2.netbsd.pool.ntp.org
129 1.16 apb restrict 2.netbsd.pool.ntp.org nomodify notrap
130 1.13 christos server 3.netbsd.pool.ntp.org
131 1.16 apb restrict 3.netbsd.pool.ntp.org nomodify notrap
132