283 lines
8.4 KiB
Groff
283 lines
8.4 KiB
Groff
.\"
|
|
.\" 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.
|
|
.\"
|
|
.\" %FreeBSD: src/usr.sbin/pccard/pccardd/pccard.conf.5,v 1.25 2004/07/02 23:12:51 ru Exp %
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\" WORD: resource リソース[pccard.conf.5]
|
|
.\"
|
|
.Dd November 2, 1994
|
|
.Dt PCCARD.CONF 5
|
|
.Os
|
|
.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
|
|
.Pa /etc/pccard.conf
|
|
ファイルは、デフォルトのリソースプール設定と pccard 識別子データベースを持つ
|
|
.Pa /etc/defaults/pccard.conf
|
|
からインクルードされます。
|
|
ユーザ固有の設定を
|
|
.Pa /etc/pccard.conf
|
|
で指定して、これらのデフォルトを上書きしたり追加エントリを追加可能です。
|
|
.Pp
|
|
それぞれの PC-CARD カードは、製造者やカードのバージョンを規定する
|
|
設定タプルを含んでいます。これらは、設定ファイル中でカードの仕様を
|
|
特定するのに使われ、それによって、そのカードとインタフェースをとれる
|
|
ドライバを見つけます。
|
|
カードとドライバの間には、多対 1 の対応関係があります。すなわち、
|
|
単一のドライバが複数の型のカードにインタフェースをとることがあります。
|
|
この助けとして、ドライバの指定とは別に、カードの初期化や
|
|
(ネットワークカードの場合なら) イーサネットアドレスの取り出し用に
|
|
パラメータを指定することもできます。
|
|
.Pp
|
|
ドライバは一度カードに割り当てられると、そのカードに割り当てられた
|
|
ままになります。しかし、同じ型のドライバの複数の実体が設定される
|
|
こともあるため、もし、同じの型のドライバが対応づけられているカードが
|
|
2 枚挿し込まれたら、同じ名前で別のドライバ実体が設定される可能性があります。
|
|
.Pp
|
|
.Em insert
|
|
と
|
|
.Em remove
|
|
コマンドは、実行可能なシェルコマンド行を指定することができます。
|
|
実行されるコマンドは、そのキーワードの後の行の残りです。
|
|
行は、バックスラッシュを使って継続することができます。
|
|
簡単なマクロ置換によって、現在のカーネルのデバイス名
|
|
.Em ( $device )
|
|
とネットワークカードのイーサネットアドレス
|
|
.Em ( $ether )
|
|
をコマンド行へ入れることが可能です。
|
|
.Xr pccardd 8
|
|
は、コマンド行を実行するために
|
|
.Xr system 3
|
|
サブルーチンを使います。
|
|
.Pp
|
|
.Xr pccardd 8
|
|
は、syslog を使用して、カードの挿抜をアナウンスします。
|
|
.Em logstr
|
|
コマンドで設定された文字列を使用するか、
|
|
これが設定されていない場合には、製造者とカードバージョンの文字列を使用します。
|
|
.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
|
|
デバッグレベルパラメータの文法は次の通りです:
|
|
.Pp
|
|
.Dl debuglevel Ar level
|
|
.Pp
|
|
上の文はどれも複数行にすることができ、
|
|
これで各々のリソースをかたまりに分けて定義することができます。
|
|
.Ss "カード識別子"
|
|
カード識別子の構文は以下の通りです。
|
|
.Pp
|
|
.Dl card Ar manufacturer version [ add_info1 [ add_info2 ]]
|
|
.Dl config Ar index driver interrupt [ flags ]
|
|
.Dl ether Ar offset
|
|
.Dl reset Ar time
|
|
.Dl iosize Ar size
|
|
.Dl memsize Ar size
|
|
.Dl insert Ar command
|
|
.Dl remove Ar command
|
|
.Dl logstr Ar string
|
|
.Pp
|
|
第 1 行は必須です。あとの文はオプションであり、
|
|
どのような順序で現れても構いません。
|
|
.Em config
|
|
行は複数存在することもあります。
|
|
.Em card
|
|
のパラメータには、製造者名、カードのバージョン、
|
|
そして追加情報 add_info1 と add_info2 があり、
|
|
カードの CIS メモリから得た値との一致をみるのに使われます。
|
|
\&"/.*/" のように '/' で文字列を括れば、
|
|
これらのパラメータは、拡張正規表現
|
|
.Xr regex 3
|
|
で記述可能です。
|
|
各式は、先頭において文字 '^' で評価されます。
|
|
.Pp
|
|
.Em config
|
|
パラメータは、
|
|
カードの CIS で得られる範囲からそのカードの設定インデックスを選択し、
|
|
この設定で関連づけられたドライバを選択し、
|
|
そして (もしあれば) 割り当てられるべき割り込みレベルを選択します。
|
|
オプションとしてフラグの集合を割り当てることもできます。
|
|
.Ar index
|
|
では、
|
|
.Dq auto
|
|
または
|
|
.Dq default
|
|
か、カードの CIS から取得可能な範囲を指定します。
|
|
.Dq auto
|
|
により、CIS から取得される情報と使用中の I/O リソースの状態から、
|
|
自動的にリソースを割り当て可能です。
|
|
.Pp
|
|
オプションの
|
|
.Em ether
|
|
キーワードは、カードの属性メモリ内に
|
|
ネットワークカードの物理イーサネットアドレスが保持されているときに使われます。
|
|
この文のパラメータは、イーサネットアドレスの属性メモリ内での
|
|
オフセットを指しています。この値は、
|
|
.Em $ether
|
|
マクロを使うことで、insert/remove コマンド内でも使用できます。
|
|
.Pp
|
|
オプションの
|
|
.Em reset
|
|
キーワードは、カード挿入時のリセット期間を
|
|
.Ar time
|
|
ミリ秒であると指定します。
|
|
デフォルトは 100 ミリ秒です。
|
|
.Pp
|
|
.Em iosize
|
|
と
|
|
.Em memsize
|
|
のキーワードは、
|
|
I/O ポートや共有メモリブロック等のリソースが CIS タプルに指定されていない
|
|
カード用に使用します。
|
|
.Pp
|
|
.Em insert
|
|
及び
|
|
.Em remove
|
|
セクションでは、カードが挿入されたり取り外されたりしたときに
|
|
実行されるべきシェルコマンドを書くことができます。複数の
|
|
.Em insert
|
|
や
|
|
.Em remove
|
|
コマンドも書くことができ、その場合列挙された順に実行されます。
|
|
.Pp
|
|
.Em logstr
|
|
コマンドで、カード挿抜時にログされる文字列を、ユーザが指定可能です。
|
|
.Em logstr
|
|
が指定されていない場合、
|
|
CIS 中の製造者とカードバージョンの文字列を使用して、出力文字列を生成します。
|
|
.Ss ワイルドカードエントリ
|
|
カード識別子として、次の 2 個のワイルドカードエントリを
|
|
汎用カードに使用可能です:
|
|
.Pp
|
|
.Dl generic serial
|
|
.Dl generic fixed_disk
|
|
.Pp
|
|
キーワード
|
|
.Em serial
|
|
は
|
|
.Dq Functional ID: Serial port/modem
|
|
にマッチし、
|
|
.Em fixed_disk
|
|
は
|
|
.Dq Fixed disk card
|
|
にマッチします。
|
|
構文は
|
|
.Em "card identifiers"
|
|
と同じですが、最初の行で
|
|
.Dq card
|
|
の代りに
|
|
.Dq generic
|
|
が使用されます。
|
|
マッチしなかったカードがこれらの汎用エントリを使用できるように、これらは、
|
|
.Nm
|
|
の最後に置かれます。
|
|
エイリアス
|
|
.Dq function
|
|
を
|
|
.Dq generic
|
|
の代りに使用可能です。
|
|
これは、歴史的な事情によるものです。
|
|
.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/defaults/pccard.conf -compact
|
|
.It Pa /etc/defaults/pccard.conf
|
|
.Xr pccardd 8
|
|
の設定ファイル。
|
|
.It Pa /etc/pccard.conf
|
|
ユーザの設定ファイル。
|
|
.El
|
|
.Sh 関連項目
|
|
.Xr pccardd 8
|