Manpages

名 称

apropos - 搜 索 手 册 页 名 称 和 描 述

概 述

apropos [-dalv?V] [-e|-w|-r] [-s 列 表 ] [-m 系 统 [,...]] [-M path] [-L 区 域 ] [-C 文 件 ] 关 键 词 ...

描 述

每 个 手 册 页 都 包 含 一 段 概 述 。 apropos 会 搜 索 包 括 关 键 词 的 描 述 。 关 键 词 通 常 为 正 则 表 达 式 ， 视 同 使 用 (-r)选 项 ； 或 包 含 通 配 符 (-w)； 或 完 全 匹 配 关 键 词 (-e)。 使 用 这 些 选 项 时 可 能 要 给 关 键 词 加 引 号 ， 或 对 特 殊 字 符 转 义 (\)， 以 防 shell 解 释 它 们 。 标 准 匹 配 规 则 允 许 匹 配 手 册 页 名 称 和 手 册 页 描 述 中 的 单 词 边 界 。 通 过 apropos 搜 索 的 数 据 库 已 由 mandb 程 序 更 新 。 取 决 于 您 的 安 装 方 式 ， 这 可 能 是 通 过 定 期 的 cron 任 务 进 行 的 ， 或 者 需 要 在 安 装 新 手 册 页 后 手 动 进 行 。

选 项

-d, --debug 打 印 调 试 信 息 。
-v, --verbose 打 印 详 细 的 警 告 消 息 。
-r, --regex 将 每 个 关 键 词 解 释 为 正 则 表 达 式 。 这 是 默 认 行 为 。 每 个 关 键 词 将 与 手 册 页 名 称 和 描 述 分 别 匹 配 。 匹 配 不 限 于 单 词 边 界 。
-w, --wildcard 将 每 个 关 键 词 解 释 为 shell 风 格 的 通 配 符 。 每 个 关 键 词 将 与 手 册 页 名 称 和 描 述 分 别 匹 配 。 如 果 同 时 使 用 了 --exact 选 项 ， 只 有 展 开 的 关 键 词 与 整 个 描 述 或 手 册 页 名 称 完 全 匹 配 时 才 视 为 找 到 。 否 则 关 键 词 也 允 许 沿 描 述 中 的 单 词 边 界 匹 配 。
-e, --exact 每 个 关 键 词 将 严 格 与 手 册 页 名 称 和 描 述 匹 配 。
-a, --and 只 显 示 匹 配 提 供 的 全 部 关 键 词 的 项 目 。 默 认 是 显 示 匹 配 任 一 关 键 词 的 项 目 。
-l, --long 不 按 终 端 宽 度 截 断 输 出 。 通 常 会 将 输 出 截 短 为 终 端 宽 度 ， 以 免 显 示 写 得 不 好 的 时 显 示 混 乱 。
-s 列 表 , --sections 列 表 , --section 列 表 只 搜 索 指 定 的 手 册 章 节 。 列 表 是 由 冒 号 或 逗 号 分 隔 的 章 节 列 表 。 如 果 列 表 中 的 指 定 的 是 简 单 的 章 节 号 ， 如 “3”， 则 显 示 的 描 述 列 表 将 只 包 含 “3”、 “3perl”“3x”等 章 节 中 的 页 面 ； 如 果 列 表 中 的 章 节 号 带 扩 展 ， 如 “3perl”， 则 显 示 的 描 述 列 表 将 只 包 含 手 册 章 节 中 对 应 部 分 的 页 面 。
-m 系 统 [,...], --systems=系 统 [,...] 如 果 此 系 统 可 以 访 问 其 他 操 作 系 统 的 手 册 页 描 述 ， 则 可 以 通 过 使 用 这 一 选 项 来 搜 索 它 们 。 如 要 搜 索 NewOS 的 手 册 页 描 述 ， 使 用 -m NewOS 选 项 。 指 定 的 系 统 选 项 可 以 是 逗 号 分 隔 的 操 作 系 统 名 称 组 合 。 要 在 搜 索 中 包 括 本 地 操 作 系 统 的 whatis 描 述 ， 可 以 在 参 数 字 符 串 中 包 含 系 统 名 man。 此 选 项 会 覆 盖 $SYSTEM 环 境 变 量 。
-M 路 径 , --manpath=路 径 另 外 指 定 一 组 以 冒 号 分 隔 的 手 册 页 层 次 结 构 作 为 搜 索 路 径 。 默 认 情 况 下 apropos 会 使 用 $MANPATH 环 境 变 量 作 为 搜 索 路 径 ； 如 果 该 环 境 变 量 为 空 或 未 设 置 ， 程 序 会 根 据 您 的 $PATH 环 境 变 量 确 定 相 应 的 手 册 路 径 。 此 选 项 会 覆 盖 $MANPATH 环 境 变 量 的 内 容 。
-L 区 域 , --locale=区 域

apropos 通 常 会 通 过 调 用 C 语 言 函 数 setlocale(3) 来 确 定 您 的 当 前 区 域 设 置 。 该 函 数 会 查 询 多 个 环 境 变 量 ， 可 能 包 括 $LC_MESSAGES 和 $LANG。 要 临 时 覆 盖 检 测 到 的 值 ， 请 使 用 该 选 项 直 接 向 apropos 提 供 一 个 区 域 字 符 串 。 注 意 ， 在 搜 索 页 面 实 际 开 始 前 它 不 会 生 效 。 帮 助 消 息 等 输 出 将 始 终 以 检 测 到 的 区 域 语 言 显 示 。

-C 文 件 , --config-file=文 件 使 用 此 用 户 配 置 文 件 代 替 默 认 的 ~/.manpath。
-?, --help 打 印 帮 助 消 息 并 退 出 。
--usage 打 印 简 短 的 帮 助 消 息 并 退 出 。
-V, --version 显 示 版 本 信 息 。

退 出 状 态

环 境

MANPATH 如 果 设 置 了 $MANPATH 环 境 变 量 ， 它 的 值 将 被 解 释 为 要 使 用 的 ， 以 冒 号 分 隔 的 手 册 页 层 次 结 构 搜 索 路 径 。 请 参 考 manpath(5) 中 的 搜 索 路 径 一 节 以 了 解 默 认 行 为 以 及 处 理 该 环 境 变 量 的 细 节 。
MANWIDTH 如 果 设 置 了 $MANWIDTH ， 它 的 值 将 用 作 终 端 宽 度 (参 阅 --long 选 项 )。 如 果 未 设 置 它 ， 终 端 宽 度 将 通 过 $COLUMNS 环 境 变 量 或 调 用 ioctl(2)(如 果 有 的 话 )计 算 。 若 都 失 败 ， 将 退 回 到 80 个 字 符 。
POSIXLY_CORRECT 如 果 设 置 了 $POSIXLY_CORRECT 环 境 变 量 (即 使 是 空 值 )， 默 认 的 apropos 搜 索 将 视 为 扩 展 的 正 则 表 达 式 (-r)。 不 过 ， 现 在 这 已 经 是 默 认 行 为 了 。

文 件

/usr/share/man/index.(bt|db|dir|pag) 传 统 的 全 局 索 引 数 据 库 缓 存 。
/var/cache/man/index.(bt|db|dir|pag) 与 FHS 兼 容 的 全 局 索 引 数 据 库 缓 存 。
/usr/share/man/.../whatis 传 统 的 whatis 文 本 数 据 库 。

亦 见

man(1), whatis(1), mandb(8)

作 者

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