


NSLOOKUP(1M)          Maintenance Commands           NSLOOKUP(1M)



NNNNAAAAMMMMEEEE
     nslookup - query Internet name servers interactively

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     nnnnssssllllooooooookkkkuuuupppp [ -_o_p_t_i_o_n ... ] [ _h_o_s_t-_t_o-_f_i_n_d | - [ _s_e_r_v_e_r ]]

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     _N_s_l_o_o_k_u_p 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.


AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
     Interactive mode is entered in the following cases:

     a)  when no arguments are given  (the  default  name  server
         will be used),

     b)  when the first argument is a hyphen (-) and  the  second
         argument  is the host name or Internet address of a name
         server.

     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 direc-
     tory 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:
9          nslookup -query=hinfo  -timeout=10
9
IIIINNNNTTTTEEEERRRRAAAACCCCTTTTIIIIVVVVEEEE CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
     Commands  may  be  interrupted  at  any  time  by  typing  a
     control-C.   To  exit,  type a control-D (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NNN....BBBB.... an unrecognized  command  will
     be interpreted as a host name.
9
     _h_o_s_t [_s_e_r_v_e_r]
          Look up information for _h_o_s_t using the current  default
          server  or  using  _s_e_r_v_e_r  if specified.  If _h_o_s_t is an



SunOS 5.5.1          Last change: June 24, 1990                   1


9


NSLOOKUP(1M)          Maintenance Commands           NSLOOKUP(1M)



          Internet address and the query type is A  or  PTR,  the
          name  of  the  host is returned.  If _h_o_s_t 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 sssseeeetttt options ddddoooommmmaaaaiiiinnnn, ssssrrrrcccchhhhlllliiiisssstttt, ddddeeeeffffnnnnaaaammmmeeee,
          and  sssseeeeaaaarrrrcccchhhh).   To  look  up  a host not in the current
          domain, append a period to the name.


     sssseeeerrrrvvvveeeerrrr _d_o_m_a_i_n
     llllsssseeeerrrrvvvveeeerrrr _d_o_m_a_i_n
          Change the default server to _d_o_m_a_i_n. LLLLsssseeeerrrrvvvveeeerrrr  uses  the
          initial  server  to  look  up  information about _d_o_m_a_i_n
          while sssseeeerrrrvvvveeeerrrr uses the current  default  server.  If  an
          authoritative  answer  can't  be  found,  the  names of
          servers that might have the answer are returned.


     rrrrooooooootttt Changes the default server to the server for  the  root
          of   the   domain  name  space.   Currently,  the  host
          ns.internic.net is used.  (This command  is  a  synonym
          for  llllsssseeeerrrrvvvveeeerrrr  nnnnssss....iiiinnnntttteeeerrrrnnnniiiicccc....nnnneeeetttt....)   The  name of the root
          server can be changed with the sssseeeetttt rrrrooooooootttt command.


     ffffiiiinnnnggggeeeerrrr [_n_a_m_e] [>>>> _f_i_l_e_n_a_m_e]
     ffffiiiinnnnggggeeeerrrr [_n_a_m_e] [>>>>>>>> _f_i_l_e_n_a_m_e]
          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 sssseeeetttt qqqquuuueeeerrrryyyyttttyyyyppppeeee====AAAA command).  _N_a_m_e is optional. >>>>
          and >>>>>>>> can be used to  redirect  output  in  the  usual
          manner.


     llllssss [_o_p_t_i_o_n] _d_o_m_a_i_n [>>>> _f_i_l_e_n_a_m_e]
     llllssss [_o_p_t_i_o_n] _d_o_m_a_i_n [>>>>>>>> _f_i_l_e_n_a_m_e]
          List the information available for  _d_o_m_a_i_n,  optionally
          creating  or appending to _f_i_l_e_n_a_m_e.  The default output
          contains  host  names  and  their  Internet  addresses.
          _O_p_t_i_o_n can be one of the following:

          ----tttt _q_u_e_r_y_t_y_p_e
              lists  all  records  of  the  specified  type  (see
              _q_u_e_r_y_t_y_p_e below).

          ----aaaa   lists aliases of hosts in the domain. synonym  for
              ----tttt  CCCCNNNNAAAAMMMMEEEE.

          ----dddd   lists all records for the domain.  synonym  for  ----
              tttt  AAAANNNNYYYY.




