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

Página de Manual de Linux                       11 diciembre 2000                                 getnameinfo(3)