HP-UX Reference (11i v2 07/12) - 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 com-
mands 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 out-
put 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 con-
verting 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 charac-
ters of the full keyword to uniquely identify the command need be typed. The output of a command is nor-
mally 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: December 2007 Update − 1 − Hewlett-Packard Company 687