find - クラウドでオンライン

プログラム：

NAME

find - ディレクトリ階層内のファイルを検索します

SYNOPSIS

find [-H] [-L] [-P] [-D debugopts] [-Olevel] [開始点...] [式]

DESCRIPTION

このマニュアルページには、GNUバージョンの find。 GNU find ディレクトリツリーを検索します
与えられた式を左から右に評価することにより、与えられた各開始点に根ざし、
結果がわかるまで、優先順位の規則に従って (セクション OPERATORS を参照)
(左辺は偽です & 操作、真 or）、 その時点で find 移動
次のファイル名に進みます。 開始点が指定されていない場合、`.' が想定されます。

使用している場合 find セキュリティが重要な環境 (たとえば、
他のユーザーが書き込み可能なディレクトリを検索するために使用している場合)、
findutils ドキュメントの「セキュリティに関する考慮事項」の章。 検索
そしてfindutilsが付属しています。 そのドキュメントには、さらに多くの詳細が含まれており、
このマニュアル ページよりも詳細な説明を参照してください。

OPTIONS

　 -H, -L & -P オプションは、シンボリック リンクの処理を制御します。 コマンドライン引数
これらに続くものは、検査されるファイルまたはディレクトリの名前と見なされます。
`-' で始まる最初の引数、または引数 `(' または `!'。
次の引数は、何を検索するかを記述する式と見なされます。
パスが指定されていない場合は、現在のディレクトリが使用されます。 式が指定されていない場合、
表現 -印刷 が使用されています（ただし、おそらく使用を検討する必要があります -print0 代わりに
とにかく）。

このマニュアルページでは、式リスト内の「オプション」について説明しています。 これらのオプションは制御します
の行動 find ただし、最後のパス名の直後に指定されています。 XNUMX
「本当の」オプション -H, -L, -P, -D & -O ある場合は、最初のパス名の前に表示する必要があります。 あ
ダブルダッシュ -- 残りの引数がオプションではないことを通知するためにも使用できます
(ただし、すべての開始点が `./' または `/' のいずれかで始まることを確認する方が、一般的に安全です。
開始点のリストでワイルドカードを使用します)。

-P シンボリック リンクをたどらない。 これはデフォルトの動作です。 いつ find 調べたり
情報をファイルに出力し、ファイルはシンボリックリンクであり、使用される情報
シンボリックリンク自体のプロパティから取得されます。

-L シンボリック リンクをたどります。 いつ find ファイルに関する情報を検査または出力します。
使用される情報は、リンク先のファイルのプロパティから取得されます
リンク自体からではなく、ポイント (壊れたシンボリック リンクまたは find is
リンク先のファイルを調べることができません)。 このオプションを使用すると、
-ノリーフ. 後で使用する場合 -P オプション、 -ノリーフ 引き続き有効になります。 もしも -L
有効であり、 find その中にサブディレクトリへのシンボリックリンクを発見します
検索すると、シンボリック リンクが指すサブディレクトリが検索されます。

時 -L オプションが有効な場合、 型 述語は常に
リンク自体ではなく、シンボリック リンクが指すファイルのタイプ (ただし、
シンボリックリンクが壊れています）。 シンボリック リンクを無効にする可能性のあるアクション
壊れた find 実行中です（たとえば、 -削除) 混乱を招く可能性があります
行動。 使用する -L を引き起こす -名前 & -イルネーム 常に返す述語
偽。

-H コマンドライン引数の処理中を除いて、シンボリック リンクをたどりません。
日時 find ファイルに関する情報を検査または印刷する場合、使用される情報は
シンボリック リンク自体のプロパティから取得されます。 これに対する唯一の例外
動作は、コマンド ラインで指定されたファイルがシンボリック リンクであり、
リンクを解決できます。 その場合、使用される情報は次から取得されます。
リンクが指すものは何でも (つまり、リンクをたどります)。 についての情報
シンボリック リンクが指しているファイルの場合、リンク自体がフォールバックとして使用されます。
調べることはできません。 もしも -H が有効であり、で指定されたパスの XNUMX つ
コマンド ラインがディレクトリへのシンボリック リンクである場合、そのディレクトリの内容は
(もちろん -maxdepth 0 はこれを防ぎます)。

複数ある場合 -H, -L & -P が指定されている場合、それぞれが他をオーバーライドします。 最後のもの
コマンドラインに現れると有効になります。 デフォルトなので、 -P オプションはすべきです
次のいずれかでない限り、有効であると見なされます。 -H or -L 指定されています。

GNU find コマンド ライン自体の処理中に頻繁に統計ファイルを実行する前に、
任意の検索が開始されました。 これらのオプションは、それらの引数の処理方法にも影響します。
具体的には、コマンドラインにリストされたファイルを比較する多くのテストがあります
現在検討中のファイルに対して。 いずれの場合も、
コマンド ラインが検査され、そのプロパティの一部が保存されます。 もしも
名前付きファイルは実際にはシンボリック リンクであり、 -P オプションが有効になっている (またはどちらでもない場合)
-H また -L が指定されている場合)、比較に使用される情報は、
シンボリック リンクのプロパティ。 それ以外の場合は、のプロパティから取得されます
リンク先のファイル。 もしも find リンクをたどることができません (たとえば、
権限が不十分であるか、リンクが存在しないファイルを指している場合)、
リンク自体が使用されます。

時 -H or -L オプション 　 in 効果、 どれか シンボリック リンク 記載されている の議論として
-新しい は逆参照され、タイムスタンプはファイルから取得されます。
シンボリック リンク ポイント。 同じ考慮事項が適用されます -新しいXY, -新たに & -cnewer.

　 -フォロー オプションはと同様の効果があります -L、しかし、それはポイントで有効になります
表示されます（つまり、 -L は使用されませんが -フォロー つまり、その後に現れるシンボリックリンク
-フォロー コマンドライン上のものは逆参照され、それより前のものは逆参照されません)。

-D デバッグオプション
診断情報を出力します。 これは、問題の原因を診断するのに役立ちます
find あなたが望むことをしていません。 デバッグ オプションのリストはカンマにする必要があります
分離した。 デバッグ オプションの互換性は、リリース間で保証されていません
findutils の。 有効なデバッグ オプションの完全なリストについては、次の出力を参照してください。 find
-D 助けます. 有効なデバッグ オプションは次のとおりです。

help デバッグ オプションの説明

tree 式ツリーを元の最適化された形式で表示します。

stat ファイルが検査されるときにメッセージを出力します。 STAT & lstat システムコール。
　 find プログラムは、そのような呼び出しを最小限に抑えようとします。

opt 式の最適化に関連する診断情報を出力します
木; -O オプションを参照してください。

rates 各述語が成功または失敗した頻度を示す要約を出力します。

-オレベル
クエリの最適化を有効にします。 の find プログラムは実行を高速化するためにテストの順序を変更します
全体的な効果を維持しながら; つまり、副作用のある述語はそうではありません。
相互に並べ替えられます。 各最適化で実行される最適化
レベルは以下の通り。

0 最適化レベル 1 に相当。

1 これはデフォルトの最適化レベルであり、従来の
行動。 名前のみに基づいてテストされるように、式が並べ替えられます。
ファイルの -名前 & -正規表現) が最初に実行されます。

