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