home *** CD-ROM | disk | FTP | other *** search
/ Internet Standards / CD1.mdf / INET / NETINFO / HOSTSERV.TXT < prev    next >
Encoding:
Text File  |  1993-12-21  |  2.7 KB  |  62 lines
  1. [ netinfo/hostserver-instructions.txt ]                [ 12/93 SAB]
  2.  
  3. The DDN Hostname Server is a TCP-based host information program and
  4. protocol running on the NIC.DDN.MIL machine.  The function of this
  5. particular server is to deliver machine-readable name and address
  6. information describing the networks, gateways, hosts, and domains in
  7. the DDN environment.  Basic use of the DDN Hostname Server is
  8. documented in RFC 953, which is available via FTP from NIC.DDN.MIL
  9. as the file rfc/rfc953.txt.
  10.  
  11. To access this server from a program, establish a TCP connection to
  12. port 101 (decimal) at the service host, NIC.DDN.MIL (192.112.36.5).
  13. Send the information request (a single line), and read the resulting
  14. response.  The connection is closed by the server upon completion of
  15. the response, so only one request can be made for each connection.
  16.  
  17. For example:
  18.  
  19.      From Remote Host:  telnet NIC.DDN.MIL 101<Return>
  20.                         haddr 192.112.36.5<Return>
  21.  
  22. NIC response:
  23.  
  24.     HOST : 192.112.36.5 : NIC.DDN.MIL, DIIS.DDN.MIL : SUN : UNIX :
  25.     TCP/TELNET,TCP/FTP,TCP/SMTP :
  26.     Connection closed by foreign host.
  27.  
  28. The currently supported keywords are:
  29.  
  30. Keyword         Response
  31. -------         --------
  32. HELP            This info
  33. VERSION         "VERSION: <string>" where <string> will be different
  34.                         for each version of the host table.
  35. HNAME <hostname> One or more matching host table entries.
  36. HADDR <hostaddr> One or more matching host table entries.
  37. ALL             The entire host table.
  38. ALL-Z           The entire host table in Unix COMPRESS format.
  39. ALL-MIL         A host table of MILNET sites only.
  40.  
  41. DOMAINS         The entire top-level domain table (domains only).
  42. ALL-DOM         Both the entire domain table and the host table.
  43.  
  44. ALL-NETS        Just the NETWORK section of the host table.
  45.  
  46. The server accepts only a single command line and returns only a
  47. single response before closing the connection.  HNAME and HADDR are
  48. useful for looking up a specific host by name or address; VERSION can
  49. be used by automated processes to see whether a "new" version of the
  50. host table exists without having to transfer the whole table.  Note,
  51. however, that the returned version string is only guaranteed to be
  52. unique to each version, and nothing should currently be assumed about
  53. its format.
  54.  
  55. PLEASE NOTE: the Official DoD Internet Host Table is updated twice a
  56. week.  HNAME or HADDR may return information that is not yet
  57. incorporated into the latest host table.  Use VERSION number instead
  58. to verify whether you have the latest host table information.
  59.  
  60. Problems, complaints, or suggestions should be sent via electronic
  61. mail to HOSTMASTER@NIC.DDN.MIL.
  62.