NAME

       inet_ntop - Parse network address structures

SYNOPSIS

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

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

DESCRIPTION

       This  function  converts the network address structure src in the af address family into a
       character string, which is copied to a character buffer dst, which is cnt bytes long.

       inet_ntop(3) extends the inet_ntoa(3)  function  to  support  multiple  address  families,
       inet_ntoa(3)  is  now considered to be deprecated in favor of inet_ntop(3).  The following
       address families are currently supported:

       AF_INET       src points to  a  struct  in_addr  (network  byte  order  format)  which  is
                     converted   to   an   IPv4   network  address  in  the  dotted-quad  format,
                     "ddd.ddd.ddd.ddd".  The buffer buf must be at  least  INET_ADDRSTRLEN  bytes
                     long.

       AF_INET6      src  points  to  a  struct  in6_addr  (network  byte  order format) which is
                     converted to a representation of this address in the most  appropriate  IPv6
                     network  address  format  for this address.  The buffer buf must be at least
                     INET6_ADDRSTRLEN bytes long.

RETURN VALUES

       inet_ntop returns a non-null pointer to buf.  NULL is returned if there was an error, with
       errno set to EAFNOSUPPORT if af was not set to a valid address family, or to ENOSPC if the
       converted address string would exceed the size of buf, given by the cnt argument.

SEE ALSO

       inet_pton(3)

BUGS

       AF_INET6 converts IPv6-mapped IPv4 addresses into an IPv6 format.