ntpdc(1) CLIX ntpdc(1)
NAME
ntpdc - Monitors operation of an NTP daemon
SYNOPSIS
/usr/ip32/tcpip/ntpdc [-n] [-v] host ...
FLAGS
-n Disables displaying the name of the responding host and its peers;
displays only the Internet addresses. By default both the name and
Internet address are displayed.
-v Generates a verbose report. By default, ntpdc displays a terse,
table-style report.
DESCRIPTION
The ntpdc command is the Network Time Protocol (NTP) control client. The
client sends a query to the NTP daemon running on each of the specified
hosts. Each NTP daemon responds with information about its peers (all
other hosts that recognize NTP). The ntpdc client then formats and
displays the result on its stdout. A host can be specified by its name or
its Internet address.
If the Internet address of the peer is ``0.0.0.0'', then the remote host
itself has a reference clock (see ntpd(8)).
Terse Report
When the -v flag is not specified, ntpdc displays one line of information
for each peer known by each remote host. A typical terse report looks
like the following example:
(rem) Address (lcl) Strat Poll Reach Delay Offset Disp
=========================================================================
-umd1 128.8.10.14 1 64 266 3.0 -65.0 0.0
*DCN1.ARPA 128.8.10.14 1 256 332 155.0 -4.0 0.0
128.8.251.92 128.8.10.14 2 64 367 -16.0 -61.0 0.0
idunno.Princeton 128.8.10.14 3 64 252 60.0 -53.0 0.0
leo 128.8.10.14 2 64 275 4.0 -273.0 1536.2
In the previous report example, the dash (-) character indicates a pre-
configured peer (a host mentioned in the file /etc/ntp.conf). The
asterisk (*) character shows which pre-configured peer (if any) is
currently being used for synchronization.
The fields of the report are as follows:
(rem) The name or Internet address of this peer.
2/94 - Intergraph Corporation 1
ntpdc(1) CLIX ntpdc(1)
(lcl) The Internet address of the remote host as known by this peer.
Strat The stratum level of the peer (as perceived by the local host).
Poll Current polling interval (in seconds) between messages sent by
this peer.
Reach Octal value of a shift register indicating which responses were
received from the previous eight polls to this peer (see RFC-
1059).
Delay Round-trip delay in milliseconds for this peer as of the latest
poll. This value is taken from the sample that has the smallest
delay value.
Offset Clock offset in milliseconds for this peer as of the latest poll.
This value is taken from the sample that has the smallest delay
value.
Disp Current value of dispersion (see RFC-1059) in milliseconds for
this peer. This value is calculated as a weighted sum of the
clock offsets in the samples from the previous eight polls to
this peer.
Verbose Report
When the -v flag is specified, ntpdc displays a verbose report for each
peer known by each remote host. A typical verbose report looks like the
following example:
Neighbor address 128.4.0.6 port:123 local address 192.35.201.47
Reach: 0376 stratum: 1, precision: -10
dispersion: 0.014000, flags: 9101, leap: 0
Reference clock ID: WWV timestamp: a7c2832e.6f9d0000
hpoll: 6, ppoll:6, timer: 1024, sent: 266, received: 192
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
The fields of the verbose report are as follows:
Neighbor address address
The Internet address of this peer.
port:port
The port number of this peer.
local address local_address
The Internet address of the remote host as known by this peer.
2 Intergraph Corporation - 2/94
ntpdc(1) CLIX ntpdc(1)
Reach: nn
Octal value of a shift register indicating which responses were
received from the previous eight polls to this peer.
stratum: n
The stratum level of the peer (as perceived by the local host).
precision: exp
The precision of this clock, given in seconds as a power of 2. For
example, 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.
dispersion: disp
Dispersion estimate calculated as a weighted sum of the clock
offsets from the last eight NTP packets exchanged between the local
and remote hosts.
flags: nnnn
Internal flags noting certain characteristics of this peer, given
as a hexadecimal value.
leap: n
The leap second indicator. A value of 0 means there is no leap
second, 1 means a leap second is added to the last minute of the
current day, 2 means a leap second is subtracted from the last
minute of the current day, and 3 means the clock on the remote host
is unsynchronized.
Reference clock ID: source
The clock source, either the name of a reference standard (such as
WWV, WWVB, or GOES) or the Internet address of the clock that
synchronized this clock.
timestamp: hex-timestamp
The last time the server clock was adjusted, given as a 64-bit
hexadecimal, fixed-point value with a fraction point between bits
31 and 32.
hpoll: exp
The minimum polling interval between messages sent to the peer,
given in seconds as a power of two.
ppoll: exp
The minimum polling interval between messages sent by the peer,
given in seconds as a power of two. A value of 0 means the peer
has not received any NTP packets, and a value of -1 means the
remote host itself has a reference clock (see ntpd(8)).
timer: nn
The current polling interval between messages sent by the peer,
2/94 - Intergraph Corporation 3
ntpdc(1) CLIX ntpdc(1)
given in seconds.
sent: nn
The number of NTP packets sent to this peer.
received nn
The number of NTP packets received from this peer.
Delay(ms)
Offset(ms)
The round-trip delay and clock offset values (in milliseconds) from
the last eight NTP packet exchanges between the local and remote
hosts. If there are fewer than eight valid samples, the rest of
the fields are filled with zeros.
delay: avg-delay
offset: avg-offset
dsp: disp
Average delay, offset, and dispersion (in milliseconds) calculated
from the previous samples. The delay and clock offset values are
taken from the sample that had the smallest delay value. The
dispersion value is calculated as a weighted sum of the clock
offsets from the above samples.
EXAMPLES
1. To display the ntpdc report of node sam, enter:
ntpdc sam
2. To display only the Internet address (not the name sam) in the table-
style report, enter:
ntpdc -n sam
3. To generate a verbose report of the host sam, enter:
ntpdc -v sam
FILES
/etc/ntp.conf
NTP daemon.
/etc/services
Configuration file.
/etc/resolv.conf
4 Intergraph Corporation - 2/94
ntpdc(1) CLIX ntpdc(1)
Domain Name System (DNS) client configuration file. DNS is the
preferred method for address resolution.
/etc/hosts
Configuration file mapping hostnames to Internet addresses.
DIAGNOSTICS
A usage message is displayed if an unknown flag is specified on the
command line.
udp/ntp: service unknown, using default 123
This message does not indicate the ntpdc client failed, however, it
does indicate the /etc/services file on your system needs to be
updated.
Timed out waiting for replies
The host that was queried is not responding to the request.
Other error messages are related to errors in functions and are displayed
with the perror() function.
EXIT VALUES
The ntpdc command exits with a value of 0 if successful. If unsuccessful,
it exits with a nonzero value.
RELATED INFORMATION
Commands: ntp(1), ntpd(8)
Functions: perror(3)
Mills, David L., Network Time Protocol (Version 1), RFC-1059
2/94 - Intergraph Corporation 5