Manpages

NOMBRE

inet_ntop − Analiza estructuras de dirección de red

SINOPSIS

#include <sys/types.h>
#include <sys/socket.h>
#include <arpa/inet.h>

const char *inet_ntop(int af, const void *src,
char *dst, size_t cnt);

DESCRIPCIÓN

Esta función convierte la estructura de dirección de red src en la familia de direcciones af en una cadena de caracteres, que es copiada a un buffer de caracteres dst, el cual tiene cnt bytes de longitud.

inet_ntop(3) extiende la función inet_ntoa(3) para soportar múltiples familias de direcciones, inet_ntoa(3) es considerada obsoleta en la actualidad en favor de inet_ntop(3). Las siguientes familias de direcciones de red están actualmente soportadas:
AF_INET

src apunta a una estructura in_addr (en orden de bytes de la red) que es convertida a una dirección de red IPv4 en el formato decimal con puntos, "ddd.ddd.ddd.ddd". El buffer dst debe tener al menos INET_ADDRSTRLEN bytes de longitud.

AF_INET6

src apunta a una estructura struct in6_addr (en orden de bytes de la red) que es convertida a una representación de esta dirección en el formato de dirección de red IPv6 más apropiado para dicha dirección. El buffer dst debe tener al menos INET6_ADDRSTRLEN bytes de longitud.

VALOR DEVUELTO

inet_ntop devuelve un puntero distinto de null a dst. Se devuelve NULL cuando hubo un error, y se asigna a errno el valor EAFNOSUPPORT si af no contiene una familia de direcciones válida, o el valor ENOSPC si la cadena con la dirección convertida sobrepasa el tamaño de dst dado por el argumento cnt.

VÉASE TAMBIÉN

inet_pton(3)

FALLOS

AF_INET6 convierte direcciones IPv4 traducidas a IPv6 a un formato IPv6.