diff options
author | aaron <> | 2000-04-18 03:01:33 +0000 |
---|---|---|
committer | aaron <> | 2000-04-18 03:01:33 +0000 |
commit | 6e79b911ce0057b5b91d0f9cedd766e0163fb043 (patch) | |
tree | 9478c878ca3f3846100f116eeb1bed16f321f335 /src/lib/libc/net/inet.3 | |
parent | 59ca3f5f8991ab72904434fb49ef0999d64ae2e8 (diff) | |
download | openbsd-6e79b911ce0057b5b91d0f9cedd766e0163fb043.tar.gz openbsd-6e79b911ce0057b5b91d0f9cedd766e0163fb043.tar.bz2 openbsd-6e79b911ce0057b5b91d0f9cedd766e0163fb043.zip |
Repairs, mostly removing hard sentence breaks.
Diffstat (limited to 'src/lib/libc/net/inet.3')
-rw-r--r-- | src/lib/libc/net/inet.3 | 45 |
1 files changed, 28 insertions, 17 deletions
diff --git a/src/lib/libc/net/inet.3 b/src/lib/libc/net/inet.3 index 1e38bdc056..eb95f6c364 100644 --- a/src/lib/libc/net/inet.3 +++ b/src/lib/libc/net/inet.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: inet.3,v 1.8 1999/07/05 04:40:59 aaron Exp $ | 1 | .\" $OpenBSD: inet.3,v 1.9 2000/04/18 03:01:32 aaron Exp $ |
2 | .\" $NetBSD: inet.3,v 1.7 1997/06/18 02:25:24 lukem Exp $ | 2 | .\" $NetBSD: inet.3,v 1.7 1997/06/18 02:25:24 lukem Exp $ |
3 | .\" | 3 | .\" |
4 | .\" Copyright (c) 1983, 1990, 1991, 1993 | 4 | .\" Copyright (c) 1983, 1990, 1991, 1993 |
@@ -85,12 +85,13 @@ The | |||
85 | function converts a presentation format address (that is, printable form | 85 | function converts a presentation format address (that is, printable form |
86 | as held in a character string) to network format (usually a | 86 | as held in a character string) to network format (usually a |
87 | .Li struct in_addr | 87 | .Li struct in_addr |
88 | or some other internal binary representation, in network byte order). It | 88 | or some other internal binary representation, in network byte order). |
89 | returns 1 if the address was valid for the specified address family, or | 89 | It returns 1 if the address was valid for the specified address family, or |
90 | 0 if the address wasn't parseable in the specified address family, or \-1 | 90 | 0 if the address wasn't parseable in the specified address family, or \-1 |
91 | if some system error occurred (in which case | 91 | if some system error occurred (in which case |
92 | .Va errno | 92 | .Va errno |
93 | will have been set). This function is presently valid for | 93 | will have been set). |
94 | This function is presently valid for | ||
94 | .Dv AF_INET | 95 | .Dv AF_INET |
95 | and | 96 | and |
96 | .Dv AF_INET6 . | 97 | .Dv AF_INET6 . |
@@ -113,7 +114,8 @@ The function | |||
113 | converts an address from network format (usually a | 114 | converts an address from network format (usually a |
114 | .Li struct in_addr | 115 | .Li struct in_addr |
115 | or some other binary form, in network byte order) to presentation format | 116 | or some other binary form, in network byte order) to presentation format |
116 | (suitable for external display purposes). It returns | 117 | (suitable for external display purposes). |
118 | It returns | ||
117 | .Dv NULL | 119 | .Dv NULL |
118 | if a system | 120 | if a system |
119 | error occurs (in which case, | 121 | error occurs (in which case, |
@@ -125,11 +127,13 @@ takes an Internet address and returns an | |||
125 | .Tn ASCII | 127 | .Tn ASCII |
126 | string representing the address in | 128 | string representing the address in |
127 | .Ql \&. | 129 | .Ql \&. |
128 | notation. The routine | 130 | notation. |
131 | The routine | ||
129 | .Fn inet_makeaddr | 132 | .Fn inet_makeaddr |
130 | takes an Internet network number and a local | 133 | takes an Internet network number and a local |
131 | network address and constructs an Internet address | 134 | network address and constructs an Internet address |
132 | from it. The routines | 135 | from it. |
136 | The routines | ||
133 | .Fn inet_netof | 137 | .Fn inet_netof |
134 | and | 138 | and |
135 | .Fn inet_lnaof | 139 | .Fn inet_lnaof |
@@ -155,8 +159,8 @@ a | |||
155 | .Pp | 159 | .Pp |
156 | When four parts are specified, each is interpreted | 160 | When four parts are specified, each is interpreted |
157 | as a byte of data and assigned, from left to right, | 161 | as a byte of data and assigned, from left to right, |
158 | to the four bytes of an Internet address. Note | 162 | to the four bytes of an Internet address. |
159 | that when an Internet address is viewed as a 32-bit | 163 | Note that when an Internet address is viewed as a 32-bit |
160 | integer quantity on a system that uses little-endian | 164 | integer quantity on a system that uses little-endian |
161 | byte order (such as the | 165 | byte order (such as the |
162 | .Tn Intel 386, 486 | 166 | .Tn Intel 386, 486 |
@@ -214,16 +218,20 @@ every field (except for the case described in 2.). | |||
214 | .It | 218 | .It |
215 | Due to the method of allocating certain styles of IPv6 | 219 | Due to the method of allocating certain styles of IPv6 |
216 | addresses, it will be common for addresses to contain long | 220 | addresses, it will be common for addresses to contain long |
217 | strings of zero bits. In order to make writing addresses | 221 | strings of zero bits. |
222 | In order to make writing addresses | ||
218 | .Pp | 223 | .Pp |
219 | containing zero bits easier a special syntax is available to | 224 | containing zero bits easier a special syntax is available to |
220 | compress the zeros. The use of | 225 | compress the zeros. |
226 | The use of | ||
221 | .Dq \&:\&: | 227 | .Dq \&:\&: |
222 | indicates multiple groups | 228 | indicates multiple groups |
223 | of 16 bits of zeros. The | 229 | of 16 bits of zeros. |
230 | The | ||
224 | .Dq \&:\&: | 231 | .Dq \&:\&: |
225 | can only appear once in an | 232 | can only appear once in an |
226 | address. The | 233 | address. |
234 | The | ||
227 | .Dq \&:\&: | 235 | .Dq \&:\&: |
228 | can also be used to compress the leading and/or trailing zeros in an address. | 236 | can also be used to compress the leading and/or trailing zeros in an address. |
229 | .Pp | 237 | .Pp |
@@ -248,7 +256,8 @@ dealing with a mixed environment of IPv4 and IPv6 nodes is | |||
248 | x:x:x:x:x:x:d.d.d.d, where the 'x's are the hexadecimal values | 256 | x:x:x:x:x:x:d.d.d.d, where the 'x's are the hexadecimal values |
249 | of the six high-order 16-bit pieces of the address, and the 'd's | 257 | of the six high-order 16-bit pieces of the address, and the 'd's |
250 | are the decimal values of the four low-order 8-bit pieces of the | 258 | are the decimal values of the four low-order 8-bit pieces of the |
251 | address (standard IPv4 representation). Examples: | 259 | address (standard IPv4 representation). |
260 | Examples: | ||
252 | .Bd -literal -offset indent | 261 | .Bd -literal -offset indent |
253 | 0:0:0:0:0:0:13.1.68.3 | 262 | 0:0:0:0:0:0:13.1.68.3 |
254 | 0:0:0:0:0:FFFF:129.144.52.38 | 263 | 0:0:0:0:0:FFFF:129.144.52.38 |
@@ -281,10 +290,12 @@ The | |||
281 | and | 290 | and |
282 | .Nm inet_pton | 291 | .Nm inet_pton |
283 | functions conforms to the IETF IPng BSD API and address formatting | 292 | functions conforms to the IETF IPng BSD API and address formatting |
284 | specifications. Note that | 293 | specifications. |
294 | Note that | ||
285 | .Nm inet_pton | 295 | .Nm inet_pton |
286 | does not accept 1-, 2-, or 3-part dotted addresses; all four parts | 296 | does not accept 1-, 2-, or 3-part dotted addresses; all four parts |
287 | must be specified. This is a narrower input set than that accepted by | 297 | must be specified. |
298 | This is a narrower input set than that accepted by | ||
288 | .Nm inet_aton . | 299 | .Nm inet_aton . |
289 | .Sh HISTORY | 300 | .Sh HISTORY |
290 | The | 301 | The |