ntpq.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

ntpq(1M) ntpq(1M)

liseconds.

The character in the left margin indicates the fate of this peer in the clock selection process.

The codes have the following meaning:

<BLANK> Discarded due to high stratum and/or failed sanity checks.

x Designated falseticker by the intersection algorithm.

. Culled from the end of the candidate list.

- Discarded by the clustering algorithm.

+ Included in the ﬁnal selection set.

# Selected for synchronization but distance exceeds maximum.

* Selected for synchronization.

o selected for synchronization, PPS signal in use.

Note that since the

peers command depends on the ability to parse the values in the responses it gets, it

may fail to work from time to time with servers which poorly control the data formats. The contents of

the host ﬁeld may be one of four forms. It may be a host name, an IP address, a reference clock imple-

mentation name with its parameter or REFCLK(<implementation number >, <parameter >). On

host-

names no only IP-addresses will be displayed.

pstatus assocID

Sends a read status request to the server for the given association. The names and values of the

peer variables returned will be printed. Note that the status word from the header is displayed

preceding the variables, both in hexadecimal and in English.

readlist [ assocID ]

rl [ assocID ]

Requests that the values of the variables in the internal variable list be returned by the server. If

the association ID is omitted or is 0, the variables are assumed to be system variables. Otherwise

they are treated as peer variables. If the internal variable list is empty, a request is sent without

data, which should induce the remote server to return a default display.

readvar assocID variable_name

[ =value ][ ... ]]

rv assocID variable_name

[ =value ][ ... ]]

Requests that the values of the speciﬁed variables be returned by the server by sending a read vari-

ables request. If the association ID is omitted or is given as zero, the variables are system variables.

Otherwise they are peer variables and the values returned will be those of the corresponding peer.

Omitting the variable list will send a request with no data which should induce the server to return

a default display.

writevar assocID variable_name [ =value ][ ... ]]

Similar to the readvar command, except the speciﬁed variables are written instead of read.

writelist [ assocID ]

Similar to the readlist command, except the internal list variables are written instead of read.

WARNINGS

The

peers command is non-atomic and may occasionally result in spurious error messages about invalid

associations occurring and terminating the command. The timeout time is a ﬁxed constant, which means

a long wait for timeouts since it assumes a worst case.

FILES

/etc/ntp.keys Contains the encryption keys used for authentication.

AUTHOR

ntpq was developed by Dennis Ferguson at the University of Toronto.