Man page - locate(1)

Manual

LOCATE

名 前
書 式
説 明
オ プ シ ョ ン
環 境 変 数
履 歴
バ グ
バ グ 報 告
著 作 権
関 連 項 目

---

名 前

locate - フ ァ イ ル 名 デ ー タ ベ ー ス か ら パ タ ー ン に 合 う も の を 表 示 す る

書 式

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...

説 明

こ の マ ニ ュ ア ル ペ ー ジ は GNU 版 locate の 使 用 法 を 説 明 し て い ま す 。 locate は 、 指 定 さ れ た 各 パ タ ー ン に 対 し て 、 一 つ ま た は 複 数 の フ ァ イ ル 名 デ ー タ ベ ー ス を 検 索 し て 、 パ タ ー ン に 一 致 す る フ ァ イ ル 名 を 表 示 し ま す 。 パ タ ー ン に は 、 シ ェ ル で 用 い る よ う な メ タ キ ャ ラ ク タ ー (‘*’, ‘?’ 及 び ‘[]’) が 利 用 で き ま す 。 メ タ キ ャ ラ ク タ ー は ‘/’ や ‘.’ を 特 別 扱 い し ま せ ん 。 し た が っ て ‘foo*bar’ と い う パ タ ー ン は 、 ‘foo3/bar’ と い う フ ァ イ ル 名 に 一 致 し ま す 。 ま た ‘*duck*’ と い う パ タ ー ン は 、 ‘lake/.ducky’ に 一 致 し ま す 。 メ タ キ ャ ラ ク タ ー を 含 む パ タ ー ン は 、 シ ェ ル に よ っ て 展 開 さ れ な い よ う に ク ォ ー ト で 囲 む 必 要 が あ り ま す 。

パ タ ー ン が 通 常 の 文 字 列 で あ る 場 合 、 つ ま り メ タ キ ャ ラ ク タ ー を 含 ん で い な い 場 合 、 locate は 、 フ ァ イ ル 名 の ど こ か に そ の 文 字 列 が 含 ま れ て い る よ う な フ ァ イ ル を す べ て 表 示 し ま す 。 パ タ ー ン に メ タ キ ャ ラ ク タ ー が 含 ま れ る 場 合 、 locate は 、 パ タ ー ン に 一 致 す る フ ァ イ ル 名 だ け を 表 示 し ま す 。 こ の こ と か ら 、 メ タ キ ャ ラ ク タ ー を 含 む パ タ ー ン に は 、 通 常 は 先 頭 に ‘*’ を つ け て お い て く だ さ い 。 同 じ よ う に 、 最 後 に も た い て い は ‘*’ を つ け て お き ま す 。 た だ し フ ァ イ ル 名 の 先 頭 ま た は 最 後 に 、 意 図 的 に 一 致 さ せ た い パ タ ー ン と す る の で あ れ ば 、 そ の 必 要 は あ り ま せ ん 。

フ ァ イ ル 名 デ ー タ ベ ー ス は 、 最 後 に 更 新 さ れ た 時 点 に お い て 、 シ ス テ ム に 存 在 し て い た フ ァ イ ル の リ ス ト か ら な っ て い ま す 。 シ ス テ ム 管 理 者 は デ フ ォ ル ト で 用 い る デ ー タ ベ ー ス の フ ァ イ ル 名 や 更 新 の 頻 度 、 ま た ど の デ ィ レ ク ト リ の 情 報 を デ ー タ ベ ー ス に 入 れ る か な ど を 選 択 す る こ と が で き ま す 。 updatedb (1) を 参 照 し て く だ さ い 。

locate は 端 末 に 対 し て 出 力 を 行 な い ま す 。 出 力 に 適 さ な い 文 字 は エ ス ケ ー プ 出 力 さ れ ま す 。 こ れ は find コ マ ン ド の -print 処 理 と 同 様 に し て 行 わ れ ま す 。 出 力 先 が 端 末 で な い 場 合 、 フ ァ イ ル 名 は そ の 文 字 の ま ま 出 力 さ れ ま す 。

オ プ シ ョ ン

-0, --null

