542N/A<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"

542N/A "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"

1339N/A [<!ENTITY mdash "&#8212;">]>

919N/A

919N/A<refentry>

919N/A

919N/A <refentryinfo>

919N/A <date>June 18, 2007</date>

542N/A </refentryinfo>

542N/A

542N/A <refmeta>

542N/A <refentrytitle>lwres_getnameinfo</refentrytitle>

970N/A <manvolnum>3</manvolnum>

977N/A <refmiscinfo>BIND9</refmiscinfo>

970N/A </refmeta>

970N/A

1339N/A <docinfo>

1339N/A <copyright>

1339N/A <year>2004</year>

1339N/A <year>2005</year>

1339N/A <year>2007</year>

1339N/A <year>2014</year>

1339N/A <holder>Internet Systems Consortium, Inc. ("ISC")</holder>

542N/A </copyright>

542N/A <copyright>

542N/A <year>2000</year>

542N/A <year>2001</year>

542N/A <holder>Internet Software Consortium.</holder>

542N/A </copyright>

810N/A </docinfo>

542N/A

810N/A <refnamediv>

810N/A <refname>lwres_getnameinfo</refname>

810N/A <refpurpose>lightweight resolver socket address structure to hostname and

542N/A service name

851N/A </refpurpose>

542N/A </refnamediv>

542N/A <refsynopsisdiv>

542N/A <funcsynopsis>

542N/A<funcsynopsisinfo>#include &lt;lwres/netdb.h&gt;</funcsynopsisinfo>

542N/A<funcprototype>

542N/A <funcdef>

542N/Aint

970N/A<function>lwres_getnameinfo</function></funcdef>

970N/A <paramdef>const struct sockaddr *<parameter>sa</parameter></paramdef>

970N/A <paramdef>size_t <parameter>salen</parameter></paramdef>

542N/A <paramdef>char *<parameter>host</parameter></paramdef>

542N/A <paramdef>size_t <parameter>hostlen</parameter></paramdef>

542N/A <paramdef>char *<parameter>serv</parameter></paramdef>

542N/A <paramdef>size_t <parameter>servlen</parameter></paramdef>

922N/A <paramdef>int <parameter>flags</parameter></paramdef>

851N/A </funcprototype>

851N/A</funcsynopsis>

963N/A </refsynopsisdiv>

851N/A

963N/A <refsect1>

851N/A <title>DESCRIPTION</title>

542N/A

<para>

This function is equivalent to the

<citerefentry>

<refentrytitle>getnameinfo</refentrytitle><manvolnum>3</manvolnum>

</citerefentry> function defined in RFC2133.

<function>lwres_getnameinfo()</function> returns the

hostname for the

<type>struct sockaddr</type> <parameter>sa</parameter> which

is

<parameter>salen</parameter> bytes long. The hostname is of

length

<parameter>hostlen</parameter> and is returned via

<parameter>*host.</parameter> The maximum length of the

hostname is

1025 bytes: <constant>NI_MAXHOST</constant>.

</para>

<para> The name of the service associated with the port number in

<parameter>sa</parameter> is returned in <parameter>*serv.</parameter>

It is <parameter>servlen</parameter> bytes long. The

maximum length

of the service name is <constant>NI_MAXSERV</constant> - 32

bytes.

</para>

<para>

The <parameter>flags</parameter> argument sets the

following

bits:

<variablelist>

<varlistentry>

<term><constant>NI_NOFQDN</constant></term>

<listitem>

<para>

A fully qualified domain name is not required for local hosts.

The local part of the fully qualified domain name is returned

instead.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>NI_NUMERICHOST</constant></term>

<listitem>

<para>

Return the address in numeric form, as if calling inet_ntop(),

instead of a host name.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>NI_NAMEREQD</constant></term>

<listitem>

<para>

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.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>NI_NUMERICSERV</constant></term>

<listitem>

<para>

The service name is returned as a digit string representing the

port number.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>NI_DGRAM</constant></term>

<listitem>

<para>

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.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1>

<title>RETURN VALUES</title>

<para><function>lwres_getnameinfo()</function>

returns 0 on success or a non-zero error code if an error occurs.

</para>

</refsect1>

<refsect1>

<title>SEE ALSO</title>

<para><citerefentry>

<refentrytitle>RFC2133</refentrytitle>

</citerefentry>,

<citerefentry>

<refentrytitle>getservbyport</refentrytitle><manvolnum>3</manvolnum>

</citerefentry>,

<citerefentry>

<refentrytitle>lwres</refentrytitle><manvolnum>3</manvolnum>

</citerefentry>,

<citerefentry>

<refentrytitle>lwres_getnameinfo</refentrytitle><manvolnum>3</manvolnum>

</citerefentry>,

<citerefentry>

<refentrytitle>lwres_getnamebyaddr</refentrytitle><manvolnum>3</manvolnum>

</citerefentry>.

<citerefentry>

<refentrytitle>lwres_net_ntop</refentrytitle><manvolnum>3</manvolnum>

</citerefentry>.

</para>

</refsect1>

<refsect1>

<title>BUGS</title>

<para>

RFC2133 fails to define what the nonzero return values of

<citerefentry>

<refentrytitle>getnameinfo</refentrytitle><manvolnum>3</manvolnum>

</citerefentry>

are.

</para>

</refsect1>

</refentry><!--