Man page - mandb(8)

Packages contains this manual

Available languages:

en fr pt_BR es it pl pt ko nl da tr sv ja uk id ru ro sr zh_CN de

Manual

MANDB

名 称
概 述
描 述
数 据 库 缓 存
选 项
退 出 状 态
诊 断
文 件
亦 见
作 者
BUGS

名 称

mandb - 创 建 或 更 新 手 册 页 索 引 缓 存

概 述

mandb [ -dqsucpt?V | -h | -V ] [ -C 文 件 ] [ manpath ]
mandb [ -dqsut ] [ -C 文 件 ] -f 文 件 名 ...

描 述

mandb 用 于 初 始 化 或 手 动 更 新 索 引 数 据 库 缓 存 。 缓 存 包 含 与 手 册 页 系 统 当 前 状 态 相 关 的 信 息 ； 保 存 在 缓 存 中 的 这 些 信 息 被 man-db 工 具 用 来 提 高 速 度 和 增 强 功 能 。

当 创 建 或 更 新 索 引 时 ， mandb 会 警 告 错 误 的 ROFF .so 请 求 ， 无 效 的 手 册 页 名 称 和 手 册 页 ， 因 为 whatis 无 法 解 析 它 们 。

给 mandb 提 供 可 选 的 ， 以 冒 号 分 隔 的 路 径 会 覆 盖 内 部 的 系 统 手 册 页 层 次 结 构 搜 索 路 径 ， 这 些 路 径 是 从 man-db 配 置 文 件 中 的 信 息 确 定 的 。

数 据 库 缓 存

mandb 可 以 编 译 支 持 以 下 任 何 一 种 数 据 库 类 型 。

Image grohtml-1182813-1.png

那 些 提 供 异 步 更 新 的 数 据 库 速 度 更 快 ， 但 代 价 是 可 能 在 异 常 中 止 时 损 坏 数 据 。 万 一 这 种 事 情 发 生 ， 可 能 要 重 新 以 -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@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).

BUGS

https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db