从Shell中寻找帮助

提示：你可以进一步查看 SDF 的具体帮助说明，如 FAQ！

虽然 UNIX shell 看起来有点令人生畏和冰冷，它有两个字母的神秘命令、几十个命令行开关，而且没有动画回形针为你指明方向，但有几种不同的方法可以从系统中获得帮助。

---

使用手册（帮助文档）

获取帮助的最简单、最全面的方法就是阅读手册。在使用电脑的过程中，你可能在某个地方听说过 RTFM（Read The Fscking Manual），这就是那本《手册》。手册是每种 UNIX 的标准文档形式。学会使用它们。学会爱护它们。

在哪里可以找到它们？其实很简单。想想一个命令(ls、rm、chmod、kill、grep）或一个程序（vi、mutt、snarf、majordomo），然后继续键入

% man command

其中command正是你想了解的命令的名称。正如你所看到的，手册被分成不同的部分。我们以 mkdir 为例。

% man mkdir
MKDIR(1)                NetBSD General Commands Manual                
MKDIR(1)

NAME
     mkdir - make directories

SYNOPSIS
     mkdir [-p] [-m mode] directory_name ...

DESCRIPTION
     mkdir creates the directories named as operands, in the order specified,
     using mode rwxrwxrwx (0777) as modified by the current umask(2).

     The options are as follows:

     -m      Set the file permission bits of the final created directory to
             the specified mode.  The mode argument can be in any of the for-
             mats specified to the chmod(1) utility.  If a symbolic mode is
             specified, the operation characters ``+'' and ``-'' are inter-
             preted relative to an initial mode of ``a=rwx''.

     -p      Create intermediate directories as required.  If this option is
             not specified, the full path prefix of each operand must already
             exist.  Intermediate directories are created with permission bits
             of rwxrwxrwx (0777) as modified by the current umask, plus write
             and search permission for the owner.  Do not consider it an error
             if the argument directory already exists.


     The user must have write permission in the parent directory.
                                                                               
EXIT STATUS
     mkdir exits 0 if successful, and >0 if an error occurred.

SEE ALSO
     chmod(1), rmdir(1), mkdir(2), umask(2)

STANDARDS
     The mkdir utility is expected to be IEEE Std 1003.2 (``POSIX.2'') compat-
     ible.

NetBSD 2.0.2                   January 25, 1994                   NetBSD 
2.0.2

以下为说明的翻译：

% man mkdir
MKDIR(1)                NetBSD General Commands Manual                
MKDIR(1)

名称
     mkdir - 创建目录

语法
     mkdir [-p] [-m mode] directory_name ...

描述
     使用mkdir按照指定对象的顺序创建目录，
     默认使用当前由umask规定的模式 rwxrwxrwx (0777)

     可选项如下：

     -m      将最终创建目录的文件权限设置为指定模式。 
             模式参数可以是为 chmod(1) 工具指定的任何模式。 
             如果指定的是符号模式，操作符 ``+'' 和 ``-'' 将
             相对于初始模式 ``a=rwx'' 进行解释。
             

     -p      根据需要创建中间目录。 如果未指定该选项，
             则每个操作数的完整路径前缀必须已经存在。 
             创建的中间目录权限为 rwxrwxrwx (0777)，
             由当前 umask 修改，外加所有者的写入和搜索权限。
             如果参数目录已经存在，则不视为错误。
                 译者注：比如命令 mkdir -p intermediate/name，
                 其中intermediate就为中间目录，若中间目录不存在则创建一个。
                 若不加参数 -p 则会报错。
     用户必须有写入父目录的权限。
                                                                               
退出状态
     mkdir 如果成功则退出 0，如果出错则退出 >0。

也请看
     chmod(1), rmdir(1), mkdir(2), umask(2)

标准
     mkdir 工具有望与 IEEE Std 1003.2（"POSIX.2"）兼容。


NetBSD 2.0.2                   January 25, 1994                   NetBSD 
2.0.2

对于我们的 mkdir 命令，显示的 man 页面有六个部分：名称（NAME）、语法（SYNOPSIS）、描述（DESCRIPTION）、退出状态（EXIT STATUS）、另见（SEE ALSO）和标准（STANDARDS）。NAME 部分只显示命令名称及其功能的简短描述。SYNOPSIS 部分简要介绍了命令的语法，以便查看输入的命令应该是什么样子。方括号 [ ] 中的项目为可选项。DESCRIPTION 部分详细描述了命令的工作原理，包括命令的各种选项或模式。退出状态（EXIT STATUS）部分描述了命令完成后（成功或失败）生成的状态代码。程序（如 shell 脚本）可以读取这些代码，以确定如何对命令结果做出反应。SEE ALSO 提供了相关命令或其他可能有用命令的交叉参考信息。最后，STANDARDS 部分列出了该命令符合哪些标准的信息。

手册分为九个章节：

1. 用户指令。（User commands)
2. 系统调用和错误编号
3. C 库中的函数。
4. 设备驱动程序
5. 文件格式
6. 游戏和其他娱乐
7. 杂项信息
8. 系统维护和操作命令
9. 内核开发人员

在某些情况下，同一主题会出现在手册的多个章节中。例如，有一个 chmod 用户命令和一个 chmod() 系统调用。如何找到相应的 man 页？您可以告诉 man 您要查找的章节。如果你想查找用户命令，可以键入

% man 1 chmod

这将显示用户命令 chmod 的手册。对具体章节的引用通常放在命令名称后面的括号中，如：chmod(1)