lwres_inetntop.html revision b0e8629055a766d4555a005a283c2889a5974945
96fc773162e93e5b85686ab152f11baf4498d868rbb<!--
13ee9baf0119bca0739d3f17591f0bf2c64cdcccrbb - Copyright (C) 2004, 2005, 2007 Internet Systems Consortium, Inc. ("ISC")
a2c240fe8836beba2330b03d55569d9e31bb3358trawick - Copyright (C) 2000, 2001 Internet Software Consortium.
a2c240fe8836beba2330b03d55569d9e31bb3358trawick -
a2c240fe8836beba2330b03d55569d9e31bb3358trawick - Permission to use, copy, modify, and distribute this software for any
a2c240fe8836beba2330b03d55569d9e31bb3358trawick - purpose with or without fee is hereby granted, provided that the above
13ee9baf0119bca0739d3f17591f0bf2c64cdcccrbb - copyright notice and this permission notice appear in all copies.
13ee9baf0119bca0739d3f17591f0bf2c64cdcccrbb -
13ee9baf0119bca0739d3f17591f0bf2c64cdcccrbb - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
13ee9baf0119bca0739d3f17591f0bf2c64cdcccrbb - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
5a58a10705b7b154b53294e0c0283d64eabdcb7fstoddard - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
5a58a10705b7b154b53294e0c0283d64eabdcb7fstoddard - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
5a58a10705b7b154b53294e0c0283d64eabdcb7fstoddard - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
10a2de5cee9ae5abe675ea200fbe635a54556c8ffanf - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
3568de757bac0b47256647504c186d17ca272f85rbb - PERFORMANCE OF THIS SOFTWARE.
3568de757bac0b47256647504c186d17ca272f85rbb-->
3568de757bac0b47256647504c186d17ca272f85rbb<!-- $Id: lwres_inetntop.html,v 1.23 2007/01/30 00:24:59 marka Exp $ -->
98f3c8c547839251cb43e9f917114cc8b16ced9efanf<html>
98f3c8c547839251cb43e9f917114cc8b16ced9efanf<head>
98f3c8c547839251cb43e9f917114cc8b16ced9efanf<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
1a411968bb62cc88c3cbf14a53caf6587c224259fanf<title>lwres_inetntop</title>
1a411968bb62cc88c3cbf14a53caf6587c224259fanf<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
10a2de5cee9ae5abe675ea200fbe635a54556c8ffanf</head>
10a2de5cee9ae5abe675ea200fbe635a54556c8ffanf<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
10a2de5cee9ae5abe675ea200fbe635a54556c8ffanf<a name="id2476275"></a><div class="titlepage"></div>
10a2de5cee9ae5abe675ea200fbe635a54556c8ffanf<div class="refnamediv">
60777c94cb33363389d4848524c0809c235ba5e5rbb<h2>Name</h2>
6f06d481dafc90f1b553f1d2828bcea50a039854fielding<p>lwres_net_ntop &#8212; lightweight resolver IP address presentation</p>
b5140df3124b186e4a977812fd9828d1e295c080wrowe</div>
b5140df3124b186e4a977812fd9828d1e295c080wrowe<div class="refsynopsisdiv">
b5140df3124b186e4a977812fd9828d1e295c080wrowe<h2>Synopsis</h2>
b5140df3124b186e4a977812fd9828d1e295c080wrowe<div class="funcsynopsis">
b5140df3124b186e4a977812fd9828d1e295c080wrowe<pre class="funcsynopsisinfo">#include &lt;lwres/net.h&gt;</pre>
c9dafaafc2650994e47f88f5239f643c97ec4cb3wrowe<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0">
c9dafaafc2650994e47f88f5239f643c97ec4cb3wrowe<tr>
c9dafaafc2650994e47f88f5239f643c97ec4cb3wrowe<td><code class="funcdef">
c9dafaafc2650994e47f88f5239f643c97ec4cb3wroweconst char *
c9dafaafc2650994e47f88f5239f643c97ec4cb3wrowe<b class="fsfunc">lwres_net_ntop</b>(</code></td>
41aef8943f349ee0b5b510dd436301b4c33c628cwrowe<td>int �</td>
41aef8943f349ee0b5b510dd436301b4c33c628cwrowe<td>
bb360f1d9bdce4f55f290de07a711db006b25957wrowe<var class="pdparam">af</var>, </td>
5727f68f33838686d447f55a100309e54efb20f8fielding</tr>
5727f68f33838686d447f55a100309e54efb20f8fielding<tr>
5727f68f33838686d447f55a100309e54efb20f8fielding<td>�</td>
5727f68f33838686d447f55a100309e54efb20f8fielding<td>const void *�</td>
5727f68f33838686d447f55a100309e54efb20f8fielding<td>
d28c69d8e5f2e88e653d61436bb6fa6302a212b4rbb<var class="pdparam">src</var>, </td>
d28c69d8e5f2e88e653d61436bb6fa6302a212b4rbb</tr>
d28c69d8e5f2e88e653d61436bb6fa6302a212b4rbb<tr>
d28c69d8e5f2e88e653d61436bb6fa6302a212b4rbb<td>�</td>
d28c69d8e5f2e88e653d61436bb6fa6302a212b4rbb<td>char *�</td>
b974a8fc59a9d6193305dcd8690992a411d88232rbb<td>
b974a8fc59a9d6193305dcd8690992a411d88232rbb<var class="pdparam">dst</var>, </td>
b974a8fc59a9d6193305dcd8690992a411d88232rbb</tr>
b974a8fc59a9d6193305dcd8690992a411d88232rbb<tr>
b974a8fc59a9d6193305dcd8690992a411d88232rbb<td>�</td>
fa996ff928f6170678c8789c8073c368f56d770arbb<td>size_t �</td>
fa996ff928f6170678c8789c8073c368f56d770arbb<td>
fa996ff928f6170678c8789c8073c368f56d770arbb<var class="pdparam">size</var><code>)</code>;</td>
fa996ff928f6170678c8789c8073c368f56d770arbb</tr>
fa996ff928f6170678c8789c8073c368f56d770arbb</table>
fa996ff928f6170678c8789c8073c368f56d770arbb</div>
a1bbc66131c63e718e3f73fc11a348f7552d7947rbb</div>
a1bbc66131c63e718e3f73fc11a348f7552d7947rbb<div class="refsect1" lang="en">
a1bbc66131c63e718e3f73fc11a348f7552d7947rbb<a name="id2543379"></a><h2>DESCRIPTION</h2>
b31025f6f2c0392dc76eecca7f27faad0b902be0wrowe<p><code class="function">lwres_net_ntop()</code>
b31025f6f2c0392dc76eecca7f27faad0b902be0wrowe converts an IP address of protocol family
b31025f6f2c0392dc76eecca7f27faad0b902be0wrowe <em class="parameter"><code>af</code></em> &#8212; IPv4 or IPv6 &#8212; at
b31025f6f2c0392dc76eecca7f27faad0b902be0wrowe location <em class="parameter"><code>src</code></em> from network format to its
b31025f6f2c0392dc76eecca7f27faad0b902be0wrowe conventional representation as a string. For IPv4 addresses,
b31025f6f2c0392dc76eecca7f27faad0b902be0wrowe that string would be a dotted-decimal. An IPv6 address would be
4783bc116b4dc37deadcc0b68ce3d3eeb6a7464aben represented in colon notation as described in RFC1884.
4783bc116b4dc37deadcc0b68ce3d3eeb6a7464aben </p>
4783bc116b4dc37deadcc0b68ce3d3eeb6a7464aben<p>
4783bc116b4dc37deadcc0b68ce3d3eeb6a7464aben The generated string is copied to <em class="parameter"><code>dst</code></em>
4783bc116b4dc37deadcc0b68ce3d3eeb6a7464aben provided
fcc25eda7b150e226d3c1cdaea66a943d3fdee4erbb <em class="parameter"><code>size</code></em> indicates it is long enough to
fcc25eda7b150e226d3c1cdaea66a943d3fdee4erbb store the
fcc25eda7b150e226d3c1cdaea66a943d3fdee4erbb ASCII representation of the address.
fcc25eda7b150e226d3c1cdaea66a943d3fdee4erbb </p>
fcc25eda7b150e226d3c1cdaea66a943d3fdee4erbb</div>
fcc25eda7b150e226d3c1cdaea66a943d3fdee4erbb<div class="refsect1" lang="en">
fcc25eda7b150e226d3c1cdaea66a943d3fdee4erbb<a name="id2543411"></a><h2>RETURN VALUES</h2>
fcc25eda7b150e226d3c1cdaea66a943d3fdee4erbb<p>
fcc25eda7b150e226d3c1cdaea66a943d3fdee4erbb If successful, the function returns <em class="parameter"><code>dst</code></em>:
cab10c98980b42562a7850410cecd37798e170ecrbb a pointer to a string containing the presentation format of the
cab10c98980b42562a7850410cecd37798e170ecrbb address. <code class="function">lwres_net_ntop()</code> returns
cab10c98980b42562a7850410cecd37798e170ecrbb <span class="type">NULL</span> and sets the global variable
cab10c98980b42562a7850410cecd37798e170ecrbb <code class="constant">errno</code> to <span class="errorcode">EAFNOSUPPORT</span> if
cab10c98980b42562a7850410cecd37798e170ecrbb the protocol family given in <em class="parameter"><code>af</code></em> is
71715c646d5231de578431f8961e711764b899d3fanf not
71715c646d5231de578431f8961e711764b899d3fanf supported.
71715c646d5231de578431f8961e711764b899d3fanf </p>
2714d6002fcdf12f5b26cc948c9f2f03ca5e7ee9rbb</div>
2714d6002fcdf12f5b26cc948c9f2f03ca5e7ee9rbb<div class="refsect1" lang="en">
2714d6002fcdf12f5b26cc948c9f2f03ca5e7ee9rbb<a name="id2543444"></a><h2>SEE ALSO</h2>
2714d6002fcdf12f5b26cc948c9f2f03ca5e7ee9rbb<p><span class="citerefentry"><span class="refentrytitle">RFC1884</span></span>,
2714d6002fcdf12f5b26cc948c9f2f03ca5e7ee9rbb <span class="citerefentry"><span class="refentrytitle">inet_ntop</span>(3)</span>,
8695c28e4d0bb9357f606045b37238d4f49ce8b6rbb <span class="citerefentry"><span class="refentrytitle">errno</span>(3)</span>.
8695c28e4d0bb9357f606045b37238d4f49ce8b6rbb </p>
8695c28e4d0bb9357f606045b37238d4f49ce8b6rbb</div>
8695c28e4d0bb9357f606045b37238d4f49ce8b6rbb</div></body>
8695c28e4d0bb9357f606045b37238d4f49ce8b6rbb</html>
8695c28e4d0bb9357f606045b37238d4f49ce8b6rbb