Manpages

名 称

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