名 称
mandb - 创 建 或 更 新 手 册 页 索 引 缓 存
概 述
mandb
[-dqsucpt?V|-h|-V] [-C
文 件 ] [manpath]
mandb [-dqsut] [-C 文
件 ] -f 文 件 名
...
描 述
mandb 用 于 初 始 化 或 手 动 更 新 索 引 数 据 库 缓 存 。 缓 存 包 含 与 手 册 页 系 统 当 前 状 态 相 关 的 信 息 ； 保 存 在 缓 存 中 的 这 些 信 息 被 man-db 工 具 用 来 提 高 速 度 和 增 强 功 能 。 当 创 建 或 更 新 索 引 时 ， mandb 会 警 告 错 误 的 ROFF .so 请 求 ， 无 效 的 手 册 页 名 称 和 手 册 页 ， 因 为 whatis 无 法 解 析 它 们 。 给 mandb 提 供 可 选 的 ， 以 冒 号 分 隔 的 路 径 会 覆 盖 内 部 的 系 统 手 册 页 层 次 结 构 搜 索 路 径 ， 这 些 路 径 是 从 man-db 配 置 文 件 中 的 信 息 确 定 的 。
数 据 库 缓 存
mandb 可 以 编 译 支 持 以 下 任 何 一 种 数 据 库 类 型 。
那 些 提 供 异 步 更 新 的 数 据 库 速 度 更 快 ， 但 代 价 是 可 能 在 异 常 中 止 时 损 坏 数 据 。 万 一 这 种 事 情 发 生 ， 可 能 要 重 新 以 -c 选 项 运 行 mandb 来 重 建 数 据 库 。
选 项
-d,
--debug 打 印 调 试 信
息 。
-q, --quiet 不 显 示 警
告 。
-s, --no-straycats 不 花 时
间 查 找 或 向 数
据 库 添 加 有 关
孤 立 cat 页 面 的 信
息 。
-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 文 件
, --config-file=文 件
使 用 此 用 户 配
置 文 件 代 替 默
认 的 ~/.manpath。
-?, --help 显 示 用 法
消 息 ， 然 后 退
出 。
--usage 打 印 简 短 的
帮 助 消 息 并 退
出 。
-V, --version 显 示 版 本
号 ， 然 后 退 出
。
退 出 状 态
|
0 程 序 成 功 执 行 。 |
||
|
1 用 法 、 语 法 或 配 置 文 件 错 误 。 |
||
|
2 操 作 出 错 。 |
||
|
3 子 进 程 失 败 。 |
诊 断
在 构 建 数 据 库 时 可 能 会 显 示 以 下 警 告 消 息 。
<文 件
名 >: 页 面 (章 节 )
的 whatis 解 析 失 败
从 给 定 <文 件 名
> 提 取 whatis 行 失 败
。 这 通 常 是 由
于 手 册 编 写 不
当 导 致 的 。 但
如 果 出 现 了 大
量 这 种 消 息 ，
则 可 能 是 系 统
包 含 非 标 准 的
， 和 man-db whatis 解 析 器
不 兼 容 的 手 册
页 。 请 参 阅
lexgrog(1) 中 的 WHATIS PARSING
一 节 了 解 更 多
信 息 。
<文 件 名 >: 是 一
个 的 无 效 的 符
号 链 接
<文 件 名 >不 存 在 ， 但 被 一 个 符 号 链 接 引 用 。 通 常 会 给 出 进 一 步 的 诊 断 信 息 ， 识 别 出 非 法 链 接 的 <文 件 名 >。
<文 件 名 >: 错 误 的 符 号 链 接 或 ROFF ’.so’ 请 求
<文 件 名 > 是 指 向 不 存 在 的 文 件 的 符 号 链 接 ， 或 包 含 带 有 请 求 不 存 在 文 件 的 ROFF。
<文 件 名 >: 将 忽 略 假 的 文 件 名
<文 件 名 > 可 能 是 或 不 是 有 效 的 手 册 页 ， 但 它 的 名 称 是 无 效 的 。 这 通 常 是 由 于 手 册 页 包 含 章 节 扩 展 <x> 却 被 放 在 了 手 册 页 章 节 <y>。
<文 件 名 掩 码 >: 扩 展 冲 突 通 配 符 <文 件 名 掩 码 > 不 唯 一 。 这 通 常 是 同 时 存 在 同 一 手 册 页 的 压 缩 和 非 压 缩 版 本 导 致 的 。
文 件
/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) 此 手 册 页 中 的 WHATIS PARSING 小 节 现 在 是 lexgrog(1) 的 一 部 分 。
作 者
Wilf.
(G.Wilford [AT] ee.uk).
Fabrizio Polacco (fpolacco [AT] debian.org).
Colin Watson (cjwatson [AT] debian.org).
BUGS
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db