JP2793489B2

JP2793489B2 - 共通データ・リンク・インターフェース

Info

Publication number: JP2793489B2
Application number: JP5331395A
Authority: JP
Inventors: キュスン・チャン; ロン・エドワード・ホール; グレゴリー・スコット・ジョイス; ポール・デーヴィド・マズラナ; ランス・ウォレン・ラッセル
Original assignee: International Business Machines Corp
Current assignee: International Business Machines Corp
Priority date: 1993-01-13
Filing date: 1993-12-27
Publication date: 1998-09-03
Anticipated expiration: 2013-09-03
Also published as: US5548731A; JPH06303286A

Description

【発明の詳細な説明】

【０００１】

【産業上の利用分野】本発明は、データ処理システムに
関し、具体的には、複数のデータ・フレームワークをサ
ポートするための共通インターフェースに関する。

【０００２】

【従来の技術】データ処理業界では、さまざまな異なる
データ・プロトコルが開発されているが、そのそれぞれ
に特定の応用分野または用途での利点と欠点がある。た
とえば、ＢＳＤは、UNIX（UNIX System Laboratories,
Inc.の登録商標）オペレーティング・システムとの互換
性を有する通信プロトコルを実施するため、ソケットと
して知られるフレームワークを使用する、ネットワーク
・コードを提供する。ソケット・フレームワークに基づ
く多数の通信プロトコルが作成されており、ＴＣＰ／Ｉ
Ｐが最も有名である。フレームワークとは、本質的に、
アプリケーション・プログラムから呼び出すことがで
き、データ転送に使用される基礎プロトコルから独立し
たデータ通信機能を提供する、プログラミング・インタ
ーフェースまたは１組のライブラリである。したがっ
て、特定のフレームワークのさまざまな版が、異なる基
礎プロトコルをサポートし得る。たとえば、ソケット
は、ＴＣＰ／ＩＰ、ＳＮＡまたはＡｒｃＮｅｔをサポー
トできる。フレームワークとプロトコルは、既に良く知
られており、例えば、ＩＢＭ出版物"AIX Version 3.2 C
ommunication Programming Concepts"、資料番号SC23-2
206-03（１９９２年９月）にも記載されている。

【０００３】

【発明が解決しようとする課題】ＡＴ＆Ｔは、ＵＮＩＸ
通信プロトコルを開発するためのフレームワークとして
ストリームを導入した。このストリーム・フレームワー
クは、ソケット・フレームワークの一部の欠点に対処し
たものであり、データ処理業界で広く使用されるように
なった。問題は、ソケットとストリームが完全に独立の
フレームワークであるという点である。したがって、オ
ペレーティング・システム提供者が新しい通信プロトコ
ルの追加を望む場合、その開発者は、その新プロトコル
を開発する前に、どちらか一方のフレームワークを選択
しなければならない。複数のフレームワークのサポート
を提供するためには、異なるハードウェア・アダプタ
と、そのようなハードウェア・アダプタに対応する異な
るデバイス・ドライバが必要である。

【０００４】オペレーティング・システム開発業者が、
異なるプロセッサ、バスなどを有する複数の基礎データ
処理システム用の共通オペレーティング・システムを提
供しようとする時、この問題はさらに大きくなる。この
状況では、オペレーティング・システム提供者が、異な
るプロセッサ（たとえば、８０４８６、６８０２０また
はＲＩＳＣマイクロプロセッサ）のためだけでなく、異
なるフレームワークおよび異なるハードウェア・アダプ
タのためにも異なるコード・サポートを有することにな
る。これは、より大きな開発資源要件と、ハードウェア
・アダプタ要件の増大を招く。

【０００５】本発明の目的は、改良されたデータ処理シ
ステムを提供することである。

【０００６】本発明のもう１つの目的は、改良されたデ
ータ通信サブシステムを提供することである。

【０００７】本発明のもう１つの目的は、複数の通信フ
レームワークをサポートする単一のハードウェア・イン
ターフェースを提供することである。

【０００８】本発明のもう１つの目的は、複数の通信フ
レームワークをサポートするハードウェア・アダプタへ
の単一のドライバ・インターフェースを提供することで
ある。

【０００９】

【課題を解決するための手段】共通データ・リンク・イ
ンターフェース（ＣＤＬＩ）は、ネットワーク・デバイ
ス・ドライバおよびデータ・リンク・プロバイダ用のフ
レームワークを提供する。このフレームワークを用いる
と、ソケット・プロトコルとストリーム・プロトコルが
共存でき、単一のデバイス・ドライバを共用できるよう
になる。このフレームワークは、ソケットおよびプロト
コルから独立しており、共通の機能を提供するだけであ
る。一般ユーザは、ソケットとＤＬＰＩ（後述する）を
介してＣＤＬＩに間接にインターフェースする。

【００１０】ＣＤＬＩは、３つの構成要素、すなわちネ
ットワーク・デバイス・ドライバ、ネットワーク・デマ
ルチプレクサ、およびネットワーク・サービスからな
る。ネットワーク・デバイス・ドライバ（ＮＤＤ）モデ
ルは、ソケットのＩＦＮＥＴおよびストリームのデータ
・リンク・プロバイダ・インターフェース（ＤＬＰＩ）
データ・リンク層のどちらからも使用できる、ネットワ
ーク・ベースのデバイスへのコンパクトで単純なインタ
ーフェースを定義する。共通データ・リンク受信機能
は、ネットワーク・デマルチプレクサによって提供され
る。デマルチプレクサは、ネットワーク・パケットの配
布に使用される受信フィルタを指定する。ネットワーク
・サービス（ＮＳ）は、ＮＤＤ、ネットワーク・デマル
チプレクサおよびＮＳユーザ（データ・リンクおよびプ
ロトコル）にサービスを供給する、１組のカーネル機能
である。ＮＳは、ＣＤＬＩをつなぎあわせる糊である。

【００１１】

【実施例】図１に、従来の包括データ・リンク制御１１
またはフレームワークの典型を示す。フレームワーク
は、アプリケーション・ユーザ１３またはカーネル・ユ
ーザ１５に、データ転送用データ・リンクを制御するた
めの共通の１組のコマンドを提供する、包括インターフ
ェース定義を定義する。カーネル・ユーザ１５は、通信
メモリのバッファ・プール２１にアクセスすることがで
き、fpカーネル・サービスによってデバイス・ドライバ
（dd）エントリ・ポイントを呼び出す。カーネル上にい
るアプリケーション・ユーザ１３は、標準インターフェ
ース対カーネル・デバイス・ドライバにアクセスし、フ
ァイル・システムが、ddエントリ・ポイントを呼び出
す。データ転送は、一般に、ユーザ空間とカーネル空間
の間でのデータの移動を必要とする。アプリケーション
・ユーザ１３は、アプリケーションまたはアクセス方式
として、カーネル上に常駐する。カーネル・ユーザ１５
は、デバイス・マネージャのカーネル・プロセスとして
カーネル内に常駐する。ファイル入出力サブシステム１
７は、ファイル記述子およびファイル・ポインタ・サブ
ルーチンを、スイッチ・テーブル（図示せず）のファイ
ル・ポインタ（fp）アクセスに変換する。ＤＬＣデバイ
ス・マネージャ１９は、ファイル入出力サブシステムと
通信入出力デバイス・ドライバの間でインターフェース
をとる際にバッファ・プールにアクセスする。このデバ
イス・マネージャは、上側の複数のユーザ、ならびに下
側の複数のデバイス・ドライバおよびアダプタをサポー
トできる。バッファ・プール２１は、通信サブシステム
用のデータ・バッファ・サービスを提供する。通信入出
力デバイス・ドライバ２３は、ハードウェア・アダプタ
の入出力レジスタおよびＤＭＡレジスタを制御し、受信
パケットをＤＬＣデバイス・マネージャに経路指定す
る。アダプタ２５は、通信媒体に接続される。

【００１２】マルチユーザ・マルチアダプタ構成２７
を、図２に示す。これには、複数のアプリケーション・
ユーザ２９と複数のカーネル・ユーザ３５が、対応する
アダプタ３３を伴う複数の通信入出力デバイス・ドライ
バ３１と共に含まれる。この従来式の手法には、異なる
フレームワークのために複数の入出力デバイス・ドライ
バが必要になるという問題がある。

【００１３】以下で、共通機能と、本発明の共通データ
・リンク・インターフェースを使用してそれらの機能を
実現する方法とを説明する。これらの機能は、一般に下
記の順序で発生する。１ネットワーク・デマルチプレクサの追加２ネットワーク・デバイス・ドライバの追加３ネットワーク・デバイス・ドライバの使用の割振り４入力パケット用受信フィルタの追加５状況処理関数の追加６ネットワーク・デマルチプレクサの追加

【００１４】ネットワーク・デマルチプレクサの追加図３を参照すると、ネットワーク・デマルチプレクサ１
４は、ネットワーク・デバイス・ドライバ（NDD）１２
からの入力パケットと非同期状況とを、関心を示したＮ
Ｓユーザに（ns_add_filterまたはns_add_statusを介し
て）経路指定する責任を負う。たとえば、８０２．２Ｌ
ＬＣ用デマルチプレクサは、ＤＳＡＰ（と、おそらくは
ethertype）を使用して、どのユーザが入力パケットを
受け取るかを決定する。デマルチプレクサの関数nd_add
_filter（ns_add_filterを介してアクセスされる）と関
数nd_del_filter（ns_del_filterを介してアクセスされ
る）は、受信フィルタの追加と除去を処理する。ネット
ワーク・デマルチプレクサ１４は、フィルタと関連ユー
ザのリストを保持する責任を負う。構成後、ネットワー
ク・デマルチプレクサ１４は、ns_add_demuxサービスに
よってシステムから使用できるようになる。

【００１５】下記の表に、ns_add_demuxサービスの例を
示す。

【表１】 struct ns_demuxer demuxer; demuxer.use_nsdmx = TRUE; demuxer.add_filter = eth_add_filter; demuxer.del_filter = eth_del_filter; demuxer.add_status = eth_add_status; demuxer.del_status = eth_del_status; demuxer.receive = eth_receive; demuxer.status = eth_status; demuxer.response = eth_response; ns_add_demux(NDD_ETHER, &demuxer);

【００１６】ネットワーク・デバイス・ドライバの追加ネットワーク・デバイス・ドライバは、構成後に、ＮＤ
Ｄユーザから使用できるようになる必要がある。これ
は、ns_attachネットワーク・サービスによって達成さ
れる。このサービスは、ネットワーク・サービスの、使
用可能ネットワーク・デバイス・ドライバのリストにＮ
ＤＤを追加する。図４にこれを示す。上側のブロック３
０に示すように、ndd構造体３２は、NULLを指す次ns_nd
dnet値（next）を有する。＆dd.ndd３４によってアドレ
スされる新ネットワーク・デバイスを追加しなければな
らない。この新ネットワーク・デバイスは、データ構造
３６を有する。このデバイス・ドライバのＮＤＤは、下
側のブロック４０のnddデータ構造であるndd構造体３２
に示すように、使用可能ネットワーク・デバイス・ドラ
イバのリストに追加される。ブロック４０は、ネットワ
ーク・デバイス・ドライバを追加した後の、結果として
得られるデータ構造の相互関係を示すものである。

