Manpages

名 前

whatis - display one-line manual page descriptions

書 式

whatis [-dlv?V] [-r|-w] [-s list] [-m system[,...]] [-M path] [-L locale] [-C file] name ...

説 明

各 マ ニ ュ ア ル ペ ー ジ に は 短 い 要 約 文 が 含 ま れ て い ま す 。 whatis は マ ニ ュ ア ル ペ ー ジ 名 を 検 索 し 、 name に 一 致 す る す べ て の マ ニ ュ ア ル ペ ー ジ の 要 約 文 を 表 示 し ま す 。

name は ワ イ ル ド カ ー ド (-w を 指 定 し た 場 合 ) ま た は 正 規 表 現 (-r を 指 定 し た 場 合 ) で 指 定 で き ま す 。 こ れ ら の オ プ シ ョ ン を 使 用 し た 場 合 、 シ ェ ル が 特 殊 文 字 を 解 釈 す る の を 防 ぐ た め に 、 name を 引 用 符 で く く る か 、 エ ス ケ ー プ (\) し な け れ ば い け な い 場 合 が あ り ま す 。 検 索 に は イ ン デ ッ ク ス 型 デ ー タ ベ ー ス が 使 用 さ れ ま す 。 こ れ は mandb プ ロ グ ラ ム に よ っ て 更 新 し ま す 。 イ ン ス ト ー ル 方 法 に よ っ て は 、 mandb は cron ジ ョ ブ と し て 定 期 的 に 実 行 さ れ て い る か も し れ ま せ ん し 、 新 し い マ ニ ュ ア ル ペ ー ジ を イ ン ス ト ー ル し た 時 に 手 動 で 実 行 す る 必 要 が あ る か も し れ ま せ ん 。 古 い テ キ ス ト 型 whatis デ ー タ ベ ー ス か ら 対 応 す る イ ン デ ッ ク ス 型 デ ー タ ベ ー ス を 生 成 す る に は 、 次 の コ マ ン ド を 実 行 し て く だ さ い 。

whatis -M manpath -w ’*’ | sort > manpath/whatis こ こ で 、 manpath/usr/man の よ う な マ ニ ュ ア ル ペ ー ジ 階 層 を 指 定 し ま す 。

オ プ シ ョ ン

-d, --debug デ バ ッ グ 情 報 を 表 示 し ま す 。
-v
, --verbose 冗 長 な 警 告 メ ッ セ ー ジ を 表 示 し ま す 。
-r
, --regexname を 正 規 表 現 と し て 解 釈 し ま す 。 name は マ ニ ュ ア ル ペ ー ジ 名 の ど の 部 分 に 対 し て も 一 致 処 理 が 行 わ れ 、 一 致 処 理 結 果 が 生 成 さ れ ま す 。 こ の 処 理 は 、 デ ー タ ベ ー ス 検 索 の 特 性 に よ り 、 通 常 の whatis 処 理 よ り 幾 分 遅 く な り ま す 。
-w
, --wildcardname を シ ェ ル 形 式 の ワ イ ル ド カ ー ド と し て 解 釈 し ま す 。 name は マ ニ ュ ア ル ペ ー ジ 名 の ど の 部 分 に 対 し て も 一 致 処 理 が 行 わ れ 、 一 致 処 理 結 果 が 生 成 さ れ ま す 。 こ の 処 理 は 、 デ ー タ ベ ー ス 検 索 の 特 性 に よ り 、 通 常 の whatis 処 理 よ り 幾 分 遅 く な り ま す 。
-l
, --long 出 力 を 端 末 幅 で 切 り 詰 め ま せ ん 。 通 常 は 、 適 切 に 書 か れ て い な い 名 前 (NAME) 節 に よ る 見 に く さ を 避 け る た め に 出 力 が 端 末 の 幅 に 切 り 詰 め ら れ ま す 。
-s
list, --sections=list, --section=list 指 定 し た マ ニ ュ ア ル セ ク シ ョ ン の み 検 索 し ま す 。 list は コ ロ ン ま た は コ ン マ で 区 切 ら れ た セ ク シ ョ ン の リ ス ト で す 。 も し 、 list の 項 目 が 単 純 な セ ク シ ョ ン 、 例 え ば "3" な ら ば 、 表 示 さ れ る 説 明 の リ ス ト に は "3"、 "3perl"、 "3x" 等 の セ ク シ ョ ン の ペ ー ジ が 含 ま れ ま す 。 一 方 list に 拡 張 部 分 も 含 め る 、 例 え ば "3perl" な ら ば 、 表 示 さ れ る 説 明 の リ ス ト は マ ニ ュ ア ル セ ク シ ョ ン に 厳 密 に 一 致 し た ペ ー ジ の み 含 ま れ る よ う に な り ま す 。
-m
system[,...], --systems=system[,...]

