lwres_getnameinfo.html revision 89da2a56413ba6294315bdde04f7547b9d71b062
e95cc69731ec79cf167e6167808e1c9b275ea007vboxsync - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
b2cb7a03a79ad2e40f4e470acbc87881781e798evboxsync - Copyright (C) 2001 Internet Software Consortium.
e95cc69731ec79cf167e6167808e1c9b275ea007vboxsync - Permission to use, copy, modify, and distribute this software for any
e95cc69731ec79cf167e6167808e1c9b275ea007vboxsync - purpose with or without fee is hereby granted, provided that the above
e95cc69731ec79cf167e6167808e1c9b275ea007vboxsync - copyright notice and this permission notice appear in all copies.
e95cc69731ec79cf167e6167808e1c9b275ea007vboxsync - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
e95cc69731ec79cf167e6167808e1c9b275ea007vboxsync - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
e95cc69731ec79cf167e6167808e1c9b275ea007vboxsync - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
e95cc69731ec79cf167e6167808e1c9b275ea007vboxsync - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
e95cc69731ec79cf167e6167808e1c9b275ea007vboxsync - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
e95cc69731ec79cf167e6167808e1c9b275ea007vboxsync - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
e95cc69731ec79cf167e6167808e1c9b275ea007vboxsync - PERFORMANCE OF THIS SOFTWARE.
174f3dff60f96d89b320f9a322307118676db1dbvboxsync<!-- $Id: lwres_getnameinfo.html,v 1.10 2005/04/03 03:31:37 marka Exp $ -->
174f3dff60f96d89b320f9a322307118676db1dbvboxsync<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>lwres_getnameinfo</TITLE
5281ff0370e0f0639507405007e100014e1f1e71vboxsyncNAME="GENERATOR"
5281ff0370e0f0639507405007e100014e1f1e71vboxsyncCONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
5281ff0370e0f0639507405007e100014e1f1e71vboxsyncCLASS="REFENTRY"
5281ff0370e0f0639507405007e100014e1f1e71vboxsyncBGCOLOR="#FFFFFF"
5281ff0370e0f0639507405007e100014e1f1e71vboxsyncTEXT="#000000"
5281ff0370e0f0639507405007e100014e1f1e71vboxsyncLINK="#0000FF"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncVLINK="#840084"
5281ff0370e0f0639507405007e100014e1f1e71vboxsyncALINK="#0000FF"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>lwres_getnameinfo</H1
e73a3b6ad6a11bdc3b89a3509058abd9737196c3vboxsyncCLASS="REFNAMEDIV"
5281ff0370e0f0639507405007e100014e1f1e71vboxsync>lwres_getnameinfo -- lightweight resolver socket address structure to hostname and service name</DIV
e73a3b6ad6a11bdc3b89a3509058abd9737196c3vboxsyncCLASS="REFSYNOPSISDIV"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncNAME="AEN11"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>Synopsis</H2
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="FUNCSYNOPSIS"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncNAME="AEN12"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="FUNCSYNOPSISINFO"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="FUNCDEF"
174f3dff60f96d89b320f9a322307118676db1dbvboxsynclwres_getnameinfo</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>(const struct sockaddr *sa, size_t salen, char *host, size_t hostlen, char *serv, size_t servlen, int flags);</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="REFSECT1"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncNAME="AEN24"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>DESCRIPTION</H2
174f3dff60f96d89b320f9a322307118676db1dbvboxsync> This function is equivalent to the <SPAN
f9de02a9df6b89c81f9cfa3fecf268f188085e1bvboxsyncCLASS="CITEREFENTRY"
f9de02a9df6b89c81f9cfa3fecf268f188085e1bvboxsyncCLASS="REFENTRYTITLE"
f9de02a9df6b89c81f9cfa3fecf268f188085e1bvboxsync>getnameinfo</SPAN
f9de02a9df6b89c81f9cfa3fecf268f188085e1bvboxsync> function defined in RFC2133.
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="FUNCTION"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>lwres_getnameinfo()</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsync> returns the hostname for the
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="TYPE"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>struct sockaddr</SPAN
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="PARAMETER"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="PARAMETER"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>salen</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsync> bytes long. The hostname is of length
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="PARAMETER"
48ec72070b2413bab04f0eeda150d5cc57364878vboxsync>hostlen</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsync> and is returned via
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="PARAMETER"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>*host.</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsync> The maximum length of the hostname is
174f3dff60f96d89b320f9a322307118676db1dbvboxsync1025 bytes: <CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="CONSTANT"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>NI_MAXHOST</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsync> The name of the service associated with the port number in
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="PARAMETER"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync> is returned in <CODE
e73a3b6ad6a11bdc3b89a3509058abd9737196c3vboxsyncCLASS="PARAMETER"
e73a3b6ad6a11bdc3b89a3509058abd9737196c3vboxsync>*serv.</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="PARAMETER"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>servlen</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsync> bytes long. The maximum length
e73a3b6ad6a11bdc3b89a3509058abd9737196c3vboxsyncof the service name is <CODE
e73a3b6ad6a11bdc3b89a3509058abd9737196c3vboxsyncCLASS="CONSTANT"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>NI_MAXSERV</CODE
5281ff0370e0f0639507405007e100014e1f1e71vboxsync> - 32 bytes.</P
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="PARAMETER"
f9de02a9df6b89c81f9cfa3fecf268f188085e1bvboxsync>flags</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsync> argument sets the following
e73a3b6ad6a11bdc3b89a3509058abd9737196c3vboxsyncCLASS="VARIABLELIST"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="CONSTANT"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>NI_NOFQDN</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>A fully qualified domain name is not required for local hosts.
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncThe local part of the fully qualified domain name is returned instead.</P
e73a3b6ad6a11bdc3b89a3509058abd9737196c3vboxsyncCLASS="CONSTANT"
e73a3b6ad6a11bdc3b89a3509058abd9737196c3vboxsync>NI_NUMERICHOST</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>Return the address in numeric form, as if calling inet_ntop(),
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncinstead of a host name.</P
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="CONSTANT"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>NI_NAMEREQD</CODE
e73a3b6ad6a11bdc3b89a3509058abd9737196c3vboxsync>A name is required. If the hostname cannot be found in the DNS and
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncthis flag is set, a non-zero error code is returned.
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncIf the hostname is not found and the flag is not set, the
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncaddress is returned in numeric form.</P
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="CONSTANT"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>NI_NUMERICSERV</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>The service name is returned as a digit string representing the port number.</P
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="CONSTANT"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>NI_DGRAM</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>Specifies that the service being looked up is a datagram
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncservice, and causes getservbyport() to be called with a second
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncargument of "udp" instead of its default of "tcp". This is required
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncfor the few ports (512-514) that have different services for UDP and
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="REFSECT1"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncNAME="AEN70"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>RETURN VALUES</H2
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="FUNCTION"
e73a3b6ad6a11bdc3b89a3509058abd9737196c3vboxsync>lwres_getnameinfo()</CODE
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncreturns 0 on success or a non-zero error code if an error occurs.</P
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="REFSECT1"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncNAME="AEN74"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>SEE ALSO</H2
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="CITEREFENTRY"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="REFENTRYTITLE"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>RFC2133</SPAN
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="CITEREFENTRY"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="REFENTRYTITLE"
b2cb7a03a79ad2e40f4e470acbc87881781e798evboxsync>getservbyport</SPAN
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="CITEREFENTRY"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="REFENTRYTITLE"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>lwres</SPAN
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="CITEREFENTRY"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="REFENTRYTITLE"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>lwres_getnameinfo</SPAN
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="CITEREFENTRY"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="REFENTRYTITLE"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>lwres_getnamebyaddr</SPAN
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="CITEREFENTRY"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="REFENTRYTITLE"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>lwres_net_ntop</SPAN
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="REFSECT1"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncNAME="AEN94"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>RFC2133 fails to define what the nonzero return values of
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="CITEREFENTRY"
174f3dff60f96d89b320f9a322307118676db1dbvboxsyncCLASS="REFENTRYTITLE"
174f3dff60f96d89b320f9a322307118676db1dbvboxsync>getnameinfo</SPAN