Provided by:
manpages-es_1.55-3_all 
NOMBRE
getnameinfo - traducción dirección-a-nombre de forma independiente del
protocolo
SINOPSIS
#include <sys/socket.h>
#include <netdb.h>
int getnameinfo(const struct sockaddr *sa, socklen_t salen,
char *host, size_t hostlen,
char *serv, size_t servlen, int flags);
DESCRIPCIÓN
La función getnameinfo(3) se define para la traducción dirección-a-
nombrenodo de manera independiente del protocolo. Combina la
funcionalidad de gethostbyaddr(3) y getservbyport(3) y es la inversa de
getaddrinfo(3). El argumento sa es un puntero a una estructura
genérica de dirección de conector (socket) (de tipo sockaddr_in o
sockaddr_in6) de tamaño salen que contiene la dirección IP y el número
del puerto de entrada. Los argumentos host y serv son punteros a
buffers (de tamaño hostlen y servlen respectivamente) que se utilizan
para almacenar los valores devueltos.
El invocador puede especificar que no se solicita ningún nombre de host
(o nombre de servicio) pasando como argumento host (o serv) el valor
NULL o asignando cero al parámetro hostlen (o servlen). Sin embargo,
al menos uno de los dos, nombre de host o nombre de servicio, debe ser
solicitado.
El argumento flags modifica el comportamiento de getnameinfo(3) como
sigue:
NI_NOFQDN
Si se activa, devuelve solamente la parte del nombre de host
correspondiente al FQDN para hosts locales.
NI_NUMERICHOST
Si se activa, se devuelve la forma numérica del nombre de host.
(Si no se activa, devolverá igualmente este valor en el caso en
que el nombre de nodo no pueda ser buscado.)
NI_NAMEREQD
Si se activa, se devuelve un error cuando el nombre de host no
puede ser buscado.
NI_NUMERICSERV
Si se activa, la dirección del servicio se devuelve en formato
numérico, por ejemplo, mediante su número de puerto.
NI_DGRAM
Si se activa, el servicio se basa en datagramas (UDP) en vez de
basarse en flujos (TCP). Se necesita para los pocos puertos
(512-514) que tienen servicios diferentes para UDP y TCP.
VALOR DEVUELTO
Cuando tiene éxito se devuelve 0 y los nombres de nodo y de servicio,
si se solicitan, se rellenan con cadenas terminadas en NUL,
posiblemente truncadas para ajustarse al tamaño especificado de los
buffers. En caso de error se devuelve un valor distinto de cero y se
modifica errno apropiadamente.
ERRORES
EAI_AGAIN
El nombre no pudo resolverse en este instante. Pruebe de nuevo
más tarde.
EAI_BADFLAGS
El parámetro flags tiene un valor inválido.
EAI_FAIL
Ocurrió un error no recuperable.
EAI_FAMILY
No se reconoció la familia de direcciones o la longitud de la
dirección es inválida para la familia especificada.
EAI_MEMORY
Memoria insuficiente.
EAI_NONAME
El nombre no se resuelve para los parámetros pasados. Se
especificó la opción NI_NAMEREQD y el nombre de host no pudo ser
localizado o ni el nombre de host ni el nombre de servicio
fueron solicitados.
EAI_SYSTEM
Ocurrió un error de sistema. El código de error puede
encontrarse en errno.
FICHEROS
/etc/hosts
/etc/nsswitch.conf
/etc/resolv.conf
NOTA
Con el objetivo de ayudar al programador a elegir tamaños razonables
para los buffers suministrados, <netdb.h> define las constantes
# define NI_MAXHOST 1025
# define NI_MAXSERV 32
La primera es la constante MAXDNAME en versiones recientes del fichero
de cabecera <arpa/nameser.h> de BIND. La última es una suposición
basada en los servicios listados en el actual RFC de Numeros Asignados.
EJEMPLOS
El código siguiente trata de obtener el nombre de host y el nombre de
servicio en formato numérico, para una dirección de conector dada.
Observe que no hay una referencia explícita a una familia de
direcciones particular.
struct sockaddr *sa; /* entrada */
char hbuf[NI_MAXHOST], sbuf[NI_MAXSERV];
if (getnameinfo(sa, sa->sa_len, hbuf, sizeof(hbuf), sbuf,
sizeof(sbuf), NI_NUMERICHOST | NI_NUMERICSERV) == 0)
printf("host=%s, serv=%s\n", hbuf, sbuf);
La siguiente versión comprueba si la dirección de conector tiene una
correspondencia inversa.
struct sockaddr *sa; /* entrada */
char hbuf[NI_MAXHOST];
if (getnameinfo(sa, sa->sa_len, hbuf, sizeof(hbuf),
NULL, 0, NI_NAMEREQD))
printf("could not resolve hostname");
else
printf("host=%s\n", hbuf);
CONFORME A
RFC 2553. (Véase también XNS, apartado 5.2.)
VÉASE TAMBIÉN
getaddrinfo(3), gethostbyaddr(3), getservbyname(3), getservbyport(3),
inet_ntop(3), socket(3), hosts(5), services(5), hostname(7), named(8)
R. Gilligan, S. Thomson, J. Bound y W. Stevens, Basic Socket Interface
Extensions for IPv6, RFC 2553, Marzo de 1999.
Tatsuya Jinmei y Atsushi Onoe, An Extension of Format for IPv6 Scoped
Addresses, internet draft, work in progress.
ftp://ftp.ietf.org/internet-drafts/draft-ietf-ipngwg-scopedaddr-
format-02.txt
Craig Metz, Protocol Independence Using the Sockets API, Proceedings of
the freenix track: 2000 USENIX annual technical conference, June 2000.
http://www.usenix.org/publications/library/proceedings/usenix2000/freenix/metzprotocol.html