ntpd(8)                             CLIX                             ntpd(8)



  NAME

    ntpd - Runs time synchronization daemon implementing NTP

  SYNOPSIS

    /usr/ip32/tcpip/ntpd [-a threshold] [-c file] [-d] [-D level] [-s]

  FLAGS

    -a threshold   Sets the threshold to limit how much ntpd changes the local
                   system clock.  This threshold is used as a sanity check to
                   prevent the system time from being changed a great deal.
                   By default, the threshold is 1000 seconds.  The threshold
                   argument can be specified as a number in units of seconds,
                   or as the string any to defeat the sanity check.

    -c file        Specifies the location of the ntpd configuration file.  By
                   default, /etc/ntp.conf is used.

    -d             Increments the debug level by a value of one.  This flag
                   can be specified more than once to increment the debug
                   level by one each time.

    -D level       Sets the debug level to level.  The higher the value (up to
                   8), the more debugging information displayed.

    -s             Causes ntpd to never adjust the local clock.

  DESCRIPTION

    The ntpd daemon implements the Network Time Protocol (NTP) described in
    RFC-1059.  This program periodically communicates with ntpd daemons on
    remote hosts in order to synchronize the clock on the local host with
    clocks on the remote hosts.  The ntpd daemon can accommodate remote clocks
    that have a varying degree of accuracy and reliability.

    The ntpd daemon uses the adjtime function to skew the clock on the local
    host by a small amount in order to keep the clock synchronized.  If the
    local clock exceeds the ``correct'' time by some threshold, then stime is
    called to make a step adjustment of the local clock.

    Entries in the ntpd configuration file (/etc/ntp.conf by default)
    determine whether the local clock is synchronized to a clock on a remote
    host or clocks on remote hosts are synchronized to the local clock.  In a
    typical configuration, one host on a local network is selected to act as
    the ``time server master'' for that network.  Other hosts on that network
    send NTP requests to the ntpd daemon on the time server master to have the
    daemon synchronize their clocks.  If the network is isolated, the time
    server master should be configured to have a local type reference clock.
    Multiple hosts can exist as time server masters on the same local network.



  2/94 - Intergraph Corporation                                              1

  ntpd(8)                             CLIX                             ntpd(8)



  EXAMPLES

    1.  The following starts the ntpd daemon using /etc/ntp.secure as the
        configuration file, limiting local system clock changes to once every
        1800 seconds (30 minutes), and setting the debug level to 2:

        ntpd -c /etc/ntp.secure -a 1800 -dd


    2.  The following starts the ntpd daemon, disallows local clock updates,
        and sets the debug level to 5:

        ntpd -s -D 5


  FILES

    /etc/ntp.conf    NTP daemon default configuration file.

    /etc/ntp.drift   NTP drift compensation register.



    /etc/clock.txt   List of low-level stratum clocks which with the local
                     machine may synchronize.

  NOTES

    Please choose NTP peers carefully.

  CAUTIONS

    RFC-1129 strongly suggests using a highly accurate clock as the primary
    server for ntp to work as designed.

    The configuration file (/etc/ntp.conf) must have at least one valid peer,
    server, or passive entry for ntpd to run properly.

  DIAGNOSTICS

    udp/ntp: service unknown, using default port_num
           A udp/ntp entry needs to be added to /etc/services.

    Problem opening NTP initialization file filename
           Check the existence and permissions of the named configuration
           file.  Also, ntpd must be run as superuser.

    Can't open /dev/kmem for reading
           The ntpd command must be run as superuser for it to access memory.

    init_ntp: bad drift compensation value



  2                                              Intergraph Corporation - 2/94

  ntpd(8)                             CLIX                             ntpd(8)



           The ntpd daemon tried to process a poorly formatted value, or a
           value outside a defined range, for the amount of intrinsic drift in
           the local clock.  The daemon will set this value to zero and
           continue processing.

    Various error messages about parameters specified in the configuration
    file may appear if values are inappropriate or syntax of commands is
    incorrect.

    Other error messages that may appear can be caused by connection or I/O
    difficulties.

  EXIT VALUES

    Errors occurring from problems reading configuration files or with data in
    the files causes the ntpd daemon to exit with a status of 1.

  RELATED INFORMATION

    Commands:  ntp(1), ntpdc(1)

    Functions:  adjtime(2), stime(2)

    Files:  ntp.conf(4)

    Mills, David L., ``Network Time Protocol (Version 1),'' RFC-1059




























  2/94 - Intergraph Corporation                                              3