src - OpenBSD base system

diff options


context:
space:
mode:

author	Jakob Schlyter <jakob@cvs.openbsd.org>	2007-12-09 13:39:46 +0000
committer	Jakob Schlyter <jakob@cvs.openbsd.org>	2007-12-09 13:39:46 +0000
commit	1173d5eff8dc423c129f442023419436ee94db23 (patch)
tree	57c2bcdc1429b2e80b91a387cd1dc561dab988eb /usr.sbin/bind/lib/lwres/man/lwres_getipnode.html
parent	e4a92ccc5f8c866478b32a346c71150a2cdf5001 (diff)

resolve conflicts

Diffstat (limited to 'usr.sbin/bind/lib/lwres/man/lwres_getipnode.html')

-rw-r--r--

usr.sbin/bind/lib/lwres/man/lwres_getipnode.html

327

1 files changed, 145 insertions, 182 deletions

diff --git a/usr.sbin/bind/lib/lwres/man/lwres_getipnode.html b/usr.sbin/bind/lib/lwres/man/lwres_getipnode.html
index d38c835eb0d..e080b935d8b 100644
--- a/usr.sbin/bind/lib/lwres/man/lwres_getipnode.html
+++ b/usr.sbin/bind/lib/lwres/man/lwres_getipnode.html

@@ -1,5 +1,5 @@

<!--

- Permission to use, copy, modify, and distribute this software for any

@@ -14,15 +14,15 @@

- OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

- PERFORMANCE OF THIS SOFTWARE.

-->

-

+

<html>

<head>

<title>lwres_getipnode</title>

-<meta name="generator" content="DocBook XSL Stylesheets V1.70.1">

+<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">

</head>

-<a name="id2482688"></a><div class="titlepage"></div>

+<a name="id2476275"></a><div class="titlepage"></div>

lwres_getipnodebyname, lwres_getipnodebyaddr, lwres_freehostent — lightweight resolver nodename / address translation API

@@ -36,29 +36,27 @@

struct hostent *

lwres_getipnodebyname(</code></td>

-<td> </td>

-<td>, </td>

-</tr>

-<tr>

-<td> </td>

-<td>, </td>

+<td>const char * </td>

+<td>

+<var class="pdparam">name</var>, </td>

</tr>

<tr>

-<td> </td>

-<td>, </td>

+<td>int </td>

+<td>

+<var class="pdparam">af</var>, </td>

</tr>

<tr>

-<td> </td>

-<td>, </td>

+<td>int </td>

+<td>

+<var class="pdparam">flags</var>, </td>

</tr>

<tr>

-<td> </td>

+<td>int * </td>

<td>

-<code>)</code>;</td>

+<var class="pdparam">error_num</var><code>)</code>;</td>

</tr>

</table>

@@ -66,62 +64,52 @@ struct hostent *

struct hostent *

lwres_getipnodebyaddr(</code></td>

-<td> </td>

-<td>, </td>

-</tr>

-<tr>

-<td> </td>

-<td>, </td>

+<td>const void * </td>

+<td>

+<var class="pdparam">src</var>, </td>

</tr>

<tr>

-<td> </td>

-<td>, </td>

+<td>size_t </td>

+<td>

+<var class="pdparam">len</var>, </td>

</tr>

<tr>

-<td> </td>

-<td>, </td>

+<td>int </td>

+<td>

+<var class="pdparam">af</var>, </td>

</tr>

<tr>

-<td> </td>

+<td>int * </td>

<td>

-<code>)</code>;</td>

+<var class="pdparam">error_num</var><code>)</code>;</td>

</tr>

</table>

-<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0">

-<tr>

+<table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr>

void

lwres_freehostent(</code></td>

-<td> </td>

-<td>

-<code>)</code>;</td>

-</tr>

-<tr>

-<td> </td>

+<td>struct hostent * </td>

<td>

-<code>)</code>;</td>

-</tr>

-</table>

+<var class="pdparam">he</var><code>)</code>;</td>

+</tr></table>

</div>

-<a name="id2549461"></a><h2>DESCRIPTION</h2>

+<a name="id2543431"></a><h2>DESCRIPTION</h2>

-These functions perform thread safe, protocol independent

