lwres_inetntop.html revision c651f15b30f1dae5cc2f00878fb5da5b3a35a468
499b34cea04a46823d003d4c0520c8b03e8513cbBrian Wellington<!--
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson - Copyright (C) 2000, 2001 Internet Software Consortium.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson -
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson - Permission to use, copy, modify, and distribute this software for any
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson - purpose with or without fee is hereby granted, provided that the above
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson - copyright notice and this permission notice appear in all copies.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson -
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson - PERFORMANCE OF THIS SOFTWARE.
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson-->
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson<!-- $Id: lwres_inetntop.html,v 1.11 2005/04/07 03:50:03 marka Exp $ -->
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson<HTML
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><HEAD
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><TITLE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>lwres_inetntop</TITLE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><META
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonNAME="GENERATOR"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><BODY
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="REFENTRY"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonBGCOLOR="#FFFFFF"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonTEXT="#000000"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonLINK="#0000FF"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonVLINK="#840084"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonALINK="#0000FF"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><H1
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><A
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonNAME="AEN1"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></A
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>lwres_inetntop</H1
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><DIV
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="REFNAMEDIV"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><A
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonNAME="AEN8"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></A
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><H2
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>Name</H2
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>lwres_net_ntop&nbsp;--&nbsp;lightweight resolver IP address presentation</DIV
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><DIV
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="REFSYNOPSISDIV"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><A
705cc52bbf49bdeedbaf255e91af2e325fc79ba5Brian WellingtonNAME="AEN11"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></A
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><H2
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>Synopsis</H2
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><DIV
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="FUNCSYNOPSIS"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><P
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></P
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><A
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonNAME="AEN12"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></A
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><PRE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="FUNCSYNOPSISINFO"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>#include &lt;lwres/net.h&gt;</PRE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><P
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="FUNCDEF"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>const char *
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonlwres_net_ntop</CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>(int af, const void *src, char *dst, size_t size);</CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></P
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><P
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></P
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></DIV
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></DIV
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><DIV
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="REFSECT1"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><A
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonNAME="AEN21"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></A
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><H2
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>DESCRIPTION</H2
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><P
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="FUNCTION"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>lwres_net_ntop()</CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson> converts an IP address of
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonprotocol family <CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="PARAMETER"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>af</CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson> &mdash; IPv4 or IPv6 &mdash;
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonat location <CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="PARAMETER"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>src</CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson> from network format to its
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonconventional representation as a string. For IPv4 addresses, that
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonstring would be a dotted-decimal. An IPv6 address would be
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonrepresented in colon notation as described in RFC1884.</P
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><P
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>The generated string is copied to <CODE
5f439956720839197eb984c397f90bdce40fa263Stephen JacobCLASS="PARAMETER"
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob>dst</CODE
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob> provided
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob<CODE
5f439956720839197eb984c397f90bdce40fa263Stephen JacobCLASS="PARAMETER"
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob>size</CODE
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob> indicates it is long enough to store the
5f439956720839197eb984c397f90bdce40fa263Stephen JacobASCII representation of the address.</P
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob></DIV
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob><DIV
5f439956720839197eb984c397f90bdce40fa263Stephen JacobCLASS="REFSECT1"
5f439956720839197eb984c397f90bdce40fa263Stephen Jacob><A
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonNAME="AEN30"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></A
e1f0415f3fc134cfc27757d7b015292bd623d9e4Brian Wellington><H2
e1f0415f3fc134cfc27757d7b015292bd623d9e4Brian Wellington>RETURN VALUES</H2
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><P
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>If successful, the function returns <CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="PARAMETER"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>dst</CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>:
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssona pointer to a string containing the presentation format of the
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonaddress. <CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="FUNCTION"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>lwres_net_ntop()</CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson> returns
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson<SPAN
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="TYPE"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>NULL</SPAN
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson> and sets the global variable
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson<CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="CONSTANT"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>errno</CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson> to <SPAN
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="ERRORCODE"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>EAFNOSUPPORT</SPAN
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson> if
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonthe protocol family given in <CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="PARAMETER"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>af</CODE
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson> is not
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafssonsupported.</P
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></DIV
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><DIV
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="REFSECT1"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><A
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonNAME="AEN39"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></A
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><H2
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>SEE ALSO</H2
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><P
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><SPAN
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="CITEREFENTRY"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><SPAN
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="REFENTRYTITLE"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>RFC1884</SPAN
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson></SPAN
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>,
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson<SPAN
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="CITEREFENTRY"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson><SPAN
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas GustafssonCLASS="REFENTRYTITLE"
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>inet_ntop</SPAN
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>(3)</SPAN
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson>,
c6ebabd5c3cb47ae8175abaeacbc1131f8117359Andreas Gustafsson<SPAN
705cc52bbf49bdeedbaf255e91af2e325fc79ba5Brian WellingtonCLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>errno</SPAN
>(3)</SPAN
>.</P
></DIV
></BODY
></HTML
>