Drop trailing whitespace.
This commit is contained in:
wiz
parent
199212f421
commit
810322e03d
|
|
@ -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
|
||||
.\"
|
||||
|
|
@ -629,7 +629,7 @@ the following:
|
|||
file \&"my_security_file\&";
|
||||
severity info;
|
||||
};
|
||||
category security { my_security_channel;
|
||||
category security { my_security_channel;
|
||||
default_syslog; default_debug; };
|
||||
.Ed
|
||||
.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.
|
||||
.Ss Server Information
|
||||
.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().
|
||||
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
|
||||
.Pa hostname.bind
|
||||
in class chaos to the anycast server and getting back a unique name.
|
||||
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
|
||||
The version the server should report via the ndc command or via a query of
|
||||
name
|
||||
.Pa version.bind
|
||||
The version the server should report via the ndc command or via a query of
|
||||
name
|
||||
.Pa version.bind
|
||||
in class chaos.
|
||||
The default is the real version number of the server,
|
||||
but some server operators prefer the string (
|
||||
.Ic surely you must be joking
|
||||
.Ic surely you must be joking
|
||||
).
|
||||
.El
|
||||
.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
|
||||
inbound zone transfers. If not specified, the default is
|
||||
system dependent (e.g.
|
||||
.Pa /usr/sbin/named-xfer
|
||||
.Pa /usr/sbin/named-xfer
|
||||
).
|
||||
.It Ic dump-file
|
||||
The pathname of the file the server dumps the database to when it
|
||||
receives
|
||||
.Dv SIGINT
|
||||
signal (as sent by
|
||||
.Ic ndc dumpdb
|
||||
.Ic ndc dumpdb
|
||||
). If not specified, the default is
|
||||
.Pa named_dump.db .
|
||||
.It Ic memstatistics-file
|
||||
|
|
@ -864,7 +864,7 @@ bit is always set on
|
|||
responses, even if the server is not actually authoritative.
|
||||
The default is
|
||||
.Li no .
|
||||
Turning
|
||||
Turning
|
||||
.Lc auth-nxdomain
|
||||
will allow older clients that require
|
||||
.Li AA
|
||||
|
|
@ -944,20 +944,20 @@ becoming corrupted (at the cost of requiring more work from the client).
|
|||
.It Ic has-old-clients
|
||||
Setting the option to
|
||||
.Li yes ,
|
||||
is equivalent to setting the following three options:
|
||||
is equivalent to setting the following three options:
|
||||
.Ic auth-nxdomain yes ; ,
|
||||
.Ic maintain-ixfr-base yes ; ,
|
||||
and
|
||||
and
|
||||
.Ic rfc2308-type1 no ;
|
||||
.Pp
|
||||
The use of
|
||||
.Ic has-old-clients
|
||||
with
|
||||
.Ic auth-nxdomain ,
|
||||
.Ic auth-nxdomain ,
|
||||
.Ic maintain-ixfr-base ,
|
||||
and
|
||||
.Ic rfc2308-type1
|
||||
is order dependent.
|
||||
and
|
||||
.Ic rfc2308-type1
|
||||
is order dependent.
|
||||
.It Ic host-statistics
|
||||
If
|
||||
.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
|
||||
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
|
||||
if they do, they will initiate it immediately.
|
||||
If
|
||||
if they do, they will initiate it immediately.
|
||||
If
|
||||
.Li explicit ,
|
||||
the DNS NOTIFY messages will only be sent to the addresses in the
|
||||
.Ic also-notify
|
||||
|
|
@ -1011,7 +1011,7 @@ statement.
|
|||
If
|
||||
.Li yes ,
|
||||
suppress the initial notify messages when the server first loads.
|
||||
The default is
|
||||
The default is
|
||||
.Li no .
|
||||
.It Ic recursion
|
||||
If
|
||||
|
|
@ -1026,48 +1026,48 @@ See also
|
|||
above.
|
||||
.It Ic rfc2308-type1
|
||||
If
|
||||
.Li yes,
|
||||
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
|
||||
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
|
||||
fix is to upgrade the broken server or sendmail. The default is
|
||||
.Li yes,
|
||||
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
|
||||
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
|
||||
fix is to upgrade the broken server or sendmail. The default is
|
||||
.Li no .
|
||||
.It Ic use-id-pool
|
||||
If
|
||||
.Li yes,
|
||||
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
|
||||
.Li no .
|
||||
.It Ic treat-cr-as-space
|
||||
If
|
||||
.Li yes,
|
||||
If
|
||||
.Li yes,
|
||||
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
|
||||
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 .
|
||||
.El
|
||||
.Ss Also-Notify
|
||||
.Ic also-notify
|
||||
.Pp
|
||||
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
|
||||
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
|
||||
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
|
||||
the zones will quickly converge on ``stealth'' servers. If an
|
||||
.Ic also-notify
|
||||
list will not get sent NOTIFY messages for that zone.
|
||||
The default is the empty list (no global notification list).
|
||||
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
|
||||
list will not get sent NOTIFY messages for that zone.
|
||||
The default is the empty list (no global notification list).
|
||||
.Ss Forwarding
|
||||
The forwarding facility can be used to create a large site-wide
|
||||
cache on a few servers, reducing traffic over links to external
|
||||
|
|
@ -1164,7 +1164,7 @@ from all hosts.
|
|||
.Bl -tag -width 0n
|
||||
.It Ic allow-recursion
|
||||
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.
|
||||
.It Ic allow-transfer
|
||||
Specifies which hosts are allowed to receive zone transfers from the
|
||||
|
|
@ -1284,7 +1284,7 @@ statement.
|
|||
.Nm transfer-source
|
||||
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
|
||||
address must appear in the remote end's
|
||||
address must appear in the remote end's
|
||||
.Nm allow-transfer
|
||||
option for the zones being transferred, if one is specified. This statement sets the
|
||||
.Nm transfer-source
|
||||
|
|
@ -1348,7 +1348,7 @@ actual kernel limit is larger than this value, use
|
|||
to specify the limit explicitly.
|
||||
.It Ic max-ixfr-log-size
|
||||
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
|
||||
log kept for Incremental Zone Transfer.
|
||||
.It Ic stacksize
|
||||
|
|
@ -1420,23 +1420,23 @@ As the order of RRs is not defined, this should not cause any problems.
|
|||
.Pp
|
||||
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
|
||||
resolvers can do this, or are not correctly configured.
|
||||
resolvers can do this, or are not correctly configured.
|
||||
.Pp
|
||||
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,
|
||||
not all the clients.
|
||||
not all the clients.
|
||||
.Pp
|
||||
The
|
||||
The
|
||||
.Ic sortlist
|
||||
statement takes an address match list and interprets it even more
|
||||
specially than the
|
||||
specially than the
|
||||
.Ic topology
|
||||
statement does.
|
||||
statement does.
|
||||
.Pp
|
||||
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,
|
||||
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
|
||||
Once the source address of the query has been matched, if the top level
|
||||
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
|
||||
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
|
||||
their directly connected networks.
|
||||
their directly connected networks.
|
||||
.Bd -literal
|
||||
sortlist {
|
||||
{ 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
|
||||
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 is defined, is a cyclic ordering (round robin).
|
||||
ordering is defined, is a cyclic ordering (round robin).
|
||||
.Pp
|
||||
An
|
||||
An
|
||||
.Ic order_spec
|
||||
is defined as follows:
|
||||
is defined as follows:
|
||||
.Bd -literal
|
||||
[ \fIclass class_name\fR ][ \fItype type_name\fR ][ \fIname\fR "FQDN" ] \fIorder\fR ordering
|
||||
.Ed
|
||||
.Pp
|
||||
If no class is specified, the default is
|
||||
If no class is specified, the default is
|
||||
.Ic ANY .
|
||||
If no
|
||||
.Li Ictype
|
||||
If no
|
||||
.Li Ictype
|
||||
is specified, the default is
|
||||
.Ic ANY .
|
||||
If no name is specified, the default is "*".
|
||||
.Ic ANY .
|
||||
If no name is specified, the default is "*".
|
||||
.Pp
|
||||
The legal values for
|
||||
.Ic ordering
|
||||
are:
|
||||
The legal values for
|
||||
.Ic ordering
|
||||
are:
|
||||
.Bl -tag -width indent
|
||||
.It Ic fixed
|
||||
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.
|
||||
.El
|
||||
.Pp
|
||||
For example:
|
||||
For example:
|
||||
.Bd -literal
|
||||
rrset-order {
|
||||
class IN type A name "rc.vix.com" order random;
|
||||
|
|
@ -1533,20 +1533,20 @@ For example:
|
|||
.Pp
|
||||
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
|
||||
in cyclic order.
|
||||
in cyclic order.
|
||||
.Pp
|
||||
If multiple
|
||||
If multiple
|
||||
.Ic rrset-order
|
||||
statements appear, they are not combined--the last one applies.
|
||||
statements appear, they are not combined--the last one applies.
|
||||
.Pp
|
||||
If no
|
||||
If no
|
||||
.Ic rrset-order
|
||||
statement is specified, a default one of:
|
||||
statement is specified, a default one of:
|
||||
.Bd -literal
|
||||
rrset-order { class ANY type ANY name "*" order cyclic ; };
|
||||
.Ed
|
||||
.Pp
|
||||
is used.
|
||||
is used.
|
||||
.Ss Glue Ordering
|
||||
When running a root nameserver it is sometimes necessary to ensure that other
|
||||
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.
|
||||
This can be achieved by setting
|
||||
.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
|
||||
Some firewalls fail to pass EDNS/UDP messages that are larger than
|
||||
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
|
||||
named making EDNS queries to it by specifying
|
||||
.Ic edns
|
||||
.Ic no; .
|
||||
The default value of
|
||||
.Ic no; .
|
||||
The default value of
|
||||
.Ic edns
|
||||
is
|
||||
is
|
||||
.Ic yes .
|
||||
.Pp
|
||||
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
|
||||
The
|
||||
.Ic keys
|
||||
clause is used to identify a
|
||||
clause is used to identify a
|
||||
.Va key_id
|
||||
defined by the
|
||||
.Ic key
|
||||
|
|
|
|||
|
|
@ -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 (c) 1985, 1989
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
.\"
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
|
|
@ -17,7 +17,7 @@
|
|||
.\" 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
|
||||
.\" without specific prior written permission.
|
||||
.\"
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||||
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
|
|
@ -31,14 +31,14 @@
|
|||
.\" SUCH DAMAGE.
|
||||
.\" -
|
||||
.\" Portions Copyright (c) 1993 by Digital Equipment Corporation.
|
||||
.\"
|
||||
.\"
|
||||
.\" Permission to use, copy, modify, and distribute this software for any
|
||||
.\" purpose with or without fee is hereby granted, provided that the above
|
||||
.\" copyright notice and this permission notice appear in all copies, and that
|
||||
.\" the name of Digital Equipment Corporation not be used in advertising or
|
||||
.\" publicity pertaining to distribution of the document or software without
|
||||
.\" specific, written prior permission.
|
||||
.\"
|
||||
.\"
|
||||
.\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL
|
||||
.\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES
|
||||
.\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT
|
||||
|
|
@ -56,7 +56,7 @@
|
|||
.Dt NSLOOKUP 8
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm nslookup
|
||||
.Nm nslookup
|
||||
.Nd query Internet name servers interactively
|
||||
.Sh SYNOPSIS
|
||||
.Nm nslookup
|
||||
|
|
@ -64,17 +64,17 @@
|
|||
.Op Ar host-to-find | Fl Op Ar server
|
||||
.Sh DESCRIPTION
|
||||
.Ic Nslookup
|
||||
is a program to query Internet domain name servers.
|
||||
.Ic Nslookup
|
||||
is a program to query Internet domain name servers.
|
||||
.Ic Nslookup
|
||||
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.
|
||||
information about various hosts and domains or to print a list of hosts
|
||||
in a domain.
|
||||
Non-interactive mode is used to print just the name and requested information
|
||||
for a host or domain.
|
||||
.Sh ARGUMENTS
|
||||
Interactive mode is entered in the following cases:
|
||||
.Bl -tag -width "a) "
|
||||
.Bl -tag -width "a) "
|
||||
.It a)
|
||||
when no arguments are given (the default name server will be used),
|
||||
.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.
|
||||
.El
|
||||
.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
|
||||
is given as the first argument. The optional second argument specifies
|
||||
the host name or address of a name server.
|
||||
.Pp
|
||||
The options listed under the
|
||||
.Dq Li set
|
||||
The options listed under the
|
||||
.Dq Li set
|
||||
command below can be specified in
|
||||
the
|
||||
.Pa .nslookuprc
|
||||
file in the user's home directory if they are listed
|
||||
the
|
||||
.Pa .nslookuprc
|
||||
file in the user's home directory if they are listed
|
||||
one per line. 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,
|
||||
|
|
@ -102,123 +102,123 @@ and the initial timeout to 10 seconds, type:
|
|||
.Ed
|
||||
.Sh INTERACTIVE COMMANDS
|
||||
Commands may be interrupted at any time by typing a control-C.
|
||||
To exit, type a control-D
|
||||
.Pq Dv EOF
|
||||
or type
|
||||
To exit, type a control-D
|
||||
.Pq Dv EOF
|
||||
or type
|
||||
.Li exit .
|
||||
The command line length must be less than 256 characters.
|
||||
To treat a built-in command as a host name,
|
||||
precede it with an escape character
|
||||
.Pq Sq \e .
|
||||
To treat a built-in command as a host name,
|
||||
precede it with an escape character
|
||||
.Pq Sq \e .
|
||||
.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
|
||||
Look up information for
|
||||
.Ar host
|
||||
using the current default server or using
|
||||
.Ar server ,
|
||||
Look up information for
|
||||
.Ar host
|
||||
using the current default server or using
|
||||
.Ar server ,
|
||||
if specified.
|
||||
If
|
||||
.Ar host
|
||||
is an Internet address and the query type is
|
||||
.Dv A
|
||||
or
|
||||
.Dv PTR ,
|
||||
If
|
||||
.Ar host
|
||||
is an Internet address and the query type is
|
||||
.Dv A
|
||||
or
|
||||
.Dv PTR ,
|
||||
the name of the host is returned.
|
||||
If
|
||||
.Ar host
|
||||
is a name and does not have a trailing period, the default
|
||||
If
|
||||
.Ar host
|
||||
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
|
||||
.Ic set
|
||||
options
|
||||
.Ic domain , srchlist , defname ,
|
||||
and
|
||||
options
|
||||
.Ic domain , srchlist , defname ,
|
||||
and
|
||||
.Ic search . )
|
||||
.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.
|
||||
.It Ic server Ar domain
|
||||
.It Ic lserver Ar domain
|
||||
Change the default server to
|
||||
.Ar domain ;
|
||||
.Ic lserver
|
||||
uses the initial server to look up information about
|
||||
Change the default server to
|
||||
.Ar domain ;
|
||||
.Ic lserver
|
||||
uses the initial server to look up information about
|
||||
.Ar domain ,
|
||||
while
|
||||
while
|
||||
.Ic server
|
||||
uses the current default server.
|
||||
uses the current default server.
|
||||
If an authoritative answer can't be found, the names of servers
|
||||
that might have the answer are returned.
|
||||
.It Ic root
|
||||
Changes the default server to the server for the root of the domain name space.
|
||||
Currently, the host
|
||||
.Li ns.internic.net
|
||||
Currently, the host
|
||||
.Li ns.internic.net
|
||||
is used.
|
||||
(This command is a synonym for
|
||||
(This command is a synonym for
|
||||
.Dq Ic lserver ns.internic.net . )
|
||||
The name of the root server can be changed with the
|
||||
.Dq Ic set root
|
||||
The name of the root server can be changed with the
|
||||
.Dq Ic set root
|
||||
command.
|
||||
.It Xo Ic finger Op Ar name
|
||||
.It Xo Ic finger Op Ar name
|
||||
.Op Ic > Ar filename
|
||||
.Xc
|
||||
.It Xo Ic finger Op Ar name
|
||||
.It Xo Ic finger Op Ar name
|
||||
.Op Ic >> Ar filename
|
||||
.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
|
||||
was successful and returned address information (see the
|
||||
.Dq Ic set querytype Ns = Ns Dv A
|
||||
was successful and returned address information (see the
|
||||
.Dq Ic set querytype Ns = Ns Dv A
|
||||
command).
|
||||
The
|
||||
.Ar name
|
||||
is optional.
|
||||
.Ic >
|
||||
and
|
||||
.Ic >>
|
||||
The
|
||||
.Ar name
|
||||
is optional.
|
||||
.Ic >
|
||||
and
|
||||
.Ic >>
|
||||
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
|
||||
.Xc
|
||||
.It Xo Ic ls Op Ar option
|
||||
.It Xo Ic ls Op Ar option
|
||||
.Ar domain Op Ic >> Ar filename
|
||||
.Xc
|
||||
List the information available for
|
||||
.Ar domain ,
|
||||
optionally creating or appending to
|
||||
List the information available for
|
||||
.Ar domain ,
|
||||
optionally creating or appending to
|
||||
.Ar filename .
|
||||
The default output contains host names and their Internet addresses.
|
||||
.Ar Option
|
||||
The default output contains host names and their Internet addresses.
|
||||
.Ar Option
|
||||
can be one of the following:
|
||||
.Bl -tag -width "-a "
|
||||
.It Fl t Ar querytype
|
||||
lists all records of the specified type (see
|
||||
.Ar querytype
|
||||
lists all records of the specified type (see
|
||||
.Ar querytype
|
||||
below).
|
||||
.It Fl a
|
||||
lists aliases of hosts in the domain;
|
||||
synonym for
|
||||
synonym for
|
||||
.Dq Fl t Dv CNAME .
|
||||
.It Fl d
|
||||
lists all records for the domain;
|
||||
synonym for
|
||||
synonym for
|
||||
.Dq Fl t Dv ANY .
|
||||
.It Fl h
|
||||
lists CPU and operating system information for the domain;
|
||||
synonym for
|
||||
synonym for
|
||||
.Dq Fl t Dv HINFO .
|
||||
.It Fl s
|
||||
lists well-known services of hosts in the domain;
|
||||
synonym for
|
||||
synonym for
|
||||
.Dq Fl t Dv WKS .
|
||||
.El
|
||||
.Pp
|
||||
When output is directed to a file, hash marks are printed for every
|
||||
50 records received from the server.
|
||||
.It Ic view Ar filename
|
||||
Sorts and lists the output of previous
|
||||
.Ic ls
|
||||
command(s) with
|
||||
Sorts and lists the output of previous
|
||||
.Ic ls
|
||||
command(s) with
|
||||
.Xr more 1 .
|
||||
.It Ic help
|
||||
.It Ic ?\&
|
||||
|
|
@ -233,7 +233,7 @@ This command is used to change state information that affects the lookups.
|
|||
Valid keywords are:
|
||||
.Bl -tag -width "class=v"
|
||||
.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 .
|
||||
Information about the current default server and host is also printed.
|
||||
.It Ic class Ns = Ns Ar value
|
||||
|
|
@ -251,9 +251,9 @@ wildcard (any of the above)
|
|||
.Pp
|
||||
The class specifies the protocol group of the information.
|
||||
.Pp
|
||||
(Default =
|
||||
.Dv IN ;
|
||||
abbreviation =
|
||||
(Default =
|
||||
.Dv IN ;
|
||||
abbreviation =
|
||||
.Ic cl )
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic debug
|
||||
|
|
@ -261,9 +261,9 @@ abbreviation =
|
|||
Turn debugging mode on. A lot more information is printed about the
|
||||
packet sent to the server and the resulting answer.
|
||||
.Pp
|
||||
(Default =
|
||||
.Ic nodebug ;
|
||||
abbreviation =
|
||||
(Default =
|
||||
.Ic nodebug ;
|
||||
abbreviation =
|
||||
.Oo Ic no Oc Ns Ic deb )
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic d2
|
||||
|
|
@ -271,34 +271,34 @@ abbreviation =
|
|||
Turn exhaustive debugging mode on.
|
||||
Essentially all fields of every packet are printed.
|
||||
.Pp
|
||||
(Default =
|
||||
(Default =
|
||||
.Ic nod2 )
|
||||
.It Ic domain Ns = Ns Ar name
|
||||
Change the default domain name to
|
||||
.Ar name .
|
||||
Change the default domain name to
|
||||
.Ar name .
|
||||
The default domain name is appended to a lookup request depending on the
|
||||
state of the
|
||||
.Ic defname
|
||||
and
|
||||
.Ic search
|
||||
state of the
|
||||
.Ic defname
|
||||
and
|
||||
.Ic search
|
||||
options.
|
||||
The domain search list contains the parents of the default domain if it has
|
||||
at least two components in its name.
|
||||
The domain search list contains the parents of the default domain if it has
|
||||
at least two components in its name.
|
||||
For example, if the default domain
|
||||
is CC.Berkeley.EDU, the search list is CC.Berkeley.EDU and Berkeley.EDU.
|
||||
Use the
|
||||
.Dq Ic set srchlist
|
||||
Use the
|
||||
.Dq Ic set srchlist
|
||||
command to specify a different list.
|
||||
Use the
|
||||
.Dq Ic set all
|
||||
Use the
|
||||
.Dq Ic set all
|
||||
command to display the list.
|
||||
.Pp
|
||||
(Default = value from
|
||||
.Xr hostname 1 ,
|
||||
(Default = value from
|
||||
.Xr hostname 1 ,
|
||||
.Pa /etc/resolv.conf ,
|
||||
or
|
||||
or
|
||||
.Ev LOCALDOMAIN ;
|
||||
abbreviation =
|
||||
abbreviation =
|
||||
.Ic do )
|
||||
.It Xo
|
||||
.Sm off
|
||||
|
|
@ -308,11 +308,11 @@ abbreviation =
|
|||
.Ar ...
|
||||
.Sm on
|
||||
.Xc
|
||||
Change the default domain name to
|
||||
.Ar name1
|
||||
Change the default domain name to
|
||||
.Ar name1
|
||||
and the domain search list
|
||||
to
|
||||
.Ar name1 , name2 ,
|
||||
to
|
||||
.Ar name1 , name2 ,
|
||||
etc. A maximum of 6 names separated by slashes (/)
|
||||
can be specified.
|
||||
For example,
|
||||
|
|
@ -322,48 +322,48 @@ set srchlist=lcs.MIT.EDU/ai.MIT.EDU/MIT.EDU
|
|||
.Pp
|
||||
sets the domain to lcs.MIT.EDU and the search list to the three names.
|
||||
This command overrides the
|
||||
default domain name and search list of the
|
||||
.Dq Ic set domain
|
||||
default domain name and search list of the
|
||||
.Dq Ic set domain
|
||||
command.
|
||||
Use the
|
||||
.Dq Ic set all
|
||||
Use the
|
||||
.Dq Ic set all
|
||||
command to display the list.
|
||||
.Pp
|
||||
(Default = value based on
|
||||
.Xr hostname 1 ,
|
||||
(Default = value based on
|
||||
.Xr hostname 1 ,
|
||||
.Pa /etc/resolv.conf ,
|
||||
or
|
||||
or
|
||||
.Ev LOCALDOMAIN ;
|
||||
abbreviation =
|
||||
abbreviation =
|
||||
.Ic srchl )
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic defname
|
||||
.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).
|
||||
.Pp
|
||||
(Default =
|
||||
.Ic defname ;
|
||||
abbreviation =
|
||||
(Default =
|
||||
.Ic defname ;
|
||||
abbreviation =
|
||||
.Oo Ic no Oc Ns Ic defname )
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic search
|
||||
.Xc
|
||||
If the lookup request contains at least one period but
|
||||
.Em doesn't
|
||||
If the lookup request contains at least one period but
|
||||
.Em doesn't
|
||||
end with a trailing period, append the domain names in the domain search list
|
||||
to the request until an answer is received.
|
||||
.Pp
|
||||
(Default =
|
||||
.Ic search ;
|
||||
abbreviation =
|
||||
(Default =
|
||||
.Ic search ;
|
||||
abbreviation =
|
||||
.Oo Ic no Oc Ns Ic sea )
|
||||
.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 .
|
||||
.Pp
|
||||
(Default = 53;
|
||||
abbreviation =
|
||||
(Default = 53;
|
||||
abbreviation =
|
||||
.Ic \&po )
|
||||
.It Ic querytype 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;
|
||||
otherwise, the pointer to other information.
|
||||
.It Dv SOA
|
||||
the domain's
|
||||
.Dq start-of-authority
|
||||
the domain's
|
||||
.Dq start-of-authority
|
||||
information.
|
||||
.It Dv TXT
|
||||
the text information.
|
||||
|
|
@ -396,14 +396,14 @@ the user information.
|
|||
the supported well-known services.
|
||||
.El
|
||||
.Pp
|
||||
Other types
|
||||
Other types
|
||||
.Dv ( ANY , AXFR , MB ,
|
||||
.Dv MD , MF , NULL )
|
||||
are described in the RFC-1035 document.
|
||||
.Pp
|
||||
(Default =
|
||||
.Dv A ;
|
||||
abbreviations =
|
||||
(Default =
|
||||
.Dv A ;
|
||||
abbreviations =
|
||||
.Ic q , ty )
|
||||
.It Xo
|
||||
.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
|
||||
information.
|
||||
.Pp
|
||||
(Default =
|
||||
.Ic recurse ;
|
||||
(Default =
|
||||
.Ic recurse ;
|
||||
abbreviation =
|
||||
.Oo Ic no Oc Ns Ic rec )
|
||||
.It Ic retry Ns = Ns Ar number
|
||||
Set the number of retries to
|
||||
Set the number of retries to
|
||||
.Ar number .
|
||||
When a reply to a request is not received within a certain
|
||||
amount of time (changed with
|
||||
.Dq Ic set timeout ) ,
|
||||
the timeout period is doubled and the request is resent.
|
||||
When a reply to a request is not received within a certain
|
||||
amount of time (changed with
|
||||
.Dq Ic set timeout ) ,
|
||||
the timeout period is doubled and the request is resent.
|
||||
The retry value controls how many times a request is resent before giving up.
|
||||
.Pp
|
||||
(Default = 4, abbreviation =
|
||||
(Default = 4, abbreviation =
|
||||
.Ic ret )
|
||||
.It Ic root Ns = Ns Ar host
|
||||
Change the name of the root server to
|
||||
.Ar host .
|
||||
This affects the
|
||||
.Dq Ic root
|
||||
command.
|
||||
Change the name of the root server to
|
||||
.Ar host .
|
||||
This affects the
|
||||
.Dq Ic root
|
||||
command.
|
||||
.Pp
|
||||
(Default =
|
||||
(Default =
|
||||
.Ic ns.internic.net. ;
|
||||
abbreviation =
|
||||
abbreviation =
|
||||
.Ic ro )
|
||||
.It Ic timeout Ns = Ns Ar number
|
||||
Change the initial timeout interval for waiting for a reply to
|
||||
.Ar number
|
||||
Change the initial timeout interval for waiting for a reply to
|
||||
.Ar number
|
||||
seconds. Each retry doubles the timeout period.
|
||||
.Pp
|
||||
(Default = 5 seconds; abbreviation =
|
||||
(Default = 5 seconds; abbreviation =
|
||||
.Ic ti )
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic vc
|
||||
.Xc
|
||||
Always use a virtual circuit when sending requests to the server.
|
||||
.Pp
|
||||
(Default =
|
||||
.Ic novc ;
|
||||
abbreviation =
|
||||
(Default =
|
||||
.Ic novc ;
|
||||
abbreviation =
|
||||
.Oo Ic no Oc Ns Ic v )
|
||||
.It Xo
|
||||
.Oo Ic no Oc Ns Ic ignoretc
|
||||
.Xc
|
||||
Ignore packet truncation errors.
|
||||
.Pp
|
||||
(Default =
|
||||
.Ic noignoretc ;
|
||||
abbreviation =
|
||||
(Default =
|
||||
.Ic noignoretc ;
|
||||
abbreviation =
|
||||
.Oo Ic no Oc Ns Ic ig )
|
||||
.El
|
||||
.El
|
||||
|
|
@ -470,9 +470,9 @@ Possible errors are:
|
|||
.Bl -tag -width "Timed"
|
||||
.It Li Timed out
|
||||
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 )
|
||||
and a certain number of retries (changed with
|
||||
and a certain number of retries (changed with
|
||||
.Do
|
||||
.Ic set retry Ns = Ns Ar value
|
||||
.Dc ) .
|
||||
|
|
@ -481,20 +481,20 @@ No name server is running on the server machine.
|
|||
.It Li \&No records
|
||||
The server does not have resource records of the current query type for the
|
||||
host, although the host name is valid.
|
||||
The query type is specified with the
|
||||
.Dq Ic set querytype
|
||||
The query type is specified with the
|
||||
.Dq Ic set querytype
|
||||
command.
|
||||
.It Li Non-existent domain
|
||||
The host or domain name does not exist.
|
||||
.It Li Connection refused
|
||||
.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.
|
||||
This error commonly occurs with
|
||||
.Ic ls
|
||||
and
|
||||
.Ic finger
|
||||
requests.
|
||||
This error commonly occurs with
|
||||
.Ic ls
|
||||
and
|
||||
.Ic finger
|
||||
requests.
|
||||
.It Li Server failure
|
||||
The name server found an internal inconsistency in its database
|
||||
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.
|
||||
.It Li Format error
|
||||
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 .
|
||||
.El
|
||||
.Sh FILES
|
||||
|
|
@ -523,7 +523,7 @@ overrides default domain
|
|||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr named 8 ,
|
||||
.Xr resolver 3 ,
|
||||
.Xr resolver 3 ,
|
||||
.Xr resolv.conf 5 ;
|
||||
RFC-1034,
|
||||
.Dq Domain Names - Concepts and Facilities ;
|
||||
|
|
|
|||
Loading…
Reference in New Issue