ダイレクトネットワークアクセス

ネットワークインタフェース

struct mibif { 
 TAILQ_ENTRY(mibif) link; 
 u_int  flags; 
 u_int  index; /* 論理的な ifindex */ 
 u_int  sysindex; 
 char  name[IFNAMSIZ]; 
 char  descr[256]; 
 struct ifmibdata mib; 
 uint64_t mibtick; 
 void  *specmib; 
 size_t  specmiblen; 
 u_char  *physaddr; 
 u_int  physaddrlen; 
 int  has_connector; 
 int  trap_enable; 
 uint64_t counter_disc; 
 mibif_notify_f xnotify; 
 void  *xnotify_data; 
 const struct lmodule *xnotify_mod; 
 struct asn_oid spec_oid; 
};

mibII モジュールは、 ifIndex があるなら RFC-2863 で説明されるようなセマンティックを実装しようと試みます。この RFC は、インタフェースのインデックスが再利用されないかもしれないと述べています。例えば tun が統合的なインタフェースタイプであり、システムがインタフェース tun0 を作成し、このインタフェースを破壊し、再び tun 0 を作成するなら、事実上、それらが異なったインタフェースであるので、これらのインタフェースは、異なったインタフェースインデックスがなければならないことを意味します。他方では、ハードウェアインタフェース xl0 があり、このインタフェースが見えなくなるなら、ドライバがアンロードされて再び現れ、そしてドライバが再びロードされるので、インタフェースインデックスは同じ状態でとどまなければなりません。 mibII は、実際と総合的な (ダイナミックな) インタフェースを区別することによって、これを実装します。インタフェースタイプは、インタフェースタイプがあるなら (例えば、“tun”) 名前で関数 mib_if_set_dyn() を呼び出すことによってダイナミックに宣言することができます。実際のインタフェースに関して、モジュールはインタフェースがアンロードされるなら、特別なリスト中のインタフェース名とその ifIndex の間のマッピングを保持します。ダイナミックなインタフェースに関して、新しい ifIndex はインタフェースが発生するたびに生成されます。 SNMP によって見られるようなインタフェースインデックスは、システムによって使用される同じインデックスではないことを意味します。 SNMP ifIndex はフィールド index で保持されて、システムのインタフェースインデックスは sysindex です。

mib_refresh_iflist への呼び出しで、全体のインタフェースリストを再作成します。

インタフェースリストは、関数 mib_first_if() と mib_next_if() で横断することができます。これらの 2 つの呼び出しでリストを横断している間は、インタフェースリストを決して変更しないでください。

名前またはインデックスによってインタフェースを見つけるための 3 つの関数があります。 mib_find_if() は、SNMP ifIndex を検索することによってインタフェースを見つけ、 mib_find_if_sys() はシステムインタフェースインデックスを検索することによってインタフェースを見つけ、そして、 mib_find_if_name() はインタフェース名を検索することによってインタフェースを見つけます。それぞれの関数はインタフェースを見つけることができないなら、 NULL を返します。

関数 mib_fetch_ifmib() はカーネルからインタフェース MIB をリフレッシュさせます。

関数 mib_if_admin() はインタフェースの管理状態を上げる (引数は、1 です) か下げる (引数は、0 です) ために使用することができます。

インタフェースイベント

また、モジュールは特定のインタフェースでイベントを登録することができます。 mibif_notify() を呼び出すことによって、これは行われます。これで、次のイベントのいずれかが起こるとき、インタフェースポインタ、通知コード、とユーザ引数 uarg で与えられたコールバック func を呼び出します:

MIBIF_NOTIFY_DESTROY

インタフェースは破壊されます。

このメカニズムは他のモジュールでインタフェースタイプ特有の MIB の部品を実装するために使用することができます。登録は mib_notify から返された値である mib_unnotify() で取り除くことができます。どんな通知登録もインタフェースが破壊されるか、または登録モジュールがアンロードされるとき、自動的に取り除かれます。 1 つのモジュールしか与えられたどんなインタフェースにも登録できないことに注意してください。

インタフェースアドレス

struct mibifa { 
 TAILQ_ENTRY(mibifa) link; 
 struct in_addr inaddr; 
 struct in_addr inmask; 
 struct in_addr inbcast; 
 struct asn_oid index; 
 u_int  ifindex; 
 u_int  flags; 
};

与えられたインタフェースでの IP アドレスの (順序付けられた) リストは mib_first_ififa() と mib_next_ififa() を呼び出すことによって、横断することができます。リストは読み込み専用と見なすべきではありません。

インタフェース受信アドレス

struct mibrcvaddr { 
 TAILQ_ENTRY(mibrcvaddr) link; 
 struct asn_oid index; 
 u_int  ifindex; 
 u_char  addr[ASN_MAXOIDLEN]; 
 size_t  addrlen; 
 u_int  flags; 
}; 
enum { 
 MIBRCVADDR_VOLATILE = 0x00000001, 
 MIBRCVADDR_BCAST = 0x00000002, 
 MIBRCVADDR_HW  = 0x00000004, 
};

MIBRCVADDR_BCAST の代入は知られているインタフェースタイプのリストに基づいていることに注意してください。フラグはインタフェースタイプの等有の MIB を実装するモジュールで取り扱われるべきです。

受信アドレスは mib_rcvaddr_create() で作成することができ、 mib_rcvaddr_delete() で削除することができます。これは、システムによって自動的に取り扱われないアドレスのためだけに行う必要があります。

受信アドレスは mib_find_rcvaddr() で見つけることができます。

インタフェーススタックテーブル

テーブルエントリは、 mib_ifstack_create() で作成されて、 mib_ifstack_delete() で削除されます。両方の関数はインタフェースへのポインタを必要とします。エントリのインタフェースのいずれかが破壊されるなら、エントリは自動的に削除されます。関数はスタックテーブルと逆のスタックテーブルの両方を取り扱います。