日本語 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.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
DEVFS(8) FreeBSD システム管理者マニュアル DEVFS(8)
名称
devfs -- DEVFS 制御
書式
devfs [-m mount-point] keyword argument ...
解説
devfs ユーティリティは、マウントされた devfs(5) のプロパティを操作するた
めのインタフェースを提供しています。
keyword 引数は、引数の残りのコンテキストを決定します。例えば、ルールサブ
システムに関連するコマンドのほとんどは、rule キーワードを前に付けなければ
なりません。次のフラグは、すべてのキーワードに共通です:
-m mount-point devfs(5) マウントであると予想される mount-point で動作し
ます。このオプションが指定されないなら、devfs は、/dev
で動作します。
ルールサブシステム
devfs(5) のルールサブシステムは、システム管理者が DEVFS の各ノードの属性
を変更できるようにするためのものです。DEVFS マウントポイントには、それぞ
れに ``ruleset'' (ルールセット) というルールのリストが関連づけられていま
す。デバイスドライバが新しいノードを作成する時には、そのノードがユーザラ
ンドから見えるようになる前にそれぞれのマウントポイントに関連づけられてい
るルールセットのすべてのルールが適用されます (下記参照)。これによって、管
理者がノードの可視性を含めた属性を変更することができるようになっていま
す。例えば、jail(2) の /dev にあるすべてのディスクノードを隠すというよう
なこともできます。
ルールの操作
ルール操作コマンドは、rule キーワードに続けて使用します。次のフラグは、す
べてのルール操作コマンドに共通のものです :
-s ruleset ruleset で指定したルールセットを操作します。このフラグが
指定されていない時は、指定したマウントポイントに現在関連
づけられているルールセットを操作します。
次のコマンドが認識されます:
rule add [rulenum] rulespec
rulespec (下記参照) で、記述されたルールをルールセットに
追加します。ルール番号は、rulenum が明示的に指定されてい
る場合には、その番号に、指定されていない場合には、自動的
にカーネルによって決められます。
rule apply rulenum | rulespec
ルール番号 rulenum または rulespec で、記述されたルール
をマウントポイントに適用します。``適用される'' ルールに
は、条件があって、マウントポイントのすべてのノードに対し
てチェックを行い、条件が一致すれば指定のアクションを起こ
します。
rule applyset ルールセットのすべてのルールをマウントポイントに適用しま
す (上記 ``apply'' の説明を参照)。
rule del rulenum
ルールセットからルール番号 rulenum のルールを削除しま
す。
rule delset 指定したルールセットのすべてのルールを削除します。
rule show [rulenum]
rulenum で指定したルール番号のルール、またはルールセット
のすべてのルールを表示します。出力行は、(ルール毎に 1 行
ずつ) 正しい rulespec になっています。
rule showsets 設定されているルールセットの番号を表示します。
ruleset ruleset ruleset で指定した番号のルールセットをマウントポイントの
カレントのルールセットにします。
ルール仕様
ルールには、2 つのパートがあります: 条件部とアクション部です。条件部で
ルールを適用する DEVFS ノードを指定し、アクション部でルールが当てはまる
ノードに何をするかを指定します。例えば、テープ型 (type tape) のすべてのデ
バイスのために GID を ``operator'' に設定するルールを書くこともできます。
ルール指定の最初のトークンがダッシュ文字 1 つ (`-') の場合、ルールは、標
準入力から読み込まれて残りの指定は、無視されます。
次のような条件が使用できます。デバイスをチェックする時には、条件は、AND
されます。OR 条件を使いたい時には、複数のルールを書いてください。
path pattern glob(3) スタイルのパータンとして解釈される pattern に適
合するパスに対してどんなノードも適合します。
type devtype タイプが devtype のすべてのノードに適合します。使用でき
るタイプは、disk, mem, tape と tty です。
次のようなアクションが使用できます。条件部とアクション部の間には、特にデ
リミタはありませんが、混乱することはないでしょう。
group gid ノードのグループ ID を gid に設定します。グループ名
(/etc/group で照会されます) または、数値で指定します。
hide ノードを隠します。隠されたノードは、マニュアルで
mknod(8) を使用するか、unhide アクションを使用するとまた
見えるようになります。ディレクトリノードを隠すことは、そ
の子どものすべてのノードを効果的に隠します。
include ruleset ルールセット番号が ruleset のルールセットのすべてのルー
ルをノードに適用します。これによってノードが変更されると
は限りません (例えば、ルールセットに一致するルールがない
場合など)。参照される ruleset に含まれるコマンドは、決定
されていません。
mode filemode ファイルモードを chmod(1) で解釈される filemode に設定し
ます。
user uid ユーザ ID を uid に設定します。ユーザ名 (/etc/passwd で
照会されます) または数値で指定します。
unhide ノードを見えるようにします。ノードがサブディレクトリに存
在するなら、すべての親ディレクトリのノードは、ノードにア
クセスすることができるように目に見えなければなりません。
実装に関する注
ルールセットは、最初に参照される時にカーネルによって作成され、最後の参照
がなくなる時に削除されます。すなわち、ルールセットは、ルールが追加される
時かどこかのマウントポイントのカレントのルールセットに設定された時に作成
され、ルールセット中の最後のルールが削除されるとき、および、もう他からの
参照もない (つまり、他のルールにインクルードされてもなく、どのマウントポ
イントのカレントのルールセットにもなっていない) ときに削除されます。
ルールセット 0 番は、すべての新しいマウントポイントのデフォルトルールセッ
トです。このルールセットは、常に空で、変更や削除はできず、showsets コマン
ドの出力にも表示されません。
ルールやルールセットは、特定のマウントポイント毎ではなく、システム全体で
一意です。つまり、showsets は、-m で指定したマウントポイントにかかわら
ず、常に同じ情報を表示します。マウントポイントが有効なのは、カレントの
ルールセットを変更する時や apply コマンドを使用する時だけです。
関連ファイル
/etc/defaults/devfs.rules デフォルトの devfs 設定ファイル。
/etc/devfs.rules ローカルの devfs 設定ファイル。こ
このルールセットは、同じルールセッ
ト番号で、
/etc/defaults/devfs.rules のそれら
を上書きします、そうでなければ、事
実上、2 つのファイルは、マージされ
ます。
/etc/devfs.conf ブート時の devfs 設定ファイル。
/usr/share/examples/etc/devfs.conf ブート時の devfs 設定ファイルの
例。
実行例
システム起動時には、ルールセット 0 番のみが存在しますが、このルールセット
は、後から変更することができないので、ルールを追加する前に別のルールセッ
トを作成しなければなりません。以下の例ではほとんど -m オプションを指定し
ていませんので、操作は、/dev に対して実行されることに注意してください (こ
れは、ノードのプロパティを変更するものだけが問題だからです)。
ルールセット 10 が /dev のためのカレントのルールセットであるべきであるこ
とを指定します (まだ存在していないなら、作成されます):
devfs ruleset 10
(すべてのユーザが読み込み書き込みする) ファイルモード 666 にするために
``speaker'' に一致する (これは、/dev/speaker のみです) パスがあるすべての
ノードにルールを追加します。そのようなノードが既に存在するなら、そして、
このルール (またはルールセット) が明白に適用されないなら、それらのモード
は、変更されないことに注意してください (下記を参照)。モードは、ルールが追
加された後にノードが作成されるなら、変更されるかもしれません (例えば、上
記のルールが追加された後に atspeaker モジュールがロードされます):
devfs rule add path speaker mode 666
カレントのルールセットのすべてのルールを、すべての存在するノードに適用し
ます。例えば、/dev/speaker が作成した後に、下記のルールが追加されたなら、
このコマンドによって、ファイルモードは、次のルールによって示されるよう
に、666 に変更されます:
devfs rule applyset
``snp*'' に一致するパスがあるすべてのデバイスについて、ファイルモードを
660 に、GID を ``snoopers'' に設定します。これは、snp(4) デバイスを使用す
るために ``snoopers'' グループのユーザを許可します (path への引数をクォー
トすることは、シェルのグロブ (globbing) 機能を無効にするためにしばしば必
要です):
devfs rule add path snp* mode 660 group snoopers
ルールセット番号 20 にルールを追加します。このルールセットは、あらゆるマ
ウントポイントのためのカレントのルールセットでないので、(ルールセット 20
が、後になって、いくつかのマウントポイントのためにカレントのルールセット
になるまで) このルールは、決して自動的に適用されません:
devfs rule -s 20 add type disk group wheel
ルールセット番号 20 のすべてのルールを /my/jail/dev の DEVFS マウントに明
白に適用します: ルールセット 20 が、そのマウントポイントのためのカレント
のルールセットでないことは問題となりません。ルールは、それでも適用されま
す:
devfs -m /my/jail/dev rule -s 20 applyset
次のルールには、条件部がないので、アクション (hide) は、すべてのノードに
適用されます:
devfs rule apply hide
すべてのノードを隠すことは、あまり有用ではないので、それを取り消すことが
できます。次は、すべてのノードを再び現れるようにして、unhide をすべての
ノードに適用します:
devfs rule apply unhide
ファイル my_rules のすべてのルールをルールセット 10 に追加します:
devfs rule -s 10 add - < my_rules
下記は、ルールセット 20 のすべてのルールをルールセット 10 にコピーしま
す。ルール番号は、保存されますが、ルールセット 10 には、衝突しない番号の
ルールが既にあるかもしれません (これらは、保存されます)。show は、有効な
ルールを出力するので、ルールセットをコピーするためにこの機能を使用するこ
とができます:
devfs rule -s 20 show | devfs rule -s 10 add -
関連項目
chmod(1), jail(2), glob(3), devfs(5), devfs.conf(5), devfs.rules(5),
chown(8), jail(8), mknod(8)
歴史
devfs ユーティリティは、FreeBSD 5.0 ではじめて登場しました。
作者
Dima Dorfman
FreeBSD 11.4 October 5, 2016 FreeBSD 11.4