| NSLOOKUP(8) | System Manager's Manual | NSLOOKUP(8) | 
nslookup —
| nslookup | [ -option...]
      [host-to-find |-[server]] | 
nslookup is a program to query Internet domain name
  servers. 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. Non-interactive mode is used to print just the name and requested
  information for a host or domain.
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.
The options listed under the
    “set” command below can be specified
    in the .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, and the
    initial timeout to 10 seconds, type:
nslookup -query=hinfo -timeout=10
EOF) or type 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
  (‘\’). N.B.: An unrecognized command will be
  interpreted as a host name.
A or PTR, the name of the
      host is returned. If 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 set
      options domain, srchlist,
      defname, and search.)
    To look up a host not in the current domain, append a period to the name.
server
    domainlserver
    domainlserver uses the initial server to look up
      information about domain, while
      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.rootns.internic.net is
      used. (This command is a synonym for “lserver
      ns.internic.net”.) The name of the root server can be
      changed with the “set root”
    command.finger
    [name] [>
    filename]finger
    [name] [>>
    filename]set
      querytype=A” command). The
      name is optional. > and
      >> can be used to redirect output in the
      usual manner.ls
    [option] domain
    [> filename]ls
    [option] domain
    [>> filename]-t
        querytype-a-t
          CNAME”.-d-t
          ANY”.-h-t
          HINFO”.-s-t
          WKS”.When output is directed to a file, hash marks are printed for every 50 records received from the server.
view
    filenamels
      command(s) with more(1).help?exitset
    keyword[=value]allset. Information about the current default
          server and host is also printed.class=valueINCHAOSHESIODANYThe class specifies the protocol group of the information.
(Default = IN; abbreviation =
            cl)
no]debug(Default = nodebug; abbreviation =
            [no]deb)
no]d2(Default = nod2)
domain=namedefname and
          search options. 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 “set srchlist” command
          to specify a different list. Use the “set
          all” command to display the list.
        (Default = value from
            hostname(1),
            /etc/resolv.conf, or
            LOCALDOMAIN; abbreviation =
            do)
srchlist=name1/name2/...
set srchlist=lcs.MIT.EDU/ai.MIT.EDU/MIT.EDU
        
        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 “set
            domain” command. Use the “set
            all” command to display the list.
(Default = value based on
            hostname(1),
            /etc/resolv.conf, or
            LOCALDOMAIN; abbreviation =
            srchl)
no]defname(Default = defname; abbreviation =
            [no]defname)
no]search(Default = search; abbreviation =
            [no]sea)
port=value(Default = 53; abbreviation =
          po)
querytype=valuetype=valueACNAMEHINFOMINFOMXNSPTRSOATXTUINFOWKSOther types (ANY,
            AXFR, MB,
            MD, MF,
            NULL) are described in the RFC-1035
            document.
(Default = A; abbreviations =
            q, ty)
no]recurse(Default = recurse; abbreviation =
            [no]rec)
retry=numberset 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.
        (Default = 4, abbreviation =
          ret)
ndots=numberroot=hostroot” command.
        (Default = ns.internic.net.;
            abbreviation = ro)
timeout=number(Default = 5 seconds; abbreviation =
            ti)
no]vc(Default = novc; abbreviation =
            [no]v)
no]ignoretc(Default = noignoretc;
            abbreviation =
            [no]ig)
no]failSERVFAIL or a referral (nofail), or terminates
          the query (fail) on such a response.
        The default is nofail.
nslookup has been built with IDN (internationalized
  domain name) support, it can accept and display non-ASCII domain names.
  nslookup appropriately converts character encoding of
  a domain name before sending a request to a DNS server or displaying a reply
  from the server. To turn off IDN support, define the IDN_DISABLE environment
  variable. IDN support is disabled if the variable is set when
  nslookup runs, or when the standard output is not a
  tty.
HOSTALIASESLOCALDOMAINIDN_DISABLEnslookup returns with an exit status of
  1 if any query failed, and 0
  otherwise.
Timed
    outset
      timeout=value”) and a certain number
      of retries (changed with “set
      retry=value”).No
    response from serverNo
    recordsset querytype”
    command.Non-existent
    domainConnection
    refusedNetwork
    is unreachablels
      and finger requests.Server
    failureRefusedFormat
    errornslookup.P.V. Mockapetris, Domain Names - Concepts and Facilities, RFC 1034, Nov 1, 1987.
P.V. Mockapetris, Domain Names - Implementation and Specification, RFC 1035, Nov 1, 1987.
| June 24, 1990 | NetBSD 10.1 |