All known gateways in TENEX/TOPS-20 INTERNET.GATEWAYS
                format.

   Remember that the server accepts only a single command line and
   returns only a single response before closing the connection.  HNAME
   and HADDR are useful for looking up a specific host by name or
   address; VERSION can be used by automated processes to see whether a
   "new" version of the host table exists without having to transfer the



 


RFC 953                                                     October 1985
Hostname Server


   whole table.  Note, however, that the returned version string is only
   guaranteed to be unique to each version, and nothing should currently
   be assumed about its format.

   Response Keys:

      ERR       entry not found, nature of error follows
      NET       entry found, rest of entry follows
      GATEWAY   entry found, rest of entry follows
      HOST      entry found, rest of entry follows
      DOMAIN    entry found, rest of entry follows
      BEGIN     followed by multiple entries
      END       done with BEGIN block of entries

   More keywords will be added as new needs are recognized.  A more
   detailed description of the allowed requests/responses follows.

QUERY/RESPONSE EXAMPLES

   1. HNAME Query - Given a name, find the entry or entries that match
   the name.  For example:

      HNAME SRI-NIC.ARPA 

         where  is a carriage return/ linefeed, and 'SRI-NIC.ARPA'
         is a host name

      The likely response is:

      HOST : 26.0.0.73, 10.0.0.51 : SRI-NIC.ARPA,SRI-NIC,NIC :
             DEC-2060 : TOPS20 : TCP/TELNET,TCP/SMTP,TCP/TIME,TCP/FTP,
             TCP/ECHO,ICMP :

      A response may stretch across more than one line.  Continuation
      lines always begin with at least one space.

   2. HADDR Query - Given an internet address (as specified in RFC 796)
   find the entry or entries that match that address. For example:

      HADDR 26.0.0.73 

         where  is a carriage return/ linefeed, and '26.0.0.73' is
         a host address.

      The likely response is the same as for the previous HNAME request.





 


RFC 953                                                     October 1985
Hostname Server


   3. ALL Query - Deliver the entire internet host table in a
   machine-readable form.  For example:

      ALL    ;where  is a carriage return/linefeed

      The likely response is the keyword 'BEGIN' followed by a colon
      ':', followed by the entire internet host table in the format
      specified in RFC-952, followed by 'END:'.

ERROR HANDLING

   ERR Reply - may occur on any query, and should be permitted in any
   access program using the name server.  Errors are of the form

      ERR :  :  :
        as in
      ERR : NAMNFD : Name not found :

   The error code is a unique descriptor, limited to 8 characters in
   length for any given error.  It may be used by the access program to
   identify the error and, in some cases, to handle it automatically.
   The string is an accompanying message for a given error for that case
   where the access program simply logs the error message.  Current
   codes and their associated interpretations are