Provided by: manpages-ja-dev_0.5.0.0.20131015+dfsg-2_all bug

名前

       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_BROADCASTIFF_POINTOPOINT のどちらが設定されているかにより (同時
       にはこれらのどちらか一方だけが設定される)、 ifa_broadaddrifa_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_broadaddrifa_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/ に書かれている。