Home | History | Annotate | Line # | Download | only in etc
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