日本語 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
MTREE(8) FreeBSD システム管理者マニュアル MTREE(8)
名称
mtree -- ディレクトリ階層をマップする
書式
mtree [-bCcDdejLlMnPqrStUuWx] [-i | -m] [-E tags] [-F flavor] [-f spec]
[-I tags] [-K keywords] [-k keywords] [-N dbdir] [-O onlyfile]
[-p path] [-R keywords] [-s seed] [-X exclude-file]
解説
mtree ユーティリティは、ファイル階層と仕様 (specification) を比較するか、
ファイル階層のための仕様を作成するか、または仕様を修正します。
コマンド行オプションによって上書きされなかったなら、デフォルトのアクショ
ンは、カレントディレクトリをルートとするファイル階層と標準入力から読み込
まれた仕様を比較することです。メッセージは、その特性が仕様と一致しない
か、またはファイル階層または仕様のいずれかから失われているあらゆるファイ
ルに関して標準出力に書き込まれます。
オプションは、次の通りです:
-b ディレクトリに入る前と出た後に、空白行を抑制します。
-C 仕様を様々なツールで解析することを簡単にする形式に変換
します。入力仕様は、標準入力または -f spec によって与
えられたファイルから読み込まれます。出力では、各ファイ
ルまたはディレクトリは、(非常に長いかもしれない) 単一
の行を使用して表わされます。(``./'' から始まる) フルパ
ス名は、最初のフィールドとして常に印刷されます。印刷さ
れる他のキーワードを制御するために -K, -k と -R を使用
することができます。印刷されるファイルを制御するために
-E と -I を使用することができます。そして、出力をソー
トするために -S オプションを使用することができます。
-c 現在の作業ディレクトリ (または -p path によって提供さ
れるディレクトリ) から始まるファイル階層のための仕様を
標準出力に印刷します。出力は、相対パス名を使用するスタ
イルです。
-D -C のように、パス名を除いて、最初の代わりに最後の
フィールドとして常に印刷されます。
-d ディレクトリタイプのファイルを除いてすべてを無視しま
す。
-E tags コンマで区切られたタブを ``exclusion'' (排他) リストに
追加します。排除リストにあるタグが付けられたディレクト
リ以外は、-C と -D で印刷されません。
-e 仕様ではなくファイル階層にあるファイルに関してエラーを
だしません。
-F flavor mtree ユーティリティの互換性のフレーバ (flavor) を設定
します。flavor は、mtree, freebsd9 または netbsd6 のう
ちの 1 つを指定できます。デフォルトは、mtree です。
freebsd9 と netbsd6 フレーバ (flavor) は、それぞれ
FreeBSD 9.0 と NetBSD 6.0 との出力互換性とコマンド行の
オプション後方互換性を保存することを試みます。
-f spec 標準入力からの代わりに、file から仕様を読み込みます。
このオプションが 2 度指定されるなら、2 つの仕様は、
ファイル階層にではなく互いと比較されます。仕様は、-c
を使用して生成された出力のようにソートされます。この場
合、出力形式は、それぞれ、0、1 と 2 つのタブ文字を前に
付いた、いくらか "in first spec only", "in second spec
only" と "different" カラムがある comm(1) によく似てい
ます。"different" カラムの各エントリは、各仕様から 1
つ、2 つの行を占領します。
-I tags コンマで区切られたタブを ``inclusion'' (包含) リストに
追加します。inclusion (包含) リストにあるタグが付いた
ディレクトリ以外は、-C と -D で印刷されます。inclusion
(包含) リストが提供されないなら、デフォルトは、すべて
のファイルを表示することです。
-i 指定されるなら、schg および sappnd フラグを設定しま
す。
-j -c オプションで仕様を作成するとき、ディレクトリレベル
が下られるごとに、4 つの空白を出力して字下げ (indent)
します。これは、各ディレクトリの前に /set 文またはコメ
ントのいずれにも影響しません。しかしながら、それは、各
ディレクトリのクローズの前のコメントに影響します。これ
は、mtree の FreeBSD バージョンの -i オプションと同等
です。
-K keywords 指定された (空白類またはコンマで区切られた) キーワード
をキーワードの現在のセットに追加します。`all' が指定さ
れるなら、他のキーワードをすべて追加します。
-k keywords type キーワードとキーワードの現在のセットの代わりに指
定された (空白類またはコンマで区切られた) キーワードを
使用します。`all' が指定されるなら、すべての他のキー
ワードを使用します。type キーワードが求められないな
ら、-R type でそれを抑制します。
-L ファイル階層のすべてのシンボリックリンクをたどります。
-l より厳格なパーミッションが、それほど厳格でないものと一
致する、``loose'' パーミッションチェックを行います。例
えば、モード 0444 でマークされたファイルは、モード
0644 のためのチェックを通ります。``loose'' チェック
は、読み込み、書き込みと実行パーミッションのみに適応し
ます -- 特にスティッキビットまたは suid/sgid ビットの
ような他のビットが仕様またなファイルのいずれかに設定さ
れているなら、正確なチェックが行なわれます。このオプ
ションは、-U または -u オプションとして同時に設定する
ことはできません。
-M 優先順位をとる最後のエントリと共に異なるタイプがある仕
様エントリのマージを許可します。
-m schg および sappnd フラグが指定されるなら、これらのフ
ラグをリセットします。これは、1 未満の (すなわち、シン
グルユーザモードまたは、システムが不安定なモードで実行
している間) securelevel でのみ可能であることに注意して
ください。セキュリティレベルの情報については、init(8)
を参照してください。
-n 仕様を作成するとき、パス名のコメントを出力しませせん。
通常、コメントは、-c オプションを使用するとき、各ディ
レクトリとそのディレクトリをクローズする前に出力されま
す。
-N dbdir システムの getpwnam(3) と getgrnam(3) (と関連する) ラ
イブラリ呼び出しからの結果を使用するのではなく、dbdir
からユーザデータベースのテキストファイル master.passwd
とグループデータベースのテキストファイル group グルー
プを使用します。
-O onlypaths このパス名のリストに含まれたファイルのみを含め (インク
ルードし) ます。
-P あらゆる比較でシンボリックリンク自体を考慮するのではな
く、ファイル階層のシンボリックリンクをたどりません。こ
れは、デフォルトです。
-p path カレントディレクトリの代わりに path をルートとするファ
イル階層を使用します。
-q 静かなモード。それが既に存在するので、``見つからない''
ディレクトリを作成することができないとき、エラーを出し
ません。これは、ディレクトリがシンボリックリンクである
とき、起こります。
-R keywords キーワードの現在のセットから指定された (空白類たはコン
マで区切られた) キーワードを削除します。`all' が指定さ
れるなら、他のすべてのキーワードを削除します。
-r 仕様に記述されていないファイル階層のあらゆるファイルを
削除します。
-S 内部データ構造に仕様を読み込むとき、エントリをソートし
ます。ソートは、-C または -D オプションによって生成さ
れた出力の順序に影響し、ディレクトリツリーが仕様と
チェックされるとき、見つからないエントリが作成される
か、または報告される順序にも影響します。
ソート順序は、サブディレクトリのためのエントリが他のエ
ントリの後でソートすることを除いて、同じディレクトリ内
のエントリが strcmp(3) によって使用される順序にソート
されるということである、-c オプションによって使用され
るものと同じです。デフォルトで、-S オプションが使用さ
れないなら、同じディレクトリ内のエントリは、(他のディ
レクトリのためのエントリから分離された) ともに集められ
ますが、ソートされません。
-s seed キーワード cksum が指定されたすべてのファイルを表わす
標準エラー出力への単一のチェックサムを表示します。
チェックサムは、指定された値でシード (種) とされます。
-t 仕様と一致するために、既存のファイルの更新時刻、デバイ
スのデバイスタイプとシンボリックリンクのターゲットを修
正します。
-U 修正されたなら、不一致が、エラーであると見なされないこ
とを除いて、-u と同じです。
-u 仕様と一致するために、所有者、グループ、パーミッショ
ン、既存のファイルのフラグ、デバイスのデバイスタイプと
シンボリックリンクのターゲットを修正します。あらゆる見
つからないディレクトリ、デバイスまたはシンボリックリン
クを作成します。ユーザ、グループとパーミッションは、作
成される見つからないディレクトリに対してすべて指定され
なければなりません。-i オプションが与えられないなら、
たとえ指定されたとしても、schg と sappnd のフラグが設
定されないことに注意してください。-m が与えられるな
ら、これらのフラグは、リセットされます。成功すれば、0
のステータスで終了し、ファイル階層が仕様と一致しなかっ
たなら、2 のステータスで終了し、他のエラーが生じたな
ら、1 のステータスで終了します。
-W 新しいディレクトリを作成するか、または既存のエントリを
変更するとき、所有権、モード、フラグまたは時間のような
様々なファイル属性を設定することを試みません。このオプ
ションは、-U または -u とともに使用されるとき、もっと
も役に立ちます。
-X exclude-file 指定されたファイルは、1 行に 1 つの仕様から除外される
fnmatch(3) パターンに一致するファイルを含んでいます。
パターンが `/' 文字を含んでいるなら、(開始ディレクトリ
と関連する) 全てのパス名と一致します。そうでなければ、
それは、ファイル名の部分 (basename) だけと一致します。
コメントは、exclude-list ファイルで許可されます。
-x ファイル階層のマウントポイント以下に降下しません。
仕様のほとんどは、``keywords'' からできています、すなわち、ファイルに関係
のある値を指定する文字列。キーワードは、デフォルト値がなく、キーワードに
値が設定されていないなら、それに基づいたチェックは、実行されません。
現在サポートされているキーワードは、次の通りです:
cksum cksum(1) ユーティリティによって指定されたデフォルトのアル
ゴリズムを使用するファイルのチェックサム。
device block または char ファイルタイプのために使用するデバイス
番号。引数は、次の形式のうちの 1 つでなければなりません:
format,major,minor
format で指定されたオペレーティングシステムのための
major と minor フィールドがあるデバイス。有効形式に
については、下記を参照してください。
format,major,unit,subunit
format で指定されたオペレーティングシステムのための
major, unit と subunit フィールドがあるデバイス。
(現在、これは、bsdos 形式によってのみサポートされて
います。)
number
(ファイルシステムで格納されるように) 不透明
(opaque) な数。
format に対して次の値が認識されます: native, 386bsd,
4bsd, bsdos, freebsd, hpux, isc, linux, netbsd, osf1,
sco, solaris, sunos, svr3, svr4, と ultrix。
より詳しい情報については、mknod(8) を参照してください。
flags シンボリック名としてのファイルフラグ。これらの名前に関す
る情報については、chflags(1) を参照してください。フラグが
設定されていないなら、文字列 `none' は、現在のデフォルト
を上書きするために使用されます。schg と sappnd フラグは、
特別に扱われることに注意してください (-i と -m オプション
を参照)。
ignore このファイルより下のあらゆるファイル階層を無視します。
gid 数値としてのファイルグループ。
gname シンボリック名としてのファイルグループ。
link シンボリックリンクが参照すると予想されるファイル。
md5 ファイルの MD5 暗号メッセージのダイジェスト。
md5digest md5 と同意語。
mode 数値 (8 進数) またはシンボリック値としての現在のファイル
のパーミッション。
nlink ファイルにあると予想されるハードリンクの数。
nochange このファイルまたはディレクトリが存在することをよく確かめ
ますが、そうでなければすべての属性を無視します。
optional ファイルは、オプションです。ファイルがファイル階層にない
なら、それについてエラーを出しません。
ripemd160digest
rmd160 と同意語。
rmd160 ファイルの RMD-160 暗号のメッセージダイジェスト。
rmd160digest rmd160 と同意語。
sha1 ファイルの SHA-1 暗号のメッセージダイジェスト。
sha1digest sha1 と同意語。
sha256 ファイルの 256 ビットの SHA-2 暗号のメッセージダイジェス
ト。
sha256digest sha256 と同意語。
sha384 ファイルの 384 ビットの SHA-2 暗号のメッセージダイジェス
ト。
sha384digest sha384 と同意語。
sha512 ファイルの 512 ビットの SHA-2 暗号のメッセージダイジェス
ト。
sha512digest sha512 と同意語。
size ファイルのバイト単位のサイズ。
tags コンマは、-E と -I に一致させられるタグで区切られます。こ
れらは、先導するコンマ、または後続するコンマなしで指定さ
れますが、それらで内部に格納されます。
time 秒とナノ秒単位のファイルの最後の更新時刻。値は、ピリオド
文字とピリオドの後に正確に 9 つの数字を含んでいるべきで
す。
type ファイルのタイプ。次のうちのいずれか 1 つに設定されます:
block ブロックスペシャルデバイス
char キャラクタスペシャルデバイス
dir ディレクトリ
fifo FIFO
file 通常ファイル
link シンボリックリンク
socket ソケット
uid 数値としてファイルの所有者。
uname シンボリック名としてファイルの所有者。
キーワードのデフォルトのセットは、flags, gid, link, mode, nlink, size,
time, type と uid です。
仕様に 4 つのタイプの行があります:
1. キーワードに対してグローバルな値を設定します。これは、空白類によって
分離され、文字列 `/set' に続いて空白類、キーワード/値のペアのセット
が続くものから成ります。キーワード/値のペアは、空白類の文字なしで、
キーワード、等号 (`=') が続き、値が続くものから成ります。いったん
キーワードが設定されたなら、その値は、リセットするかまたは、未設定と
なるまで、変更されません。
2. キーワードに対すしてグローバルな値を未設定とします。これは、空白類に
よって分離され、文字列 `/unset' に続いて空白類、1 つ以上のキーワード
が後続するものから成ります。`all' が指定されるなら、すべてのキーワー
ドを未設定とします。
3. ファイル仕様、パス名、空白類が続き、0 以上の空白類で分離されたキー
ワード/値のペアが続くものから成ります。
パス名は、空白類の文字に先行します。パス名は、階層中のファイルが、そ
れらが一致する最初のパターンに関係している場合に、文字 (`[', `]',
`?' または `*') に一致する標準パス名のうちのいずれかを含むことができ
ます。mtree は、非印刷可能文字を含んでいるパス名をエンコード (符号
化) するために (VIS_CSTYLE 形式の) strsvis(3) を使用します。空白類文
字は、`\s' (空白), `\t' (タブ), and `\n' (改行) としてエンコードされ
ます。パス名中の `#' 文字は、それらとコメントを区別するためにバック
スラッシ `\' を前に付けることによってエスケープされます。
キーワード/値のペアの各々は、空白類文字なしで、キーワード、等号
(`=') が続き、キーワードの値が続くものから成ります。これらの値は、変
更せずに、対応するキーワードのグローバルな値を上書きします。
リストされた最初のパス名のエントリは、完全なパス名と相対パス名を混ぜ
合わせることは、一貫して正確に動作するということを、これが保証するよ
うに、指定された `.' ディレクトリでなければなりません。指定された
`.' ディレクトリのための複数のエントリは、許可されます。最後のそのよ
うなエントリのための設定は、既存のエントリのものを上書きします。
最初の文字でないスラッシュ (`/') を含んでいるパス名は、(ツリーのルー
トに関連する) フルパスとして扱われます。パス名で参照されているすべて
の親ディレクトリは、存在していなければなりません。相対パス名によって
使用されるカレントディレクトリのパスは、適切に更新されます。タイプが
同じ (-M が与えられなければ、その場合に、タイプは異なるかもしれませ
ん) であるなら、同じフルパスのための複数のエントリは、許可されます。
この場合、最後のエントリのための設定が優先します。
スラッシュを含んでいないパス名は、相対パスとして扱われます。ディレク
トリを指定することによって、続くファイルは、そのディレクトリ階層で検
索されます。
4. 文字列 `..' だけを含んでいる行によって、(相対パスによって使用される)
カレントディレクトリのパスは、1 レベル上昇します。
空行と最初の空白類でない文字がハッシュマーク (`#') である行は、無視されま
す。
mtree ユーティリティは、成功すれば、0 のステータスで終了し、なんらかのエ
ラーが生じたなら、1 のステータスで終了し、そしてファイル階層が仕様と一致
しなかったなら、2 のステータスで終了します。
関連ファイル
/etc/mtree システム仕様ディレクトリ
使用例
``トロイの木馬'' (trojan horsed) だったシステムバイナリを検出するために
は、ファイルシステムで mtree が実行されること、そして異なったマシンでまた
は少なくとも暗号化された形式で格納された結果のコピーをお勧めします。-s オ
プションのためのシード (種) は、明白な値であるべきではありません、そして
最終のチェックサムは、いかなる状況であってもオンラインで格納されるべきで
はありません! その後、定期的に、mtree は、前の値と比較して、オンライン仕
様と最終のチェックサムに対して実行されるべきです。それらの修正されたバイ
ナリに適合するオンライン仕様を変更することが悪いやつらのために可能です
が、同じ最終のチェックサム値を生成することは彼らのために可能であるべきで
はありません。最終のチェックサム値が変化するなら、どのバイナリの実際に修
正されたか検出するために、仕様のオフラインのコピーを使用することができま
す。
-d オプションは、例えば、配布のためのディレクトリ階層を作成するために -U
または -u と組み合わせて使用することができます。
互換性
-F オプションによって提供される互換性の shim は、設計によって不完全です。
既知の制限が、下記に説明されます。
freebsd9 形式 (flavor) は、失敗してエラー報告するのではなく適切な uid と
gid キーワードでそれらを置き換えることによって、uname と group キーワード
のための検索の失敗のデフォルト取り扱いを保持します。関連する -w フラグ
は、印刷される警告を起こし、出力されるキーワードがないということよりむし
ろ無操作 (no-op) です。後の振る舞いは、/set 文の外観で潜在的に危険である
ので、エミュレートされません。
netbsd6 形式 (flavor) は、0 パディングされたナノ秒値のない sec
onds.nanoseconds として報告された時間が 100000000 未満であるという歴史的
のバグを複製しません。
関連項目
chflags(1), chgrp(1), chmod(1), cksum(1), stat(2), fnmatch(3), fts(3),
strsvis(3), chown(8), mknod(8)
歴史
mtree ユーティリティは、4.3BSD-Reno で登場しました。optional キーワード
は、NetBSD 1.2 で登場しました。-U オプションは、NetBSD 1.3 で登場しまし
た。flags と md5 キーワードと -i と -m オプションは、NetBSD 1.4 で登場し
ました。device, rmd160, sha1, tags と all キーワード、-D, -E, -I, -L, -l,
-N, -P, -R, -W と -X オプションとフルパスのサポートは、NetBSD 1.6 で登場
しました。sha256, sha384 と sha512 キーワードは、NetBSD 3.0 で登場しまし
た。-S オプションは、NetBSD 6.0 で登場しました。ではじめて登場しました。
FreeBSD 11.4 February 3, 2013 FreeBSD 11.4