- unstable 2.13.2-1
| MANDB(8) | 手動分頁工具 | MANDB(8) |
名稱¶
mandb - 建立或更新手動分頁索引快取
語法¶
mandb [-dqsucpt?V] [-C file]
[manpath]
mandb [-dqsut] [-C file] -f
filename ...
描述¶
mandb 用於初始化或手動更新 index 資料庫快取。快取包含與手動分頁系統目前狀態相關的資訊,其中儲存的資訊供 man-db 工具用來增強其速度和功能。
在建立或更新 index 時,mandb 會警告不良的 ROFF .so 要求、偽造的手動分頁檔案名稱以及無法剖析 whatis 的手動分頁。
向 mandb 提供可選的以冒號分隔的路徑將覆寫內部系統手動分頁階層搜尋路徑,這是從 man-db 設定檔中找到的資訊判斷的。
資料庫快取¶
mandb 可以編譯以支援以下任何一種資料庫類型。
| 名稱 | 非同步 | 檔案名稱 |
| Berkeley db | 是 | index.bt |
| GNU gdbm | 是 | index.db |
| UNIX ndbm | 否 | index.(dir|pag) |
支援非同步更新的資料庫類型提供了增強的速度,代價是在不正常終止的情況下可能發生在不正常終止的情況下可能發生毀損。在不正常的情況下,可能需要重新執行 mandb 並使用 -c 選項從頭重新建立資料庫。
選項¶
- -d, --debug
- 列印除錯資訊。
- -q, --quiet
- 不產生警告。
- -s, --no-straycats
- 不要浪費時間尋找或新增有關流浪貓的資訊到資料庫。
- -p, --no-purge
- 不要浪費時間檢查已刪除的手動分頁並從資料庫中清除它們。
- -c, --create
- 預設情況下,mandb 會嘗試更新任何先前建立的資料庫。如果資料庫不存在,它會建立一個。此選項強制 mandb 刪除先前的資料庫並從頭重新建立,並暗示 --no-purge. 如果資料庫毀損或未來引入新的資料庫儲存方案,這可能是必要的。
- -u, --user-db
- 只建立使用者資料庫,即使具有寫入權限以建立系統資料庫。
- -t, --test
- 對階層搜尋路徑中的手動分頁執行正確性檢查。使用此選項時,mandb 將不會更改現有資料庫。
- -f, --filename
- 只更新指定檔案名稱的項目。此選項不供一般使用;它在 man 以 MAN_DB_UPDATES 選項編譯時使用,並行現頁面過期時。它暗示 -p 並停用 -c 和 -s。
- -C file, --config-file=file
- 使用此使用者設定檔,而非預設的 ~/.manpath。
- -?, --help
- 顯示用法訊息,然後退出。
- --usage
- 列印簡短用法訊息並退出。
- -V, --version
- 顯示版本,然後退出。
結束狀態¶
- 0
- 程式執行成功。
- 1
- 用法、語法或設定檔錯誤。
- 2
- 操作錯誤。
- 3
- 子處理程序失敗。
診斷¶
在資料庫建置期間可能發出以下警告訊息。
- <filename>: whatis parse for page(sec) failed
- 嘗試從指定的 <filename> 擷取 whatis 行失敗。這通常是由於撰寫不佳的手動分頁,但如果發出許多此類訊息,則系統可能包含與 man-db whatis 剖析器不相容的非標準手動分頁。請參閱 lexgrog(1) 中的 WHATIS PARSING 區段以取得更多資訊。
- <filename>: is a dangling symlink
- <filename> 不存在但被符號連結參考。通常會發出進一步的診斷以識別有問題的連結的 <filename>。
- <filename>: bad symlink or ROFF `.so' request
- <filename> 要不是符號連結,就是包含對不存在檔案的 ROFF 引入要求。
- <filename>: ignoring bogus filename
- <filename> 可能是也可能不是有效的手動分頁,但其名稱無效。這通常是由於將包含區段延伸 <x> 的手動分頁放入手動分頁區段 <y> 中。
- <filename_mask>: competing extensions
- 萬用字元 <filename_mask> 不是唯一的。這通常是由於同時存在相同手動分頁的壓縮和非壓縮版本。除最近以外的所有版本都會被忽略。
檔案¶
- /etc/manpath.config
- man-db 設定檔。
- /var/cache/man/index.(bt|db|dir|pag)
- 符合 FHS 的全域 index 資料庫快取。
資料庫快取的舊位置包括:
- /usr/man/index.(bt|db|dir|pag)
- 傳統的全域 index 資料庫快取。
- /var/catman/index.(bt|db|dir|pag)
- 替代或符合 FSSTND 的全域 index 資料庫快取。
請參閱¶
lexgrog(1), man(1), manpath(5), catman(8)
原先在手動分頁中的 WHATIS PARSING 區段現在是 lexgrog(1) 的一部分。
作者¶
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
| 2026-11-15 | 2.13.2 |