Scroll to navigation

CATMAN(8) 手動分頁工具 CATMAN(8)

名稱

catman - 建立或更新預先格式化的手動分頁

語法

catman [-d?V] [-M path] [-C file] [section] ...

描述

catman 用於建立一組最新的預先格式化的手動分頁,稱為 cat 頁面。Cat 頁面通常比原始手動分頁顯示得快,但需要額外的儲存空間。支援 cat 頁面的決定由本機管理員做出,他們必須提供合適的目錄來容納它們。

catman 可用的選項是要預先格式化的手動分頁階層和區段。預設階層是 man-db 設定檔中指定的系統階層,預設區段則是環境變數 $MANSECT 中以冒號分隔的內容,或者如果 $MANSECT 未定義,則是內建到 man 中的標準集。向 catman 提供一組以空白分隔的區段名稱將覆寫上述兩者。

catman 利用與每個階層相關的 index 資料庫快取來判斷哪些檔案需要格式化。

選項

列印除錯資訊。
指定替代的以冒號分隔的手動分頁階層搜尋路徑。預設情況下,這是 man-db 設定檔中指示為系統階層的所有路徑。
使用此使用者設定檔,而非預設的 ~/.manpath。
-?, --help
列印說明訊息並退出。
列印簡短用法訊息並退出。
顯示版本資訊。

環境

如果已設定 $MANSECT,其值是以冒號分隔的區段清單,用於判斷要搜尋哪些手動區段以及順序。預設是「1 n l 8 3 0 2 3type 3posix 3pm 3perl 3am 5 4 9 6 7」,除非被 /etc/manpath.config 中的 SECTION 指示詞覆寫。
如果已設定 $MANPATH,其值會被解讀為要使用的以冒號分隔的說明頁階層搜尋路徑。

請參閱 manpath(5) 的 SEARCH PATH 區段,了解此環境變數的預設行為和處理方式的詳細資訊。

檔案

/etc/manpath.config
man-db 設定檔。
/usr/man/index.(bt|db|dir|pag)
傳統的全域 index 資料庫快取。
/var/catman/index.(bt|db|dir|pag)
替代或符合 FSSTND 的全域 index 資料庫快取。

請參閱

man(1), manpath(5), 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

2026-11-15 2.13.2