【００１７】ns_detachサービスは、ns_attachの逆であ
る。すなわち、このサービスは、使用可能デバイスのリ
ストからネットワーク・デバイスを除去する。

【００１８】ネットワーク・デバイス・ドライバの使用
の割振りデバイス・ドライバが（ns_attachを使用して）システ
ムから使用できるようになった後、ユーザはそのデバイ
ス・ドライバにアクセスできる。デバイス・ドライバの
ユーザは、ns_allocネットワーク・サービスを介してＮ
ＤＤへのアクセス権を得る。このサービスは、ＮＤＤの
使用を割振り（図５のndd構造体４２を介して）、必要
があればＮＤＤをオープンする。デバイスへのアクセス
権の放棄は、ns_freeネットワーク・サービスを介して
行われる。具体的なステップを、図５に示す。

【００１９】入力パケット用受信フィルタの追加入力パケット（ＩＰ）を受け取るため、ユーザは、関心
のあるパケットのタイプを指定しなければならない。Ｉ
Ｐは、たとえばethertype 0x800パケットが欲しいこと
を示す。この登録は、ns_add_filterネットワーク・サ
ービスを介して実施される。指定されたＮＤＤのネット
ワーク・デマルチプレクサは、そのフィルタおよびユー
ザのリストに、この受信フィルタを追加する。フィルタ
は、ns_del_filterサービスによって除去される。８０
２．３ローカル・エリア・ネットワーク・パケットの受
信パケットの流れを、図６の下のボックス５０に示す。
フィルタ構造は、符号５２で定義され、符号６０で示す
８０２．２ＬＡＮ用の特定のフィルタ・パラメータを有
する。ユーザは、符号５４で定義される。

【００２０】状況処理関数の追加ユーザは、ＮＤＤ状況情報の受け取りを望む場合、ネッ
トワーク・デマルチプレクサに登録しなければならな
い。この登録は、ns_add_statusネットワーク・サービ
スを介して実施される。指定されたＮＤＤのネットワー
ク・デマルチプレクサが、そのフィルタおよびユーザの
リストに状況フィルタを追加する。状況フィルタは、ns
_del_statusサービスによって除去される。

【００２１】割り振られたネットワーク・デバイス・ド
ライバの使用ここで図７を参照すると、ＮＤＤユーザは、ns_allocサ
ービスを用いてＮＤＤを割り振った後に、ＮＤＤの関数
ndd_output７０および関数ndd_ctl７２を使用すること
ができる。ndd_outputは、関連するデバイス・ドライバ
７４にデータを送るのに使用される。特定のハードウェ
ア・アダプタ用のさまざまなデバイス制御機能および状
況機能が関数ndd_ctlを介して使用できる。パケット
送信と制御機能発行のためのサンプル・コードを、図７
の下側に示す。

【００２２】機能的相互作用図８に、物理デバイス２６およびネットワーク・デマル
チプレクサ１４の制御に使用されるネットワーク・デバ
イス・ドライバ１２と、ネットワーク・サービス１６
と、ＣＤＬＩユーザ８０との間のインターフェースおよ
び相互作用を示す。ＣＤＬＩユーザは、たとえば図３の
ソケット・フレームワーク２２を使用している可能性が
あり、したがって図８のＣＤＬＩユーザ８０とネットワ
ーク・サービス１６の間のインターフェースが図３のイ
ンターフェース４１になる。あるいは、ＣＤＬＩユーザ
が、図３のストリーム・フレームワーク２４を使用して
いる可能性があり、したがって図８のＣＤＬＩユーザ８
０とネットワーク・サービス１６の間のインターフェー
スが図３のインターフェース４３になる。次に、図８に
示した関数またはルーチンのそれぞれを説明する。

【００２３】ネットワーク・サービスの概観以下のルーチンは、それぞれのルーチンの定義によって
示されるように、ネットワーク・サービスのさまざまな
態様を提供する。

【００２４】ユーザ用ネットワーク・サービス（ソケッ
ト、ＤＬＰＩ）。 ns_alloc 指定されたネットワーク・デバイスの使用を割り振る。 ns_free ネットワーク・デバイスへのアクセス権を放棄する。 ns_add_filter フィルタに一致するパケットの受信を可能にする受信フ
ィルタを追加する。 ns_del_filter 受信フィルタを削除し、フィルタに一致するパケットの
受信を不能にする。 ns_add_status 非同期状況の経路指定用フィルタを追加する。 ns_del_status 前に追加された状況フィルタを削除する。

【００２５】ネットワーク・デマルチプレクサ用ネット
ワーク・サービス。 ns_add_demux 指定されたタイプのネットワーク・デバイス用デマルチ
プレクサを追加する。 ns_del_demux 指定されたタイプのネットワーク・デバイス用デマルチ
プレクサを除去する。

【００２６】ネットワーク・デバイス・ドライバ用ネッ
トワーク・サービス。 ns_attach 使用可能ＮＳデバイス連鎖にデバイスを置く。 ns_detach 使用可能デバイス連鎖からデバイスを除去する。

【００２７】以下に、上記のネットワーク・サービス・
ルーチン群を実施するための詳細な実施情報を提供す
る。

【００２８】名前 ns_alloc − ネットワーク・デバイス・ドライバの使
用を割り振る。

【００２９】摘要 #include <sys/ndd.h> int ns_alloc ( nddname, nddpp) char *nddname; struct ndd **nddpp;

【００３０】パラメータ nddname 割り振ろうとするデバイス名。 nddpp ndd構造体を指すポインタのアドレス。

【００３１】解説このネットワーク・サービスは、ＮＳデバイス連鎖を見
回って、指定されたnddnameを有するデバイス・ドライ
バを見つける。一致が見つかった場合、指定されたデバ
イス・ドライバの参照カウントを増分する。参照カウン
トを増分して１になる場合には、ndd構造体で指定され
たルーチンndd_open()を呼び出して、そのデバイス・ド
ライバをオープンする。

【００３２】例 struct ndd *nddp; error = ns_alloc("en0", &nddp);

【００３３】戻り値一致が見つかり、デバイスのオープンに成功した場合、
指定されたデバイスのndd構造体を指すポインタをnddpp
に記憶する。一致が見つからないか、またはデバイスの
オープンに成功しなかった場合、非０値を返す。０ − 動作に成功した。 ENODEV − 無効なネットワーク・デバイスを示す。 ENOENT − このデバイス用に使用可能なネットワーク
・デマルチプレクサがない。他の値は、ＮＤＤのオープンからの戻り値。

【００３４】ファイル net/ns.c

【００３５】関連情報インターフェース：ns_free()、ndd_open() ネットワーク・デバイス・ドライバ

【００３６】名前 ns_free − ネットワーク・デバイスへのアクセス権
を放棄する。

【００３７】摘要 #include <sys/ndd.h> void ns_free ( nddp) struct ndd *nddp;

【００３８】パラメータ nddp 使用から解放しようとするネットワーク・デバイ
スのndd構造体を指定する。

【００３９】解説このネットワーク・サービスは、指定されたndd構造体
の参照カウントを減分する。参照カウントが０になった
場合、ndd構造体内で指定されたルーチンndd_close()を
呼び出す。

【００４０】例 struct ndd *nddp; ns_free(nddp);

【００４１】戻り値なし

【００４２】ファイル net/ns.c

【００４３】関連情報インターフェース：ns_alloc() ネットワーク・デバイス・ドライバ

【００４４】名前 ns_add_filter − パケットの受信を可能にするため
に受信フィルタを登録する。

【００４５】摘要 #include <sys/cdli.h> int ns_add_filter ( nddp, filter, len, ns_user) struct ndd *nddp; caddr_t filter; int len; struct ns_user *ns_user;

【００４６】パラメータ nddp この追加要求の対象となるnddを指定する。 filter 受信フィルタを指すポインタ。 len パラメータfilterの指す受信フィルタのバイ
ト単位の長さ。 ns_user ユーザを定義するns_user構造体を指すポイ
ンタ。

【００４７】解説 ns_add_filterネットワーク・サービスは、パケット受
信用の受信フィルタを登録するために呼び出される。こ
れによって、ネットワーク・デマルチプレクサがパケッ
トを適当なユーザに経路指定できるようになる。この追
加要求は、指定されたＮＤＤ用のデマルチプレクサの関
数nd_add_filterに渡される。ns_add_filterの呼出し側
は、ns_freeを呼び出す前にフィルタを放棄する責任を
負う。

【００４８】例 struct ns_8022 dl; /* ８０２．２LAN用フィルタ
*/ struct ns_user ns_user; /* ユーザを記述する */ dl.filtertype = NS_LLC_DSAP_SNAP; dl.dsap = 0xaa; dl.orgcode[0] = 0x0; dl.orgcode[1] = 0x0; dl.orgcode[2] = 0x0; dl.ethertype = 0x0800; ns_user.isr = ipintr; ns_user.protoq = &ipintrq; ns_user.netisr = NETISR_IP; ns_user.pkt_format = NS_PROTO_SNAP; ns_add_filter(nddp, &dl, sizeof(dl), &ns_user);

【００４９】戻り値０ − 動作に成功した。 ENODEV − 無効なネットワーク・デバイスを示す。 ENOENT − このデバイス用に使用可能なネットワーク
・デマルチプレクサがない。他の値は、ネットワーク・デマルチプレクサからの戻り
値。

【００５０】ファイル net/ns.c

【００５１】関連情報インターフェース：ns_del_filter() ネットワーク・デマルチプレクサ

【００５２】名前 ns_del_filter − 受信フィルタを削除する。

【００５３】摘要 #include <sys/cdli.h> int ns_del_filter ( nddp, filter, len) struct ndd *nddp; caddr_t filter; int len;

【００５４】パラメータ nddp この削除要求の対象となるnddを指定する。 filter 受信フィルタを指すポインタ。 len 受信フィルタのバイト単位の長さ。

【００５５】解説このネットワーク・サービスは、対応するネットワーク
・デマルチプレクサから受信フィルタを削除する。これ
は、そのフィルタに一致するパケットのパケット受信を
不能にするという効果がある。この削除要求は、指定さ
れたＮＤＤのデマルチプレクサの関数nd_del_filterに
渡される。

【００５６】例 struct ns_8022 dl; /* ８０２．２LAN用フィルタ
*/ dl.filtertype = NS_LLC_DSAP_SNAP; dl.dsap = 0xaa; dl.orgcode[0] = 0x0; dl.orgcode[1] = 0x0; dl.orgcode[2] = 0x0; dl.ethertype = 0x0800; ns_del_filter(nddp, &dl, sizeof(dl));

【００５７】戻り値０ − 動作に成功した。 ENODEV − 無効なネットワーク・デバイスを示す。他の値は、ネットワーク・デマルチプレクサからの戻り
値。

【００５８】ファイル net/ns.c

【００５９】関連情報インターフェース：ns_add_filter()およびns_alloc()

【００６０】名前 ns_add_status − 非同期状況の経路指定用の状況フ
ィルタを追加する。

