lwres_inetntop.html revision 89da2a56413ba6294315bdde04f7547b9d71b062
98N/A<!--
98N/A - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
1379N/A - Copyright (C) 2001 Internet Software Consortium.
98N/A -
98N/A - Permission to use, copy, modify, and distribute this software for any
919N/A - purpose with or without fee is hereby granted, provided that the above
919N/A - copyright notice and this permission notice appear in all copies.
919N/A -
919N/A - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
919N/A - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
919N/A - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
919N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
919N/A - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
919N/A - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
919N/A - PERFORMANCE OF THIS SOFTWARE.
919N/A-->
919N/A
919N/A<!-- $Id: lwres_inetntop.html,v 1.10 2005/04/03 03:31:37 marka Exp $ -->
919N/A
919N/A<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
919N/A<HTML
919N/A><HEAD
98N/A><TITLE
98N/A>lwres_inetntop</TITLE
98N/A><META
493N/ANAME="GENERATOR"
493N/ACONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
98N/A><BODY
970N/ACLASS="REFENTRY"
970N/ABGCOLOR="#FFFFFF"
970N/ATEXT="#000000"
970N/ALINK="#0000FF"
970N/AVLINK="#840084"
970N/AALINK="#0000FF"
970N/A><H1
1003N/A><A
1339N/ANAME="AEN1"
1339N/A></A
970N/A>lwres_inetntop</H1
970N/A><DIV
970N/ACLASS="REFNAMEDIV"
970N/A><A
1366N/ANAME="AEN8"
1366N/A></A
970N/A><H2
98N/A>Name</H2
1366N/A>lwres_net_ntop&nbsp;--&nbsp;lightweight resolver IP address presentation</DIV
98N/A><DIV
911N/ACLASS="REFSYNOPSISDIV"
1366N/A><A
1366N/ANAME="AEN11"
911N/A></A
98N/A><H2
493N/A>Synopsis</H2
493N/A><DIV
98N/ACLASS="FUNCSYNOPSIS"
98N/A><P
1089N/A></P
156N/A><A
493N/ANAME="AEN12"
493N/A></A
493N/A><PRE
493N/ACLASS="FUNCSYNOPSISINFO"
493N/A>#include &lt;lwres/net.h&gt;</PRE
493N/A><P
98N/A><CODE
98N/A><CODE
98N/ACLASS="FUNCDEF"
1345N/A>const char *
1089N/Alwres_net_ntop</CODE
1351N/A>(int af, const void *src, char *dst, size_t size);</CODE
1366N/A></P
606N/A><P
606N/A></P
606N/A></DIV
606N/A></DIV
705N/A><DIV
967N/ACLASS="REFSECT1"
606N/A><A
1422N/ANAME="AEN21"
1422N/A></A
1422N/A><H2
1422N/A>DESCRIPTION</H2
1422N/A><P
1422N/A><CODE
606N/ACLASS="FUNCTION"
1351N/A>lwres_net_ntop()</CODE
606N/A> converts an IP address of
606N/Aprotocol family <CODE
606N/ACLASS="PARAMETER"
1089N/A>af</CODE
1262N/A> &mdash; IPv4 or IPv6 &mdash;
1265N/Aat location <CODE
1265N/ACLASS="PARAMETER"
606N/A>src</CODE
1109N/A> from network format to its
1109N/Aconventional representation as a string. For IPv4 addresses, that
1109N/Astring would be a dotted-decimal. An IPv6 address would be
606N/Arepresented in colon notation as described in RFC1884.</P
606N/A><P
606N/A>The generated string is copied to <CODE
98N/ACLASS="PARAMETER"
1126N/A>dst</CODE
1126N/A> provided
1126N/A<CODE
970N/ACLASS="PARAMETER"
493N/A>size</CODE
493N/A> indicates it is long enough to store the
493N/AASCII representation of the address.</P
98N/A></DIV
647N/A><DIV
1089N/ACLASS="REFSECT1"
1089N/A><A
98N/ANAME="AEN30"
647N/A></A
647N/A><H2
1089N/A>RETURN VALUES</H2
647N/A><P
606N/A>If successful, the function returns <CODE
1089N/ACLASS="PARAMETER"
98N/A>dst</CODE
606N/A>:
1196N/Aa pointer to a string containing the presentation format of the
98N/Aaddress. <CODE
1379N/ACLASS="FUNCTION"
1379N/A>lwres_net_ntop()</CODE
493N/A> returns
493N/A<SPAN
98N/ACLASS="TYPE"
705N/A>NULL</SPAN
705N/A> and sets the global variable
705N/A<CODE
493N/ACLASS="CONSTANT"
493N/A>errno</CODE
493N/A> to <SPAN
705N/ACLASS="ERRORCODE"
705N/A>EAFNOSUPPORT</SPAN
705N/A> if
970N/Athe protocol family given in <CODE
970N/ACLASS="PARAMETER"
1366N/A>af</CODE
970N/A> is not
970N/Asupported.</P
1351N/A></DIV
1366N/A><DIV
1351N/ACLASS="REFSECT1"
1366N/A><A
970N/ANAME="AEN39"
970N/A></A
970N/A><H2
970N/A>SEE ALSO</H2
970N/A><P
1366N/A><SPAN
970N/ACLASS="CITEREFENTRY"
970N/A><SPAN
1366N/ACLASS="REFENTRYTITLE"
1366N/A>RFC1884</SPAN
970N/A></SPAN
970N/A>,
970N/A<SPAN
970N/ACLASS="CITEREFENTRY"
970N/A><SPAN
970N/ACLASS="REFENTRYTITLE"
970N/A>inet_ntop</SPAN
1366N/A>(3)</SPAN
970N/A>,
1366N/A<SPAN
1366N/ACLASS="CITEREFENTRY"
970N/A><SPAN
1366N/ACLASS="REFENTRYTITLE"
970N/A>errno</SPAN
970N/A>(3)</SPAN
970N/A>.</P
1366N/A></DIV
1366N/A></BODY
1366N/A></HTML
970N/A>
1366N/A