Index for Section 3

Alphabetical listing for I

Bottom of page

if_nameindex(3)
NAME
  if_nameindex - Returns an array of all interface names and indexes

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

SYNOPSIS
  #include <net/if.h>

  struct if_nameindex *if_nameindex ( void );

DESCRIPTION
  The if_nameindex() function dynamically allocates memory for an array of
  if_nameindex structures, one structure for each interface.  A structure
  with a zero (0) if_index value (0) and a NULL if_name value indicates the
  end of the array.

  You must define the following if_nameindex structure prior to a call to
  if_nameindex:

       struct if_nameindex {
	  unsigned int	 if_index;
	  char		 *if_name;
       };

  To free memory allocated by this function, use the if_freenameindex
  function.

RETURN VALUES
  Upon successful conversion, the if_nameindex() function returns a pointer
  to the first structure in the array of if_nameindex structures.

RELATED INFORMATION
  Functions: if_freenameindex(3), if_indextoname(3), if_nametoindex(3).

Index for Section 3

Alphabetical listing for I

Top of page