lwres_inetntop.html revision ac299c4f5ca236370b9df2a91b18b149b1d344a7
50066670817cdf9e86c832066d73715232b29680Tinderbox User<!--
11e9368a226272085c337e9e74b79808c16fbdbaTinderbox User - Copyright (C) 2000, 2001 Internet Software Consortium.
50066670817cdf9e86c832066d73715232b29680Tinderbox User -
50066670817cdf9e86c832066d73715232b29680Tinderbox User - Permission to use, copy, modify, and distribute this software for any
50066670817cdf9e86c832066d73715232b29680Tinderbox User - purpose with or without fee is hereby granted, provided that the above
50066670817cdf9e86c832066d73715232b29680Tinderbox User - copyright notice and this permission notice appear in all copies.
50066670817cdf9e86c832066d73715232b29680Tinderbox User -
50066670817cdf9e86c832066d73715232b29680Tinderbox User - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
50066670817cdf9e86c832066d73715232b29680Tinderbox User - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
50066670817cdf9e86c832066d73715232b29680Tinderbox User - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
50066670817cdf9e86c832066d73715232b29680Tinderbox User - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
50066670817cdf9e86c832066d73715232b29680Tinderbox User - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
50066670817cdf9e86c832066d73715232b29680Tinderbox User - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
50066670817cdf9e86c832066d73715232b29680Tinderbox User - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
50066670817cdf9e86c832066d73715232b29680Tinderbox User - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
50066670817cdf9e86c832066d73715232b29680Tinderbox User-->
50066670817cdf9e86c832066d73715232b29680Tinderbox User<HTML
50066670817cdf9e86c832066d73715232b29680Tinderbox User><HEAD
50066670817cdf9e86c832066d73715232b29680Tinderbox User><TITLE
50066670817cdf9e86c832066d73715232b29680Tinderbox User>lwres_inetntop</TITLE
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><META
14a656f94b1fd0ababd84a772228dfa52276ba15Evan HuntNAME="GENERATOR"
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox UserCONTENT="Modular DocBook HTML Stylesheet Version 1.61
50066670817cdf9e86c832066d73715232b29680Tinderbox User"></HEAD
50066670817cdf9e86c832066d73715232b29680Tinderbox User><BODY
50066670817cdf9e86c832066d73715232b29680Tinderbox UserCLASS="REFENTRY"
50066670817cdf9e86c832066d73715232b29680Tinderbox UserBGCOLOR="#FFFFFF"
50066670817cdf9e86c832066d73715232b29680Tinderbox UserTEXT="#000000"
50066670817cdf9e86c832066d73715232b29680Tinderbox UserLINK="#0000FF"
50066670817cdf9e86c832066d73715232b29680Tinderbox UserVLINK="#840084"
50066670817cdf9e86c832066d73715232b29680Tinderbox UserALINK="#0000FF"
50066670817cdf9e86c832066d73715232b29680Tinderbox User><H1
50066670817cdf9e86c832066d73715232b29680Tinderbox User><A
50066670817cdf9e86c832066d73715232b29680Tinderbox UserNAME="AEN1"
50066670817cdf9e86c832066d73715232b29680Tinderbox User>lwres_inetntop</A
50066670817cdf9e86c832066d73715232b29680Tinderbox User></H1
50066670817cdf9e86c832066d73715232b29680Tinderbox User><DIV
50066670817cdf9e86c832066d73715232b29680Tinderbox UserCLASS="REFNAMEDIV"
50066670817cdf9e86c832066d73715232b29680Tinderbox User><A
50066670817cdf9e86c832066d73715232b29680Tinderbox UserNAME="AEN8"
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User></A
50066670817cdf9e86c832066d73715232b29680Tinderbox User><H2
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User>Name</H2
50066670817cdf9e86c832066d73715232b29680Tinderbox User>lwres_net_ntop&nbsp;--&nbsp;lightweight resolver IP address presentation</DIV
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><DIV
50066670817cdf9e86c832066d73715232b29680Tinderbox UserCLASS="REFSYNOPSISDIV"
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><A
50066670817cdf9e86c832066d73715232b29680Tinderbox UserNAME="AEN11"
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User></A
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User><H2
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User>Synopsis</H2
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><DIV
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox UserCLASS="FUNCSYNOPSIS"
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><A
50066670817cdf9e86c832066d73715232b29680Tinderbox UserNAME="AEN12"
50066670817cdf9e86c832066d73715232b29680Tinderbox User></A
50066670817cdf9e86c832066d73715232b29680Tinderbox User><P
50066670817cdf9e86c832066d73715232b29680Tinderbox User></P
50066670817cdf9e86c832066d73715232b29680Tinderbox User><PRE
50066670817cdf9e86c832066d73715232b29680Tinderbox UserCLASS="FUNCSYNOPSISINFO"
50066670817cdf9e86c832066d73715232b29680Tinderbox User>#include &lt;lwres/net.h&gt;</PRE
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><P
50066670817cdf9e86c832066d73715232b29680Tinderbox User><CODE
50066670817cdf9e86c832066d73715232b29680Tinderbox User><CODE
50066670817cdf9e86c832066d73715232b29680Tinderbox UserCLASS="FUNCDEF"
50066670817cdf9e86c832066d73715232b29680Tinderbox User>const char *
50066670817cdf9e86c832066d73715232b29680Tinderbox Userlwres_net_ntop</CODE
50066670817cdf9e86c832066d73715232b29680Tinderbox User>(int af, const void *src, char *dst, size_t size);</CODE
50066670817cdf9e86c832066d73715232b29680Tinderbox User></P
50066670817cdf9e86c832066d73715232b29680Tinderbox User><P
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User></P
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User></DIV
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User></DIV
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><DIV
50066670817cdf9e86c832066d73715232b29680Tinderbox UserCLASS="REFSECT1"
50066670817cdf9e86c832066d73715232b29680Tinderbox User><A
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox UserNAME="AEN21"
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User></A
50066670817cdf9e86c832066d73715232b29680Tinderbox User><H2
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User>DESCRIPTION</H2
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User><P
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User><TT
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox UserCLASS="FUNCTION"
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User>lwres_net_ntop()</TT
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User> converts an IP address of
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox Userprotocol family <TT
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox UserCLASS="PARAMETER"
50066670817cdf9e86c832066d73715232b29680Tinderbox User><I
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User>af</I
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User></TT
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User> &mdash; IPv4 or IPv6 &mdash;
50066670817cdf9e86c832066d73715232b29680Tinderbox Userat location <TT
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox UserCLASS="PARAMETER"
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User><I
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User>src</I
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User></TT
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User> from network format to its
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox Userconventional representation as a string. For IPv4 addresses, that
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox Userstring would be a dotted-decimal. An IPv6 address would be
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox Userrepresented in colon notation as described in RFC1884.</P
50066670817cdf9e86c832066d73715232b29680Tinderbox User><P
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User>The generated string is copied to <TT
50066670817cdf9e86c832066d73715232b29680Tinderbox UserCLASS="PARAMETER"
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><I
50066670817cdf9e86c832066d73715232b29680Tinderbox User>dst</I
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User></TT
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User> provided
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User<TT
6f1205897504b8f50b1785975482c995888dd630Tinderbox UserCLASS="PARAMETER"
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><I
6f1205897504b8f50b1785975482c995888dd630Tinderbox User>size</I
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User></TT
50066670817cdf9e86c832066d73715232b29680Tinderbox User> indicates it is long enough to store the
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox UserASCII representation of the address.</P
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User></DIV
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><DIV
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox UserCLASS="REFSECT1"
50066670817cdf9e86c832066d73715232b29680Tinderbox User><A
50066670817cdf9e86c832066d73715232b29680Tinderbox UserNAME="AEN30"
50066670817cdf9e86c832066d73715232b29680Tinderbox User></A
50066670817cdf9e86c832066d73715232b29680Tinderbox User><H2
50066670817cdf9e86c832066d73715232b29680Tinderbox User>RETURN VALUES</H2
50066670817cdf9e86c832066d73715232b29680Tinderbox User><P
50066670817cdf9e86c832066d73715232b29680Tinderbox User>If successful, the function returns <TT
50066670817cdf9e86c832066d73715232b29680Tinderbox UserCLASS="PARAMETER"
50066670817cdf9e86c832066d73715232b29680Tinderbox User><I
50066670817cdf9e86c832066d73715232b29680Tinderbox User>dst</I
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User></TT
50066670817cdf9e86c832066d73715232b29680Tinderbox User>:
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox Usera pointer to a string containing the presentation format of the
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox Useraddress. <TT
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox UserCLASS="FUNCTION"
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User>lwres_net_ntop()</TT
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User> returns
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User<SPAN
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox UserCLASS="TYPE"
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User>NULL</SPAN
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User> and sets the global variable
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User<TT
50066670817cdf9e86c832066d73715232b29680Tinderbox UserCLASS="CONSTANT"
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User>errno</TT
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User> to <SPAN
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox UserCLASS="ERRORCODE"
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User>EAFNOSUPPORT</SPAN
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User> if
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox Userthe protocol family given in <TT
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox UserCLASS="PARAMETER"
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User><I
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User>af</I
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User></TT
50066670817cdf9e86c832066d73715232b29680Tinderbox User> is not
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox Usersupported.</P
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User></DIV
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><DIV
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox UserCLASS="REFSECT1"
50066670817cdf9e86c832066d73715232b29680Tinderbox User><A
50066670817cdf9e86c832066d73715232b29680Tinderbox UserNAME="AEN39"
50066670817cdf9e86c832066d73715232b29680Tinderbox User></A
50066670817cdf9e86c832066d73715232b29680Tinderbox User><H2
50066670817cdf9e86c832066d73715232b29680Tinderbox User>SEE ALSO</H2
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><P
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><SPAN
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox UserCLASS="CITEREFENTRY"
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User><SPAN
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox UserCLASS="REFENTRYTITLE"
50066670817cdf9e86c832066d73715232b29680Tinderbox User>RFC1884</SPAN
50066670817cdf9e86c832066d73715232b29680Tinderbox User></SPAN
50066670817cdf9e86c832066d73715232b29680Tinderbox User>,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<SPAN
50066670817cdf9e86c832066d73715232b29680Tinderbox UserCLASS="CITEREFENTRY"
50066670817cdf9e86c832066d73715232b29680Tinderbox User><SPAN
50066670817cdf9e86c832066d73715232b29680Tinderbox UserCLASS="REFENTRYTITLE"
50066670817cdf9e86c832066d73715232b29680Tinderbox User>inet_ntop</SPAN
50066670817cdf9e86c832066d73715232b29680Tinderbox User>(3)</SPAN
50066670817cdf9e86c832066d73715232b29680Tinderbox User>,
50066670817cdf9e86c832066d73715232b29680Tinderbox User<SPAN
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox UserCLASS="CITEREFENTRY"
50066670817cdf9e86c832066d73715232b29680Tinderbox User><SPAN
50066670817cdf9e86c832066d73715232b29680Tinderbox UserCLASS="REFENTRYTITLE"
50066670817cdf9e86c832066d73715232b29680Tinderbox User>errno</SPAN
50066670817cdf9e86c832066d73715232b29680Tinderbox User>(3)</SPAN
50066670817cdf9e86c832066d73715232b29680Tinderbox User>.</P
50066670817cdf9e86c832066d73715232b29680Tinderbox User></DIV
50066670817cdf9e86c832066d73715232b29680Tinderbox User></BODY
50066670817cdf9e86c832066d73715232b29680Tinderbox User></HTML
50066670817cdf9e86c832066d73715232b29680Tinderbox User>