NAME
inet_ntop - Parse network address structures
SYNOPSIS
#include <sys/types.h>
#include <sys/socket.h>
#include <arpa/inet.h>
I const char *inet_ntop(int af , const void * src ,
I char * dst , socklen_t cnt );
DESCRIPTION
This function converts the network address structure
src
in the
af
address family into a character string, which is copied to a character buffer
R dst ,
which is
cnt
bytes long.
inet_ntop(3)
extends the
inet_ntoa(3)
function to support multiple address families,
inet_ntoa(3)
is now considered to be deprecated in favor of
inet_ntop(3).
The following address families are currently supported:
AF_INET
src
points to a
struct in_addr
(network byte order format)
which is converted to an IPv4 network address in
the dotted-quad format, "ddd.ddd.ddd.ddd".
The buffer
dst
must be at least
INET_ADDRSTRLEN
bytes long.
AF_INET6
src
points to a
struct in6_addr
(network byte order format)
which is converted to a representation of this address in the
most appropriate IPv6 network address format for this address.
The buffer
dst
must be at least
INET6_ADDRSTRLEN
bytes long.
RETURN VALUE
R inet_ntop ()
returns a non-null pointer to
R dst .
NULL is returned if there was an error, with
errno
set to
EAFNOSUPPORT
if
af
was not set to a valid address family,
or to
ENOSPC
if the converted address string would exceed the size of
R dst
given by the
cnt
argument.
CONFORMING TO
POSIX.1-2001.
Note that RFC 2553 defines a prototype where the last parameter
cnt
is of type
R size_t .
Many systems follow RFC 2553.
Glibc 2.0 and 2.1 have
R size_t ,
but 2.2 has
R socklen_t .
BUGS
AF_INET6
converts IPv6-mapped IPv4 addresses into an IPv6 format.
SEE ALSO
ČLÁNKY DO MAILU