日本語 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_BREAKLOOP(3) PCAP_BREAKLOOP(3)
名称
pcap_breakloop - 戻るために、強制的に pcap_dispatch() または
pcap_loop() を呼び出す
書式
#include <pcap/pcap.h>
void pcap_breakloop(pcap_t *);
解説
pcap_breakloop() は、ループするのではなく、強制的に pcap_dispatch(3) ま
たは pcap_loop(3) を戻るためのフラグを設定します。それらは、今までのと
ころ処理されたパケットの数を返し、パケットが今までのところ処理されてい
ないなら、PCAP_ERROR_BREAK を返します。
このルーチンは、単にループ中でチェックされるフラグを設定するように、
UNIX のシグナルハンドラまたは Windows のコンソール制御ハンドラを内部で
使用するために安全です。
フラグは、OS からパケットを読み込むループでチェックされます - OS によっ
て返された 1 組のパケットを処理するループと同様に - それ自体によるシグ
ナルは、必ずしもそれらのループ終了するとはいえません。利用者がシグナル
の後にシステムコールを再開し、シグナルハンドラで pcap_breakloop() の呼
び出しをサポートする UNIX システムでシグナルをキャッチするなら、それら
のシグナルをキャッチするとき、システムコールが、そのシグナルによって再
開されるべきでないことを指定しなければならないことに注意してください。
そうでなければ、シグナルがライブキャプチャ (捕獲) でパケットの読み込み
呼び出しを割り込んだなら、利用者のシグナルハンドラが pcap_breakloop()
を呼び出した後に返るとき、呼び出しは、再開され、より多くのパケットが到
着するまでループが終了せず、そして呼び出しは終了します。
また、マルチスレッドのアプリケーションにおいて、1 つのスレッドが、
pcap_dispatch(), pcap_loop(), pcap_next(3) または pcap_next_ex(3) でブ
ロックされるなら、異なったスレッドの pcap_breakloop() への呼び出しは、
そのスレッドをアンブロック (unblock) しないことに注意してください。利用
者は、POSIX スレッドをサポートするシステムのスレッドのキャンセルまたは
スレッドのシグナリング (signalling)、またはスレッドが Windows でブロッ
クされる pcap_t の pcap_getevent() の結果で SetEvent() のように、スレッ
ドをアンブロックするために呼び出しをブロックすることからスレッドをブ
レークするために OS が提供するメカニズムはなんでも使用する必要がありま
す。非同期手続きの呼び出しは、pcap_t でブロックされたスレッドが、警告可
能な状態でないように、Windows で動作しません。
いくつかのプラットフォームで、pcap_next() と pcap_next_ex() は、OS から
パケットの読み込みでループすることに注意してください。そのループは、必
ずしもシグナルによって終了するわけではないので、たとえ pcap_next() また
は pcap_next_ex() が使用されていても、pcap_breakloop() は、パケット処理
を終了するために使用されるべきです。
pcap_breakloop() は、それが呼び出された後に、これ以上のパケットが
pcap_dispatch() または pcap_loop() によって処理されることを保証しませ
ん。多くても 1 つ以上のパケットが処理されるかもしれません。
pcap_dispatch() または pcap_loop() から PCAP_ERROR_BREAK が返されるな
ら、フラグは、クリアされるので、その後の呼び出しで、パケットを読み込み
を再開します。正の数が返されるなら、フラグはクリアされないので、その後
の呼び出しは、PCAP_ERROR_BREAK を返して、フラグをクリアします。
関連項目
pcap(3)
25 July 2018 PCAP_BREAKLOOP(3)