inet_net_ntop()

convert Internet network number to CIDR format 

Function


SYNOPSIS

#include <arpa/inet.h>

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


DESCRIPTION

The inet_net_ntop() function converts an Internet network number from network format (usually a struct in_addr or some other binary form, in network byte order) to Classless Internet Domain Routing (CIDR) presentation format.

With CIDR, a single IP address can be used to designate many unique IP addresses. A CIDR IP address looks like a normal IP address except that it ends with a slash followed by a number, called the IP prefix. For example:

172.200.0.0/16

The IP prefix specifies how many addresses are covered by the CIDR address, with lower numbers covering more addresses. An IP prefix of /12, for example, can be used to address 4,096 former Class C addresses


PARAMETERS

af 

Specifies the address family. Currently, only AF_INET is supported.

src 

Points to the Internet network number. The format of the address is interpreted according to af.

bits 

Specifies the number of bits that specify the network number.

dst 

Points to the buffer where the converted address is stored.

size 

Is the size of dst, in bytes.


RETURN VALUES

On success, the inet_net_ntop() function returns dst on success. Otherwise, it returns a null pointer, and sets errno to one of the following:

EAFNOSUPPORT 

The address family specified in af is not supported by this function.

EINVAL 

bits is less than 0 or greater than 32.

EMSGSIZE 

The buffer specified by dst and size is not large enough to contain the converted address.


CONFORMANCE

PTC MKS Toolkit UNIX APIs extension.


MULTITHREAD SAFETY LEVEL

MT-Safe.


PORTING ISSUES

The implementation of this function is taken from the Bind resolver implementation from the Internet Software Consortium.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
inet_addr(), inet_aton(), inet_lnaof(), inet_makeaddr(), inet_net_pton(), inet_neta(), inet_netof(), inet_network(), inet_ntoa(), inet_ntop(), inet_pton()


PTC MKS Toolkit 10.3 Documentation Build 39.