Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Drop trailing whitespace.

This commit is contained in:
wiz 2004-05-20 00:26:19 +00:00
parent 199212f421
commit 810322e03d
2 changed files with 248 additions and 248 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

158
usr.sbin/bind/named/named.conf.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: named.conf.5,v 1.1.1.1 2004/05/18 00:06:57 christos Exp $ .\" $NetBSD: named.conf.5,v 1.2 2004/05/20 00:26:19 wiz Exp $
.\" .\"
.\" Copyright (c) 1999-2000 by Internet Software Consortium .\" Copyright (c) 1999-2000 by Internet Software Consortium
.\" .\"
@ -629,7 +629,7 @@ the following:
file \&"my_security_file\&"; file \&"my_security_file\&";
severity info; severity info;
}; };
category security { my_security_channel; category security { my_security_channel;
default_syslog; default_debug; }; default_syslog; default_debug; };
.Ed .Ed
.Pp .Pp
@ -781,22 +781,22 @@ and a warning will be generated. If there is no options statement,
an options block with each option set to its default will be used. an options block with each option set to its default will be used.
.Ss Server Information .Ss Server Information
.Bl -tag -width 0n .Bl -tag -width 0n
.It Ic hostname .It Ic hostname
This defaults to the hostname of the machine hosting the nameserver as found by gethostname(). This defaults to the hostname of the machine hosting the nameserver as found by gethostname().
Its prime purpose is to be able to identify which of a number of anycast Its prime purpose is to be able to identify which of a number of anycast
servers is actually answering your queries by sending a txt query for servers is actually answering your queries by sending a txt query for
.Pa hostname.bind .Pa hostname.bind
in class chaos to the anycast server and getting back a unique name. in class chaos to the anycast server and getting back a unique name.
Setting Setting
the hostname to a empty string ("") will disable processing of the queries. the hostname to a empty string ("") will disable processing of the queries.
.It Ic version .It Ic version
The version the server should report via the ndc command or via a query of The version the server should report via the ndc command or via a query of
name name
.Pa version.bind .Pa version.bind
in class chaos. in class chaos.
The default is the real version number of the server, The default is the real version number of the server,
but some server operators prefer the string ( but some server operators prefer the string (
.Ic surely you must be joking .Ic surely you must be joking
). ).
.El .El
.Ss Pathnames .Ss Pathnames
@ -816,14 +816,14 @@ server was started. The directory specified should be an absolute path.
The pathname to the named-xfer program that the server uses for The pathname to the named-xfer program that the server uses for
inbound zone transfers. If not specified, the default is inbound zone transfers. If not specified, the default is
system dependent (e.g. system dependent (e.g.
.Pa /usr/sbin/named-xfer .Pa /usr/sbin/named-xfer
). ).
.It Ic dump-file .It Ic dump-file
The pathname of the file the server dumps the database to when it The pathname of the file the server dumps the database to when it
receives receives
.Dv SIGINT .Dv SIGINT
signal (as sent by signal (as sent by
.Ic ndc dumpdb .Ic ndc dumpdb
). If not specified, the default is ). If not specified, the default is
.Pa named_dump.db . .Pa named_dump.db .
.It Ic memstatistics-file .It Ic memstatistics-file
@ -864,7 +864,7 @@ bit is always set on
responses, even if the server is not actually authoritative. responses, even if the server is not actually authoritative.
The default is The default is
.Li no . .Li no .
Turning Turning
.Lc auth-nxdomain .Lc auth-nxdomain
will allow older clients that require will allow older clients that require
.Li AA .Li AA
@ -944,20 +944,20 @@ becoming corrupted (at the cost of requiring more work from the client).
.It Ic has-old-clients .It Ic has-old-clients
Setting the option to Setting the option to
.Li yes , .Li yes ,
is equivalent to setting the following three options: is equivalent to setting the following three options:
.Ic auth-nxdomain yes ; , .Ic auth-nxdomain yes ; ,
.Ic maintain-ixfr-base yes ; , .Ic maintain-ixfr-base yes ; ,
and and
.Ic rfc2308-type1 no ; .Ic rfc2308-type1 no ;
.Pp .Pp
The use of The use of
.Ic has-old-clients .Ic has-old-clients
with with
.Ic auth-nxdomain , .Ic auth-nxdomain ,
.Ic maintain-ixfr-base , .Ic maintain-ixfr-base ,
and and
.Ic rfc2308-type1 .Ic rfc2308-type1
is order dependent. is order dependent.
.It Ic host-statistics .It Ic host-statistics
If If
.Li yes , .Li yes ,
@ -994,8 +994,8 @@ zone the server is authoritative for changes. The use of NOTIFY
speeds convergence between the master and its slaves. Slave servers speeds convergence between the master and its slaves. Slave servers
that receive a NOTIFY message and understand it will contact the that receive a NOTIFY message and understand it will contact the
master server for the zone and see if they need to do a zone transfer, and master server for the zone and see if they need to do a zone transfer, and
if they do, they will initiate it immediately. if they do, they will initiate it immediately.
If If
.Li explicit , .Li explicit ,
the DNS NOTIFY messages will only be sent to the addresses in the the DNS NOTIFY messages will only be sent to the addresses in the
.Ic also-notify .Ic also-notify
@ -1011,7 +1011,7 @@ statement.
If If
.Li yes , .Li yes ,
suppress the initial notify messages when the server first loads. suppress the initial notify messages when the server first loads.
The default is The default is
.Li no . .Li no .
.It Ic recursion .It Ic recursion
If If
@ -1026,48 +1026,48 @@ See also
above. above.
.It Ic rfc2308-type1 .It Ic rfc2308-type1
If If
.Li yes, .Li yes,
the server will send NS records along with the SOA record for negative the server will send NS records along with the SOA record for negative
answers. You need to set this to no if you have an old BIND server using answers. You need to set this to no if you have an old BIND server using
you as a forwarder that does not understand negative answers which contain you as a forwarder that does not understand negative answers which contain
both SOA and NS records or you have an old version of sendmail. The correct both SOA and NS records or you have an old version of sendmail. The correct
fix is to upgrade the broken server or sendmail. The default is fix is to upgrade the broken server or sendmail. The default is
.Li no . .Li no .
.It Ic use-id-pool .It Ic use-id-pool
If If
.Li yes, .Li yes,
the server will keep track of its own outstanding query ID's to avoid duplication the server will keep track of its own outstanding query ID's to avoid duplication
and increase randomness. This will result in 128KB more memory being consumed and increase randomness. This will result in 128KB more memory being consumed
by the server. The default is by the server. The default is
.Li no . .Li no .
.It Ic treat-cr-as-space .It Ic treat-cr-as-space
If If
.Li yes, .Li yes,
the server will treat CR characters the same way it treats a space the server will treat CR characters the same way it treats a space
or tab. This may be necessary when loading zone files on a UNIX system or tab. This may be necessary when loading zone files on a UNIX system
that were generated on an NT or DOS machine. The default is that were generated on an NT or DOS machine. The default is
.Li no . .Li no .
.El .El
.Ss Also-Notify .Ss Also-Notify
.Ic also-notify .Ic also-notify
.Pp .Pp
Defines a global list of IP addresses that also get sent NOTIFY messages Defines a global list of IP addresses that also get sent NOTIFY messages
whenever a fresh copy of the zone is loaded. This helps to ensure that copies of whenever a fresh copy of the zone is loaded. This helps to ensure that copies of
the zones will quickly converge on ``stealth'' servers. If an the zones will quickly converge on ``stealth'' servers. If an
.Ic also-notify
list is given in a
.Ic zone
statement, it will override the
.Ic options also-notify
statement. When a
.Ic zone notify
statement is set to
.Ic no ,
the IP addresses in
the global
.Ic also-notify .Ic also-notify
list will not get sent NOTIFY messages for that zone. list is given in a
The default is the empty list (no global notification list). .Ic zone
statement, it will override the
.Ic options also-notify
statement. When a
.Ic zone notify
statement is set to
.Ic no ,
the IP addresses in
the global
.Ic also-notify
list will not get sent NOTIFY messages for that zone.
The default is the empty list (no global notification list).
.Ss Forwarding .Ss Forwarding
The forwarding facility can be used to create a large site-wide The forwarding facility can be used to create a large site-wide
cache on a few servers, reducing traffic over links to external cache on a few servers, reducing traffic over links to external
@ -1164,7 +1164,7 @@ from all hosts.
.Bl -tag -width 0n .Bl -tag -width 0n
.It Ic allow-recursion .It Ic allow-recursion
Specifies which hosts are allowed to ask recursive questions. Specifies which hosts are allowed to ask recursive questions.
If not specified, the default is to allow recursive queries If not specified, the default is to allow recursive queries
from all hosts. from all hosts.
.It Ic allow-transfer .It Ic allow-transfer
Specifies which hosts are allowed to receive zone transfers from the Specifies which hosts are allowed to receive zone transfers from the
@ -1284,7 +1284,7 @@ statement.
.Nm transfer-source .Nm transfer-source
determines which local address will be bound to the TCP connection used to fetch all zones determines which local address will be bound to the TCP connection used to fetch all zones
transferred inbound by the server. If not set, it defaults to a system controlled value which will usually be the address of the interface ``closest to`` the remote end. This transferred inbound by the server. If not set, it defaults to a system controlled value which will usually be the address of the interface ``closest to`` the remote end. This
address must appear in the remote end's address must appear in the remote end's
.Nm allow-transfer .Nm allow-transfer
option for the zones being transferred, if one is specified. This statement sets the option for the zones being transferred, if one is specified. This statement sets the
.Nm transfer-source .Nm transfer-source
@ -1348,7 +1348,7 @@ actual kernel limit is larger than this value, use
to specify the limit explicitly. to specify the limit explicitly.
.It Ic max-ixfr-log-size .It Ic max-ixfr-log-size
The The
.Li max-ixfr-log-size .Li max-ixfr-log-size
will be used in a future release of the server to limit the size of the transaction will be used in a future release of the server to limit the size of the transaction
log kept for Incremental Zone Transfer. log kept for Incremental Zone Transfer.
.It Ic stacksize .It Ic stacksize
@ -1420,23 +1420,23 @@ As the order of RRs is not defined, this should not cause any problems.
.Pp .Pp
The client resolver code should re-arrange the RRs as appropriate, i.e. using The client resolver code should re-arrange the RRs as appropriate, i.e. using
any addresses on the local net in preference to other addresses. However, not all any addresses on the local net in preference to other addresses. However, not all
resolvers can do this, or are not correctly configured. resolvers can do this, or are not correctly configured.
.Pp .Pp
When a client is using a local server, the sorting can be performed in the server, When a client is using a local server, the sorting can be performed in the server,
based on the client's address. This only requires configuring the nameservers, based on the client's address. This only requires configuring the nameservers,
not all the clients. not all the clients.
.Pp .Pp
The The
.Ic sortlist .Ic sortlist
statement takes an address match list and interprets it even more statement takes an address match list and interprets it even more
specially than the specially than the
.Ic topology .Ic topology
statement does. statement does.
.Pp .Pp
Each top level statement in the sortlist must itself be an explicit address match Each top level statement in the sortlist must itself be an explicit address match
list with one or two elements. The first element (which may be an IP address, list with one or two elements. The first element (which may be an IP address,
an IP prefix, an ACL name or nested address match list) of each top level list is an IP prefix, an ACL name or nested address match list) of each top level list is
checked against the source address of the query until a match is found. checked against the source address of the query until a match is found.
.Pp .Pp
Once the source address of the query has been matched, if the top level Once the source address of the query has been matched, if the top level
statement contains only one element, the actual primitive element that statement contains only one element, the actual primitive element that
@ -1454,7 +1454,7 @@ preference shown between these two networks. Queries received from a host on
the 192.168.1/24 network will prefer other addresses on that network to the the 192.168.1/24 network will prefer other addresses on that network to the
192.168.2/24 and 192.168.3/24 networks. Queries received from a host on the 192.168.2/24 and 192.168.3/24 networks. Queries received from a host on the
192.168.4/24 or the 192.168.5/24 network will only prefer other addresses on 192.168.4/24 or the 192.168.5/24 network will only prefer other addresses on
their directly connected networks. their directly connected networks.
.Bd -literal .Bd -literal
sortlist { sortlist {
{ localhost; // IF the local host { localhost; // IF the local host
@ -1494,26 +1494,26 @@ a zone might be configured to always be returned in the order they are defined
in the zone file. Or perhaps a random shuffle of the records as they are in the zone file. Or perhaps a random shuffle of the records as they are
returned is wanted. The rrset-order statement permits configuration of the returned is wanted. The rrset-order statement permits configuration of the
ordering made of the records in a multiple record response. The default, if no ordering made of the records in a multiple record response. The default, if no
ordering is defined, is a cyclic ordering (round robin). ordering is defined, is a cyclic ordering (round robin).
.Pp .Pp
An An
.Ic order_spec .Ic order_spec
is defined as follows: is defined as follows:
.Bd -literal .Bd -literal
[ \fIclass class_name\fR ][ \fItype type_name\fR ][ \fIname\fR "FQDN" ] \fIorder\fR ordering [ \fIclass class_name\fR ][ \fItype type_name\fR ][ \fIname\fR "FQDN" ] \fIorder\fR ordering
.Ed .Ed
.Pp .Pp
If no class is specified, the default is If no class is specified, the default is
.Ic ANY . .Ic ANY .
If no If no
.Li Ictype .Li Ictype
is specified, the default is is specified, the default is
.Ic ANY . .Ic ANY .
If no name is specified, the default is "*". If no name is specified, the default is "*".
.Pp .Pp
The legal values for The legal values for
.Ic ordering .Ic ordering
are: are:
.Bl -tag -width indent .Bl -tag -width indent
.It Ic fixed .It Ic fixed
Records are returned in the order they are defined in the zone file. Records are returned in the order they are defined in the zone file.
@ -1523,7 +1523,7 @@ Records are returned in some random order.
Records are returned in a round-robin order. Records are returned in a round-robin order.
.El .El
.Pp .Pp
For example: For example:
.Bd -literal .Bd -literal
rrset-order { rrset-order {
class IN type A name "rc.vix.com" order random; class IN type A name "rc.vix.com" order random;
@ -1533,20 +1533,20 @@ For example:
.Pp .Pp
will cause any responses for type A records in class IN that have "rc.vix.com" as will cause any responses for type A records in class IN that have "rc.vix.com" as
a suffix, to always be returned in random order. All other records are returned a suffix, to always be returned in random order. All other records are returned
in cyclic order. in cyclic order.
.Pp .Pp
If multiple If multiple
.Ic rrset-order .Ic rrset-order
statements appear, they are not combined--the last one applies. statements appear, they are not combined--the last one applies.
.Pp .Pp
If no If no
.Ic rrset-order .Ic rrset-order
statement is specified, a default one of: statement is specified, a default one of:
.Bd -literal .Bd -literal
rrset-order { class ANY type ANY name "*" order cyclic ; }; rrset-order { class ANY type ANY name "*" order cyclic ; };
.Ed .Ed
.Pp .Pp
is used. is used.
.Ss Glue Ordering .Ss Glue Ordering
When running a root nameserver it is sometimes necessary to ensure that other When running a root nameserver it is sometimes necessary to ensure that other
nameservers that are priming are successful. nameservers that are priming are successful.
@ -1554,7 +1554,7 @@ This requires that glue A records for at least of the nameservers are returned
in the answer to a priming query. in the answer to a priming query.
This can be achieved by setting This can be achieved by setting
.Ic preferred-glue A; .Ic preferred-glue A;
which will add A records before other types in the additional section. which will add A records before other types in the additional section.
.Ss EDNS .Ss EDNS
Some firewalls fail to pass EDNS/UDP messages that are larger than Some firewalls fail to pass EDNS/UDP messages that are larger than
certain size, 512 or the UDP reassembly buffer. certain size, 512 or the UDP reassembly buffer.
@ -1928,10 +1928,10 @@ associated with a remote name server.
If you discover that a server does not support EDNS you can prevent If you discover that a server does not support EDNS you can prevent
named making EDNS queries to it by specifying named making EDNS queries to it by specifying
.Ic edns .Ic edns
.Ic no; . .Ic no; .
The default value of The default value of
.Ic edns .Ic edns
is is
.Ic yes . .Ic yes .
.Pp .Pp
If you discover that a server is giving out bad data, marking it as If you discover that a server is giving out bad data, marking it as
@ -1976,7 +1976,7 @@ checked for syntax but is otherwise ignored.
.Pp .Pp
The The
.Ic keys .Ic keys
clause is used to identify a clause is used to identify a
.Va key_id .Va key_id
defined by the defined by the
.Ic key .Ic key

338
usr.sbin/bind/nslookup/nslookup.8
View File

@ -1,11 +1,11 @@
.\" $NetBSD: nslookup.8,v 1.1.1.1 2004/05/18 00:06:58 christos Exp $ .\" $NetBSD: nslookup.8,v 1.2 2004/05/20 00:26:44 wiz Exp $
.\" .\"
.\" .\"
.\" ++Copyright++ 1985, 1989 .\" ++Copyright++ 1985, 1989
.\" - .\" -
.\" Copyright (c) 1985, 1989 .\" Copyright (c) 1985, 1989
.\" The Regents of the University of California. All rights reserved. .\" The Regents of the University of California. All rights reserved.
.\" .\"
.\" Redistribution and use in source and binary forms, with or without .\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions .\" modification, are permitted provided that the following conditions
.\" are met: .\" are met:
@ -17,7 +17,7 @@
.\" 3. Neither the name of the University nor the names of its contributors .\" 3. Neither the name of the University nor the names of its contributors
.\" may be used to endorse or promote products derived from this software .\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission. .\" without specific prior written permission.
.\" .\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@ -31,14 +31,14 @@
.\" SUCH DAMAGE. .\" SUCH DAMAGE.
.\" - .\" -
.\" Portions Copyright (c) 1993 by Digital Equipment Corporation. .\" Portions Copyright (c) 1993 by Digital Equipment Corporation.
.\" .\"
.\" Permission to use, copy, modify, and distribute this software for any .\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above .\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies, and that .\" copyright notice and this permission notice appear in all copies, and that
.\" the name of Digital Equipment Corporation not be used in advertising or .\" the name of Digital Equipment Corporation not be used in advertising or
.\" publicity pertaining to distribution of the document or software without .\" publicity pertaining to distribution of the document or software without
.\" specific, written prior permission. .\" specific, written prior permission.
.\" .\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL .\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL
.\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES .\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT .\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT
@ -56,7 +56,7 @@
.Dt NSLOOKUP 8 .Dt NSLOOKUP 8
.Os .Os
.Sh NAME .Sh NAME
.Nm nslookup .Nm nslookup
.Nd query Internet name servers interactively .Nd query Internet name servers interactively
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm nslookup .Nm nslookup
@ -64,17 +64,17 @@
.Op Ar host-to-find | Fl Op Ar server .Op Ar host-to-find | Fl Op Ar server
.Sh DESCRIPTION .Sh DESCRIPTION
.Ic Nslookup .Ic Nslookup
is a program to query Internet domain name servers. is a program to query Internet domain name servers.
.Ic Nslookup .Ic Nslookup
has two modes: interactive and non-interactive. has two modes: interactive and non-interactive.
Interactive mode allows the user to query name servers for Interactive mode allows the user to query name servers for
information about various hosts and domains or to print a list of hosts information about various hosts and domains or to print a list of hosts
in a domain. in a domain.
Non-interactive mode is used to print just the name and requested information Non-interactive mode is used to print just the name and requested information
for a host or domain. for a host or domain.
.Sh ARGUMENTS .Sh ARGUMENTS
Interactive mode is entered in the following cases: Interactive mode is entered in the following cases:
.Bl -tag -width "a) " .Bl -tag -width "a) "
.It a) .It a)
when no arguments are given (the default name server will be used), when no arguments are given (the default name server will be used),
.It b) .It b)
@ -82,17 +82,17 @@ when the first argument is a hyphen (-) and the second argument
is the host name or Internet address of a name server. is the host name or Internet address of a name server.
.El .El
.Pp .Pp
Non-interactive mode is used when the name or Internet address Non-interactive mode is used when the name or Internet address
of the host to be looked up of the host to be looked up
is given as the first argument. The optional second argument specifies is given as the first argument. The optional second argument specifies
the host name or address of a name server. the host name or address of a name server.
.Pp .Pp
The options listed under the The options listed under the
.Dq Li set .Dq Li set
command below can be specified in command below can be specified in
the the
.Pa .nslookuprc .Pa .nslookuprc
file in the user's home directory if they are listed file in the user's home directory if they are listed
one per line. Options can also be specified one per line. Options can also be specified
on the command line if they precede the arguments and are prefixed with 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, a hyphen. For example, to change the default query type to host information,
@ -102,123 +102,123 @@ and the initial timeout to 10 seconds, type:
.Ed .Ed
.Sh INTERACTIVE COMMANDS .Sh INTERACTIVE COMMANDS
Commands may be interrupted at any time by typing a control-C. Commands may be interrupted at any time by typing a control-C.
To exit, type a control-D To exit, type a control-D
.Pq Dv EOF .Pq Dv EOF
or type or type
.Li exit . .Li exit .
The command line length must be less than 256 characters. The command line length must be less than 256 characters.
To treat a built-in command as a host name, To treat a built-in command as a host name,
precede it with an escape character precede it with an escape character
.Pq Sq \e . .Pq Sq \e .
.Sy N.B.: An unrecognized command will be interpreted as a host name. .Sy N.B.: An unrecognized command will be interpreted as a host name.
.Bl -tag -width "lserver" .Bl -tag -width "lserver"
.It Ar host Op Ar server .It Ar host Op Ar server
Look up information for Look up information for
.Ar host .Ar host
using the current default server or using using the current default server or using
.Ar server , .Ar server ,
if specified. if specified.
If If
.Ar host .Ar host
is an Internet address and the query type is is an Internet address and the query type is
.Dv A .Dv A
or or
.Dv PTR , .Dv PTR ,
the name of the host is returned. the name of the host is returned.
If If
.Ar host .Ar host
is a name and does not have a trailing period, the default is a name and does not have a trailing period, the default
domain name is appended to the name. (This behavior depends on the state of the domain name is appended to the name. (This behavior depends on the state of the
.Ic set .Ic set
options options
.Ic domain , srchlist , defname , .Ic domain , srchlist , defname ,
and and
.Ic search . ) .Ic search . )
.Pp .Pp
To look up a host not in the current domain, append a period to To look up a host not in the current domain, append a period to
the name. the name.
.It Ic server Ar domain .It Ic server Ar domain
.It Ic lserver Ar domain .It Ic lserver Ar domain
Change the default server to Change the default server to
.Ar domain ; .Ar domain ;
.Ic lserver .Ic lserver
uses the initial server to look up information about uses the initial server to look up information about
.Ar domain , .Ar domain ,
while while
.Ic server .Ic server
uses the current default server. uses the current default server.
If an authoritative answer can't be found, the names of servers If an authoritative answer can't be found, the names of servers
that might have the answer are returned. that might have the answer are returned.
.It Ic root .It Ic root
Changes the default server to the server for the root of the domain name space. Changes the default server to the server for the root of the domain name space.
Currently, the host Currently, the host
.Li ns.internic.net .Li ns.internic.net
is used. is used.
(This command is a synonym for (This command is a synonym for
.Dq Ic lserver ns.internic.net . ) .Dq Ic lserver ns.internic.net . )
The name of the root server can be changed with the The name of the root server can be changed with the
.Dq Ic set root .Dq Ic set root
command. command.
.It Xo Ic finger Op Ar name .It Xo Ic finger Op Ar name
.Op Ic > Ar filename .Op Ic > Ar filename
.Xc .Xc
.It Xo Ic finger Op Ar name .It Xo Ic finger Op Ar name
.Op Ic >> Ar filename .Op Ic >> Ar filename
.Xc .Xc
Connects with the finger server on the current host. Connects with the finger server on the current host.
The current host is defined when a previous lookup for a host The current host is defined when a previous lookup for a host
was successful and returned address information (see the was successful and returned address information (see the
.Dq Ic set querytype Ns = Ns Dv A .Dq Ic set querytype Ns = Ns Dv A
command). command).
The The
.Ar name .Ar name
is optional. is optional.
.Ic > .Ic >
and and
.Ic >> .Ic >>
can be used to redirect output in the usual manner. can be used to redirect output in the usual manner.
.It Xo Ic ls Op Ar option .It Xo Ic ls Op Ar option
.Ar domain Op Ic > Ar filename .Ar domain Op Ic > Ar filename
.Xc .Xc
.It Xo Ic ls Op Ar option .It Xo Ic ls Op Ar option
.Ar domain Op Ic >> Ar filename .Ar domain Op Ic >> Ar filename
.Xc .Xc
List the information available for List the information available for
.Ar domain , .Ar domain ,
optionally creating or appending to optionally creating or appending to
.Ar filename . .Ar filename .
The default output contains host names and their Internet addresses. The default output contains host names and their Internet addresses.
.Ar Option .Ar Option
can be one of the following: can be one of the following:
.Bl -tag -width "-a " .Bl -tag -width "-a "
.It Fl t Ar querytype .It Fl t Ar querytype
lists all records of the specified type (see lists all records of the specified type (see
.Ar querytype .Ar querytype
below). below).
.It Fl a .It Fl a
lists aliases of hosts in the domain; lists aliases of hosts in the domain;
synonym for synonym for
.Dq Fl t Dv CNAME . .Dq Fl t Dv CNAME .
.It Fl d .It Fl d
lists all records for the domain; lists all records for the domain;
synonym for synonym for
.Dq Fl t Dv ANY . .Dq Fl t Dv ANY .
.It Fl h .It Fl h
lists CPU and operating system information for the domain; lists CPU and operating system information for the domain;
synonym for synonym for
.Dq Fl t Dv HINFO . .Dq Fl t Dv HINFO .
.It Fl s .It Fl s
lists well-known services of hosts in the domain; lists well-known services of hosts in the domain;
synonym for synonym for
.Dq Fl t Dv WKS . .Dq Fl t Dv WKS .
.El .El
.Pp .Pp
When output is directed to a file, hash marks are printed for every When output is directed to a file, hash marks are printed for every
50 records received from the server. 50 records received from the server.
.It Ic view Ar filename .It Ic view Ar filename
Sorts and lists the output of previous Sorts and lists the output of previous
.Ic ls .Ic ls
command(s) with command(s) with
.Xr more 1 . .Xr more 1 .
.It Ic help .It Ic help
.It Ic ?\& .It Ic ?\&
@ -233,7 +233,7 @@ This command is used to change state information that affects the lookups.
Valid keywords are: Valid keywords are:
.Bl -tag -width "class=v" .Bl -tag -width "class=v"
.It Ic all .It Ic all
Prints the current values of the frequently-used options to Prints the current values of the frequently-used options to
.Ic set . .Ic set .
Information about the current default server and host is also printed. Information about the current default server and host is also printed.
.It Ic class Ns = Ns Ar value .It Ic class Ns = Ns Ar value
@ -251,9 +251,9 @@ wildcard (any of the above)
.Pp .Pp
The class specifies the protocol group of the information. The class specifies the protocol group of the information.
.Pp .Pp
(Default = (Default =
.Dv IN ; .Dv IN ;
abbreviation = abbreviation =
.Ic cl ) .Ic cl )
.It Xo .It Xo
.Oo Ic no Oc Ns Ic debug .Oo Ic no Oc Ns Ic debug
@ -261,9 +261,9 @@ abbreviation =
Turn debugging mode on. A lot more information is printed about the Turn debugging mode on. A lot more information is printed about the
packet sent to the server and the resulting answer. packet sent to the server and the resulting answer.
.Pp .Pp
(Default = (Default =
.Ic nodebug ; .Ic nodebug ;
abbreviation = abbreviation =
.Oo Ic no Oc Ns Ic deb ) .Oo Ic no Oc Ns Ic deb )
.It Xo .It Xo
.Oo Ic no Oc Ns Ic d2 .Oo Ic no Oc Ns Ic d2
@ -271,34 +271,34 @@ abbreviation =
Turn exhaustive debugging mode on. Turn exhaustive debugging mode on.
Essentially all fields of every packet are printed. Essentially all fields of every packet are printed.
.Pp .Pp
(Default = (Default =
.Ic nod2 ) .Ic nod2 )
.It Ic domain Ns = Ns Ar name .It Ic domain Ns = Ns Ar name
Change the default domain name to Change the default domain name to
.Ar name . .Ar name .
The default domain name is appended to a lookup request depending on the The default domain name is appended to a lookup request depending on the
state of the state of the
.Ic defname .Ic defname
and and
.Ic search .Ic search
options. options.
The domain search list contains the parents of the default domain if it has The domain search list contains the parents of the default domain if it has
at least two components in its name. at least two components in its name.
For example, if the default domain For example, if the default domain
is CC.Berkeley.EDU, the search list is CC.Berkeley.EDU and Berkeley.EDU. is CC.Berkeley.EDU, the search list is CC.Berkeley.EDU and Berkeley.EDU.
Use the Use the
.Dq Ic set srchlist .Dq Ic set srchlist
command to specify a different list. command to specify a different list.
Use the Use the
.Dq Ic set all .Dq Ic set all
command to display the list. command to display the list.
.Pp .Pp
(Default = value from (Default = value from
.Xr hostname 1 , .Xr hostname 1 ,
.Pa /etc/resolv.conf , .Pa /etc/resolv.conf ,
or or
.Ev LOCALDOMAIN ; .Ev LOCALDOMAIN ;
abbreviation = abbreviation =
.Ic do ) .Ic do )
.It Xo .It Xo
.Sm off .Sm off
@ -308,11 +308,11 @@ abbreviation =
.Ar ... .Ar ...
.Sm on .Sm on
.Xc .Xc
Change the default domain name to Change the default domain name to
.Ar name1 .Ar name1
and the domain search list and the domain search list
to to
.Ar name1 , name2 , .Ar name1 , name2 ,
etc. A maximum of 6 names separated by slashes (/) etc. A maximum of 6 names separated by slashes (/)
can be specified. can be specified.
For example, For example,
@ -322,48 +322,48 @@ set srchlist=lcs.MIT.EDU/ai.MIT.EDU/MIT.EDU
.Pp .Pp
sets the domain to lcs.MIT.EDU and the search list to the three names. sets the domain to lcs.MIT.EDU and the search list to the three names.
This command overrides the This command overrides the
default domain name and search list of the default domain name and search list of the
.Dq Ic set domain .Dq Ic set domain
command. command.
Use the Use the
.Dq Ic set all .Dq Ic set all
command to display the list. command to display the list.
.Pp .Pp
(Default = value based on (Default = value based on
.Xr hostname 1 , .Xr hostname 1 ,
.Pa /etc/resolv.conf , .Pa /etc/resolv.conf ,
or or
.Ev LOCALDOMAIN ; .Ev LOCALDOMAIN ;
abbreviation = abbreviation =
.Ic srchl ) .Ic srchl )
.It Xo .It Xo
.Oo Ic no Oc Ns Ic defname .Oo Ic no Oc Ns Ic defname
.Xc .Xc
If set, append the default domain name to a single-component lookup request If set, append the default domain name to a single-component lookup request
(i.e., one that does not contain a period). (i.e., one that does not contain a period).
.Pp .Pp
(Default = (Default =
.Ic defname ; .Ic defname ;
abbreviation = abbreviation =
.Oo Ic no Oc Ns Ic defname ) .Oo Ic no Oc Ns Ic defname )
.It Xo .It Xo
.Oo Ic no Oc Ns Ic search .Oo Ic no Oc Ns Ic search
.Xc .Xc
If the lookup request contains at least one period but If the lookup request contains at least one period but
.Em doesn't .Em doesn't
end with a trailing period, append the domain names in the domain search list end with a trailing period, append the domain names in the domain search list
to the request until an answer is received. to the request until an answer is received.
.Pp .Pp
(Default = (Default =
.Ic search ; .Ic search ;
abbreviation = abbreviation =
.Oo Ic no Oc Ns Ic sea ) .Oo Ic no Oc Ns Ic sea )
.It Ic port Ns = Ns Ar value .It Ic port Ns = Ns Ar value
Change the default TCP/UDP name server port to Change the default TCP/UDP name server port to
.Ar value . .Ar value .
.Pp .Pp
(Default = 53; (Default = 53;
abbreviation = abbreviation =
.Ic \&po ) .Ic \&po )
.It Ic querytype Ns = Ns Ar value .It Ic querytype Ns = Ns Ar value
.It Ic type Ns = Ns Ar value .It Ic type Ns = Ns Ar value
@ -385,8 +385,8 @@ the name server for the named zone.
the host name if the query is an Internet address; the host name if the query is an Internet address;
otherwise, the pointer to other information. otherwise, the pointer to other information.
.It Dv SOA .It Dv SOA
the domain's the domain's
.Dq start-of-authority .Dq start-of-authority
information. information.
.It Dv TXT .It Dv TXT
the text information. the text information.
@ -396,14 +396,14 @@ the user information.
the supported well-known services. the supported well-known services.
.El .El
.Pp .Pp
Other types Other types
.Dv ( ANY , AXFR , MB , .Dv ( ANY , AXFR , MB ,
.Dv MD , MF , NULL ) .Dv MD , MF , NULL )
are described in the RFC-1035 document. are described in the RFC-1035 document.
.Pp .Pp
(Default = (Default =
.Dv A ; .Dv A ;
abbreviations = abbreviations =
.Ic q , ty ) .Ic q , ty )
.It Xo .It Xo
.Oo Ic no Oc Ns Ic recurse .Oo Ic no Oc Ns Ic recurse
@ -411,56 +411,56 @@ abbreviations =
Tell the name server to query other servers if it does not have the Tell the name server to query other servers if it does not have the
information. information.
.Pp .Pp
(Default = (Default =
.Ic recurse ; .Ic recurse ;
abbreviation = abbreviation =
.Oo Ic no Oc Ns Ic rec ) .Oo Ic no Oc Ns Ic rec )
.It Ic retry Ns = Ns Ar number .It Ic retry Ns = Ns Ar number
Set the number of retries to Set the number of retries to
.Ar number . .Ar number .
When a reply to a request is not received within a certain When a reply to a request is not received within a certain
amount of time (changed with amount of time (changed with
.Dq Ic set timeout ) , .Dq Ic set timeout ) ,
the timeout period is doubled and the request is resent. the timeout period is doubled and the request is resent.
The retry value controls how many times a request is resent before giving up. The retry value controls how many times a request is resent before giving up.
.Pp .Pp
(Default = 4, abbreviation = (Default = 4, abbreviation =
.Ic ret ) .Ic ret )
.It Ic root Ns = Ns Ar host .It Ic root Ns = Ns Ar host
Change the name of the root server to Change the name of the root server to
.Ar host . .Ar host .
This affects the This affects the
.Dq Ic root .Dq Ic root
command. command.
.Pp .Pp
(Default = (Default =
.Ic ns.internic.net. ; .Ic ns.internic.net. ;
abbreviation = abbreviation =
.Ic ro ) .Ic ro )
.It Ic timeout Ns = Ns Ar number .It Ic timeout Ns = Ns Ar number
Change the initial timeout interval for waiting for a reply to Change the initial timeout interval for waiting for a reply to
.Ar number .Ar number
seconds. Each retry doubles the timeout period. seconds. Each retry doubles the timeout period.
.Pp .Pp
(Default = 5 seconds; abbreviation = (Default = 5 seconds; abbreviation =
.Ic ti ) .Ic ti )
.It Xo .It Xo
.Oo Ic no Oc Ns Ic vc .Oo Ic no Oc Ns Ic vc
.Xc .Xc
Always use a virtual circuit when sending requests to the server. Always use a virtual circuit when sending requests to the server.
.Pp .Pp
(Default = (Default =
.Ic novc ; .Ic novc ;
abbreviation = abbreviation =
.Oo Ic no Oc Ns Ic v ) .Oo Ic no Oc Ns Ic v )
.It Xo .It Xo
.Oo Ic no Oc Ns Ic ignoretc .Oo Ic no Oc Ns Ic ignoretc
.Xc .Xc
Ignore packet truncation errors. Ignore packet truncation errors.
.Pp .Pp
(Default = (Default =
.Ic noignoretc ; .Ic noignoretc ;
abbreviation = abbreviation =
.Oo Ic no Oc Ns Ic ig ) .Oo Ic no Oc Ns Ic ig )
.El .El
.El .El
@ -470,9 +470,9 @@ Possible errors are:
.Bl -tag -width "Timed" .Bl -tag -width "Timed"
.It Li Timed out .It Li Timed out
The server did not respond to a request after a certain amount of The server did not respond to a request after a certain amount of
time (changed with time (changed with
.Dq Ic set timeout Ns = Ns Ar value ) .Dq Ic set timeout Ns = Ns Ar value )
and a certain number of retries (changed with and a certain number of retries (changed with
.Do .Do
.Ic set retry Ns = Ns Ar value .Ic set retry Ns = Ns Ar value
.Dc ) . .Dc ) .
@ -481,20 +481,20 @@ No name server is running on the server machine.
.It Li \&No records .It Li \&No records
The server does not have resource records of the current query type for the The server does not have resource records of the current query type for the
host, although the host name is valid. host, although the host name is valid.
The query type is specified with the The query type is specified with the
.Dq Ic set querytype .Dq Ic set querytype
command. command.
.It Li Non-existent domain .It Li Non-existent domain
The host or domain name does not exist. The host or domain name does not exist.
.It Li Connection refused .It Li Connection refused
.It Li Network is unreachable .It Li Network is unreachable
The connection to the name or finger server could not be made The connection to the name or finger server could not be made
at the current time. at the current time.
This error commonly occurs with This error commonly occurs with
.Ic ls .Ic ls
and and
.Ic finger .Ic finger
requests. requests.
.It Li Server failure .It Li Server failure
The name server found an internal inconsistency in its database The name server found an internal inconsistency in its database
and could not return a valid answer. and could not return a valid answer.
@ -502,7 +502,7 @@ and could not return a valid answer.
The name server refused to service the request. The name server refused to service the request.
.It Li Format error .It Li Format error
The name server found that the request packet was not in the proper format. The name server found that the request packet was not in the proper format.
It may indicate an error in It may indicate an error in
.Nm nslookup . .Nm nslookup .
.El .El
.Sh FILES .Sh FILES
@ -523,7 +523,7 @@ overrides default domain
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr named 8 , .Xr named 8 ,
.Xr resolver 3 , .Xr resolver 3 ,
.Xr resolv.conf 5 ; .Xr resolv.conf 5 ;
RFC-1034, RFC-1034,
.Dq Domain Names - Concepts and Facilities ; .Dq Domain Names - Concepts and Facilities ;