【００６１】摘要 #include <sys/cdli.h> int ns_add_status (nddp, statfilter, len, ns_statuser) struct ndd *nddp; caddr_t statfilter; int len; struct ns_statuser *ns_statuser;

【００６２】パラメータ nddp この追加要求の対象となるndd構造体を
指すポインタ。 statfilter 状況フィルタを指すポインタ。 len statfilterのバイト単位の長さ。 ns_statuser このユーザを定義するns_statuser構造
体を指すポインタ。

【００６３】解説 ns_add_statusネットワーク・サービスは、状況フィル
タの登録のために呼び出される。この追加要求は、指定
されたＮＤＤのデマルチプレクサの関数nd_add_status
に渡される。これによって、ユーザが、指定されたデバ
イスから非同期状況情報を受信できるようになる。

【００６４】注非同期状況を入手できるようになった時、ネットワーク
・デマルチプレクサがユーザの状況処理関数を呼び出
す。ユーザの状況処理関数は、直接に呼び出されるの
で、この状況処理関数は、スケジューリングされるルー
チンになることができない。

【００６５】例 struct ns_statuser user; struct ns_com_status filter; filter.mask = NDD_HARD_FAIL; filter.sid = 0; user.isr = status_fn; user.isr_data = whatever_makes_sense; error = ns_add_status(nddp, &filter, sizeof(filte
r),&user);

【００６６】戻り値０ − 動作に成功した。 ENODEV − 無効なデバイスを示す。他の値は、ネットワーク・デマルチプレクサからの戻り
値。

【００６７】ファイル net/ns.c

【００６８】関連情報インターフェース：ns_del_status() ネットワーク・デマルチプレクサ

【００６９】名前 ns_del_status − 前に追加された状況フィルタを削
除する。

【００７０】摘要 #include <sys/cdli.h> int ns_del_status (nddp, statfilter, len) struct ndd *nddp; caddr_t statfilter; int len;

【００７１】パラメータ nddp この削除要求の対象となるndd構造体を指
すポインタ。 statfilter 状況フィルタを指すポインタ。 len statfilterのバイト単位の長さ。

【００７２】解説 ns_del_statusネットワーク・サービスは、対応するネ
ットワーク・デマルチプレクサから前に追加された状況
フィルタを削除するために呼び出される。この削除要求
は、指定されたＮＤＤのデマルチプレクサの関数nd_del
_statusに渡される。これには、指定されたデバイスか
らの非同期状況通知を不能にする効果がある。

【００７３】例 /* フィルタ・パラメータはns_add_statusの呼出しに使
用されたものと同一。 */ error = ns_add_status(nddp, &filter,sizeof(filte
r));

【００７４】戻り値０ − 動作に成功した。 ENODEV − 無効なデバイスを示す。 EINVAL − 無効なパラメータを示す。他の値は、ネットワーク・デマルチプレクサからの戻り
値。

【００７５】ファイル net/ns.c

【００７６】関連情報インターフェース：ns_add_status() ネットワーク・デマルチプレクサ

【００７７】名前 ns_add_demux − 指定されたタイプのネットワーク・
インターフェース用のデマルチプレクサを追加する。

【００７８】摘要 #include <sys/ndd.h> #include <sys/cdli.h> int ns_add_demux ( ndd_type, demux) int ndd_type; struct ns_demux *demux;

【００７９】パラメータ ndd_type 追加しようとするデマルチプレクサのインタ
ーフェース・タイプ。 demux デマルチプレクサを定義する構造体ns_demux
を指すポインタ。

【００８０】解説このネットワーク・サービスは、使用可能ネットワーク
・デマルチプレクサのリストに、指定されたデマルチプ
レクサを追加する。デマルチプレクサは、ネットワーク
・インターフェース・タイプごとに１つしか存在できな
い。インターフェース・タイプは、同じ特性を有するネ
ットワーク・デバイスの特定のクラス（すなわち、イー
サネット、トークン・リング）を記述するものである。
sys/ndd.hにリストされたndd_type値は、ＳＮＭＰによ
って定義される数である。所望のタイプがndd.hに含ま
れない場合、ＳＮＭＰ値が定義されているならば、その
値を使用しなければならない。定義されていない場合
は、NDD_MAX_TYPEを超える未定義の値を使用することが
できる。

【００８１】例 struct ns_demux demuxer; demuxer.add_filter = eth_add_filter; demuxer.del_filter = eth_del_filter; demuxer.add_status = eth_add_status; demuxer.del_status = eth_del_status; demuxer.receive = eth_receive; demuxer.status = eth_status; demuxer.response = eth_response; ns_add_demux(NDD_ISO88023, &demuxer);

【００８２】戻り値０ − 動作に成功した。 EEXIST − 所与のタイプのデマルチプレクサが既に存
在する。 EINVAL − ndd_typeが範囲外。

【００８３】ファイル net/ns.c

【００８４】関連情報ネットワーク・デマルチプレクサ、ns_del_demux()

【００８５】名前 ns_del_demux − 指定されたタイプのネットワーク・
インターフェース用のデマルチプレクサを削除する。

【００８６】摘要 #include <sys/ndd.h> int ns_del_demux ( ndd_type) int ndd_type;

【００８７】パラメータ ndd_type 削除しようとするデマルチプレクサのネット
ワーク・インターフェース・タイプ。

【００８８】解説デマルチプレクサが現在使用中でない場合、このネット
ワーク・サービスは、使用可能ネットワーク・デマルチ
プレクサのリストから、指定されたデマルチプレクサを
削除する。デマルチプレクサに関してＮＤＤがオープン
されている場合、そのデマルチプレクサは使用中であ
る。

【００８９】例 ns_del_demux(NDD_ISO88023);

【００９０】戻り値０ − 動作に成功した。 ENOENT − 指定されたタイプのデマルチプレクサが存
在しない。 EINVAL − ndd_typeが範囲外。 EBUSY − デマルチプレクサが現在使用中である。

【００９１】ファイル net/ns.c

【００９２】関連情報ネットワーク・デマルチプレクサ、ns_add_demux()

【００９３】名前 ns_attach − ネットワーク・サブシステムにネット
ワーク・デバイスを付加する。

【００９４】摘要 #include <sys/ndd.h> int ns_attach ( nddp) struct ndd *nddp;

【００９５】パラメータ nddp 付加しようとするデバイスを記述したndd構造体
を指すポインタ。

【００９６】解説このネットワーク・サービスは、使用可能ＮＳデバイス
連鎖にデバイスを置くために呼び出される。ns_attach
を呼び出した後にＮＤＤはオープンする準備をしなけれ
ばならない。

【００９７】注 ndd構造体は、デバイスによって割り振られ、初期設定
される。これは、ピン止めしなければならない。

【００９８】例 /* NDD構成中にNDDを追加する例 */ struct ndd ndd; ndd.ndd_name = "en"; ndd.ndd_unit = adap_num; ndd.ndd_addrlen = 6; ndd.ndd_hdrlen = 14; ndd.ndd_mtu = ETHERMTU; ndd.ndd_mintu = 60; ndd.ndd_type = NDD_ETHER; ndd.ndd_flags = NDD_UP | NDD_BROADCAST | NDD_SIMPLEX; ndd.ndd_open = entopen; ndd.ndd_output = entwrite; ndd.ndd_ctl = entctl; ndd.ndd_close = entclose; ns_attach(&ndd);

【００９９】戻り値０ − 動作に成功した。 EEXIST − 使用可能ＮＳデバイス連鎖内にデバイスが
既に存在することを示す。

【０１００】ファイル net/ns.c

【０１０１】関連情報インターフェース：ns_detach()

【０１０２】名前 ns_detach − ネットワーク・サブシステムからネッ
トワーク・デバイスを除去する。

【０１０３】摘要 #include <sys/ndd.h> int ns_detach ( nddp) struct ndd *nddp;

【０１０４】パラメータ nddp 切り離そうとするデバイスを記述したndd構造体
を指すポインタ。

【０１０５】解説このサービスは、使用可能ＮＳデバイスの連鎖からndd
構造体を除去する。

【０１０６】例 /* nddpは、前に付加されたndd構造体のアドレス */ ns_detach(nddp);

【０１０７】戻り値０ − 動作に成功した。 ENOENT − 指定されたndd構造体が見つからなかっ
た。

【０１０８】ファイル net/ns.c

【０１０９】関連情報インターフェース：ns_attach()

【０１１０】ネットワーク・デマルチプレクサの概観ネットワーク・デマルチプレクサは、受信データおよび
状況情報を適当なユーザに経路指定するための諸機能を
提供する。デマルチプレクサは、インターフェースから
受け取る可能性のある異なるタイプの受信データを解釈
でき、経路指定できなければならない。たとえば、ＦＤ
ＤＩインターフェース用のネットワーク・デマルチプレ
クサ（NDDタイプNDD_FDDI）は、ＭＡＣ、ＳＭＴ、作成
者およびＬＬＣのフレームを解釈する必要がある。ＦＤ
ＤＩデマルチプレクサは、ns_add_filterネットワーク
・サービス呼出しに使用される受信フィルタ（入力パケ
ット・デマルチプレクシング用の判断基準）のフォーマ
ットを指定する責任も負うことになる。

【０１１１】ネットワーク・デマルチプレクサは、ns_a
dd_demuxネットワーク・サービスを介してＮＳに登録す
る。

【０１１２】ＮＳに登録されるデマルチプレクサは、ネ
ットワーク・インターフェース・タイプ（＜sys/ndd.h
＞に定義される）ごとに１つしか存在できない。

【０１１３】ネットワーク・デマルチプレクサは、下記
の関数からなる。 nd_config() この任意指定のエントリ・ポイントは、デマルチプレク
サの構成機能を提供する。 nd_receive() 受信データを適当なＮＳユーザに経路指定する。 nd_status() 非同期状況を適当なＮＳユーザに配布する。 nd_add_filter() 受信データの経路指定用の受信フィルタを追加する。 nd_del_filter() 前に指定された受信フィルタを削除する。 nd_add_status() 非同期状況の経路指定用のフィルタを追加する。 nd_del_status() 前に指定された状況フィルタを削除する。

【０１１４】次に、上記にリストしたネットワーク・デ
マルチプレクサ・ルーチン群を実施するための詳細な実
施情報を提供する。

【０１１５】名前 nd_config() − ネットワーク・デマルチプレクサ構
成

【０１１６】摘要 #include <sys/cdli.h> #include <sys/ndd.h> int nd_config( op, indata, indatalen, outdata,outd
atalen) sysconfig_op_t op; nd_config_t * indata; size_t indatalen; nd_config_t * outdata; size_t outdatalen;

【０１１７】パラメータ op SYSCONFIG_CONFIGUREまたはSYSCONFIG_UNC
ONFIGUREのどちらか indata デマルチプレクサ構成情報 indatalen indataのバイト単位の長さ outdata 返される構成情報 outdatalen outdataのバイト単位の長さ

【０１１８】解説この関数は、ネットワーク・デマルチプレクサの構成を
提供する。SYSCONFIG_CONFIGUREを与えると、デマルチ
プレクサがシステムに構成される。このデマルチプレク
サは、SYSCONFIG_UNCONFIGUREによって除去される。ネ
ットワーク・デマルチプレクサのタイプは、indataに含
まれる。