区 切 り 文 字 と し て 、 改 行 文 字 で は な く ASCII NUL 文 字 を 用 い ま す 。

-A, --all

必 須 の 引 数 す べ て に 一 致 す る 名 前 の み を 表 示 し ま す 。 つ ま り す べ て に 一 致 せ ず 、 1 つ や そ の 一 部 に の み に 一 致 す る も の は 表 示 し ま せ ん 。

-b, --basename

指 定 さ れ た パ タ ー ン が 、 デ ー タ ベ ー ス 内 に あ る フ ァ イ ル 名 の 最 後 の 構 成 要 素 に 一 致 し た 場 合 に 、 出 力 結 果 と し て 一 致 し た も の と し ま す 。 最 後 の 構 成 要 素 は 、 通 常 「 ベ ー ス 名 」 と 表 現 さ れ ま す 。

-c, --count

一 致 し た フ ァ イ ル 名 を 出 力 す る の で は な く 、 一 致 し た 総 数 を 出 力 し ま す 。 た だ し -- print (-p) も 指 定 さ れ た 場 合 は 除 き ま す 。

-d path, --database=path

デ フ ォ ル ト の フ ァ イ ル 名 デ ー タ ベ ー ス を 検 索 す る の で は な く 、 path に あ る フ ァ イ ル 名 デ ー タ ベ ー ス を 検 索 し ま す 。 複 数 の デ ー タ ベ ー ス フ ァ イ ル は 、 コ ロ ン で 区 切 っ て 指 定 し ま す 。 環 境 変 数 LOCATE_PATH を 利 用 し て 、 検 索 す る デ ー タ ベ ー ス フ ァ イ ル を 指 定 す る こ と も で き ま す 。 オ プ シ ョ ン と 環 境 変 数 が と も に 指 定 さ れ た 場 合 は 、 オ プ シ ョ ン が 優 先 さ れ ま す 。 パ ス 指 定 に 空 の 要 素 が 指 定 さ れ た 場 合 は 、 デ フ ォ ル ト の デ ー タ ベ ー ス フ ァ イ ル 名 と 同 義 で あ る も の と し て 扱 わ れ ま す 。 デ ー タ ベ ー ス は stdin か ら 指 定 す る こ と も で き ま す 。 こ れ を 行 う 場 合 は path の 要 素 と し て ‘-’ を 利 用 し ま す 。 path の 構 成 要 素 に 複 数 の ‘-’ が 指 定 さ れ て い た 場 合 、 2 つ め 以 降 は 無 視 さ れ ま す (そ し て 警 告 メ ッ セ ー ジ が 出 力 さ れ ま す )。

フ ァ イ ル 名 デ ー タ ベ ー ス の フ ォ ー マ ッ ト は 、 GNU find と locate の バ ー ジ ョ ン 4.0 か ら 変 更 さ れ ま し た 。 こ の フ ォ ー マ ッ ト に よ っ て 、 バ イ ト オ ー ダ ー が 異 な る マ シ ン 間 に お い て も 、 デ ー タ ベ ー ス が 共 有 で き る よ う に な り ま し た 。 locate の 本 バ ー ジ ョ ン で は 、 GNU locate の 旧 バ ー ジ ョ ン 、 あ る い は Unix バ ー ジ ョ ン の locate や find を 自 動 的 に 識 別 し て 読 み 込 み を 行 な い ま す 。 古 い locate の デ ー タ ベ ー ス フ ォ ー マ ッ ト へ の サ ポ ー ト は 、 今 後 の リ リ ー ス に お い て は 継 続 し ま せ ん 。

-e, --existing

現 在 存 在 し て い る 名 前 の み を 表 示 し ま す (デ ー タ ベ ー ス が 生 成 さ れ た 際 に 存 在 し て い た 名 前 を 表 示 す る わ け で は あ り ま せ ん )。 な お デ ー タ ベ ー ス 内 に 一 致 す る 名 前 が 多 数 存 在 し て い る と 、 プ ロ グ ラ ム 処 理 速 度 が 多 少 低 下 す る こ と が あ り ま す 。 プ ロ グ ラ ム 内 に お い て こ の オ プ シ ョ ン を 利 用 し て い る 場 合 は 、 locate が チ ェ ッ ク し た 後 の フ ァ イ ル は 、 削 除 さ れ て し ま い 、 確 認 で き な い こ と が あ る 点 に 注 意 し て く だ さ い 。

