plocate - ファイル名を検索し、高速に実行
SYNOPSIS
plocate [OPTION]... PATTERN...
DESCRIPTION
plocate は、システム上の指定されたパターン (または複数のパターンがある場合はすべてのパターン) に一致するすべてのファイルを見つけます。 これは、`updatedb(8)` によって作成されたインデックス、または (あまり一般的ではありませんが) `plocate-build(8)` によって別のインデックスから変換されたインデックスを使用して行われます。
plocate は、`mlocate(1)` とほぼ同じ引数を使用できますが、大幅に高速です。 特に、パターンが非常に短い (3 バイト未満) か、正規表現で検索する場合を除いて、データベース全体をスキャンする必要はほとんどありません。 BSD `locate`、または UTF-8 以外のファイル名やロケールとの互換性を維持しようとはしません。 ほとんどの I/O は非同期で行われますが、結果は同期されるため、出力は毎回同じ順序で表示されます。
複数のパターンが与えられた場合、plocate はそれらすべてのパターンに一致するファイルを探します。
これは mlocate(1) との主な非互換性であり、mlocate(1) は -A オプションが与えられない限り、1 つ以上のパターンに一致するファイルを検索します。
デフォルトでは、パターンは検索するサブ文字列と見なされます。 少なくとも 1 つのエスケープされていないグロビングメタ文字 (*、?、または []) が与えられた場合、そのパターンは代わりにグロブパターンと見なされます (これは、サブ文字列一致にするには、先頭と末尾に * が必要であることを意味します)。 --regexp が与えられた場合、パターンは代わりに (アンカーされていない) POSIX 基本正規表現と見なされ、--regex が与えられた場合、パターンは POSIX 拡張正規表現と見なされます。 これらすべてが mlocate(1) の動作と一致します。
`mlocate(1)` と同様に、plocate は、呼び出しユーザーがすべての親ディレクトリに対して読み取りおよび実行のアクセス許可を持っているため、表示されるすべてのファイルを表示し、そうでないファイルは表示しません。 これは、インデックスをルートとして実行し、呼び出しユーザーとして可視性をテストすることによって行われます。
EXIT STATUS
plocate は、一致が見つかった場合、または `--help` または `--version` が渡された場合に、0 を返して終了します。
それ以外の場合、plocate はステータスコード 1 を返して終了し、エラーが発生したか、一致するものが見つからなかったことを示します。
OPTIONS
-A, --all
`mlocate(1)` との互換性のために無視されます。
-b, --basename
パス名のファイル名部分に対してのみ一致するようにします。つまり、ディレクトリ名は一致から除外されます (ただし、それでも出力されます)。 これは検索を高速化するわけではありませんが、興味のない一致を抑制する可能性があります。
-c, --count
各一致を出力する代わりに、一致するものをカウントし、最後に合計数を表示します。
-d, --database DBPATH
`/var/lib/plocate/plocate.db` ではなく、指定されたデータベースで一致するものを見つけます。 この引数は複数回指定して、複数のデータベースを検索できます。 また、1 つの引数で複数のデータベースを指定することもできます。データベースは `:` で区切ります `\`。 (すべての文字 ( `:` と `\` を含む) は、先頭に `\` を付けてエスケープできます。)
-e, --existing
locateを実行する時点でファイルが存在するエントリのみを出力します。ただし、mlocate(1)とは異なり、シンボリックリンクはデフォルトでたどされず（また、これを変更するオプションもありません）。
-i, --ignore-case
現在のロケールで指定された大文字と小文字を区別しないマッチを行います（デフォルトは大文字と小文字を区別する、バイト単位のマッチです）。plocateは、完全なUnicodeの大文字と小文字の変換ルールをサポートしていないことに注意してください。特に、ドイツ語ロケールでも、ßを検索してもssに一致する結果は返されません。また、このオプションは、より多くの検索候補を生成する必要があるため、大文字と小文字を区別するマッチよりもいくらか遅くなります。
-l, --limit LIMIT
LIMIT個のマッチが見つかった時点で検索を停止します。--countが指定されている場合、出力される数は最大でLIMITになります。
-N, --literal
エントリ名を引用符なしで出力します。通常、plocateは、一般的なシェルで安全に使用できるように、ファイル名の特殊文字をエスケープします（GNU coreutilsのshell-escape-always quotingスタイルに類似）、ただしパイプに出力する場合は、このオプションにより、そのような引用符がオフになります。
-0, --null
各マッチの後に改行を書き込む代わりに、NULL（ASCII 0）を書き込みます。これにより、ファイル名に埋め込まれた改行が含まれている場合でも、他のツール（xargs(1)など）で処理できるように、曖昧さのない出力を生成できます。
-r, --regexp
パターンはPOSIX基本正規表現として扱われます。詳細については、regex(7)を参照してください。このオプションを使用すると、データベース全体を線形的にスキャンするため、処理が遅くなります。
--regex
-r, --regexpと同様ですが、パターンはPOSIX拡張正規表現として扱われます。
-w, --wholename
パス名全体に対してマッチします。これはデフォルトの動作であり、-bが最初に指定されない限り、何も行いません。したがって、このオプションはmlocate(1)との互換性のためにのみ存在します。
--help
使用方法に関する情報を出力し、正常に終了します。
--version
バージョン情報を出力し、正常に終了します。
環境変数
LOCATE_PATH
指定された場合、明示的に指定されたパス（またはデフォルトのパス）の後に、このパスが追加されます。コロンで区切り、文字のエスケープは、--databaseオプションと同様のルールに従います。
著者
Steinar H. Gunderson <\_\>
関連項目
plocate-build(8), mlocate(1), updatedb(8)