オプション

すべてのオプションは常に真を返す。 -daystart, -follow, -regextype を除いて、そのほかのオプションは、そのオプションより前に指定された判別式も含め、すべての判別式に影響を及ぼす。これは、オプションの処理は、コマンドラインが解析されるときに行われるのに対して、判別式の方は、ファイルが調べられるまで何もしないからである。 -daystart, -follow, -regextype の各オプションはこの点で異なっている。この三つのオプションは、コマンドラインで自分より後に指定された判別式にしか影響を及ぼさないのだ。従って、混乱を避けるためには、 -daystart, -follow, -regextype 以外のオプションは、式の先頭部に置いた方がよい。そうしないと、警告が発せられる。

-d

-depth と同じ。FreeBSD, NetBSD, MacOS X, OpenBSD との互換性のためにある。

 

-daystart

-amin, -atime, -cmin, -ctime, -mmin, -mtime において、今日 (すなわち 0 日前) の始まりを今現在から 24 時間前ではなく、コマンド実行当日の 0 時にする。このオプションが影響を及ぼすのは、コマンドラインで自分より後に指定された判別式だけである。

-depth

ディレクトリそのものより先に、ディレクトリの中身を処理する。アクション -delete を使用すると、 -depth オプションも自動的に設定される。

 

-follow

非推奨である。 -L オプションを代わりに使う方がよい。シンボリックリンクをたどる。 -noleaf が自動的に設定される。 -follow オプションが影響を及ぼすのは、コマンドラインで自分より後に指定された判別式だけである。 -H や -L オプションが指定されていない場合、 -follow オプションの位置によって述語 -newer の動作が変わってくる。 -newer が -follow の後に来れば、 -newer の引き数として指定されたいかなるファイルも、それがシンボリックリンクなら、リンクをたどられることになるわけだ。同じことが -newerXY, -anewer, -cnewer についても言える。同様に、述語 -type も、シンボリックリンクそのものではなく、必ずシンボリックリンクが参照しているファイルのタイプに対してマッチを行うようになる。 -follow を使用すると、述語 -lname と -ilname は常に偽を返す。

 

-help, --help

find のコマンドラインの使用法をざっと説明して終了する。

 

-ignore_readdir_race

通常、 find は stat 関数でファイル情報を取得できなかったとき、エラーメッセージを吐くことになっている。ところが、このオプションを指定した場合は、 find がディレクトリからファイル名を読み込んでから、そのファイルに対して stat 関数を実行しようとするまでの間に、ファイルが消去されても、エラーは表示されない。この動作は、コマンドラインで名前を指定したファイルやディレクトリに対しても適用される。このオプションはコマンドラインを読み込む際に有効になるので、ファイルシステムのある部分をこのオプションを有効にして探索し、別の部分はこのオプションを無効にして探索するといったことはできない (そうしたことをやりたかったら、 find コマンドを二回実行する必要があるだろう。一回は、このオプションを付けて、もう一回はこのオプションなしで)。

 

-maxdepth levels

コマンドライン引き数として指定したパスから最大 levels 段階下のディレクトリまで探索する ( levels は非負の整数)。 -maxdepth 0 は、判別式やアクションの対象にするのは、コマンドライン引き数だけであることを意味する。

 

-mindepth levels

コマンドライン引き数として指定したパスから少なくとも levels 段階ディレクトリを下降するまで、どんな判別式やアクションも行わない ( levels は非負の整数)。 -mindepth 1 を指定すると、コマンドラインの引き数を除くすべてファイルを処理する。

 

-mount

ほかのファイルシステムにあるディレクトリを探索しない。これは -xdev の別名であり、系統の違う find との互換性のためにある。

 

-noignore_readdir_race

-ignore_readdir_race の効果を無効にする。

 

-noleaf

「ディレクトリのハードリンク数から 2 を引いたものが、そのディレクトリに含まれるサブディレクトリの数である」とする最適化動作を行わない。このオプションが必要になるのは、ディレクトリとリンクの関係について Unix の流儀に従わないファイルシステムを探索するときだ。たとえば、CD-ROM や MS-DOS のファイルシステムとか、AFS ボリュームのマウントポイントなどを探索するときである。通常の Unix ファイルシステムでは、各ディレクトリは少なくとも 2 個のハードリンクを持っている。ディレクトリ名のエントリと、そのディレクトリ中の `.' エントリである。さらに、そのディレクトリにサブディレクトリがあれば、サブディレクトリそれぞれに、親ディレクトリにハードリンクした '..' エントリが存在する。 find としては、ディレクトリを調べる際に、ディレクトリのリンク数より 2 少ない数だけサブディレクトリを stat 関数で調べた時点で、ディレクトリ中の残りのエントリはディレクトリではない (ディレクトリツリー中の `leaf 葉っぱ' ファイルである) とわかるわけである。もし、調べるのがファイル名だけで充分なら、ファイルに対して stat 関数を実行する必要はない。そこで、この動作により、検索速度がいちじるしく向上するわけだ。

 

