add network time

source/manual/ntpd.rst

@@ -0,0 +1,65 @@
+==============
+Network Time
+==============
+
+OPNsense ships with a standard `NTPd <http://doc.ntp.org/current-stable/>`__ server,
+which synchronizes time with upstream servers and provides time to connected clients.
+
+A newly installed firewall comes with NTP enabled on all interfaces (firewall blocks all non LAN access in this case),
+forwarding queries to one of the :code:`X.opnsense.pool.ntp.org` upstreams (:code:`X` is any of 0,1,2,3).
+
+-------------------------
+General settings
+-------------------------
+
+In most cases the default setup is ready to use, below you will find some of the general options which can be configured.
+
+=====================================================================================================================
+
+====================================  ===============================================================================
+Interface(s)	                        Interfaces to bind to, when none is selected it listens to all
+Time servers                          Servers to use, comes with two toggles:
+
+                                      * Prefer
+                                          Marks the server as preferred.
+                                      * Do not use
+                                          Marks the server as unused, except for display purposes.
+                                          The server is discarded by the selection algorithm.
+Orphan mode                           Orphan mode allows the system clock to be used when no other
+                                      clocks are available. The number here specifies the stratum reported
+                                      during orphan mode and should normally be set to a number high enough to
+                                      insure that any other servers available to clients are
+                                      preferred over this server.
+NTP graphs                            Enable RRD graphs of NTP statistics, which can be viewed in
+                                      :menuselection:`Reporting --> Health`
+Syslog logging                        Extend logging with peer and/or system messages
+Statistics logging                    Enable statistical logging in :code:`/var/log/ntp`, doesn't come with a
+                                      user interface
+Access restrictions                   Within the access restriction row, you can set various options which
+                                      limit the use of ntpd and in some cases instruct ntpd how to handle
+                                      rejected clients.
+Leap seconds                          You can manually supply ntpd with a leap seconds file, more detailed info
+                                      on the contents of those files can be found
+                                      `here <http://support.ntp.org/bin/view/Support/ConfiguringNTP#Section_6.14.>`__
+====================================  ===============================================================================
+
+
+.. Note::
+
+    NTPs is disabled if no Time servers are configured. There is no separate enable/disable toggle.
+
+
+-------------------------
+GPS
+-------------------------
+
+If you own a gps receiver, which supports NMEA, you can use it as a reference clock and configure it in this section.
+For some brands settings are preconfigured, you can also use custom settings.
+
+
+-------------------------
+PPS
+-------------------------
+
+If your GPS receiver supports PPS (Pulse Per Second) output or you have a separate PPS signal available, you
+can configure the serial port to use along with some other settings here.

source/services.rst

@@ -19,6 +19,7 @@ Your security appliance comes with quite some services to ease network operation
    manual/dhcp
    manual/dnsmasq
    manual/ips
+   manual/ntpd
    manual/unbound
    manual/proxy
    manual/dynamic_routing