diff options
Diffstat (limited to '')
| -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. |
