[原文] .TH LOCATE 1 \" -*- nroff -*- [訳文] .TH LOCATE 1 ---------------------------------------- [原文] .SH NAME locate - list files in databases that match a pattern . [訳文] .SH 名前 locate - ファイル名データベースからパターンに合うものを表示する . ---------------------------------------- [原文] .SH SYNOPSIS .B locate [-d path | --database=path] [-e | -E | --[non-]existing] [-i | --ignore-case] [-0 | --null] [-c | --count] [-w | --wholename] [-b | --basename] [-l N | --limit=N] [-S | --statistics] [-r | --regex ] [--regextype R] [--max-database-age D] [-P | -H | --nofollow] [-L | --follow] [--version] [-A | --all] [-p | --print] [--help] pattern... . [訳文] .SH 書式 locate [-d path | --database=path] [-e | -E | --[non-]existing] [-i | --ignore-case] [-0 | --null] [-c | --count] [-w | --wholename] [-b | --basename] [-l N | --limit=N] [-S | --statistics] [-r | --regex ] [--regextype R] [--max-database-age D] [-P | -H | --nofollow] [-L | --follow] [--version] [-A | --all] [-p | --print] [--help] pattern... . ---------------------------------------- [原文] .SH DESCRIPTION This manual page documents the GNU version of .BR locate . For each given pattern, .B locate searches one or more databases of file names and displays the file names that contain the pattern. Patterns can contain shell-style metacharacters: `*', `?', and `[]'. The metacharacters do not treat `/' or `.' specially. Therefore, a pattern `foo*bar' can match a file name that contains `foo3/bar', and a pattern `*duck*' can match a file name that contains `lake/.ducky'. Patterns that contain metacharacters should be quoted to protect them from expansion by the shell. [訳文] .SH 説明 このマニュアルページは GNU 版 locate の使用法を説明しています。 locate は、 指定された各パターンに対して、 一つまたは複数のファイル名データベースを検索して、パターンに 一致するファイル名を表示します。 パターンには、 シェルで用いるようなメタキャラクター (`*', `?' 及び `[]') が利用できます。 メタキャラクターは `/' や `.' を特別扱いしません。 したがって `foo*bar' というパターンは、 `foo3/bar' というファイル名に一致します。 また `*duck*' というパターンは、 `lake/.ducky' に一致します。 メタキャラクターを含むパターンは、 シェルによって展開されないようにクォートで囲む必要があります 。 ---------------------------------------- [原文] .P If a pattern is a plain string \(em it contains no metacharacters \(em .B locate displays all file names in the database that contain that string anywhere. If a pattern does contain metacharacters, .B locate only displays file names that match the pattern exactly. As a result, patterns that contain metacharacters should usually begin with a `*', and will most often end with one as well. The exceptions are patterns that are intended to explicitly match the beginning or end of a file name. [訳文] .P パターンが通常の文字列である場合、 つまりメタキャラクターを含んでいない場合、 locate は、 ファイル名のどこかにその文字列が含まれているようなファイルを すべて表示します。 パターンにメタキャラクターが含まれる場合、 locate は、 パターンに一致するファイル名だけを表示します。 このことから、 メタキャラクターを含むパターンには、 通常は先頭に `*' をつけておいてください。 同じように、最後にもたいていは `*' をつけておきます。 ただしファイル名の先頭または最後に、 意図的に一致させたいパターンとするのであれば、 その必要はありません。 ---------------------------------------- [原文] .P The file name databases contain lists of files that were on the system when the databases were last updated. The system administrator can choose the file name of the default database, the frequency with which the databases are updated, and the directories for which they contain entries; see updatedb(1). [訳文] .P ファイル名データベースは、最後に更新された時点において、シス テムに存在していたファイルのリストからなっている。システム管 理者はデフォルトで用いるデータベースのファイル名や更新の頻度 、またどのディレクトリの情報をデータベースに入れるかなどを選 択することができる。updatedb(1) を見よ。 ---------------------------------------- [原文] .P If .BR locate 's output is going to a terminal, unusual characters in the output are escaped in the same way as for the -print action of the .B find command. If the output is not going to a terminal, file names are printed exactly as-is. . [訳文] .P locate は端末に対して出力を行ないます。 出力に適さない文字はエスケープ出力されます。 これは find コマンドの -print 処理と同様にして行われます。 出力先が端末でない場合、ファイル名はその文字のまま出力されま す。 . ---------------------------------------- [原文] .SH OPTIONS [訳文] .SH オプション ---------------------------------------- [原文] .TP .I "-0, --null" Use ASCII NUL as a separator, instead of newline. [訳文] .TP -0, --null 区切り文字として、改行文字ではなく ASCII NUL 文字を用います。 ---------------------------------------- [原文] .TP .I "-A, --all" Print only names which match all non-option arguments, not those matching one or more non-option arguments. [訳文] .TP -A, --all 必須の引数すべてに一致する名前のみを表示します。 つまりすべてに一致せず、1 つやその一部にのみに一致するものは表示しません。 ---------------------------------------- [原文] .TP .I "-b, --basename" Results are considered to match if the pattern specified matches the final component of the name of a file as listed in the database. This final component is usually referred to as the `base name'. [訳文] .TP -b, --basename 指定されたパターンが、データベース内にあるファイル名の最後の 構成要素に一致した場合に、出力結果として一致したものとします 。 最後の構成要素は、通常「ベース名」と表現されます。 ---------------------------------------- [原文] .TP .I "-c, --count" Instead of printing the matched filenames, just print the total number of matches we found, unless --print (-p) is also present. [訳文] .TP -c, --count 一致したファイル名を出力するのではなく、一致した総数を出力し ます。 ただし --print (-p) も指定された場合は除きます。 ---------------------------------------- [原文] .TP .I "-d path, --database=path" Instead of searching the default file name database, search the file name databases in path, which is a colon-separated list of database file names. You can also use the environment variable .B LOCATE_PATH to set the list of database files to search. The option overrides the environment variable if both are used. Empty elements in the path are taken to be synonyms for the file name of the default database. A database can be supplied on stdin, using `-' as an element of path. If more than one element of path is `-', later instances are ignored (and a warning message is printed). [訳文] .TP -d path, --database=path デフォルトのファイル名データベースを検索するのではなく、path にあるファイル名データベースを検索します。 複数のデータベースファイルは、 コロンで区切って指定します。 環境変数 LOCATE_PATH を利用して、検索するデータベースファイルを指定することもでき ます。 オプションと環境変数がともに指定された場合は、オプションが優 先されます。 パス指定に空の要素が指定された場合は、デフォルトのデータベー スファイル名と同義であるものとして扱われます。 データベースは stdin から指定することもできます。 これを行う場合は path の要素として `-' を利用します。 path の構成要素に複数の `-' が指定されていた場合、2 つめ以降は無視されます (そして警告メッセージが出力されます)。 ---------------------------------------- [原文] .IP The file name database format changed starting with GNU .B find and .B locate version 4.0 to allow machines with different byte orderings to share the databases. This version of .B locate can automatically recognize and read databases produced for older versions of GNU .B locate or Unix versions of .B locate or .BR find . Support for the old locate database format will be discontinued in a future release. [訳文] .IP ファイル名データベースのフォーマットは、 GNU find と locate のバージョン 4.0 から変更されました。 このフォーマットによって、 バイトオーダーが異なるマシン間においても、 データベースが共有できるようになりました。 locate の本バージョンでは、 GNU locate の旧バージョン、 あるいは Unix バージョンの locate や find を自動的に識別して読み込みを行ないます。 古い locate のデータベースフォーマットへのサポートは、 今後のリリースにおいては継続しません。 ---------------------------------------- [原文] .TP .I "-e, --existing" Only print out such names that currently exist (instead of such names that existed when the database was created). Note that this may slow down the program a lot, if there are many matches in the database. If you are using this option within a program, please note that it is possible for the file to be deleted after .B locate has checked that it exists, but before you use it. [訳文] .TP -e, --existing 現在存在している名前のみを表示します (データベースが生成された際に存在していた名前を表示するわけ ではありません)。 なおデータベース内に一致する名前が多数存在していると、 プログラム処理速度が多少低下することがあります。 プログラム内においてこのオプションを利用している場合は、 locate がチェックした後のファイルは、 削除されてしまい、 確認できないことがある点に注意してください。 ---------------------------------------- [原文] .TP .I "-E, --non-existing" Only print out such names that currently do not exist (instead of such names that existed when the database was created). Note that this may slow down the program a lot, if there are many matches in the database. [訳文] .TP -E, --non-existing 現在存在していない名前のみを表示します (データベースが生成された際に存在していた名前を表示するので はありません)。 なおデータベース内に一致する名前が多数存在していると、 プログラム処理速度が多少低下することがあります。 ---------------------------------------- [原文] .TP .I "--help" Print a summary of the options to .B locate and exit. [訳文] .TP --help locate のオプション概要を表示して終了します。 ---------------------------------------- [原文] .TP .I "-i, --ignore-case" Ignore case distinctions in both the pattern and the file names. [訳文] .TP -i, --ignore-case パターンとファイル名において、 英字の大文字小文字を区別しません。 ---------------------------------------- [原文] .TP .I "-l N, --limit=N" Limit the number of matches to N. If a limit is set via this option, the number of results printed for the -c option will never be larger than this number. [訳文] .TP -l N, --limit=N 一致する数を N に制限します。 制限数を本オプションにより設定した場合、 -c オプションによって表示される結果数は、 本オプションの値を上回ることはありません。 ---------------------------------------- [原文] .TP .I "-L, --follow" If testing for the existence of files (with the -e or -E options), consider broken symbolic links to be non-existing. This is the default. [訳文] .TP -L, --follow (-e や -E オプションとともに使って) ファイルの存在チェックを行う場合、 シンボリックリンクが壊れている場合には、 存在していないものとして扱います。 これはデフォルトの動作です。 ---------------------------------------- [原文] .TP .I "--max-database-age D" Normally, .B locate will issue a warning message when it searches a database which is more than 8 days old. This option changes that value to something other than 8. The effect of specifying a negative value is undefined. [訳文] .TP --max-database-age D 通常 locate は、 検索するデータベースが 8 日以上古かった場合に、 警告メッセージを表示します。 このオプションは、 その日数を 8 日以外のものに設定する場合に用います。 負数を指定した場合の動作は未定です。 ---------------------------------------- [原文] .TP .I "-m, --mmap" Accepted but does nothing, for compatibility with BSD .BR locate . [訳文] .TP -m, --mmap 指定可能ですが、 ただし何も行いません。 これは BSD 版の locate との互換性のために存在しています。 ---------------------------------------- [原文] .TP .I "-P, -H, --nofollow" If testing for the existence of files (with the -e or -E options), treat broken symbolic links as if they were existing files. The -H form of this option is provided purely for similarity with .BR find ; the use of -P is recommended over -H. [訳文] .TP -P, -H, --nofollow (-e や -E オプションとともに使って) ファイルの存在チェックを行う場合、 シンボリックリンクが壊れている場合には、 存在してるものとして扱います。 本オプションの -H 形式は、 find に合わせるために提供されています。 したがって -H よりも -P を用いることが推奨されます。 ---------------------------------------- [原文] .TP .I "-p, --print" Print search results when they normally would not, because of the presence of --statistics (-S) or --count (-c). [訳文] .TP -p, --print --statistics (-S) や --count (-c) が指定されているために、 検索結果が表示されないものについて、 その結果を表示します。 ---------------------------------------- [原文] .TP .I "-r, --regex" The pattern specified on the command line is understood to be a regular expression, as opposed to a glob pattern. The Regular expressions work in the same was as in .B emacs except for the fact that "." will match a newline. GNU .B find uses the same regular expressions. Filenames whose full paths match the specified regular expression are printed (or, in the case of the -c option, counted). If you wish to anchor your regular expression at the ends of the full path name, then as is usual with regular expressions, you should use the characters ^ and $ to signify this. [訳文] .TP -r, --regex コマンドライン上から指定されるこのパターンは、 glob パターンとしてではなく、 正規表現として解釈されます。 この正規表現は、 emacs 内において用いられるものと同様のものでしたが、 "." が改行文字として扱われるという違いがありました。 GNU find では、 同じ正規表現が用いられます。 ファイル名のフルパスが、 指定された正規表現にマッチするときに、 そのファイル名が表示されます (または -c オプションが指定された場合、 その数がカウントされます)。 正規表現を使ってフルパスの前後を完全に一致させたい場合は、 正規表現においてよく用いるように、 ^ と $ の文字を用いて指定します。 ---------------------------------------- [原文] .TP .I "--regextype R" Use regular expression dialect R. Supported dialects include `findutils-default', `posix-awk', `posix-basic', `posix-egrep', `posix-extended', `posix-minimal-basic', `awk', `ed', `egrep', `emacs', `gnu-awk', `grep' and `sed'. See the Texinfo documentation for a detailed explanation of these dialects. [訳文] .TP --regextype R 正規表現の方言である R を用います。 サポートされる方言は以下です。 `findutils-default', `posix-awk', `posix-basic', `posix-egrep', `posix-extended', `posix-minimal-basic', `awk', `ed', `egrep', `emacs', `gnu-awk', `grep', `sed' 。 この方言の詳細な説明は Texinfo ドキュメントを参照してください。 ---------------------------------------- [原文] .TP .I "-s, --stdio" Accepted but does nothing, for compatibility with BSD .BR locate . [訳文] .TP -s, --stdio 指定可能ですが、 ただし何も行いません。 これは BSD 版の locate との互換性のために存在しています。 ---------------------------------------- [原文] .TP .I "-S, --statistics" Print various statistics about each locate database and then exit without performing a search, unless non-option arguments are given. For compatibility with BSD, -S is accepted as a synonym for --statistics. However, the output of .B locate -S is different for the GNU and BSD implementations of .BR locate . [訳文] .TP -S, --statistics 各 locate データベースについての統計情報を表示します。 必須の引数が指定されていなければ、 検索処理は行わずに終了します。 BSD 版との互換性のために、 --statistics と同じ意味で -S が受け付けられます。 ただし locate -S による出力結果は、 locate の GNU 版と BSD 版では異なります。 ---------------------------------------- [原文] .TP .I "--version" Print the version number of .B locate and exit. [訳文] .TP --version locate のバージョン番号を表示して終了します。 ---------------------------------------- [原文] .TP .I "-w, --wholename" Match against the whole name of the file as listed in the database. This is the default. [訳文] .TP -w, --wholename データベース内に保持されているファイル名との完全一致を行いま す。 これはデフォルトの動作です。 ---------------------------------------- [原文] .SH ENVIRONMENT [訳文] .SH 環境変数 ---------------------------------------- [原文] .TP .B LOCATE_PATH Colon-separated list of databases to search. If the value has a leading or trailing colon, or has two colons in a row, you may get results that vary between different versions of .BR locate . . [訳文] .TP LOCATE_PATH 検索するデータベース名をコロンで区切ったリスト。 この設定値の先頭あるいは末尾にコロンを設定するか、あるいは設 定内に 2 つのコロンを含めると、 locate の異なるバージョン間において、 検索結果が異なることになります。 . ---------------------------------------- [原文] .SH "HISTORY" The .B locate program started life as the BSD fast find program, contributed to BSD by James A. Woods. This was described by his paper .I Finding Files Fast which was published in Usenix .IR ;login: , Vol 8, No 1, February/March, 1983, pp. 8-10. When the .B find program began to assume a default .B -print action if no action was specified, this changed the interpretation of .B find .BR pattern . The BSD developers therefore moved the fast find functionality into .BR locate . The GNU implementation of .B locate appears to be derived from the same code. [訳文] .SH 履歴 locate プログラムは、 プログラムの高速検索のために、 James A. Woods が BSD に提供したところから始まりました。 これは以下の論文において説明されたものです。 Finding Files Fast which was published in Usenix ;login:, Vol 8, No 1, February/March, 1983, pp. 8-10. find プログラムのアクションが指定されなかった場合に、 -print アクションがデフォルトとして扱われるようになり、 find pattern の実装が変更されました。 そこで BSD 開発者は、 この高速検索機能を locate に移転しました。 GNU による locate も、 同一のコードに基づいて実装されています。 ---------------------------------------- [原文] .P Significant changes to .B locate in reverse order: .TS tab(|); LL. 4.3.7 | Byte-order independent support for old database format 4.3.3 | locate -i supports multi-byte characters correctly | Introduced --max_db_age 4.3.2 | Support for the slocate database format 4.2.22| Introduced the --all option 4.2.15| Introduced the --regex option 4.2.14| Introduced options -L, -P, -H 4.2.12| Empty items in LOCATE_PATH now indicate the default database 4.2.11| Introduced the --statistics option 4.2.4 | Introduced --count and --limit 4.2.0 | Glob characters cause matching against the whole file name 4.0 | Introduced the LOCATE02 database format 3.7 | Locate can search multiple databases .TE . [訳文] .P locate の主要な変更を、 以下に降順で示します。 .TS tab(|); LL. 4.3.7 | 旧DBフォーマットにてバイトオーダー順に依存しない対応。 4.3.3 | locate の -i がマルチバイト文字を適切に対応。 | --max_db_age の導入。 4.3.2 | slocate データベースフォーマットの導入。 4.2.22| --all オプションの導入。 4.2.15| --regex オプションの導入。 4.2.14| -L, -P, -H の各オプションの導入。 4.2.12| LOCATE_PATH における空指定は、 デフォルトデータベースを表す。 4.2.11| --statistics オプションの導入。 4.2.4 | --count と --limit の導入。 4.2.0 | glob 文字がファイル名全体に一致するように。 4.0 | LACATE02 データベースフォーマットの導入。 3.7 | Locate が複数データベースを検索できるようにします。 .TE . ---------------------------------------- [原文] .SH "BUGS" The .B locate database correctly handles filenames containing newlines, but only if the system's sort command has a working .I -z option. If you suspect that .B locate may need to return filenames containing newlines, consider using its .I --null option. . [訳文] .SH バグ locate データベースは、 改行文字を含むファイル名でも適切に処理を行います。 ただしそれは、 システムの sort コマンドの -z オプションが正しく動作する場合です。 locate が返すファイル名に改行文字が含まれているべき、 と思われる場合には、 --null オプションの利用を検討してください。 . ---------------------------------------- [原文] .SH "REPORTING BUGS" GNU findutils online help: Report any translation bugs to [訳文] .SH バグ報告 GNU findutils オンラインヘルプ: 翻訳に関するバグ報告 ---------------------------------------- [原文] .PP Report any other issue via the form at the GNU Savannah bug tracker: [訳文] .PP その他の問題について GNU Savannah バグトラッカー経由での報告: ---------------------------------------- [原文] .RS [訳文] .RS ---------------------------------------- [原文] .RE General topics about the GNU findutils package are discussed at the .I bug-findutils mailing list: [訳文] .RE GNU findutils パッケージのメーリングリスト bug-findutils において議論されている全般的なトピック: ---------------------------------------- [原文] .RS [訳文] .RS ---------------------------------------- [原文] .RE . [訳文] .RE . ---------------------------------------- [原文] .SH COPYRIGHT Copyright © 1994-2021 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later . This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. . [訳文] .SH 著作権 Copyright © 1994-2021 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later . This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. . ---------------------------------------- [原文] .SH "SEE ALSO" .BR find (1), .BR updatedb (1), .BR xargs (1), .BR glob (3), .BR locatedb (5) [訳文] .SH 関連項目 find(1), updatedb(1), xargs(1), glob(3), locatedb(5) ---------------------------------------- [原文] .PP Full documentation or available locally via: .B info locate [訳文] .PP 完全なドキュメント またローカルにおいては info locate により参照できます。 ----------------------------------------