If this system has access to other operating systems’ manual page names, they can be accessed using this option. To search NewOS’s manual page names, use the option -m NewOS.

system は コ ン マ 区 切 り の OS 名 で 指 定 し ま す 。 現 在 使 用 し て い る オ ペ レ ー テ ィ ン グ シ ス テ ム を 検 索 に 含 め る 場 合 は 、 シ ス テ ム 名 の 引 数 文 字 列 に man を 含 め ま す 。 こ の オ プ シ ョ ン は $SYSTEM 環 境 変 数 を 上 書 き し ま す 。

-M path--manpath=path 検 索 す る マ ニ ュ ア ル ペ ー ジ 階 層 を 変 更 す る 場 合 、 そ の 集 合 を コ ロ ン で 区 切 っ て 指 定 し ま す 。 デ フ ォ ル ト で は 、 whatis は $MANPATH 環 境 変 数 を 使 用 し ま す 。 $MANPATH 環 境 変 数 が 空 で あ る か 、 設 定 さ れ て い な い 場 合 、 $PATH 環 境 変 数 に 応 じ て 適 切 な マ ニ ュ ア ル ペ ー ジ の パ ス が 決 定 さ れ ま す 。 こ の オ プ シ ョ ン は $MANPATH の 内 容 を 上 書 き し ま す 。
-L 
locale--locale=locale

whatis は 通 常 、 現 在 の ロ ケ ー ル を C の 関 数 setlocale(3) を 呼 び 出 す こ と に よ っ て 決 定 し ま す 。 こ れ は お そ ら く $LC_MESSAGES や $LANG な ど を 含 む さ ま ざ ま な 環 境 変 数 を 使 用 し ま す 。 一 時 的 に こ の 値 を 上 書 き し た い 場 合 に は 、 こ の オ プ シ ョ ン を 使 用 し て whatis に 直 接 locale 文 字 列 を 渡 し ま す 。 こ れ は ペ ー ジ の 検 索 が 実 際 に 開 始 さ れ る ま で は 効 果 が 無 い こ と に 注 意 し て く だ さ い 。 ヘ ル プ メ ッ セ ー ジ な ど は 常 に 初 期 に 決 定 さ れ た ロ ケ ー ル に よ っ て 表 示 さ れ ま す 。

-C file--config-file=file

Use this user configuration file rather than the default of ~/.manpath.

-?, --help ヘ ル プ メ ッ セ ー ジ を 表 示 し て 終 了 し ま す 。
--usage

Print a short usage message and exit.

-V, --version バ ー ジ ョ ン 情 報 を 表 示 し ま す 。

終 了 ス テ ー タ ス

0 プ ロ グ ラ ム が 正 常 に 実 行 さ れ ま し た 。

1 使 用 法 、 構 文 ま た は 設 定 フ ァ イ ル の エ ラ ー で す 。

2 操 作 の エ ラ ー で す 。

16 指 定 し た キ ー ワ ー ド に マ ッ チ し た ペ ー ジ が 見 つ か り ま せ ん で し た 。

環 境 変 数

SYSTEM

$SYSTEM が 設 定 さ れ て い る 場 合 、 -m オ プ シ ョ ン で 指 定 し た 引 数 と 同 様 の 効 果 が あ り ま す 。

MANPATH

$MANPATH が 設 定 さ れ て い る 場 合 、 そ の 値 は コ ロ ン 区 切 り の マ ニ ュ ア ル ペ ー ジ 階 層 の 検 索 パ ス と し て 使 用 さ れ ま す 。

See the SEARCH PATH section of manpath(5) for the default behaviour and details of how this environment variable is handled.

MANWIDTH

If $MANWIDTH is set, its value is used as the terminal width (see the --long option). If it is not set, the terminal width will be calculated using the value of $COLUMNS, and ioctl(2) if available, or falling back to 80 characters if all else fails.

フ ァ イ ル

/usr/share/man/index.(bt|db|dir|pag) 伝 統 的 な 大 域 イ ン デ ッ ク ス 型 デ ー タ ベ ー ス キ ャ ッ シ ュ で す 。
/var/cache/man/index.(bt|db|dir|pag)

FHS 準 拠 の 大 域 イ ン デ ッ ク ス 型 デ ー タ ベ ー ス キ ャ ッ シ ュ で す 。

/usr/share/man/.../whatis 伝 統 的 な whatis テ キ ス ト 型 デ ー タ ベ ー ス で す 。

関 連 項 目

apropos(1), man(1), mandb(8)

著 者

Wilf. (G.Wilford [AT] ee.uk).
Fabrizio Polacco (fpolacco [AT] debian.org).
Colin Watson (cjwatson [AT] debian.org).

バ グ

https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db