-nodename-to-address and address-to-nodename

-translation as defined in RFC2553.

-

+ These functions perform thread safe, protocol independent

+ nodename-to-address and address-to-nodename

+ translation as defined in RFC2553.

+

-They use a

-struct hostent

-which is defined in

-<code class="filename">namedb.h</code>:

-

+ They use a

+ struct hostent

+ which is defined in

+ <code class="filename">namedb.h</code>:

+

struct hostent {

char *h_name; /* official name of host */

@@ -133,184 +121,159 @@ struct hostent {

#define h_addr h_addr_list[0] /* address, for backward compatibility */

</pre>

-

+

-The members of this structure are:

-

+ The members of this structure are:

+

<dd>

-The official (canonical) name of the host.

-</dd>

+ The official (canonical) name of the host.

+ </dd>

<dt><code class="constant">h_aliases</code></dt>

<dd>

-A NULL-terminated array of alternate names (nicknames) for the host.

-</dd>

+ A NULL-terminated array of alternate names (nicknames) for the

+ host.

+ </dd>

<dt><code class="constant">h_addrtype</code></dt>

<dd>

-The type of address being returned - usually

-PF_INET

-or

-PF_INET6.

+ The type of address being returned - usually

+ PF_INET

+ or

+ PF_INET6.

-</dd>

+ </dd>

<dt><code class="constant">h_length</code></dt>

<dd>

-The length of the address in bytes.

-</dd>

+ The length of the address in bytes.

+ </dd>

<dd>

-A

-NULL

-terminated array of network addresses for the host.

-Host addresses are returned in network byte order.

-</dd>

+ A

+ NULL

+ terminated array of network addresses for the host.

+ Host addresses are returned in network byte order.

+ </dd>

</dl></div>

-

-

-<code class="function">lwres_getipnodebyname()</code>

-looks up addresses of protocol family

-<code>af</code>

-for the hostname

-<code>name</code>.

+

+<code class="function">lwres_getipnodebyname()</code>

+ looks up addresses of protocol family <code>af</code>

+ for the hostname <code>name</code>. The

+ <code>flags</code> parameter contains ORed flag bits

+ to specify the types of addresses that are searched for, and the

+ types of addresses that are returned. The flag bits are:

-The

-<code>flags</code>

-parameter contains ORed flag bits to

-specify the types of addresses that are searched

-for, and the types of addresses that are returned.

-The flag bits are:

-

+

<dt><code class="constant">AI_V4MAPPED</code></dt>

<dd>

-This is used with an

-<code>af</code>

-of AF_INET6, and causes IPv4 addresses to be returned as IPv4-mapped

-IPv6 addresses.

-</dd>

+ This is used with an

+ <code>af</code>

+ of AF_INET6, and causes IPv4 addresses to be returned as

+ IPv4-mapped

+ IPv6 addresses.

+ </dd>

<dd>

-This is used with an

-<code>af</code>

-of AF_INET6, and causes all known addresses (IPv6 and IPv4) to be returned.

-If AI_V4MAPPED is also set, the IPv4 addresses are return as mapped

-IPv6 addresses.

-</dd>

+ This is used with an

+ <code>af</code>

+ of AF_INET6, and causes all known addresses (IPv6 and IPv4) to

+ be returned.

+ If AI_V4MAPPED is also set, the IPv4 addresses are return as

+ mapped

+ IPv6 addresses.

+ </dd>

<dt><code class="constant">AI_ADDRCONFIG</code></dt>

<dd>

-Only return an IPv6 or IPv4 address if here is an active network

-interface of that type. This is not currently implemented

-in the BIND 9 lightweight resolver, and the flag is ignored.

-</dd>

+ Only return an IPv6 or IPv4 address if here is an active network

+ interface of that type. This is not currently implemented

+ in the BIND 9 lightweight resolver, and the flag is ignored.

+ </dd>

<dt><code class="constant">AI_DEFAULT</code></dt>

<dd>

-This default sets the

-<code class="constant">AI_V4MAPPED</code>

-and

-<code class="constant">AI_ADDRCONFIG</code>

-flag bits.

-</dd>

+ This default sets the

+ <code class="constant">AI_V4MAPPED</code>

+ and

+ <code class="constant">AI_ADDRCONFIG</code>

+ flag bits.

+ </dd>

</dl></div>

-

-

-<code class="function">lwres_getipnodebyaddr()</code>

-performs a reverse lookup

-of address

-<code>src</code>

-which is

-<code>len</code>

-bytes long.

-<code>af</code>

-denotes the protocol family, typically

-PF_INET

-or

-PF_INET6.

-

-

-<code class="function">lwres_freehostent()</code>

-releases all the memory associated with

-the

-struct hostent

-pointer

-<code>he</code>.

-Any memory allocated for the

-<code class="constant">h_name</code>,

-<code class="constant">h_addr_list</code>

-and

-<code class="constant">h_aliases</code>

-is freed, as is the memory for the

-hostent

-structure itself.

-

+

+<code class="function">lwres_getipnodebyaddr()</code>

+ performs a reverse lookup of address <code>src</code>

+ which is <code>len</code> bytes long.

+ <code>af</code> denotes the protocol family, typically

+ PF_INET or PF_INET6.

+

+<code class="function">lwres_freehostent()</code>

+ releases all the memory associated with the struct

+ hostent pointer <code>he</code>. Any memory

+ allocated for the <code class="constant">h_name</code>,

+ <code class="constant">h_addr_list</code> and

+ <code class="constant">h_aliases</code> is freed, as is the memory for

+ the hostent structure itself.

+

</div>

-<a name="id2549832"></a><h2>RETURN VALUES</h2>

+<a name="id2543689"></a><h2>RETURN VALUES</h2>

-If an error occurs,

-<code class="function">lwres_getipnodebyname()</code>

-and

-<code class="function">lwres_getipnodebyaddr()</code>

-set

-<code>*error_num</code>

-to an appropriate error code and the function returns a

-NULL

-pointer.

-The error codes and their meanings are defined in

-<code class="filename"><lwres/netdb.h></code>:

-

+ If an error occurs,

+ <code class="function">lwres_getipnodebyname()</code>

+ and

+ <code class="function">lwres_getipnodebyaddr()</code>

+ set

+ <code>*error_num</code>

+ to an appropriate error code and the function returns a

+ NULL

+ pointer.

+ The error codes and their meanings are defined in

+ <code class="filename"><lwres/netdb.h></code>:

+

<dt><code class="constant">HOST_NOT_FOUND</code></dt>

<dd>

-No such host is known.

-</dd>

+ No such host is known.

+ </dd>

<dt><code class="constant">NO_ADDRESS</code></dt>

<dd>

-The server recognised the request and the name but no address is

-available. Another type of request to the name server for the

-domain might return an answer.

-</dd>

+ The server recognised the request and the name but no address is

+ available. Another type of request to the name server for the

+ domain might return an answer.

+ </dd>

<dt><code class="constant">TRY_AGAIN</code></dt>

<dd>

-A temporary and possibly transient error occurred, such as a

-failure of a server to respond. The request may succeed if

-retried.

-</dd>

+ A temporary and possibly transient error occurred, such as a

+ failure of a server to respond. The request may succeed if

+ retried.

+ </dd>

<dt><code class="constant">NO_RECOVERY</code></dt>

<dd>

-An unexpected failure occurred, and retrying the request

-is pointless.

-</dd>

+ An unexpected failure occurred, and retrying the request

+ is pointless.

+ </dd>

</dl></div>

-

-

-lwres_hstrerror(3

-)

-translates these error codes to suitable error messages.

-

+

+lwres_hstrerror(3)

+ translates these error codes to suitable error messages.

+

</div>

-<a name="id2549923"></a><h2>SEE ALSO</h2>

-

-RFC2553,

+<a name="id2543786"></a><h2>SEE ALSO</h2>

+RFC2553,

-lwres(3),

+ lwres(3),

-lwres_gethostent(3),

+ lwres_gethostent(3),

-lwres_getaddrinfo(3),

+ lwres_getaddrinfo(3),

-lwres_getnameinfo(3),

+ lwres_getnameinfo(3),

-lwres_hstrerror(3).

-

+ lwres_hstrerror(3).

+

</div>

</div></body>

</html>