home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / rfc / 900s / rfc953.txt < prev    next >
Text File  |  1992-09-21  |  8KB  |  284 lines
  1. Network Working Group                               K. Harrenstien (SRI)
  2. Request for Comments: 953                                 M. Stahl (SRI)
  3. Obsoletes:  RFC 811                                     E. Feinler (SRI)
  4.                                                             October 1985
  5.  
  6.                             HOSTNAME SERVER
  7.  
  8.  
  9. STATUS OF THIS MEMO
  10.  
  11.    This RFC is the official specification of the Hostname Server
  12.    Protocol.  This edition of the specification includes minor revisions
  13.    to RFC 811 which brings it up to date.  Distribution of this memo is
  14.    unlimited.
  15.  
  16. INTRODUCTION
  17.  
  18.    The NIC Internet Hostname Server is a TCP-based host information
  19.    program and protocol running on the SRI-NIC machine.  It is one of a
  20.    series of internet name services maintained by the DDN Network
  21.    Information Center (NIC) at SRI International on behalf of the
  22.    Defense Communications Agency (DCA).  The function of this particular
  23.    server is to deliver machine-readable name/address information
  24.    describing networks, gateways, hosts, and eventually domains, within
  25.    the internet environment.  As currently implemented, the server
  26.    provides the information outlined in the DoD Internet Host Table
  27.    Specification [See RFC-952].  For a discussion of future developments
  28.    see also RFC-921 concerning the Domain Name System.
  29.  
  30. PROTOCOL
  31.  
  32.    To access this server from a program, establish a TCP connection to
  33.    port 101 (decimal) at the service host, SRI-NIC.ARPA (26.0.0.73 or
  34.    10.0.0.51).  Send the information request (a single line), and read
  35.    the resulting response.  The connection is closed by the server upon
  36.    completion of the response, so only one request can be made for each
  37.    connection.
  38.  
  39. QUERY/RESPONSE FORMAT
  40.  
  41.    The name server accepts simple text query requests of the form
  42.  
  43.       <command key> <argument(s)> [<options>]
  44.  
  45.    where square brackets ("[]") indicate an optional field.  The command
  46.    key is a keyword indicating the nature of the request.  The defined
  47.    keys are explained below.
  48.  
  49.    The response, on the other hand, is of the form
  50.  
  51.       <response key> : <rest of response>
  52.  
  53.  
  54. Harrenstien & Stahl & Feinler                                   [Page 1]
  55.  
  56.  
  57.  
  58. RFC 953                                                     October 1985
  59. Hostname Server
  60.  
  61.  
  62.    where <response key> is a keyword indicating the nature of the
  63.    response, and the rest of the response is interpreted in the context
  64.    of the key.
  65.  
  66.    NOTE:  Care should be taken to interpret the nature of the reply
  67.    (e.g, single record or multiple record), so that no confusion about
  68.    the state of the reply results.  An "ALL" request will likely return
  69.    several hundred or more records of all types, whereas "HNAME" or
  70.    "HADDR" will usually return one HOST record.
  71.  
  72. COMMAND/RESPONSE KEYS
  73.  
  74.    The currently defined command keywords are listed below.  NOTE:
  75.    Because the server and the features available will evolve with time,
  76.    the HELP command should be used to obtain the most recent summary of
  77.    implemented features, changes, or new commands.
  78.  
  79.       Keyword   Response
  80.  
  81.       HELP      This information.
  82.  
  83.       VERSION   "VERSION: <string>" where <string> will be different for
  84.                 each version of the host table.
  85.  
  86.       HNAME <hostname>
  87.                 One or more matching host table entries.
  88.  
  89.       HADDR <hostaddr>
  90.                 One or more matching host table entries.
  91.  
  92.       ALL       The entire host table.
  93.  
  94.       ALL-OLD   The entire host table without domain style names.
  95.  
  96.       DOMAINS   The entire top-level domain table (domains only).
  97.  
  98.       ALL-DOM   Both the entire domain table and the host table.
  99.  
  100.       ALL-INGWAY
  101.                 All known gateways in TENEX/TOPS-20 INTERNET.GATEWAYS
  102.                 format.
  103.  
  104.    Remember that the server accepts only a single command line and
  105.    returns only a single response before closing the connection.  HNAME
  106.    and HADDR are useful for looking up a specific host by name or
  107.    address; VERSION can be used by automated processes to see whether a
  108.    "new" version of the host table exists without having to transfer the
  109.  
  110.  
  111. Harrenstien & Stahl & Feinler                                   [Page 2]
  112.  
  113.  
  114.  
  115. RFC 953                                                     October 1985
  116. Hostname Server
  117.  
  118.  
  119.    whole table.  Note, however, that the returned version string is only
  120.    guaranteed to be unique to each version, and nothing should currently
  121.    be assumed about its format.
  122.  
  123.    Response Keys:
  124.  
  125.       ERR       entry not found, nature of error follows
  126.       NET       entry found, rest of entry follows
  127.       GATEWAY   entry found, rest of entry follows
  128.       HOST      entry found, rest of entry follows
  129.       DOMAIN    entry found, rest of entry follows
  130.       BEGIN     followed by multiple entries
  131.       END       done with BEGIN block of entries
  132.  
  133.    More keywords will be added as new needs are recognized.  A more
  134.    detailed description of the allowed requests/responses follows.
  135.  
  136. QUERY/RESPONSE EXAMPLES
  137.  
  138.    1. HNAME Query - Given a name, find the entry or entries that match
  139.    the name.  For example:
  140.  
  141.       HNAME SRI-NIC.ARPA <CRLF>
  142.  
  143.          where <CRLF> is a carriage return/ linefeed, and 'SRI-NIC.ARPA'
  144.          is a host name
  145.  
  146.       The likely response is:
  147.  
  148.       HOST : 26.0.0.73, 10.0.0.51 : SRI-NIC.ARPA,SRI-NIC,NIC :
  149.              DEC-2060 : TOPS20 : TCP/TELNET,TCP/SMTP,TCP/TIME,TCP/FTP,
  150.              TCP/ECHO,ICMP :
  151.  
  152.       A response may stretch across more than one line.  Continuation
  153.       lines always begin with at least one space.
  154.  
  155.    2. HADDR Query - Given an internet address (as specified in RFC 796)
  156.    find the entry or entries that match that address. For example:
  157.  
  158.       HADDR 26.0.0.73 <CRLF>
  159.  
  160.          where <CRLF> is a carriage return/ linefeed, and '26.0.0.73' is
  161.          a host address.
  162.  
  163.       The likely response is the same as for the previous HNAME request.
  164.  
  165.  
  166.  
  167.  
  168. Harrenstien & Stahl & Feinler                                   [Page 3]
  169.  
  170.  
  171.  
  172. RFC 953                                                     October 1985
  173. Hostname Server
  174.  
  175.  
  176.    3. ALL Query - Deliver the entire internet host table in a
  177.    machine-readable form.  For example:
  178.  
  179.       ALL <CRLF>   ;where <CRLF> is a carriage return/linefeed
  180.  
  181.       The likely response is the keyword 'BEGIN' followed by a colon
  182.       ':', followed by the entire internet host table in the format
  183.       specified in RFC-952, followed by 'END:'.
  184.  
  185. ERROR HANDLING
  186.  
  187.    ERR Reply - may occur on any query, and should be permitted in any
  188.    access program using the name server.  Errors are of the form
  189.  
  190.       ERR : <code> : <string> :
  191.         as in
  192.       ERR : NAMNFD : Name not found :
  193.  
  194.    The error code is a unique descriptor, limited to 8 characters in
  195.    length for any given error.  It may be used by the access program to
  196.    identify the error and, in some cases, to handle it automatically.
  197.    The string is an accompanying message for a given error for that case
  198.    where the access program simply logs the error message.  Current
  199.    codes and their associated interpretations are
  200.  
  201.       NAMNFD    Name not found; name not in table
  202.       ADRNFD    Address not found; address not in table
  203.       ILLCOM    Illegal command; command key not recognized
  204.       TMPSYS    Temporary system failure, try again later
  205.  
  206. REFERENCES
  207.  
  208.    1. Harrenstien, K., Stahl, M., and Feinler, E., "Official DoD
  209.       Internet Host Table Specification," RFC-952, DDN Network
  210.       Information Center, SRI International, October 1985.
  211.  
  212.    2. Pickens, J., Feinler, E., and Mathis, J., "The NIC Name Server," A
  213.       Datagram-based Information Utility, RFC-756, Network Information
  214.       Center, SRI International, July 1979.
  215.  
  216.    3. Postel, J., "Address Mappings," RFC-796, Information Sciences
  217.       Institute, University of Southern California, Marina del Rey,
  218.       September 1981.
  219.  
  220.    4. Postel, J., "Domain Name System Implementation Schedule", RFC-921,
  221.       Information Sciences Institute, University of Southern California,
  222.       Marina del Rey, October 1984.
  223.  
  224.  
  225. Harrenstien & Stahl & Feinler                                   [Page 4]
  226.  
  227.  
  228.  
  229. RFC 953                                                     October 1985
  230. Hostname Server
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282. Harrenstien & Stahl & Feinler                                   [Page 5]
  283.  
  284.