2 任意 型 or -xtype のみに基づくすべてのテストの後にテストが実行されます。
ただし、ファイルからの情報を必要とするテストの前に
i ノード。 多くの最新バージョンの Unix では、ファイル タイプは次のように返されます。
readdir（） したがって、これらの述語は述語よりも評価が高速です
最初にファイルを開始する必要があります。 を使用する場合 -fstype FOO 述語と
ファイルシステムの種類を指定する FOO 知られていない（つまり、
`/etc/mtab'） 当時の find 開始、その述語はと同等です
-間違い.

3 この最適化レベルでは、完全なコストベースのクエリ オプティマイザが有効になります。
テストの順序は、安価な (つまり、高速な) テストが実行されるように変更されます。
必要に応じて、最初とより高価なものは後で実行されます。 内部
各コスト バンドに応じて、述語が先にまたは後で評価されます。
成功する可能性があるかどうか。 為に -o、述語
成功する可能性が高いものはより早く評価され、 -a、述語
失敗する可能性のあるものは、より早く評価されます。

コストベースのオプティマイザーには、特定のテストがどの程度の可能性があるかについての固定された考えがあります。
成功した。 場合によっては、確率は特定の性質を考慮します。
テスト (たとえば、 型 f よりも成功する可能性が高いと想定される 型 c).
コストベースのオプティマイザは現在評価中です。 実際にそうでない場合
のパフォーマンスを向上させる find、再び削除されます。 逆に、
信頼性が高く、堅牢で効果的であることが証明されている最適化は、
時間の経過とともに最適化レベルが低下します。 ただし、デフォルトの動作 (つまり
最適化レベル 1) は、4.3.x リリース シリーズでは変更されません。 の
findutils テスト スイートはすべてのテストを実行します find 各最適化レベルで
結果が同じであることを保証します。

表現

開始点のリストの後のコマンド ラインの部分は、 表現。 これは
ファイルの照合方法とファイルの処理方法を記述する一種のクエリ仕様
一致したもの。 式は一連のもので構成されます。

テスト テストは、通常、ファイルのプロパティに基づいて、true または false の値を返します。
検討中です。 の -空の たとえば、現在のファイルが
空です。


アクションには副作用 (標準出力に何かを出力するなど) があり、
通常、成功したかどうかに基づいて、true または false を返します。
　 -印刷 たとえば、アクションは現在のファイルの名前を標準に出力します
出力。

グローバルオプション
グローバル オプションは、任意の部分で指定されたテストとアクションの操作に影響します。
コマンドライン。 グローバル オプションは常に true を返します。 の - 深さ のオプション
例が作る find ファイルシステムを深さ優先でトラバースします。

位置オプション
定位置オプションは、それに続くテストまたはアクションのみに影響します。 ポジショナル
options は常に true を返します。 の -regextype たとえば、オプションは位置、
後で発生する正規表現の正規表現方言を指定する
コマンドラインで。

オペレーター
演算子は、式内の他の項目を結合します。 彼らはのために含まれています
例 -o (論理 OR を意味する) および -a (論理積を意味します)。 オペレーターのいる場所
ない、 -a 想定されます。

式全体に次のアクション以外のアクションが含まれていない場合 -プルーン or -印刷, -印刷 is
式全体が true であるすべてのファイルに対して実行されます。

　 -削除 アクションもオプションのように機能します ( - 深さ).

ポジショナル OPTIONS
定位置オプションは常に true を返します。 後で発生するテストのみに影響します。
コマンドライン。

-デイスタート
測定時間（ -にいる, -時間, -cmin, -ctime, -みん, - ファイルのmtime）から
24 時間前ではなく、今日の始まりです。 このオプションはテストにのみ影響します
コマンドラインで後で表示されます。

-フォロー
非推奨。 使用 -L 代わりにオプション。 シンボリック リンクを逆参照します。 示す
-ノリーフを選択します。 -フォロー オプションは、それ以降に表示されるテストのみに影響します。
コマンドライン。 ない限り -H or -L オプションが指定されている場合、
-フォロー オプションは、 -新しい 述語; としてリストされているファイル
の議論 -新しい シンボリック リンクの場合は逆参照されます。 同じ
対価が適用される -新しいXY, -新たに & -cnewer。 同様に、 型
述語は、シンボリック リンクが作成されたファイルのタイプに対して常に一致します。
リンク自体ではなく、を指しています。 使用する -フォロー を引き起こす -名前 & -イルネーム
述語は常に false を返します。

-regextype type
が理解できる正規表現構文を変更します。 -正規表現 & -irex テストする
コマンドラインで後で発生します。 既知の正規表現の種類を確認するには、
つかいます -regextype 助けます. Texinfo のドキュメント ( 関連項目 ALSO) 意味を説明します
さまざまなタイプの正規表現の相違点。

-警告、-警告
警告メッセージをオンまたはオフにします。 これらの警告は、コマンド ラインにのみ適用されます
使用、条件にではありません find 検索時に遭遇する可能性があります
ディレクトリ。 デフォルトの動作は以下に対応します -警告 標準入力が
tty、およびへ -ノワーン それ以外は。 コマンドラインの使用に関する警告メッセージが表示された場合
の終了ステータス find 影響を受けません。 POSIXLY_CORRECT の場合
環境変数が設定され、かつ -警告 is また 中古、 it is 指定の これ、 if
どれか、 警告 意志 be アクティブ。

GLOBAL OPTIONS
グローバル オプションは常に true を返します。 グローバル オプションは、発生するテストに対しても有効です。
コマンドラインの前に。 混乱を避けるために、グローバル オプションは
開始点のリストの後のコマンドライン、最初のテストの直前、定位置オプション
またはアクション。 他の場所でグローバルオプションを指定すると、 find 警告を発します
これが混乱を招く可能性があることを説明するメッセージ。

グローバル オプションは開始点のリストの後にあるため、同じ種類の開始点ではありません。
オプションとして -L例えば。

-d FreeBSD、NetBSD、MacOS X、および OpenBSD との互換性のための -depth の同義語。

-depth ディレクトリ自体の前に各ディレクトリの内容を処理します。 -delete アクション
また意味します - 深さ.

-助けて
のコマンドライン使用法の概要を出力します find 終了します。

-ignore_readdir_race
通常は、 find ファイルの stat に失敗すると、エラー メッセージが出力されます。 もし、あんたが
このオプションを指定すると、その間にファイルが削除されます find の名前を読み取ります
ディレクトリからのファイルと、ファイルを統計しようとする時間、エラーメッセージなし
発行されます。 これは、名前が指定されているファイルまたはディレクトリにも適用されます
コマンドラインで。 このオプションは、コマンド ラインが実行された時点で有効になります。
つまり、これでファイルシステムの一部を検索することはできません
オプションをオンにし、その一部をこのオプションをオフにします (そうする必要がある場合は、
XNUMXつ発行する必要があります find XNUMX つはオプションあり、もう XNUMX つはオプションなし)。

-最大深度 レベル
せいぜい降りる レベル (非負の整数) 以下のディレクトリのレベル
出発点。 -最大深度 0
テストとアクションを開始点自体にのみ適用することを意味します。

-min Depth レベル
以下のレベルでテストやアクションを適用しないでください。 レベル (否定的ではない
整数）。 -min Depth 1 開始点を除くすべてのファイルを処理することを意味します。

-mount 他のファイルシステムのディレクトリを降りません。 の別名 -xdev、用
の他のバージョンとの互換性 find.

-noignore_readdir_race
の効果をオフにします -ignore_readdir_race.

-ノリーフ
ディレクトリに含まれるサブディレクトリが 2 つ少ないと仮定して最適化しないでください。
ハードリンク数。 このオプションは、ファイルシステムを検索するときに必要です。
CD-ROM や MS-DOS ファイルシステムなど、Unix のディレクトリ リンク規則に従わない
または AFS ボリューム マウント ポイント。 通常の Unix ファイルシステムの各ディレクトリには、
少なくとも 2 つのハード リンク: その名前とその「.」 エントリ。 さらに、そのサブディレクトリ
(存在する場合) それぞれに、そのディレクトリにリンクされた `..' エントリがあります。 いつ find を調べている
ディレクトリ、ディレクトリのリンクよりも 2 つ少ないサブディレクトリを示した後
count、ディレクトリ内の残りのエントリが非ディレクトリであることを認識しています
(ディレクトリ ツリーの「leaf」ファイル)。 ファイルの名前だけが必要な場合
調べる必要はありません。 これにより、
検索速度。

