Provided by: manpages-ja-dev_0.5.0.0.20131015+dfsg-2_all 
名前
getifaddrs, freeifaddrs - インターフェースのアドレスを取得する
書式
#include <sys/types.h>
#include <ifaddrs.h>
int getifaddrs(struct ifaddrs **ifap);
void freeifaddrs(struct ifaddrs *ifa);
説明
getifaddrs() 関数は、ローカルシステムのネットワークインターフェース情報を表す構造体の連結リストを作成し、
リストの先頭の要素のアドレスを *ifap に格納する。 リストは ifaddrs 構造体で構成される。 ifaddrs 構造体は
以下のように定義されている。
struct ifaddrs {
struct ifaddrs *ifa_next; /* Next item in list */
char *ifa_name; /* Name of interface */
unsigned int ifa_flags; /* Flags from SIOCGIFFLAGS */
struct sockaddr *ifa_addr; /* Address of interface */
struct sockaddr *ifa_netmask; /* Netmask of interface */
union {
struct sockaddr *ifu_broadaddr;
/* Broadcast address of interface */
struct sockaddr *ifu_dstaddr;
/* Point-to-point destination address */
} ifa_ifu;
#define ifa_broadaddr ifa_ifu.ifu_broadaddr
#define ifa_dstaddr ifa_ifu.ifu_dstaddr
void *ifa_data; /* Address-specific data */
};
ifa_next フィールドにはリストの次の構造体へのポインタが格納される。 この要素がリストの最後の場合には NULL
が入る。
ifa_name は NULL 終端されたインターフェース名を指す。
ifa_flags フィールドには、 SIOCGIFFLAGS ioctl(2) 操作で返されるインターフェースのフラグが格納される (これ
らのフラグのリストについては netdevice(7) を参照)。
ifa_addr フィールドは、インターフェースのアドレスを格納した構造体へのポインタである (sa_family サブフィー
ルドを参照して、アドレス構造体の形式を判別すべきである)。 このフィールドは NULL ポインタとなる場合があ
る。
ifa_netmask フィールドには、 ネットマスクがあるアドレスファミリーであれば、 ifa_addr に関連付けられたネッ
トマスクを格納した構造体へのポインタが入る。 このフィールドは NULL ポインタとなる場合がある。
ifa_flags にビット IFF_BROADCAST か IFF_POINTOPOINT のどちらが設定されているかにより (同時にはこれらのど
ちらか一方だけが設定される)、 ifa_broadaddr に ifa_addr に対応するブロードキャストが入るか (そのアドレス
ファミリーでブロードキャストがある場合)、 ifa_dstaddr に point-to-point インターフェースの宛先アドレスが
入るかが決まる。
ifa_data フィールドは、 アドレスファミリー固有のデータが入ったバッファへのポインタである。 そのインター
フェースでこのようなデータがない場合には、 このフィールドは NULL となる。
getifaddrs() が返すデータは動的に確保される。 必要なくなった際には freeifaddrs() を使って解放すべきであ
る。
返り値
成功すると、 getifaddrs は 0 を返す。 エラーの場合、 -1 が返り、 errno が適切に設定される。
エラー
getifaddrs() は失敗する場合があり、その場合には errno には socket(2), bind(2), getsockname(2),
recvmsg(2), sendto(2), malloc(3), realloc(3) に対して規定されているエラーのいずれかが設定される。
バージョン
getifaddrs() 関数は glibc 2.3 で初めて登場したが、 glibc 2.3.3 より前のバージョンの実装では IPv4 アドレス
だけがサポートされていた。 IPv6 のサポートは glibc 2.3.3 で追加された。 IPv4 以外のアドレスファミリーが
getifaddrs で利用できるのは、 netlink をサポートするカーネルの場合だけである。
準拠
POSIX.1-2001 にはない。 この関数は BSDi で初めて登場し、 BSD 系のシステムに存在するが、 ドキュメント上は
かなり動作が異なり、アドレス毎ではなくインターフェース毎に 1 エントリを返す。 このことは、 インターフェー
スがアドレスを持たない場合には ifa_addr や他のフィールドは実際に NULL になり、 インターフェースに IP アド
レスが割り当てられている場合には リンクレベルのアドレスは返されない、ということを意味する。 また、
ifa_broadaddr と ifa_dstaddr のどちらを選択するかを決める方法は、 システムにより異なる。
注意
Linux では、 返されるアドレスは通常インターフェースに割り当てられた IPv4 アドレスと IPv6 アドレスになる
が、 これ以外にインターフェース毎に一つ AF_PACKET アドレスも返される。 AF_PACKET アドレスには、 インター
フェースとその物理層に関する低レベルの詳細が格納される。 この場合、 ifa_data フィールドには、
<linux/if_link.h> で定義される struct rtnl_link_stats (Linux 2.4 以前では <linux/netdevice.h> で定義され
る struct net_device_stats) へのポインタが格納される。 この構造体には、インターフェースの様々な属性や統計
情報が入る。
例
以下のプログラムは getifaddrs(), freeifaddrs(), getnameinfo(3) の使用例である。 以下はこのプログラムをあ
るシステムで実行した際の出力である。
$ ./a.out
lo address family: 17 (AF_PACKET)
eth0 address family: 17 (AF_PACKET)
lo address family: 2 (AF_INET)
address: <127.0.0.1>
eth0 address family: 2 (AF_INET)
address: <10.1.1.4>
lo address family: 10 (AF_INET6)
address: <::1>
eth0 address family: 10 (AF_INET6)
address: <fe80::2d0:59ff:feda:eb51%eth0>
プログラムのソース
#include <arpa/inet.h>
#include <sys/socket.h>
#include <netdb.h>
#include <ifaddrs.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
int
main(int argc, char *argv[])
{
struct ifaddrs *ifaddr, *ifa;
int family, s;
char host[NI_MAXHOST];
if (getifaddrs(&ifaddr) == -1) {
perror("getifaddrs");
exit(EXIT_FAILURE);
}
/* Walk through linked list, maintaining head pointer so we
can free list later */
for (ifa = ifaddr; ifa != NULL; ifa = ifa->ifa_next) {
if (ifa->ifa_addr == NULL)
continue;
family = ifa->ifa_addr->sa_family;
/* Display interface name and family (including symbolic
form of the latter for the common families) */
printf("%s address family: %d%s\n",
ifa->ifa_name, family,
(family == AF_PACKET) ? " (AF_PACKET)" :
(family == AF_INET) ? " (AF_INET)" :
(family == AF_INET6) ? " (AF_INET6)" : "");
/* For an AF_INET* interface address, display the address */
if (family == AF_INET || family == AF_INET6) {
s = getnameinfo(ifa->ifa_addr,
(family == AF_INET) ? sizeof(struct sockaddr_in) :
sizeof(struct sockaddr_in6),
host, NI_MAXHOST, NULL, 0, NI_NUMERICHOST);
if (s != 0) {
printf("getnameinfo() failed: %s\n", gai_strerror(s));
exit(EXIT_FAILURE);
}
printf("\taddress: <%s>\n", host);
}
}
freeifaddrs(ifaddr);
exit(EXIT_SUCCESS);
}
関連項目
bind(2), getsockname(2), socket(2), packet(7), ifconfig(8)
この文書について
この man ページは Linux man-pages プロジェクトのリリース 3.54 の一部 である。プロジェクトの説明とバグ報告
に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。
GNU 2012-11-11 GETIFADDRS(3)