日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
DEVD.CONF(5) FreeBSD ファイルフォーマットマニュアル DEVD.CONF(5)
名称
devd.conf -- devd(8) のための設定ファイル
解説
一般的な構文
devd(8) 設定は、2 つの一般的な機能、ステートメントとコメントから成りま
す。すべてのステートメントは、セミコロンで終わります。多くのステートメン
トは、同様にセミコロンで終了するサブステートメントを含むことができます。
次のステートメントがサポートされています:
attach 新しくアタッチされたデバイスが前述の基準にマッチするとき、実行す
る各種のマッチする基準とアクションを指定します。
detach 新しくデタッチされたデバイスが前述の基準にマッチするとき、実行す
る各種のマッチする基準とアクションを指定します。
nomatch 現在カーネルにロードされるデバイスドライバが (新しい) デバイスを
要求しないとき、実行する各種のマッチする基準とアクションを指定し
ます。
notify カーネルがユーザーランドにイベント通知を送信するとき、実行する各
種のマッチする基準とアクションを指定します。
options devd(8) の操作のための各種のオプションとパラメータを指定します。
ステートメントは、設定ファイル中にどんな順序でも現れることができ、要求さ
れるたびごとに繰り返すことができます。各ステートメントとそれらのサブス
テートメントの構文と意味のさらなる詳細は、以下に説明されます。
options を除いて、各ステートメントには、それに関連している優先度 (任意の
数値) があり、ここで、`0' は、最も低い優先度に定義されます。2 つのステー
トメントが同じイベントに適合するなら、最も高い優先度のステートメントのア
クションのみ実行されます。このような方法で、特別な注意を必要とするデバイ
スまたは通知のために一般的なステートメントを上書きすることができます。
ステートメントの一般的な構文は、次の通りです:
statement priority {
substatement "value";
...
substatement "value";
};
サブステートメント
次のサブステートメントは、options ステートメントの中でサポートされます。
directory "/some/path";
devd(8) が、更なる設定ファイルとして、"*.conf" と名前が付けら
れたすべてのファイルを読み込むディレクトリのリストに与えられた
ディレクトリを追加します。いくつもの directory ステートメント
を使用することができます。
pid-file "/var/run/devd.pid";
PID ファイルを指定します。
set regexp-name "(some|regexp)";
正規表現を作成して、それを変数 regexp-name に割り当てます。変
数は、設定ファイルの残りの至るところで利用可能です。文字列が
`!' で始まり、文字列の残りによって書式化された正規表現がマッチ
しないなら、マッチします。すべての正規表現には、それらの周りに
暗黙の `^$' があります。
次のサブステートメントは、attach と detach ステートメントの中でサポートさ
れています。
action "command";
適合が成功したときに実行するコマンド。例 ``/etc/pccard_ether
$device-name start''
class "string";
これは、``match "class" "string"'' の省略表現です。
device-name "string";
これは、``match "device-name" "string"'' の省略表現です。これ
は、string というデバイスに適合します。それには、以前に作成さ
れ正規表現を含む正規表現または変数が許されます。``device
name'' 変数は、後の action ステートメントで使用可能です。
match "variable" "value";
value の内容が正規表現である variable に対して value の内容を
適合させます。device-name ステートメントがすべてのデバイスの適
合を処理するので、attach でも detach イベントの間でも必要とし
ません。変数の部分的なリストについては、下記を参照してくださ
い。
media-type "string";
ネットワークデバイスについて、media-type は、与えられたメディ
アタイプがあるデバイスに適合します。有効なメディアタイプは、次
の通りです: ``Ethernet'', ``Tokenring'', ``FDDI'', ``802.11''
と ``ATM'' です。
subdevice "string";
これは、``match "subdevice" "string"'' の省略表現です。
次のサブステートメントは、nomatch ステートメントの中でサポートされます。
action "command";
上記と同様。
match "variable" "value";
value の内容が正規表現である variable に対して value の内容を
適合させます。変数の部分的なリストについては、下記を参照してく
ださい。
次のサブステートメントは、notify ステートメントの中でサポートされていま
す。``notify'' 変数は、このステートメント内で利用可能であり、イベントを配
信したシステムとサブシステムに依存する値を含んでします。
action "command";
適合が成功したときに実行するコマンド。例
``/etc/rc.d/power_profile $notify''
match "system | subsystem | type | notify" "value";
いくつもの match ステートメントは、notify ステートメント内に存
在できます。value は、固定文字列または正規表現のいずれかを指定
できます。以下は、利用可能なシステム、サブシステム、とタイプの
リストです。
media-type "string";
上記参照。
match ステートメントで使用することができる変数
変数の部分的なリストと match ステートメントで使用することができるそれらの
利用可能な値。変数は、(デバイスイベントのために) イベントを生成したデバイ
スの特徴に基づいてバスによって公開されます。イベントの他のクラスのための
変数は、それらのイベントに依存します。
変数 説明
* 現在のイベントからの全体のメッセージ。
_ 初期のタイプ文字の後の現在のイベントからの全体のメッセー
ジ。
timestamp ドット分数の 1970 年以来の秒単位の、このイベントが処理され
た時間。
bus 親バスのデバイス名。
cdev それが、devfs(5) ファイルシステムによって作成されているな
ら、デバイスノードのパス。
class デバイスクラス。
comm 実行形式名 (カーネル)
core コアファイルへのパズ (カーネル)
device デバイス ID。
devclass デバイスクラス (USB)。
devsubclass デバイスサブクラス (USB)。
device-name アタッチ/デタッチするデバイスの名前。
endpoints エンドポイントカウント (USB)。
function カード機能。
interface インタフェース ID (USB)。
intclass インタフェースクラス (USB)。
intprotocol インタフェースプロトコル (USB)。
intsubclass インタフェースサブクラス (USB)。
jail 規則をトリガしているプロセスのための jail 名 (RCTL)
mode ペリフェラルモード (USB)。
notify ``notify'' 変数の値に適合します。
parent 親デバイス。
pid 規則をトリガしているプロセスの PID (RCTL)
port ハブポート番号 (USB)。
product プロダクト ID (USB)。
release ハードウェアリビジョン (USB)。
ruid 規則をトリガしているプロセスの実 UID (RCTL)
rule 規則 (RCTL)
sernum シリアル番号 (USB)。
slot カードスロット。
subvendor サブベンダ ID (PCI)。
subdevice サブデバイス ID。
subsystem システムのサブシステムに適合します、下記参照。
system システムタイプに適合します、下記参照。
type 通知のタイプ、下記参照。
vendor ベンダ ID。
通知の適合
notify メカニズムの中で使用されるシステム、サブシステムとタイプの部分的な
リストです。
システム サブシステム タイプ 説明
ACPI ACPI サブシステムに関連するイベント。
ACPI ACAD AC (交流) 線の状態 ($notify=0x00 は、オ
フライン, 0x01 は、オンライン)。
ACPI Button ボタンの状態 ($notify=0x00 は、電源,
0x01 は、スリープ)。
ACPI CMBAT バッテリのイベント。
ACPI Dock ドック (dock) 状態 ($notify=0x00 は、
ドックに入れられない、0x01 は、ドックに
入れられた)。
ACPI Lid 蓋の状態 ($notify=0x00 は、クローズされ
ている, 0x01 は、オープン)。
ACPI PROCESSOR プロセッサの状態/設定 ($notify=0x81
は、利用可能な Cx 状態に変更されます)。
ACPI Resume 通知を再開します。
ACPI Suspend 通知をサスペドします。
ACPI Thermal 温度ゾーンのイベント。
システム サブシステム タイプ 説明
AEON power press Amiga の電源ボタンが押されました。
システム サブシステム タイプ 説明
CAM cam(4) システムに関連するイベント。
CAM periph 周辺機器デバイスに関連するイベント。
CAM periph error 一般的なエラー。
CAM periph timeout コマンドのタイムアウト。
システム サブシステム タイプ 説明
CARP carp(4) プロトコルに関連するイベント。
CARP vhid@inet ``subsystem'' は、実際の CARP vhid とイ
ベントが起こったネットワークインタ
フェースの名前を含んでいます。
CARP vhid@inet MASTER ノードは、仮想ホストのためのマスタとな
る。
CARP vhid@inet BACKUP ノードは、仮想ホストのためのバックアッ
プとなる。
システム サブシステム タイプ 説明
coretemp coretemp(4) デバイスに関連するイベン
ト。
coretemp Thermal CPU コアが臨界温度に到達したことの通
知。
coretemp Thermal temperature 高温になりすぎたコアの温度を含む文字
列。
システム サブシステム タイプ 説明
IFNET
IFNET inet ``subsystem'' は、イベントが発生した
ネットワークインタフェースの実際の名前
です。
IFNET inet LINK_UP キャリア状態は、UP に変更されました。
IFNET inet LINK_DOWN キャリア状態は、DOWN に変更されました。
IFNET inet ATTACH ネットワークインタフェースは、システム
にアタッチされます。
IFNET inet DETACH ネットワークインタフェースは、システム
からデタッチされます。
システム サブシステム タイプ 説明
DEVFS
DEVFS CDEV CREATE devfs(5) ノードが作成されます。
DEVFS CDEV DESTROY devfs(5) ノードが破壊されます。
システム サブシステム タイプ 説明
ETHERNET inet IFATTACH inet インタフェースのデフォルトの
VNET インスタンスがアタッチされたと
き、通知します。
システム サブシステム タイプ 説明
GEOM geom(4) フレームワークに関連したイベ
ント。DEVFS と比べての違いは、GEOM
がディスクのようなデバイスのみを含む
ことです。
GEOM DEV CREATE geom(4) デバイスノードが、作成されま
す。
GEOM DEV DESTROY geom(4) デバイスノードが、破壊されま
す。
GEOM DEV GEOM::physpath デバイスの物質的なパスは、変更され
ました。
GEOM DEV GEOM::rotation_rate ディスクのローテートの比率が変
更されました。
GEOM DEV MEDIACHANGE 物理的なメディアは、変更されました。
GEOM DEV SIZECHANGE geom(4) プロバイダのサイズが変更され
ます。
システム サブシステム タイプ 説明
kern power resume システムがサスペンド状態から起きたこと
を通知します。注意: この通知は、非推奨
で、FreeBSD 14.0 で削除されるでしょう。
システム サブシステム タイプ 説明
kernel signal coredump プロセスがクラッシュしてコアをダンプし
たことを通知。
kernel power resume システムがサスペンド状態から起きたこと
を通知。
システム サブシステム タイプ 説明
PMU 各種タイプの電源管理ユニットからのイ
ベントを通知。
PMU AC AC 電力関連のイベントの通知。
PMU AC overvoltage AC 電源線で過電圧状態が検出されまし
た。
PMU AC plugged 電源が AC 電源線に投入されました。
PMU AC unplugged 電源が AC 電源線から抜かれました。
PMU Battery
PMU Battery absent バッテリがもはやなくなりました。
PMU Battery charged バッテリが充電されました。
PMU Battery charging バッテリが充電を開始しました。
PMU Battery disconnected バッテリが切断されました。
PMU Battery high-temp バッテリが、温度が制限を超えたことを
報告しました。
PMU Battery low-temp バッテリが制限以下の温度であることを
報告しました。
PMU Battery plugged バッテリが差し込まれました (例えば、
接続されている)。
PMU Battery shutdown-threshold バッテリの電力が、シャットダウ
ンのしきい値を下回りました。
PMU Battery warning-threshold バッテリの電力が、ユーザへの警告
のしきい値を下回りました。
PMU Button pressed adb(4) または pmu(4) のボタンが押され
ました。
PMU keys adb(4) のキーボードの 1 つのキーが押
されました。
PMU keys brightness 輝度レベルの変更が要求されました。方
向は、$notify 変数にあります。
PMU keys mute ミュート (mute) キー。
PMU keys volume 音量レベルの変更が要求されました。方
向は、$notify 変数にあります。
PMU keys eject イジェクトが要求されました。
PMU lid close pmc(4) デバイスのふたが閉じたことを検
出しました。
PMU lid open pmc(4) デバイスのふたが開くことを検出
しました。
PMU POWER ACLINE pmc(4) デバイスは、AC 線の状態を検出
しました ($notify=0x00 は、オフライ
ン、0x01 は、オンライン)。
PMU USB overvoltage USB 電源ピンの電源線で過電圧状態。
PMU USB plugged デバイスが USB デバイスにプラグ接続さ
れました。
PMU USB undervoltage USB 電源ピンのための電源線で過小電圧
状態。
PMU USB unplugged デバイスが USB デバイスへのプラブを外
されました。
システム サブシステム タイプ 説明
RCTL rctl(8) フレームワークに関連しているイ
ベント。
RCTL rule matched "devctl" として指定されたアクションがあ
る規則が、トリガされました。
システム サブシステム タイプ 説明
USB USB サブシステムに関連するイベント。
USB DEVICE ATTACH USB デバイスは、システムにアタッチされ
ます。
USB DEVICE DETACH USB デバイスは、システムからデタッチさ
れます。
USB INTERFACE ATTACH USB インタフェースは、デバイスにアタッ
チされます。
USB INTERFACE DETACH USB インタフェースは、デバイスからデ
タッチされます。
リンク状態がインタフェース ``fxp0'' で UP に変化すると次の通知 (notify)
イベントが起こります:
system=IFNET subsystem=fxp0 type=LINK_UP
AC (交流) 線の状態が ``offline'' に変化したなら、次のイベントが起こりま
す:
system=ACPI subsystem=ACAD notify=0x00
コメント
コメントは、空白類が設定ファイルに現われるところならどんな場所でも現われ
ることができます。すべての種類のプログラマが気に入るように、C、C++ または
sehll/Perl 作成物にそれらを書くことができます。
C スタイルのコメントは、2 文字の `/*' (スラッシュ、星) で始まり、`*/'
(星、スラッシュ) で終わります。それらは、これらの文字で完全に区切ることが
できるので、行の一部だけ、または複数の行にまたがってコメントに使用するこ
とができます。
C スタイルのコメントは、入れ子にすることができません。例えば、次は、すべ
てのコメントが最初の `*/' で終わるので、正しくありません:
/* これは, コメントの開始です.
これは, まだコメントの一部です.
/* これは, コメントを入れ子にする正しくない試みです. */
これは, もはやどんなコメント内でありません. */
C++ スタイルのコメントは、2 文字の `//' (スラッシュ、スラッシュ) で始ま
り、物理的な行の終りまで続きます。それらは、複数の物理的な行をまたがって
続けることはできません。複数行にわたる 1 つの論理的なコメントにするために
は、`//' の組を使用しなければなりません。例えば:
// これは, コメントの開始です. 次の行は,
// たとえそれが論理的に前のコメントの
// 一部であっても, 新しいコメントです.
関連ファイル
/etc/devd.conf devd(8) 設定ファイル。
使用例
#
# これは、インタフェース fxp0 と ath0 でリンクダウンイベントをキャッチ
# します
#
notify 0 {
match "system" "IFNET";
match "subsystem" "(fxp0|ath0)";
match "type" "LINK_DOWN";
action "logger $subsystem is DOWN";
};
#
# 蓋のオープン/クロースイベントに適合します
# 外部のスクリプトに $notify の値を渡すことによって、
# これらを単一のイベントに結合することができます
#
notify 0 {
match "system" "ACPI";
match "subsystem" "Lid";
match "notify" "0x00";
action "logger Lid closed, we can sleep now!";
};
notify 0 {
match "system" "ACPI";
match "subsystem" "Lid";
match "notify" "0x01";
action "logger Lid opened, the sleeper must awaken!";
};
#
# USB デバイスタイプにマッチする
#
notify 0 {
match "system" "USB";
match "subsystem" "INTERFACE";
match "type" "ATTACH";
match "intclass" "0x0e";
action "logger USB video device attached";
};
#
# ath と iwn デバイスがアタッチされているので、
# pccard_ether で ath と wi デバイスの設定を試みます
#
attach 0 {
device-name "(ath|iwn)[0-9]+";
action "/etc/pccard_ether $device-name start";
};
#
# ath と iwn デバイスがシステムからデタッチされているので、
# それらを停止します
#
detach 0 {
device-name "(ath|iwn)[0-9]+";
action "/etc/pccard_ether $device-name stop";
};
インストールされた /etc/devd.conf には、多くの追加例があります。
関連項目
cam(4), coretemp(4), devfs(5), re_format(7), devd(8)
FreeBSD 12.2 August 18, 2020 FreeBSD 12.2