【０１１９】注 SYSCONFIG_CONFIGUREの場合、ns_add_demuxネットワー
ク・サービスを呼び出して、指定されたタイプのネット
ワーク・インターフェース用のデマルチプレクサを追加
しなければならない。SYSCONFIG_UNCONFIGUREの場合、n
s_del_demuxを呼び出してデマルチプレクサを除去しな
ければならない。

【０１２０】戻り値 ns_add_demuxまたはns_del_demuxの戻り値

【０１２１】関連情報インターフェース：ns_add_demux()、ns_del_demux() OSF/1 System Extension Guide。

【０１２２】名前 nd_receive() − ＮＤＤからの受信データを処理す
る。

【０１２３】摘要 #include <sys/ndd.h> #include <sys/mbuf.h> void nd_receive( nddp, m) struct ndd *nddp; struct mbuf *m;

【０１２４】パラメータ nddp 受信データの起点であるndd構造体のアドレス。 m 受信データを含むmbuf連鎖を指すポインタ。

【０１２５】解説この関数は、着信データを処理し、そのデータを適当な
ユーザに経路指定する。この関数は、そのインターフェ
ース・タイプから受信される可能性のある異なるタイプ
のフレームを解釈できなければならない。ネットワーク
・デバイス・ドライバは、有効な受信フレーム（ハード
ウェアによって示される）のすべてを、ネットワーク・
デマルチプレクサ受信関数に渡す。

【０１２６】注関数nd_receive()は、割込みに対して安全でなければな
らない。mbuf連鎖の最初のmbufは、M_PKTHDRフォーマッ
トでなければならない。フィールドm_pkthdr.lenは、パ
ケットの全長に設定しなければならない。mbufのフィー
ルドm_nextpktを用いて連鎖することによって、複数の
入力パケットをデマルチプレクサに渡すことができる。
入力パケットをユーザに渡さない場合、関数nd_receive
が、バッファを解放する責任を負う。

【０１２７】戻り値この関数には戻り値がない。

【０１２８】関連情報ネットワーク・デバイス・ドライバ、mbufサービス

【０１２９】名前 nd_status() − ＮＤＤからの状況情報を処理する。

【０１３０】摘要 #include <sys/ndd.h> #include <sys/cdli.h> void nd_status( nddp, status) struct ndd *nddp; ndd_stat_t *status;

【０１３１】パラメータ nddp この情報の起点のデバイスのndd構造体を指定
する。 status ndd_stat_t状況ブロックを指すポインタ。この
状況ブロックは、状況事象に関するデバイス固有の情報
を含む。この状況ブロックは、sys/ndd.hで定義され
る。

【０１３２】解説状況事象がネットワーク・デバイス上で発生する時、Ｎ
ＤＤが、適当な状況ブロックを作成し、状況関数を呼び
出す。この関数は、状況情報を適当なユーザに経路指定
する責任を負う。

【０１３３】注関数nd_status()は、割込みに対して安全でなければな
らない。状況ブロックは、参照によって渡され、この呼
出しの持続期間の間だけ有効である。

【０１３４】戻り値この関数には戻り値がない。

【０１３５】関連情報ネットワーク・デマルチプレクサ

【０１３６】名前 nd_add_filter() − 指定されたデバイスの受信フィ
ルタを追加する。

【０１３７】摘要 #include <sys/ndd.h> #include <sys/cdli.h> int nd_add_filter ( nddp, filter, len, ns_user) struct ndd *nddp; caddr_t filter; int len; struct ns_user *ns_user;

【０１３８】パラメータ nddp そのデバイスのndd構造体を指定する。 filter 追加しようとする受信フィルタを指す。フォ
ーマットはデマルチプレクサに依存する。 len パラメータfilterの指す受信フィルタのバイ
ト単位の長さ。デマルチプレクサは、この長さが正しい
ことを検査しなければならない。 ns_user このユーザを記述したns_user構造体を指す
ポインタ。

【０１３９】解説関数nd_add_filter()は、ns_add_filterネットワーク・
サービス呼出しから呼び出される。ルーチンnd_add_fil
ter()は、指定された受信フィルタを、可能受信パター
ンのリストに追加する。これに続いて、NDDのndd_ctl関
数が、NDD_ADD_FILTER動作とこのパラメータfilterで指
定された値を用いて呼び出される。

【０１４０】戻り値０ − 動作に成功した。 EEXIST − 受信フィルタは既に使用中である。 EINVAL − 受信フィルタが無効である。他の値は、デマルチプレクサに依存する戻り値。

【０１４１】関連情報インターフェース：ns_add_filter()

【０１４２】名前 nd_del_filter() − 指定されたデバイス用の受信フ
ィルタを削除する。

【０１４３】摘要 #include <sys/ndd.h> #include <sys/cdli.h> int nd_del_filter ( nddp, filter, len) struct ndd *nddp; caddr_t filter; int len;

【０１４４】パラメータ nddp この削除要求のデバイスのndd構造体を指定す
る。 filter 削除しようとする受信フィルタを指す。フォー
マットはデマルチプレクサに依存する。 len パラメータfilterの指す受信フィルタのバイト
単位の長さ。デマルチプレクサは、この長さが正しいこ
とを検査しなければならない。

【０１４５】解説 nd_del_filter()は、ns_del_filterネットワーク・サー
ビス呼出しから呼び出される。ルーチンnd_del_filte
r()は、可能受信パターンのリストから、指定された受
信フィルタを除去する。これに続いて、NDDのndd_ctl関
数が、NDD_DEL_FILTER動作とこのパラメータfilterで指
定された値を用いて呼び出される。

【０１４６】戻り値０ − 動作に成功した。 EINVAL − 無効な受信フィルタを示す。他の値は、デマルチプレクサに依存する戻り値。

【０１４７】関連情報インターフェース：ns_del_filter()およびns_add_demu
x()

【０１４８】名前 nd_add_status() − 指定されたデバイス用の状況処
理関数を追加する。

【０１４９】摘要 #include <sys/ndd.h> #include <sys/cdli.h> int nd_add_status ( nddp, statfilter, len, ns_statuser) struct ndd *nddp; caddr_t statfilter; int len; struct ns_statuser *ns_statuser;

【０１５０】パラメータ nddp この追加要求のデバイスのndd構造体を
指定する。 statfilter 追加しようとする状況フィルタを指す。
フォーマットはデマルチプレクサに依存する。 len パラメータstatfilterの指す状況フィル
タのバイト単位の長さ。 ns_statuser このユーザを記述したns_statuser構造
体を指すポインタ。

【０１５１】解説関数nd_add_status()は、ns_add_statusネットワーク・
サービス呼出しから呼び出される。ルーチンnd_add_sta
tus()は、指定された状況フィルタを状況処理関数のリ
ストに追加する。これに続いて、NDDのndd_ctl関数が、
NDD_ADD_STATUS動作とこのパラメータstatfilterで指定
された値を用いて呼び出される。

【０１５２】戻り値０ − 動作に成功した。 EINVAL − 状況フィルタが無効である。他の値は、デマルチプレクサに依存する戻り値。

【０１５３】関連情報インターフェース：ns_add_status()

【０１５４】名前 nd_del_status() − 指定されたデバイス用の状況フ
ィルタを削除する。

【０１５５】摘要 #include <sys/ndd.h> #include <sys/cdli.h> int nd_del_status ( nddp, statfilter, len) struct ndd *nddp; caddr_t statfilter; int len;

【０１５６】パラメータ nddp この削除要求のデバイスのndd構造体を指
定する。 statfilter 削除しようとする状況フィルタを指す。フ
ォーマットはデマルチプレクサに依存する。 len パラメータstatfilterの指す状況フィルタ
のバイト単位の長さ。

【０１５７】解説関数nd_del_status()は、ns_del_statusネットワーク・
サービス呼出しから呼び出される。ルーチンnd_del_sta
tus()は、指定された状況フィルタを使用して、呼出し
側の状況処理関数を除去する。これに続いて、ＮＤＤの
ndd_ctl関数が、NDD_DEL_STATUS動作とこのパラメータs
tatfilterで指定された値を用いて呼び出される。

【０１５８】戻り値０ − 動作に成功した。 EINVAL − 無効なパラメータ。他の値は、デマルチプレクサに依存する戻り値。

【０１５９】関連情報インターフェース：ns_del_status()

【０１６０】名前 nd_response() − ８０２．２ＬＬＣＸＩＤまたは
ＴＥＳＴ要求用の応答フレームを作成し、送信する。

【０１６１】摘要 #include <sys/ndd.h> #include <sys/mbuf.h> void nd_response( nddp, m, llcoffset) struct ndd *nddp; struct mbuf *m; caddr_t llcoffset;

【０１６２】パラメータ nddp 応答を送信しなければならない対象のndd
構造体のアドレス。 m ＸＩＤパケットまたはＴＥＳＴパケットを
含むmbuf連鎖を指すポインタ。 llcoffset ８０２．２ＬＬＣヘッダの先頭のオフセッ
ト。

【０１６３】解説この関数は、ＭＡＣレベル処理を実行することによっ
て、着信ＸＩＤ要求または着信ＴＥＳＴ要求を処理す
る。たとえば、８０２．３デマルチプレクサは、８０
２．３ヘッダ内のソース・フィールドと宛先フィールド
を反転しなければならない。この関数の呼出し側は、既
に８０２．２のＸＩＤ処理またはＴＥＳＴ処理を行って
いなければならない。パケット処理の後に、この関数
は、指定されたＮＤＤのndd_output関数を呼び出す。

【０１６４】注関数nd_response()は、割込みに対して安全でなければ
ならない。連鎖の最初のmbufは、M_PKTHDRフォーマット
でなければならない。フィールドm_pkthdr.lenは、パケ
ットの全長に設定しなければならない。mbufのフィール
ドm_nextpktを用いて連鎖することによって、複数のパ
ケットをこの関数に渡すことはできない。エラーが発生
する場合、mbufは解放されず、応答フレームは送信され
ない。

【０１６５】戻り値この関数には戻り値がない。

【０１６６】関連情報ネットワーク・デバイス・ドライバ

【０１６７】ネットワーク・デバイス・ドライバの概観ネットワーク・デバイス・ドライバ（ＮＤＤ）は、物理
ハードウェアとのデータ送受信のための諸機能を提供す
る。ユーザ・アプリケーションは、ソケットまたはスト
リームによってネットワーク・デバイスとインターフェ
ースする。ＮＤＤは、下記のエントリ・ポイントおよび
関数からなる。 ndd_config − 構成機能を提供する。 ndd_open − システム資源を割り振り、データの読み
書きのためデバイスを初期設定する。 ndd_close − デバイスを既知の状態にリセットし、
システム資源を解放する。 ndd_output − データ送信のための手段を提供する。 ndd_ctl − デバイスを制御するためのさまざまな機
能。

【０１６８】NDDは、下記の関数を介してデマルチプレ
クサともインターフェースする。 nd_rcv − この関数は、ネットワーク・デマルチプレ
クサのnd_receive関数の構文に適合する。 nd_stat − この関数は、ネットワーク・デマルチプ
レクサのnd_status関数の構文に適合する。

【０１６９】構成の完了時に、ns_attachネットワーク
・サービスを呼び出して、指定されたデバイスを使用可
能ＮＳデバイス連鎖に置く。ns_attachの呼出しは、必
要なマイクロコード、経路指定テーブルまたは他の情報
がロードされるまで延期される可能性がある。

【０１７０】終了が完了する前に、ns_detachネットワ
ーク・サービスを呼び出して、指定されたデバイスを使
用可能ＮＳデバイス連鎖から除去する。

【０１７１】以下に、上にリストしたネットワーク・デ
バイス・ドライバ・ルーチン群を実施するための詳細な
実施情報を提供する。

【０１７２】名前 ndd_open関数 − 指定されたデバイスをオープンす
る。

【０１７３】摘要 #include <sys/ndd.h> int ndd_open ( nddp) struct ndd *nddp;

【０１７４】パラメータ nddp このオープン要求の対象のデバイスのndd構造体
を指すポインタ。

【０１７５】解説関数ndd_open()が呼び出される時、デバイス・ドライバ
は、必要なシステム資源のすべてを割り振り、そのデバ
イスをネットワークに付加しなければならない。１デバ
イスあたり１つのオープンだけがサポートされる。ネッ
トワーク・デマルチプレクサの受信関数および状況関数
は、この呼出しの前にＮＳによってndd構造体内に置か
れる。

【０１７６】注デバイスを使用するデータの送受信は、ndd_open()関数
が成功裡に完了した後でなければ実行できない。オープ
ンの時、ネットワーク・デバイス・ドライバ（ＮＤＤ）
は、ネットワークへ付加するため、必要な初期設定のす
べてを行う。ＮＤＤは、「妥当な」時間の間、初期設定
の完了を待ちながらブロックする。正当な時間は、アダ
プタ固有である。これは、イーサネットの場合には１分
になり、トークンリングの場合には１秒になることがあ
る。この時間制限に達した場合、ＮＤＤは、フラグNDD_
UPをセットし、呼出し側に成功を返す。初期設定が最終
的に完了した時に、非同期状況を送って、オープンが完
了したことを示す。ndd構造体のフィールドndd_flags内
で、フラグNDD_RUNNINGもセットされる。ハード・オー
プン・エラーだけが返される。非同期オープンに関して
接続に失敗した場合、フラグNDD_UPをオフにする。ndd_
open関数は、ns_allocネットワーク・サービスからのみ
呼び出される。

【０１７７】戻り値０ − 動作に成功した。 EBUSY − デバイスが既にオープンされている。 ENOMEM − 必要なメモリを割り振れない。 ENODEV − 無効なデバイス。 ENOCONNECT − オープンに失敗し、ネットワークに接
続できなかったことを示す。

【０１７８】関連情報関数ndd_close()

【０１７９】名前 ndd_close関数 − 指定されたデバイスをクローズす
る。

【０１８０】摘要 #include <sys/ndd.h> int ndd_close( nddp) struct ndd *nddp;

【０１８１】パラメータ nddp クローズしようとするデバイスのndd構造体を指
すポインタ。

【０１８２】解説関数ndd_close()が呼び出される時、デバイス・ドライ
バは、指定されたデバイスをネットワークから切り離
し、前に割り振られたシステム資源を解放する。デバイ
スは、そのデバイスの送信待ち行列の処理を許可される
まで、ネットワークから切り離されない。すなわち、nd
d_close()は、すべてのパケットの送信が終わるまでリ
ターンしない。デバイスがクローズの時点で動作不能で
ある場合、そのデバイスの送信待ち行列を空にさせる必
要はない。ＮＤＤは、ndd_close()の時点で所有してい
るすべてのバッファを解放する責任を負う。この関数
は、デバイスを既知の状態にリセットする。

【０１８３】注 ndd_close関数は、ns_freeネットワーク・サービスから
のみ呼び出される。

【０１８４】戻り値０ − 動作に成功した。

【０１８５】関連情報関数ndd_open()

【０１８６】名前 ndd_output関数 − 指定されたネットワーク・デバイ
スにデータを出力する。

【０１８７】摘要 #include <sys/ndd.h> #include <sys/mbuf.h> int ndd_output(nddp, m) struct ndd *nddp; struct mbuf *m;

【０１８８】パラメータ nddp そのデバイスのndd構造体のアドレス。 m 送信しようとするパケットのmbufポインタ。

【０１８９】解説関数ndd_output()は、ネットワーク上にデータを送信す
るため、ＮＳユーザによって呼び出される。送信データ
はmbuf内で渡される。成功した書込み要求の際に、ＮＤ
Ｄは、その要求に関連するすべてのバッファを解放する
責任を負う。ndd_outputの呼出しが失敗の場合、ＮＤＤ
はmbufを解放しない。連鎖されたパケットのうちのどれ
かを送信できる場合、その書込みは成功とみなされ、Ｎ
ＤＤはその連鎖のすべてのmbufを解放する責任を負う。

【０１９０】注 ndd_output()は、割込みに対して安全でなければなら
ず、ブロックすることはできない。mbuf連鎖の最初のmb
ufは、M_PKTHDRフォーマットでなければならず、フィー
ルドm_pkthdr.lenは、パケットの全長（バイト単位）に
設定しなければならない。mbufのフィールドm_nextpkt
を使用することによって、複数のパケットを連鎖するこ
とができる。

【０１９１】戻り値０ − 送信に成功した。 EAGAIN − 送信待ち行列が満杯である。 ENETDOWN − ネットワークが永久的にダウンしてい
る。 ENETUNREACH − ネットワークが一時的にアクセス不
能である。

【０１９２】関連情報関数ndd_open()、mbufサービス

【０１９３】名前 ndd_ctl関数 − デバイス制御関数を提供する

【０１９４】摘要 #include <sys/ndd.h> int ndd_ctl ( nddp, cmd, arg, len) struct ndd *nddp; int cmd; caddr_t arg; int len;

【０１９５】パラメータ nddp デバイスのndd構造体のアドレス。 cmd 実行しようとする制御動作を指定する。コマンド
は下で説明する。 arg 制御パラメータ・ブロックのアドレスを指定す
る。フォーマットはコマンド固有である。 len パラメータargの長さ（バイト単位）。

【０１９６】解説 NDD_GET_STATS 包括的な統計とデバイス固有の統計を検索する。arg
は、統計を返すバッファのアドレスである。 NDD_ENABLE_ADDRESS 代替アドレスを用いたパケットの受信を可能にする（た
とえばマルチキャスト）。argは、可能にしようとする
マルチキャスト・アドレスを指す。argのフォーマット
は、ＮＤＤタイプに固有である。フィールドndd_flags
にフラグNDD_ALTADDRSをセットしなければならない。 NDD_DISABLE_ADDRESS 代替アドレスの受信を不能にする。パラメータargは、
使用不能にしようとするアドレスを指す。argのフォー
マットは、ＮＤＤタイプに固有である。最後の代替アド
レスである場合、ndd構造体のフィールドndd_flagsでフ
ラグNDD_ALTADDRSをリセットしなければならない。 NDD_PROMISCUOUS_ON 乱雑モードをサポートするデバイスに対しては乱雑モー
ドをオンにする。 NDD_PROMISCUOUS_OFF 乱雑モードを終了する。 NDD_ADD_FILTER このコマンドは、ハードウェア・レベルのフィルタリン
グをサポートするデバイスが使用するためのものであ
る。パラメータargは、フィルタ・リストに追加しよう
とする受信フィルタ（たとえばsap）を指す。フィルタ
のフォーマットは、デバイス・タイプ固有である。arg
のフォーマットは、ＮＤＤタイプに固有である。 NDD_DEL_FILTER ハードウェア・フィルタ・リストから、前に追加された
フィルタを除去する。パラメータargは、除去しようと
するフィルタを指す。argのフォーマットは、ＮＤＤタ
イプに固有である。 NDD_MIB_SET 指定されたデバイスに対してＭＩＢをセットする。パラ
メータargは、下記のフィールドを含むndd_mib_acc構造
体のアドレスを指定する。 length パラメータndd_mib_setのバイト単位の全長。 ndd_mib_set count − セットするＭＩＢ変数の数。下記のフィールドは、count回だけ繰り返される。 mib − セットするＭＩＢ変数。 status − セット動作から返される状況。値は、sys/
ndd.hで定義される。 mib_len − フィールドmib_valueのバイト単位の長
さ。 mib_value − ＭＩＢ変数にセットする値。 NDD_MIB_QUERY デバイス固有のＭＩＢがサポートされるかどうかを判定
する。パラメータargは、ndd_mib_acc構造体を指す。 length mdd_mib_queryのバイト単位の全長 ndd_mib_query デバイス固有ＭＩＢ構造体を指すポイ
ンタ。この構造体のこの部分には、各ＭＩＢ変数のサポ
ートの水準を示すフラグが書き込まれる。これらのフラ
グは、sys/ndd.hで定義される。 NDD_MIB_GET 指定されたデバイス上のすべてのＭＩＢの値を検索す
る。パラメータargは、ndd_mib_acc構造体を指す。 length ndd_mib_getのバイト単位の全長。 ndd_mib_get デバイス固有ＭＩＢ構造体を指すポイン
タ。 NDD_ENABLE_MULTICAST すべてのマルチキャスト・パケットの受信を可能にす
る。ndd構造体のフィールドndd_flags中でフラグNDD_MU
LTICASTをセットしなければならない。 NDD_DISABLE_MULTICAST すべてのマルチキャスト・パケットの受信を不能にす
る。ndd構造体のフィールドndd_flags中でフラグNDD_MU
LTICASTをリセットしなければならない。

【０１９７】注ＮＤＤインターフェースに適合するすべてのデバイス・
ドライバは、上記のコマンド動作のそれぞれを、必ずし
もサポートしなくともよいが、認識しなければならな
い。追加の制御動作は、必要に応じて個々のＮＤＤによ
って指定できる。

【０１９８】関数ndd_ctl()は、割込みに対して安全で
なければならない。また、ndd_ctl()は、参照カウント
を必要とする制御動作（たとえば乱雑モードのセット）
の参照カウントを維持しなければならない。

【０１９９】これらの関数には、特権検査は不要であ
る。特権検査は、より高いレベルで行われる。

【０２００】戻り値０ − 成功。 EOPNOTSUPP − そのコマンドはサポートされない。 EINVAL − 無効なパラメータが指定された。 ENETUNREACH − ネットワークが現在アクセス不能で
ある。 ENETDOWN − ネットワークが永久的にダウンしてい
る。

【０２０１】共通デマルチプレクサ・サービスの概観共通デマルチプレクサ・サービスは、ネットワーク・デ
マルチプレクサをより簡単に作成できるように、共通機
能を提供する。これらのサービスは、下記の関数からな
る。

【０２０２】dmx_8022_receive() 受信した８０２．２ＬＬＣデータを適当なユーザに経路
指定する。

【０２０３】dmx_status() 非同期状況を適当なユーザに配布する。

【０２０４】dmx_8022_add_filter() 受信データの経路指定用の８０２．２受信フィルタを追
加する。

【０２０５】dmx_8022_del_filter() 前に指定された８０２．２受信フィルタを削除する。

