diff options
Diffstat (limited to 'src/lib/libc/net/gethostbyname.3')
-rw-r--r-- | src/lib/libc/net/gethostbyname.3 | 34 |
1 files changed, 17 insertions, 17 deletions
diff --git a/src/lib/libc/net/gethostbyname.3 b/src/lib/libc/net/gethostbyname.3 index a71048779b..4465fa5734 100644 --- a/src/lib/libc/net/gethostbyname.3 +++ b/src/lib/libc/net/gethostbyname.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: gethostbyname.3,v 1.11 1999/05/21 18:18:09 deraadt Exp $ | 1 | .\" $OpenBSD: gethostbyname.3,v 1.12 1999/07/05 04:40:59 aaron Exp $ |
2 | .\" | 2 | .\" |
3 | .\" Copyright (c) 1983, 1987, 1991, 1993 | 3 | .\" Copyright (c) 1983, 1987, 1991, 1993 |
4 | .\" The Regents of the University of California. All rights reserved. | 4 | .\" The Regents of the University of California. All rights reserved. |
@@ -72,11 +72,11 @@ functions | |||
72 | each return a pointer to an object with the | 72 | each return a pointer to an object with the |
73 | following structure describing an internet host | 73 | following structure describing an internet host |
74 | referenced by name or by address, respectively. | 74 | referenced by name or by address, respectively. |
75 | This structure contains either information obtained from the name server (ie. | 75 | This structure contains either information obtained from the name server (i.e., |
76 | .Xr resolver 3 | 76 | .Xr resolver 3 |
77 | and | 77 | and |
78 | .Xr named 8 ), Ns | 78 | .Xr named 8 ), |
79 | broken-out fields from a line in | 79 | broken-out fields from a line in |
80 | .Pa /etc/hosts , | 80 | .Pa /etc/hosts , |
81 | or database entries supplied by the | 81 | or database entries supplied by the |
82 | .Xr yp 8 | 82 | .Xr yp 8 |
@@ -99,13 +99,13 @@ The members of this structure are: | |||
99 | .It Fa h_name | 99 | .It Fa h_name |
100 | Official name of the host. | 100 | Official name of the host. |
101 | .It Fa h_aliases | 101 | .It Fa h_aliases |
102 | A zero terminated array of alternate names for the host. | 102 | A zero-terminated array of alternate names for the host. |
103 | .It Fa h_addrtype | 103 | .It Fa h_addrtype |
104 | The type of address being returned. | 104 | The type of address being returned. |
105 | .It Fa h_length | 105 | .It Fa h_length |
106 | The length, in bytes, of the address. | 106 | The length, in bytes, of the address. |
107 | .It Fa h_addr_list | 107 | .It Fa h_addr_list |
108 | A zero terminated array of network addresses for the host. | 108 | A zero-terminated array of network addresses for the host. |
109 | Host addresses are returned in network byte order. | 109 | Host addresses are returned in network byte order. |
110 | .It Fa h_addr | 110 | .It Fa h_addr |
111 | The first address in | 111 | The first address in |
@@ -132,9 +132,9 @@ for example | |||
132 | The | 132 | The |
133 | .Fn gethostbyaddr | 133 | .Fn gethostbyaddr |
134 | function will search for the specified address of length | 134 | function will search for the specified address of length |
135 | .Dv len | 135 | .Fa len |
136 | in the address family | 136 | in the address family |
137 | .Dv af . | 137 | .Fa af . |
138 | The only address family currently supported is | 138 | The only address family currently supported is |
139 | .Dv AF_INET . | 139 | .Dv AF_INET . |
140 | .Pp | 140 | .Pp |
@@ -149,7 +149,7 @@ If the | |||
149 | flag is non-zero, | 149 | flag is non-zero, |
150 | this sets the option to send all queries to the name server using | 150 | this sets the option to send all queries to the name server using |
151 | .Tn TCP | 151 | .Tn TCP |
152 | and to retain the connection after each call to | 152 | and to retain the connection after each call to |
153 | .Fn gethostbyname | 153 | .Fn gethostbyname |
154 | or | 154 | or |
155 | .Fn gethostbyaddr . | 155 | .Fn gethostbyaddr . |
@@ -168,11 +168,11 @@ The | |||
168 | .Fn herror | 168 | .Fn herror |
169 | function prints an error message describing the failure. If its argument | 169 | function prints an error message describing the failure. If its argument |
170 | .Fa string | 170 | .Fa string |
171 | is | 171 | is non-null, |
172 | .Pf non Dv -NULL , | ||
173 | it is prepended to the message string and separated from it by a colon | 172 | it is prepended to the message string and separated from it by a colon |
173 | .Pq Ql \&: | ||
174 | and a space. The error message is printed with a trailing newline. | 174 | and a space. The error message is printed with a trailing newline. |
175 | The contents of the error message is the same as that returned by | 175 | The contents of the error message is the same as that returned by |
176 | .Fn hstrerror | 176 | .Fn hstrerror |
177 | with argument | 177 | with argument |
178 | .Fa h_errno . | 178 | .Fa h_errno . |
@@ -182,7 +182,7 @@ with argument | |||
182 | .It Pa /etc/resolv.conf | 182 | .It Pa /etc/resolv.conf |
183 | .El | 183 | .El |
184 | .Sh DIAGNOSTICS | 184 | .Sh DIAGNOSTICS |
185 | Error return status from | 185 | Error return status from |
186 | .Fn gethostbyname , | 186 | .Fn gethostbyname , |
187 | .Fn gethostbyname2 , | 187 | .Fn gethostbyname2 , |
188 | and | 188 | and |
@@ -208,8 +208,8 @@ A retry at some later time may succeed. | |||
208 | Some unexpected server failure was encountered. | 208 | Some unexpected server failure was encountered. |
209 | This is a non-recoverable error. | 209 | This is a non-recoverable error. |
210 | .It Dv NO_DATA | 210 | .It Dv NO_DATA |
211 | The requested name is valid but does not have an IP address; | 211 | The requested name is valid but does not have an IP address; |
212 | this is not a temporary error. | 212 | this is not a temporary error. |
213 | This means that the name is known to the name server but there is no address | 213 | This means that the name is known to the name server but there is no address |
214 | associated with this name. | 214 | associated with this name. |
215 | Another type of request to the name server using this domain name | 215 | Another type of request to the name server using this domain name |
@@ -254,7 +254,7 @@ closes the file. | |||
254 | .Sh HISTORY | 254 | .Sh HISTORY |
255 | The | 255 | The |
256 | .Fn herror | 256 | .Fn herror |
257 | function appeared in | 257 | function appeared in |
258 | .Bx 4.3 . | 258 | .Bx 4.3 . |
259 | The | 259 | The |
260 | .Fn endhostent , | 260 | .Fn endhostent , |
@@ -272,7 +272,7 @@ copied before any subsequent calls overwrite it. | |||
272 | Only the Internet | 272 | Only the Internet |
273 | address formats are currently understood. | 273 | address formats are currently understood. |
274 | .Pp | 274 | .Pp |
275 | YP does not support any address families other than | 275 | YP does not support any address families other than |
276 | .Dv AF_INET | 276 | .Dv AF_INET |
277 | and uses | 277 | and uses |
278 | the traditional database format. | 278 | the traditional database format. |