getifaddrs()

Get a network interface address

Synopsis:

#include <sys/types.h>
#include <sys/socket.h>
#include <ifaddrs.h>

int getifaddrs( struct ifaddrs ** ifap );

Arguments:

ifap: The address of a location where the function can store a pointer to a linked list of ifaddrs structures that contain the data related to the network interfaces on the local machine.

Library:

libsocket

Use the -l socket option to qcc to link against this library.

Description:

The getifaddrs() function stores a reference to a linked list of the network interfaces on the local machine in the memory referenced by ifap.

The data returned by getifaddrs() is dynamically allocated; you should free it by calling freeifaddrs() when you no longer need it.

Returns:

0: Success.
-1: An error occurred (errno is set).

Errors:

The getifaddrs() function may fail and set errno for any of the errors specified by ioctl(), malloc(), socket(), and sysctl().

It can also set errno to ENOMEM if the system is out of memory, or the interface list was growing while getifaddrs() was executing. Calling the function again when the interface list is stable can return 0 (success).

Classification:

Unix

Safety:
Cancellation point	Yes
Interrupt handler	No
Signal handler	No
Thread	Yes