-バージョン、-バージョン
印刷する find バージョン番号と終了。

-xdev 他のファイルシステムのディレクトリを降りません。

TESTS
たとえば、いくつかのテスト -新しいXY & -同じファイル、ファイル間の比較を許可する
現在調査されており、コマンドラインで指定された参照ファイルがあります。 いつ
これらのテストが使用されると、参照ファイルの解釈は
オプション -H, -L & -P および以前の -フォロー、しかし参照ファイルは検査されるだけです
コマンド ラインが解析されるときに XNUMX 回。 参照ファイルを調べられない場合
（たとえば、 STAT(2) システムコールが失敗する)、エラーメッセージが発行され、 find
ゼロ以外のステータスで終了します。

数値引数は次のように指定できます。

+n よりも大きい n,

-n 未満 n,

n 正確に n.

-にいる n
ファイルが最後にアクセスされました n 数分前。

-新たに file
ファイルが最後にアクセスされたのは、 file 変更されました。 もしも file 象徴的です
リンクと -H オプションまたは -L オプションが有効な場合、ファイルのアクセス時間
それは常に使用されることを指します。

-時間 n
ファイルが最後にアクセスされました n※24時間前。 find が 24 時間の数を割り出すとき
ファイルが最後にアクセスされた期間より前の場合、小数部分は無視されるため、一致する
-時間 +1、ファイルは少なくともアクセスされている必要があります 2 数日前。

-cmin n
ファイルのステータスが最後に変更されました n 数分前。

-cnewer file
ファイルのステータスが最後に変更されたのは、 file 変更されました。 もしも file 　
シンボリックリンクと -H オプションまたは -L オプションが有効で、status-change
それが指すファイルの時刻が常に使用されます。

-ctime n
ファイルのステータスが最後に変更されました n※24時間前。 のコメントを参照してください -時間 〜へ
丸めがファイル ステータス変更時間の解釈にどのように影響するかを理解します。

-empty ファイルは空で、通常のファイルまたはディレクトリです。

-実行可能
実行可能なファイルと検索可能なディレクトリ (ファイル内) に一致します。
名前解決の意味)。 これには、アクセス制御リストやその他のものが考慮されます。
アクセス許可アーティファクト -パーマ テストは無視します。 このテストは、
アクセス(2) システムコールなので、UID マッピング (または
root-squashing)、多くのシステムが実装しているため アクセス(2) クライアントのカーネルと
そのため、サーバーに保持されている UID マッピング情報を利用することはできません。 これだから
テストは、の結果のみに基づいています。 アクセス(2) システムコール、なし
このテストが成功したファイルが実際に実行できることを保証します。

-false 常に false。

-fstype type
ファイルは次のタイプのファイルシステムにあります type. 有効なファイルシステムの種類は、
Unix の異なるバージョン。 あるファイルシステムタイプの不完全なリスト
Unix または別のバージョンで受け入れられるのは、ufs、4.2、4.3、nfs、tmp、mfs、S51K、
S52K。 使用できます -printf %F ディレクティブを使用して、あなたのタイプを確認します
ファイルシステム。

-ギッド n ファイルの数値グループ ID は n.

-グループ 名前
ファイルはグループに属しています 名前 (数値のグループ ID を使用できます)。

-イルネーム パターン
いいね -名前、ただし、一致では大文字と小文字が区別されません。 もし -L オプションまたは -フォロー
オプションが有効な場合、シンボリック リンクが壊れていない限り、このテストは false を返します。

-いなめ パターン
いいね -名前、ただし、一致では大文字と小文字が区別されません。 たとえば、パターン `fo*' と
「フ??」 ファイル名 `Foo'、`FOO'、`foo'、`fOo' などに一致します。パターン `*foo*`
「.foobar」というファイルにも一致します。

-inum n
ファイルには inode 番号があります n. 通常はこちらのほうが使いやすい -同じファイル 代わりにテストします。

-ipath パターン
いいね -道. ただし、一致は大文字と小文字を区別しません。

-irex パターン
いいね -正規表現ただし、一致では大文字と小文字が区別されません。

-i全体名 パターン
-ipath を参照してください。 この代替手段は、移植性が低くなります。 -ipath.

-リンク n
ファイルには n リンク。

-名前 パターン
ファイルは、内容がシェル パターンと一致するシンボリック リンクです パターンを選択します。
メタ文字は `/' または `.' を扱いません。 特に。 もし -L オプションまたは -フォロー
オプションが有効な場合、シンボリック リンクが壊れていない限り、このテストは false を返します。

-みん n
ファイルのデータが最後に変更されました n 数分前。

- ファイルのmtime n
ファイルのデータが最後に変更されました n※24時間前。 のコメントを参照してください -時間 〜へ
丸めがファイル変更時間の解釈にどのように影響するかを理解します。

-名前 パターン
ファイル名のベース（先頭のディレクトリが削除されたパス）がシェルと一致する
パターン パターン. 先頭のディレクトリが削除されるため、ファイル名は
との試合と見なされる -名前 決してスラッシュを含まないので、`-name a/b' は
何にも一致しません（おそらく使用する必要があります -道 代わりは）。 警告が出される
これを行おうとすると、環境変数 POSIXLY_CORRECT が設定されていない限り。 の
メタ文字 (`*'、`?'、および `[]') は `.' に一致します。 ベース名の先頭 (これ
findutils-4.2.2 での変更です。 以下の「標準への準拠」のセクションを参照してください)。 に
ディレクトリとその下のファイルを無視し、使用します -プルーン; の例を参照してください
の説明 -道. 中括弧は特別なものとして認識されていません。
Bashを含むいくつかのシェルは、シェルで特別な意味を持つブレースを吹き込みます
パターン。 ファイル名の一致は、 fnmatch(3)
ライブラリ機能。 パターンを引用符で囲むことを忘れないでください。
シェルによって膨張から保護します。

-新しい file
ファイルは次の日付よりも最近変更されました file。 場合 file はシンボリックリンクであり、 -H
オプションまたは -L オプションが有効で、それが指すファイルの変更時刻
to は常に使用されます。

-新しいXY 参照
タイムスタンプがあれば成功 X 考慮されているファイルのタイムスタンプよりも新しい Y of
ファイル 参照. 文字 X & Y 次の文字のいずれかです。

a ファイルのアクセス時間 参照
B ファイルの誕生時刻 参照
c の inode ステータス変更時間 参照

m ファイルの変更時刻 参照
t 参照 時間として直接解釈されます

一部の組み合わせは無効です。 たとえば、次の場合は無効です。 X ようにするには t。 いくつかの
組み合わせはすべてのシステムに実装されているわけではありません。 例えば B ではサポートされていません
すべてのシステム。 無効またはサポートされていない組み合わせ XY 致命的
エラー結果。 時間指定は、 -d
GNUのオプション date. 参照ファイルの誕生時刻を使用しようとすると、
出生時刻を特定できない場合、致命的なエラー メッセージが表示されます。 指定する場合
検査中のファイルの発生時刻を参照するテスト、このテストは失敗します
生年月日が不明なファイルの場合。

-グループなし
ファイルの数値グループ ID に対応するグループがありません。

-ノーザー
ファイルの数値ユーザー ID に対応するユーザーがいません。

