lwres_inetntop.docbook revision 83a28ca274521e15086fc39febde507bcc4e145e
152N/A<!DOCTYPE book [
152N/A<!ENTITY mdash "&#8212;">]>
152N/A<!--
152N/A - Copyright (C) 2000, 2001, 2004, 2005, 2007, 2014-2016 Internet Systems Consortium, Inc. ("ISC")
152N/A -
152N/A - This Source Code Form is subject to the terms of the Mozilla Public
152N/A - License, v. 2.0. If a copy of the MPL was not distributed with this
152N/A - file, You can obtain one at http://mozilla.org/MPL/2.0/.
152N/A-->
152N/A
152N/A<!-- Converted by db4-upgrade version 1.0 -->
152N/A<refentry xmlns:db="http://docbook.org/ns/docbook" version="5.0">
152N/A <info>
152N/A <date>2007-06-18</date>
152N/A </info>
152N/A <refentryinfo>
152N/A <corpname>ISC</corpname>
152N/A <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
152N/A </refentryinfo>
152N/A
5718N/A <refmeta>
152N/A <refentrytitle>lwres_inetntop</refentrytitle>
5718N/A <manvolnum>3</manvolnum>
5718N/A <refmiscinfo>BIND9</refmiscinfo>
5718N/A </refmeta>
152N/A
152N/A <docinfo>
152N/A <copyright>
5718N/A <year>2000</year>
618N/A <year>2001</year>
152N/A <year>2004</year>
5718N/A <year>2005</year>
844N/A <year>2007</year>
5718N/A <year>2014</year>
5718N/A <year>2015</year>
1273N/A <year>2016</year>
1273N/A <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
5718N/A </copyright>
3661N/A </docinfo>
152N/A
152N/A <refnamediv>
152N/A <refname>lwres_net_ntop</refname>
5718N/A <refpurpose>lightweight resolver IP address presentation</refpurpose>
5718N/A </refnamediv>
844N/A <refsynopsisdiv>
5718N/A <funcsynopsis>
5718N/A<funcsynopsisinfo>#include &lt;lwres/net.h&gt;</funcsynopsisinfo>
5718N/A<funcprototype>
5718N/A <funcdef>
152N/Aconst char *
3996N/A<function>lwres_net_ntop</function></funcdef>
3996N/A <paramdef>int <parameter>af</parameter></paramdef>
3996N/A <paramdef>const void *<parameter>src</parameter></paramdef>
152N/A <paramdef>char *<parameter>dst</parameter></paramdef>
5718N/A <paramdef>size_t <parameter>size</parameter></paramdef>
5718N/A </funcprototype>
5718N/A</funcsynopsis>
5718N/A </refsynopsisdiv>
5718N/A
5718N/A <refsection><info><title>DESCRIPTION</title></info>
3983N/A
3983N/A
3983N/A <para><function>lwres_net_ntop()</function>
5718N/A converts an IP address of protocol family
5718N/A <parameter>af</parameter> &mdash; IPv4 or IPv6 &mdash; at
5718N/A location <parameter>src</parameter> from network format to its
5718N/A conventional representation as a string. For IPv4 addresses,
152N/A that string would be a dotted-decimal. An IPv6 address would be
5718N/A represented in colon notation as described in RFC1884.
152N/A </para>
5718N/A
277N/A <para>
3983N/A The generated string is copied to <parameter>dst</parameter>
152N/A provided
5718N/A <parameter>size</parameter> indicates it is long enough to
152N/A store the
4242N/A ASCII representation of the address.
4242N/A </para>
4242N/A
4242N/A </refsection>
4242N/A <refsection><info><title>RETURN VALUES</title></info>
5718N/A
5718N/A
5718N/A <para>
5718N/A If successful, the function returns <parameter>dst</parameter>:
5718N/A a pointer to a string containing the presentation format of the
683N/A address. <function>lwres_net_ntop()</function> returns
152N/A <type>NULL</type> and sets the global variable
4242N/A <constant>errno</constant> to <errorcode>EAFNOSUPPORT</errorcode> if
4242N/A the protocol family given in <parameter>af</parameter> is
4242N/A not
4242N/A supported.
5718N/A </para>
5718N/A
181N/A </refsection>
5718N/A <refsection><info><title>SEE ALSO</title></info>
5718N/A
5718N/A <para><citerefentry>
5718N/A <refentrytitle>RFC1884</refentrytitle>
5718N/A </citerefentry>,
5718N/A <citerefentry>
5718N/A <refentrytitle>inet_ntop</refentrytitle><manvolnum>3</manvolnum>
5718N/A </citerefentry>,
5718N/A <citerefentry>
5718N/A <refentrytitle>errno</refentrytitle><manvolnum>3</manvolnum>
5718N/A </citerefentry>.
5718N/A </para>
5718N/A </refsection>
5718N/A</refentry>
181N/A