Print this page
4775 Fixed formatting in getaddinfo(3) man page
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man3socket/getaddrinfo.3socket
+++ new/usr/src/man/man3socket/getaddrinfo.3socket
1 1 '\" te
2 2 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
3 3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
4 4 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
5 5 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 6 .TH GETADDRINFO 3SOCKET "May 8, 2009"
7 7 .SH NAME
8 8 getaddrinfo, getnameinfo, freeaddrinfo, gai_strerror \- translate between node
9 9 name and address
10 10 .SH SYNOPSIS
11 11 .LP
12 12 .nf
13 13 \fBcc\fR [ \fIflag\fR\&.\|.\|. ] \fIfile\fR \&.\|.\|. \fB-lsocket\fR \fB -lnsl \fR [ \fIlibrary\fR \&.\|.\|. ]
14 14 #include <sys/socket.h>
15 15 #include <netdb.h>
16 16
17 17 \fBint\fR \fBgetaddrinfo\fR(\fBconst char *\fR\fInodename\fR, \fBconst char *\fR\fIservname\fR,
18 18 \fBconst struct addrinfo *\fR\fIhints\fR, \fBstruct addrinfo **\fR\fIres\fR);
19 19 .fi
20 20
21 21 .LP
22 22 .nf
23 23 \fBint\fR \fBgetnameinfo\fR(\fBconst struct sockaddr *\fR\fIsa\fR, \fBsocklen_t\fR \fIsalen\fR,
24 24 \fBchar *\fR\fIhost\fR, \fBsize_t\fR \fIhostlen\fR, \fBchar *\fR\fIserv\fR, \fBsize_t\fR \fIservlen\fR,
25 25 \fBint\fR \fIflags\fR);
26 26 .fi
27 27
28 28 .LP
29 29 .nf
30 30 \fBvoid\fR \fBfreeaddrinfo\fR(\fBstruct addrinfo *\fR\fIai\fR);
31 31 .fi
32 32
33 33 .LP
34 34 .nf
35 35 \fBchar *\fR\fBgai_strerror\fR(\fBint\fR \fIerrcode\fR);
36 36 .fi
37 37
38 38 .SH DESCRIPTION
39 39 .sp
40 40 .LP
41 41 These functions perform translations from node name to address and from address
42 42 to node name in a protocol-independent manner.
43 43 .sp
44 44 .LP
45 45 The \fBgetaddrinfo()\fR function performs the node name to address translation.
46 46 The \fInodename\fR and \fIservname\fR arguments are pointers to null-terminated
47 47 strings or \fINULL\fR. One or both of these arguments must be a non-null
48 48 pointer. In the normal client scenario, both the \fInodename\fR and
49 49 \fIservname\fR are specified. In the normal server scenario, only the
50 50 \fIservname\fR is specified.
51 51 .sp
52 52 .LP
53 53 A non-null \fInodename\fR string can be a node name or a numeric host address
54 54 string. The \fInodename\fR can also be an IPv6 zone-id in the form:
55 55 .sp
56 56 .in +2
57 57 .nf
58 58 <address>%<zone-id>
59 59 .fi
60 60 .in -2
61 61
62 62 .sp
63 63 .LP
64 64 The address is the literal IPv6 link-local address or host name of the
65 65 destination. The zone-id is the interface ID of the IPv6 link used to send the
66 66 packet. The zone-id can either be a numeric value, indicating a literal zone
67 67 value, or an interface name such as \fBhme0\fR.
68 68 .sp
69 69 .LP
70 70 A non-null \fIservname\fR string can be either a service name or a decimal port
71 71 number.
72 72 .sp
73 73 .LP
74 74 The caller can optionally pass an \fBaddrinfo\fR structure, pointed to by the
75 75 \fIhints\fR argument, to provide hints concerning the type of socket that the
76 76 caller supports.
77 77 .sp
78 78 .LP
79 79 The \fBaddrinfo\fR structure is defined as:
80 80 .sp
81 81 .in +2
82 82 .nf
83 83 struct addrinfo {
84 84 int ai_flags; /* AI_PASSIVE, AI_CANONNAME,
85 85 AI_NUMERICHOST, AI_NUMERICSERV
86 86 AI_V4MAPPED, AI_ALL,
87 87 AI_ADDRCONFIG */
88 88 int ai_family; /* PF_xxx */
89 89 int ai_socktype; /* SOCK_xxx */
90 90 int ai_protocol; /* 0 or IPPROTO_xxx for IPv4 & IPv6 */
91 91 socklen_t ai_addrlen; /* length of ai_addr */
92 92 char *ai_canonname; /* canonical name for nodename */
93 93 struct sockaddr *ai_addr; /* binary address */
94 94 struct addrinfo *ai_next; /* next structure in linked list */
95 95 };
96 96 .fi
97 97 .in -2
98 98
99 99 .sp
100 100 .LP
101 101 In this \fIhints\fR structure, all members other than \fBai_flags\fR,
102 102 \fBai_family\fR, \fBai_socktype\fR, and \fBai_protocol\fR must be 0 or a null
103 103 pointer. A value of \fBPF_UNSPEC\fR for \fBai_family\fR indicates that the
104 104 caller will accept any protocol family. A value of 0 for \fBai_socktype\fR
105 105 indicates that the caller will accept any socket type. A value of 0 for
106 106 \fBai_protocol\fR indicates that the caller will accept any protocol. For
107 107 example, if the caller handles only TCP and not UDP, then the \fBai_socktype\fR
108 108 member of the \fIhints\fR structure should be set to \fBSOCK_STREAM\fR when
109 109 \fBgetaddrinfo()\fR is called. If the caller handles only IPv4 and not IPv6,
110 110 then the \fBai_family\fR member of the \fIhints\fR structure should be set to
111 111 \fBPF_INET\fR when \fBgetaddrinfo()\fR is called. If the third argument to
112 112 \fBgetaddrinfo()\fR is a null pointer, it is as if the caller had filled in an
113 113 \fBaddrinfo\fR structure initialized to 0 with \fBai_family\fR set to
114 114 \fBPF_UNSPEC\fR.
115 115 .sp
116 116 .LP
117 117 Upon success, a pointer to a linked list of one or more \fBaddrinfo\fR
118 118 structures is returned through the final argument. The caller can process each
119 119 \fBaddrinfo\fR structure in this list by following the \fBai_next\fR pointer,
120 120 until a null pointer is encountered. In each returned \fBaddrinfo\fR structure
121 121 the three members \fBai_family\fR, \fBai_socktype\fR, and \fBai_protocol\fR are
122 122 the corresponding arguments for a call to the \fBsocket\fR(3SOCKET) function.
123 123 In each \fBaddrinfo\fR structure the \fBai_addr\fR member points to a filled-in
124 124 socket address structure whose length is specified by the \fBai_addrlen\fR
125 125 member.
126 126 .sp
127 127 .LP
128 128 If the \fBAI_PASSIVE\fR bit is set in the \fBai_flags\fR member of the
129 129 \fIhints\fR structure, the caller plans to use the returned socket address
130 130 structure in a call to \fBbind\fR(3SOCKET). In this case, if the \fInodename\fR
131 131 argument is a null pointer, the IP address portion of the socket address
132 132 structure will be set to \fBINADDR_ANY\fR for an IPv4 address or
133 133 \fBIN6ADDR_ANY_INIT\fR for an IPv6 address.
134 134 .sp
135 135 .LP
136 136 If the \fBAI_PASSIVE\fR bit is not set in the \fBai_flags\fR member of the
137 137 \fIhints\fR structure, then the returned socket address structure will be ready
138 138 for a call to \fBconnect\fR(3SOCKET) (for a connection-oriented protocol) or
139 139 either \fBconnect\fR(3SOCKET), \fBsendto\fR(3SOCKET), or \fBsendmsg\fR(3SOCKET)
140 140 (for a connectionless protocol). If the \fInodename\fR argument is a null
141 141 pointer, the IP address portion of the socket address structure will be set to
142 142 the loopback address.
143 143 .sp
144 144 .LP
145 145 If the \fBAI_CANONNAME\fR bit is set in the \fBai_flags\fR member of the
146 146 \fIhints\fR structure, then upon successful return the \fBai_canonname\fR
147 147 member of the first \fBaddrinfo\fR structure in the linked list will point to a
148 148 null-terminated string containing the canonical name of the specified
149 149 \fInodename\fR. A numeric host address string is not a name, and thus does not
150 150 have a canonical name form; no address to host name translation is performed.
151 151 .sp
152 152 .LP
153 153 If the \fBAI_NUMERICHOST\fR bit is set in the \fBai_flags\fR member of the
154 154 \fIhints\fR structure, then a non-null \fInodename\fR string must be a numeric
155 155 host address string. Otherwise an error of \fBEAI_NONAME\fR is returned. This
156 156 flag prevents any type of name resolution service (such as DNS) from being
157 157 called.
158 158 .sp
159 159 .LP
160 160 If the \fBAI_NUMERICSERV\fR flag is specified, then a non-null servname string
161 161 supplied will be a numeric port string. Otherwise, an [\fBEAI_NONAME\fR] error
162 162 is returned. This flag prevents any type of name resolution service (for
163 163 example, NIS+) from being invoked.
164 164 .sp
165 165 .LP
166 166 If the \fBAI_V4MAPPED\fR flag is specified along with an \fBai_family\fR of
167 167 \fBAF_INET6\fR, then \fBgetaddrinfo()\fR returns IPv4-mapped IPv6 addresses on
168 168 finding no matching IPv6 addresses (\fBai_addrlen\fR shall be 16). For example,
169 169 if no AAAA records are found when using DNS, a query is made for A records. Any
170 170 found records are returned as IPv4-mapped IPv6 addresses.
171 171 .sp
172 172 .LP
173 173 The \fBAI_V4MAPPED\fR flag is ignored unless \fBai_family\fR equals
174 174 \fBAF_INET6\fR.
175 175 .sp
176 176 .LP
177 177 If the \fBAI_ALL\fR flag is used with the AI_V4MAPPED flag, then
178 178 \fBgetaddrinfo()\fR returns all matching IPv6 and IPv4 addresses. For example,
179 179 when using the DNS, queries are made for both AAAA records and A records, and
180 180 \fBgetaddrinfo()\fR returns the combined results of both queries. Any IPv4
181 181 addresses found are returned as IPv4-mapped IPv6 addresses.
182 182 .sp
183 183 .LP
184 184 The \fBAI_ALL\fR flag without the \fBAI_V4MAPPED\fR flag is ignored.
185 185 .sp
186 186 .LP
187 187 When \fBai_family\fR is not specified (\fBAF_UNSPEC\fR), \fBAI_V4MAPPED\fR and
188 188 \fBAI_ALL\fR flags are used only if \fBAF_INET6\fR is supported.
189 189 .sp
190 190 .LP
191 191 If the \fBAI_ADDRCONFIG\fR flag is specified, IPv4 addresses are returned only
192 192 if an IPv4 address is configured on the local system, and IPv6 addresses are
193 193 returned only if an IPv6 address is configured on the local system. For this
194 194 case, the loopback address is not considered to be as valid as a configured
195 195 address. For example, when using the DNS, a query for AAAA records should occur
196 196 only if the node has at least one IPv6 address configured (other than IPv6
197 197 loopback) and a query for A records should occur only if the node has at least
198 198 one IPv4 address configured (other than the IPv4 loopback).
199 199 .sp
200 200 .LP
201 201 All of the information returned by \fBgetaddrinfo()\fR is dynamically
202 202 allocated: the \fBaddrinfo\fR structures as well as the socket address
203 203 structures and canonical node name strings pointed to by the \fBaddrinfo\fR
204 204 structures. The \fBfreeaddrinfo()\fR function is called to return this
205 205 information to the system. For \fBfreeaddrinfo()\fR, the \fBaddrinfo\fR
206 206 structure pointed to by the \fIai\fR argument is freed, along with any dynamic
207 207 storage pointed to by the structure. This operation is repeated until a null
208 208 \fBai_next\fR pointer is encountered.
209 209 .sp
210 210 .LP
211 211 To aid applications in printing error messages based on the \fBEAI_\fR* codes
212 212 returned by \fBgetaddrinfo()\fR, the \fBgai_strerror()\fR is defined. The
213 213 argument is one of the \fBEAI_\fR* values defined below and the return value
214 214 points to a string describing the error. If the argument is not one of the
215 215 \fBEAI_\fR* values, the function still returns a pointer to a string whose
216 216 contents indicate an unknown error.
217 217 .sp
218 218 .LP
219 219 The \fBgetnameinfo()\fR function looks up an IP address and port number
220 220 provided by the caller in the name service database and system-specific
221 221 database, and returns text strings for both in buffers provided by the caller.
222 222 The function indicates successful completion by a 0 return value; a non-zero
223 223 return value indicates failure.
224 224 .sp
225 225 .LP
226 226 The first argument, \fIsa\fR, points to either a \fBsockaddr_in\fR structure
227 227 (for IPv4) or a \fBsockaddr_in6\fR structure (for IPv6) that holds the IP
228 228 address and port number. The \fIsalen\fR argument gives the length of the
229 229 \fBsockaddr_in\fR or \fBsockaddr_in6\fR structure.
230 230 .sp
231 231 .LP
232 232 The function returns the node name associated with the IP address in the buffer
233 233 pointed to by the \fIhost\fR argument.
234 234 .sp
235 235 .LP
236 236 The function can also return the IPv6 zone-id in the form:
237 237 .sp
238 238 .in +2
239 239 .nf
240 240 <address>%<zone-id>
241 241 .fi
242 242 .in -2
243 243
244 244 .sp
245 245 .LP
246 246 The caller provides the size of this buffer with the \fIhostlen\fR argument.
247 247 The service name associated with the port number is returned in the buffer
248 248 pointed to by \fIserv\fR, and the \fIservlen\fR argument gives the length of
249 249 this buffer. The caller specifies not to return either string by providing a 0
250 250 value for the \fIhostlen\fR or \fIservlen\fR arguments. Otherwise, the caller
251 251 must provide buffers large enough to hold the node name and the service name,
252 252 including the terminating null characters.
253 253 .sp
254 254 .LP
255 255 To aid the application in allocating buffers for these two returned strings,
256 256 the following constants are defined in <\fBnetdb.h\fR>:
257 257 .sp
258 258 .in +2
259 259 .nf
260 260 #define NI_MAXHOST 1025
261 261 #define NI_MAXSERV 32
262 262 .fi
263 263 .in -2
264 264
265 265 .sp
266 266 .LP
267 267 The final argument is a flag that changes the default actions of this function.
268 268 By default, the fully-qualified domain name (\fBFQDN\fR) for the host is looked
269 269 up in the name service database and returned. If the flag bit \fBNI_NOFQDN\fR
270 270 is set, only the node name portion of the \fBFQDN\fR is returned for local
271 271 hosts.
272 272 .sp
273 273 .LP
274 274 If the flag bit \fBNI_NUMERICHOST\fR is set, or if the host's name cannot be
275 275 located in the name service, the numeric form of the host's address is returned
276 276 instead of its name, for example, by calling \fBinet_ntop()\fR (see
277 277 \fBinet\fR(3SOCKET)) instead of \fBgetipnodebyname\fR(3SOCKET). If the flag bit
278 278 \fBNI_NAMEREQD\fR is set, an error is returned if the host's name cannot be
279 279 located in the name service database.
280 280 .sp
281 281 .LP
282 282 If the flag bit \fBNI_NUMERICSERV\fR is set, the numeric form of the service
283 283 address is returned (for example, its port number) instead of its name. The two
284 284 \fBNI_NUMERIC\fR* flags are required to support the \fB-n\fR flag that many
285 285 commands provide.
286 286 .sp
287 287 .LP
288 288 A fifth flag bit, \fBNI_DGRAM\fR, specifies that the service is a datagram
289 289 service, and causes \fBgetservbyport\fR(3SOCKET) to be called with a second
290 290 argument of \fBudp\fR instead of the default \fBtcp\fR. This is required for
291 291 the few ports (for example, 512-514) that have different services for UDP and
|
↓ open down ↓ |
291 lines elided |
↑ open up ↑ |
292 292 TCP.
293 293 .sp
294 294 .LP
295 295 These \fBNI_\fR* flags are defined in <\fBnetdb.h\fR> along with the \fBAI_\fR*
296 296 flags already defined for \fBgetaddrinfo()\fR.
297 297 .SH RETURN VALUES
298 298 .sp
299 299 .LP
300 300 For \fBgetaddrinfo()\fR, if the query is successful, a pointer to a linked list
301 301 of one or more \fBaddrinfo\fR structures is returned by the fourth argument and
302 -the function returns \fB0\fR. The order of the addresses returned i nthe fourth
302 +the function returns \fB0\fR. The order of the addresses returned in the fourth
303 303 argument is discussed in the ADDRESS ORDERING section. If the query fails, a
304 304 non-zero error code will be returned. For \fBgetnameinfo()\fR, if successful,
305 305 the strings hostname and service are copied into \fIhost\fR and \fIserv\fR,
306 306 respectively. If unsuccessful, zero values for either \fIhostlen\fR or
307 307 \fIservlen\fR will suppress the associated lookup; in this case no data is
308 308 copied into the applicable buffer. If \fBgai_strerror()\fR is successful, a
309 309 pointer to a string containing an error message appropriate for the \fBEAI_\fR*
310 310 errors is returned. If \fIerrcode\fR is not one of the \fBEAI_\fR* values, a
311 311 pointer to a string indicating an unknown error is returned.
312 312 .SS "Address Ordering"
313 313 .sp
314 314 .LP
315 315 AF_INET6 addresses returned by the fourth argument of \fBgetaddrinfo()\fR are
316 316 ordered according to the algorithm described in \fIRFC 3484, Default Address
317 317 Selection for Internet Protocol version 6 (IPv6)\fR. The addresses are ordered
318 318 using a list of pair-wise comparison rules which are applied in order. If a
319 319 rule determines that one address is better than another, the remaining rules
320 320 are irrelevant to the comparison of those two addresses. If two addresses are
321 321 equivalent according to one rule, the remaining rules act as a tie-breaker. The
322 322 address ordering list of pair-wise comparison rules follow below:
323 323 .sp
324 324
325 325 .sp
326 326 .TS
327 327 box;
328 328 l | l
329 329 l | l .
330 330 Avoid unusable destinations. T{
331 331 Prefer a destination that is reachable through the IP routing table.
332 332 T}
333 333 _
334 334 Prefer matching scope. T{
335 335 Prefer a destination whose scope is equal to the scope of its source address. See \fBinet6\fR(7P) for the definition of scope used by this rule.
336 336 T}
337 337 _
338 338 Avoid link-local source. T{
339 339 Avoid selecting a link-local source address when the destination address is not a link-local address.
340 340 T}
341 341 _
342 342 Avoid deprecated addresses. T{
343 343 Prefer a destination that is not deprecated (\fBIFF_DEPRECATED\fR).
344 344 T}
345 345 _
346 346 T{
347 347 Prefer matching label. This rule uses labels that are obtained through the IPv6 default address selection policy table. See \fBipaddrsel\fR(1M) for a description of the default contents of the table and how the table is configured.
348 348 T} T{
349 349 Prefer a destination whose label is equal to the label of its source address.
350 350 T}
351 351 _
352 352 T{
353 353 Prefer higher precedence. This rule uses precedence values that are obtained through the IPv6 default address selection policy table. See \fBipaddrsel\fR(1M) for a description of the default contents of the table and how the table is configured.
354 354 T} T{
355 355 Prefer the destination whose precedence is higher than the other destination.
356 356 T}
357 357 _
358 358 Prefer native transport. T{
359 359 Prefer a destination if the interface that is used for sending packets to that destination is not an IP over IP tunnel.
360 360 T}
361 361 _
362 362 T{
363 363 Prefer smaller scope. See \fBinet6\fR(7P) for the definition of this rule.
364 364 T} T{
365 365 Prefer the destination whose scope is smaller than the other destination.
366 366 T}
367 367 _
368 368 Use longest matching prefix. T{
369 369 When the two destinations belong to the same address family, prefer the destination that has the longer matching prefix with its source address.
370 370 T}
371 371 .TE
372 372
373 373 .SH ERRORS
374 374 .sp
375 375 .LP
376 376 The following names are the error values returned by \fBgetaddrinfo()\fR and
377 377 are defined in <\fBnetdb.h\fR>:
378 378 .sp
379 379 .ne 2
380 380 .na
381 381 \fB\fBEAI_ADDRFAMILY\fR\fR
382 382 .ad
383 383 .RS 18n
384 384 Address family for nodename is not supported.
385 385 .RE
386 386
387 387 .sp
388 388 .ne 2
389 389 .na
390 390 \fB\fBEAI_AGAIN\fR\fR
391 391 .ad
392 392 .RS 18n
393 393 Temporary failure in name resolution has occurred .
394 394 .RE
395 395
396 396 .sp
397 397 .ne 2
398 398 .na
399 399 \fB\fBEAI_BADFLAGS\fR\fR
400 400 .ad
401 401 .RS 18n
402 402 Invalid value specified for \fBai_flags\fR.
403 403 .RE
404 404
405 405 .sp
406 406 .ne 2
407 407 .na
408 408 \fB\fBEAI_FAIL\fR\fR
409 409 .ad
410 410 .RS 18n
411 411 Non-recoverable failure in name resolution has occurred.
412 412 .RE
413 413
414 414 .sp
415 415 .ne 2
416 416 .na
417 417 \fB\fBEAI_FAMILY\fR\fR
418 418 .ad
419 419 .RS 18n
420 420 The \fBai_family\fR is not supported.
421 421 .RE
422 422
423 423 .sp
424 424 .ne 2
425 425 .na
426 426 \fB\fBEAI_MEMORY\fR\fR
427 427 .ad
428 428 .RS 18n
429 429 Memory allocation failure has occurred.
430 430 .RE
431 431
432 432 .sp
433 433 .ne 2
434 434 .na
435 435 \fB\fBEAI_NODATA\fR\fR
436 436 .ad
437 437 .RS 18n
438 438 No address is associated with \fInodename\fR.
439 439 .RE
440 440
441 441 .sp
442 442 .ne 2
443 443 .na
444 444 \fB\fBEAI_NONAME\fR\fR
445 445 .ad
446 446 .RS 18n
447 447 Neither \fInodename\fR nor \fIservname\fR is provided or known.
448 448 .RE
449 449
450 450 .sp
451 451 .ne 2
452 452 .na
453 453 \fB\fBEAI_SERVICE\fR\fR
454 454 .ad
455 455 .RS 18n
456 456 The \fIservname\fR is not supported for \fBai_socktype\fR.
457 457 .RE
458 458
459 459 .sp
460 460 .ne 2
461 461 .na
462 462 \fB\fBEAI_SOCKTYPE\fR\fR
463 463 .ad
464 464 .RS 18n
465 465 The \fBai_socktype\fR is not supported.
466 466 .RE
467 467
468 468 .sp
469 469 .ne 2
470 470 .na
471 471 \fB\fBEAI_OVERFLOW\fR\fR
472 472 .ad
473 473 .RS 18n
474 474 Argument buffer has overflowed.
475 475 .RE
476 476
477 477 .sp
478 478 .ne 2
479 479 .na
480 480 \fB\fBEAI_SYSTEM\fR\fR
481 481 .ad
482 482 .RS 18n
483 483 System error was returned in \fIerrno\fR.
484 484 .RE
485 485
486 486 .SH FILES
487 487 .sp
488 488 .ne 2
489 489 .na
490 490 \fB\fB/etc/inet/hosts\fR\fR
491 491 .ad
492 492 .RS 22n
493 493 local database that associates names of nodes with IP addresses
494 494 .RE
495 495
496 496 .sp
497 497 .ne 2
498 498 .na
499 499 \fB\fB/etc/netconfig\fR\fR
500 500 .ad
501 501 .RS 22n
502 502 network configuration database
503 503 .RE
504 504
505 505 .sp
506 506 .ne 2
507 507 .na
508 508 \fB\fB/etc/nsswitch.conf\fR\fR
509 509 .ad
510 510 .RS 22n
511 511 configuration file for the name service switch
512 512 .RE
513 513
514 514 .SH ATTRIBUTES
515 515 .sp
516 516 .LP
517 517 See \fBattributes\fR(5) for description of the following attributes:
518 518 .sp
519 519
520 520 .sp
521 521 .TS
522 522 box;
523 523 c | c
524 524 l | l .
525 525 ATTRIBUTE TYPE ATTRIBUTE VALUE
526 526 _
527 527 Interface Stability Committed
528 528 _
529 529 MT-Level MT-Safe
530 530 _
531 531 Standard See \fBstandards\fR(5).
532 532 .TE
533 533
534 534 .SH SEE ALSO
535 535 .sp
536 536 .LP
537 537 \fBipaddrsel\fR(1M), \fBgethostbyname\fR(3NSL), \fBgetipnodebyname\fR(3SOCKET),
538 538 \fBhtonl\fR(3SOCKET), \fBinet\fR(3SOCKET), \fBnetdb.h\fR(3HEAD),
539 539 \fBsocket\fR(3SOCKET), \fBhosts\fR(4), \fBnsswitch.conf\fR(4),
540 540 \fBattributes\fR(5), \fBstandards\fR(5), \fBinet6\fR(7P)
541 541 .sp
542 542 .LP
543 543 Draves, R. \fIRFC 3484, Default Address Selection for Internet Protocol version
544 544 6 (IPv6)\fR. Network Working Group. February 2003.
545 545 .SH NOTES
546 546 .sp
547 547 .LP
548 548 IPv4-mapped addresses are not recommended.
|
↓ open down ↓ |
236 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX