189 lines
6.2 KiB
Groff
189 lines
6.2 KiB
Groff
.\" jpman %Id: pccard.conf.5,v 1.3 1998/07/10 15:23:53 jsakai Stab %
|
|
.\"
|
|
.\" Copyright (c) 1994 Andrew McRae. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. The name of the author may not be used to endorse or promote products
|
|
.\" derived from this software without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
.\" WORD: resource リソース[pccard.conf.5]
|
|
.\"
|
|
.Dd November 2, 1994
|
|
.Dt PCCARD.CONF 5
|
|
.Os FreeBSD
|
|
.Sh 名称
|
|
.Nm pccard.conf
|
|
.Nd
|
|
.Xr pccardd 8
|
|
設定ファイル
|
|
.Sh 解説
|
|
.Nm pccard.conf
|
|
ファイルは、PC-CARD スロット管理デーモン
|
|
.Xr pccardd 8
|
|
用の設定ファイルです。カードを識別し、
|
|
PC-CARD カードにドライバ (ドライバ用リソースも含む) を
|
|
対応させることが出来る情報を提供します。
|
|
.Pp
|
|
設定ファイル内には四つの基本的な要素があります。
|
|
オプションとして他のセクションに先立って
|
|
.Em "リソースプール"
|
|
があり、その後 1 つ以上の
|
|
.Em "カード識別子"
|
|
と
|
|
.Em "デバイス実体"
|
|
が続きます。
|
|
最後の 2 つはどんな順序で現れてもよく、
|
|
都合に応じてあちこちへ散在しても構いません。
|
|
.Pp
|
|
それぞれの PC-CARD カードは、製造者やカードのバージョンを規定する
|
|
設定タプルを含んでいます。これらは、設定ファイル中でカードの仕様を
|
|
特定するのに使われ、それによって、そのカードとインタフェースをとれる
|
|
ドライバを見つけます。
|
|
カードとドライバの間には、多対 1 の対応関係があります。すなわち、
|
|
単一のドライバが複数の型のカードにインタフェースをとることがあります。
|
|
この助けとして、ドライバの指定とは別に、カードの初期化や
|
|
(ネットワークカードの場合なら) イーサネットアドレスの取り出し用に
|
|
パラメータを指定することもできます。
|
|
.Pp
|
|
ドライバは一度カードに割り当てられると、そのカードに割り当てられた
|
|
ままになります。しかし、同じ型のドライバの複数の実体が設定される
|
|
こともあるため、もし、同じの型のドライバが対応づけられているカードが
|
|
2 枚挿し込まれたら、同じ名前で別のドライバ実体が設定される可能性があります。
|
|
.Pp
|
|
.Em insert
|
|
と
|
|
.Em remove
|
|
コマンドは、実行可能なシェルコマンド行を指定することができます。
|
|
実行されるコマンドは、そのキーワードの後の行の残りです。
|
|
行は、バックスラッシュを使って継続することができます。
|
|
簡単なマクロ置換によって、現在のカーネルのデバイス名
|
|
.Em ( $device )
|
|
とネットワークカードのイーサネットアドレス
|
|
.Em ( $ether )
|
|
をコマンド行へ入れることが可能です。
|
|
.Xr pccardd 8
|
|
は、コマンド行を実行するために
|
|
.Xr system 3
|
|
サブルーチンを使います。
|
|
.Pp
|
|
数値は 8 進数、16 進数、10 進数のいずれかの表現をとります。
|
|
もし 10 進数に
|
|
.Em k
|
|
か
|
|
.Em K
|
|
が付いていれば、その値は 1024 を掛けたものになります。
|
|
名前にスペースを含める必要があるならば、
|
|
ダブルクォートで括っておくとよいでしょう。
|
|
ハッシュ文字 (#) は、その行の残りをコメントにします。
|
|
.Ss "リソースプール"
|
|
この (オプションである) セクションは、ISA バスのメモリアドレス空間や
|
|
I/O ポート、割込み要求番号 (IRQ) といったシステムリソースのプールを指定します。
|
|
このリソースプールは、それぞれのドライバの記述中で指定された要求に応じて、
|
|
動的にアドレス空間や割り込み番号を割り当てるのに使われます。
|
|
.Pp
|
|
リソースに関する構文は以下の通りです。
|
|
.Pp
|
|
.Dl io Ar start - end ...
|
|
.Dl memory Ar address size ...
|
|
.Dl irq Ar irq-number ...
|
|
.Pp
|
|
各文では、初期化時にドライバへ割り当てるのに使える、
|
|
I/O やメモリや IRQ のブロックを定義します。
|
|
.Pp
|
|
上の文はどれも複数行にすることができ、
|
|
これで各々のリソースをかたまりに分けて定義することができます。
|
|
.Ss "カード識別子"
|
|
カード識別子の構文は以下の通りです。
|
|
.Pp
|
|
.Dl card Ar manufacturer version
|
|
.Dl config Ar index driver interrupt [ flags ]
|
|
.Dl ether Ar offset
|
|
.Dl insert Ar command
|
|
.Dl remove Ar command
|
|
.Pp
|
|
第 1 行は必須です。あとの文はオプションであり、
|
|
どのような順序で現れても構いません。
|
|
.Em config
|
|
行は複数存在することもあります。
|
|
.Em card
|
|
のパラメータには、製造者名とカードのバージョンがあり、
|
|
カードの CIS メモリから得た値との一致をみるのに使われます。
|
|
.Em config
|
|
パラメータは、
|
|
カードの CIS で得られる範囲からそのカードの設定インデックスを選択し、
|
|
この設定で関連づけられたドライバを選択し、
|
|
そして (もしあれば) 割り当てられるべき割り込みレベルを選択します。
|
|
オプションとしてフラグの集合を割り当てることもできます。
|
|
.Pp
|
|
オプションの
|
|
.Em ether
|
|
キーワードは、カードの属性メモリ内に
|
|
ネットワークカードの物理イーサネットアドレスが保持されているときに使われます。
|
|
この文のパラメータは、イーサネットアドレスの属性メモリ内での
|
|
オフセットを指しています。この値は、
|
|
.Em $ether
|
|
マクロを使うことで、 insert/remove コマンド内でも使用できます。
|
|
.Pp
|
|
.Em insert
|
|
及び
|
|
.Em remove
|
|
セクションでは、カードが挿入されたり取り外されたりしたときに
|
|
実行されるべきシェルコマンドを書くことができます。複数の
|
|
.Em insert
|
|
や
|
|
.Em remove
|
|
コマンドも書くことができ、その場合列挙された順に実行されます。
|
|
.Sh 使用例
|
|
典型的な設定ファイルは以下のような体裁でしょう。
|
|
.Bd -literal
|
|
#
|
|
# サンプル設定ファイル
|
|
#
|
|
# パラメータのプール
|
|
#
|
|
io 0x280 - 0x2F0 0x300 - 0x360
|
|
irq 5 6 8 9 10 15
|
|
memory 0xd4000 96k
|
|
memory 0xc4000 32k
|
|
#
|
|
# カードデータベース
|
|
#
|
|
card "RPTI LTD." "EP400" # NE2000 clone
|
|
ether 0x110
|
|
config 0x21 "ed0" 5
|
|
insert ifconfig $device physical $ether
|
|
insert ifconfig $device bean
|
|
remove ifconfig $device down
|
|
|
|
card "XYZZY" "FAX/1.0" tty
|
|
config 0x30 "sio1" 11
|
|
insert echo start getty
|
|
remove echo stop getty
|
|
|
|
.Ed
|
|
.Sh 関連ファイル
|
|
.Bl -tag -width /etc/pccard.conf -compact
|
|
.It Pa /etc/pccard.conf
|
|
.Xr pccardd 8
|
|
の設定ファイル。
|
|
.El
|
|
.Sh 関連項目
|
|
.Xr pccardd 8
|