if_nameindex

Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

if_nameindex, if_freenameindex - ネットワークインターフェースの名前とインデックスを取得する  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <net/if.h>

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

説明

if_nameindex() 関数は if_nameindex 構造体の配列を返す。 各構造体にはローカルシステムのネットワークインターフェースのいずれかの情報が入る。 if_nameindex 構造体には少なくとも以下のフィールドがある。

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() で解放すべきである。  

返り値

On success, if_nameindex() returns pointer to the array; on error, NULL is returned, and errno is set to indicate the error.  

エラー

if_nameindex() が失敗した場合には以下の errno が設定される。
ENOBUFS
利用可能なリソースが十分にない。

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

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性値
if_nameindex(), if_freenameindex() Thread safetyMT-Safe
 

標準規格

POSIX.1-2008, RFC 3493.  

歴史

glibc 2.1. POSIX.1-2001. BSDi.

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);
}
 

関連項目

getsockopt(2), setsockopt(2), getifaddrs(3), if_indextoname(3), if_nametoindex(3), ifconfig(8)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
属性
標準規格
歴史
例
プログラムのソース
関連項目

This document was created by man2html, using the manual pages.