1 '\" te

     2 .\" CDDL HEADER START

     3 .\"

     4 .\" The contents of this file are subject to the terms of the

     5 .\" Common Development and Distribution License (the "License").

     6 .\" You may not use this file except in compliance with the License.

     7 .\"

     8 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE

     9 .\" or http://www.opensolaris.org/os/licensing.

    10 .\" See the License for the specific language governing permissions

    11 .\" and limitations under the License.

    12 .\"

    13 .\" When distributing Covered Code, include this CDDL HEADER in each

    14 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.

    15 .\" If applicable, add the following below this CDDL HEADER, with the

    16 .\" fields enclosed by brackets "[]" replaced with your own identifying

    17 .\" information: Portions Copyright [yyyy] [name of copyright owner]

    18 .\"

    19 .\" CDDL HEADER END

    20 .\"

    21 .\" Copyright (c) 2009, 2015, Oracle and/or its affiliates. All rights reserved.

    22 .\"

    23 .TH "ntptrace" "8" "" "" "System Administration Commands"

    24 .SH NAME

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

    26 .SH SYNOPSIS

    27 .LP

    28 .nf

    29 \fB/usr/sbin/ntptrace\fR [\fB-n\fR] [\fB-m\fR \fImaxhosts\fR] [\fIserver\fR]

    30 .fi

    31 .SH DESCRIPTION

    32 .LP

    33 \fBntptrace\fR determines from where a given Network Time Protocol (\fBNTP\fR) server gets its time, and follows the chain of  \fBNTP\fR servers back to their master time source. If given no arguments, it starts with  \fIlocalhost\fR.

    34 .SH OPTIONS

    35 .LP

    36 The following options are supported:

    37 .sp

    38 .ne 2

    39 .mk

    40 .na

    41 \fB\fB-n\fR\fR

    42 .ad

    43 .RS 14n

    44 .rt  

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

    46 .RE

    47 

    48 .sp

    49 .ne 2

    50 .mk

    51 .na

    52 \fB\fB-m\fR \fImaxhosts\fR\fR

    53 .ad

    54 .RS 14n

    55 .rt  

    56 Sets the maximum number of levels up the chain that will be followed.

    57 .RE

    58 

    59 .SH EXAMPLES

    60 .LP

    61 \fBExample 1 \fRSample Output From the \fBntptrace\fR Command

    62 .LP

    63 The following example shows the output from the \fBntptrace\fR command:

    64 

    65 .sp

    66 .in +2

    67 .nf

    68 % \fBntptrace\fR

    69 

    70 

    71  localhost: stratum 4, offset 0.0019529, synch distance 0.144135

    72  server2.bozo.com: stratum 2, offset 0.0124263, synch distance 0.115784

    73  usndh.edu: stratum 1, offset 0.0019298, synch distance 0.011993, refid 'WWVB'

    74 .fi

    75 .in -2

    76 .sp

    77 

    78 .LP

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

    80 

    81 .RS +4

    82 .TP

    83 .ie t \(bu

    84 .el o

    85 The server's host name

    86 .RE

    87 .RS +4

    88 .TP

    89 .ie t \(bu

    90 .el o

    91 The server's stratum

    92 .RE

    93 .RS +4

    94 .TP

    95 .ie t \(bu

    96 .el o

    97 The time offset between that server and the local host (as measured by \fBntptrace\fR; this is why it is not always zero for  \fIlocalhost\fR)

    98 .RE

    99 .RS +4

   100 .TP

   101 .ie t \(bu

   102 .el o

   103 The host's synchronization distance

   104 .RE

   105 .RS +4

   106 .TP

   107 .ie t \(bu

   108 .el o

   109 The reference clock \fBID\fR (only for stratum-1 servers)

   110 .RE

   111 .LP

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

   113 .SH SEE ALSO

   114 .LP

   115 \fBntpq\fR(8), \fBntpd\fR(8), \fBntpdc\fR(8), \fBattributes\fR(7))

   116