diff options
Diffstat (limited to 'contrib/bind9/lib/lwres/man/lwres_getnameinfo.html')
| -rw-r--r-- | contrib/bind9/lib/lwres/man/lwres_getnameinfo.html | 410 |
1 files changed, 137 insertions, 273 deletions
diff --git a/contrib/bind9/lib/lwres/man/lwres_getnameinfo.html b/contrib/bind9/lib/lwres/man/lwres_getnameinfo.html index 8130fe8321170..6e7a7b1665879 100644 --- a/contrib/bind9/lib/lwres/man/lwres_getnameinfo.html +++ b/contrib/bind9/lib/lwres/man/lwres_getnameinfo.html @@ -1,290 +1,154 @@ <!-- - - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") - - Copyright (C) 2001 Internet Software Consortium. - - + - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") + - Copyright (C) 2000, 2001 Internet Software Consortium. + - - Permission to use, copy, modify, and distribute this software for any - purpose with or without fee is hereby granted, provided that the above - copyright notice and this permission notice appear in all copies. - - + - - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY - - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, + - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> - -<!-- $Id: lwres_getnameinfo.html,v 1.5.2.1.4.2 2004/08/22 23:39:04 marka Exp $ --> - -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<HTML -><HEAD -><TITLE ->lwres_getnameinfo</TITLE -><META -NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD -><BODY -CLASS="REFENTRY" -BGCOLOR="#FFFFFF" -TEXT="#000000" -LINK="#0000FF" -VLINK="#840084" -ALINK="#0000FF" -><H1 -><A -NAME="AEN1" -></A ->lwres_getnameinfo</H1 -><DIV -CLASS="REFNAMEDIV" -><A -NAME="AEN8" -></A -><H2 ->Name</H2 ->lwres_getnameinfo -- lightweight resolver socket address structure to hostname and service name</DIV -><DIV -CLASS="REFSYNOPSISDIV" -><A -NAME="AEN11" -></A -><H2 ->Synopsis</H2 -><DIV -CLASS="FUNCSYNOPSIS" -><P -></P -><A -NAME="AEN12" -></A -><PRE -CLASS="FUNCSYNOPSISINFO" ->#include <lwres/netdb.h></PRE -><P -><CODE -><CODE -CLASS="FUNCDEF" ->int -lwres_getnameinfo</CODE ->(const struct sockaddr *sa, size_t salen, char *host, size_t hostlen, char *serv, size_t servlen, int flags);</CODE -></P -><P -></P -></DIV -></DIV -><DIV -CLASS="REFSECT1" -><A -NAME="AEN24" -></A -><H2 ->DESCRIPTION</H2 -><P -> This function is equivalent to the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->getnameinfo</SPAN ->(3)</SPAN -> function defined in RFC2133. -<CODE -CLASS="FUNCTION" ->lwres_getnameinfo()</CODE -> returns the hostname for the -<SPAN -CLASS="TYPE" ->struct sockaddr</SPAN -> <VAR -CLASS="PARAMETER" ->sa</VAR -> which is -<VAR -CLASS="PARAMETER" ->salen</VAR -> bytes long. The hostname is of length -<VAR -CLASS="PARAMETER" ->hostlen</VAR -> and is returned via -<VAR -CLASS="PARAMETER" ->*host.</VAR -> The maximum length of the hostname is -1025 bytes: <CODE -CLASS="CONSTANT" ->NI_MAXHOST</CODE ->.</P -><P -> The name of the service associated with the port number in -<VAR -CLASS="PARAMETER" ->sa</VAR -> is returned in <VAR -CLASS="PARAMETER" ->*serv.</VAR -> -It is <VAR -CLASS="PARAMETER" ->servlen</VAR -> bytes long. The maximum length -of the service name is <CODE -CLASS="CONSTANT" ->NI_MAXSERV</CODE -> - 32 bytes.</P -><P -> The <VAR -CLASS="PARAMETER" ->flags</VAR -> argument sets the following +<!-- $Id: lwres_getnameinfo.html,v 1.5.2.1.4.9 2005/10/13 02:33:56 marka Exp $ --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>lwres_getnameinfo</title> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> +</head> +<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> +<a name="id2463721"></a><div class="titlepage"></div> +<div class="refnamediv"> +<h2>Name</h2> +<p>lwres_getnameinfo — lightweight resolver socket address structure to hostname and service name</p> +</div> +<div class="refsynopsisdiv"> +<h2>Synopsis</h2> +<div class="funcsynopsis"> +<pre class="funcsynopsisinfo">#include <lwres/netdb.h></pre> +<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"> +<tr> +<td><code class="funcdef"> +int +<b class="fsfunc">lwres_getnameinfo</b>(</code></td> +<td> </td> +<td>, </td> +</tr> +<tr> +<td> </td> +<td> </td> +<td>, </td> +</tr> +<tr> +<td> </td> +<td> </td> +<td>, </td> +</tr> +<tr> +<td> </td> +<td> </td> +<td>, </td> +</tr> +<tr> +<td> </td> +<td> </td> +<td>, </td> +</tr> +<tr> +<td> </td> +<td> </td> +<td>, </td> +</tr> +<tr> +<td> </td> +<td> </td> +<td> +<code>)</code>;</td> +</tr> +</table> +</div> +</div> +<div class="refsect1" lang="en"> +<a name="id2525862"></a><h2>DESCRIPTION</h2> +<p> This function is equivalent to the <span class="citerefentry"><span class="refentrytitle">getnameinfo</span>(3)</span> function defined in RFC2133. +<code class="function">lwres_getnameinfo()</code> returns the hostname for the +<span class="type">struct sockaddr</span> <em class="parameter"><code>sa</code></em> which is +<em class="parameter"><code>salen</code></em> bytes long. The hostname is of length +<em class="parameter"><code>hostlen</code></em> and is returned via +<em class="parameter"><code>*host.</code></em> The maximum length of the hostname is +1025 bytes: <code class="constant">NI_MAXHOST</code>.</p> +<p> The name of the service associated with the port number in +<em class="parameter"><code>sa</code></em> is returned in <em class="parameter"><code>*serv.</code></em> +It is <em class="parameter"><code>servlen</code></em> bytes long. The maximum length +of the service name is <code class="constant">NI_MAXSERV</code> - 32 bytes. +</p> +<p> The <em class="parameter"><code>flags</code></em> argument sets the following bits: -<P -></P -><DIV -CLASS="VARIABLELIST" -><DL -><DT -><CODE -CLASS="CONSTANT" ->NI_NOFQDN</CODE -></DT -><DD -><P ->A fully qualified domain name is not required for local hosts. -The local part of the fully qualified domain name is returned instead.</P -></DD -><DT -><CODE -CLASS="CONSTANT" ->NI_NUMERICHOST</CODE -></DT -><DD -><P ->Return the address in numeric form, as if calling inet_ntop(), -instead of a host name.</P -></DD -><DT -><CODE -CLASS="CONSTANT" ->NI_NAMEREQD</CODE -></DT -><DD -><P ->A name is required. If the hostname cannot be found in the DNS and +</p> +<div class="variablelist"><dl> +<dt><span class="term"><code class="constant">NI_NOFQDN</code></span></dt> +<dd><p> +A fully qualified domain name is not required for local hosts. +The local part of the fully qualified domain name is returned instead. +</p></dd> +<dt><span class="term"><code class="constant">NI_NUMERICHOST</code></span></dt> +<dd><p> +Return the address in numeric form, as if calling inet_ntop(), +instead of a host name. +</p></dd> +<dt><span class="term"><code class="constant">NI_NAMEREQD</code></span></dt> +<dd><p> +A name is required. If the hostname cannot be found in the DNS and this flag is set, a non-zero error code is returned. If the hostname is not found and the flag is not set, the -address is returned in numeric form.</P -></DD -><DT -><CODE -CLASS="CONSTANT" ->NI_NUMERICSERV</CODE -></DT -><DD -><P ->The service name is returned as a digit string representing the port number.</P -></DD -><DT -><CODE -CLASS="CONSTANT" ->NI_DGRAM</CODE -></DT -><DD -><P ->Specifies that the service being looked up is a datagram +address is returned in numeric form. +</p></dd> +<dt><span class="term"><code class="constant">NI_NUMERICSERV</code></span></dt> +<dd><p> +The service name is returned as a digit string representing the port number. +</p></dd> +<dt><span class="term"><code class="constant">NI_DGRAM</code></span></dt> +<dd><p> +Specifies that the service being looked up is a datagram service, and causes getservbyport() to be called with a second argument of "udp" instead of its default of "tcp". This is required for the few ports (512-514) that have different services for UDP and -TCP.</P -></DD -></DL -></DIV -></P -></DIV -><DIV -CLASS="REFSECT1" -><A -NAME="AEN70" -></A -><H2 ->RETURN VALUES</H2 -><P -><CODE -CLASS="FUNCTION" ->lwres_getnameinfo()</CODE -> -returns 0 on success or a non-zero error code if an error occurs.</P -></DIV -><DIV -CLASS="REFSECT1" -><A -NAME="AEN74" -></A -><H2 ->SEE ALSO</H2 -><P -><SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->RFC2133</SPAN -></SPAN ->, -<SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->getservbyport</SPAN ->(3)</SPAN ->, -<SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->lwres</SPAN ->(3)</SPAN ->, -<SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->lwres_getnameinfo</SPAN ->(3)</SPAN ->, -<SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->lwres_getnamebyaddr</SPAN ->(3)</SPAN ->. -<SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->lwres_net_ntop</SPAN ->(3)</SPAN ->.</P -></DIV -><DIV -CLASS="REFSECT1" -><A -NAME="AEN94" -></A -><H2 ->BUGS</H2 -><P ->RFC2133 fails to define what the nonzero return values of -<SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->getnameinfo</SPAN ->(3)</SPAN -> -are.</P -></DIV -></BODY -></HTML -> +TCP. +</p></dd> +</dl></div> +<p> +</p> +</div> +<div class="refsect1" lang="en"> +<a name="id2525988"></a><h2>RETURN VALUES</h2> +<p> +<code class="function">lwres_getnameinfo()</code> +returns 0 on success or a non-zero error code if an error occurs. +</p> +</div> +<div class="refsect1" lang="en"> +<a name="id2526001"></a><h2>SEE ALSO</h2> +<p> +<span class="citerefentry"><span class="refentrytitle">RFC2133</span></span>, +<span class="citerefentry"><span class="refentrytitle">getservbyport</span>(3)</span>, +<span class="citerefentry"><span class="refentrytitle">lwres</span>(3)</span>, +<span class="citerefentry"><span class="refentrytitle">lwres_getnameinfo</span>(3)</span>, +<span class="citerefentry"><span class="refentrytitle">lwres_getnamebyaddr</span>(3)</span>. +<span class="citerefentry"><span class="refentrytitle">lwres_net_ntop</span>(3)</span>. +</p> +</div> +<div class="refsect1" lang="en"> +<a name="id2526059"></a><h2>BUGS</h2> +<p> +RFC2133 fails to define what the nonzero return values of +<span class="citerefentry"><span class="refentrytitle">getnameinfo</span>(3)</span> +are. +</p> +</div> +</div></body> +</html> |