NAME

inet_ntop − Convert a numeric address to a text string

SYNOPSIS

#include <arpa/inet.h>
const char ∗inet_ntop(
        int af,
        const void ∗src,
        char ∗dst,
        size_t size );

LIBRARY

Standard C Library (libc)

PARAMETERS

afSpecifies the address family.  Valid values are AF_INET for an Internet Protocol Version 4 (IPv4) address and AF_INET6 for an IPv6 address. 

srcPoints to a buffer that contains the numeric Internet address. 

dstPoints to a buffer that is to contain the text string. 

sizeSpecifies 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

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

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

If the inet_ntop() routine call fails, errno is set to one of the following values:

[EAFNOSUPPORT]
The address family specified in af parameter is invalid. 

[ENOSPC]
The size of the buffer is inadequate.

SEE ALSO

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

Network Programmer’s Guide