Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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:

Classification:

Unix

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

See also:

errno, freeifaddrs(), ifaddrs, ioctl(), malloc(), socket(), sysctl()