Index Index for
Section 3
Index Alphabetical
listing for I
Index Bottom of
page

inet_ntop(3)

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

af Specifies the address family. Valid values are AF_INET for an Internet Protocol Version 4 (IPv4) address and AF_INET6 for an IPv6 address. src Points to a buffer that contains the numeric Internet address. dst Points to a buffer that is to contain the text string. size 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

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).

Index Index for
Section 3
Index Alphabetical
listing for I
Index Top of
page