IF_NAMEINDEX

名前

書式

#include <net/if.h>

struct if_nameindex *if_nameindex(void);
void if_freenameindex(struct if_nameindex *ptr);

説明

unsigned int if_index; /* インターフェースのインデックス (1, 2, ...) */ char *if_name; /*ヌル終端された名前 ("eth0" など) */

if_index フィールドにはインターフェースのインデックスが入る。 if_name フィールドはヌル終端されたインターフェース名を指す。 配列の最後は、 if_index が 0 で if_name が NULL のエントリーで示される。

if_nameindex() が返すデータ構造体は動的に確保される。 必要なくなった際には if_freenameindex() で解放すべきである。  

返り値

エラー

ENOBUFS

利用可能なリソースが十分にない。

if_nameindex() は、 socket(2), bind(2), ioctl(2), getsockname(2), recvmsg(2), sendto(2), malloc(3) に対して規定されているエラーのいずれかで失敗する場合がある。  

バージョン

属性

準拠

この関数は BSDi 初めて登場した。  

例

$ ./a.out 1: lo 2: wlan0 3: em1  

プログラムのソース

int main(int argc, char *argv[]) {
    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); }  

関連項目

この文書について

関連キーワード

Linux マニュアル 一覧

関連するコマンド・関数

Index

名前

書式

説明

返り値

エラー

バージョン

属性

準拠

例

プログラムのソース

関連項目

この文書について