find(1)

これは位置に依存しない項で、ディレクトリ階層の下降の際に、 ディレクトリのすべてのエントリーをディレクトリ自体より先に調べるようにします。 これが有効なのは find を cpio(1) と併用する場合で、 書き込みパーミッションのないディレクトリ内の ファイルを転送することができます。 また、 cpio(1) を使用する際に、ディレクトリの修正日付を変更したくない場合にも利用できます。 常に真です。

これは位置に依存しない項で、 find がシンボリックリンクを対象とするようになります。 シンボリックリンクを対象とする場合、 find は、調べたディレクトリの跡を管理しているので、無限ループを検出できます。 たとえば、シンボリックリンクが上位ディレクトリを指している場合に発生するループを検出します。 これは、 -type l とともに使用してはいけません。 常に真です。

これは位置に依存しない項で、ファイルシステムのタイプが、 FStype FStype は cdfs、 hfs、 vxfs、 または nfs のいずれかで、それぞれ CDFS、HFS、JFS (VXFS) または NFS の各ファイルシステムに対応) で指定したタイプと異なる場合に、 find はディレクトリを下降しません。

ただし、 マウントポイントはその親ディレクトリの FStype を継承します。 すなわち、 -fsonly hfs が指定された場合、 find が HFS ファイルシステム上にマウントされた NFS マウントポイントを検出すると、 そのマウントポイントはアクセスされますが、 その下のエントリーはアクセスされません。 また、 -fsonly nfs が指定された場合、NFS ファイルシステムのマウントポイントの下にある HFS ファイルシステムはトラバースされないので注意してください。 常に真です。

ファイルが物理的にローカルシステム側にある場合に真になります。 これは、検索を物理的にローカルシステム側にあるファイルだけに制限せず、単にそのようなファイルを一致させているだけです。 『例』 を参照してください。

これは位置に依存しない項で、 find は、 pathname_list に列挙された開始点より下にあるファイルシステムマウン トポイントをトラバースしなくなります。 この場合、マウントポイント自体はアクセスされますが、 そのマウントポイントより下にあるエントリーはアクセスされません。 常に真です。

-xdev と同じです。 この要素は、単に過去のシステムとの互換性のために提供されるものです。 したがって、可能な限り -xdev を優先して使用してください。

パターン file が現在のファイル名の最後の構成要素に一致した場合に真になります。 パターンは、ファイル名展開のパターンマッチング表記に従って 一致の判定が行われます regexp(5) を参照)。 Pattern is matched according to Pattern Matching Notation for filename expansion. find をシェルから実行する場合は、シェルがメタキャラクタとして展開しないように パターンをエスケープ (バックスラッシュを使用) または引用符で囲んでください。 パターンには、追加のコードセットキャラクタを含めることができます。

これは -name と同じですが、ベース名だけでなく、 (-print の出力と同じような) 絶対パスを使用する点が異なります。 なお、 / は特殊文字とはみなされません。 たとえば、 */.profile は、 ./home/fred/.profile に一致します。

この要素では、引き数 mode はファイルのモードビットを表します。 この引き数は chmod(1) の mode オペランドと同じフォーマットですが、 最初の文字に 演算子 - を使用できない点が異なります。 記号形式の mode を使用する場合、 指定しないファイルモードビットはすべてクリアとして扱われます。

先頭の負符号を省略すると、 この要素はファイルパーミッションのビットが mode の値と完全に一致した場合に真になります。 また、記号表現属性 s (set-user-ID、 set-group-ID) (ユーザー ID のセット、グループ ID のセット) および t (スティッキービット) に対応するビットは無視されます。

mode の前に負符号を付けると、 この要素は mode でオンになっている全ビットがファイルパーミッション ビットでも オンである場合に真になります。 この場合、記号表現属性 s および t に対応するビットは有効になります。

ファイルが属するファイルシステムのタイプが FStype FStype は cdfs、 hfs、 nfs、 または vxfs のいずれかで、それぞれ CDFS、HFS、NFS、または JFS (VXFS) の各ファイルシステム タイプに対応) の場合に真になります。

ファイルのタイプが c の場合に真になります。 c は以下のいずれかを表します。

ファイルに n 個のリンクが存在した場合に真になります。

ファイルがユーザー uname に属している場合に真になります。 uname が数値で /etc/passwd ファイル内にログイン名として存在していない場合、 それはユーザー ID とみなされます。 uname オペランドの前に + または - を付けて、プライマリの比較を変更することができます。 項 n が 10 進数の整数を表す場合、 +n は n より大きいことを意味し、 -n は n より小さいことを意味し、 n はちょうど n を意味します。

ファイルがグループ gname に属している場合に真になります。 gname が数値で /etc/group ファイル内に存在しない場合、それはグループ ID とみなされます。 gname オペランドの前に + または - を付けて、プライマリの比較を変更することができます。 項 n が 10 進数の整数を表す場合、 +n は n より大きいことを意味し、 -n は n より小さいことを意味し、 n はちょうど n を意味します。

ファイルが属するユーザー ID がパスワードデータベース内にリストされていない場合に真になります。 passwd(4) を参照してください。