SunOS 5.5.1          Last change: June 24, 1990                   2






NSLOOKUP(1M)          Maintenance Commands           NSLOOKUP(1M)



          ----hhhh   lists CPU and operating system information for the
              domain.  synonym for ----tttt  HHHHIIIINNNNFFFFOOOO.

          ----ssss   lists well-known services of hosts in the  domain.
              synonym for ----tttt  WWWWKKKKSSSS.

          When output is directed  to  a  file,  hash  marks  are
          printed for every 50 records received from the server.


     vvvviiiieeeewwww _f_i_l_e_n_a_m_e
          Sorts and lists the output of  previous  llllssss  command(s)
          with _m_o_r_e(1).


     hhhheeeellllpppp

     ????    Prints a brief summary of commands.


     eeeexxxxiiiitttt Exits the program.


     sssseeeetttt _k_e_y_w_o_r_d[=_v_a_l_u_e]
          This command is used to change state  information  that
          affects the lookups.  Valid keywords are:

          aaaallllllll  Prints the current values of  the  frequently-used
               options  to  sssseeeetttt.   Information about the  current
               default server and host is also printed.

          ccccllllaaaassssssss====_v_a_l_u_e
               Change the query class to one of:

               IN        the Internet class.

               CHAOS     the Chaos class.

               HESIOD    the MIT Athena Hesiod class.

               ANY       wildcard (any of the above).

               The class specifies  the  protocol  group  of  the
               information.
               (Default = IN, abbreviation = cl)

          [[[[nnnnoooo]]]]ddddeeeebbbbuuuugggg
               Turn debugging mode on. A lot more information  is
               printed  about  the  packet sent to the server and
               the resulting answer.
               (Default = nodebug, abbreviation = [no]deb)




SunOS 5.5.1          Last change: June 24, 1990                   3






NSLOOKUP(1M)          Maintenance Commands           NSLOOKUP(1M)



          [[[[nnnnoooo]]]]dddd2222
               Turn exhaustive debugging  mode  on.   Essentially
               all fields of every packet are printed.
               (Default = nod2)

          ddddoooommmmaaaaiiiinnnn====_n_a_m_e
               Change  the  default  domain  name  to  _n_a_m_e.  The
               default  domain  name  is  appended  to  a  lookup
               request depending on the state of the ddddeeeeffffnnnnaaaammmmeeee  and
               sssseeeeaaaarrrrcccchhhh  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
               sssseeeetttt ssssrrrrcccchhhhlllliiiisssstttt command to specify a different  list.
               Use the sssseeeetttt aaaallllllll command to display the list.
               (Default = value from  hostname,  /etc/resolv.conf
               or LOCALDOMAIN, abbreviation = do)

          ssssrrrrcccchhhhlllliiiisssstttt====_n_a_m_e_1/_n_a_m_e_2/...
               Change the default domain name to  _n_a_m_e_1  and  the
               domain search list to _n_a_m_e_1, _n_a_m_e_2, etc. A maximum
               of 6 names separated by slashes (/) can be  speci-
               fied.  For example,
9                   set srchlist=lcs.MIT.EDU/ai.MIT.EDU/MIT.EDU
9               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  sssseeeetttt
               ddddoooommmmaaaaiiiinnnn  command.   Use  the  sssseeeetttt  aaaallllllll  command  to
               display the list.
               (Default    =    value    based    on    hostname,
               /etc/resolv.conf  or  LOCALDOMAIN,  abbreviation =
               srchl)

          [[[[nnnnoooo]]]]ddddeeeeffffnnnnaaaammmmeeee
               If set,  append  the  default  domain  name  to  a
               single-component  lookup  request  (i.e., one that
               does not contain a period).
               (Default = defname, abbreviation = [no]def)

          [[[[nnnnoooo]]]]sssseeeeaaaarrrrcccchhhh
               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.
               (Default = search, abbreviation = [no]sea)

          ppppoooorrrrtttt====_v_a_l_u_e
               Change the default TCP/UDP  name  server  port  to
               _v_a_l_u_e.
               (Default = 53, abbreviation = po)



SunOS 5.5.1          Last change: June 24, 1990                   4






