日本語 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
NG_ETHER(4) FreeBSD カーネルインタフェースマニュアル NG_ETHER(4)
名称
ng_ether -- イーサネット netgraph ノードタイプ
書式
#include <netgraph/ng_ether.h>
解説
ether netgraph ノードタイプは、イーサネットインタフェースと netgraph(4)
ネットワークサブシステムとの情報をやりとりを許します。ng_ether モジュール
がカーネルにいったんロードされると、ノードは、自動的にシステムのそれぞれ
のイーサネットインタフェースのために作成されます。各ノードは、関連インタ
フェースと同じ名前でそれ自体の名前を付けることを試みます。
3 つのフックがサポートされます: lower, upper, orphans です。フック名
divert は、lower のための別名として使用できます。そして、後方互換性のため
に提供されます。ほんとうに 2 つの名前は、同じフックを表します。
lower フックは、生のイーサネットデバイスへの接続です。接続されたとき、
upper 層の処理のためにカーネルに渡される代わりにすべての着信パケットは、
このフックに転送されます。このフックへの書き込みは、デバイスによって送信
される生のイーサネットフレームをもたらします。通常の発信パケットは、接続
された lower によって影響されません。
upper フックは、上位のプロトコルレイヤへの接続です。接続されたとき、デバ
イスによって送信される代わりに、すべて発信パケットは、このフックへ転送さ
れます。このフックへの書き込みは、ちょうどまるで配線上に入ったかのように
カーネルによって受信される生のイーサネットフレームをもたらします。通常の
着信パケットは、接続された upper によって影響されません。
orphans フックは、(そうでなければ捨てられる) 認識されていないパケットだけ
がそのフックに書き込まれることを除いて、lower と同等です。さらに、他の通
常の着信トラフィックは、影響を受けなません。upper に書き込まれた認識され
ていないパケットは、接続された場合、orphans へ転送して戻されます。
すべての場合では、フレームは、標準に 14 バイトのイーサネットヘッダ (しか
し、チェックサムはない) がある生のイーサネットフレームです。
どんなフックも接続されていないとき、upper と lower は、実際には、一緒に接
続されます、それでパケットは、通常上方と下方に流れます。
フック
このノードタイプは、次のフックをサポートします:
lower 下位のデバイスリンクレイヤとの接続。
upper 上位のプロトコルレイヤとの接続。
orphans lower に似ていますが、認識されていないパケットを受信するだけで
す。
コントロールメッセージ
このノードタイプは、次を加えて、一般的なコントロールメッセージをサポート
します:
NGM_ETHER_GET_IFNAME (getifname)
ヌル文字で終了する ASCII 文字列として関連インタフェースの名前を返し
ます。通常、これは、ノードの名前と同じです。
NGM_ETHER_GET_IFINDEX (getifindex)
32 ビットの整数として関連インタフェースのグローバルなインデックスを
返します。
NGM_ETHER_GET_ENADDR (getenaddr)
デバイスのユニークな 6 バイトのイーサネットアドレスを返します。
NGM_ETHER_SET_ENADDR (setenaddr)
デバイスのユニークな 6 バイトのイーサネットアドレスを設定します。こ
のコントロールメッセージは、SIOCSIFLLADDR ioctl(2) システムコールを
使用することと同等です。
NGM_ETHER_SET_PROMISC (setpromisc)
無差別モードを有効にするか、または無効にします。このメッセージは、イ
ンタフェースで無差別モードを有効にするか、または無効にする 32 ビット
の 1 つの整数フラグを含んでいます。0 でない値は、無差別モードを有効
にします。
NGM_ETHER_GET_PROMISC (getpromisc)
ノードの無差別フラグの現在の値を取得します。返り値は、常に 1 か 0 で
す。このフラグがノードの自己の無差別な設定を反映して、他の手段によっ
て影響することができる、(例えば、bpf(4)) 実際のインタフェースの無差
別な状態は、反映する必要がないことに注意してください、
NGM_ETHER_SET_AUTOSRC (setautosrc)
自動ソースアドレス上書きフラグを設定します。このメッセージは、すべて
の発信パケットをデバイスのユニークなイーサネットアドレスでそれらの
ソースイーサネットアドレスフィールドを上書きする 32 ビットの 1 つの
整数フラグを含んでいます。このフラグが 0 に設定されるなら、発信パ
ケットのソースアドレスは、変更されません。このフラグのためのデフォル
ト設定は、無効です。
NGM_ETHER_GET_AUTOSRC (getautosrc)
ノードのソースアドレス上書きフラグの現在の値を取得します。返り値は、
常に 1 か 0 です。
NGM_ETHER_ADD_MULTI (addmulti)
イーサネットマルチキャストグループに加えます。このコントロールメッ
セージは、SIOCADDMULTI ioctl(2) システムコールを使用することと同等で
す。
NGM_ETHER_DEL_MULTI (delmulti)
イーサネットマルチキャストグループから退きます。このコントロールメッ
セージは、SIOCDELMULTI ioctl(2) システムコールを使用することと同等で
す。
NGM_ETHER_DETACH (detach)
基本的なイーサネットインタフェースからデタッチして、ノードをシャット
ダウンします。
シャットダウン
NGM_SHUTDOWN コントロールメッセージを受け取ることによって、すべてのフック
は、切断され、無差別モードは、無効にされますが、ノードは、削除されませ
ん。ノードは、NGM_ETHER_DETACH コントロールメッセージを使用してシャットダ
ウンのみ行うことができます。インタフェース自体が取り除かれるなら (例え
ば、PC Card 取り外しのため)、ノードは、見えなくなります。
使用例
このコマンドは、``fxp0'' インタフェースによって受信されたすべての認識され
ないパケットを 16 進法と ASCII で復号化されて標準出力にダンプします:
nghook -a fxp0: orphans
このコマンドは、インタフェース ``fxp0'' に sample.pkt の内容を送信します:
cat sample.pkt | nghook fxp0: orphans
これらのコマンドは、ng_tee(4) ノードを、パケットの流れ、統計などをトレー
スするのに使用することができる lower と upper のプロトコルレイヤの間に挿
入します。
ngctl mkpeer fxp0: tee lower right
ngctl connect fxp0: lower upper left
関連項目
arp(4), netgraph(4), netintro(4), ifconfig(8), ngctl(8), nghook(8)
作者
Julian Elischer <julian@FreeBSD.org>
Archie Cobbs <archie@FreeBSD.org>
バグ
他のほとんどの netgraph ノードタイプのために動作する自動 KLD モジュール
ローディングメカニズムは、ether ノードが要求に応じて作成されないので、
ether ノードタイプでは、動作しません。代わりに、イーサネットインタフェー
スが取り付けられるとき、または KLD が最初にロードされるとき、それらは、作
成されます。そのため、KLD が静的にカーネルにコンパイルされないなら、ether
ノードを生じさせるために、手動で KLD をロードする必要があります。
FreeBSD 11.2 June 23, 2011 FreeBSD 11.2