Linux Man手册的使用示例

    Linux的命令非常多，很多人在学一个命令时，首先想到的是使用百度或者谷歌，或者参考书上给出怎么使用的例子。但授人以鱼不如授人以渔，通过man该命令可以得到关于该命令的有用信息。当我们学会使用man文档时，将大大提升使用命令的能力。这里，本人认为更多人是不知道列出的选项怎么用，有什么规律，导致不想使用man。为此，本文通过mkdir命令文档做一个示例，希望对读者们有所帮助。

一、man命令

    对于man，将各类命令分为9个板块：

板块 含义 1 可执行文件或者shell命令 2 系统调用（内核提供的函数） 3 库函数 4 特别的文件（通常在/dev） 5 文件格式，如/etc/passwd 6 游戏 7 杂项（包括宏包） 8 系统管理员命令（通常给root用户使用） 9 内核例程（非标准例程）

    那么，这部分和我们有什么关系呢？事实上，当我们man一个命令的时候，默认会从这些模块中查找，但找到的可能不是我们想要的。例如

man mkdir

    得到：

    我们确实得到了mkdir命令的帮助文档。但是如果我要查询mkdir这个系统调用呢？这时就不是我想要的了。从上面表格，可以知道系统调用是在第二部分，这时就要用如下命令：

man 2 mkdir

    这时看到的是MKDIR(2)，表示是系统调用这个板块的。要知道，man在没有指定板块时，将使用一种默认的顺序查找这些板块中的命令，只返回含有该命令的第一个文档。当指定板块时，只从该板块中查找。所以，当我们man得不到想要的文档时，就要给出板块号了。
    下面，我们来对剩余的一些板块的命令举一个例子。

man 3 fread

man 4 tty

man 5 passwd

    这时展示的是/etc/passwd的格式。

二、man mkdir

    这里以man mkdir为例，解释这个文档里面的内容。为了方便，这里对所有非空行添加了行号。

       1    MKDIR(1)                            User Commands                            MKDIR(1)     2  NAME     3         mkdir - make directories     4  SYNOPSIS     5         mkdir [OPTION]... DIRECTORY...     6  DESCRIPTION     7         Create the DIRECTORY(ies), if they do not already exist.     8         Mandatory arguments to long options are mandatory for short options too.     9         -m, --mode=MODE    10                set file mode (as in chmod), not a=rwx - umask    11         -p, --parents    12                no error if existing, make parent directories as needed    13         -v, --verbose    14                print a message for each created directory    15         -Z     set  SELinux  security context of each created directory to the default    16                type    17         --context[=CTX]    18                like -Z, or if CTX is specified then set the SELinux or SMACK  security    19                context to CTX    20         --help display this help and exit    21         --version    22                output version information and exit    23  AUTHOR    24         Written by David MacKenzie.    25  REPORTING BUGS    26         GNU coreutils online help: <http://www.gnu.org/software/coreutils/>    27         Report mkdir translation bugs to <http://translationproject.org/team/>    28  COPYRIGHT    29         Copyright  © 2014 Free Software Foundation, Inc.  License GPLv3+: GNU GPL ver‐    30         sion 3 or later <http://gnu.org/licenses/gpl.html>.    31         This is free software: you are free to change and redistribute it.   There  is    32         NO WARRANTY, to the extent permitted by law.    33  SEE ALSO    34         mkdir(2)    35         Full documentation at: <http://www.gnu.org/software/coreutils/mkdir>    36         or available locally via: info '(coreutils) mkdir invocation'    37  GNU coreutils 8.23                  November 2014                            MKDIR(1)

2.1 man命令文档的构成

    可以看出，文档有几个部分：

部分 解释 NAME 命令的名字 SYNOPSIS 命令的格式 DESCRIPTION 语法，主要是一些选项 AUTHOR 命令的作者 REPORTING BUGS 报告bug的链接 COPYRIGHT 版权 SEE ALSO 更多参考

    一般情况下还可能有其他部分，如EXAMPLES，会给出示例。首先，来看看第5行：

mkdir [OPTION]… DIRECTORY…

    这一行定义了命令的使用格式。[]表示可选，也就是可以添加OPTION，也可以不用添加OPTION。而DIRECTORY不可以缺少，必须至少有一个。…表示可以有多个。如：
a. 无选项，一个DIRECTORY

mkdir mk1

b. 无选项，两个DIRECTORY

mkdir mk2 mk3

c. 两个选项，两个DIRECTORY

mkdir -m 775 -p mk4/tmp mk5

结果：

2.2 参数的使用

    接着看第8行：

Mandatory arguments to long options are mandatory for short options too.

    这句话的意思是：对于长选项必不可少的参数对短选项来说也是必不可少的。
    通常一个选项可以用-开头，给出首个字母，这时是短选项。也可以用–开头，给出全名，这时是长选项。如第9行：

-m, –mode=MODE

    表示既可以用-m这个短选项，也可以用–mode这个长选项。

    另外，后面有一个参数MODE，这个参数是指定被创建目录的权限，而且这个参数是必不可少的，因为没有加[]。这时的用法是-m MODE 或者–mode=MODE。但对于短选项来说，在-m MODE之间的空格一般可以去掉，即变成-mMODE。

    不管哪种情况，MODE这个参数不能去掉。上面提示丢失了参数，出错。

2.3 使用剩余的选项

    剩余的选项类似上面的情况，使用示例如下：