NAME

ntpdc − monitor operation of ntp daemon

SYNOPSIS

ntpdc [ −n ] [ −v ] hosts... 

DESCRIPTION

ntpdc sends an INFO_QUERY packet to an ntp daemon running on the given hosts.  Each daemon responds with information about each of its peers, which ntpdc formats on the standard output. 

Normally, the name of the responding host and its peers are printed.  The −n switch disables this, printing only internet addresses. 

The default is a terse, table-style report.  The −v switch generates a verbose report. 

Terse Report

A typical terse report looks like this:

(rem)Address   (lcl)StratPollReachDelayOffsetDisp
====================================================================
-umd1128.8.10.14  1 64 266  3.0 -65.0    0.0
*DCN1.ARPA128.8.10.14  1256 332155.0  -4.0    0.0
128.8.251.92128.8.10.14  2 64 367-16.0 -61.0    0.0
idunno.Princeto128.8.10.14  3 64 252 60.0 -53.0    0.0
leo128.8.10.14  2 64 275  4.0-273.0 1536.2

Fields are interpreted as follows:

- or *:
The - mark indicates a pre-configured peer (mentioned in ntp.conf).  The * mark shows which pre-configured peer (if any) is currently being used for synchronization. 

(rem) Address:
The remote host name or internet address of a peer.

(lcl) Address:
The “local” host as specified as an argument to ntpdc.

Strat: The stratum level of the peer (as perceived by the local host). 

Poll: Current polling interval in seconds for this peer. 

Reach:
Octal value of a shift register indicating which responses were received from the previous eight polls to this peer (see RFC1119). 

Delay:
Round-trip delay in milliseconds for this peer as of the latest poll.

Offset:
The amount of time to adjust the local clock to bring it into correspondence with this peer.

Disp: Current value of dispersion (see RFC1119) in milliseconds for this peer. 

Verbose Reports

When the −v flag is given, a series of verbose reports are presented.  A typical one looks like this:

Neighbor address 128.4.0.6 port:123  local address 192.35.201.47
Reach: 0376 stratum: 1 poll int(HPI): 10 precision: -10
Sync distance: 0 disp: 0.014000 flags: 0 leap: 0
Reference clock ID: WWV  timestamp: a7c2832e.6f9d0000
Poll int(MPI): 10 threshold: 1024 timer: 1024 send: 266 received: 192 samples: 9
Delay(ms)  1144.00 1296.00 1118.00 1115.00 1225.00 1129.00 1086.00 1087.00
Offset(ms)   19.00   92.00  -17.00   12.00   41.00    4.00   -1.00  -14.00
 delay: 1086.000000 offset: -1.000000 dsp 0.014000

Fields are interpreted as follows:

Neighbor address...:
The address and port number of this neighbor, followed by the local address.

Reach: nn
Reachability in response to last eight polls (octal value of shift ­register).

stratum: n
Stratum level.

poll int(erval): time

precision: nn
The precision of this clock, given in seconds as a power of 2, e.g., a clock derived from the power line frequency (60 Hz) has a precision of 1/60 second (about 2^-6) and would be indicated by a precision of -6.

Sync distance: 0
Synchronizing distance.  Always zero in the current implementation.

disp: nn
Dispersion.

flags: nn

leap: flag
The leap second indicator.  Nonzero if there is to be a leap second added or subtracted at the new year.

Reference clock ID: [address]

timestamp: n

Poll int(erval): time

threshold: nn

timer: nn

send: nn
The number of ntp packets sent to this neighbor. 

received: nn
The number of ntp packets received from this neighbor. 

samples: nn

Delay and Offset:
The round trip delay and clock offset for the last eight ntp packet exchanges.  If there are fewer than eight valid samples, the delay field will be zero. 

delay: avg-delay offset: avg-offset dsp nnn (calculated value)
Average delay, offset, and dispersion calculated from the above samples.

SEE ALSO

ntp(1M), ntpd(1M). 
RFC1119 Network Time Protocol. 

WARNING

ntpdc(1M) will only work on INTERACTIVE UNIX System Version 2.3 or later. 

CREDITS

This facility was developed by the University of Maryland. 

\*U  —  Version 1.0