#include <net/if.h> struct if_nameindex *if_nameindex(void); void if_freenameindex(struct if_nameindex *ptr);
unsigned int if_index; /* Index of interface (1, 2, ...) */
char *if_name; /* Null-terminated name ("eth0", etc.) */
if_index フィールドにはインターフェースのインデックスが入る。 if_name フィールドはヌル終端されたインターフェース名を指す。 配列の最後は、 if_index が 0 で if_name が NULL のエントリーで示される。
if_nameindex() が返すデータ構造体は動的に確保される。 必要なくなった際には if_freenameindex() で解放すべきである。
if_nameindex() は、 socket(2), bind(2), ioctl(2), getsockname(2), recvmsg(2), sendto(2), malloc(3) に対して規定されているエラーのいずれかで失敗する場合がある。
| インターフェース | 属性 | 値 |
| if_nameindex(), if_freenameindex() | Thread safety | MT-Safe |
Before glibc 2.3.4, the implementation supported only interfaces with IPv4 addresses. Support of interfaces that don't have IPv4 addresses is available only on kernels that support netlink.
$ ./a.out; 1: lo 2: wlan0 3: em1
#include <net/if.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
int
main(void)
{
struct if_nameindex *if_ni, *i;
if_ni = if_nameindex();
if (if_ni == NULL) {
perror("if_nameindex");
exit(EXIT_FAILURE);
}
for (i = if_ni; !(i->if_index == 0 && i->if_name == NULL); i++)
printf("%u: %s\n", i->if_index, i->if_name);
if_freenameindex(if_ni);
exit(EXIT_SUCCESS);
}