Manpages

名 前

mandb - マ ニ ュ ア ル ペ ー ジ の イ ン デ ッ ク ス キ ャ ッ シ ュ を 作 成 、 更 新 す る

書 式

mandb [-dqsucpt?V] [-C file] [manpath]
mandb
[-dqsut] [-C file] -f filename ...

説 明

mandb is used to initialise or manually update index database caches. The caches contain information relevant to the current state of the manual page system and the information stored within them is used by the man-db utilities to enhance their speed and functionality.

When creating or updating an index, mandb will warn of bad ROFF .so requests, bogus manual page filenames and manual pages from which the whatis cannot be parsed.

Supplying mandb with an optional colon-delimited path will override the internal system manual page hierarchy search path, determined from information found within the man-db configuration file.

デ ー タ ベ ー ス キ ャ ッ シ ュ

mandb は 次 の う ち 一 つ の デ ー タ ベ ー ス タ イ プ を サ ポ ー ト す る よ う に コ ン パ イ ル さ れ ま す 。

Those database types that support asynchronous updates provide enhanced speed at the cost of possible corruption in the event of unusual termination. In an unusual case where this has occurred, it may be necessary to rerun mandb with the -c option to re-create the databases from scratch.

オ プ シ ョ ン

-d, --debug デ バ ッ グ 情 報 を 表 示 し ま す 。
-q
, --quiet 警 告 を 表 示 し ま せ ん 。
-s
, --no-straycats

Do not spend time looking for or adding information to the databases regarding stray cats.

-p, --no-purge 削 除 さ れ た マ ニ ュ ア ル ペ ー ジ の 検 索 と 、 そ れ に 伴 う デ ー タ ベ ー ス の デ ー タ 削 除 を 行 い ま せ ん 。
-c
, --create デ フ ォ ル ト で は 、 mandb ま 作 成 済 み の デ ー タ ベ ー ス を 更 新 し ま す 。 デ ー タ ベ ー ス が 存 在 し な い 場 合 、 デ ー タ ベ ー ス を 作 成 し ま す 。 こ の オ プ シ ョ ン を 使 用 し た 場 合 、 mandb は こ れ ま で に 作 成 さ れ た デ ー タ ベ ー ス を 削 除 し 、 新 規 に デ ー タ ベ ー ス を 作 成 し ま す 。 ま た 、 暗 黙 的 に --no-purge が 指 定 さ れ ま す 。 こ れ の 作 業 は 、 デ ー タ ベ ー ス が 破 損 し た か 、 新 機 能 に よ り デ ー タ ベ ー ス の ス キ ー マ が 変 更 さ れ た 場 合 に 必 要 と な り ま す 。
-u
, --user-db ユ ー ザ ー 用 デ ー タ ベ ー ス の 作 成 の み 行 い ま す 。 シ ス テ ム 用 デ ー タ ベ ー ス の 作 成 権 限 が あ っ た と し て も 、 シ ス テ ム 用 デ ー タ ベ ー ス の 作 成 は 行 い ま せ ん 。
-t
, --test 検 索 パ ス 内 の 階 層 に あ る マ ニ ュ ア ル ペ ー ジ と デ ー タ ベ ー ス 情 報 が 正 確 に 合 っ て い る か の 確 認 を し ま す 。 こ の オ プ シ ョ ン を 使 用 し た 場 合 、 mandb は 既 存 の デ ー タ ベ ー ス の 変 更 は 行 い ま せ ん 。
-f
, --filename 指 定 し た フ ァ イ ル 名 に 関 す る デ ー タ ベ ー ス の 項 目 の み 更 新 し ま す 。 こ の オ プ シ ョ ン は 一 般 的 に は 使 用 し ま せ ん 。 MAN_DB_UPDATES オ プ シ ョ ン を 有 効 に し て コ ン パ イ ル し た 場 合 、 ペ ー ジ が 古 い か ど う か を 確 認 す る た め に 、 man の 内 部 で 使 用 さ れ ま す 。 こ の オ プ シ ョ ン は 、 暗 黙 的 に 、 -p を 有 効 に し 、 -c お よ び -s を 無 効 に し ま す 。
-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 操 作 の エ ラ ー で す 。

3 子 プ ロ セ ス が 異 常 終 了 し ま し た 。

診 断

デ ー タ ベ ー ス を 構 築 中 に 次 の 警 告 メ ッ セ ー ジ が 表 示 さ れ る こ と が あ り ま す 。

<filename>: whatis parse for page(sec) failed

An attempt to extract whatis line(s) from the given <filename> failed. This is usually due to a poorly written manual page, but if many such messages are emitted it is likely that the system contains non-standard manual pages which are incompatible with the man-db whatis parser. See the WHATIS PARSING section in lexgrog(1) for more information.

<フ ァ イ ル 名 > は シ ン ボ リ ッ ク リ ン ク が 切 れ て い ま す

<フ ァ イ ル 名 >が 参 照 し て い る シ ン ボ リ ッ ク リ ン ク の 先 が 存 在 し ま せ ん 。 通 常 、 <フ ァ イ ル 名 >の 参 照 し て い る リ ン ク 先 を 特 定 す る た め の 追 加 の 診 断 メ ッ セ ー ジ が 表 示 さ れ ま す 。

<フ ァ イ ル 名 >: : シ ン ボ リ ッ ク リ ン ク ま た は ROFF の ’.so’ 要 求 に 誤 り が あ り ま す シ ン ボ リ ッ ク リ ン ク の 参 照 先 ま た は ROFF の イ ン ク ル ー ド (.so) 要 求 に 含 ま れ る <フ ァ イ ル 名 >が 存 在 し ま せ ん 。
<フ ァ イ ル 名 >: お か し な フ ァ イ ル 名 を 無 視 し て い ま す

<フ ァ イ ル 名 >を 持 つ マ ニ ュ ア ル ペ ー ジ が 有 効 で あ る か 無 効 で あ る か に か か わ ら ず 、 名 前 が 無 効 で す 。 こ れ は 通 常 、 マ ニ ュ ア ル ペ ー ジ が セ ク シ ョ ン 拡 張 名 <x> で あ る の に 、 マ ニ ュ ア ル ペ ー ジ セ ク シ ョ ン <y> に 配 置 さ れ て い る 時 に 発 生 し ま す 。

<filename_mask>: competing extensions

The wildcard <filename_mask> is not unique. This is usually caused by the existence of both a compressed and uncompressed version of the same manual page. All but the most recent are ignored.

フ ァ イ ル

/etc/manpath.config

man-db 設 定 フ ァ イ ル で す 。

/var/cache/man/index.(bt|db|dir|pag)

FHS 準 拠 の 大 域 イ ン デ ッ ク ス 型 デ ー タ ベ ー ス キ ャ ッ シ ュ で す 。 過 去 に 使 用 さ れ て い た デ ー タ ベ ー ス キ ャ ッ シ ュ の 位 置 :

/usr/man/index.(bt|db|dir|pag) 伝 統 的 な 大 域 イ ン デ ッ ク ス 型 デ ー タ ベ ー ス キ ャ ッ シ ュ で す 。
/var/catman/index.(bt|db|dir|pag)
代 替 ま た は FSSTND 準 拠 の 大 域 イ ン デ ッ ク ス 型 デ ー タ ベ ー ス キ ャ ッ シ ュ で す 。

関 連 項 目

lexgrog(1), man(1), manpath(5), catman(8) こ の マ ニ ュ ア ル ペ ー ジ に あ っ た 処 理 さ れ る デ ー タ 節 は lexgrog(1) ペ ー ジ に 移 動 し ま し た 。

著 者

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