Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ntptrace (8)

Name

ntptrace - trace a chain of NTP hosts back to their master time source

Synopsis

/usr/sbin/ntptrace [-n] [-m maxhosts] [server]

Description

System Administration Commands                                     ntptrace(8)



NAME
       ntptrace - trace a chain of NTP hosts back to their master time source

SYNOPSIS
       /usr/sbin/ntptrace [-n] [-m maxhosts] [server]

DESCRIPTION
       ntptrace  determines  from  where  a  given Network Time Protocol (NTP)
       server gets its time, and follows the chain of   NTP  servers  back  to
       their master time source. If given no arguments, it starts with  local-
       host.

OPTIONS
       The following options are supported:

       -n            Turns off the printing of host names;  instead,  host  IP
                     addresses are given.


       -m maxhosts   Sets  the maximum number of levels up the chain that will
                     be followed.


EXAMPLES
       Example 1 Sample Output From the ntptrace Command

       The following example shows the output from the ntptrace command:


         % ntptrace


          localhost: stratum 4, offset 0.0019529, synch distance 0.144135
          server2.bozo.com: stratum 2, offset 0.0124263, synch distance 0.115784
          usndh.edu: stratum 1, offset 0.0019298, synch distance 0.011993, refid 'WWVB'



       On each line, the fields are (left to right):


           o      The server's host name

           o      The server's stratum

           o      The time offset between that server and the local  host  (as
                  measured  by ntptrace; this is why it is not always zero for
                  localhost)

           o      The host's synchronization distance

           o      The reference clock ID (only for stratum-1 servers)

       All times are given in seconds. Synchronization distance is  a  measure
       of the goodness of the clock's time.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+---------------------+
       |ATTRIBUTE TYPE |  ATTRIBUTE VALUE    |
       +---------------+---------------------+
       |Availability   | service/network/ntp |
       +---------------+---------------------+
       |Stability      | Volatile            |
       +---------------+---------------------+

SEE ALSO
       ntpq(8), ntpd(8), attributes(7))




NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source          was         downloaded         from          http://ar-
       chive.ntp.org/ntp4/ntp-4.2/ntp-4.2.8p15.tar.gz.

       Further information about this software can be found on the open source
       community website at http://www.ntp.org/.



                                                                   ntptrace(8)