if_nametoindex() - ネットワーク・インターフェース名の対応する索引へのマッピング

標準

標準/拡張機能	C/C++	依存項目
RFC2553 Single UNIX Specification、バージョン 3	両方	z/OS® V1R4

形式

#define _OPEN_SYS_SOCK_IPV6
#include <net/if.h>

unsigned int if_nametoindex(const char *ifname);

SUSV3:

#define _POSIX_C_SOURCE 200112L
#include <net/if.h>

unsigned int if_nametoindex(const char *ifname);

機能説明

if_nametoindex() 関数は、インターフェース名 ifname に対応したインターフェース索引を戻します。

戻り値

正常に実行された場合は、if_nametoindex() はインターフェース名 ifname に対応するインターフェース索引を戻します。正常に実行されなかった場合、if_nametoindex() は 0 を戻して errno を次のいずれかに設定します。

エラー・コード: 説明
EINVAL: 無効なパラメーターが指定されました。ifname パラメーターは NULL です。
ENOMEM: インターフェース名の情報を取得するには、使用可能なストレージが不十分です。
ENXIO: ifname パラメーターで提供された、指定インターフェース名は存在しません。

関連情報