-道 パターン
ファイル名がシェルパターンと一致する パターン. メタ文字は `/' または
「.」 特に; たとえば、
探す 。 -パス「./sr*sc」
`./src/misc' (存在する場合) というディレクトリのエントリを出力します。 無視する
ディレクトリツリー全体、使用 -プルーン ツリー内のすべてのファイルをチェックするのではなく、
たとえば、ディレクトリ `src/emacs' とその下のすべてのファイルとディレクトリをスキップするには
それを見つけて、見つかった他のファイルの名前を出力するには、次のようにします。
探す 。 -path ./src/emacs -prune -o -print
パターン一致テストは、ファイル名全体に適用されることに注意してください。
コマンドラインで指定された開始点の。 を使用することだけが理にかなっています
関連する開始点も絶対パスの場合は、ここに絶対パス名を指定します。 これ
これは、このコマンドが何にも一致しないことを意味します:
バーを見つける -path /foo/bar/myfile -print
検索は -道 ディレクトリ名と
調べているファイルのベース名。 連結は決して終わらないので
スラッシュ、 -道 スラッシュで終わる引数は何にも一致しません (おそらく
コマンドラインで指定された開始点)。 述語 -道 もサポートされています
HP-UXによる find POSIX 標準の次期バージョンに含まれる予定です。

-パーマ モード
ファイルの許可ビットは正確に モード (XNUMX 進数またはシンボリック)。 完全一致なので
この形式をシンボリック モードに使用する場合は、次のようにする必要があります。
かなり複雑なモード文字列を指定します。 たとえば、`-perm g=w' のみが一致します。
モードが 0020 のファイル (つまり、グループの書き込み権限が
許可セットのみ)。 `/' や `-' を使いたくなる可能性が高くなります。
たとえば、`-perm -g=w' のような形式で、group write を持つ任意のファイルに一致します。
許可。 を参照してください 例 いくつかの説明的な例については、セクションを参照してください。

-パーマ-モード
すべての許可ビット モード ファイルに設定されています。 記号モードが受け入れられます
この形式で、これは通常、それらを使用したい方法です。 君は
シンボリック モードを使用する場合は、「u」、「g」、または「o」を指定する必要があります。 を参照してください 例
いくつかの実例があります。

-パーマ /モード
許可ビットのいずれか モード ファイルに設定されています。 記号モードが受け入れられます
この形で。 シンボリック モードを使用する場合は、「u」、「g」、または「o」を指定する必要があります。 見る
　 例 いくつかの説明的な例については、セクションを参照してください。 許可ビットがない場合 モード
が設定されている場合、このテストは任意のファイルに一致します (ここでの考え方は、
の動作 -パーマ -000).

-パーマ +モード
これはサポートされなくなりました (2005 年以降は廃止されています)。 使用する -パーマ /モード
を代わりにお使いください。

-可読性
読み取り可能なファイルに一致します。 これは、アクセス制御リストと
他のパーミッション アーティファクト -パーマ テストは無視します。 このテストは
　 アクセス(2) システムコールであり、UID マッピングを行う NFS サーバーにだまされる可能性があります。
（またはルートスカッシング）、多くのシステムが実装しているため アクセス(2) クライアントのカーネル内
そのため、サーバーに保持されている UID マッピング情報を利用することはできません。

-正規表現 パターン
ファイル名が正規表現に一致 パターン. これはパス全体で一致し、
検索ではありません。 たとえば、`./fubar3' という名前のファイルに一致させるには、
正規表現 `.*bar.' または `.*b.*3' ですが、`f.*r3' ではありません。 正規表現
によって理解される find はデフォルトで Emacs の正規表現ですが、これは
で変更されました -regextype オプションを選択します。

-同じファイル 名
ファイルは次と同じ inode を参照しています 名。 時 -L 有効であり、これには以下が含まれます
シンボリックリンク。

-サイズ n[CWBKMG]
ファイルの用途 n スペースの単位、切り上げ。 次のサフィックスを使用できます。

512 バイト ブロックの場合は「b」 (接尾辞が使用されていない場合、これがデフォルトです)

バイトの場合は「c」

XNUMX バイトの単語の場合は「w」

キロバイト (1024 バイト単位) の場合は「k」

メガバイト (1048576 バイトの単位) の場合は「M」

「G」はギガバイト (1073741824 バイトの単位)

サイズは間接ブロックをカウントしませんが、スパース ファイル内のブロックをカウントします
実際には割り当てられません。 `%k' と `%b' フォーマットは
の指定子 -printf スパース ファイルを別の方法で処理します。 `b' サフィックスは常に
は 512 バイトのブロックを示し、決して 1 キロバイトのブロックではありません。
の動作 -ls.

+ と - の接頭辞は、通常どおり、大なり小なりを表します。 心に留めておいてください
サイズは次の単位に切り上げられます。 したがって -サイズ -1M 同等ではありません
〜へ -サイズ -1048576c. 前者は空のファイルのみに一致し、後者はファイルに一致します
1 ～ 1,048,575 バイト。

-true 常に真。

型 c
ファイルの種類 c:

b ブロック (バッファ) スペシャル

c 文字 (バッファなし) 特殊

dディレクトリ

p 名前付きパイプ (FIFO)

f 通常ファイル

l シンボリックリンク; これは、 -L オプションまたは -フォロー オプションがある
シンボリックリンクが壊れていない限り、実際には。 検索したい場合
シンボリック リンク -L 有効です。使用してください -xtype.

sソケット

D ドア (Solaris)

-uid n ファイルの数値ユーザー ID は n.

-中古 n
ファイルが最後にアクセスされました n ステータスが最後に変更されてからの日数。

-ユーザー uname
ファイルはユーザーが所有しています uname (数値のユーザー ID を使用できます)。

-姓 パターン
-path を参照してください。 この代替手段は、移植性が低くなります。 -道.

-書き込み可能
書き込み可能なファイルに一致します。 これは、アクセス制御リストと
他のパーミッション アーティファクト -パーマ テストは無視します。 このテストは
　 アクセス(2) システムコールであり、UID マッピングを行う NFS サーバーにだまされる可能性があります。
（またはルートスカッシング）、多くのシステムが実装しているため アクセス(2) クライアントのカーネル内
そのため、サーバーに保持されている UID マッピング情報を利用することはできません。

-xtype c
と同じ 型 ファイルがシンボリック リンクでない限り。 シンボリック リンクの場合:
-H or -P オプションが指定されました。ファイルが次のタイプのファイルへのリンクである場合は true c; もし
　 -L オプションが指定されている場合は true c l です。 つまり、シンボリック
リンク、 -xtype ファイルのタイプをチェックします 型 チェックしません。

-環境 パターン
(SELinux のみ) ファイルのセキュリティ コンテキストが glob と一致する パターン.

ACTIONS
-削除
ファイルを削除します。 削除が成功した場合は true。 削除に失敗した場合、エラー メッセージ
発行されます。 もしも -削除 失敗、 findの終了ステータスはゼロ以外になります (
最終的に終了します）。 の使用 -削除 ` を自動的にオンにします- 深さ'オプション。

警告: find コマンド ラインは式として評価されることを忘れないでください。
パッティング -削除 最初に作ります find 最初の下のすべてを削除してみてください
あなたが指定したポイント。 テストするとき find 後で実行するコマンド ライン
で使用 -削除、明示的に指定する必要があります - 深さ 後で避けるために
驚き。 なぜなら -削除 含意する - 深さ、あなたは便利に使うことができません -プルーン &
-削除 一緒に。

