Man page - whereis(1)

Packages contains this manual

Package:  util-linux
apt-get install util-linux

Manuals in package:
• getopt(1)
• x86_64(8)
• zramctl(8)
• findfs(8)
• blockdev(8)
• ipcmk(1)
• linux64(8)
• ldattach(8)
• findmnt(8)
• unshare(1)
• uclampset(1)
• partx(8)
• lscpu(1)
• flock(1)
• fallocate(1)
• setterm(1)
• terminal-colors.d(5)
• setsid(1)
• setarch(8)
• lsns(8)
• adjtime_config(5)
• chcpu(8)
• runuser(1)
• rtcwake(8)
• rev(1)
• lsipc(1)
• blkdiscard(8)
• nsenter(1)
• whereis(1)
• dmesg(1)
• fsck(8)
• blkid(8)
• ipcs(1)
• mcookie(1)
• lsblk(8)
• readprofile(8)
• switch_root(8)
• wdctl(8)
• mountpoint(1)
• lsmem(1)
• fsfreeze(8)
• i386(8)
• pivot_root(8)
• swaplabel(8)
• scols-filter(5)
• getty(8)
• chmem(8)
• chrt(1)
• agetty(8)
• blkzone(8)
• more(1)
• choom(1)
• mkswap(8)
• wipefs(8)
• taskset(1)
• lslocks(8)
• linux32(8)
• ionice(1)
• isosize(8)
• su(1)
• rename.ul(1)
• prlimit(1)
• namei(1)
• lslogins(1)
• ipcrm(1)
• fstrim(8)
• mkfs(8)
• hardlink(1)
• sulogin(8)
• setpriv(1)
Documentations in package:
• util-linux

Available languages:

en pl ja uk ro sr de

Manual

WHEREIS

名 前
書 式
説 明
オ プ シ ョ ン
フ ァ イ ル を 検 索 す る パ ス
環 境 変 数
用 例
入 手 方 法

---

名 前

whereis - コ マ ン ド の バ イ ナ リ 、 ソ ー ス 、 マ ニ ュ ア ル フ ァ イ ル が ど こ に あ る か を 突 き 止 め る

書 式

whereis [options] [ -BMS directory ... -f ] name ...

説 明

whereis は 、 指 定 さ れ た コ マ ン ド 名 に つ い て 、 そ の バ イ ナ リ 、 ソ ー ス 、 マ ニ ュ ア ル フ ァ イ ル が ど こ に あ る か を 突 き 止 め る 。 whereis に 渡 さ れ た 名 前 は 、 ま ず 先 行 す る パ ス 名 の 部 分 が 取 り 除 か れ 、 次 に 、 末 尾 に . ext の 形 を 取 る 拡 張 子 (た と え ば 、 .c な ど ) が あ れ ば 、 そ れ も (ひ と つ だ け ) 取 り 除 か れ る 。 ソ ー ス コ ー ド コ ン ト ロ ー ル シ ス テ ム (SCCS) を 使 用 し た こ と に よ る s. と い う 接 頭 辞 へ の 対 応 も 行 わ れ る 。 whereis は 、 そ れ か ら 、 検 索 対 象 の プ ロ グ ラ ム な ど を Linux の 標 準 的 な 場 所 と 、 $PATH や $MANPATH に よ っ て 指 定 さ れ て い る 場 所 で 見 つ け 出 そ う と す る 。

[ 訳 注 ]

「 s. と い う 接 頭 辞 へ の 対 応 」 と い う の は 、 た と え ば 、 ls の ソ ー ス フ ァ イ ル の 探 索 を 求 め ら れ た と き に 、 ls.c だ け で な く 、 s.ls.c と い っ た フ ァ イ ル も 捜 し に 行 く よ う に す る こ と で あ る 。

検 索 対 象 の 限 定 (オ プ シ ョ ン -b , -m , -s ) は 累 加 式 で あ り 、 コ マ ン ド ラ イ ン で 後 に 続 く name と い う パ タ ー ン に 適 用 さ れ る 。 な お 、 検 索 対 象 の 限 定 を や り 直 す と 、 検 索 の 条 件 が 再 設 定 さ れ る こ と に な る 。 た と え ば 、

whereis -bm ls tr -m gcc

は 、 "ls" と "tr" に つ い て は 、 バ イ ナ リ フ ァ イ ル と man ペ ー ジ を 見 つ け よ う と し 、 "gcc" に つ い て は 、 man ペ ー ジ だ け を 捜 す 。

オ プ シ ョ ン -B , -M , -S は 、 後 に 続 く name と い う パ タ ー ン に 対 す る 検 索 パ ス を 設 定 し 直 す 。 た と え ば 、

whereis -m ls -M /usr/share/man/man1 -f cal

は 、 "ls" の man ペ ー ジ は 、 デ フ ォ ル ト の パ ス の す べ て で 捜 す が 、 "cal" に つ い て は 、 /usr/share/man/man1 デ ィ レ ク ト リ の み で 検 索 す る 。

