日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
GETIFADDRS(3) FreeBSD ライブラリ関数マニュアル GETIFADDRS(3)
名称
getifaddrs -- インタフェースアドレスを取得する
書式
#include <ifaddrs.h>
int
getifaddrs(struct ifaddrs **ifap);
void
freeifaddrs(struct ifaddrs *ifp);
解説
getifaddrs() 関数は、ifap によって参照されるメモリでローカルマシン上に
ネットワークインタフェースのリンクしたリストへの参照を格納します。リスト
は、インクルードファイル <ifaddrs.h> に定義されるように、ifaddrs 構造体か
ら構成されます。ifaddrs 構造体は、少なくとも次のエントリを含んでいます。
struct ifaddrs *ifa_next; /* 次の構造体へのポインタ */
char *ifa_name; /* インタフェース名 */
u_int ifa_flags; /* インタフェースフラグ */
struct sockaddr *ifa_addr; /* インタフェースアドレス */
struct sockaddr *ifa_netmask; /* インタフェースネットマスク */
struct sockaddr *ifa_broadaddr; /* インタフェースブロードキャスト
アドレス */
struct sockaddr *ifa_dstaddr; /* P2P インタフェースあて先 */
void *ifa_data; /* アドレス特有データ */
ifa_next フィールドは、リストでの次の構造体へのポインタを含んでいます。こ
のフィールドのリストでの最後の構造体は、NULL です。
ifa_name フィールドは、インタフェース名を含んでいます。
ifconfig(8) ユーティリティによって設定されるように、ifa_flags フィールド
は、インタフェースフラグを含んでいます。
次のものが存在するなら、ifa_addr フィールドは、インタフェースのアドレス、
またはインタフェースのリンクレベルアドレスのいずれかを参照します。そうで
なければ、それは、NULL です。(ifa_addr フィールドの sa_family フィールド
は、ifa_addr アドレスのフォーマットを決定するために調べられるべきです。)
設定されるなら、ifa_netmask フィールドは、ifa_addr に関連したネットマスク
(netmask) を参照します。そうでなければ、それは、NULL です。
存在するなら、非 P2P インタフェースのため単に参照すべき、ifa_broadaddr
フィールドは、ifa_addr に関連したブロードキャストアドレスを参照します。そ
うでなければ、それは、NULL です。
存在するなら、ifa_dstaddr フィールドは、P2P インタフェースで、あて先アド
レスを参照します。そうでなければ、それは、NULL です。
ifa_data フィールドは、(インクルードファイル <net/if.h> で定義される)
struct if_data へのポインタのアドレスファミリ特有データを参照します。
AF_LINK アドレスのために、それは、様々なインタフェース属性と統計値を含ん
でいます。すべての他のアドレスファミリのために、それは、アドレスごとのイ
ンタフェース統計値を含んでいます。
getifaddrs() によって返されたデータは、動的に割り付けられ、もはや必要でな
かったとき、freeifaddrs() を使用して解放されるべきです。
戻り値
関数 getifaddrs() は、処理が成功すると値 0 を返します。そうでない場合、値
-1 が返され、グローバル変数 errno にエラーを示す値が設定されます。
エラー
getifaddrs() が失敗すると、ライブラリルーチン ioctl(2), socket(2),
malloc(3) または sysctl(3) で明記されたエラーのいずれかが errno に設定さ
れます。
関連項目
ioctl(2), socket(2), sysctl(3), networking(4), ifconfig(8)
歴史
getifaddrs 実装は、BSDi BSD/OS ではじめて登場しました。
バグ
<net/if.h> と <ifaddrs.h> の両方が含まれているなら、<net/if.h> は、
<ifaddrs.h> の前にインクルードされていなければなりません。
FreeBSD 11.4 November 25, 2014 FreeBSD 11.4