ntp.conf revision 1.23 1 1.23 kim # $NetBSD: ntp.conf,v 1.23 2021/10/28 07:24:40 kim 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.1 fair
12 1.1 fair # Process ID file, so that the daemon can be signalled from scripts
13 1.1 fair
14 1.21 kim pidfile /var/run/ntpd.pid
15 1.21 kim
16 1.21 kim # Don't give up even if the reference time is hugely different. This can
17 1.21 kim # happen if the system was suspended and resumed.
18 1.21 kim
19 1.21 kim #tinker panic 0
20 1.1 fair
21 1.2 simonb # The correction calculated by ntpd(8) for the local system clock's
22 1.7 fredb # drift is stored here.
23 1.1 fair
24 1.21 kim driftfile /var/db/ntp.drift
25 1.1 fair
26 1.7 fredb # Suppress the syslog(3) message for each peer synchronization change.
27 1.1 fair
28 1.21 kim logconfig -syncstatus
29 1.5 fredb
30 1.17 apb # Refuse to set the local clock if there are too few good peers or servers.
31 1.17 apb # This may help minimize disruptions due to network congestion. Don't
32 1.5 fredb # do this if you configure only one server!
33 1.5 fredb
34 1.21 kim tos minsane 2
35 1.21 kim
36 1.21 kim # Set the target and limit for adding servers configured via pool statements
37 1.21 kim # or discovered dynamically via mechanisms such as broadcast and manycast.
38 1.21 kim # Ntpd automatically adds maxclock-1 servers from configured pools, and may
39 1.21 kim # add as many as maxclock*2 if necessary to ensure that at least minclock
40 1.21 kim # servers are providing good consistent time.
41 1.21 kim
42 1.21 kim tos minclock 3 maxclock 6
43 1.1 fair
44 1.10 christos # Set the number of tries to register with mdns. 0 means never
45 1.21 kim
46 1.21 kim mdnstries 0
47 1.10 christos
48 1.15 christos # New ntpd disables the ntpdc protocol by default, to re-enable uncomment
49 1.15 christos # the following line
50 1.21 kim
51 1.21 kim #enable mode7
52 1.21 kim
53 1.21 kim # Allow hasty ntpdate clients to avoid rate limiting / kod responses.
54 1.21 kim # The default is 2 seconds between packets from the client.
55 1.21 kim
56 1.21 kim #discard minimum 1
57 1.15 christos
58 1.16 apb # Access control restrictions.
59 1.16 apb # See /usr/share/doc/html/ntp/accopt.html for syntax.
60 1.16 apb # See <http://support.ntp.org/bin/view/Support/AccessRestrictions> for advice.
61 1.16 apb # Last match wins.
62 1.16 apb #
63 1.16 apb # Some of the more common keywords are:
64 1.16 apb # ignore Deny packets of all kinds.
65 1.21 kim # limited Deny time service if the packet violates the rate limits
66 1.21 kim # established by the discard command. Does not affect ntpq or
67 1.21 kim # ntpdc queries.
68 1.21 kim # kod Send "kiss-o'-death" packets if clients exceed rate limits.
69 1.23 kim # No effect without the limited flag.
70 1.21 kim # nomodify Deny attempts to modify the state of the server via ntpq or
71 1.21 kim # ntpdc queries.
72 1.16 apb # noquery Deny all ntpq and ntpdc queries. Does not affect time
73 1.16 apb # synchronisation.
74 1.19 apb # nopeer Prevent establishing new peer associations.
75 1.19 apb # Does not affect peers configured using "peer" lines.
76 1.16 apb # Does not affect client/server time synchronisation.
77 1.16 apb # noserve Deny all time synchronisation. Does not affect ntpq or
78 1.16 apb # ntpdc queries.
79 1.16 apb # notrap Deny the trap subset of the ntpdc control message protocol.
80 1.16 apb # notrust Deny packets that are not cryptographically authenticated.
81 1.16 apb #
82 1.19 apb # By default, allow client/server time exchange without prior
83 1.19 apb # arrangement, but deny configuration changes, queries, and peer
84 1.19 apb # associations that were not explicitly configured.
85 1.21 kim
86 1.21 kim restrict default limited kod nomodify notrap nopeer noquery
87 1.21 kim
88 1.21 kim # Restrictions used for associations (peer, server, pool).
89 1.21 kim
90 1.21 kim restrict source nomodify notrap noquery
91 1.16 apb
92 1.16 apb # Fewer restrictions for the local subnet.
93 1.16 apb # (Uncomment and adjust as appropriate.)
94 1.21 kim
95 1.21 kim #restrict 192.0.2.0 mask 255.255.255.0 limited kod nomodify notrap nopeer
96 1.21 kim #restrict 2001:db8:: mask ffff:ffff:: limited kod nomodify notrap nopeer
97 1.16 apb
98 1.16 apb # No restrictions for localhost.
99 1.21 kim
100 1.16 apb restrict 127.0.0.1
101 1.16 apb restrict ::1
102 1.16 apb
103 1.21 kim # Hereafter should be "server", "peer", or "pool" statements to configure
104 1.21 kim # other hosts to exchange NTP packets with.
105 1.17 apb #
106 1.17 apb # See <http://support.ntp.org/bin/view/Support/DesigningYourNTPNetwork>
107 1.17 apb # and <http://support.ntp.org/bin/view/Support/SelectingOffsiteNTPServers>
108 1.17 apb # for advice.
109 1.17 apb #
110 1.19 apb # Peers or servers should be selected in such a way that the network
111 1.19 apb # path to them is short, uncongested, and symmetric (that is, the series
112 1.19 apb # of links and routers used to get to the peer is the same one that
113 1.19 apb # the peer uses to get back). The best place to start looking for NTP
114 1.19 apb # peers for your system is within your own network, or at your Internet
115 1.19 apb # Service Provider (ISP).
116 1.1 fair #
117 1.7 fredb # Ideally, you should select at least three other systems to talk NTP
118 1.7 fredb # with, for an "what I tell you three times is true" effect.
119 1.1 fair
120 1.22 kim #peer an.ntp.peer.goes.here iburst
121 1.22 kim #server an.ntp.server.goes.here iburst
122 1.4 agc
123 1.17 apb # The pool.ntp.org project coordinates public time servers provided by
124 1.17 apb # volunteers. See <http://www.pool.ntp.org>. The *.netbsd.pool.ntp.org
125 1.21 kim # servers are intended to be used by default on NetBSD hosts.
126 1.21 kim #
127 1.21 kim # The following pool statement will give you a random set of NTP servers
128 1.21 kim # geographically close to you. A single pool statement adds multiple
129 1.21 kim # servers from the pool, according to the tos minclock/maxclock targets.
130 1.21 kim # The "2" host is used to obtain both IPv4 and IPv6 addresses.
131 1.17 apb #
132 1.6 fredb # The pool.ntp.org project needs more volunteers! The only criteria to
133 1.6 fredb # join are a nailed-up connection and a static IP address. For details,
134 1.21 kim # see the web page <http://www.pool.ntp.org/join.html>
135 1.6 fredb
136 1.21 kim pool 2.netbsd.pool.ntp.org iburst
137