ファイルが属するグループ ID がグループデータベース内にリストされていない場合に真になります。 group(4) を参照してください。

ファイルが n ブロックの長さの場合に真になります (1 ブロックは 512 バイト)。 n の後に c があると、サイズは文字単位になります。

開始時刻からファイルのアクセス時刻を引いた時間が 24 時間の n-1 倍と n 倍の間にある (すなわち n 日前にアクセスした) 場合に真になります。 開始時刻は、 find ユーティリティの起動時刻と path オペランドで指定されたファイルへの find ユーティリティの実行による最初のアクセス時刻との間の時刻です。 pathname_list 内のディレクトリのアクセス時刻は、 find 自身が変更します。

開始時刻からファイルの変更時刻を引いた時間が 24 時間の n-1 倍と n 倍の間にある (すなわち n 日前に変更した) 場合に真になります。 開始時刻は、 find ユーティリティの起動時刻と path オペランドで指定されたファイルへの find ユーティリティの実行による最初のアクセス時刻との間の時刻です。

開始時刻からファイルのステータス情報の最終変更時刻を引いた時間が 24 時間の n-1 倍と n 倍の間にある (すなわち n 日前にステータス情報を変更した) 場合に真になります。 開始時刻は、 find ユーティリティの起動時刻と path オペランドで指定されたファイルへの find ユーティリティの実行による最初のアクセス時刻との間の時刻です。

現在のファイルが、引き数の file より後に修正されている場合に真になります。

現在のファイルの 時刻の値 tv1) が file の時刻の値 tv2) より新しい場合に真になります。 時刻の値 tv1 と tv2 は、それぞれ次の 3 文字のいずれかで示されます。

tv2 文字を省略すると、デフォルトは m になります。 -newer オプションは、 -newermm と等価です。

構文例

ファイルのシリアル番号 (i ノード番号) が n の場合に真になります。 ただし、 ファイルのシリアル番号は 1 つのファイルシステム中でのみユニークとなります。 したがって、ファイルのシリアル番号のマッチングを行っても、 検索範囲を 1 つのファイルシステムに限定しない限り、 参照されたファイルが同じであるとは限りません。

ファイルが path で指定したファイルと同じ物理ファイルであれば (すなわち、 path にリンクされていれば)、真になります。 この要素は -inum とほとんど同じですが、 複数のファイルシステムを対象に検索を行った場合でも、 ファイルが path にハードリンクされていることを正しく検出します。

現在のパス名を出力します。 常に真です。

実行した cmd が終了ステータスとしてゼロの値を返す場合に真になります。 cmd の後にはセミコロン (;) またはプラス記号 (+) を付けなければなりません (セミコロンおよびプラス記号 はシェルでは特別な意味を持つので、エスケープする必要があります)。 + が使用される場合は、 cmd は、pathnames のセットを集め、そのセットに対して実行します。 最初の {} と + の間のコマンド引き数は無視されます。 ; より + の方がよい理由は、パフォーマンスが非常に向上するからです。 コマンド引き数 {} は現在のパス名で置き換えられます。 cmd は、追加コードセットキャラクタを含みます。

-exec と同じですが、 生成されたコマンド行の先頭に疑問符を付けて出力し、 ユーザーが y と応答した場合に限って実行する点が異なります。 肯定の応答の形式は、ロケール依存になります。 たとえば、ロケールが C の場合は、"y"になります。 environ(5) の LANG を参照してください。 cmd は、セミコロン (;) で終わらなければなりません。 (セミコロンはシェルでは特別な意味を持つので、エスケープする必要があります)。 cmd は、補助コードセットの文字を含んでも構いません。

現在のファイルを cpio(4) フォーマット (5120 バイトレコード) で device に書き込みます。 -cpio を使用した場合は、 -depth も指定されているとみなされます。 常に真です。

-cpio と同じですが、 cpio に -c オプションを追加します。 -ncpio を使用した場合は、 -depth も指定されているとみなされます。 常に真です。

現在のエントリーがディレクトリの場合、 find はそのディレクトリをスキップします。 この要素は、特定のディレクトリを検索の対象から外す場合、 あるいは cpio -p を使用している際に再帰的なループを回避する場合に利用することができます。 ただし、 -depth オプションが指定されている場合、 -prune は無効になります。 詳細は、 -only の説明と下記の 『例』 を参照してください。 常に真です。

これは -prune とは逆の肯定論理を適用する要素です。 -prune は、各ディレクトリに対する -only の評価が失敗した場合に、実行されます。 次の 3 つのコマンドは、等価になります。

ただし、 -depth オプションが指定されている場合、 -only は無効になります。 常に真です。

かっこで囲んだ式が真であれば、真になります。 スペースは必須です。 かっこは、シェルに対して特別な意味を持つので、 \( や \) のように、エスケープする必要があります。

論理 NOT 演算子。 expression が真でなければ、真になります。

論理 AND 演算子。 2 つの expression が両方とも真であれば、真になります。

論理 OR 演算子。 2 つの expression の一方または両方が真であれば、真になります。

グループ名

マウントポイント

ユーザー名