Man page - whatis(1)

Packages contains this manual

Package:  man-db
apt-get install man-db

Manuals in package:
• lexgrog(1)
• manconv(1)
• manpath(5)
• man(1)
• accessdb(8)
• manpath(1)
• mandb(8)
• apropos(1)
• whatis(1)
• man-recode(1)
• catman(8)
• zsoelim(1)
Documentations in package:
• man-db

Available languages:

en fr pt_BR es it pl pt ko nl da tr sv ja uk id ru ro sr zh_CN de

Manual

WHATIS

名 前
書 式
説 明
オ プ シ ョ ン
終 了 ス テ ー タ ス
環 境 変 数
フ ァ イ ル
関 連 項 目
著 者
バ グ

---

名 前

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 , --regex

各 name を 正 規 表 現 と し て 解 釈 し ま す 。 name は マ ニ ュ ア ル ペ ー ジ 名 の ど の 部 分 に 対 し て も 一 致 処 理 が 行 わ れ 、 一 致 処 理 結 果 が 生 成 さ れ ま す 。 こ の 処 理 は 、 デ ー タ ベ ー ス 検 索 の 特 性 に よ り 、 通 常 の whatis 処 理 よ り 幾 分 遅 く な り ま す 。

-w , --wildcard

各 name を シ ェ ル 形 式 の ワ イ ル ド カ ー ド と し て 解 釈 し ま す 。 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@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).

バ グ

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

---