lwres_inetntop.html revision 8de7014e56565605a51898a2a33a8b08fd3f1e57
5cd4555ad444fd391002ae32450572054369fd42Rob Austein<!--
5cd4555ad444fd391002ae32450572054369fd42Rob Austein - Copyright (C) 2000, 2001 Internet Software Consortium.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein -
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - Permission to use, copy, modify, and distribute this software for any
c1a883f2e04d94e99c433b1f6cfd0c0338f4ed85Mark Andrews - purpose with or without fee is hereby granted, provided that the above
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews - copyright notice and this permission notice appear in all copies.
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson -
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews-->
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews<HTML
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews><HEAD
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson><TITLE
f5d30e2864e048a42c4dc1134993ae7efdb5d6c3Mark Andrews>lwres_inetntop</TITLE
c1a883f2e04d94e99c433b1f6cfd0c0338f4ed85Mark Andrews><META
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinNAME="GENERATOR"
ddccd5811feff696ba460dabfb666ce61040f545Andreas GustafssonCONTENT="Modular DocBook HTML Stylesheet Version 1.61
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein"></HEAD
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><BODY
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="REFENTRY"
ddccd5811feff696ba460dabfb666ce61040f545Andreas GustafssonBGCOLOR="#FFFFFF"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinTEXT="#000000"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinLINK="#0000FF"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinVLINK="#840084"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinALINK="#0000FF"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><H1
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinNAME="AEN1"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>lwres_inetntop</A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></H1
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><DIV
c1a883f2e04d94e99c433b1f6cfd0c0338f4ed85Mark AndrewsCLASS="REFNAMEDIV"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinNAME="AEN8"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><H2
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>Name</H2
f5d30e2864e048a42c4dc1134993ae7efdb5d6c3Mark Andrews>lwres_net_ntop&nbsp;--&nbsp;lightweight resolver IP address presentation</DIV
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><DIV
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="REFSYNOPSISDIV"
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson><A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinNAME="AEN11"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><H2
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>Synopsis</H2
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson><DIV
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="FUNCSYNOPSIS"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><A
ddccd5811feff696ba460dabfb666ce61040f545Andreas GustafssonNAME="AEN12"
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson></A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><P
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson></P
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson><PRE
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="FUNCSYNOPSISINFO"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>#include &lt;lwres/net.h&gt;</PRE
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson><P
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><CODE
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson><CODE
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="FUNCDEF"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>const char *
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafssonlwres_net_ntop</CODE
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>(int af, const void *src, char *dst, size_t size);</CODE
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></P
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><P
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></P
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></DIV
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></DIV
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><DIV
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="REFSECT1"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinNAME="AEN21"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><H2
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>DESCRIPTION</H2
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><P
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="FUNCTION"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>lwres_net_ntop()</TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinconverts an IP address of protocol family
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="PARAMETER"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><I
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>af</I
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein&mdash; IPv4 or IPv6 &mdash;
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinat location
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="PARAMETER"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><I
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>src</I
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinfrom network format to its conventional representation as a string.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinFor IPv4 addresses, that string would be a dotted-decimal.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinAn IPv6 address would be represented in colon notation as described in
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinRFC1884.</P
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><P
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>The generated string is copied to
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="PARAMETER"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><I
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>dst</I
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinprovided
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="PARAMETER"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><I
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>size</I
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinindicates it is long enough to store the ASCII representation
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinof the address.</P
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></DIV
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><DIV
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="REFSECT1"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinNAME="AEN30"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><H2
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>RETURN VALUES</H2
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><P
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>If successful, the function returns
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="PARAMETER"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><I
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>dst</I
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>:
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeina pointer to a string containing
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinthe presentation format of the address.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="FUNCTION"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>lwres_net_ntop()</TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinreturns
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="TYPE"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>NULL</SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinand sets the global variable
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="CONSTANT"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>errno</TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinto
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="ERRORCODE"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>EAFNOSUPPORT</SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinif the protocol family given in
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="PARAMETER"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><I
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>af</I
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></TT
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinis not supported.</P
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></DIV
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><DIV
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="REFSECT1"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinNAME="AEN39"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></A
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><H2
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>SEE ALSO</H2
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson><P
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="CITEREFENTRY"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="REFENTRYTITLE"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>RFC1884</SPAN
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson></SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>,
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="CITEREFENTRY"
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson><SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="REFENTRYTITLE"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>inet_ntop</SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>(3)</SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>,
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein<SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="CITEREFENTRY"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein><SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinCLASS="REFENTRYTITLE"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>errno</SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>(3)</SPAN
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein>.</P
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></DIV
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></BODY
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein></HTML
>