NSLOOKUP(1M)          Maintenance Commands           NSLOOKUP(1M)



          qqqquuuueeeerrrryyyyttttyyyyppppeeee====_v_a_l_u_e
          ttttyyyyppppeeee====_v_a_l_u_e
               Change the type of information query to one of:

               A         the host's Internet address.

               CNAME     the canonical name for an alias.

               HINFO     the host CPU and operating system type.

               MINFO     the mailbox or mail list information.

               MX        the mail exchanger.

               NS        the name server for the named zone.

               PTR       the host name if the query is an  Inter-
                         net  address,  otherwise  the pointer to
                         other information.

               SOA       the   domain's    ``start-of-authority''
                         information.

               TXT       the text information.

               UINFO     the user information.

               WKS       the supported well-known services.

               Other types (ANY, AXFR,  MB,  MD,  MF,  NULL)  are
               described in the RFC-1035 document.
               (Default = A, abbreviations = q, ty)

          [[[[nnnnoooo]]]]rrrreeeeccccuuuurrrrsssseeee
               Tell the name server to query other servers if  it
               does not have the information.
               (Default = recurse, abbreviation = [no]rec)

          rrrreeeettttrrrryyyy====_n_u_m_b_e_r
               Set the number of retries to _n_u_m_b_e_r. When a  reply
               to  a  request  is  not  received within a certain
               amount of time (changed  with  sssseeeetttt  ttttiiiimmmmeeeeoooouuuutttt),  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)

          rrrrooooooootttt====_h_o_s_t
               Change the name of the root server to  _h_o_s_t.  This
               affects the rrrrooooooootttt command.
               (Default = ns.internic.net., abbreviation = ro)




SunOS 5.5.1          Last change: June 24, 1990                   5






NSLOOKUP(1M)          Maintenance Commands           NSLOOKUP(1M)



          ttttiiiimmmmeeeeoooouuuutttt====_n_u_m_b_e_r
               Change the initial timeout  interval  for  waiting
               for  a reply to _n_u_m_b_e_r seconds. Each retry doubles
               the timeout period.
               (Default = 5 seconds, abbreviation = ti)

          [[[[nnnnoooo]]]]vvvvcccc
               Always use a virtual circuit when sending requests
               to the server.
               (Default = novc, abbreviation = [no]v)

          [[[[nnnnoooo]]]]iiiiggggnnnnoooorrrreeeettttcccc
               Ignore packet truncation errors.
               (Default = noignoretc, abbreviation = [no]ig)

DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
     If the lookup request was not successful, an  error  message
     is printed.  Possible errors are:

     Timed out
          The server did not respond to a request after a certain
          amount  of  time (changed with sssseeeetttt ttttiiiimmmmeeeeoooouuuutttt====_v_a_l_u_e) and a
          certain   number   of   retries   (changed   with   sssseeeetttt
          rrrreeeettttrrrryyyy====_v_a_l_u_e).

     No response from server
          No name server is running on the server machine.

     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  sssseeeetttt
          qqqquuuueeeerrrryyyyttttyyyyppppeeee command.

     Non-existent domain
          The host or domain name does not exist.

     Connection refused
     Network is unreachable
          The connection to the name or finger server  could  not
          be  made  at  the  current  time.   This error commonly
          occurs with llllssss and ffffiiiinnnnggggeeeerrrr requests.

     Server failure
          The name server found an internal inconsistency in  its
          database and could not return a valid answer.

     Refused
          The name server refused to service the request.

     Format error
          The name server found that the request packet  was  not



SunOS 5.5.1          Last change: June 24, 1990                   6






NSLOOKUP(1M)          Maintenance Commands           NSLOOKUP(1M)



          in  the  proper  format.   It  may indicate an error in
          _n_s_l_o_o_k_u_p.


FFFFIIIILLLLEEEESSSS
     /etc/resolv.conf         initial     domain     name     and
                              name server addresses.
     $HOME/.nslookuprc        user's initial options.
     /usr/lib/nslookup.help   summary of commands.

EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
     HOSTALIASES    file containing host aliases.
     LOCALDOMAIN    overrides default domain.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     resolver(3n), resolver(4), in.named(1m),
     RFC-1034  ``Domain Names - Concepts and Facilities''
     RFC-1035  ``Domain Names  -  Implementation  and  Specifica-
     tion''

AAAAUUUUTTTTHHHHOOOORRRR
     Andrew Cherenson

































SunOS 5.5.1          Last change: June 24, 1990                   7



