名称

ng_hole — netgraph 廃棄ノードタイプ

書式

#include < sys/types.h>
#include < netgraph/ng_hole.h>

解説

hole ノードタイプは、それが受け取るデータとコントロールメッセージをすべて黙って廃棄します。このタイプは、テストとデバッグのために使用されます。

フック

名前がユニークである限り、 ng_hole ノードは、フック名にかかわらず、接続するためにどんなリクエストも受け付けます。

コントロールメッセージ

このノードタイプは、次を加えて、一般的なコントロールメッセージをサポートします:

NGM_HOLE_GET_STATS ( getstats)

このコマンドは、 ASCII 文字列引数フック名をとり、 struct ng_hole_hookstat としてフックに関連した統計を返します。

NGM_HOLE_CLR_STATS ( clrstats)

このコマンドは、 ASCII 文字列引数フック名をとり、フックに関連した統計をクリアします。

NGM_HOLE_GETCLR_STATS ( getclrstats)

このコマンドは、統計も不可分にクリアされる以外は、 NGM_HOLE_GET_STATS と同一です。

シャットダウン

このノードは、 NGM_SHUTDOWN コントロールメッセージを受け取るか、すべてのフックが切断されている時、シャットダウンします。

関連項目

netgraph(4), ng_echo(4), ngctl(8)

歴史

ng_hole ノードタイプは、 FreeBSD 4.0 で実装されました。

作者

Julian Elischer <julian@FreeBSD.org>