HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

x
xntpdc(1M) xntpdc(1M)
NAME
xntpdc - special NTP query program
SYNOPSIS
xntpdc [ -dilnps ][-c command ][host ][
... ]
DESCRIPTION
xntpdc is used to query the xntpd
daemon about its current state and to request changes in that state.
The program may be run either in interactive mode or controlled mode using command line arguments.
Extensive state and statistics information is available through the xntpdc interface. In addition, nearly
all the configuration options which can be specified at start up using
xntpd’s configuration file may also
be specified at run time using
xntpdc. If one or more request options is included on the command line
when
xntpdc is executed, each of the requests will be sent to the NTP servers running on each of the
hosts given as command line arguments, or on localhost by default. If no request options are given,
xntpdc will attempt to read commands from the standard input and execute these on the NTP server
running on the first host given on the command line, again defaulting to localhost when no other host is
specified. xntpdc will prompt for commands if the standard input is a terminal device.
xntpdc uses NTP mode 7 packets to communicate with the NTP server, and hence can be used to query
any compatible server on the network which permits it. Note that since NTP is a UDP protocol, this com-
munication will be somewhat unreliable, especially over large distances in terms of network topology.
xntpdc makes no attempt to retransmit requests, and will timeout requests if the remote host is not
heard from within a suitable timeout time.
The operation of
xntpdc is specific to the particular implementation of the
xntpd daemon and can be
expected to work only with this and maybe some previous versions of the daemon. Requests from a
remote
xntpdc program which affect the state of the local server must be authenticated, which requires
both the remote program and local server to share a common key and key identifier.
COMMAND LINE OPTIONS
Specifying a command line option other than
-i or -n will cause the specified query (or queries) to be
sent to the indicated host(s) immediately. Otherwise, xntpdc will attempt to read interactive format
commands from the standard input.
-c command The following command is interpreted as an interactive format command and is added to
the list of commands to be executed on the specified host(s). Multiple -c commands may
be given.
-d Debugging information is printed.
-i Force xntpdc to operate in interactive mode. Prompts will be written to the standard
output and commands read from the standard input.
-l Obtain a list of peers which are known to the server(s). This option is equivalent to
-c
listpeers
command. See "CONTROL MESSAGE COMMANDS" below.
-n Output all host addresses in dotted-quad numeric format (xxx.xxx.xxx.xxx) rather than
converting to the canonical host names.
-p Print a list of peers known to the server as well as a summary of their state. This is
equivalent to -c peers command. See "CONTROL MESSAGE COMMANDS" below.
-s Print a list of peers known to the server as well as a summary of their state, but in a
slightly different format than the -p command. This is equivalent to -c dmpeers com-
mand. See "CONTROL MESSAGE COMMANDS" below.
INTERACTIVE COMMANDS
Interactive format commands consist of a keyword followed by zero to four arguments. Only enough char-
acters of the full keyword to uniquely identify the command need be typed. The output of a command is
normally sent to the standard output. The output of individual commands may be redirected or sent to a
file by appending a
>, followed by a file name, to the command line.
A number of interactive format commands are executed entirely within the
xntpdc program itself and
do not result in NTP mode 7 requests being sent to a server. These commands are described as follows:
? [ command_keyword ]
HP-UX 11i Version 2: August 2003 − 1 − Hewlett-Packard Company Section 1M−−925