-regextype type

判別式 -regex と -iregex が理解する正規表現の文法を変更する。このオプションよりコマンドラインの後方で指定する -regex などに対して効果がある。現在実装されている文法のタイプには、emacs (デフォルトである), posix-awk, posix-basic, posix-egrep, posix-extended がある。

 

-version, --version

find のバージョンを表示して終了する。

 

-warn, -nowarn

警告メッセージの表示、非表示を切り替える。こうしたメッセージは、もっぱらコマンドラインの使用法に関するものであり、 find がディレクトリを探索中に出会うかもしれない何らかの状況に関するものではない。デフォルトの動作は、標準入力が tty であれば、 -warn であり、それ以外の場合は、 -nowarn である。

 

-xdev

ほかのファイルシステムにあるディレクトリを探索しない。

 

判別式 (TESTS)

判別式の中には、たとえば -newerXY や -samefile のように、現在検査の対象になっているファイルと、コマンドラインで指定したリファレンスファイルとを比較することになっているものがある。そうしたリファレンスファイルの実体が何になるかは、 -H, -L, -P といったオプションや、先行する -follow の存在によって決まってくる。ただし、リファレンスファイルが調べられるのは、一回だけであり、それはコマンドラインの解析が行われるときである。リファレンスファイルを調べることができない場合は (たとえば、それに対する stat(2) システムコールに失敗するなど)、エラーメッセージが表示され、 find は 0 以外のステータスで終了する。

数値の引き数は、以下の形で指定することができる。

+n

n を越える数であることを意味する。

-n

n 未満であることを意味する。

n

ぴったり n であることを意味する。

 

-amin n

ファイルの最終アクセス日時が n 分前であれば真。

 

-anewer file

ファイルの最終アクセス日時が、 file の内容更新日時よりも新しければ、真を返す。引き数 file がシンボリックリンクで、しかも -H や -L オプションが有効になっている場合は、リンク先のファイルの内容更新日時が比較に使用されることになる。

 

-atime n

ファイルの最終アクセス日時が n 日前ならば、真を返す。ファイルの最終アクセス日時が何日前かを計算する際、現在時刻との時間差を 24 で割った余りは切り捨てられる。従って、 -atime +1 にマッチするためには、ファイルは少なくとも二日前にアクセスされていなければならない。

 

-cmin n

ファイルの最終ステータス変更日時が n 分前ならば真。

 

-cnewer file

ファイルの最終ステータス変更日時が、 file の内容更新日時よりも新しければ、真を返す。引き数 file がシンボリックリンクで、しかも -H や -L オプションが有効になっている場合は、リンク先のファイルの内容更新日時が比較に使用されることになる。

 

-ctime n

ファイルの最終ステータス変更日時が n 日前ならば、真を返す。何日前かを計算する際に、現在時刻との時間差を 24 で割った余りを切り捨てることが、ファイルのステータス変更日時の解釈にどんな影響を及ぼすかについては、 -atime の説明を見てほしい。

 

-empty

ファイルが空で、通常のファイルかディレクトリならば真。

 

-executable

実行可能なファイルや (ファイル名解決の際に) 検索可能なディレクトリにマッチする。判別式 -perm が ACL (アクセス・コントロール・リスト) などのパーミッション制御の仕組みを無視するのに対して、この判別式は ACL なども考慮に入れる。この判別式は access(2) システムコールを使用しているので、UID マッピング (または root-squashing) を行っている NFS サーバがあると、正確な結果を得られないことがある。なぜなら、たいていのシステムは access(2) をクライアントのカーネルで実装しており、それ故、サーバ側に保持されている UID マッピング情報を利用できないからだ。この判別式はひとえに access(2) システムコールの結果に基づいているので、この判別式が真を返したからと言って、そのファイルが実際に実行できるとはかぎらない。

 

