ns_query(1M) ns_query(1M)
NAME
ns_query, nstest - domain name server test tools
SYNOPSIS
ns_query [-d ] host [ server ]
nstest [-d] [-i] [-p port] [-r] [-v ] [server] [log-file]
DESCRIPTION
ns_query and nstest are utilities used to perform simple
queries to a domain name server. ns_query queries for address
information about the specified host. nstest also generates
queries, but can generate queries for many different types of
information.
Files
ns_packet.dump nstest dump file
/etc/resolv.conf resolver configuration file
USAGE
ns_query
Normally queries are directed according to the contents of
/etc/resolv.conf [see resolver(3N)], or to the local name
server if /etc/resolv.conf does not exist. The optional
server argument causes ns_query to inquire of the specified
server instead. Note that the server is first looked up using
the default server(s).
If the -d option is specified, ns_query enables debugging in
the resolver(3N) library routines. Note that the library must
be compiled with debugging turned on in order for this to have
any effect.
nstest
nstest works only if the library has been compiled with
debugging turned on. Otherwise no output is produced.
nstest takes the following options:
-d dumps the received packet to a file called
ns_packet.dump in the current directory.
-i causes the resolver to ignore truncation errors.
-p port Causes queries to be sent to the specified port
instead of the default (53).
Copyright 1994 Novell, Inc. Page 1
ns_query(1M) ns_query(1M)
-r Disables recursive queries.
-v Forces the use of virtual circuit (TCP) connections
instead of datagram queries.
nstest normally queries the local server (INADDR_ANY).
Specifying a server argument causes queries to be sent to
server instead. Note that server must be specified as an
internet address in dotted-quad notation, for example,
128.212.75.67.
If log-file is specified, nstest writes a log of queries and
responses to the specified file.
Once started, nstest prompts for input and then performs the
specified query. To exit nstest, enter an end-of-file
character (ctrl-D).
The following list enumerates the query commands and the types
of information that can be retrieved using nstest:
ahost Retrieves address information associated with
host.
Aaddr Retrieves hostname information associated with
addr.
buser Retrieves mailbox information associated with
user.
Buser Retrieves mailgroup information associated with
user.
fhost Retrieves user-info information associated with
host.
ghost Retrieves group-id information associated with
host.
Ggroup-id Retrieves host information associated with group-
id.
hhost Retrieves host-info information associated with
host.
Copyright 1994 Novell, Inc. Page 2
ns_query(1M) ns_query(1M)
ihost Retrieves mailbox-info information associated with
host.
phost Retrieves pointer information associated with
host.
mhost Retrieves mail exchanger information associated
with host.
nhost Retrieves name-server information associated with
host.
rhost Retrieves mail-rename information associated with
host.
shost Retrieves start-of-authority information
associated with host.
Thost Retrieves textual information associated with
host.
uhost Retrieves user-id information associated with
host.
Uuser-id Retrieves host information associated with user-
id.
xhost performs a zone-transfer of all information
associated with host.
whost Retrieves well-known-service information
associated with host.
chost Retrieves cname (alias) information associated
with host.
*host Retrieves any available information associated
with host.
REFERENCES
hostname(5), named(1M), resolver(3N),
RFC974, RFC1034, RFC1035
Copyright 1994 Novell, Inc. Page 3