-E, --non-existing

現 在 存 在 し て い な い 名 前 の み を 表 示 し ま す (デ ー タ ベ ー ス が 生 成 さ れ た 際 に 存 在 し て い た 名 前 を 表 示 す る の で は あ り ま せ ん )。 な お デ ー タ ベ ー ス 内 に 一 致 す る 名 前 が 多 数 存 在 し て い る と 、 プ ロ グ ラ ム 処 理 速 度 が 多 少 低 下 す る こ と が あ り ま す 。

--help

locate の オ プ シ ョ ン 概 要 を 表 示 し て 終 了 し ま す 。

-i, --ignore-case

パ タ ー ン と フ ァ イ ル 名 に お い て 、 英 字 の 大 文 字 小 文 字 を 区 別 し ま せ ん 。

-l N, --limit=N

一 致 す る 数 を N に 制 限 し ま す 。 制 限 数 を 本 オ プ シ ョ ン に よ り 設 定 し た 場 合 、 -c オ プ シ ョ ン に よ っ て 表 示 さ れ る 結 果 数 は 、 本 オ プ シ ョ ン の 値 を 上 回 る こ と は あ り ま せ ん 。

-L, --follow

(-e や -E オ プ シ ョ ン と と も に 使 っ て ) フ ァ イ ル の 存 在 チ ェ ッ ク を 行 う 場 合 、 シ ン ボ リ ッ ク リ ン ク が 壊 れ て い る 場 合 に は 、 存 在 し て い な い も の と し て 扱 い ま す 。 こ れ は デ フ ォ ル ト の 動 作 で す 。

--max-database-age D

通 常 locate は 、 検 索 す る デ ー タ ベ ー ス が 8 日 以 上 古 か っ た 場 合 に 、 警 告 メ ッ セ ー ジ を 表 示 し ま す 。 こ の オ プ シ ョ ン は 、 そ の 日 数 を 8 日 以 外 の も の に 設 定 す る 場 合 に 用 い ま す 。 負 数 を 指 定 し た 場 合 の 動 作 は 未 定 で す 。

-m, --mmap

指 定 可 能 で す が 、 た だ し 何 も 行 い ま せ ん 。 こ れ は BSD 版 の locate と の 互 換 性 の た め に 存 在 し て い ま す 。

-P, -H, --nofollow

(-e や -E オ プ シ ョ ン と と も に 使 っ て ) フ ァ イ ル の 存 在 チ ェ ッ ク を 行 う 場 合 、 シ ン ボ リ ッ ク リ ン ク が 壊 れ て い る 場 合 に は 、 存 在 し て る も の と し て 扱 い ま す 。 本 オ プ シ ョ ン の -H 形 式 は 、 find に 合 わ せ る た め に 提 供 さ れ て い ま す 。 し た が っ て -H よ り も -P を 用 い る こ と が 推 奨 さ れ ま す 。

-p, --print

--statistics (-S) や --count (-c) が 指 定 さ れ て い る た め に 、 検 索 結 果 が 表 示 さ れ な い も の に つ い て 、 そ の 結 果 を 表 示 し ま す 。

-r, --regex

コ マ ン ド ラ イ ン 上 か ら 指 定 さ れ る こ の パ タ ー ン は 、 glob パ タ ー ン と し て で は な く 、 正 規 表 現 と し て 解 釈 さ れ ま す 。 こ の 正 規 表 現 は 、 emacs 内 に お い て 用 い ら れ る も の と 同 様 の も の で し た が 、 "." が 改 行 文 字 と し て 扱 わ れ る と い う 違 い が あ り ま し た 。 GNU find で は 、 同 じ 正 規 表 現 が 用 い ら れ ま す 。 フ ァ イ ル 名 の フ ル パ ス が 、 指 定 さ れ た 正 規 表 現 に マ ッ チ す る と き に 、 そ の フ ァ イ ル 名 が 表 示 さ れ ま す (ま た は -c オ プ シ ョ ン が 指 定 さ れ た 場 合 、 そ の 数 が カ ウ ン ト さ れ ま す )。 正 規 表 現 を 使 っ て フ ル パ ス の 前 後 を 完 全 に 一 致 さ せ た い 場 合 は 、 正 規 表 現 に お い て よ く 用 い る よ う に 、 ˆ と $ の 文 字 を 用 い て 指 定 し ま す 。

