diff options
| -rw-r--r-- | usr.sbin/bind/bin/dig/nslookup.1 | 176 |
1 files changed, 81 insertions, 95 deletions
diff --git a/usr.sbin/bind/bin/dig/nslookup.1 b/usr.sbin/bind/bin/dig/nslookup.1 index 56eac32eda4..a42de0f0c5e 100644 --- a/usr.sbin/bind/bin/dig/nslookup.1 +++ b/usr.sbin/bind/bin/dig/nslookup.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: nslookup.1,v 1.13 2019/12/18 15:19:30 jmc Exp $ +.\" $OpenBSD: nslookup.1,v 1.14 2019/12/27 12:56:45 jmc Exp $ .\" .\" Copyright (C) 2004-2007, 2010, 2013-2016, 2018 Internet Systems Consortium, Inc. ("ISC") .\" @@ -14,7 +14,7 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: December 18 2019 $ +.Dd $Mdocdate: December 27 2019 $ .Dt NSLOOKUP 1 .Os .Sh NAME @@ -64,7 +64,10 @@ option causes to print the version number and immediately exits. .Sh INTERACTIVE COMMANDS -.Bl -tag -width Ds +.Bl -tag -width Ds -compact +.It Ic exit +Exit the program. +.Pp .It Ic host Op Ar server Look up information for host using the current default server or using server, if specified. @@ -74,8 +77,9 @@ If host is a name and does not have a trailing period, the search list is used to qualify the name. .Pp To look up a host not in the current domain, append a period to the name. -.It Ic server Ar domain +.Pp .It Ic lserver Ar domain +.It Ic server Ar domain Change the default server to .Ar domain ; .Ic lserver @@ -86,117 +90,99 @@ while 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 -not implemented -.It Ic finger -not implemented -.It Ic ls -not implemented -.It Ic view -not implemented -.It Ic help -not implemented -.It Ic ?\& -not implemented -.It Ic exit -Exits the program. -.It Ic set Cm keyword= Ns Ar value +.Pp +.It Ic set Cm keyword Ns = Ns Ar value This command is used to change state information that affects the lookups. +Some keywords may be abbreviated, as shown in parentheses. Valid keywords are: .Bl -tag -width Ds .It Cm all Prints the current values of the frequently used options to .Ic set . Information about the current default server and host is also printed. -.It Cm class= Ns Ar value +.It Cm class Ns = Ns Ar value +.Pq Cm cl Change the query class to one of: -.Bl -tag -width Ds -.It Cm IN -the Internet class +.Pp +.Bl -tag -width Ds -compact +.It Cm ANY +wildcard .It Cm CH the Chaos class .It Cm HS the Hesiod class -.It Cm ANY -wildcard +.It Cm IN +the Internet class .El .Pp The class specifies the protocol group of the information. -.Pp -(Default = -.Cm IN ; -abbreviation = -.Cm cl ) -.It Xo -.Op Cm no Ns -.Cm debug -.Xc -Turn on or off the display of the full response packet and any intermediate -response packets when searching. -.Pp -(Default = -.Cm nodebug ; -abbreviation = -.Cm nodeb ) +The default is +.Cm IN . .It Xo .Op Cm no Ns .Cm d2 .Xc Turn debugging mode on or off. This displays more about what nslookup is doing. -.Pp -(Default = -.Cm nod2 ) -.It Cm domain= Ns Ar name +The default is +.Cm nod2 . +.It Xo +.Op Cm no Ns +.Cm debug +.Xc +.Pq Cm nodeb +Turn on or off the display of the full response packet and any intermediate +response packets when searching. +The default is +.Cm nodebug . +.It Cm domain Ns = Ns Ar name Sets the search list to .Ar name . .It Xo .Op Cm no Ns -.Cm search +.Cm fail .Xc -If the lookup request contains at least one period but 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 = -.Cm search ) -.It Cm port= Ns Ar value +Try the next name server if a name server responds with SERVFAIL or a referral +.Pq Cm nofail +or terminate query +.Pq Cm fail +on such a response. +The default is +.Cm nofail . +.It Cm ndots Ns = Ns Ar number +Set the number of dots (label separators) in a domain that will disable +searching. +Absolute names always stop searching. +.It Cm port Ns = Ns Ar value +.Pq Cm po Change the default TCP/UDP name server port to .Ar value . -.Pp -(Default = -.Ar 53 ; -abbreviation = -.Cm po ) -.It Cm querytype= Ns Ar value -.It Cm type= Ns Ar value +The default is port 53. +.It Oo Cm query Oc Ns Cm type Ns = Ns Ar value +.Pq Cm q , ty Change the type of the information query. -.Pp -(Default = -.Ar A ; -abbreviations = -.Cm q , -.Cm ty ) +The default is +.Sq A . .It Xo .Op Cm no Ns .Cm recurse .Xc +.Pq Cm rec Tell the name server to query other servers if it does not have the information. -.Pp -(Default = -.Cm recurse ; -abbreviation = -.Xo -.Op Cm no Ns -.Cm rec -.Xc ) -.It Cm ndots= Ns Ar number -Set the number of dots (label separators) in a domain that will disable -searching. -Absolute names always stop searching. -.It Cm retry= Ns Ar number +The default is +.Cm recurse . +.It Cm retry Ns = Ns Ar number Set the number of retries to number. -.It Cm timeout= Ns Ar number +.It Xo +.Op Cm no Ns +.Cm search +.Xc +If the lookup request contains at least one period but doesn't end with a +trailing period, append the domain names in the domain search list to the +request until an answer is received. +The default is +.Cm search . +.It Cm timeout Ns = Ns Ar number Change the initial timeout interval for waiting for a reply to number seconds. .It Xo @@ -204,22 +190,22 @@ reply to number seconds. .Cm vc .Xc Always use a virtual circuit when sending requests to the server. -.Pp -(Default = -.Cm novc ) -.It Xo -.Op Cm no Ns -.Cm fail -.Xc -Try the next name server if a name server responds with SERVFAIL or a referral -.Pq Cm nofail -or terminate query -.Pq Cm fail -on such a response. -.Pp -(Default = -.Cm nofail ) +The default is +.Cm novc . .El +.Pp +.It Ic ?\& +not implemented +.It Ic finger +not implemented +.It Ic help +not implemented +.It Ic ls +not implemented +.It Ic root +not implemented +.It Ic view +not implemented .El .Sh FILES .Pa /etc/resolv.conf |