-false

常に偽を返す。

 

-fstype type

ファイルが置かれているファイルシステムが type ならば、真を返す。使用できるファイルシステムは、Unix の系統によって様々である。 Unix の系統次第では指定可能なファイルシステムを不完全ながら挙げると、 ufs, 4.2, 4.3, nfs, tmp, mfs, S51K, S52K などがある。アクション -printf で書式指定子 %F を使えば、使用中のファイルシステムのタイプが何かを知ることができる。

 

-gid n

ファイルのグループ ID 番号が n ならば真。

 

-group gname

ファイルの属するグループが gname ならば真 (グループ ID 番号で指定してもよい)。

 

-ilname pattern

-lname と同じだが、大文字小文字を区別しない。 -L か -follow オプションが有効な場合は、シンボリックリンクがリンク切れしている場合を除き、この判別式は偽を返す。

 

-iname pattern

-name と同じだが、大文字小文字を区別しない。たとえば、パターン `fo*' や `F??' は、`Foo', `FOO', `foo', `fOo' といったファイル名とマッチする。シェルのファイル名展開と違い、こうしたパターンにおいて '*' は、ファイル名の先頭にある '.' ともマッチする。すなわち、 find -name *bar は、ファイル `.foobar' ともマッチすることになるわけだ。当然ながら、パターンは引用符で囲むべきだということに気をつけていただきたい。さもないと、パターン中にワイルドカード文字があれば、シェルがそれを展開してしまうことになる。

 

-inum n

ファイルの inode 番号が n ならば真。たいていの場合、この判別式より、 -samefile を使った方が簡単である。

 

-ipath pattern

-iwholename と同じように動作する。この判別式は非推奨である。使わないでいただきたい。

 

-iregex pattern

-regex と同じだが、大文字小文字を区別しない。

 

-iwholename pattern

-wholename と同じだが、大文字小文字を区別しない。

 

-links n

ファイルのリンク数が n ならば真。

 

-lname pattern

ファイルがシンボリックリンクであり、リンク先として指定されているパスがシェルのパターン pattern にマッチすれば、真を返す。メタ文字は、`/' や `.' を例外扱いしない。 -L や -follow オプションが有効な場合は、シンボリックリンクがリンク切れしている場合を除き、この判別式は偽を返す。

 

-mmin n

ファイルの最終内容更新日時が n 分前であれば真。

 

-mtime n

ファイルの最終内容更新日時が n 日前ならば、真を返す。何日前かを計算する際に、現在時刻との時間差を 24 で割った余りを切り捨てることが、ファイルの内容更新日時の解釈にどんな影響を及ぼすかについては、 -atime の説明を見てほしい。

 

-name pattern

