lwres_inetntop.html revision 8de7014e56565605a51898a2a33a8b08fd3f1e57
843e19887f64dde75055cf8842fc4db2171eff45johnlev<!--
843e19887f64dde75055cf8842fc4db2171eff45johnlev - Copyright (C) 2000, 2001 Internet Software Consortium.
843e19887f64dde75055cf8842fc4db2171eff45johnlev -
843e19887f64dde75055cf8842fc4db2171eff45johnlev - Permission to use, copy, modify, and distribute this software for any
843e19887f64dde75055cf8842fc4db2171eff45johnlev - purpose with or without fee is hereby granted, provided that the above
843e19887f64dde75055cf8842fc4db2171eff45johnlev - copyright notice and this permission notice appear in all copies.
843e19887f64dde75055cf8842fc4db2171eff45johnlev -
843e19887f64dde75055cf8842fc4db2171eff45johnlev - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
843e19887f64dde75055cf8842fc4db2171eff45johnlev - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
843e19887f64dde75055cf8842fc4db2171eff45johnlev - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
843e19887f64dde75055cf8842fc4db2171eff45johnlev - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
843e19887f64dde75055cf8842fc4db2171eff45johnlev - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
843e19887f64dde75055cf8842fc4db2171eff45johnlev - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
843e19887f64dde75055cf8842fc4db2171eff45johnlev - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
843e19887f64dde75055cf8842fc4db2171eff45johnlev - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
843e19887f64dde75055cf8842fc4db2171eff45johnlev-->
843e19887f64dde75055cf8842fc4db2171eff45johnlev<HTML
843e19887f64dde75055cf8842fc4db2171eff45johnlev><HEAD
843e19887f64dde75055cf8842fc4db2171eff45johnlev><TITLE
843e19887f64dde75055cf8842fc4db2171eff45johnlev>lwres_inetntop</TITLE
843e19887f64dde75055cf8842fc4db2171eff45johnlev><META
843e19887f64dde75055cf8842fc4db2171eff45johnlevNAME="GENERATOR"
843e19887f64dde75055cf8842fc4db2171eff45johnlevCONTENT="Modular DocBook HTML Stylesheet Version 1.61
843e19887f64dde75055cf8842fc4db2171eff45johnlev"></HEAD
843e19887f64dde75055cf8842fc4db2171eff45johnlev><BODY
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="REFENTRY"
843e19887f64dde75055cf8842fc4db2171eff45johnlevBGCOLOR="#FFFFFF"
843e19887f64dde75055cf8842fc4db2171eff45johnlevTEXT="#000000"
843e19887f64dde75055cf8842fc4db2171eff45johnlevLINK="#0000FF"
843e19887f64dde75055cf8842fc4db2171eff45johnlevVLINK="#840084"
843e19887f64dde75055cf8842fc4db2171eff45johnlevALINK="#0000FF"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><H1
843e19887f64dde75055cf8842fc4db2171eff45johnlev><A
843e19887f64dde75055cf8842fc4db2171eff45johnlevNAME="AEN1"
843e19887f64dde75055cf8842fc4db2171eff45johnlev>lwres_inetntop</A
843e19887f64dde75055cf8842fc4db2171eff45johnlev></H1
843e19887f64dde75055cf8842fc4db2171eff45johnlev><DIV
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="REFNAMEDIV"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><A
843e19887f64dde75055cf8842fc4db2171eff45johnlevNAME="AEN8"
843e19887f64dde75055cf8842fc4db2171eff45johnlev></A
843e19887f64dde75055cf8842fc4db2171eff45johnlev><H2
843e19887f64dde75055cf8842fc4db2171eff45johnlev>Name</H2
843e19887f64dde75055cf8842fc4db2171eff45johnlev>lwres_net_ntop&nbsp;--&nbsp;lightweight resolver IP address presentation</DIV
843e19887f64dde75055cf8842fc4db2171eff45johnlev><DIV
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="REFSYNOPSISDIV"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><A
843e19887f64dde75055cf8842fc4db2171eff45johnlevNAME="AEN11"
843e19887f64dde75055cf8842fc4db2171eff45johnlev></A
843e19887f64dde75055cf8842fc4db2171eff45johnlev><H2
843e19887f64dde75055cf8842fc4db2171eff45johnlev>Synopsis</H2
843e19887f64dde75055cf8842fc4db2171eff45johnlev><DIV
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="FUNCSYNOPSIS"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><A
843e19887f64dde75055cf8842fc4db2171eff45johnlevNAME="AEN12"
843e19887f64dde75055cf8842fc4db2171eff45johnlev></A
843e19887f64dde75055cf8842fc4db2171eff45johnlev><P
843e19887f64dde75055cf8842fc4db2171eff45johnlev></P
843e19887f64dde75055cf8842fc4db2171eff45johnlev><PRE
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="FUNCSYNOPSISINFO"
843e19887f64dde75055cf8842fc4db2171eff45johnlev>#include &lt;lwres/net.h&gt;</PRE
843e19887f64dde75055cf8842fc4db2171eff45johnlev><P
843e19887f64dde75055cf8842fc4db2171eff45johnlev><CODE
843e19887f64dde75055cf8842fc4db2171eff45johnlev><CODE
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="FUNCDEF"
843e19887f64dde75055cf8842fc4db2171eff45johnlev>const char *
843e19887f64dde75055cf8842fc4db2171eff45johnlevlwres_net_ntop</CODE
843e19887f64dde75055cf8842fc4db2171eff45johnlev>(int af, const void *src, char *dst, size_t size);</CODE
843e19887f64dde75055cf8842fc4db2171eff45johnlev></P
843e19887f64dde75055cf8842fc4db2171eff45johnlev><P
843e19887f64dde75055cf8842fc4db2171eff45johnlev></P
843e19887f64dde75055cf8842fc4db2171eff45johnlev></DIV
843e19887f64dde75055cf8842fc4db2171eff45johnlev></DIV
843e19887f64dde75055cf8842fc4db2171eff45johnlev><DIV
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="REFSECT1"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><A
843e19887f64dde75055cf8842fc4db2171eff45johnlevNAME="AEN21"
843e19887f64dde75055cf8842fc4db2171eff45johnlev></A
843e19887f64dde75055cf8842fc4db2171eff45johnlev><H2
843e19887f64dde75055cf8842fc4db2171eff45johnlev>DESCRIPTION</H2
843e19887f64dde75055cf8842fc4db2171eff45johnlev><P
843e19887f64dde75055cf8842fc4db2171eff45johnlev><TT
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="FUNCTION"
843e19887f64dde75055cf8842fc4db2171eff45johnlev>lwres_net_ntop()</TT
843e19887f64dde75055cf8842fc4db2171eff45johnlev>
843e19887f64dde75055cf8842fc4db2171eff45johnlevconverts an IP address of protocol family
843e19887f64dde75055cf8842fc4db2171eff45johnlev<TT
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="PARAMETER"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><I
843e19887f64dde75055cf8842fc4db2171eff45johnlev>af</I
843e19887f64dde75055cf8842fc4db2171eff45johnlev></TT
843e19887f64dde75055cf8842fc4db2171eff45johnlev>
843e19887f64dde75055cf8842fc4db2171eff45johnlev&mdash; IPv4 or IPv6 &mdash;
843e19887f64dde75055cf8842fc4db2171eff45johnlevat location
843e19887f64dde75055cf8842fc4db2171eff45johnlev<TT
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="PARAMETER"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><I
843e19887f64dde75055cf8842fc4db2171eff45johnlev>src</I
843e19887f64dde75055cf8842fc4db2171eff45johnlev></TT
843e19887f64dde75055cf8842fc4db2171eff45johnlev>
843e19887f64dde75055cf8842fc4db2171eff45johnlevfrom network format to its conventional representation as a string.
843e19887f64dde75055cf8842fc4db2171eff45johnlevFor IPv4 addresses, that string would be a dotted-decimal.
843e19887f64dde75055cf8842fc4db2171eff45johnlevAn IPv6 address would be represented in colon notation as described in
843e19887f64dde75055cf8842fc4db2171eff45johnlevRFC1884.</P
843e19887f64dde75055cf8842fc4db2171eff45johnlev><P
843e19887f64dde75055cf8842fc4db2171eff45johnlev>The generated string is copied to
843e19887f64dde75055cf8842fc4db2171eff45johnlev<TT
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="PARAMETER"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><I
843e19887f64dde75055cf8842fc4db2171eff45johnlev>dst</I
843e19887f64dde75055cf8842fc4db2171eff45johnlev></TT
843e19887f64dde75055cf8842fc4db2171eff45johnlev>
843e19887f64dde75055cf8842fc4db2171eff45johnlevprovided
843e19887f64dde75055cf8842fc4db2171eff45johnlev<TT
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="PARAMETER"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><I
843e19887f64dde75055cf8842fc4db2171eff45johnlev>size</I
843e19887f64dde75055cf8842fc4db2171eff45johnlev></TT
843e19887f64dde75055cf8842fc4db2171eff45johnlev>
843e19887f64dde75055cf8842fc4db2171eff45johnlevindicates it is long enough to store the ASCII representation
843e19887f64dde75055cf8842fc4db2171eff45johnlevof the address.</P
843e19887f64dde75055cf8842fc4db2171eff45johnlev></DIV
843e19887f64dde75055cf8842fc4db2171eff45johnlev><DIV
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="REFSECT1"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><A
843e19887f64dde75055cf8842fc4db2171eff45johnlevNAME="AEN30"
843e19887f64dde75055cf8842fc4db2171eff45johnlev></A
843e19887f64dde75055cf8842fc4db2171eff45johnlev><H2
843e19887f64dde75055cf8842fc4db2171eff45johnlev>RETURN VALUES</H2
843e19887f64dde75055cf8842fc4db2171eff45johnlev><P
843e19887f64dde75055cf8842fc4db2171eff45johnlev>If successful, the function returns
843e19887f64dde75055cf8842fc4db2171eff45johnlev<TT
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="PARAMETER"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><I
843e19887f64dde75055cf8842fc4db2171eff45johnlev>dst</I
843e19887f64dde75055cf8842fc4db2171eff45johnlev></TT
843e19887f64dde75055cf8842fc4db2171eff45johnlev>:
843e19887f64dde75055cf8842fc4db2171eff45johnlev
843e19887f64dde75055cf8842fc4db2171eff45johnleva pointer to a string containing
843e19887f64dde75055cf8842fc4db2171eff45johnlevthe presentation format of the address.
843e19887f64dde75055cf8842fc4db2171eff45johnlev<TT
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="FUNCTION"
843e19887f64dde75055cf8842fc4db2171eff45johnlev>lwres_net_ntop()</TT
843e19887f64dde75055cf8842fc4db2171eff45johnlev>
843e19887f64dde75055cf8842fc4db2171eff45johnlevreturns
843e19887f64dde75055cf8842fc4db2171eff45johnlev<SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="TYPE"
843e19887f64dde75055cf8842fc4db2171eff45johnlev>NULL</SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlev>
843e19887f64dde75055cf8842fc4db2171eff45johnlevand sets the global variable
843e19887f64dde75055cf8842fc4db2171eff45johnlev<TT
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="CONSTANT"
843e19887f64dde75055cf8842fc4db2171eff45johnlev>errno</TT
843e19887f64dde75055cf8842fc4db2171eff45johnlev>
843e19887f64dde75055cf8842fc4db2171eff45johnlevto
b9bc7f7832704fda46b4d6b04f3f7be1227dc644smaybe<SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="ERRORCODE"
843e19887f64dde75055cf8842fc4db2171eff45johnlev>EAFNOSUPPORT</SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlev>
843e19887f64dde75055cf8842fc4db2171eff45johnlevif the protocol family given in
843e19887f64dde75055cf8842fc4db2171eff45johnlev<TT
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="PARAMETER"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><I
843e19887f64dde75055cf8842fc4db2171eff45johnlev>af</I
843e19887f64dde75055cf8842fc4db2171eff45johnlev></TT
843e19887f64dde75055cf8842fc4db2171eff45johnlev>
843e19887f64dde75055cf8842fc4db2171eff45johnlevis not supported.</P
843e19887f64dde75055cf8842fc4db2171eff45johnlev></DIV
843e19887f64dde75055cf8842fc4db2171eff45johnlev><DIV
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="REFSECT1"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><A
843e19887f64dde75055cf8842fc4db2171eff45johnlevNAME="AEN39"
843e19887f64dde75055cf8842fc4db2171eff45johnlev></A
843e19887f64dde75055cf8842fc4db2171eff45johnlev><H2
843e19887f64dde75055cf8842fc4db2171eff45johnlev>SEE ALSO</H2
843e19887f64dde75055cf8842fc4db2171eff45johnlev><P
843e19887f64dde75055cf8842fc4db2171eff45johnlev><SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="CITEREFENTRY"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="REFENTRYTITLE"
843e19887f64dde75055cf8842fc4db2171eff45johnlev>RFC1884</SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlev></SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlev>,
843e19887f64dde75055cf8842fc4db2171eff45johnlev<SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="CITEREFENTRY"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="REFENTRYTITLE"
843e19887f64dde75055cf8842fc4db2171eff45johnlev>inet_ntop</SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlev>(3)</SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlev>,
843e19887f64dde75055cf8842fc4db2171eff45johnlev<SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="CITEREFENTRY"
843e19887f64dde75055cf8842fc4db2171eff45johnlev><SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlevCLASS="REFENTRYTITLE"
843e19887f64dde75055cf8842fc4db2171eff45johnlev>errno</SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlev>(3)</SPAN
843e19887f64dde75055cf8842fc4db2171eff45johnlev>.</P
843e19887f64dde75055cf8842fc4db2171eff45johnlev></DIV
843e19887f64dde75055cf8842fc4db2171eff45johnlev></BODY
843e19887f64dde75055cf8842fc4db2171eff45johnlev></HTML
843e19887f64dde75055cf8842fc4db2171eff45johnlev>