日本語 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.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
PCAP_FINDALLDEVS(3) PCAP_FINDALLDEVS(3)
名称
pcap_findalldevs, pcap_freealldevs - キャプチャ (捕獲) デバイスのリスト
を取得し、そのリストを解放する
書式
#include <pcap/pcap.h>
char errbuf[PCAP_ERRBUF_SIZE];
int pcap_findalldevs(pcap_if_t **alldevsp, char *errbuf);
void pcap_freealldevs(pcap_if_t *alldevs);
解説
pcap_findalldevs() は、pcap_create(3) と pcap_activate(3) で、または
pcap_open_live(3) でオープンすることができるネットワークデバイスのリス
トを構築します。(例えば、そのプロセスにはキャプチャするためにそれらを
オープンする十分な特権がないかもしれないので、pcap_findalldevs() を呼び
出すプロセスによってオープンすることができないネットワークデバイスがあ
るかもしれないことに注意してください。そうだとしたら、それらのデバイス
は、リストに現れません。) pcap_findalldevs() が成功するなら、alldevsp
によって指されるポインタは、リストの最初の要素を指すように設定される
か、またはデバイスが見つからなかったなら (これは、成功と見なされます)、
NULL を指すように設定されます。リストの各要素は、タイプ pcap_if_t であ
り、次のメンバがあります:
next NULL でないなら、リスト中の次の要素へのポインタ。リストの
最後の要素のための NULL。
name pcap_open_live() に渡されるデバイスの名前を与える文字列へ
のポインタ。
description
NULL でなければ、デバイスの人間に読み込み可能な記述を与え
る文字列へのポインタ。
addresses
デバイスのためのネットワークアドレスのリストの最初の要素
へのポインタ、またはデバイスにアドレスがないなら、NULL で
す。
flags デバイスフラグは、次の通りです:
PCAP_IF_LOOPBACK
デバイスがループバックインタフェースであるなら、設
定します。
PCAP_IF_UP
デバイスが動作しているなら、設定します。
PCAP_IF_RUNNING
デバイスが動作しているなら、設定します。
PCAP_IF_WIRELESS
デバイスが無線インタフェースであるなら、設定されま
す。これは、IEEE 802.15.4 と IEEE 802.11 のよう
な、無線ベースのネットワークと同様に IrDA を含むの
で、それは、ただ、Wi-Fi を意味していません。
PCAP_IF_CONNECTION_STATUS
アダプタが接続されているかどうかを示すためのビット
マスク。無線インタフェースのために、"connected"
(接続された) は、"associated with a network" (ネッ
トワークと関連する) ことを意味します。
接続状態ビットのために設定できる値は、次の通りです:
PCAP_IF_CONNECTION_STATUS_UNKNOWN
アダプタが接続されているかどうかは未知です。
PCAP_IF_CONNECTION_STATUS_CONNECTED
アダプタは、接続されました。
PCAP_IF_CONNECTION_STATUS_DISCONNECTED
アダプタは、接続が絶たれました。
PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
"connected" と "disconnected" の概念は、このインタ
フェースに適用されません。例えば、それは、ループ
バックデバイスに適用されません。
アドレスのリストの各要素は、タイプ pcap_addr_t であり、次のメンバがあり
ます:
next NULL でなければ、リストの次の要素へのポインタ。リストの最
後の要素のための NULL。
addr アドレスを含む struct sockaddr へのポインタ。
netmask
NULL でなければ、addr によって指されたアドレスに対応する
ネットマスクを含む struct sockaddr へのポインタ。
broadaddr
NULL でなければ、addr によって指されたアドレスに対応する
ブロードキャスト (同報通信) アドレスを含む struct
sockaddr へのポインタ。デバイスがブロードキャストをサポー
トしないなら、NULL となるかもしれません。
dstaddr
NULL でなければ、addr によって指されたアドレスに対応する
宛先アドレスを含む struct sockaddr へのポインタ。デバイス
がポイントツーポイント (point-to-point) インタフェースで
ないなら、NULL となるかもしれません。
アドレスのリスト中のアドレスは、IPv4 アドレス、IPv6 アドレス、またはあ
る他のタイプのアドレスかもしれないので、アドレスの内容を解釈する前に
struct sockaddr の sa_family メンバをチェックしなければならないことに注
意してください。アドレスがすべて IPv4 アドレスまたは IPv4 あるいは IPv6
アドレスをすべて等しいと仮定しないでください。IPv4 アドレスには、値
AF_INET があり、(IPv6 をサポートしない、より古いオペレーティングシステ
ムは、それを定義しないかもしれない) IPv6 アドレスには、値 AF_INET6 があ
り、そして他のアドレスには、他の値があります。他のアドレスが返されるか
どうか、それらがプラットフォーム依存であるかもしれないどのタイプ。IPv4
アドレスについて、あたかも struct sockaddr_in を指すかのように、struct
sockaddr ポインタを解釈することができます。IPv6 アドレスについて、あた
かも struct sockaddr_in6 を指すかのように、それを解釈することができま
す。
デバイスのリストは、alldevs によって指されるリストを解放する、
pcap_freealldevs(3) によって解放されなければなりません。
戻り値
pcap_findalldevs() は、成功すれば 0 を返し、失敗すれば PCAP_ERROR を返
します。示されるように、デバイスを見つけないことは、失敗ではなく、成功
と見なされるので、0 が、その場合に返されます。PCAP_ERROR が返されるな
ら、errbuf は、適切なエラーメッセージで満たされます。errbuf は、少なく
とも PCAP_ERRBUF_SIZE 文字を保持できると想定されます。
後方互換性
PCAP_IF_UP と PCAP_IF_RUNNING 定数は、libpcap リリース 1.6.1 で利用可能
になりました。PCAP_IF_WIRELESS, PCAP_IF_CONNECTION_STATUS,
PCAP_IF_CONNECTION_STATUS_UNKNOWN, PCAP_IF_CONNECTION_STATUS_CONNECTED,
PCAP_IF_CONNECTION_STATUS_DISCONNECTED, と
PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE 定数は、libpcap リリース 1.9.0
で利用可能になりました。
関連項目
pcap(3)
22 August 2018 PCAP_FINDALLDEVS(3)