.\" 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