HP-UX Reference (11i v2 04/09) - 1 User Commands N-Z (vol 2)

r
rndc(1) rndc(1)
NAME
rndc - name server control utility
SYNOPSIS
rndc [-c config-file][
-k keyname][-m][-p port#][-s server ][
-V][-y key_id] command [com-
mand...]
DESCRIPTION
This command allows the system administrator to control the operation of a name server. If
rndc is
invoked without any command line options or arguments, it prints a short summary of the supported
commands and the available options and their arguments.
rndc communicates with the name server over a TCP connection, sending commands authenticated with
digital signatures. In the current versions of rndc
, the only supported encryption algorithm is HMAC-
MD5, which uses a shared secret on each end of the connection. This provides TSIG-style authentication
for the command request and the name server’s response. All commands sent over the channel must be
signed by a key_id known to the server.
rndc reads its default configuration file,
/etc/rndc.conf to determine how to contact the name
server and decide what algorithm and keys it should use.
Options
-c config-file This option can be used to specify an alternate configuration file. The default
configuration file is /etc/rndc.conf
.
-k keyname This option can be used to specify the keyname of the rndc authentication key.
This must be a valid domain name. Default is rndc-key.
-m Provides debugging information to the developers.
-p port# This option specifies that rndc should send commands to TCP port number port#
on the system running the name server instead of BIND 9.1.3’s default control
channel port, 953.
-s server This option is used to specify the server on which this command is run. server is the
name or address of the server which matches a
server statement in the
configuration file for rndc.Ifnoserver is supplied on the command line, the host
named by the default-server clause in the
options statement of the configuration
file,
rndc.conf will be used.
-V Provides debugging information and is primarily of interest only to the BIND 9
developers.
-y key_id This option identifies the key_id to use from the configuration file. key_id must be
known to
named with the same algorithm and secret string for control message
validation to succeed. If the -y option is not specified, rndc will first look for a key
clause in the server statement of
rndc.conf file. If no server statement is
present for that host, then the default-key clause of the options statement of the
configuration file, rndc.conf will be used.
command command is one of the following:
reload Reload configuration file and zones.
reload zone Reload the given zone.
refresh zone Schedule zone maintenance for the given zone.
stats Write server statistics to the statistics file as specified by the
statistics-file directive of the options statement in the
named.conf configuration file. If the statistics-file
directive is not specified, the statistics is dumped to the
named.stats file in the directory specified by the directory
directive of the options statement in the named.conf
configuration file.
querylog Toggle query logging.
dumpdb Dump the current contents of the cache into the file specified by the
dump-file directive of the options statement in the
HP-UX 11i Version 2: September 2004 − 1 − Hewlett-Packard Company Section 1−−807