Index for Section 3

Alphabetical listing for I

Bottom of page

inet_ntop(3)
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
  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 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

Index for Section 3

Alphabetical listing for I

Top of page