【０２０６】dmx_add_status() 非同期状況の経路指定用フィルタを追加する。

【０２０７】dmx_del_status() 前に追加された状況フィルタを削除する。

【０２０８】次に、上記にリストした共通デマルチプレ
クサ・サービス・ルーチン群を実施するための詳細な実
施情報を提供する。

【０２０９】名前 dmx_8022_receive() − ＮＤＤからの受信データを処
理する。

【０２１０】摘要 #include <sys/ndd.h> #include <sys/mbuf.h> void dmx_8022_receive(nddp, m, llcoffset) struct ndd *nddp; struct mbuf *m; int llcoffset;

【０２１１】パラメータ nddp 受信データの起点のndd構造体のアドレ
ス。 m 受信パケットを含むmbuf連鎖を指すポイン
タ。 llcoffset ８０２．２ＬＬＣヘッダへのバイト単位の
オフセットを指定する。

【０２１２】解説この関数は、着信８０２．２データを処理し、そのデー
タを適当なユーザに経路指定する。データの経路指定
は、前にns_add_filterおよびdmx_8022_add_filterネッ
トワーク・サービスを介して追加された８０２．２フィ
ルタを使用することによって達成される。

【０２１３】注関数dmx_8022_receive()は、割込みに対して安全でなけ
ればならない。連鎖の最初のmbufは、M_PKTHDRフォーマ
ットでなければならない。フィールドm_pkthdr.lenは、
パケットの全長に設定しなければならない。mbufのフィ
ールドm_nextpktを用いて連鎖することによって、複数
のパケットをこの関数に渡すことはできない。入力パケ
ットをユーザに渡さない場合、関数dmx_8022_receiveが
バッファを解放する。

【０２１４】戻り値この関数には戻り値がない。

【０２１５】関連情報ネットワーク・デバイス・ドライバ

【０２１６】名前 dmx_status() − ＮＤＤからの状況情報を処理する。

【０２１７】摘要 #include <sys/ndd.h> #include <sys/cdli.h> void dmx_status(nddp, status) struct ndd *nddp; struct ndd_statblk *status;

【０２１８】パラメータ nddp この情報の起点のデバイスのndd構造体を指
定する。 status ndd_statblk状況ブロックを指すポインタ。
この状況ブロックは、状況事象に関するデバイス固有情
報を含む。この情報ブロックは、sys/ndd.hで定義され
る。

【０２１９】解説 dmx_statusネットワーク・サービスは、ネットワーク・
デマルチプレクサの状況関数から呼び出される。これ
は、状況情報を適当なユーザに経路指定する責任を負
う。

【０２２０】注関数dmx_status()は、割込みに対して安全でなければな
らない。

【０２２１】状況ブロックは、参照によって渡され、こ
の呼出しの持続期間の間だけ有効である。

【０２２２】戻り値この関数には戻り値がない。

【０２２３】関連情報ネットワーク・デマルチプレクサ

【０２２４】名前 dmx_8022_add_filter() − 指定されたデバイス用の
８０２．２受信フィルタを追加する。

【０２２５】摘要 #include <sys/ndd.h> #include <sys/cdli.h> int dmx_8022_add_filter (nddp, filter, ns_user) struct ndd *nddp; struct ns_8022 *filter; struct ns_user *ns_user;

【０２２６】パラメータ nddp デバイスのndd構造体を指定する。 filter 追加しようとする８０２．２受信フィルタを
指す。 ns_user このユーザを記述したns_user構造体を指す
ポインタ。

【０２２７】解説関数dmx_8022_add_filter()は、ネットワーク・デマル
チプレクサのフィルタ追加関数から呼び出される。この
ルーチンは、指定された８０２．２ＬＬＣ受信フィルタ
を可能受信パターンのリストに追加する。

【０２２８】戻り値０ − 動作に成功した。 ENOMEM − 要求された資源を割り振れない。 EEXIST − 受信フィルタが既に使用中である。 EINVAL − 受信フィルタが無効である。

【０２２９】関連情報インターフェース：ns_add_filter()

【０２３０】名前 dmx_8022_del_filter() − 指定されたデバイスの８
０２．２ＬＬＣ受信フィルタを削除する。

【０２３１】摘要 #include <sys/ndd.h> #include <sys/cdli.h> int dmx_8022_del_filter (nddp, filter) struct ndd *nddp; struct ns_8022 *filter;

【０２３２】パラメータ nddp この削除要求の対象となるデバイスのndd構造
体を指定する。 filter 削除しようとする受信フィルタを指定するns_8
022構造体を指す。

【０２３３】解説 dmx_8022_del_filter()サービスは、ネットワーク・デ
マルチプレクサのフィルタ削除関数から呼び出される。
これは、指定された８０２．２ＬＬＣ受信フィルタを、
可能受信パターンのリストから削除する。

【０２３４】戻り値０ − 動作に成功した。 ENOENT − 指定されたフィルタが見つからなかった。 EINVAL − 無効な受信フィルタを表す。

【０２３５】関連情報インターフェース：ns_del_filter()

【０２３６】名前 dmx_add_status() − 指定されたデバイス用の状況処
理関数を追加する。

【０２３７】摘要 #include <sys/ndd.h> #include <sys/cdli.h> int dmx_add_status (nddp, statfilter, ns_statuser) struct ndd *nddp; struct ns_com_status *statfilter: struct ns_statuser *ns_statuser;

【０２３８】パラメータ nddp この追加要求の対象となるデバイスのnd
d構造体を指定する。 statfilter 追加しようとする状況フィルタを指す。 ns_statuser このユーザを記述したns_statuser構造
体を指すポインタ。

【０２３９】解説関数dmx_add_status()は、ネットワーク・デマルチプレ
クサの状況追加関数から呼び出される。これは、指定さ
れたns_com_statusフィルタを状況処理関数のリストに
追加する。dmx_statusサービスは、状況事象を処理する
ために状況ユーザを呼び出すべきであるかどうかを判定
する時、この状況フィルタを使用する。

【０２４０】戻り値０ − 動作に成功した。 ENOMEM − 要求された資源を割り振れない。 EINVAL − 状況フィルタが無効。

【０２４１】関連情報インターフェース：ns_add_status( )

【０２４２】名前 dmx_del_status() − 指定されたデバイス用の状況フ
ィルタを削除する。

【０２４３】摘要 #include <sys/ndd.h> #include <sys/cdli.h> int dmx_del_status (nddp, statfilter) struct ndd *nddp; struct ns_com_status *statfilter;

【０２４４】パラメータ nddp この削除要求の対象となるデバイスのndd
構造体を指定する。 statfilter 削除しようとする状況フィルタを指す。

【０２４５】解説関数dmx_del_status()は、ネットワーク・デマルチプレ
クサの状況削除関数から呼び出される。これは、指定さ
れたns_com_statusフィルタを状況処理関数のリストか
ら削除する。ns_com_status構造体のフィールドsidを使
用して、正しい状況フィルタを除去する。このため、共
通状況関数のユーザは、dmx_add_status呼出しからの状
況フィルタを保管しなければならない。

【０２４６】戻り値０ − 動作に成功した。 ENOENT − 指定されたフィルタが見つからなかった。 EINVAL − 無効なパラメータ。

【０２４７】関連情報インターフェース：ns_del_status()

【０２４８】下記のデータ構造定義が、共通データ・リ
ンク・インターフェースを可能にするために、上記の諸
ルーチンと共に使用される。

【０２４９】名前 ndd − ネットワーク・デバイス・ドライバを定義す
る。

【０２５０】摘要 #include <sys/ndd.h> struct ndd { struct ndd *ndd_next; u_int ndd_refcnt; char *ndd_name; u_short ndd_unit; u_long ndd_flags; caddr_t ndd_correlator; /* プロシージャ・ハンドル */ int (*ndd_open)(); int (*ndd_close)(); int (*ndd_output)(); int (*ndd_ctl)(); /* ユーザ受信関数およびユーザ状況関数 */ void (*nd_receive)(); void (*nd_status)(); /* ドライバの記述 */ u_long ndd_mtu; u_long ndd_mintu; u_char ndd_type; u_char ndd_addrlen; u_char ndd_hdrlen; caddr_t ndd_physaddr; /* 統計 */ struct ndd_genstats ndd_genstats; caddr_t ndd_specsats; caddr_t ndd_speclen; struct ns_demuxer *ndd_demuxer; struct ns_dmx_ctl *ndd_nsdemux; caddr_t ndd_specdemux; };

【０２５１】フィールド ndd_next 使用可能ＮＤＤ連鎖内の次のＮＤＤを指すポインタ。こ
のフィールドは、ns_attachおよびns_detachネットワー
ク・サービスによってのみ修正されなければならない。

【０２５２】ndd_refcnt このＮＤＤに関する未解決ns_allocの数のカウンタ。ns
_allocネットワーク・サービスはこのカウンタを増分
し、ns_freeサービスはこれを減分する。

【０２５３】ndd_name このＮＤＤの名前。たとえば"en"。

【０２５４】ndd_unit 同一タイプの特定のデバイスを識別するのに使用する。
イーサネットＮＤＤは、システム内に２つのアダプタが
ある場合に、"en"という名前と０または１のユニットを
有することができる。その場合、このＮＤＤのユーザ
は、"en0"および"en1"という名前でアダプタを参照する
ことになる。

【０２５５】ndd_flags デバイスの状況と特性を記述する。これらのフラグはす
べて、ＮＤＤによってセットされる。NDD_RUNNING、NDD
_DEADおよびNDD_LIMBOは、相互に排他的である。 NDD_UP ＮＤＤのオープンに成功した時にセッ
トされる。非同期オープンが後に失敗する場合、このフ
ラグをリセットしなければならない。 NDD_RUNNING ＮＤＤがオープンされており、動作し
ている。 NDD_DEAD アダプタが動作していない。 NDD_LIMBO ＮＤＤが、デバイス・エラーから回復
しようと試みている。 NDD_BROADCAST このアダプタは、媒体同報通信能力を
有する。 NDD_SIMPLEX アダプタが、それ自体の送信を聞き取
れない。 NDD_DEBUG ＮＤＤが、デバッグ・モードで動作し
ている。 NDD_PROMISC アダプタが、乱雑モードである。 NDD_ALTADDRS アダプタが、代替アドレス（たとえば
マルチキャスト）を受信している。 NDD_MULTICAST アダプタが、全マルチキャスト・アド
レスを受信している。

【０２５６】ndd_correlator このフィールドは、ＮＤＤが、内部制御構造体との相関
に使用することができる。

【０２５７】ndd_open ＮＤＤのオープン関数のアドレス。

【０２５８】ndd_close ＮＤＤのクローズ関数のアドレス。

【０２５９】ndd_output ＮＤＤのパケット送信関数のアドレス。

【０２６０】ndd_ctl ＮＤＤのデバイス制御関数のアドレス。

【０２６１】ndd_rcv デマルチプレクサ受信関数を指すポインタ。ＮＤＤは、
パケットを受信した時、この関数を呼び出す。このフィ
ールドは、ns_allocネットワーク・サービスによって初
期設定される。