-EXEC command ;
実行する command; 0 ステータスが返される場合は true。 に続くすべての引数 find 　
`;' で構成される引数まで、コマンドの引数と見なされます。 は
遭遇した。 文字列 `{}' は、処理中の現在のファイル名に置き換えられます
コマンドの引数だけでなく、すべての引数で発生します。
一部のバージョンのように、それは単独です find. これらの構造の両方が必要になる場合があります
シェルによる展開から保護するためにエスケープ (`\' で) するか引用符で囲みます。
ジョブの設定方法については、 例 の使用例のセクション -EXEC オプション。 ザ·
指定されたコマンドは、一致したファイルごとに XNUMX 回実行されます。 コマンドはで実行されます
開始ディレクトリ。 使用を取り巻くセキュリティ上の問題は避けられない
-EXEC アクション; を使用する必要があります -execdir 代わりにオプション。

-EXEC command {} +
この亜種は、 -EXEC action は、選択されたファイルに対して指定されたコマンドを実行します。
ただし、コマンド ラインは、選択した各ファイル名を最後に追加することによって作成されます。 の
コマンドの呼び出しの総数は、
一致したファイル。 コマンド ラインは、 xargs 構築します
そのコマンドライン。 コマンド内で使用できる `{}' のインスタンスは XNUMX つだけです。 の
コマンドは開始ディレクトリで実行されます。 もしも find エラーが発生します。
すぐに終了する場合があるため、保留中のコマンドの一部が実行されない場合があります。
全て。 この変種の -EXEC 常に true を返します。

-execdir command ;

-execdir command {} +
いいね -EXEC、ただし、指定されたコマンドは、を含むサブディレクトリから実行されます
一致したファイル。これは通常、開始したディレクトリではありません find。 この
競合状態を回避するため、コマンドを呼び出すためのはるかに安全な方法
一致したファイルへのパスの解決中。 と同様に -EXEC アクション、
`+' 形式の -execdir 一致した複数を処理するコマンドラインを構築します
ファイルですが、特定の呼び出し command に存在するファイルのみを一覧表示します。
同じサブディレクトリ。 このオプションを使用する場合は、 $ PATH
環境変数が「.」を参照していません。 そうしないと、攻撃者は任意のプログラムを実行できます
適切な名前のファイルをディレクトリに残すことで、好きなコマンドを実行できます。
あなたは走ります -execdir. 同じことがエントリに適用されます $ PATH 空です
または絶対ディレクトリ名ではありません。 もしも find エラーが発生した場合、これは可能性があります
すぐに終了することがあるため、保留中のコマンドがまったく実行されない場合があります。
アクションの結果は、 + または ; バリアントが使用されています。
-execdir command {} + 常に true を返しますが、 -execdir command {} ; 真を返します
場合のみ command 0を返します。

-fls file
真実; お気に入り -ls しかし、に書く file ような -fprint. 出力ファイルは常に作成されます。
述語が決して一致しない場合でも。 を参照してください 普通でない ファイル名 のセクション
ファイル名の異常な文字がどのように処理されるかについての情報。

-fprint file
真実; 完全なファイル名を file に出力します file。 場合 file 存在しないとき find is
実行すると、作成されます。 存在する場合は切り捨てられます。 ファイル名
`/dev/stdout' と `/ dev / stderr' は特別に処理されます。 彼らは標準を参照します
それぞれ出力と標準エラー出力。 出力ファイルは常に作成されます。
述語が決して一致しない場合でも。 を参照してください 普通でない ファイル名 のセクション
ファイル名の異常な文字がどのように処理されるかについての情報。

-fprint0 file
真実; お気に入り -print0 しかし、に書く file ような -fprint. 出力ファイルは常に
述語がまったく一致しない場合でも作成されます。 を参照してください 普通でない ファイル名
ファイル名の異常な文字がどのように処理されるかについては、 を参照してください。

-fprintf file 形式でアーカイブしたプロジェクトを保存します．
真実; お気に入り -printf しかし、に書く file ような -fprint. 出力ファイルは常に
述語がまったく一致しない場合でも作成されます。 を参照してください 普通でない ファイル名
ファイル名の異常な文字がどのように処理されるかについては、 を参照してください。

-ls 真; 現在のファイルをリストする ls -ディル 標準出力でフォーマットします。 ブロック数
環境変数 POSIXLY_CORRECT が設定されていない限り、1K ブロックです。
ケース 512 バイトのブロックが使用されます。 を参照してください 普通でない ファイル名 情報セクション
ファイル名の特殊文字の扱いについて。

-Ok command ;
いいね -EXEC ただし、最初にユーザーに尋ねます。 ユーザーが同意する場合は、コマンドを実行します。 さもないと
false を返すだけです。 コマンドが実行されると、その標準入力はリダイレクトされます
/ dev / null.

プロンプトへの応答は、正規表現のペアに対して照合されます。
それが肯定的な反応か否定的な反応かを判断します。 この正規表現は
`POSIXLY_CORRECT' 環境変数が設定されている場合、システムから取得されます。
そうでなければ findのメッセージ翻訳。 システムに適切な機能がない場合
意味、 find独自の定義が使用されます。 いずれの場合も、
正規表現自体の解釈は環境の影響を受ける
変数 'LC_CTYPE' (文字クラス) および 'LC_COLLATE' (文字範囲と
同等クラス)。

-okdir command ;
いいね -execdir と同じ方法で最初にユーザーに尋ねます -Ok. ユーザーが行う場合
同意しない場合は、false を返します。 コマンドが実行される場合、その標準入力は
からリダイレクトされました / dev / null.

-真を印刷します。 完全なファイル名を標準出力に出力し、その後に改行を付けます。 もしも
あなたはの出力をパイプしています find 別のプログラムに入ると、最もかすかなプログラムがあります
検索しているファイルに改行が含まれている可能性があります。
次に、使用を真剣に検討する必要があります -print0 オプションの代わりに -印刷。 見る
　 普通でない ファイル名 異例の文字についてのセクション
ファイル名が処理されます。

-print0
真実; 標準出力に完全なファイル名を出力し、その後にヌル文字を出力します
(改行文字の代わりに -印刷 使用します）。 これにより、次のファイル名が許可されます。
によって正しく解釈されるように、改行またはその他の種類の空白を含める
を処理するプログラム find 出力。 このオプションは、 -0 のオプション
xargs.

-printf 形式でアーカイブしたプロジェクトを保存します．
真実; 印刷する 形式でアーカイブしたプロジェクトを保存します． 標準出力で、`\' エスケープと `%' を解釈します。
ディレクティブ。 フィールドの幅と精度は `printf' C と同じように指定できます。
関数。 多くのフィールドが %d ではなく %s として出力されることに注意してください。
これは、フラグが期待どおりに機能しないことを意味する場合があります。 これはまた、
`-' フラグは機能します (フィールドを強制的に左揃えにします)。 ようではない -印刷,
-printf 文字列の最後に改行を追加しません。 逃亡者と
ディレクティブは次のとおりです。

\a 警報ベル。

\b バックスペース。

\c この形式からの印刷を直ちに停止し、出力をフラッシュします。

\f フォーム フィード。

\ n改行。

\ rキャリッジリターン。

\ t水平タブ。

\v 垂直タブ。

\ 0 ASCIINUL。

\\リテラルの円記号（ `\ '）。

\NNN ASCII コードが NNN (XNUMX 進数) の文字。

`\ '文字の後に他の文字が続く場合は通常の文字として扱われます
文字なので、両方とも印刷されます。

％％リテラルのパーセント記号。

%a C の `ctime' 関数によって返される形式でのファイルの最終アクセス時間。

%Ak で指定された形式のファイルの最終アクセス時間 k、これは `@' または
C `strftime' 関数のディレクティブ。 可能な値 k 　
以下に記載されています; それらのいくつかは、すべてのシステムで利用できない場合があります。
システム間の「strftime」の違い。

@ 1 年 1970 月 00 日 00:XNUMX GMT からの秒数、小数部あり。

時間フィールド:

H 時間 (00..23)

私時間 (01..12)

k 時間 ( 0..23)

l 時間 ( 1..12)

M 分 (00..59)

p ロケールの AM または PM

r 時刻、12 時間 (hh:mm:ss [AP]M)

S 秒 (00.00 .. 61.00)。 端数部分があります。

T 時間、24 時間 (hh:mm:ss.)

+ 「+」で区切られた日付と時刻。たとえば、「2004-04-28+22:22:05.0」。
これは GNU 拡張です。 時間は現在のタイムゾーンで与えられます
(TZ 環境変数の設定によって影響を受ける可能性があります)。 の
秒フィールドには小数部分が含まれます。

X ロケールの時間表現 (H:M:S)。 秒フィールドには
小数部分。

Z タイム ゾーン (例: EDT)、またはタイム ゾーンが特定できない場合はなし

日付フィールド:

ロケールの省略された曜日名 (Sun..Sat)

ロケールの完全な曜日名、可変長 (Sunday..Saturday)

b ロケールの省略された月名 (Jan..Dec)

B ロケールの完全な月名、可変長 (January..December)

c ロケールの日時 (Sat Nov 04 12:02:33 EST 1989)。 フォーマットは
と同じ ctime（3）それとの互換性を維持するため
形式では、秒フィールドに小数部はありません。

d 日 (01..31)

D 日付 (mm/dd/yy)

h b と同じ

j 年間通算日 (001..366)

m 月 (01..12)

日曜日を週の最初の曜日とする U 週番号 (00..53)

w 曜日 (0..6)

月曜日を週の最初の曜日とする W 週番号 (00..53)

x ロケールの日付表現 (mm/dd/yy)

y 年の下 00 桁 (99..XNUMX)

Ｙ年（1970年～）

%b このファイルに使用されるディスク容量 (512 バイト ブロック単位)。 ディスク以来
スペースは、ファイルシステムのブロックサイズの倍数で割り当てられます。これは通常、
%s/512 より大きいですが、ファイルがスパースの場合は小さくなることもあります
ファイルにソフトウェアを指定する必要があります。

%c C の `ctime' によって返される形式のファイルの最終ステータス変更時間
機能。

%Ck で指定された形式のファイルの最終ステータス変更時間 k、これは
%A と同じです。

%d ディレクトリ ツリー内のファイルの深さ。 0 は、ファイルが開始点であることを意味します。

%D ファイルが存在するデバイス番号 (struct の st_dev フィールド
stat)、XNUMX 進数で。

%f 先頭のディレクトリを削除したファイルの名前 (最後の要素のみ)。

%F ファイルが存在するファイルシステムのタイプ。 この値は -fstype に使用できます。

%g ファイルのグループ名、またはグループに名前がない場合は数値のグループ ID。

%G ファイルの数値グループ ID。

%h ファイル名の先頭ディレクトリ (最後の要素を除くすべて)。 ファイルの場合
name にはスラッシュが含まれていません (現在のディレクトリにあるため) %h
指定子は "." に展開されます。

%H ファイルが見つかった開始点。

%i ファイルの i ノード番号 (XNUMX 進数)。

%k このファイルに使用されているディスク容量 (1K ブロック単位)。 ディスク容量
ファイルシステムのブロックサイズの倍数で割り当てられます。これは通常、
%s/1024 より大きいですが、ファイルがスパースの場合は小さくなることもあります
ファイルにソフトウェアを指定する必要があります。

%l シンボリック リンクのオブジェクト (ファイルがシンボリック リンクでない場合は空の文字列)。

%m ファイルの許可ビット (XNUMX 進数)。 このオプションは「従来の」
ほとんどの Unix 実装が使用する数値ですが、特定の場合
実装が XNUMX 進数のパーミッション ビットの通常とは異なる順序を使用している場合、
ファイルのモードの実際の値と出力の違いを確認する
%mの。 通常、この数値の先頭に XNUMX を付けたいと思うでしょう。
これを行うには、 # フラグ (たとえば、`%#m' など)。

%M ファイルのパーミッション (シンボリック形式で、 ls）。 このディレクティブは
findutils 4.2.5 以降でサポートされています。

%n ファイルへのハード リンクの数。

%p ファイルの名前。

%P ファイルが見つかった開始点の名前を持つファイルの名前
除去された。

％sファイルのサイズ（バイト単位）。

%S ファイルのスパース性。 これは (BLOCKSIZE*st_blocks / st_size) として計算されます。
特定の長さの通常のファイルに対して得られる正確な値は次のとおりです。
システム依存。 ただし、通常、スパース ファイルの値は
1.0、および間接ブロックを使用するファイルは、より大きな値を持つ場合があります
1.0より。 BLOCKSIZE に使用される値はシステムに依存しますが、通常は
512 バイト。 ファイル サイズがゼロの場合、出力される値は未定義です。 の上
st_blocks をサポートしていないシステムでは、ファイルのスパース性は
1.0になります。

%t C の `ctime' によって返される形式でのファイルの最終更新時刻
機能。

%Tk で指定された形式のファイルの最終変更時刻 k、これは
%A と同じです。

%u ファイルのユーザー名、またはユーザーに名前がない場合は数値のユーザー ID。

%U ファイルの数値ユーザー ID。

%y ファイルの種類 ( ls -l)、U=未知の型 (起こらないはずです)

%Y ファイルのタイプ (%y など)、およびシンボリック リンクをたどる: L=ループ、N=存在しない

%Z (SELinux のみ) ファイルのセキュリティ コンテキスト。

%{ %[ %(
将来使用するために予約されています。

他の文字が続く `%' 文字は破棄されますが、他の文字は破棄されます。
文字が印刷されます (これに依存しないでください。さらにフォーマット文字が表示される可能性があります
紹介された）。 フォーマット引数の末尾にある `%' は、未定義の動作を引き起こします
次のキャラがいないので。 一部のロケールでは、ドアが隠れる場合があります
キー、他のものでは、読んでいる小説から最後のページを削除する場合があります。

%m および %d ディレクティブは、 # , 0 & + フラグですが、他のディレクティブはそうします
数字を出力したとしても、そうではありません。 これらをサポートしない数値ディレクティブ
フラグが含まれます G, U, b, D, k & n. `-' フォーマット フラグがサポートされ、変更されます
右寄せ (デフォルト) から左寄せへのフィールドの位置合わせ
正当化されます。

ジョブの設定方法については、 普通でない ファイル名 異例の文字についてのセクション
ファイル名が処理されます。

-True を削除します。 ファイルがディレクトリの場合は、そのディレクトリに降りないでください。 もしも - 深さ 与えられる、
間違い; 無効。 なぜなら -削除 含意する - 深さ、あなたは便利に使うことができません -プルーン
& -削除 一緒に。

-quit すぐに終了します。 子プロセスが実行されたままになることはありませんが、それ以上のパスはありません
コマンドラインで指定されたものは処理されます。 例えば、 find / tmp / foo
/tmp/バー -印刷 -終了する 印刷のみします / tmp / foo. されているすべてのコマンド ライン
で構築された -execdir ... {} + 前に呼び出されます find 終了します。 出口
status は、エラーがすでに発生しているかどうかによって、ゼロになる場合とそうでない場合があります。

オペレーター
優先度の低い順にリストされています。

( 式 )
強制優先。 括弧はシェルにとって特別なものなので、通常は
それらを引用する必要があります。 このマニュアルページの例の多くは、バックスラッシュを使用して
この目的: `(...)' の代わりに `\(...\)'。

! 式 Trueの場合 式 は偽です。 このキャラクターは通常、以下からの保護も必要です。
シェルによる解釈。

-ではありません 式
と同じ ！ 式、ただし POSIX 準拠ではありません。

式1 式2
連続する XNUMX つの式は、暗黙の「and」で結合されていると見なされます。 式2 ではありません
評価される場合 式1 は偽です。

式1 -a 式2
と同じ 式1 式2.

式1 -そして 式2
と同じ 式1 式2、ただし POSIX 準拠ではありません。

式1 -o 式2
ゴールド; 式2 次の場合は評価されません 式1 本当です。

式1 または 式2
と同じ 式1 -o 式2、ただし POSIX 準拠ではありません。

式1 , 式2
リスト; 両方 式1 & 式2 常に評価されます。 の値 式1 破棄されます。
リストの値はの値です 式2. コンマ演算子は次の場合に役立ちます
いくつかの異なる種類のものを検索しますが、ファイルシステムをトラバースします
階層は一度だけ。 の -fprintf アクションを使用して、一致したさまざまなリストを表示できます
アイテムをいくつかの異なる出力ファイルに。

ということに注意してください -a 暗黙的に指定された場合 (たとえば、XNUMX つのテストが指定されていない場合)
それらの間の明示的な演算子) または明示的に -o。 この
という意味です find . -名前 ファイル -o -名前 bファイル -印刷 絶対に印刷しない ファイル.

普通でない ファイル名

の行動の多くは find の制御下にあるデータの印刷をもたらす
他のユーザー。 これには、ファイル名、サイズ、変更時刻などが含まれます。 ファイル
名前には、`\0' と `/' 以外の任意の文字を含めることができるため、問題が発生する可能性があります。
ファイル名に通常とは異なる文字が含まれていると、予期せず、多くの場合望ましくないことがファイル名に発生する可能性があります。
(たとえば、一部の端末でファンクション キーの設定を変更するなど)。
以下に説明するように、異常な文字はさまざまなアクションによって異なる方法で処理されます。

-print0、-fprint0
出力先が
ターミナル。

-ls、-fls
特殊な文字は常にエスケープされます。 空白、バックスラッシュ、および二重引用符
文字は C スタイルのエスケープを使用して出力されます (たとえば、`\f'、`\"')。
通常とは異なる文字は、XNUMX 進エスケープを使用して表示されます。 その他の印字可能文字
（ために -ls & -fls これらは 041 進数の 0176 から XNUMX までの文字です) が出力されます
そのまま。

-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 スクリプトまたは一致したファイルが任意のファイルを持つ可能性がある状況で
名前、使用を検討する必要があります -print0 -印刷.

　 -Ok & -okdir アクションは、現在のファイル名をそのまま出力します。 これは将来変更される可能性があります
リリース。

規格 適合性

POSIX 標準に最も準拠するには、POSIXLY_CORRECT を設定する必要があります。
環境変数。 次のオプションは、POSIX 標準 (IEEE Std
1003.1、2003 年版):

-H このオプションはサポートされています。

-L このオプションはサポートされています。

-名前 このオプションはサポートされていますが、POSIX 準拠は の POSIX 準拠に依存します。
システムの fnmatch(3) ライブラリ機能。 findutils-4.2.2 以降、シェル
メタ文字 (`*'、`?'、`[]' など) は先頭の `.' に一致します。
IEEE PASC 解釈 126 はこれを要求します。 これは以前からの変更点です
findutils のバージョン。

型 サポートされています。 POSIX では、「b」、「c」、「d」、「l」、「p」、「f」、および「s」が指定されています。 GNUも見つける
OS がこれらを提供するドアを表す `D' をサポートします。

-Ok サポートされています。 回答の解釈は「はい」と「いいえ」による
`LC_MESSAGES' 環境変数を設定することによって選択されたパターン。 とき
`POSIXLY_CORRECT' 環境変数が設定され、これらのパターンはシステムの
肯定的 (はい) または否定的 (いいえ) の応答の定義。 システムの
のドキュメント nl_langinfo(3)、特に YESEXPR と NOEXPR。 いつ
`POSIXLY_CORRECT' が設定されていない場合、パターンは代わりに find自分のもの
メッセージカタログ。

-新しい サポートされています。 指定されたファイルがシンボリック リンクの場合、常に逆参照されます。
これは、以前の動作からの変更です。
シンボリックリンク; 以下の歴史セクションを参照してください。

-パーマ サポートされています。 POSIXLY_CORRECT 環境変数が設定されていない場合、いくつかのモード
POSIX で無効な引数 (+a+x など) がサポートされています。
下位互換性。

その他の述語
述語 -時間, -ctime, - 深さ, -グループ, -リンク, - ファイルのmtime, -グループなし, -ノーザー,
-印刷, -プルーン, -サイズ, -ユーザー & -xdev `-atime', `-ctime', `-depth', `-group',
`-links', `-mtime', `-nogroup', `-nouser', `-perm', `-print', `-prune', `-size',
`-user' と `-xdev' はすべてサポートされています。

POSIX 標準では、括弧 `('、`)'、否定 `!' が指定されています。 そして「and」と「or」
演算子 ( -a, -o).

他のすべてのオプション、述語、式などは、POSIX を超える拡張です。
標準。 ただし、これらの拡張機能の多くは GNU find に固有のものではありません。

POSIX 標準では、 find ループを検出します:

　 find ユーティリティは無限ループを検出します。 つまり、以前に
最後に遭遇したファイルの先祖である訪問済みディレクトリ。 いつ
find は無限ループを検出し、診断メッセージを標準エラーに書き込みます。
そして、階層内のその位置を回復するか、終了する必要があります。

GNU find これらの要件に準拠しています。 を含むディレクトリのリンク数
祖先へのハードリンクであるエントリは、そうでない場合よりも低くなることがよくあります
なれ。 これは、GNU find がときどき、
実際には祖先へのリンクであるサブディレクトリ。 以来 find 実際に入らない
このようなサブディレクトリでは、診断メッセージの発行を回避できます。 これは
動作はやや混乱するかもしれませんが、実際にこれに依存している人はほとんどいません
行動。 葉の最適化がオフになっている場合 -ノリーフ、ディレクトリ エントリ
常に検査され、適切な場合に診断メッセージが発行されます。
シンボリック リンクを使用してファイル システム サイクルを作成することはできませんが、 -L オプションまたは
　 -フォロー オプションが使用中の場合、診断メッセージが発行されます。 find ループに遭遇
シンボリックリンクの。 ハードリンクを含むループと同様に、リーフの最適化はしばしば
つまり find 呼び出す必要がないことを知っています stat（） or chdir（） シンボリックリンクで、
したがって、この診断は多くの場合必要ありません。

　 -d オプションは、さまざまな BSD システムとの互換性のためにサポートされていますが、使用する必要があります
POSIX 準拠のオプション - 深さ を代わりにお使いください。

POSIXLY_CORRECT 環境変数は、 -正規表現 or
-irex これらのテストは POSIX 標準で指定されていないためです。

ENVIRONMENT 変数

LANG 設定されていない、または設定されていない国際化変数のデフォルト値を提供します。
ヌル。

LC_ALL 空でない文字列値に設定されている場合、他のすべての値をオーバーライドします。
国際化変数。

LC_COLLATE
POSIX 標準では、この変数がパターン マッチングに影響を与えることを指定しています。
に使用 -名前 オプション。 GNU find は fnmatch(3) ライブラリ機能など
`LC_COLLATE' のサポートは、システム ライブラリに依存します。 この変数も
への応答の解釈に影響を与える -わかった; 一方、'LC_MESSAGES' 変数
への応答を解釈するために使用される実際のパターンを選択します -Ok
パターン内のブラケット式の解釈は、次の影響を受けます。
`LC_COLLATE'.

LC_CTYPE
この変数は、通常の文字クラスで使用される文字クラスの扱いに影響します。
式と -名前 システムの場合、テストします fnmatch(3) 図書館
関数はこれをサポートします。 この変数は、
への応答を解釈するために使用される正規表現の文字クラス
によって発行されたプロンプト -Ok. `LC_CTYPE' 環境変数も影響します。
ファイル名が印刷されるとき、文字は印刷できないと見なされます。 を参照してください
セクション 珍しいファイル名。

LC_MESSAGES
国際化されたメッセージに使用するロケールを決定します。 もし
`POSIXLY_CORRECT' 環境変数が設定されている場合、これはまた、
によって行われたプロンプトへの応答の解釈 -Ok をご利用ください。

NLSパス
国際化メッセージ カタログの場所を決定します。

PATH によって呼び出される実行可能ファイルを見つけるために検索されるディレクトリに影響します。
-EXEC, -execdir, -Ok & -okdir.

POSIXLY_CORRECT
によって使用されるブロック サイズを決定します。 -ls & -fls。 場合 POSIXLY_CORRECT 設定され、ブロック
512バイト単位です。 それ以外の場合は、1024 バイト単位です。

この変数を設定すると、警告メッセージもオフになります (つまり、 -ノワーン）によって
デフォルト、POSIX は出力とは別にそれを要求するため -Ok、すべてのメッセージ
stderr に出力されるのは診断であ​​り、ゼロ以外の終了ステータスになる必要があります。

POSIXLY_CORRECT が設定されていない場合、 -パーマ +zzz は同様に扱われます -パーマ /zzz の場合 +zzz
は有効な記号モードではありません。 POSIXLY_CORRECT が設定されている場合、そのような構造は
エラーとして扱われます。

POSIXLY_CORRECT が設定されている場合、 -Ok アクションは
に従ってではなく、システムのメッセージ カタログに従って解釈されます。
find独自のメッセージ翻訳。

TZ の時間関連のフォーマット ディレクティブの一部に使用されるタイム ゾーンに影響します。
-printf & -fprintf.

例

find / tmpに -名前 型 f -印刷 | xargs /bin/rm -f

という名前のファイルを検索します ディレクトリ内またはその下にある / tmpに そしてそれらを削除します。 これにより、
改行、一重引用符または二重引用符を含むファイル名があると、正しく動作しません。
またはスペース。

find / tmpに -名前 型 f -print0 | xargs -0 /bin/rm -f

という名前のファイルを検索します ディレクトリ内またはその下にある / tmpに ファイル名を処理してそれらを削除します
一重引用符または二重引用符、スペース、または
改行は正しく処理されます。 の -名前 テストはその前に来る 型 するためにテストする
電話するのを避ける STAT(2) すべてのファイルで。

find . 型 f -EXEC file 「{}」 \;

現在のディレクトリ内またはその下にあるすべてのファイルに対して「file」を実行します。 ブレースが
シェルスクリプトとして解釈されないように一重引用符で囲みます
句読点。 セミコロンも同様にバックスラッシュを使用して保護されていますが、
その場合も一重引用符を使用できます。

find / \( -パーマ -4000 -fprintf /root/suid.txt '%#分 %u %p\n' \) , \
\( -サイズ + 100M -fprintf /root/big.txt '%-10s %p\n' \)

ファイルシステムを一度だけトラバースし、setuid ファイルとディレクトリを
/root/suid.txt 大きなファイルを /root/big.txt.

find $ HOME - ファイルのmtime 0

過去 XNUMX 年間に変更されたホーム ディレクトリ内のファイルを検索します。
時間。 各ファイルが最後に変更されてからの時間が
を 24 時間で割った余りは破棄されます。 一致するということは - ファイルのmtime 0
ファイルには、24 時間以内の過去の変更が必要です。

find / sbin / usr / sbin -実行可能 \! -可読性 -印刷

実行可能だが読み取り不可能なファイルを検索します。

find . -パーマ 664

所有者とグループに読み取りと書き込みのアクセス許可があるファイルを検索しますが、
他のユーザーが読み取ることはできますが、書き込むことはできません。 これらの基準を満たしているが、
他の許可ビットが設定されている (たとえば、誰かがファイルを実行できる場合)
一致した。

find . -パーマ -664

所有者とグループに読み取りと書き込みのアクセス許可があるファイルを検索します。
他のユーザーは、余分な許可ビットの存在に関係なく読み取ることができます (
たとえば、実行可能ビット)。 これは、たとえば、モードが 0777 のファイルに一致します。

find . -パーマ / 222

誰か (所有者、グループ、または誰でも) が書き込み可能なファイルを検索する
そうしないと）。

find . -パーマ / 220
find . -パーマ /u+w,g+w
find . -パーマ /u=w,g=w

これら XNUMX つのコマンドはすべて同じことを行いますが、最初のコマンドは XNUMX 進数を使用します。
ファイル モードの表現であり、他の XNUMX つは記号形式を使用します。 これらのコマンド
all は、所有者またはグループのいずれかが書き込み可能なファイルを検索します。 ファイル
一致するために、所有者とグループの両方が書き込み可能である必要はありません。 どちらでも構いません。

find . -パーマ -220
find . -パーマ -g+w、u+w

これらのコマンドはどちらも同じことを行います。 両方で書き込み可能なファイルを検索します
所有者とそのグループ。

find . -パーマ -444 -パーマ / 222 ! -パーマ / 111
find . -パーマ -a+r -パーマ /a+w ! -パーマ /a+x

これら XNUMX つのコマンドはどちらも、誰でも読み取り可能なファイルを検索します ( -パーマ -444 or
-パーマ -a+r)、少なくとも XNUMX つの書き込みビットが設定されている ( -パーマ / 222 or -パーマ /a+w) しかしそうではない
誰でも実行可能 ( ! -パーマ / 111 & ! -パーマ /a+x それぞれ）。

cd /ソースディレクトリ
find . -名前 .スナップショット -プルーン -o \( \! -名前 *~ -print0 \)|
cpio -pmd0 /dest-dir

このコマンドは、 /ソースディレクトリ 〜へ /dest-dir、ただしファイルと
名前付きディレクトリ .スナップショット （およびそれらのすべて）。 また、ファイルまたはディレクトリを省略します
で終わる名前 ~、しかしその内容ではありません。 コンストラクト -プルーン -o \( ... -print0 \)
は非常に一般的です。 ここでの考え方は、前の式が -プルーン 一致するもの
剪定されます。 しかし -プルーン アクション自体は true を返すため、次のようになります -o
取得できなかったディレクトリに対してのみ右側が評価されるようにします
pruned (整理されたディレクトリの内容はアクセスさえされないため、その内容は
無関係）。 の右側の式 -o のみ括弧内にある
明快さ。 それは、 -print0 アクションは、実行されなかったものに対してのみ行われます
持ってる -プルーン それらに適用されます。 テスト間のデフォルトの「and」条件がより多くをバインドするため
よりもしっかりと -o、とにかくこれがデフォルトですが、括弧は何が何であるかを示すのに役立ちます
起こっています。

find レポ/ -EXEC test -d {}/.svn \; または \
-EXEC test -d {}/。ギット \; または -EXEC test -d {}/CVS \; \
-印刷 -プルーン

次のプロジェクトのディレクトリと、それに関連付けられた SCM 管理を考える
ディレクトリ、プロジェクトのルートの効率的な検索を実行します。

レポ/プロジェクト1/CVS
レポ/gnu/project2/.svn
レポ/gnu/project3/.svn
レポ/gnu/project3/src/.svn
レポ/project4/.git

この例では、 -プルーン すでに存在するディレクトリへの不必要な下降を防ぎます。
発見されました (たとえば、すでに見つかっているため、project3/src は検索しません
project3/.svn) ですが、兄弟ディレクトリ (project2 と project3) が確実に見つかります。

EXIT ステータス

find すべてのファイルが正常に処理された場合はステータス 0 で終了し、エラーの場合は 0 より大きいステータスで終了します
発生する。 これは意図的に非常に大まかな説明ですが、戻り値が
ゼロ、あなたはの結果の正確さに頼るべきではありません find.

何らかのエラーが発生した場合、 find すべてのアクションを完了せずに、すぐに停止する可能性があります
指定。 たとえば、一部の開始点が調査されていないか、保留中の可能性があります
のプログラム呼び出し -EXEC ... {} + or -execdir ... {} + 実行されていない可能性があります。

onworks.net サービスを使用してオンライン検索を使用する