Man page for lwres_getnameinfo
June 2, 2007 – 3:34 amLWRES_GETNAMEINFO
Section: BIND9 (3)
Updated: Jun 30, 2000
Index
Return to Main Contents
NAME
lwres_getnameinfo – lightweight resolver socket address structure to hostname and service name
SYNOPSIS
#include <lwres/netdb.h>
int lwres_getnameinfo(const struct sockaddr *sa, size_t salen, char *host, size_t hostlen, char *serv, size_t servlen, int flags);
DESCRIPTION
getnameinfo(3)
function defined in RFC2133.
lwres_getnameinfo()
returns the hostname for the
struct sockaddr
sa
which is
salen
bytes long. The hostname is of length
hostlen
and is returned via
*host.
The maximum length of the hostname is 1025 bytes:
NI_MAXHOST.
The name of the service associated with the port number in
sa
is returned in
*serv.
It is
servlen
bytes long. The maximum length of the service name is
NI_MAXSERV
– 32 bytes.
The
flags
argument sets the following bits:
NI_NOFQDN
A fully qualified domain name is not required for local hosts. The local part of the fully qualified domain name is returned instead.
NI_NUMERICHOST
Return the address in numeric form, as if calling inet_ntop(), instead of a host name.
NI_NAMEREQD
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.
NI_NUMERICSERV
The service name is returned as a digit string representing the port number.
NI_DGRAM
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.
RETURN VALUES
lwres_getnameinfo()
returns 0 on success or a non–zero error code if an error occurs.
SEE ALSO
RFC2133(),
getservbyport(3),
lwres(3),
lwres_getnameinfo(3),
lwres_getnamebyaddr(3).
lwres_net_ntop(3).
BUGS
RFC2133 fails to define what the nonzero return values of
getnameinfo(3)
are.
COPYRIGHT
Copyright © 2004, 2005, 2007 Internet Systems Consortium, Inc. ("ISC")
Copyright © 2000, 2001 Internet Software Consortium.
Index
Related posts:
- Man page for lwres_getipnode
- man avahi.service – Man page for avahi.service
- man Net::Domain – Man page for Net::Domain
- man Net::Domain – Man page for Net::Domain
- man hostname – Man page for hostname
- man ypset – Man page for ypset
- man getnameinfo – Man page for getnameinfo
- man IO::Socket::INET – Man page for IO::Socket::INET
- man IO::Socket::INET6 – Man page for IO::Socket::INET6
- Man page for lwres_gethostent