【０２６２】ndd_stat デマルチプレクサ状況関数を指すポインタ。ＮＤＤは、
非同期状況を入手できる時、この関数を呼び出す。この
フィールドは、ns_allocネットワーク・サービスによっ
て初期設定される。

【０２６３】ndd_mtu 送信可能な最大パケット・サイズ。

【０２６４】ndd_mintu 送信可能な最小パケット・サイズ。

【０２６５】ndd_type ＮＤＤの媒体タイプ（たとえば、ＦＤＤＩＮＤＤの場
合にはNDD_FDDI）。イーサネットＮＤＤが８０２．３を
サポートする場合、NDD_ISO88023というタイプを使用し
なければならない。そうでない場合には、NDD_ETHERで
なければならない。可能な値のリストについてはsys/nd
d.hを参照されたい。

【０２６６】ndd_addrlen このフィールドには、物理アドレスのバイト単位の長さ
が含まれる。たとえば、これは、イーサネットの場合に
は６になる。

【０２６７】ndd_hdrlen このＮＤＤの媒体レベルおよびリンク・レベルのヘッダ
のバイト単位の全長。ヘッダが可変長の場合、最大長を
指定しなければならない。

【０２６８】ndd_physaddr このデバイスの物理アドレスを指すポインタ。

【０２６９】ndd_genstats ndd_genstats構造体には、すべてのＮＤＤタイプに共通
の単純なカウンタが含まれる。

【０２７０】ndd_specstats ＮＤＤ固有カウンタを指すポインタ。デバイス固有カウ
ンタがない場合、このフィールドをNULLにしてよい。

【０２７１】ndd_speclen ndd_specstatsが指すデバイス固有統計の長さ。

【０２７２】ndd_demuxer このフィールドは、ＮＤＤに関連するネットワーク・デ
マルチプレクサ（struct ns_demuxer）を指す。最初のn
s_allocの時点でNULLである場合、このフィールドは、
ネットワーク・サービスによって初期設定される。そう
でない場合、指定されたデマルチプレクサを使用する。

【０２７３】ndd_nsdemux 共通デマルチプレクサ・サービスが、ＮＤＤに関連する
デマルチプレクサによって使用される場合、このフィー
ルドは、デマルチプレクサ制御構造体を指す。ネットワ
ーク・サービスが、このフィールドを初期設定する。

【０２７４】ndd_specdemux デマルチプレクサは、このフィールドを初期設定し、各
ＮＤＤ用のデマルチプレクサ構造体を指すのに使用する
ことができる。

【０２７５】解説 ndd構造体は、ネットワーク・デバイス・ドライバを定
義し、ＮＤＤとそのユーザの間の連係を提供する。各ネ
ットワーク・デバイスに、１つのndd構造体が関連付け
られる。

【０２７６】注 ndd構造体は、ＮＤＤによって割り振られ、所有され
る。これは、ピン止めされなければならない。

【０２７７】ファイル sys/ndd.h

【０２７８】名前 ndd_genstats − 共通ＮＤＤ統計を定義する。

【０２７９】摘要 #include <sys/ndd.h> struct ndd_genstats { u_long ndd_ipackets_msw; u_long ndd_ipackets_lsw; u_long ndd_ibytes_msw; u_long ndd_ibytes_lsw; u_long ndd_recvintr_msw; u_long ndd_recvintr_lsw; u_long ndd_ierrors; u_long ndd_opackets_msw; u_long ndd_opackets_lsw; u_long ndd_obytes_msw; u_long ndd_obytes_lsw; u_long ndd_xmitintr_msw; u_long ndd_xmitintr_lsw; u_long ndd_oerrors; u_long ndd_nobufs; u_long ndd_xmitque_max; u_long ndd_xmitque_ovf; /*XXX - Paul */};

【０２８０】フィールド ndd_ipackets_msw このＮＤＤ上で受信したパケットの数の最上位ワード。

【０２８１】ndd_ipackets_lsw このＮＤＤ上で受信したパケットの数の最下位ワード。

【０２８２】ndd_ibytes_msw 全受信バイト数の最上位ワード。

【０２８３】ndd_ibytes_lsw 全受信バイト数の最下位ワード。

【０２８４】ndd_ierrors 遭遇した受信エラーの数。

【０２８５】ndd_opackets_msw このＮＤＤ上で送信したパケットの数の最上位ワード。

【０２８６】ndd_opackets_lsw このＮＤＤ上で送信したパケットの数の最下位ワード。

【０２８７】ndd_obytes_msw 送信したバイトの数の最上位ワード。

【０２８８】ndd_obytes_lsw 送信したバイトの数の最下位ワード。

【０２８９】ndd_oerrors このＮＤＤに関する出力エラーの数。

【０２９０】ndd_xmitintr_msw 送信完了割込みの回数の最上位ワード。

【０２９１】ndd_xmitintr_lsw 送信完了割込みの回数の最下位ワード。

【０２９２】ndd_recvintr_msw データ受信割込みの回数の最上位ワード。

【０２９３】ndd_recvintr_lsw データ受信割込みの回数の最下位ワード。

【０２９４】ndd_nobufs バッファが使用できなかった回数。

【０２９５】ndd_xmitque_max 待ち行列化された送信の最大数。

【０２９６】ndd_xmitque_ovf 送信待ち行列オーバーフロー・エラーの数。

【０２９７】解説 ndd_genstats構造体は、すべてのＮＤＤタイプに共通の
単純なカウンタを保存するのに使用される。

【０２９８】注 ndd_genstats構造体は、ndd構造体の一部である。

【０２９９】ファイル sys/ndd.h

【０３００】名前 ndd_statblk − ネットワーク・デバイス・ドライバ
状況ブロック。

【０３０１】摘要 #include <sys/ndd.h> struct ndd_statblk { u_int code; u_int option[10]; };

【０３０２】フィールド code 状況ブロックのタイプを定義する。可能なコード値は、
sys/ndd.hで定義される。 NDD_HARD_FAIL ハードウェア障害が発生した NDD_LIMBO_ENTER ネットワーク回復モードに入った NDD_LIMBO_EXIT ネットワーク回復モードから出た NDD_STATUS さまざまな状況情報と事象情報

【０３０３】option このフィールドは、理由コードまたは他の情報を含むこ
とができる。フィールドoptionのフォーマットは、code
ごとに指定される。 NDD_ADAP_CHECK アダプタ・チェック停止状態 NDD_BUS_ERROR バス・エラー NDD_CMD_FAIL デバイス・コマンドが障害を発生した NDD_PIO_FAIL PIO動作が障害を発生した NDD_UCODE_FAIL デバイス・マイクロコードの障害 NDD_TX_ERROR 送信エラーが発生した NDD_TX_TIMEOUT 送信タイムアウト・エラー NDD_RCV_ERROR 受信エラーが発生した NDD_AUTO_RMV 自動除去エラーを検出した NDD_CONNECTED デバイス・オープン成功 NDD_BAD_PKTS 不良パケットを受信した

【０３０４】解説この構造体は、非同期デバイス状況情報をＣＤＬＩユー
ザに伝えるのに使用される。

【０３０５】ファイル sys/ndd.h

【０３０６】名前 ns_user − 入力パケット配布に関するユーザ特性を
記述する。

【０３０７】摘要 #include <sys/cdli.h> #include <net/if.h> struct ns_user { int (*isr)(); caddr_t isr_data; struct ifqueue *protoq; u_short pkt_format; u_short netisr; struct ifnet *ifp; };

【０３０８】フィールド isr 入力パケットを処理する関数のアドレス。この関数は、
ユーザ指定のフィルタに一致する受信データを入手でき
る時に呼び出される。

【０３０９】isr_data パラメータprotoqがNULLの場合、このフィールドが、パ
ラメータとしてisrに渡される。

【０３１０】protoq 入力ifqueueのアドレス。このフィールドが非NULLの場
合、入力パケットが、待ち行列化され、isrが、schedne
tisr(netisr)を用いてスケジューリングされる。これが
NULLの場合、下記のようにisrが直接呼び出される。 . isr(nddp, m, macp, isr_data); ただし、nddpは、データの起点のndd構造体。mは、入力
パケット。macpは、パケットの先頭を指す。isr_data
は、ns_add_filterの呼出しで指定された値。

【０３１１】pkt_format このフィールドは、入力パケットのパケット・ヘッダ表
示を指定する。可能な値は下記のとおりである。 NS_PROTO リンク・レベル・ヘッダをすべて除去する。ＳＮＡＰは
使用しない。 NS_PROTO_SNAP ＳＮＡＰを含むリンク・レベル・ヘッダをすべて除去す
る。 NS_INCLUDE_LLC ＬＬＣヘッダを定位置に残す。 NS_INCLUDE_MAC ヘッダを全く除去しない。 NS_HANDLE_NON_UI ＸＩＤフレームおよびＴＥＳＴフレームを自動的に処理
する。

【０３１２】netisr このフィールドは、ユーザisr関数のスケジューリング
に使用されるnetisr数を示す。netisrが非０の場合、pr
otoqがすべて指定されなければならず、ユーザは、neti
sr_addサービスを呼び出して、netisrを登録しなければ
ならない。

【０３１３】ifp 呼出し側がIFNETドライバの場合、このフィールド中で
適当なifnetポインタをセットしなければならない。呼
出し側がＩＦＮＥＴドライバでない場合、このフィール
ドをNULLにしなければならない。

【０３１４】解説この構造体は、パケットをデマルチプレクサのユーザに
配布する方法を記述するのに使用される。ユーザは、ns
_add_filterサービスを呼び出す前にこの構造体を初期
設定する。

【０３１５】ファイル sys/cdli.h

【０３１６】名前 ns_statuser − あるデバイスの非同期状況ユーザを
記述する。

【０３１７】摘要 struct ns_statuser int (*isr)(); caddr_t isr_data; };

【０３１８】フィールド isr 非同期状況を処理する関数のアドレス。この関数は、非
同期状況事象が発生した時に呼び出される。isrは、下
記のように直接呼び出される。 isr(nddp, status, isr_data); ただしnddpは、この状況の起点のndd構造体。status
は、ndd_statblk構造体を指すポインタ。isr_dataは、n
s_add_statusの呼出しで指定された値。

【０３１９】isr_data このフィールドは、パラメータとしてisrに渡される。

【０３２０】解説この構造体は、状況ユーザを記述するのに使用される。
これは、非同期状況の発生時にそれを提示するのに使用
される。

【０３２１】ファイル sys/cdli.h

【０３２２】名前 ns_8022 − 共通デマルチプレクサ・サービスが使用
する８０２．２ＬＬＣ受信フィルタ。

【０３２３】摘要 struct ns_8022 { u_int filtertype; u_char dsap; u_char orgcode[3]; u_short ethertype; };

【０３２４】フィールド filtertype 受信フィルタリングのタイプを指定する。下記のうちの
どれか。 NS_8022_LLC_DSAP ８０２．２ＤＳＡＰフィールドに対するフィルタ NS_8022_LLC_DSAP_SNAP ＳＮＡＰを有する８０２．２に対するフィルタ NS_TAP ＮＤＤからすべてのネットワーク・パケットを受信す
る。NS_TAPユーザは、パケットの待ち行列化を指定でき
ない。NS_TAPユーザは、直接呼び出され、パケットに関
心がある場合にはそのパケットをコピーしなければなら
ない。

