home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 4 / 4030 / nslook.1 < prev    next >
Encoding:
Text File  |  1991-09-10  |  2.1 KB  |  91 lines
  1. ..TH NSLOOK 1 "Sep 10, 1991"
  2. ..UC 4
  3. ..SH NAME
  4. nslook \- name server lookup
  5. ..SH SYNOPSIS
  6. ..B nslook
  7. [
  8. ..B \-l
  9. ]
  10. ..I hostname
  11. ..br
  12. ..B nslook
  13. [
  14. ..B \-l
  15. ]
  16. ..B \-a
  17. ..I IP-address
  18. ..br
  19. ..SH DESCRIPTION
  20. ..B Nslook 
  21. provides a simple way to retrieve an IP address or a host name
  22. from the Domain Name Service. The command
  23. ..PP
  24. ..ti +10n
  25. \fC nslook \fP
  26. ..I hostname
  27. ..PP
  28. prints the IP address of
  29. ..I hostname
  30. on standard output (and nothing else). The command
  31. ..PP
  32. ..ti +10n
  33. \fC nslook \-a \fP
  34. ..I IP-address
  35. ..PP
  36. prints the official name of the Internet host with the specified
  37. ..I IP-address
  38. on standard output.
  39. ..PP
  40. If the
  41. ..B \-l
  42. flag is given, 
  43. ..B nslook
  44. gives a long format display, showing the hosts official name, zero or
  45. more aliases, and one or more IP addresses.
  46. ..PP
  47. ..SH DIAGNOSTICS
  48. The diagnostics of 
  49. ..B nslook
  50. correspond to the errors signalled by
  51. gethostbyname(3) and gethostbyaddr(3).
  52. ..TP
  53. \fC unknown host \fP
  54. ..TP
  55. \fC temporary error -- try again later \fP
  56. This usually indicates that the local server did not receive
  57. a response from an authoritative server.
  58. A retry at some later time may succeed.
  59. ..TP
  60. \fC unrecoverable error \fP
  61. Some unexpected server failure was encountered.
  62. ..TP
  63. \fC no IP address \fP
  64. The requested name is valid but does not have an IP address; 
  65. this is not a temporary error.  
  66. This means that the name is known to the name server but there is no address
  67. associated with this name.
  68. Another type of request to the name server using this domain name
  69. will result in an answer;
  70. for example, a mail-forwarder may be registered for this domain.
  71. ..PP
  72. If one of these errors occurs, 
  73. ..B nslook
  74. returns an exit code of 1.
  75. ..SH "SEE ALSO"
  76. nslookup(1), gethostbyaddr(3), gethostbyname(3)
  77. ..SH BUGS
  78. Normally
  79. ..B nslook
  80. does not list alias hostnames since it only uses the information given 
  81. by gethostbyname(3) or gethostbyaddr(3).
  82. ..PP
  83. If 
  84. ..B nslook
  85. tries to find the address of a non-existent host in the local domain, 
  86. the error ``no IP address'' is signalled. This is due to the return code 
  87. of gethostbyname(3).
  88. ..PP
  89. ..SH AUTHOR
  90. Juergen Nickelsen  <nickel@cs.tu-berlin.de>
  91.