man - 系统参考手册的接口
概要
man [man 选项] [[章节] 页面 ...] ...
man -k [apropos 选项] 正则表达式 ...
man -K [man 选项] [章节] 术语 ...
man -f [whatis 选项] 页面 ...
man -l [man 选项] 文件 ...
man -w|-W [man 选项] 页面 ...
描述
man 是系统的手册分页器。传递给 man 的每个页面参数通常是程序、实用程序或函数名称。然后找到与这些参数中的每个参数关联的手册页,并显示它。如果提供了章节,man 将仅在该手册的章节中搜索。默认操作是在所有可用章节中搜索(按预定义的顺序,参见“默认设置”),并且仅显示找到的第一个页面,即使页面存在于多个章节中。
下表显示了手册的章节编号,后跟它们包含的页面类型。
1 可执行程序或 shell 命令
2 系统调用(由内核提供的函数)
3 库调用(程序库中的函数)
4 特殊文件(通常位于 /dev 中)
5 文件格式和约定,例如 /etc/passwd
6 游戏
7 杂项(包括宏包和约定),例如 man(7)、groff(7)、man-pages(7) 8 系统管理命令(通常仅供 root 用户使用) 9 内核例程 [非标准]
一个手册页由几个部分组成。
常用的章节名称包括 NAME、SYNOPSIS、CONFIGURATION、DESCRIPTION、OPTIONS、EXIT STATUS、RETURN VALUE、ERRORS、ENVIRONMENT、FILES、VERSIONS、STANDARDS、NOTES、BUGS、EXAMPLE、AUTHORS 和 SEE ALSO。
以下约定适用于 SYNOPSIS 部分,并且可以用作其他部分的指南。
粗体文本 表示完全按照所示的方式输入。
斜体文本 表示用适当的参数替换。
[-abc] 表示 [] 中的任何或所有参数都是可选的。
-a|-b 表示用 | 分隔的选项不能一起使用。
参数 ... 表示参数可以重复。
[表达式] ... 表示 [] 中的整个表达式可以重复。
确切的渲染方式可能因输出设备而异。例如,man 通常无法在终端中渲染斜体文本,并且通常会使用下划线或彩色文本来代替。
命令或函数说明是一种模式,它应该匹配所有可能的调用。在某些情况下,建议说明几个互斥的调用方式,如本手册页的 SYNOPSIS 部分所示。
示例
man ls
显示项目(程序)ls 的手册页。
man man.7
显示宏包 man 的第 7 节的手册页。(这是“man 7 man”的另一种拼写。)
man 'man(7)'
显示宏包 man 的第 7 节的手册页。(这是“man 7 man”的另一种拼写。当复制和粘贴手册页的交叉引用时,这可能更方便。请注意,括号通常必须用引号引起来,以防止 shell 解释它们。)
man -a intro
依次显示手册中包含的所有可用的 intro 手册页。可以在连续显示之间退出,或跳过其中的任何一个。
man -t bash | lpr -Pps
将 bash 的手册页格式化为默认的 troff 或 groff 格式,并将其通过管道输送到名为 ps 的打印机。groff 的默认输出通常是 PostScript。man --help 应该会说明 -t 选项绑定了哪个处理器。
man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
此命令将解压缩并格式化 nroff 源代码手册页 ./foo.1x.gz,将其转换为设备无关 (dvi) 文件。重定向是必要的,因为 -T 标志会导致输出直接发送到 stdout,而不会使用分页器。可以使用 xdvi 等程序查看输出,或使用 dvips 等程序将其进一步处理为 PostScript。
man -k printf
搜索短描述和手册页名称,查找关键字 printf(作为正则表达式)。打印出所有匹配项。这等效于 apropos printf。
man -f smail
查找 smail 引用的手册页,并打印出找到的手册页的短描述。这等效于 whatis smail。
概述
man 提供了许多选项,以便为用户提供尽可能多的灵活性。以下详细介绍了可以对搜索路径、节顺序、输出处理器和其他行为进行更改。
如果设置了,man 将检查各种环境变量,以确定其操作。可以将“万能”变量 $MANOPT 设置为任何命令行的字符串,但有一个例外:用于作为选项参数的任何空格都必须进行转义(前面加一个反斜杠)。man 首先解析 $MANOPT,然后再解析其自身的命令行。在命令行中找到的相同选项将覆盖需要参数的选项。要重置 $MANOPT 中设置的所有选项,可以将 -D 指定为初始命令行选项。这将允许 man“忘记”在 $MANOPT 中指定的选项,尽管这些选项必须是有效的。
手册页通常以 nroff(1) 格式存储在 /usr/share/man 等目录中。在某些安装中,可能还存在预格式化的 cat 页面,以提高性能。有关这些文件存储位置的详细信息,请参阅 manpath(5)。
此包支持多种语言的手册页,由您的区域设置控制。如果您的系统未自动为您设置此内容,则可能需要设置 $LC_MESSAGES、$LANG 或其他系统特定的环境变量,以指示您首选的区域设置,通常以 POSIX 格式指定。
<language>[_<territory>[.<character-set>[,<version>]]]
如果所需的页面有您的本地版本,则会显示该版本,而不是通常的(通常为美式英语)页面。
如果您发现与此软件包提供的翻译不兼容,并且希望提供您的母语版本,请联系维护者,他们将协调这项工作。
各个手册页通常由维护其程序、函数或其他主题的维护者编写和维护,不包含在此软件包中。如果您发现缺少或不完整的手册页,请向相关软件包的维护者报告。
有关此手册分页器提供的其他功能和扩展的信息,请阅读随软件包提供的文档。
默认设置
可以通过环境变量 $MANSECT 或 /etc/manpath.config 中的 SECTION 指令来覆盖搜索部分的顺序。默认情况下,顺序如下:
1n l 8 3 0 2 3type 3posix 3pm 3perl 3am 5 4 9 6 7
格式化的手册页使用分页器显示。可以通过多种方式指定,否则将回退到默认设置(有关详细信息,请参见选项 -P)。
通过多种方式确定过滤器。首先,将检查命令行选项 -p 或环境变量 $MANROFFSEQ。如果未使用 -p,并且未设置环境变量,则将解析 nroff 文件的第一行以查找预处理器字符串。要包含有效的预处理器字符串,第一行必须类似于
'\" <string>
其中 string 可以是选项 -p 中描述的任何字母组合。
如果上述方法均未提供任何过滤器信息,则使用默认设置。
将从过滤器、主格式器(nroff 或带有 -t 的 [tg]roff)以及可选的设备(使用 -T 或 -E 指定)形成一个格式化管道,然后执行。或者,如果在 man 树的根目录中存在可执行程序 mandb_nfmt(或带有 -t 的 mandb_tfmt),则将执行它。它将手册源文件、预处理器字符串以及可选的设备(使用 -T 或 -E 指定)作为参数传递。
选项
命令行、$MANOPT 或两者中重复的非参数选项不会产生负面影响。对于需要参数的选项,每次重复都会覆盖前一个参数值。
通用选项
-C 文件,--config-file=文件
使用此用户配置文件,而不是默认的 \~/.manpath。
-d,--debug
打印调试信息。
-D,--default
此选项通常作为第一个选项发出,并会将 man 的行为重置为默认值。它的用途是重置 $MANOPT 中可能设置的选项。任何后续选项都将产生其通常的效果。
--warnings[=warnings]
启用 groff 的警告。这可用于对手册页的源文本执行完整性检查。warnings 是一个逗号分隔的警告名称列表;如果未提供,则默认值为“mac”。要禁用 groff 警告,请在前面加上“!”:例如,--warnings=mac,!break 启用“mac”类别的警告,并禁用“break”类别的警告。请参阅 info groff 中的“Warnings”节点,以获取可用警告名称的列表。
主要操作模式
-f, --whatis
大致相当于 whatis。如果可用,则显示手册页中的简短描述。有关详细信息,请参阅 whatis(1)。
-k, --apropos
大致相当于 apropos。搜索手册页简短描述中的关键字,并显示任何匹配项。有关详细信息,请参阅 apropos(1)。
-K, --global-apropos
搜索所有手册页中的文本。这是一个蛮力搜索,可能需要一些时间;如果可以,您应该指定一个部分以减少需要搜索的页面数量。搜索词可以是简单的字符串(默认值),也可以是使用 --regex 选项的正则表达式。
请注意,此搜索的是手册页的源代码,而不是呈现的文本,因此可能会因为源文件中的注释等原因而产生误报,或者因为将连字符写成“-”等原因而产生漏报。搜索呈现的文本会慢得多。
-l, --local-file
激活“local”模式。格式化并显示本地手册文件,而不是搜索整个系统的手册集合。每个手册页参数都将被解释为正确格式的 nroff 源文件。不会生成 cat 文件。如果将“-”列为其中一个参数,则将从 stdin 读取输入。
如果未使用此选项,那么如果参数包含“/”字符,man 也会将手册页参数解释为本地文件名,因为这是一个很好的指示,表明该参数引用了文件系统中的路径。
-w, --where, --path, --location
不要实际显示手册页,而是打印将要格式化的源 nroff 文件的位置。如果也使用了 -a 选项,则打印与搜索条件匹配的所有源文件的位置。
-W, --where-cat, --location-cat
不要实际显示手册页,而是打印将要显示的预格式化 cat 文件的位置。如果也使用了 -a 选项,则打印与搜索条件匹配的所有预格式化 cat 文件的位置。
如果同时使用了 -w 和 -W,则打印源文件和 cat 文件,并用空格分隔。如果同时使用了 -w、-W 和 -a,则对每个可能的匹配项执行此操作。
-c, --catman
此选项不是供一般使用,而应仅由 catman 程序使用。
-R encoding, --recode=encoding
与其以通常的方式格式化手册页,不如将其源转换为指定的编码。如果您已经知道源文件的编码,也可以直接使用 manconv(1)。但是,此选项允许您将多个手册页转换为单个编码,而无需显式指定每个手册页的编码,前提是它们已经安装在一个类似于手册页层次结构的结构中。
请考虑使用 man-recode(1) 来转换多个手册页,因为它具有专为批量转换设计的界面,因此速度可能更快。
查找手册页
-L locale, --locale=locale
`man` 通常会通过调用 C 函数 `setlocale(3)` 来确定当前的语言环境,该函数会查询各种环境变量,可能包括 `$LC_MESSAGES` 和 `$LANG`。要临时覆盖确定的值,请使用此选项直接向 `man` 提供语言环境字符串。请注意,它仅在开始搜索页面时才会生效。诸如帮助消息之类的输出始终以最初确定的语言环境显示。
-m system[,...], --systems=system[,...]
如果该系统可以访问其他操作系统的手册页,可以使用此选项来访问它们。要搜索 NewOS 手册页集合中的手册页,请使用选项 -m NewOS。
指定的系统可以是逗号分隔的操作系统名称的组合。要包含对本机操作系统手册页的搜索,请在参数字符串中包含系统名称 man。此选项将覆盖 $SYSTEM 环境变量。
-M path, --manpath=path
指定要使用的替代 manpath。默认情况下,man 使用从 manpath 代码派生的路径来确定搜索路径。此选项会覆盖 $MANPATH 环境变量,并导致选项 -m 被忽略。
作为 manpath 指定的路径必须是手册页层次结构的根目录,该层次结构按照 man-db 手册(在“手册页系统”下)中描述的方式进行组织。要查看位于这些层次结构之外的手册页,请参见选项 -l。
-S list, -s list, --sections=list
给定的列表是冒号或逗号分隔的列表,用于确定要搜索的手册页部分以及搜索顺序。此选项会覆盖 $MANSECT 环境变量。(-s 拼写是为了与 System V 兼容。)
-e sub-extension, --extension=sub-extension
某些系统将大型手册页集合(例如与 Tcl 包一起提供的手册页)合并到主手册页层次结构中。为了解决存在具有相同名称的手册页(例如 exit(3))的问题,通常会将所有 Tcl 页都分配到第 l 部分。由于这很不幸,现在可以将这些页放入正确的部分,并为它们分配特定的“扩展名”,在这种情况下,为 exit(3tcl)。在正常操作下,man 会优先显示 exit(3),而不是 exit(3tcl)。为了解决这种情况并避免必须知道所需的页位于哪个部分,现在可以向 man 提供子扩展名字符串,指示页必须属于哪个包。在上述示例中,向 man 提供选项 -e tcl 将限制搜索到具有扩展名 *tcl 的页。
-i, --ignore-case
在搜索手册页时忽略大小写。这是默认设置。
-I, --match-case
以区分大小写的方式搜索手册页。
--regex
显示所有页面,这些页面的名称或描述的任何部分都与每个页面参数作为正则表达式匹配,就像 apropos(1) 一样。由于通常没有合理的方法来选择“最佳”页面,因此在使用正则表达式进行搜索时,此选项隐含 -a。
--wildcard
显示所有页面,这些页面的名称或描述的任何部分都与每个页面参数使用 shell 风格的通配符匹配,就像 apropos(1) --wildcard 一样。页面参数必须与整个名称或描述匹配,或者在描述中匹配单词边界。由于通常没有合理的方法来选择“最佳”页面,因此在使用通配符进行搜索时,此选项隐含 -a。
--names-only
如果使用了 --regex 或 --wildcard 选项,则仅匹配页面名称,而不匹配页面描述,就像 whatis(1) 一样。否则,没有效果。
-a, --all
默认情况下,man 在显示找到的最合适的手册页后退出。使用此选项可以强制 man 显示与搜索条件匹配的所有手册页。
-u, --update
此选项导致 man 更新其已安装手册页的数据库缓存。这只需要在很少的情况下进行,通常最好运行 mandb(8) 命令。
--no-subpages
默认情况下,man 会尝试将命令行中给出的两个手册页名称解释为单个手册页名称,该名称包含连字符或下划线。这支持一个常见模式,即程序实现多个子命令,并允许为每个子命令提供手册页,以便可以使用与调用子命令本身类似的方式访问这些手册页。例如:
$ man -aw git diff
/usr/share/man/man1/git-diff.1.gz
要禁用此行为,请使用 --no-subpages 选项。
$ man -aw --no-subpages git diff
/usr/share/man/man1/git.1.gz
/usr/share/man/man3/Git.3pm.gz
/usr/share/man/man1/diff.1.gz
控制格式化输出
-P pager, --pager=pager
指定要使用的输出分页器。默认情况下,man 使用 pager,如果找不到 pager 或 pager 无法执行,则回退到 cat。此选项会覆盖 $MANPAGER 环境变量,而 $MANPAGER 环境变量又会覆盖 $PAGER 环境变量。它不能与 -f 或 -k 结合使用。
该值可以是简单的命令名称或带有参数的命令,并且可以使用 shell 引用(反斜杠、单引号或双引号)。它不能使用管道来连接多个命令;如果需要,请使用包装器脚本,该脚本可以将要显示的文件作为参数或通过标准输入传递。
`-r prompt, --prompt=prompt`
如果使用了 less 的最新版本作为分页器,man 将尝试设置其提示符和一些合理的选项。默认提示符如下所示:
^ anual page name(sec) line x
其中 `name` 表示手册页名称,`sec` 表示找到手册页的部分,`x` 表示当前行号。这是通过使用 `$LESS` 环境变量来实现的。
通过 `-r` 选项提供一个字符串将覆盖此默认值。该字符串可以包含文本 `$MAN_PN`,它将被扩展为当前手册页的名称及其部分名称,并用括号括起来。用于生成默认提示符的字符串可以表示为:
`\ Manual\ page\ \$MAN_PN\ ?ltline\ %lt?L/%L.:`
`byte\ %bB?s/%s..?\ (END):?pB\ %pB\\%..`
`(press h for help or q to quit)`
这里将其分成三行只是为了提高可读性。有关其含义,请参阅 [less]({filename}../../less)(1) 手册页。提示符字符串首先由 shell 评估。提示符中的所有双引号、反引号和反斜杠都必须通过前导反斜杠进行转义。提示符字符串可以以转义的 `$` 结尾,其后可以是 `less` 的更多选项。默认情况下,`man` 设置 `-ix8` 选项。
可以通过 `$MANLESS` 环境变量(如下所述)来设置默认提示符字符串,如果未在命令行中提供。
`-7, --ascii`
当在 7 位终端或终端模拟器上查看纯 ASCII(7) 手册页时,在使用带有 GNU nroff 的 latin1(7) 设备描述时,某些字符可能无法正确显示。此选项允许以 ASCII 格式显示纯 ASCII 手册页,并使用 latin1 设备。它不会翻译任何 latin1 文本。下表显示了执行的翻译:其中一些部分可能仅在使用 GNU nroff 的 latin1(7) 设备时才能正确显示。
描述 八进制 latin1 ascii
续行连字符 255 ‐ 项目符号(中间点) 267 • o
重音符号 264 ´ '
乘号 327 × x
如果 latin1 列显示正确,则您的终端可能已设置为 latin1 字符,因此不需要此选项。如果 latin1 和 ASCII 列相同,则您正在使用此选项或 `man` 未使用 latin1 设备描述格式化此页。如果 latin1 列丢失或损坏,则可能需要使用此选项查看手册页。
当使用选项 `-t`、`-H`、`-T` 或 `-Z` 时,将忽略此选项,并且对于其他非 GNU 的 nroff 来说可能没有用。
`-E encoding, --encoding=encoding`
生成不同于默认值的字符编码的输出。为了向后兼容,编码可以是 nroff 设备,例如 ASCII、latin1 或 UTF-8,也可以是真正的字符编码,例如 UTF-8。
--no-hyphenation, --nh
通常,nroff 会自动在换行处对文本进行断字,即使在不包含连字符的单词中也是如此,如果这样做对于在行中排列单词而不会产生过多的空格是必要的。此选项禁用自动断字,因此单词仅在它们已经包含连字符时才会进行断字。
如果您正在编写手册页,并且只想防止 nroff 在不适当的点上对单词进行断字,请不要使用此选项,而是查阅 nroff 文档;例如,您可以将 "\%" 放在单词内部,以指示可以在该点对单词进行断字,或者将 "\%" 放在单词的开头,以防止对单词进行断字。
--no-justification, --nj
通常,nroff 会自动将文本对齐到两边边距。此选项禁用完全对齐,只对齐到左边距,有时称为“左对齐”文本。
如果您正在编写手册页,并且只想防止 nroff 对某些段落进行对齐,请不要使用此选项,而是查阅 nroff 文档;例如,您可以使用“.na”、“.nf”、“.fi”和“.ad”请求来暂时禁用调整和填充。
-p string, --preprocessor=string
指定在 nroff 或 troff/groff 之前要运行的预处理程序序列。并非所有安装都具有完整的预处理程序集。一些预处理程序及其使用的字母包括:eqn (e)、grap (g)、pic (p)、tbl (t)、vgrind (v) 和 refer (r)。 此选项会覆盖 $MANROFFSEQ 环境变量。zsoelim 始终作为第一个预处理程序运行。
-t, --troff
使用 groff -mandoc 将手册页格式化到标准输出。此选项与 -H、-T 或 -Z 结合使用时不是必需的。
-T[device], --troff-device[=device]
此选项用于更改 groff(或可能更改 troff 的)输出,使其适用于与默认设备不同的设备。它隐含 -t。示例(截至 groff 1.23.0)包括 dvi、latin1、pdf、ps、utf8、X75 和 X100。
-H[browser], --html[=browser]
此选项将导致 groff 生成 HTML 输出,并在 Web 浏览器中显示该输出。如果提供了可选的浏览器参数,则浏览器选项由其确定,否则由 $BROWSER 环境变量确定,或者如果未设置该变量,则由编译时默认值确定(通常为 lynx)。此选项隐含 -t,并且仅适用于 GNU troff。
-X[dpi], --gxditview[=dpi]
此选项使用 gxditview 程序在图形窗口中显示 groff 的输出。dpi(每英寸点数)可以是 75、75-12、100 或 100-12,默认值为 75;-12 变体使用 12 点基本字体。此选项隐含 -T,并使用 X75、X75-12、X100 或 X100-12 设备。
-Z, --ditroff
groff 将运行 troff,然后使用适当的后处理程序来生成适合所选设备的输出。如果 groff -mandoc 是 groff,则此选项将传递给 groff,并且会禁止使用后处理程序。它隐含 -t。
获取帮助
-?, --help
打印帮助信息并退出。
--usage
打印简短的使用信息并退出。
-V, --version
显示版本信息。
退出状态
0 程序成功执行。
1 用法、语法或配置文件错误。
2 操作错误。
3 子进程返回了非零退出状态。
16 至少有一个页面/文件/关键字不存在或未匹配。
环境
MANPATH
如果设置了 $MANPATH,则其值将用作搜索手册页的路径。
请参阅 manpath(5) 的“搜索路径”部分,了解默认行为和此环境变量的处理方式。
MANROFFOPT
每次 man 调用格式化程序(nroff、troff 或 groff)时,它都会将 $MANROFFOPT 的内容添加到格式化程序的命令行中。
例如,MANROFFOPT=-P-i 告诉格式化程序使用斜体文本(仅某些终端支持),而不是下划线文本。
MANROFFSEQ
如果设置了 $MANROFFSEQ,则其值将用于确定传递到每个手册页的预处理器集。默认预处理器列表取决于系统。
MANSECT
如果设置了 $MANSECT,则其值将是一个以冒号分隔的节列表,并且它将用于确定搜索的手册节以及搜索顺序。默认值为“1 n l 8 3 0 2 3ype 3posix 3pm 3perl 3am 5 4 9 6 7”,除非被 /etc/manpath.config 中的 SECTION 指令覆盖。
MANPAGER, PAGER
如果设置了 $MANPAGER 或 $PAGER($MANPAGER 优先使用),则其值将用作用于显示手册页的程序的名称。默认情况下,使用 pager,如果找不到 pager 或 pager 无法执行,则回退到 cat。
该值可以是简单的命令名称或带有参数的命令,并且可以使用 shell 引用(反斜杠、单引号或双引号)。它不能使用管道来连接多个命令;如果需要,请使用包装器脚本,该脚本可以将要显示的文件的名称作为参数或通过标准输入传递。
MANLESS
如果设置了 $MANLESS,则其值将用作 less 分页器的默认提示字符串,就像使用 -r 选项一样(因此,对文本 $MAN_PN 的任何引用都将以相同的方式扩展)。例如,如果希望无条件地将提示字符串设置为“我的提示字符串”,请将 $MANLESS 设置为“ -Psmy prompt string”。使用 -r 选项会覆盖此环境变量。
BROWSER
如果设置了 $BROWSER,则其值将是一个以冒号分隔的命令列表,每个命令都将依次用于尝试启动用于 man --html 的 Web 浏览器。在每个命令中,%s 将替换为包含 groff 的 HTML 输出的文件名,%% 将替换为单个百分号 (%),%c 将替换为冒号 (:)。
SYSTEM 如果设置了 $SYSTEM,它将与将其作为 -m 选项的参数指定的行为相同。
MANOPT 如果设置了 $MANOPT,它将在 man 的命令行之前进行解析,并且预期其格式与命令行选项类似。由于所有其他 man 特定的环境变量都可以表示为命令行选项,因此它们也是包含在 $MANOPT 中的候选对象,因此预计它们将变得过时。注意:所有应解释为选项参数一部分的空格都必须进行转义。
MANWIDTH
如果设置了 $MANWIDTH,则其值将用作应格式化手册页的行长度。如果未设置,则手册页将以适合当前终端的行长度进行格式化(使用 $COLUMNS 的值,如果可用,则使用 ioctl(2),否则如果两者都不可用,则回退到 80 个字符)。只有在可以使用默认格式化时(即,当终端行长度在 66 到 80 个字符之间时),才会保存 cat 页面。
MAN_KEEP_FORMATTING
通常,当输出未重定向到终端时(例如,重定向到文件或管道),格式字符将被丢弃,以便更容易地在没有特殊工具的情况下阅读结果。但是,如果将 $MAN_KEEP_FORMATTING 设置为任何非空值,则这些格式字符将保留。这对于围绕 man 的包装器可能很有用,因为这些包装器可以解释格式字符。
MAN_KEEP_STDERR
通常,当输出重定向到终端时(通常重定向到分页器),用于生成格式化手册页的命令的任何错误输出都将被丢弃,以避免干扰分页器的显示。诸如 groff 之类的程序通常会生成关于排版问题的相对较小的错误消息,例如糟糕的对齐方式,这在与手册页一起显示时会产生令人不快且通常令人困惑的效果。但是,有些用户希望看到这些错误消息,因此,如果将 $MAN_KEEP_STDERR 设置为任何非空值,则将按通常方式显示错误输出。
MAN_DISABLE_SECCOMP
在 Linux 上,man 通常使用 seccomp(2) 沙箱来限制处理不受信任数据的子进程。这可以更安全地运行针对任意手册页的复杂解析代码。如果由于与正在显示的页面的内容无关的原因,此操作出现问题,则可以将 $MAN_DISABLE_SECCOMP 设置为任何非空值以禁用沙箱。
PIPELINE_DEBUG
如果将 $PIPELINE_DEBUG 环境变量设置为“1”,则 man 将打印调试消息到标准错误,以描述它运行的每个子进程。
LANG, LC_MESSAGES
根据系统和实现,将检查 $LANG 和 $LC_MESSAGES 中的一个或两个,以确定当前的语言环境。man 将以该语言环境显示其消息(如果可用)。有关确切详细信息,请参见 setlocale(3)。
文件
/etc/manpath.config
man-db 配置文件。
/usr/share/man
全局手册页层次结构。
标准
POSIX.1-2001,POSIX.1-2008,POSIX.1-2017。
参阅
apropos(1), groff(1), less(1), manpath(1), nroff(1), troff(1), whatis(1), zsoelim(1), manpath(5), man(7), catman(8), mandb(8)
某些软件包的文档可能以其他格式提供,例如 info(1) 或 HTML。
历史
1990 1991 – 最初由 John W. Eaton (_) 编写。
1992 年 12 月 23 日:Rik Faith (_) 应用了 Willem Kasdorp (_) 提供的错误修复。
1994 年 4 月 30 日 – 2000 年 2 月 23 日:Wilf. (_) 一直在开发和维护此软件包,并得到了一些忠实人士的帮助。
1996 年 10 月 30 日 – 2001 年 3 月 30 日:Fabrizio Polacco <_> 在 Debian 项目中维护和增强了此软件包,并得到了整个社区的帮助。
2001 年 3 月 31 日 – 至今:Colin Watson <_> 现在正在开发和维护 man-db。
错误
https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db