【０３２５】dsap フィルタリングの対象となる８０２．２ＬＬＣＤＳＡ
Ｐ。

【０３２６】orgcode ８０２．２ＳＮＡＰヘッダ内の編成コードを指定する。
このフィールドは、filtertypeがNS_8022_LLC_DSAP_SNA
Pにセットされている場合に限って有効である。

【０３２７】ethertype ８０２．２ＳＮＡＰヘッダ内のフィールドethertypeを
指定する。このフィールドは、filtertypeがNS_8022_LL
C_DSAP_SNAPにセットされている場合に限って有効であ
る。

【０３２８】解説この構造体は、共通デマルチプレクサ・サービスが使用
する受信フィルタである。これを用いると、プロトコル
多重化のために８０２．２ＬＬＣを使用する、ネットワ
ークに対するフィルタリングが可能になる。

【０３２９】ファイル sys/cdli.h

【０３３０】名前 ns_comstatus − 共通デマルチプレクサ・サービス用
の状況フィルタ。

【０３３１】摘要 struct ns_comstatus { u_int filtertype; u_int mask; u_int sid; };

【０３３２】フィールド filtertype 状況フィルタのタイプを指定する。これは、NS_STATUS_
MASKにセットしなければならない。 mask 状況コードマスク値。あるデバイス上で非同期事象が発
生した時、ネットワーク・デマルチプレクサは、指定さ
れたフィールドmaskと状況ブロックのフィールドcodeの
論理和をとる。その結果が非０である場合、その状況ブ
ロックがユーザに配布される。 sid このフィールドは、ns_add_statusサービスによって計
算される状況ＩＤを保持する。ユーザは、この値を記憶
し、これをns_del_statusサービスに供給しなければな
らない。

【０３３３】解説この構造体は、共通デマルチプレクサ・サービスが使用
する状況フィルタである。これは、ユーザに、どの状況
事象に関心があるかを指定する手段を与える。

【０３３４】ファイル sys/cdli.h

【０３３５】名前 ifqueue − ネットワーク・パケット待ち行列。

【０３３６】摘要 struct ifqueue { struct mbuf *ifq_head; struct mbuf *ifq_tail; int ifq_len; int ifq_maxlen; int ifq_drops; };

【０３３７】フィールド ifq_head 待ち行列の最初のmbufを指すポインタ。 ifq_tail 待ち行列の最後のmbufを指すポインタ。 ifq_len 待ち行列内のパケットの数。 ifq_maxlen この待ち行列上で待機できるパケットの最大数。 ifq_drops 待ち行列が満杯だったために捨てられたパケットの数。

【０３３８】解説この構造体は、待ち行列サービスを要求したＣＤＬＩユ
ーザのためにネットワーク・パケットを待ち行列化する
のに使用される。ifqueuesを操作するためのマクロが、
net/if.hにある。パケットは、待機状態ＦＩＦＯであ
る。mbufのフィールドm_nextpktは、待合せ機構として
使用される。パケットは、IF-DEQUEUEマクロを使用する
ことによって、一時に１つずつ除去することができる。

【０３３９】ファイル net/if.h

【０３４０】名前 nd_dmxstats − ネットワーク・デマルチプレクサ統
計。

【０３４１】摘要 struct nd_dmxstats { u_long nd_nofilter; u_long nd_nobufs: u_long nd_bcast; u_long nd_mcast; };

【０３４２】フィールド nd_nofilter ユーザがいないので捨てられたパケットの数。 nd_nobufs バッファを使用できなかったので捨てられたパケットの
数。 nd_bcast 受信した同報通信パケットの数。 nd_mcast 受信したマルチキャスト・パケットの数。

【０３４３】解説この構造体は、デマルチプレクサ・タイプから独立な統
計を含む。この統計は、使用カウンタと診断カウンタを
提供する。

【０３４４】ファイル sys/cdli.h

【０３４５】名前 ns_demuxer − ネットワーク・デマルチプレクサを定
義する。

【０３４６】摘要 struct ns_demuxer { u_short inuse; u_short use_nsdmx; int (*add_filter)(); int (*del_filter)(); int (*add_status)(); int (*del_status)(); int (*receive)(); int (*status)(); int (*response)(); };

【０３４７】フィールド inuse あるデマルチプレクサが現在使用中であるかどうかを示
す。このフィールドは、ネットワーク・サービスによっ
てのみセットされる。これは、ns_allocごとに増分さ
れ、ns_freeごとに減分される。

【０３４８】use_nsdmx このフィールドは、デマルチプレクサが、ＣＤＬＩの提
供する共通デマルチプレクサ・サービスを使用しようと
している場合に真にセットしなければならない論理変数
である。共通サービスを使用しない場合、この値を偽に
セットしなければならない。

【０３４９】add_filter デマルチプレクサのフィルタ追加関数のアドレス。この
関数は、ns_add_filterネットワーク・サービスから呼
び出される。

【０３５０】del_filter デマルチプレクサのフィルタ削除関数のアドレス。この
関数は、ns_del_filterネットワーク・サービスから呼
び出される。

【０３５１】add_status デマルチプレクサの状況追加関数のアドレス。この関数
は、ns_add_statusネットワーク・サービスから呼び出
される。

【０３５２】del_status デマルチプレクサの状況削除関数のアドレス。この関数
は、ns_del_statusネットワーク・サービスから呼び出
される。

【０３５３】receive デマルチプレクサのパケット入力関数のアドレス。受信
データを入手できる時、ＮＤＤがこの関数を呼び出す。

【０３５４】status デマルチプレクサの状況処理関数のアドレス。非同期状
況が発生した時、ＮＤＤがこの関数を呼び出す。

【０３５５】response ＸＩＤフレーム応答またはＴＥＳＴフレーム応答が必要
な時に呼び出される関数のアドレス。

【０３５６】解説この構造体は、ns_add_demuxサービスを介してネットワ
ーク・デマルチプレクサを登録するのに使用される。こ
れは、デマルチプレクサのさまざまなエントリ・ポイン
トを指定する。

【０３５７】ファイル sys/cdli.h

【０３５８】名前 nd_config − ネットワーク・デマルチプレクサ構成
情報を提供する。

【０３５９】摘要 #include <sys/cdli.h> struct nd_config { int version; int errcode; int ndd_type; };

【０３６０】フィールド version nd_config構造体のバージョン番号。ND_CONFIG_VERSION
_1にセットされる。

【０３６１】errcode デマルチプレクサ構成から返される状況。

【０３６２】ndd_type このデマルチプレクサがサービスするＮＤＤのタイプを
指定する。

【０３６３】解説この構造体は、ネットワーク・デマルチプレクサに構成
情報を渡すのに使用される。

【０３６４】ファイル sys/cdli.h

【０３６５】

【発明の効果】要約すると、単一のハードウェア・アダ
プタの使用を介して複数のデータ・フレームワークを可
能にするための均一なインターフェースが提供される。
これによって、さまざまなハードウェア・プラットフォ
ームへのオペレーティング・システムの可搬性が大幅に
単純化され、そのような複数フレームワーク・サポート
を提供するためのハードウェア・アダプタ要件が最小に
なる。

【図面の簡単な説明】

【図１】包括プログラミング・インターフェースを使用
するデータ・リンク・サービスまたはネットワーク・サ
ービスを提供する従来のフレームワークを示す図であ
る。

【図２】図１に示したものの、従来のマルチユーザ・マ
ルチアダプタ構成を示す図である。

【図３】共通データ・リンク・インターフェース（ＣＤ
ＬＩ）の全体的システム・ブロック図である。

【図４】ＣＤＬＩシステムへのネットワーク・デバイス
・ドライバの追加を示す図である。

【図５】ＣＤＬＩシステムでのネットワーク・ドライバ
の使用の割振りを示す図である。

【図６】ＣＤＬＩシステムでの入力パケット用受信フィ
ルタの追加を示す図である。

【図７】ＣＤＬＩシステムでの割り振られたネットワー
ク・デバイス・ドライバの使用を示す図である。

【図８】ＣＤＬＩシステムでのデータおよびコードの流
れを示す図である。

【符号の説明】

１２ネットワーク・デバイス・ドライバ（ＮＤＤ）１３アプリケーション・ユーザ１４ネットワーク・デマルチプレクサ１５カーネル・ユーザ１６ネットワーク・サービス１８ＩＦＮＥＴ２０ＤＬＰＩ２２ソケット・フレームワーク２３通信入出力デバイス・ドライバ２４ストリーム・フレームワーク２５アダプタ２６物理デバイス

───────────────────────────────────────────────────── フロントページの続き (72)発明者ロン・エドワード・ホールアメリカ合衆国78759、テキサス州オースチン、ダブル・スパー・ループ 10607 (72)発明者グレゴリー・スコット・ジョイスアメリカ合衆国78753、テキサス州オースチン、ファロウ・コーヴ 12318ビー (72)発明者ポール・デーヴィド・マズラナアメリカ合衆国78758、テキサス州オースチン、レベッカ・ドライブ 1006 (72)発明者ランス・ウォレン・ラッセルアメリカ合衆国78624、テキサス州フレデリックスバーグ・ルート３ボックス 310ビー (56)参考文献特開平４−279952（ＪＰ，Ａ) (58)調査した分野(Int.Cl.⁶，ＤＢ名) G06F 13/00 H04L 12/00

Claims

(57)【特許請求の範囲】

【請求項１】データ通信サブシステム内で複数のフレー
ムワークをサポートするためのシステムであって、オペレーティング・システム・サービスとハードウェア
・アダプタをインターフェースするためのデバイス・ド
ライバ手段と、前記デバイス・ドライバ手段に結合された、前記通信サ
ブシステム内で活動状態デバイスを維持するためのサー
ビス手段と、前記デバイス・ドライバ手段に結合された、第１フレー
ムワークを使用可能にするための層１手段と、前記デバイス・ドライバ手段に結合された、第２フレー
ムワークを使用可能にするための層２手段と、前記デバイス・ドライバ手段に結合された、受信データ
をフィルタするためのネットワーク・デマルチプレクサ
手段とを具備し、前記第１フレームワークが、ストリーム・フレームワー
クを含むことを特徴とするシステム。
【請求項２】データ通信サブシステム内で複数のフレー
ムワークをサポートするためのシステムであって、オペレーティング・システム・サービスとハードウェア
・アダプタをインターフェースするためのデバイス・ド
ライバ手段と、前記デバイス・ドライバ手段に結合された、前記通信サ
ブシステム内で活動状態デバイスを維持するためのサー
ビス手段と、前記デバイス・ドライバ手段に結合された、第１フレー
ムワークを使用可能にするための層１手段と、前記デバイス・ドライバ手段に結合された、第２フレー
ムワークを使用可能にするための層２手段と、前記デバイス・ドライバ手段に結合された、受信データ
をフィルタするためのネットワーク・デマルチプレクサ
手段とを具備し、前記第２フレームワークが、ソケット・フレームワーク
を含むことを特徴とするシステム。
【請求項３】前記第２フレームワークが、ソケット・フ
レームワークを含むことを特徴とする、請求項１のシス
テム。