Manpages

NOMBRE

inet_pton − Crea una estructura de dirección de red

SINOPSIS

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

int inet_pton(int af, const char *src, void *dst);

DESCRIPCIÓN

Esta función convierte la cadena de caracteres src en una estructura de dirección de red de la familia af , y copia la estructura de dirección de red a dst.

inet_pton(3) extiende la función de inet_addr(3) para soportar múltiples familias de direcciones, inet_addr(3) está considerada obsoleta hoy en día en favor de inet_pton(3). Las siguientes familias de direcciones están soportadas actualmente:
AF_INET

src apunta a una cadena de caracteres que contiene una dirección de red IPv4 en el formato decimal con puntos, "ddd.ddd.ddd.ddd". La dirección es convertida a una estructura in_addr y copiada a dst, que debe tener sizeof(struct in_addr) bytes de longitud.

AF_INET6

src apunta a una cadena de caracters que contiene una dirección de red IPv6 en cualquier formato de dirección IPv6 permitido. La dirección es convertida a una estructura in6_addr y copiada a dst, que debe tener sizeof(struct in6_addr) bytes de longitud.

Ciertos formatos hexadecimales y octales antiguos de direcciones AF_INET no están soportados por inet_pton, que los rechaza.

VALOR DEVUELTO

inet_pton devuelve un valor negativo y asigna a errno el valor EAFNOSUPPORT si af no contiene una familia de direcciones válida. Devuelve cero si src no contiene una cadena de caracteres que represente una dirección de red válida en la familia de direcciones especificada. Devuelve un valor positivo si la dirección de red fue convertida con éxito.

VÉASE TAMBIÉN

inet_ntop(3)

FALLOS

AF_INET6 no reconoce direcciones IPv4. Se debe pasar una dirección IPv4 debidamente mapeada a IPv6 en src en su lugar.