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