Lines Matching +full:c +full:- +full:family +full:- +full:name

2 .\" Copyright (c) 2001, the Institute of Electrical and Electronics Engineers, Inc. and The Open Group. All Rights Reserved.
3 .\" Portions Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved.
6 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
10 .\" 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 the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
12 .SH NAME
13 freeaddrinfo, getaddrinfo \- get address information
17 \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lxnet\fR [ \fIlibrary\fR ... ]
42 The \fBgetaddrinfo()\fR function translates the name of a service location (for
43 example, a host name) and/or a service name and returns a set of socket
49 pointers to null-terminated strings. One or both of these two arguments are
50 supplied by the application as a non-null pointer.
53 The format of a valid name depends on the address family or families. If a
54 specific family is not given and the name could be interpreted as valid within
55 multiple supported families, the implementation attempts to resolve the name in
60 If the \fInodename\fR argument is not null, it can be a descriptive name or can
61 be an address string. If the specified address family is \fBAF_INET\fR,
63 If the specified address family is \fBAF_INET\fR or \fBAF_UNSPEC\fR, address
68 If the specified address family is \fBAF_INET6\fR or \fBAF_UNSPEC\fR, standard
77 If \fIservname\fR is null, the call returns network-level addresses for the
79 null-terminated character string identifying the requested service. This string
80 can be either a descriptive name or a numeric representation suitable for use
81 with the address family or families. If the specified address family is
88 the returned information to a specific socket type, address family and/or
92 caller accepts any address family. A value of 0 for \fBai_socktype\fR means
101 or be the bitwise-inclusive OR of one or more of the values \fBAI_PASSIVE\fR,
112 connection-mode protocol) or for a call to \fBconnect()\fR,
119 not null, the function attempts to determine the canonical name corresponding
121 notation for a complete name).
124 If the \fBAI_NUMERICHOST\fR flag is specified, then a non-null \fInodename\fR
126 \fBEAI_NONAME\fR error is returned. This flag prevents any type of name
130 If the \fBAI_NUMERICSERV\fR flag is specified, then a non-null \fIservname\fR
132 is returned. This flag prevents any type of name resolution service (for
137 \fBAF_INET6\fR, then \fBgetaddrinfo()\fR returns IPv4-mapped IPv6 addresses on
147 socket type is not given (for example, a value of 0) and the service name could
149 implementation attempts to resolve the service name for all supported socket
151 non-zero socket type value limits the returned information to values with the
156 \fBAF_UNSPEC\fR, addresses are returned for use with any address family that
158 addresses are returned for use only with the specified address family. If
160 addresses are returned for use only with the specified address family and
168 non-zero return value indicates failure. The possible values for the failures
191 points to a null-terminated string containing the canonical name corresponding
192 to the input \fInodename\fR. If the canonical name is not available, then
212 The name could not be resolved at this time. Future attempts might succeed.
230 A non-recoverable error occurred when attempting to resolve the name.
239 The address family was not recognized.
258 he name does not resolve for the supplied parameters.  Neither \fInodename\fR
318 c | c
324 MT-Level	MT-Safe