ファイルやディレクトリのベースネーム (パスから最後の要素だけを残して、先行するディレクトリを取り去ったもの) が、シェルのパターン pattern にマッチすれば、真を返す。メタ文字 (`*', `?', `[]) は、ベースネームの先頭にある `.' とマッチする (findutils-4.2.2 からこのように変更になった。下記のセクション「標準への準拠」を参照)。あるディレクトリとそれ以下にあるファイルをまとめて無視するには、 -prune を使うとよい。一例が -path の説明中にある。中カッコ ('{}') は特殊文字として認識されない。この点、bash を含む一部のシェルで、シェル・パターン中の中カッコに特別な意味を付与しているのと異なっている。ファイル名のマッチングは、 fnmatch(3) ライブラリ関数を用いて行われる。パターンを引用符で囲むのを忘れないように。シェルによって展開されてしまわないようにするためである。

 

-newer file

ファイルが file よりも最近に内容を更新されていれば、真を返す。引き数 file がシンボリックリンクで、しかも -H や -L オプションが有効になっている場合は、リンク先のファイルの内容更新日時が比較に使用されることになる。

 

-newerXY reference

目下検査の対象になっているファイルのタイムスタンプを reference と比較する。引き数 reference は、たいていの場合ファイル名であるが (そして、そのタイムスタンプの一つが比較に使用されるが)、日時を直接表す文字列でも構わない。 X と Y は仮の表現であって、実際には以下に述べるような別の文字が来る。そうした文字が、検査の対象になっているファイルとリファレンスそれぞれの、どの日時を比較に使用するかを決めるのである (訳注: 前者を X で、後者を Y で指定する)。

 

組み合わせによっては、無効なものもある。たとえば、 X に t を指定しても無効である。組み合わせの中には、すべてのシステムで実装されているとはかぎらないものもある。たとえば、 B はすべてのシステムでサポートされているわけではない。 XY の無効な組み合わせやサポートされていない組み合わせを指定すると、致命的エラーが起きる。日時を直接指定すると、それは GNU date の -d オプションに対する引き数と同様に解釈される。リファレンスファイルの作成日時を使用しようとして、作成日時が特定できない場合は、致命的エラーのメッセージが表示される。また、検査対象になるファイルの作成日時を参照する判別式を指定した場合、作成日時がわからない環境では、そのテストはどのファイルに対しても失敗することになる。

 

-nogroup

ファイルのグループ ID 番号に対応するグループが存在しなければ真。

 

-nouser

ファイルのユーザ ID 番号に対応するユーザが存在しなければ真。

 

-path pattern

ファイル名がシェルのパターン pattern にマッチすれば真。メタ文字は `/' や `.' を例外扱いしない。従って、たとえば、

 

find . -path "./sr*sc"

 

は、`./src/misc' と言うディレクトリを (存在していれば) 表示する。あるディレクトリ以下をすべて無視するには、そこに存在するファイルを一つ一つ抑止するよりも、 -prune を使用した方がよい。たとえば、 `src/emacs' と、その下にあるファイルやディレクトリのすべてをスキップし、それ以外のファイルがあったら、その名前を表示するとしよう。そのためには、こんな風にする。

 

find . -path ./src/emacs -prune -o -print

 

パターンマッチのテストは、パスを含むファイル名の全体に対して行われるが、そうしたパス付きのファイル名は、コマンドラインで指定した探索の始点の一つから始まっていることに注意してほしい。だから、 -path の引き数に絶対パス名を使用することに意味があるのは、関連する探索の始点がこちらも絶対パスであるときだけだろう。従って、次のコマンドは何にもマッチしないことになる。

 

find bar -path /foo/bar/myfile -print

 

述語 -path は、HP-UX の find でもサポートされている。 POSIX 標準の次期バージョンでも採用されることになるだろう。

 

-perm mode

ファイルの許可属性が mode (8 進数表現でもシンボル表現でもよい) とまったく同じなら、真を返す。 mode 指定のこの形式では、許可属性がぴったり一致することを要求しているので、シンボルによる表現でこの形式を使おうとすると、かなり複雑なモード文字列を指定しなければならないかもしれない。たとえば -perm g=w は、許可属性が 0020 のファイルにしかマッチしないことになる (すなわち、許可属性のうち、グループの書き込み許可のみが立っているファイルだ)。そんなわけで、 mode の前に `/' や `-' を付ける形式を使いたくなる場合の方が、ずっと多そうである。たとえば、 -perm -g=w なら、グループが書き込み許可を持っているいかなるファイルにもマッチするわけだ。具体例については「用例」セクションを見てほしい。

 

-perm - mode

mode で指定した許可属性ビットのすべてが、ファイルでも立っていれば、真を返す。 mode 指定のこの形式でも、シンボルによる許可属性表現が使用できる。と言うより、この形式ではたいていの場合、シンボルによる表現を使いたくなるだろう。シンボルによる表現を使用する場合は、`u' や `g' や `o' をきちんと指定しなければならない。具体例については「用例」セクションを見てほしい。

 

-perm / mode

mode で指定した許可属性ビットのどれかが、ファイルでも立っていれば、真を返す。 mode 指定のこの形式でも、シンボルによる許可属性表現が使用できる。シンボルによる表現を使用する場合は、`u' や `g' や `o' をきちんと指定しなければならない。具体例については「用例」セクションを見てほしい。 mode で許可属性ビットが一つも立っていない場合、この判別式はいかなるファイルにもマッチする (すなわち、 -perm -000 の動作と同じだということだ)。

 

-perm + mode

非推奨な形式。 mode で指定した許可属性ビットのどれかが立っているファイルを捜す古い方法である。代わりに -perm /mode を使用した方がよい。`+' を付けて mode を指定するこの形式でシンボルによる表現を使おうとすると、思いがけない結果を生むことがある。たとえば、 `+u+x' はそれ自体有効なシンボル表現である ('+u,+x' と同じであり、0111 を意味する)。そのため、 -perm +u+x は、 -perm + mode として評価されず、ぴったり一致する許可属性を指定するときの -perm mode として評価されてしまうのだ。その結果、実行ビットが少なくともどれか一つ立っているファイルではなく、許可属性がぴったり 0111 のファイルにマッチすることになる。もし、この項の説明がわかりにくかったとしても、あなた一人がわからないのではない。とりあえず、 -perm / mode を使っておいていただきたい。判別式 -perm のこの形式が非推奨なのは、シンボルによる許可属性に先行する `+' は、シンボル表現の一部として解釈するように POSIX の規定で要求されているからであり、それ故、我々は '+' に代えて、'/' を使うようにしたのである。

 

-readable

読み込み可能なファイルにマッチする。判別式 -perm が ACL (アクセス・コントロール・リスト) などのパーミッション制御の仕組みを無視するのに対して、この判別式は ACL なども考慮に入れる。この判別式は access(2) システムコールを使用しているので、UID マッピング (または root-squashing) を行っている NFS サーバがあると、正確な結果を得られないことがある。なぜなら、たいていのシステムは access(2) をクライアントのカーネルで実装しており、それ故、サーバ側に保持されている UID マッピング情報を利用できないからである。

 

-regex pattern

ファイル名が正規表現 pattern にマッチすれば、真を返す。これはパスを含むファイル名全体に対するマッチであって、部分的な一致ではない。だから、たとえば、`./fubar3' という名前のファイルにマッチさせるために、正規表現 `.*bar.' や `.*b.*3' は使用できるが、`f.*r3' は使用できないわけだ。 find が理解する正規表現は、デフォルトでは Emacs の正規表現だが、これは -regextype オプションで変更することができる。

 

-samefile name

ファイルが name と同じ inode を参照していれば、真を返す。 -L が有効な場合、シンボリックリンクも真を返す。

 

-size n[cwbkMG]

ファイルが n 単位分の領域を使用していれば、真を返す。以下の接尾辞が使える。

サイズには間接ブロック (indirect block) の分は含まれないが、穴空きファイル (sparse file) における、実際には割り当てられていないブロックの分は含まれる。アクション -printf の `%k' や `%b' 書式指定子とは穴空きファイルの扱い方が違うことを、心にとめておいてほしい。接尾辞 `b' は常に 512 バイトのブロックを意味し、1 キロバイトのブロックを指すことはない。その点が、アクション -ls の動作と異なっている。

 

-true

常に真。

 

-type c

ファイルのタイプが c であれば真。 c の位置には実際には以下の文字が来る。

-uid n

ファイル所有者のユーザ ID 番号が n ならば真。

 

-used n

ファイルが最後にアクセスされたのが、ファイルのステータスが最後に変更されてから n 日後ならば、真を返す。

 

-user uname

ファイルの所有者が uname というユーザならば真 (ユーザ ID 番号で指定してもよい)。

 

-wholename pattern

-path と同じである。この別名は移植性で -path に劣る。

 

-writable

書き込み可能なファイルにマッチする。判別式 -perm が ACL (アクセス・コントロール・リスト) などのパーミッション制御の仕組みを無視するのに対して、この判別式は ACL なども考慮に入れる。この判別式は access(2) システムコールを使用しているので、UID マッピング (または root-squashing) を行っている NFS サーバがあると、正確な結果を得られないことがある。なぜなら、たいていのシステムは access(2) をクライアントのカーネルで実装しており、それ故、サーバ側に保持されている UID マッピング情報を利用できないからである。

 

-xtype c

検査の対象となるファイルがシンボリックリンクでないかぎり、 -type と同じである。ファイルがシンボリックリンクのときは、以下のように動作する。 -H や -P オプションが指定された場合は、リンク先のファイルのタイプが c ならば、真を返す。他方、 -L オプションが指定されている場合は、 c が `l' ならば、真を返す。言い換えると、ファイルがシンボリックであるとき、 -xtype は、 -type が検査しない方のファイルのタイプを検査するわけだ。

 

アクション

-delete

ファイルを消去する。消去に成功すれば、真を返す。消去に失敗した場合は、エラーメッセージを表示する。 -delete に失敗した場合の find の終了ステータスは、ゼロ以外である (最終的に終了したときの終了ステータスのことである)。 -delete を使用すると、自動的に -depth オプションが有効になる。

 

警告: 忘れないでほしいが、find のコマンドラインは一つの式 (expression) として評価されるので、一番最初に -delete を指定すると、 find は、指定された探索の開始点以下にあるものを、ことごとく消去しようとする。後で -delete を付けて使用するつもりで、 find のコマンドラインをテスト実行するときは、 -depth を明示的に指定するとよい。そうすれば、後で「こんなはずではなかった」と慌てないですむ。 -delete を指定すると自動的に -depth が有効になるので、 -prune を -delete と一緒に使っても役に立たない。

 

-exec command ;

command を実行する。 command の返り値が 0 ならば、真を返す。 find のコマンドラインで指定されたこれ以降の引き数は、`;' という引き数が現れるまで、すべてコマンドに対する引き数と見なされる。文字列 `{}' は、それがコマンドの引き数中に現れるすべての場所で、現在処理中のファイル名に置き換えられる。 find の一部の版とは違い、`{}' は引き数中の一ヶ所でしか使えないわけではない。こうした構文の要素 (訳注: すなわち、`{}' と `;') は、シェルによって展開されないように、どちらも `\' でエスケープするなり、引用符で囲むなりする必要があるかもしれない。アクション -exec の使用例については「用例」セクションを見てほしい。指定したコマンドは、マッチした各ファイルに対して一回づつ実行される。また、コマンドは find を実行したディレクトリで実行される。そこで、 -exec アクションの使用に関しては、セキュリティの問題が避けられないわけだ。 -exec の代わりに、 -execdir アクションを使用することをお勧めする。 (訳注: `;' は引き数なので、直前の引き数との間に空白が必要だということに注意してほしい。)

 

-exec command {} +

アクション -exec のこの変形も、選択したファイルに対して指定したコマンドを実行するが、コマンドラインを形成するとき、選択した各ファイル名をコマンドラインの末尾に追加して行くという方法を取る (訳注: コマンドラインが長くなりすぎるときは、処理するファイル名の数を適切に分割して、コマンドを複数回実行する)。そのため、コマンドを呼び出す回数は、マッチしたファイルの数よりずっと少なくてすむわけだ。コマンドラインの形成法は、 xargs のコマンドライン形成法とほぼ同じである。`{}' はコマンドライン中の一ヶ所でしか使えない。コマンドは find を実行したディレクトリで実行される。 (訳注: `+' は引き数なので、直前の引き数との間に空白が必要だということに注意してほしい。)

 

-execdir command ;

-execdir command {} +

-exec と似ているが、指定したコマンドはマッチしたファイルが存在するサブディレクトリで実行される。そのサブディレクトリは、 find を実行したディレクトリとは違うのが普通だ。これはコマンドを呼び出す方法としてずっと安全である。マッチしたファイルのパスを解決する際に、競合状態が起きるのを避けられるからだ。アクション -exec の場合と同様、 -execdir の `+' を伴う形式でも、マッチした複数のファイルを一度に処理するように、コマンドラインを形成することになる。しかし、 command のどの呼び出しにおいても、処理の対象としてリストされるファイルは、同じサブディレクトリに存在するものだけである。このアクションを使用するのなら、環境変数 $PATH が `.' を参照しないようにしなければならない。さもないと、悪意を持った攻撃者が、あなたが -execdir を実行することになるディレクトリに適当な名前のファイルを入れておくことによって、何でも好きなコマンドを実行できてしまうからである。 $PATH の中に、空っぽのエントリや、絶対パスのディレクトリ名ではないエントリがある場合にも、同じことが当てはまる。

 

-fls file

真を返す。 -ls と似ているが、 -fprint 同様、出力を file に書き出す点が違う。出力用のファイルは、この述語の対象になるものが一つもなかった場合でも、必ず作成される。ファイル名中の変わった文字がどのように扱われるかについては、「変わり者のファイル名」セクションを参照してほしい。

 

-fprint file

真を返す。パス付きのファイル名をファイル file に出力する。 find の実行時に file が存在しなければ、新たに作成される。すでに存在していれば、元の中身が捨てられる。ファイル名 ``/dev/stdout'' と ``/dev/stderr'' の扱いは特別で、それぞれ標準出力と標準エラー出力を指している。出力用のファイルは、この述語の対象になるものが一つもなかった場合でも、必ず作成される。ファイル名中の変わった文字がどのように扱われるかについては、「変わり者のファイル名」セクションを参照してほしい。

 

-fprint0 file

真を返す。 -print0 と似ているが、 -fprint 同様、出力を file に書き出す点が違う。出力用のファイルは、この述語の対象になるものが一つもなかった場合でも、必ず作成される。ファイル名中の変わった文字がどのように扱われるかについては、「変わり者のファイル名」セクションを参照してほしい。

 

-fprintf file format

真を返す。 -printf と似ているが、 -fprint 同様、出力を file に書き出す点が違う。出力用のファイルは、この述語の対象になるものが一つもなかった場合でも、必ず作成される。ファイル名中の変わった文字がどのように扱われるかについては、「変わり者のファイル名」セクションを参照してほしい。

 

-ls

真を返す。処理対象のファイルを ls -dils の書式で標準出力にリストする。ブロック数は、1 ブロック 1 キロバイトの計算である。ただし、環境変数 POSIXLY_CORRECT が設定されている場合は、 1 ブロック 512 バイトが使用される。ファイル名中の変わった文字がどのように扱われるかについては、「変わり者のファイル名」セクションを参照してほしい。

 

-ok command ;

-exec と似ているが、まずユーザに問い合わせを行う。ユーザーが同意すれば、コマンドを実行する。同意しなければ、何もせずに偽を返す。コマンドを実行する際、そのコマンドの標準入力は、 /dev/null に付け換えられる。

 

プロンプトに対するユーザの応答は、肯定・否定を表す一組の正規表現と照合して、同意か、不同意かが判断される。この正規表現は、環境変数 `POSIXLY_CORRECT' が設定されていれば、システムから得られるが、設定されていなければ、 find のメッセージ・カタログから取得される。なお、システムに適切な定義が存在しない場合は、 find の持つ定義が使用されることになる。どちらの場合でも、正規表現そのものの解釈は、環境変数 'LC_CTYPE' (文字クラスについて) や 'LC_COLLATE' (文字の範囲や等価クラスについて) の影響を受ける。

 

-okdir command ;

-execdir と似ているが、 -ok と同じように、まずユーザに問い合わせを行う。ユーザが同意しなければ、何もせずに偽を返す。コマンドを実行する際、そのコマンドの標準入力は、 /dev/null に付け換えられる。

 

-print

真を返す。パス付きのファイル名を標準出力に表示し、各ファイル名の後ろに改行文字を付ける。 find の出力をパイプを使って他のプログラムに渡している場合、検索対象のファイル名に改行文字が含まれている可能性が、わずかにでもあるならば、アクション -print ではなく、 -print0 を使用することを真剣に考えるべきだ。ファイル名中の変わった文字がどのように扱われるかについては、「変わり者のファイル名」セクションを参照してほしい。

 

-print0

真を返す。パス付きのファイル名を標準出力に表示し、各ファイル名の後ろに ( -print が改行文字を付けるのとは違って) ヌル文字を付加する。そうすることによって、 find の出力を処理するプログラムが、改行文字などのホワイトスペースを含むファイル名を正しく解釈できるようになるわけだ。このアクションは、 xargs の -0 オプションに呼応している。

 

-printf format

真を返す。標準出力に format を出力する。そのとき format 中の `\' によるエスケープシーケンスと、`%' に始まる書式指定子を認識して変換する。フィールドの幅や精度は、C 言語の `printf' 関数と同じやり方で指定できる。フィールドの多くは、(`printf' 関数流に言うと) %d ではなく、%s として出力されることに注意していただきたい。すなわち、フラグが期待通りに効かないかもしれないのだ。だが、それはまた、`-' フラグ (フィールドを強制的に左揃えにする) が使えるということでもある。 -print とは違って、 -printf は文字列の末尾に改行文字を付加しない。バックスラッシュ・エスケープシーケンスと書式指定子は以下のとおりである。

-prune

真を返す。ファイルがディレクトリの場合は、そのディレクトリ以下に降りて行かない。 -depth が指定してあるときは、偽を返し、何もしない。 -delete を指定すると自動的に -depth が有効になるので、 -prune を -delete と一緒に使っても役に立たない。

-quit

直ちに終了する。動いている子プロセスを残したまま終了したりはしないが、コマンドラインで指定したパスをこれ以上処理することはない。たとえば、 find /tmp/foo /tmp/bar -print -quit は、 /tmp/foo を表示するだけである。 -execdir ... {} + によってすでに作成されたコマンドラインがあれば、 find が終了する前に、呼び出して実行する。終了ステータスは、エラーがすでに起きているかどうかよって、0 のことも、0 でないこともある。

 

変わり者のファイル名

多くの場合、 find のアクションはデータを端末に表示することになるわけだが、それはほかのユーザが自由にできるデータであることもある。そうしたデータとは、たとえば、ファイルの名前、サイズ、内容更新日時などだ。この内、ファイル名は `\0' と `/' 以外のどんな文字でも使えることになっているので、時として問題の種となる。ファイル名の中に風変わりな文字があると、使用している端末に思いがけない、そしてしばしば望ましくない影響をもたらすことがあるのだ (たとえば、端末によっては、ファンクション・キーの現在の設定が変更されてしまう)。風変わりな文字をどう扱うかはアクションによって異なっている。それを以下に示そう。

-print0, -fprint0

常にファイル名に手を加えず、そのまま出力する。出力先が端末であっても、同じである。

 

-ls, -fls

風変わりな文字は、常にエスケープされる。ホワイトスペース (空白、改行、タブなど)、バックスラッシュ、ダブルクォートは C 言語式のエスケープ表現で出力される (たとえば `\f', `\"')。ほかの風変わりな文字には、エスケープした8 進数が使われる。それ以外の表示可能な文字は ( -ls や -fls とっては 8 進数の 041 から 0176 に当たる文字)、手を加えずにそのまま出力される。

 

-printf, -fprintf

出力先が端末でない場合は、そのまま出力される。端末の場合は、使用される書式指定子によって、結果は様々である。書式指定子 %D, %F, %g, %G, %H, %Y, %y が展開される値は、ファイルの所有者の管轄外なので、そのまま出力される。書式指定子 %a, %b, %c, %d, %i, %k, %m, %M, %n, %s, %t, %u, %U の値は、ファイル所有者の管轄内であるが、それを使って端末に勝手なデータを送ることはできない。従って、そのまま出力される。書式指定子 %f, %h, %l, %p, %P はクォートされる。このクォート方法は、GNU ls と同じである。言い換えると、 -ls や -fls におけるクォート方法とは違うということだ。もし、 find の出力に使う形式を自由に決めることができるならば、たいていの場合、終端文字に改行ではなく、`\0' を使用した方がよい。ファイル名には空白や改行が含まれていることがあるからだ。どの文字がクォートを必要とするかを判断するには、環境変数 `LC_CTYPE' の設定が使用される。

 

-print, -fprint

クォートは -printf や -fprintf と同じやり方で行われる。 find をスクリプト中で使っている場合や、マッチするファイルが行儀の悪いファイル名を持っている可能性がある場合は、 -print ではなく、 -print0 の使用を考えた方がよいだろう。

アクション -ok と -okdir は、対象となるファイル名をそのまま手を加えずに出力する。この動作は、将来のリリースで変わるかもしれない。

演算子

演算子を優先順位の高いものから順に列挙する。

( expr )

カッコの内側を先に処理する。カッコはシェルにとって特別な意味を持っているので、普通はクォートする必要があるだろう。このマニュアルページで挙げている例の多くでは、そのためにバックスラッシュを使っている。すなわち `(...)' ではなく、`\(...\)' と書いているわけだ。

 

! expr

expr が偽の場合、真になる。通常この記号も、シェルによって解釈されないようにする必要があるだろう。

 

-not expr

! expr と同じだが、POSIX 準拠の表現ではない。

 

expr1 expr2

連続する二つの式は、and 結合と解釈される (明示されていないが、式の間に "-a"があると見なされるわけだ)。 expr1 が偽の場合、 expr2 は評価されない。

 

expr1 -a expr2

expr1 expr2 と同じ。

 

expr1 -and expr2

expr1 expr2 と同じだが、POSIX 準拠の表現ではない。

 

expr1 -o expr2

or 結合である。 expr1 が真ならば、 expr2 は評価されない。

 

expr1 -or expr2

expr1 -o expr2 と同じだが、POSIX 準拠の表現ではない。

 

expr1 , expr2

リストである。常に expr1 と expr2 の両方が評価される。 expr1 の値は捨てられ、 expr2 の値がリスト全体の値になる。コンマ演算子はいくつかの異なったタイプの対象を捜すとき便利だが、ファイルシステム階層の探索は一度しか行われない。異なった形でマッチした対象の一覧をそれぞれ別のファイルに書き出すには、 -fprintf を利用すればよい。

 

[訳注]:

find にとって演算子も引き数である。だから `(', `)', `!', `,' といった演算子も、前後の引き数との間に空白が必要だということに気をつけてほしい。