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.

Linux Man Page                                    May 18, 2000                                      inet_ntop(3)