Man page - if_nameindex(3)

Packages contains this manual

Available languages:

en fr ja ru ro

Manual

IF_NAMEINDEX

名 前
書 式
説 明
返 り 値
エ ラ ー
バ ー ジ ョ ン
属 性
準 拠
例
プ ロ グ ラ ム の ソ ー ス
関 連 項 目
こ の 文 書 に つ い て

名 前

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

書 式

#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; /* イ ン タ ー フ ェ ー ス の イ ン デ ッ ク ス (1, 2, ...) */
char *if_name; /*ヌ ル 終 端 さ れ た 名 前 ("eth0" な ど ) */

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

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

返 り 値

成 功 し た 場 合 に は if_nameindex () は 配 列 へ の ポ イ ン タ ー を 返 す 。 エ ラ ー 時 に は NULL が 返 さ れ 、 errno が 適 切 に 設 定 さ れ る 。

エ ラ ー

if_nameindex () が 失 敗 し た 場 合 に は 以 下 の errno が 設 定 さ れ る 。
ENOBUFS

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

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

バ ー ジ ョ ン

if_nameindex () 関 数 は glibc 2.1 で 初 め て 登 場 し た が 、 glibc 2.3.4 よ り 前 の バ ー ジ ョ ン の 実 装 で は IPv4 ア ド レ ス を 持 つ イ ン タ ー フ ェ ー ス の み を サ ポ ー ト し て い た 。 IPv4 ア ド レ ス を 持 た な い イ ン タ ー フ ェ ー ス が サ ポ ー ト さ れ て い る の は 、 netlink を サ ポ ー ト す る カ ー ネ ル に お い て の み で あ る 。

属 性

こ の 節 で 使 用 さ れ て い る 用 語 の 説 明 に つ い て は 、 attributes (7) を 参 照 。

Image grohtml-28648-1.png

準 拠

POSIX.1-2001, POSIX.1-2008, RFC 3493.

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

例

以 下 の プ ロ グ ラ ム は こ の ペ ー ジ で 説 明 し た 関 数 の 使 い 方 を 示 し て い る 。 こ の プ ロ グ ラ ム が 生 成 す る 出 力 は 以 下 の よ う に な る 。

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

プ ロ グ ラ ム の ソ ー ス

#include <net/if.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

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

関 連 項 目

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

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man-pages プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。