オ プ シ ョ ン

	-b		バ イ ナ リ を 検 索 す る 。
	-m		マ ニ ュ ア ル を 検 索 す る 。
	-s		ソ ー ス を 検 索 す る 。
	-u		検 出 結 果 が 異 例 で あ る コ マ ン ド 名 に つ い て の み 表 示 す る 。 こ こ で 異 例 と い う の は 、 明 示 的 に 調 査 を 要 求 し た 各 タ イ プ に つ い て 、 検 出 結 果 が た だ 1 つ で は な い こ と で あ る 。 従 っ て 、 ’ whereis -m -u * ’ と い う コ マ ン ド は 、 カ レ ン ト デ ィ レ ク ト リ の フ ァ イ ル の う ち で 、 文 書 フ ァ イ ル が ま っ た く 存 在 し な い か 、 2 つ 以 上 存 在 す る も の を 求 め る こ と に な る 。

[ 訳 注 ]

こ の 説 明 は 古 く な っ て い る の で は な い か と 思 う 。 実 際 に は 、 手 元 の util-linux 2.36 で ’ whereis -m -u * ’ を 実 行 し て も 、 文 書 フ ァ イ ル の ま っ た く 存 在 し な い も の に つ い て は 、 何 も 表 示 さ れ な い 。 2 つ 以 上 存 在 す る も の だ け が 表 示 さ れ る 。

-B list

whereis が バ イ ナ リ を 捜 す 場 所 を 限 定 す る 。 list は 、 ホ ワ イ ト ス ペ ー ス (訳 注 : ス ペ ー ス や タ ブ ) で 区 切 っ た デ ィ レ ク ト リ の リ ス ト で あ る 。

-M list

whereis が マ ニ ュ ア ル や info 形 式 の 文 書 を 捜 す 場 所 を 限 定 す る 。 list は 、 ホ ワ イ ト ス ペ ー ス で 区 切 っ た デ ィ レ ク ト リ の リ ス ト で あ る 。

-S list

whereis が ソ ー ス を 捜 す 場 所 を 限 定 す る 。 list は 、 ホ ワ イ ト ス ペ ー ス で 区 切 っ た デ ィ レ ク ト リ の リ ス ト で あ る 。

	-f		デ ィ レ ク ト リ の リ ス ト は 直 前 で 終 わ り 、 こ こ か ら フ ァ イ ル 名 が 始 ま る と 知 ら せ る 。 -B , -M , -S オ プ シ ョ ン の 何 れ か を 使 用 す る と き は 、 こ れ を 使 わ な け れ ば な ら な い 。
	-l		whereis が 実 際 に 使 用 し て い る 検 索 パ ス の リ ス ト を 表 示 す る 。 -B , -M , -S の ど れ も 指 定 さ れ て い な い 場 合 に こ の オ プ シ ョ ン が 表 示 す る の は 、 ハ ー ド コ ー ド さ れ た パ ス の う ち で 、 whereis が シ ス テ ム 上 で 見 つ け る こ と の で き た も の で あ る 。

-h , --help

ヘ ル プ を 表 示 し て 終 了 す る 。

-V , --version

バ ー ジ ョ ン 情 報 を 表 示 し て 終 了 す る 。

フ ァ イ ル を 検 索 す る パ ス

デ フ ォ ル ト で whereis は 、 ハ ー ド コ ー ド さ れ た パ ス を 使 っ て 、 フ ァ イ ル を 見 つ け よ う と す る が 、 こ の パ ス は 、 グ ロ ブ の パ タ ー ン で 定 義 さ れ て い る 。 ま た 、 whereis は 、 環 境 変 数 $PATH と $MANPATH の 内 容 を デ フ ォ ル ト の 検 索 パ ス と し て 使 用 し よ う と す る 。 ど ん な パ ス が 使 わ れ て い る か を 知 る 一 番 簡 単 な 方 法 は 、 コ マ ン ド に リ ス ト オ プ シ ョ ン の -l を 追 加 す る こ と で あ る 。 -l を 使 え ば 、 -B , -M , -S の 効 果 も 表 示 さ れ る 。

環 境 変 数

WHEREIS_DEBUG=all

デ バ ッ グ 出 力 を 有 効 に す る 。

用 例

/usr/bin に あ る フ ァ イ ル の 内 、 /usr/man/man1 に マ ニ ュ ア ル が な い か 、 /usr/src に ソ ー ス の な い も の を す べ て 見 つ け 出 す 。

cd /usr/bin
whereis -u -ms -M /usr/man/man1 -S /usr/src -f *

[ 訳 注 ]

上 記 の コ マ ン ド は 、 少 な く と も 手 元 の util-linux 2.36 で は 、 指 定 し た デ ィ レ ク ト リ に マ ニ ュ ア ル や ソ ー ス が な い も の の 表 示 は せ ず 、 た と え ば passwd.1.gz と passwd.1ssl.gz の よ う に 、 そ う し た も の が 2 つ 以 上 あ る 場 合 だ け 表 示 す る よ う だ 。 -u オ プ シ ョ ン の 訳 注 も 参 照 。 な お 、 当 方 の 場 合 、 マ ニ ュ ア ル が あ る の は 、 /usr/share/man/man1 で あ る 。

入 手 方 法

こ の whereis コ マ ン ド は util-linux パ ッ ケ ー ジ の 一 部 で あ り 、 Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/> か ら 入 手 で き る 。

---