lwres_getnameinfo.docbook revision 5cd4555ad444fd391002ae32450572054369fd42
f743002678eb67b99bbc29fee116b65d9530fec0wrowe<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
80833bb9a1bf25dcf19e814438a4b311d2e1f4cffuankg "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
16f23f109da3b82fdca8695789bec9f06e2e3383humbedooh [<!ENTITY mdash "—">]>
c12b284247f00b5696adabb0b855ce0669465764ylavic - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
c12b284247f00b5696adabb0b855ce0669465764ylavic - Copyright (C) 2000, 2001 Internet Software Consortium.
6029353b43240f5fa7feede018ce0e3ab1600c96covener - Permission to use, copy, modify, and distribute this software for any
6029353b43240f5fa7feede018ce0e3ab1600c96covener - purpose with or without fee is hereby granted, provided that the above
6029353b43240f5fa7feede018ce0e3ab1600c96covener - copyright notice and this permission notice appear in all copies.
8861e3760584fe7f451b3519163502a63c406eb3humbedooh - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
8861e3760584fe7f451b3519163502a63c406eb3humbedooh - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
e1f43cac62f6960a6945e1fb6e3288ef7082ac53rpluem - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
e1f43cac62f6960a6945e1fb6e3288ef7082ac53rpluem - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
e1f43cac62f6960a6945e1fb6e3288ef7082ac53rpluem - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
e1f43cac62f6960a6945e1fb6e3288ef7082ac53rpluem - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
f06e7c4b1bce6b6491e5de0b7998d3f5696b293dchrisd - PERFORMANCE OF THIS SOFTWARE.
179565be4043d7e5f9161aa75271fa0a001866d9covener<!-- $Id: lwres_getnameinfo.docbook,v 1.8 2007/01/29 22:16:02 sra Exp $ -->
111436a32ba1254291e4883292fb116d15fe8f64covener <refentryinfo>
fce4949fb0b309a5744afcd503c6ed2d35621ee2covener </refentryinfo>
d522f82d7ada07a0cedb8dc6b71eacf3477d7188trawick <copyright>
1e1539a1e7d64b1af92636b81aac5aa50ee3163bminfrin <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
1e1539a1e7d64b1af92636b81aac5aa50ee3163bminfrin </copyright>
1e1539a1e7d64b1af92636b81aac5aa50ee3163bminfrin <copyright>
efe780dcf13b2b95effabf897d694d8f23feac74trawick </copyright>
81849cd8925f6ffaf57412aaaac8a6df0d33cbb6covener <refnamediv>
c8e4ae58e7b9eb27e5158d6980770d5064c50ba7trawick <refpurpose>lightweight resolver socket address structure to hostname and
c8e4ae58e7b9eb27e5158d6980770d5064c50ba7trawick service name
c8e4ae58e7b9eb27e5158d6980770d5064c50ba7trawick </refpurpose>
c8e4ae58e7b9eb27e5158d6980770d5064c50ba7trawick </refnamediv>
fe83f60b41477b14a37edcfcd1f7f5c5a1ebfe44minfrin <refsynopsisdiv>
fe83f60b41477b14a37edcfcd1f7f5c5a1ebfe44minfrin <funcsynopsis>
fe83f60b41477b14a37edcfcd1f7f5c5a1ebfe44minfrin<funcsynopsisinfo>#include <lwres/netdb.h></funcsynopsisinfo>
993d1261a278d7322bccef219101220b7b4fb8c5jkaluza<funcprototype>
3b995de5609b15115a0764e6979ba43071a2988fjim <paramdef>const struct sockaddr *<parameter>sa</parameter></paramdef>
3b995de5609b15115a0764e6979ba43071a2988fjim <paramdef>size_t <parameter>salen</parameter></paramdef>
ba050a6f942b9fa0e81ed73437588005c569655ccovener <paramdef>char *<parameter>host</parameter></paramdef>
ba050a6f942b9fa0e81ed73437588005c569655ccovener <paramdef>size_t <parameter>hostlen</parameter></paramdef>
ba050a6f942b9fa0e81ed73437588005c569655ccovener <paramdef>char *<parameter>serv</parameter></paramdef>
ba050a6f942b9fa0e81ed73437588005c569655ccovener <paramdef>size_t <parameter>servlen</parameter></paramdef>
ba050a6f942b9fa0e81ed73437588005c569655ccovener <paramdef>int <parameter>flags</parameter></paramdef>
ba050a6f942b9fa0e81ed73437588005c569655ccovener </funcprototype>
ba050a6f942b9fa0e81ed73437588005c569655ccovener</funcsynopsis>
135ddda3a989215d2bedbcf1529bfb269c3eda23niq </refsynopsisdiv>
135ddda3a989215d2bedbcf1529bfb269c3eda23niq <refsect1>
001a44c352f89c9ec332ffd3e0a6927dcd19432chumbedooh This function is equivalent to the
001a44c352f89c9ec332ffd3e0a6927dcd19432chumbedooh <citerefentry>
001a44c352f89c9ec332ffd3e0a6927dcd19432chumbedooh <refentrytitle>getnameinfo</refentrytitle><manvolnum>3</manvolnum>
efe780dcf13b2b95effabf897d694d8f23feac74trawick </citerefentry> function defined in RFC2133.
793214f67dede32edfd9ee96c664ead04d175cbbjfclere <function>lwres_getnameinfo()</function> returns the
cc5a4a08dc9783fcbc52ce86f11e01c281a43810minfrin hostname for the
33124689065ade0dfc8c54d8ebb734f9439cb89btrawick <type>struct sockaddr</type> <parameter>sa</parameter> which
33124689065ade0dfc8c54d8ebb734f9439cb89btrawick <parameter>salen</parameter> bytes long. The hostname is of
9b0076ddd1103e5fa9c1f9bafde4b06ce244fbaecovener <parameter>*host.</parameter> The maximum length of the
249d09d51808cb7981af99762c3b3736ca126cd5jkaluza hostname is
56589be3d7a3e9343370df240010c6928cc78b39jkaluza <para> The name of the service associated with the port number in
56589be3d7a3e9343370df240010c6928cc78b39jkaluza <parameter>sa</parameter> is returned in <parameter>*serv.</parameter>
56589be3d7a3e9343370df240010c6928cc78b39jkaluza It is <parameter>servlen</parameter> bytes long. The
652bacc79dd7f980249784cc8c4838e8f1de7e8acovener maximum length
652bacc79dd7f980249784cc8c4838e8f1de7e8acovener of the service name is <constant>NI_MAXSERV</constant> - 32
50cfe8bbbaf4279375802531268e2bf0155215fetrawick <variablelist>
50cfe8bbbaf4279375802531268e2bf0155215fetrawick <varlistentry>
f87299dab99bc04b51a6b8cad51b6795db862c0atrawick A fully qualified domain name is not required for local hosts.
4d12805e6c18253040223ea637acd6b3b3c18f60jorton The local part of the fully qualified domain name is returned
4d12805e6c18253040223ea637acd6b3b3c18f60jorton </listitem>
4d12805e6c18253040223ea637acd6b3b3c18f60jorton </varlistentry>
e5d909f2b06bd880fb3675cd49363df981caa631trawick <varlistentry>
cb666b29f81df1d11d65002250153353568021fccovener Return the address in numeric form, as if calling inet_ntop(),
cb666b29f81df1d11d65002250153353568021fccovener instead of a host name.
6a80c3c6f4b8ea7ba5e89402b8b779b09ce020e0covener </listitem>
1c2cab00d988fc48cbe59032cf76cc0bab20d6f7covener </varlistentry>
6a80c3c6f4b8ea7ba5e89402b8b779b09ce020e0covener <varlistentry>
1f50dc34ae069adeed20b2986e5ffdefa5c410e0covener A name is required. If the hostname cannot be found in the DNS
1f50dc34ae069adeed20b2986e5ffdefa5c410e0covener this flag is set, a non-zero error code is returned.
63a5ea80bddcc84a462e40f402b4f330e0e05411covener If the hostname is not found and the flag is not set, the
63a5ea80bddcc84a462e40f402b4f330e0e05411covener address is returned in numeric form.
63a5ea80bddcc84a462e40f402b4f330e0e05411covener </listitem>
986f3ea2c314d4d4b3b937149853a0f23f6119aaminfrin </varlistentry>
986f3ea2c314d4d4b3b937149853a0f23f6119aaminfrin <varlistentry>
65a4e663b82f8bce28ac22ab2edfd7502de36998sf <listitem>
65a4e663b82f8bce28ac22ab2edfd7502de36998sf The service name is returned as a digit string representing the
65a4e663b82f8bce28ac22ab2edfd7502de36998sf port number.
74e7f6c55fd67b10cb400b3f6d1dc718a303d944minfrin </listitem>
74e7f6c55fd67b10cb400b3f6d1dc718a303d944minfrin </varlistentry>
74e7f6c55fd67b10cb400b3f6d1dc718a303d944minfrin <varlistentry>
a511a29faf2ff7ead3b67680154a624effb31aafminfrin Specifies that the service being looked up is a datagram
a511a29faf2ff7ead3b67680154a624effb31aafminfrin service, and causes getservbyport() to be called with a second
a511a29faf2ff7ead3b67680154a624effb31aafminfrin argument of "udp" instead of its default of "tcp". This is
63921358ef93fcb41bc71d9894221ba3d7fbb87bminfrin for the few ports (512-514) that have different services for UDP
6d601599d3d65df0410eae6e573e75b2dbfb1fb4minfrin </listitem>
6d601599d3d65df0410eae6e573e75b2dbfb1fb4minfrin </varlistentry>
6d601599d3d65df0410eae6e573e75b2dbfb1fb4minfrin </variablelist>
4c02bab56a528a180bbe394d8b6e6fd9c1a3ac1esf </refsect1>
4c02bab56a528a180bbe394d8b6e6fd9c1a3ac1esf <refsect1>
684e0cfc200f66287a93bbd1708d1dd8a92a7eefcovener returns 0 on success or a non-zero error code if an error occurs.
05a5a9c3e16f21566e1b61f4bd68025ce1b741ccjoes </refsect1>
05a5a9c3e16f21566e1b61f4bd68025ce1b741ccjoes <refsect1>
ef82e8fa164e0a1f8b813f7deb6b7ead96018c94niq </citerefentry>,
ef82e8fa164e0a1f8b813f7deb6b7ead96018c94niq <citerefentry>
ef82e8fa164e0a1f8b813f7deb6b7ead96018c94niq <refentrytitle>getservbyport</refentrytitle><manvolnum>3</manvolnum>
ef82e8fa164e0a1f8b813f7deb6b7ead96018c94niq </citerefentry>,
ef82e8fa164e0a1f8b813f7deb6b7ead96018c94niq <citerefentry>
413ee814748f37be168ff12407fa6dba0ceeabe6trawick <refentrytitle>lwres</refentrytitle><manvolnum>3</manvolnum>
c12917da693bae4028a1d5a5e8224bceed8c739dsf </citerefentry>,
c12917da693bae4028a1d5a5e8224bceed8c739dsf <citerefentry>
eafcc0ebf263d0ba69855b6e10958c4c1a2361bdsf <refentrytitle>lwres_getnameinfo</refentrytitle><manvolnum>3</manvolnum>
eafcc0ebf263d0ba69855b6e10958c4c1a2361bdsf </citerefentry>,
eafcc0ebf263d0ba69855b6e10958c4c1a2361bdsf <citerefentry>
eafcc0ebf263d0ba69855b6e10958c4c1a2361bdsf <refentrytitle>lwres_getnamebyaddr</refentrytitle><manvolnum>3</manvolnum>
eafcc0ebf263d0ba69855b6e10958c4c1a2361bdsf </citerefentry>.
d7ffd2da16d58b1a0de212e4d56f7aebb72bef26sf <citerefentry>
d7ffd2da16d58b1a0de212e4d56f7aebb72bef26sf <refentrytitle>lwres_net_ntop</refentrytitle><manvolnum>3</manvolnum>
d7ffd2da16d58b1a0de212e4d56f7aebb72bef26sf </citerefentry>.
4576c1a9ef54cd1e5555ee07d016a7f559f80338sf </refsect1>
4576c1a9ef54cd1e5555ee07d016a7f559f80338sf <refsect1>
9811aed12bbc71783d2e544ccb5fecd193843eadsf RFC2133 fails to define what the nonzero return values of
88fac54d9d64f85bbdab5d7010816f4377f95bd7rjung <citerefentry>
88fac54d9d64f85bbdab5d7010816f4377f95bd7rjung <refentrytitle>getnameinfo</refentrytitle><manvolnum>3</manvolnum>
bd3f5647b96d378d9c75c954e3f13582af32c643sf </citerefentry>
bd3f5647b96d378d9c75c954e3f13582af32c643sf </refsect1>
2a7beea91d46beb41f043a84eaad060047ee04aafabien - Local variables:
2a7beea91d46beb41f043a84eaad060047ee04aafabien - mode: sgml