NAME    [Toc]    [Back]

       inet_ntop - Convert a numeric address to a text string

SYNOPSIS    [Toc]    [Back]

       #include <arpa/inet.h>

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

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       Specifies  the  address  family.  Valid values are AF_INET
       for an Internet Protocol  Version  4  (IPv4)  address  and
       AF_INET6  for  an  IPv6  address.  Points to a buffer that
       contains the numeric Internet address.  Points to a buffer
       that is to contain the text string.  Specifies the size of
       the buffer pointed to by the dst parameter.  For  Internet
       Protocol  Version  4  (IPv4) addresses, the minimum buffer
       size is 16 octets. For IPv6 addresses, the minimum  buffer
       size  is  46  octets.   The <netinet/in.h file defines the
       INET_ADDRSTRLEN and  INET6_ADDRSTRLEN  constants,  respectively,
 for for these values.

DESCRIPTION    [Toc]    [Back]

       The  use  of this routine is deprecated.  Use the getnameinfo(3) routine instead.

       The  inet_ntop()  function  converts  a  binary   Internet
       address value to a formatted text string.

RETURN VALUES    [Toc]    [Back]

       Upon   successful  conversion,  the  inet_ntop()  function
       returns a  pointer  to  the  buffer  containing  the  text
       string.  If the function fails, it returns a NULL pointer.

ERRORS    [Toc]    [Back]

       If the inet_ntop() routine call fails, errno is set to one
       of  the  following values: The address family specified in
       af parameter is invalid.  The size of the buffer is inadequate.

SEE ALSO    [Toc]    [Back]

       Functions: getnameinfo(3), inet_pton(3).

       Network Programmer's Guide



                                                     inet_ntop(3)