命令：man

简介

man命令，是manual的缩写，manual表示手册的意思。通过man命令，可以查询大多数shell外部命令的帮助手册。

语法格式

# man [[section] page ...] ...

命令行的section我们理解为章节，page就是我们待查询帮助的命令名称。
比如我们想知道man命令自己的帮助手册。

[root@C7 ~]# man man

这个只是最简单的语法格式，详见man手册。

章节

同一个命令的帮助手册有多个章节。当一个命令在多个章节下都有man手册的时候，其查找机制和命令在环境变量PATH中的查找机制类似，会有一个事先定义好的查找顺序，找到第一个man手册之后，就退出查找，将其显示出来，不再查找后续的man手册。
章节是以ID的形式来体现的。章节ID及其对应的含义如下：

• 1 可执行的程序或者shell命令
• 2 系统调用（内核所提供的函数）
• 3 库调用（程序库所提供的函数）
• 4 特殊文件（通常在/dev目录下）
• 5 配置文件（例如/etc/passwd）
• 6 游戏
• 7 杂项（包含宏包和约定），例如man(7)和groff(7)
• 8 系统管理员命令（通常仅供root使用）
• 9 内核例程【非标准】

例如

[root@C7 ~]# man 1 passwd
[root@C7 ~]# man 5 passwd

段落

在每个具体的man手册内部中，也可以有多个section，这里的section我们理解为段落。
常见的段落有：

• NAME：简要描述信息。
• SYNOPSIS：语法格式。
• DESCRIPTION：详细描述信息。
• OPTIONS：选项说明。
• EXIT STATUS：命令执行返回的退出码。
• ENVIRONMENT：相关的环境变量。
• BUGS：如果命令存在BUG，如何反馈给官方。
• EXAMPLE：示例。
• AUTHORS：作者。
• SEE ALSO：命令的扩展信息，一般一个命令会涉及到多个其他的命令或者机制，需要补充了解的信息，会在该段落中说明。

man文本样式

在SYNOPSIS中，会有一些文本样式，它们有各自不同的含义，并且适用于其他的段落：

• bold text：粗体字，表示不可替换的固定值。
• italic text：斜体字，但是一般在终端上，它会显示为下划线字体，表示替换为合适的参数。
• [-abc]：中括号中的表示都可选。
• -a|-b：表示二选一，不可以同时使用。
• argument ...：表示参数可重复。
• [expression] ...：表示整个表达式可重复。

man  [-C  file] [-d] [-D] [--warnings[=warnings]] [-R encoding] [-L locale] [-m system[,...]] [-M path] [-S list] [-e extension] [-i|-I] [--regex|--wildcard] [--names-only] [-a] [-u] [--no-subpages] [-P pager] [-r prompt] [-7] [-E encoding] [--no-hyphenation] [--no-justification] [-p string] [-t]  [-T[device]]  [-H[browser]]  [-X[dpi]]  [-Z]  [[section] page ...] ...

例如从上面的man语法中我们可以看出，man命令是可以不带选项不带参数执行的。

[root@C7 ~]# man
What manual page do you want?

常用选项

• -f, --whatis：详见whatis(1)。
• -k, --apropos：详见apropos(1)。

他们都是用于查找命令有哪些相关的章节，以及各自章节的含义。从结果来看-k相对来说搜索的结果更多一点。

[root@C7 ~]# man -f passwd
passwd (5)           - password file
passwd (1)           - update user's authentication tokens
sslpasswd (1ssl)     - compute password hashes

[root@C7 ~]# man -k passwd
chpasswd (8)         - update passwords in batch mode
fgetpwent_r (3)      - get passwd file entry reentrantly
getpwent_r (3)       - get passwd file entry reentrantly
gpasswd (1)          - administer /etc/group and /etc/gshadow
grub2-mkpasswd-pbkdf2 (1) - Generate a PBKDF2 password hash.
kpasswd (1)          - change a user's Kerberos password
lpasswd (1)          - Change group or user password
lppasswd (1)         - add, change, or delete digest passwords.
pam_localuser (8)    - require users to be listed in /etc/passwd
passwd (1)           - update user's authentication tokens
sslpasswd (1ssl)     - compute password hashes
passwd (5)           - password file
passwd2des (3)       - RFS password encryption
pwhistory_helper (8) - Helper binary that transfers password hashes from passwd or shadow to opasswd
saslpasswd2 (8)      - set a user's sasl password
smbpasswd (5)        - The Samba encrypted password file
vncpasswd (1)        - change the VNC password

• -a, --all：默认情况下，man只会显示最优先的帮助手册。使用该选项的话，会显示所有section下符合搜索条件的帮助手册。

[root@c7-server ~]# man -a passwd
--Man-- next: sslpasswd(1ssl) [ view (return) | skip (Ctrl-D) | quit (Ctrl-C) ]

--Man-- next: passwd(5) [ view (return) | skip (Ctrl-D) | quit (Ctrl-C) ]

当阅读玩passwd(1)的时候，会询问我们是否继续阅读sslpasswd(1ssl)。我们可选择继续、跳过或者干脆直接退出。

• -M path, --manpath=path：默认情况下，man使用manpath的衍生代码来判断帮助手册的搜索路径。可以通过该选项来修改默认的搜索路径。
• -P pager, --pager=pager：帮助手册最后会通过pager显示出来，默认的pager是less -s。可以通过该选项修改。
• -w, --where, --path, --location：不显示帮助手册的内容，而显示帮助手册源nroff文件的位置。nroff文件是帮助手册的源文件，一般是被压缩，当需要被man命令调用展示的时候再解压缩并格式化出来给我们看。
• -W, --where-cat, --location-cat：和-w类似，只不过帮助手册不是源nroff文件，而是cat文件（应该就是纯文本了）。貌似man手册文件一般都是nroff文件格式的。

[root@c7-server ~]# man -wW passwd ps top systemd
/usr/share/man/man1/passwd.1.gz
/usr/share/man/man1/ps.1.gz
/usr/share/man/man1/top.1.gz
/usr/share/man/man1/systemd.1.gz