[BACK]Return to nslookup.1 CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src / external / mpl / bind / dist / bin / dig

Annotation of src/external/mpl/bind/dist/bin/dig/nslookup.1, Revision 1.3

1.2       christos    1: .\"    $NetBSD: nslookup.1,v 1.1.1.11 2016/05/26 15:45:40 christos Exp $
1.1       christos    2: .\"
                      3: .\" Copyright (C) 2004-2007, 2010, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
                      4: .\"
                      5: .\" This Source Code Form is subject to the terms of the Mozilla Public
                      6: .\" License, v. 2.0. If a copy of the MPL was not distributed with this
                      7: .\" file, You can obtain one at http://mozilla.org/MPL/2.0/.
                      8: .\"
                      9: .hy 0
                     10: .ad l
                     11: '\" t
                     12: .\"     Title: nslookup
                     13: .\"    Author:
                     14: .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
                     15: .\"      Date: 2014-01-24
                     16: .\"    Manual: BIND9
                     17: .\"    Source: ISC
                     18: .\"  Language: English
                     19: .\"
                     20: .TH "NSLOOKUP" "1" "2014\-01\-24" "ISC" "BIND9"
                     21: .\" -----------------------------------------------------------------
                     22: .\" * Define some portability stuff
                     23: .\" -----------------------------------------------------------------
                     24: .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                     25: .\" http://bugs.debian.org/507673
                     26: .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
                     27: .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                     28: .ie \n(.g .ds Aq \(aq
                     29: .el       .ds Aq '
                     30: .\" -----------------------------------------------------------------
                     31: .\" * set default formatting
                     32: .\" -----------------------------------------------------------------
                     33: .\" disable hyphenation
                     34: .nh
                     35: .\" disable justification (adjust text to left margin only)
                     36: .ad l
                     37: .\" -----------------------------------------------------------------
                     38: .\" * MAIN CONTENT STARTS HERE *
                     39: .\" -----------------------------------------------------------------
                     40: .SH "NAME"
                     41: nslookup \- query Internet name servers interactively
                     42: .SH "SYNOPSIS"
                     43: .HP \w'\fBnslookup\fR\ 'u
                     44: \fBnslookup\fR [\fB\-option\fR] [name\ |\ \-] [server]
                     45: .SH "DESCRIPTION"
                     46: .PP
                     47: \fBNslookup\fR
                     48: is a program to query Internet domain name servers\&.
                     49: \fBNslookup\fR
                     50: 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 is used to print just the name and requested information for a host or domain\&.
                     51: .SH "ARGUMENTS"
                     52: .PP
                     53: Interactive mode is entered in the following cases:
                     54: .sp
                     55: .RS 4
                     56: .ie n \{\
                     57: \h'-04' 1.\h'+01'\c
                     58: .\}
                     59: .el \{\
                     60: .sp -1
                     61: .IP "  1." 4.2
                     62: .\}
                     63: when no arguments are given (the default name server will be used)
                     64: .RE
                     65: .sp
                     66: .RS 4
                     67: .ie n \{\
                     68: \h'-04' 2.\h'+01'\c
                     69: .\}
                     70: .el \{\
                     71: .sp -1
                     72: .IP "  2." 4.2
                     73: .\}
                     74: when the first argument is a hyphen (\-) and the second argument is the host name or Internet address of a name server\&.
                     75: .RE
                     76: .PP
                     77: 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\&.
                     78: .PP
                     79: 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, and the initial timeout to 10 seconds, type:
                     80: .sp
                     81: .if n \{\
                     82: .RS 4
                     83: .\}
                     84: .nf
                     85: nslookup \-query=hinfo  \-timeout=10
                     86: .fi
                     87: .if n \{\
                     88: .RE
                     89: .\}
                     90: .PP
                     91: The
                     92: \fB\-version\fR
                     93: option causes
                     94: \fBnslookup\fR
                     95: to print the version number and immediately exits\&.
                     96: .SH "INTERACTIVE COMMANDS"
                     97: .PP
                     98: \fBhost\fR [server]
                     99: .RS 4
                    100: Look up information for host using the current default server or using server, if specified\&. If host is an Internet address and the query type is A or PTR, the name of the host is returned\&. If host is a name and does not have a trailing period, the search list is used to qualify the name\&.
                    101: .sp
                    102: To look up a host not in the current domain, append a period to the name\&.
                    103: .RE
                    104: .PP
                    105: \fBserver\fR \fIdomain\fR
                    106: .RS 4
                    107: .RE
                    108: .PP
                    109: \fBlserver\fR \fIdomain\fR
                    110: .RS 4
                    111: Change the default server to
                    112: \fIdomain\fR;
                    113: \fBlserver\fR
                    114: uses the initial server to look up information about
                    115: \fIdomain\fR, while
                    116: \fBserver\fR
                    117: uses the current default server\&. If an authoritative answer can\*(Aqt be found, the names of servers that might have the answer are returned\&.
                    118: .RE
                    119: .PP
                    120: \fBroot\fR
                    121: .RS 4
                    122: not implemented
                    123: .RE
                    124: .PP
                    125: \fBfinger\fR
                    126: .RS 4
                    127: not implemented
                    128: .RE
                    129: .PP
                    130: \fBls\fR
                    131: .RS 4
                    132: not implemented
                    133: .RE
                    134: .PP
                    135: \fBview\fR
                    136: .RS 4
                    137: not implemented
                    138: .RE
                    139: .PP
                    140: \fBhelp\fR
                    141: .RS 4
                    142: not implemented
                    143: .RE
                    144: .PP
                    145: \fB?\fR
                    146: .RS 4
                    147: not implemented
                    148: .RE
                    149: .PP
                    150: \fBexit\fR
                    151: .RS 4
                    152: Exits the program\&.
                    153: .RE
                    154: .PP
                    155: \fBset\fR \fIkeyword\fR\fI[=value]\fR
                    156: .RS 4
                    157: This command is used to change state information that affects the lookups\&. Valid keywords are:
                    158: .PP
                    159: \fBall\fR
                    160: .RS 4
                    161: Prints the current values of the frequently used options to
                    162: \fBset\fR\&. Information about the current default server and host is also printed\&.
                    163: .RE
                    164: .PP
                    165: \fBclass=\fR\fIvalue\fR
                    166: .RS 4
                    167: Change the query class to one of:
                    168: .PP
                    169: \fBIN\fR
                    170: .RS 4
                    171: the Internet class
                    172: .RE
                    173: .PP
                    174: \fBCH\fR
                    175: .RS 4
                    176: the Chaos class
                    177: .RE
                    178: .PP
                    179: \fBHS\fR
                    180: .RS 4
                    181: the Hesiod class
                    182: .RE
                    183: .PP
                    184: \fBANY\fR
                    185: .RS 4
                    186: wildcard
                    187: .RE
                    188: .sp
                    189: The class specifies the protocol group of the information\&.
                    190: .sp
                    191: (Default = IN; abbreviation = cl)
                    192: .RE
                    193: .PP
                    194: \fB\fI[no]\fR\fR\fBdebug\fR
                    195: .RS 4
                    196: Turn on or off the display of the full response packet and any intermediate response packets when searching\&.
                    197: .sp
                    198: (Default = nodebug; abbreviation =
                    199: [no]deb)
                    200: .RE
                    201: .PP
                    202: \fB\fI[no]\fR\fR\fBd2\fR
                    203: .RS 4
                    204: Turn debugging mode on or off\&. This displays more about what nslookup is doing\&.
                    205: .sp
                    206: (Default = nod2)
                    207: .RE
                    208: .PP
                    209: \fBdomain=\fR\fIname\fR
                    210: .RS 4
                    211: Sets the search list to
                    212: \fIname\fR\&.
                    213: .RE
                    214: .PP
                    215: \fB\fI[no]\fR\fR\fBsearch\fR
                    216: .RS 4
                    217: If the lookup request contains at least one period but doesn\*(Aqt end with a trailing period, append the domain names in the domain search list to the request until an answer is received\&.
                    218: .sp
                    219: (Default = search)
                    220: .RE
                    221: .PP
                    222: \fBport=\fR\fIvalue\fR
                    223: .RS 4
                    224: Change the default TCP/UDP name server port to
                    225: \fIvalue\fR\&.
                    226: .sp
                    227: (Default = 53; abbreviation = po)
                    228: .RE
                    229: .PP
                    230: \fBquerytype=\fR\fIvalue\fR
                    231: .RS 4
                    232: .RE
                    233: .PP
                    234: \fBtype=\fR\fIvalue\fR
                    235: .RS 4
                    236: Change the type of the information query\&.
                    237: .sp
                    238: (Default = A; abbreviations = q, ty)
                    239: .RE
                    240: .PP
                    241: \fB\fI[no]\fR\fR\fBrecurse\fR
                    242: .RS 4
                    243: Tell the name server to query other servers if it does not have the information\&.
                    244: .sp
                    245: (Default = recurse; abbreviation = [no]rec)
                    246: .RE
                    247: .PP
                    248: \fBndots=\fR\fInumber\fR
                    249: .RS 4
                    250: Set the number of dots (label separators) in a domain that will disable searching\&. Absolute names always stop searching\&.
                    251: .RE
                    252: .PP
                    253: \fBretry=\fR\fInumber\fR
                    254: .RS 4
                    255: Set the number of retries to number\&.
                    256: .RE
                    257: .PP
                    258: \fBtimeout=\fR\fInumber\fR
                    259: .RS 4
                    260: Change the initial timeout interval for waiting for a reply to number seconds\&.
                    261: .RE
                    262: .PP
                    263: \fB\fI[no]\fR\fR\fBvc\fR
                    264: .RS 4
                    265: Always use a virtual circuit when sending requests to the server\&.
                    266: .sp
                    267: (Default = novc)
                    268: .RE
                    269: .PP
                    270: \fB\fI[no]\fR\fR\fBfail\fR
                    271: .RS 4
                    272: Try the next nameserver if a nameserver responds with SERVFAIL or a referral (nofail) or terminate query (fail) on such a response\&.
                    273: .sp
                    274: (Default = nofail)
                    275: .RE
                    276: .sp
                    277: .RE
                    278: .SH "RETURN VALUES"
                    279: .PP
                    280: \fBnslookup\fR
                    281: returns with an exit status of 1 if any query failed, and 0 otherwise\&.
1.3     ! christos  282: .SH "IDN SUPPORT"
        !           283: .PP
        !           284: If
        !           285: \fBnslookup\fR
        !           286: has been built with IDN (internationalized domain name) support, it can accept and display non\-ASCII domain names\&.
        !           287: \fBnslookup\fR
        !           288: appropriately converts character encoding of domain name before sending a request to DNS server or displaying a reply from the server\&. If you\*(Aqd like to turn off the IDN support for some reason, define the
        !           289: \fBIDN_DISABLE\fR
        !           290: environment variable\&. The IDN support is disabled if the variable is set when
        !           291: \fBnslookup\fR
        !           292: runs or when the standard output is not a tty\&.
1.1       christos  293: .SH "FILES"
                    294: .PP
                    295: /etc/resolv\&.conf
                    296: .SH "SEE ALSO"
                    297: .PP
                    298: \fBdig\fR(1),
                    299: \fBhost\fR(1),
                    300: \fBnamed\fR(8)\&.
                    301: .SH "AUTHOR"
                    302: .PP
                    303: \fBInternet Systems Consortium, Inc\&.\fR
                    304: .SH "COPYRIGHT"
                    305: .br
                    306: Copyright \(co 2004-2007, 2010, 2013-2018 Internet Systems Consortium, Inc. ("ISC")
                    307: .br

CVSweb <webmaster@jp.NetBSD.org>