223 lines
6.9 KiB
Text
223 lines
6.9 KiB
Text
.\" Man page generated from reStructuredText.
|
|
.
|
|
.
|
|
.nr rst2man-indent-level 0
|
|
.
|
|
.de1 rstReportMargin
|
|
\\$1 \\n[an-margin]
|
|
level \\n[rst2man-indent-level]
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
-
|
|
\\n[rst2man-indent0]
|
|
\\n[rst2man-indent1]
|
|
\\n[rst2man-indent2]
|
|
..
|
|
.de1 INDENT
|
|
.\" .rstReportMargin pre:
|
|
. RS \\$1
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
. nr rst2man-indent-level +1
|
|
.\" .rstReportMargin post:
|
|
..
|
|
.de UNINDENT
|
|
. RE
|
|
.\" indent \\n[an-margin]
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.nr rst2man-indent-level -1
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
..
|
|
.TH "NSLOOKUP" "1" "@RELEASE_DATE@" "@PACKAGE_VERSION@" "BIND 9"
|
|
.SH NAME
|
|
nslookup \- query Internet name servers interactively
|
|
.SH SYNOPSIS
|
|
.sp
|
|
\fBnslookup\fP [\-option] [name | \-] [server]
|
|
.SH DESCRIPTION
|
|
.sp
|
|
\fBnslookup\fP is a program to query Internet domain name servers.
|
|
\fBnslookup\fP has two modes: interactive and non\-interactive. Interactive
|
|
mode allows the user to query name servers for information about various
|
|
hosts and domains or to print a list of hosts in a domain.
|
|
Non\-interactive mode prints just the name and requested
|
|
information for a host or domain.
|
|
.SH ARGUMENTS
|
|
.sp
|
|
Interactive mode is entered in the following cases:
|
|
.INDENT 0.0
|
|
.IP a. 3
|
|
when no arguments are given (the default name server is used);
|
|
.IP b. 3
|
|
when the first argument is a hyphen (\-) and the second argument is
|
|
the host name or Internet address of a name server.
|
|
.UNINDENT
|
|
.sp
|
|
Non\-interactive mode is used when the name or Internet address of the
|
|
host to be looked up is given as the first argument. The optional second
|
|
argument specifies the host name or address of a name server.
|
|
.sp
|
|
Options can also be specified on the command line if they precede the
|
|
arguments and are prefixed with a hyphen. For example, to change the
|
|
default query type to host information, with an initial timeout of 10
|
|
seconds, type:
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.EX
|
|
nslookup \-query=hinfo \-timeout=10
|
|
.EE
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.sp
|
|
The \fB\-version\fP option causes \fBnslookup\fP to print the version number
|
|
and immediately exit.
|
|
.SH INTERACTIVE COMMANDS
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \fBhost [server]\fP
|
|
This command looks up information for \fI\%host\fP using the current default server or
|
|
using \fBserver\fP, if specified. If \fI\%host\fP is an Internet address and the
|
|
query type is A or PTR, the name of the host is returned. If \fI\%host\fP is
|
|
a name and does not have a trailing period (\fB\&.\fP), the search list is used
|
|
to qualify the name.
|
|
.sp
|
|
To look up a host not in the current domain, append a period to the
|
|
name.
|
|
.TP
|
|
.B \fBserver domain\fP | \fBlserver domain\fP
|
|
These commands change the default server to \fBdomain\fP; \fBlserver\fP uses the initial
|
|
server to look up information about \fBdomain\fP, while \fBserver\fP uses the
|
|
current default server. If an authoritative answer cannot be found,
|
|
the names of servers that might have the answer are returned.
|
|
.TP
|
|
.B \fBroot\fP
|
|
This command is not implemented.
|
|
.TP
|
|
.B \fBfinger\fP
|
|
This command is not implemented.
|
|
.TP
|
|
.B \fBls\fP
|
|
This command is not implemented.
|
|
.TP
|
|
.B \fBview\fP
|
|
This command is not implemented.
|
|
.TP
|
|
.B \fBhelp\fP
|
|
This command is not implemented.
|
|
.TP
|
|
.B \fB?\fP
|
|
This command is not implemented.
|
|
.TP
|
|
.B \fBexit\fP
|
|
This command exits the program.
|
|
.TP
|
|
.B \fBset keyword[=value]\fP
|
|
This command is used to change state information that affects the
|
|
lookups. Valid keywords are:
|
|
.INDENT 7.0
|
|
.TP
|
|
.B \fBall\fP
|
|
This keyword prints the current values of the frequently used options to
|
|
\fBset\fP\&. Information about the current default server and host is
|
|
also printed.
|
|
.TP
|
|
.B \fBclass=value\fP
|
|
This keyword changes the query class to one of:
|
|
.INDENT 7.0
|
|
.TP
|
|
.B \fBIN\fP
|
|
the Internet class
|
|
.TP
|
|
.B \fBCH\fP
|
|
the Chaos class
|
|
.TP
|
|
.B \fBHS\fP
|
|
the Hesiod class
|
|
.TP
|
|
.B \fBANY\fP
|
|
wildcard
|
|
.UNINDENT
|
|
.sp
|
|
The class specifies the protocol group of the information. The default
|
|
is \fBIN\fP; the abbreviation for this keyword is \fBcl\fP\&.
|
|
.TP
|
|
.B \fBnodebug\fP
|
|
This keyword turns on or off the display of the full response packet, and any
|
|
intermediate response packets, when searching. The default for this keyword is
|
|
\fBnodebug\fP; the abbreviation for this keyword is \fB[no]deb\fP\&.
|
|
.TP
|
|
.B \fBnod2\fP
|
|
This keyword turns debugging mode on or off. This displays more about what
|
|
nslookup is doing. The default is \fBnod2\fP\&.
|
|
.TP
|
|
.B \fBdomain=name\fP
|
|
This keyword sets the search list to \fBname\fP\&.
|
|
.TP
|
|
.B \fBnosearch\fP
|
|
If the lookup request contains at least one period, but does not end
|
|
with a trailing period, this keyword appends the domain names in the domain
|
|
search list to the request until an answer is received. The default is \fBsearch\fP\&.
|
|
.TP
|
|
.B \fBport=value\fP
|
|
This keyword changes the default TCP/UDP name server port to \fBvalue\fP from
|
|
its default, port 53. The abbreviation for this keyword is \fBpo\fP\&.
|
|
.TP
|
|
.B \fBquerytype=value\fP | \fBtype=value\fP
|
|
This keyword changes the type of the information query to \fBvalue\fP\&. The
|
|
defaults are A and then AAAA; the abbreviations for these keywords are
|
|
\fBq\fP and \fBty\fP\&.
|
|
.sp
|
|
Please note that it is only possible to specify one query type. Only the default
|
|
behavior looks up both when an alternative is not specified.
|
|
.TP
|
|
.B \fBnorecurse\fP
|
|
This keyword tells the name server to query other servers if it does not have
|
|
the information. The default is \fBrecurse\fP; the abbreviation for this
|
|
keyword is \fB[no]rec\fP\&.
|
|
.TP
|
|
.B \fBndots=number\fP
|
|
This keyword sets the number of dots (label separators) in a domain that
|
|
disables searching. Absolute names always stop searching.
|
|
.TP
|
|
.B \fBretry=number\fP
|
|
This keyword sets the number of retries to \fBnumber\fP\&.
|
|
.TP
|
|
.B \fBtimeout=number\fP
|
|
This keyword changes the initial timeout interval to wait for a reply to
|
|
\fBnumber\fP, in seconds.
|
|
.TP
|
|
.B \fBnovc\fP
|
|
This keyword indicates that a virtual circuit should always be used when sending requests to the server.
|
|
\fBnovc\fP is the default.
|
|
.TP
|
|
.B \fBnofail\fP
|
|
This keyword tries the next nameserver if a nameserver responds with SERVFAIL or
|
|
a referral (nofail), or terminates the query (fail) on such a response. The
|
|
default is \fBnofail\fP\&.
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH RETURN VALUES
|
|
.sp
|
|
\fBnslookup\fP returns with an exit status of 1 if any query failed, and 0
|
|
otherwise.
|
|
.SH IDN SUPPORT
|
|
.sp
|
|
If \fBnslookup\fP has been built with IDN (internationalized domain name)
|
|
support, it can accept and display non\-ASCII domain names. \fBnslookup\fP
|
|
appropriately converts character encoding of a domain name before sending
|
|
a request to a DNS server or displaying a reply from the server.
|
|
To turn off IDN support, define the \fBIDN_DISABLE\fP
|
|
environment variable. IDN support is disabled if the variable is set
|
|
when \fBnslookup\fP runs, or when the standard output is not a tty.
|
|
.SH FILES
|
|
.sp
|
|
\fB/etc/resolv.conf\fP
|
|
.SH SEE ALSO
|
|
.sp
|
|
\fI\%dig(1)\fP, \fI\%host(1)\fP, \fI\%named(8)\fP\&.
|
|
.SH AUTHOR
|
|
Internet Systems Consortium
|
|
.SH COPYRIGHT
|
|
2025, Internet Systems Consortium
|
|
.\" Generated by docutils manpage writer.
|
|
.
|