/* ifaddrs.h -- declarations for getting network interface addresses

[0] Fix | Delete

Copyright (C) 2002-2018 Free Software Foundation, Inc.

[1] Fix | Delete

This file is part of the GNU C Library.

[2] Fix | Delete

[3] Fix | Delete

The GNU C Library is free software; you can redistribute it and/or

[4] Fix | Delete

modify it under the terms of the GNU Lesser General Public

[5] Fix | Delete

License as published by the Free Software Foundation; either

[6] Fix | Delete

version 2.1 of the License, or (at your option) any later version.

[7] Fix | Delete

[8] Fix | Delete

The GNU C Library is distributed in the hope that it will be useful,

[9] Fix | Delete

but WITHOUT ANY WARRANTY; without even the implied warranty of

[10] Fix | Delete

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU

[11] Fix | Delete

Lesser General Public License for more details.

[12] Fix | Delete

[13] Fix | Delete

You should have received a copy of the GNU Lesser General Public

[14] Fix | Delete

License along with the GNU C Library; if not, see

[15] Fix | Delete

<http://www.gnu.org/licenses/>. */

[16] Fix | Delete

[17] Fix | Delete

#ifndef _IFADDRS_H

[18] Fix | Delete

#define _IFADDRS_H 1

[19] Fix | Delete

[20] Fix | Delete

#include <features.h>

[21] Fix | Delete

#include <sys/socket.h>

[22] Fix | Delete

[23] Fix | Delete

__BEGIN_DECLS

[24] Fix | Delete

[25] Fix | Delete

/* The `getifaddrs' function generates a linked list of these structures.

[26] Fix | Delete

Each element of the list describes one network interface. */

[27] Fix | Delete

struct ifaddrs

[28] Fix | Delete

{

[29] Fix | Delete

struct ifaddrs *ifa_next; /* Pointer to the next structure. */

[30] Fix | Delete

[31] Fix | Delete

char *ifa_name; /* Name of this network interface. */

[32] Fix | Delete

unsigned int ifa_flags; /* Flags as from SIOCGIFFLAGS ioctl. */

[33] Fix | Delete

[34] Fix | Delete

struct sockaddr *ifa_addr; /* Network address of this interface. */

[35] Fix | Delete

struct sockaddr *ifa_netmask; /* Netmask of this interface. */

[36] Fix | Delete

union

[37] Fix | Delete

{

[38] Fix | Delete

/* At most one of the following two is valid. If the IFF_BROADCAST

[39] Fix | Delete

bit is set in `ifa_flags', then `ifa_broadaddr' is valid. If the

[40] Fix | Delete

IFF_POINTOPOINT bit is set, then `ifa_dstaddr' is valid.

[41] Fix | Delete

It is never the case that both these bits are set at once. */

[42] Fix | Delete

struct sockaddr *ifu_broadaddr; /* Broadcast address of this interface. */

[43] Fix | Delete

struct sockaddr *ifu_dstaddr; /* Point-to-point destination address. */

[44] Fix | Delete

} ifa_ifu;

[45] Fix | Delete

/* These very same macros are defined by <net/if.h> for `struct ifaddr'.

[46] Fix | Delete

So if they are defined already, the existing definitions will be fine. */

[47] Fix | Delete

# ifndef ifa_broadaddr

[48] Fix | Delete

# define ifa_broadaddr ifa_ifu.ifu_broadaddr

[49] Fix | Delete

# endif

[50] Fix | Delete

# ifndef ifa_dstaddr

[51] Fix | Delete

# define ifa_dstaddr ifa_ifu.ifu_dstaddr

[52] Fix | Delete

# endif

[53] Fix | Delete

[54] Fix | Delete

void *ifa_data; /* Address-specific data (may be unused). */

[55] Fix | Delete

};

[56] Fix | Delete

[57] Fix | Delete

[58] Fix | Delete

/* Create a linked list of `struct ifaddrs' structures, one for each

[59] Fix | Delete

network interface on the host machine. If successful, store the

[60] Fix | Delete

list in *IFAP and return 0. On errors, return -1 and set `errno'.

[61] Fix | Delete

[62] Fix | Delete

The storage returned in *IFAP is allocated dynamically and can

[63] Fix | Delete

only be properly freed by passing it to `freeifaddrs'. */

[64] Fix | Delete

extern int getifaddrs (struct ifaddrs **__ifap) __THROW;

[65] Fix | Delete

[66] Fix | Delete

/* Reclaim the storage allocated by a previous `getifaddrs' call. */

[67] Fix | Delete

extern void freeifaddrs (struct ifaddrs *__ifa) __THROW;

[68] Fix | Delete

[69] Fix | Delete

__END_DECLS

[70] Fix | Delete

[71] Fix | Delete

#endif /* ifaddrs.h */

[72] Fix | Delete

[73] Fix | Delete