NAME

inet_ntop − Converts a numeric address to a text string

LIBRARY

Standard C Library (libc.so, libc.a)

SYNOPSIS

#include <arpa/inet.h>

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

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 inet_ntop() function converts a numeric Internet address value to a 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 pointer to the buffer containing NULL. 

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. 

RELATED INFORMATION

Functions: inet_pton(3).