--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 ド キ ュ メ ン ト を 参 照 し て く だ さ い 。

-s, --stdio

指 定 可 能 で す が 、 た だ し 何 も 行 い ま せ ん 。 こ れ は BSD 版 の locate と の 互 換 性 の た め に 存 在 し て い ま す 。

-S, --statistics

各 locate デ ー タ ベ ー ス に つ い て の 統 計 情 報 を 表 示 し ま す 。 必 須 の 引 数 が 指 定 さ れ て い な け れ ば 、 検 索 処 理 は 行 わ ず に 終 了 し ま す 。 BSD 版 と の 互 換 性 の た め に 、 --statistics と 同 じ 意 味 で -S が 受 け 付 け ら れ ま す 。 た だ し locate -S に よ る 出 力 結 果 は 、 locate の GNU 版 と BSD 版 で は 異 な り ま す 。

--version

locate の バ ー ジ ョ ン 番 号 を 表 示 し て 終 了 し ま す 。

-w, --wholename

デ ー タ ベ ー ス 内 に 保 持 さ れ て い る フ ァ イ ル 名 と の 完 全 一 致 を 行 い ま す 。 こ れ は デ フ ォ ル ト の 動 作 で す 。

環 境 変 数

LOCATE_PATH

検 索 す る デ ー タ ベ ー ス 名 を コ ロ ン で 区 切 っ た リ ス ト 。 こ の 設 定 値 の 先 頭 あ る い は 末 尾 に コ ロ ン を 設 定 す る か 、 あ る い は 設 定 内 に 2 つ の コ ロ ン を 含 め る と 、 locate の 異 な る バ ー ジ ョ ン 間 に お い て 、 検 索 結 果 が 異 な る こ と に な り ま す 。

履 歴

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 も 、 同 一 の コ ー ド に 基 づ い て 実 装 さ れ て い ま す 。

locate の 主 要 な 変 更 を 、 以 下 に 降 順 で 示 し ま す 。

バ グ

locate デ ー タ ベ ー ス は 、 改 行 文 字 を 含 む フ ァ イ ル 名 で も 適 切 に 処 理 を 行 い ま す 。 た だ し そ れ は 、 シ ス テ ム の sort コ マ ン ド の -z オ プ シ ョ ン が 正 し く 動 作 す る 場 合 で す 。 locate が 返 す フ ァ イ ル 名 に 改 行 文 字 が 含 ま れ て い る べ き 、 と 思 わ れ る 場 合 に は 、 --null オ プ シ ョ ン の 利 用 を 検 討 し て く だ さ い 。

バ グ 報 告

GNU findutils オ ン ラ イ ン ヘ ル プ : <https://www.gnu.org/software/findutils/#get-help>
翻 訳 に 関 す る バ グ 報 告 <https://translationproject.org/team/>

そ の 他 の 問 題 に つ い て GNU Savannah バ グ ト ラ ッ カ ー 経 由 で の 報 告 :

<https://savannah.gnu.org/bugs/?group=findutils>

GNU findutils パ ッ ケ ー ジ の メ ー リ ン グ リ ス ト bug-findutils に お い て 議 論 さ れ て い る 全 般 的 な ト ピ ッ ク :

<https://lists.gnu.org/mailman/listinfo/bug-findutils>

著 作 権

Copyright © 1994-2022 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

関 連 項 目

find (1), updatedb (1), xargs (1), glob (3), locatedb (5)

完 全 な ド キ ュ メ ン ト <https://www.gnu.org/software/findutils/locate>
ま た ロ ー カ ル に お い て は info locate に よ り 参 照 で き ま す 。

---