3.12.手册页
===========

FreeBSD 上最详细的文档是以手册页的形式出现的。几乎系统中的每一个程序都有一个简短的参考手册，解释其基本操作和可用参数。可以用 ``man`` 来查看这些手册：

.. raw:: latex

   \diilbookstyleinputcell

.. code:: shell-session

   % man command

其中 *command* 是要了解的命令的名称。例如，要了解更多关于 `ls(1) <https://www.freebsd.org/cgi/man.cgi?query=ls&sektion=1&format=html>`__ 的信息，请输入：

.. raw:: latex

   \diilbookstyleinputcell

.. code:: shell-session

   % man ls

手册页面被划分成多个章节，每个章节有不同的主题。在 FreeBSD 中，有以下几个部分：

1. 用户指令。

2. 系统调用和错误编号。

3. C 库中的函数。

4. 设备驱动程序。

5. 文件格式。

6. 游戏和其他娱乐程序。

7. 杂项信息。

8. 系统维护和操作命令。

9. 系统内核接口。

在某些情况下，同一个主题可能会出现于在线手册的多个部分。例如，有= ``chmod`` 用户命令和 ``chmod()`` 系统调用。要告诉 `man(1) <https://www.freebsd.org/cgi/man.cgi?query=man&sektion=1&format=html>`__ 显示哪一节，需要指定节号：

.. raw:: latex

   \diilbookstyleinputcell

.. code:: shell-session

   % man 1 chmod

这将显示用户命令 `chmod(1) <https://www.freebsd.org/cgi/man.cgi?query=chmod&sektion=1&format=html>`__ 的手册页面。在书面文档中，对在线手册特定章节的引用通常放在括号里，所以 `chmod(1) <https://www.freebsd.org/cgi/man.cgi?query=chmod&sektion=1&format=html>`__ 指的是用户命令，而 `chmod(2) <https://www.freebsd.org/cgi/man.cgi?query=man&sektion=1&format=html>`__ 指的是系统调用。

如果手册页的名称不详，使用 ``man -k`` 来搜索手册页说明中的关键词：

.. raw:: latex

   \diilbookstyleinputcell

.. code:: shell-session

   % man -k mail

这条命令显示了在描述中含有关键字 ``mail`` 的命令列表。这等同于使用 `apropos(1) <https://www.freebsd.org/cgi/man.cgi?query=apropos&sektion=1&format=html>`__\ 。

要阅读 **/usr/sbin** 中所有命令的说明，请输入：

.. raw:: latex

   \diilbookstyleinputcell

.. code:: shell-session

   % cd /usr/sbin
   % man -f * | more

或

.. raw:: latex

   \diilbookstyleinputcell

.. code:: shell-session

   % cd /usr/sbin
   % whatis * |more

3.12.1. GNU Info 文件
---------------------

FreeBSD 包括由自由软件基金会 (FSF) 制作的一些应用程序和实用程序。除了手册页面之外，这些程序还可能包括称为 ``info`` 文件的超文本文件。这些文件可以用 `info(1) <https://www.freebsd.org/cgi/man.cgi?query=info&sektion=1&format=html>`__ 查看，如果安装了 `editors/emacs <https://cgit.freebsd.org/ports/tree/editors/emacs/pkg-descr>`__\ ，则可以用 emacs 的 ``info`` 模式。

要使用 `info(1) <https://www.freebsd.org/cgi/man.cgi?query=info&sektion=1&format=html>`__\ ，请输入：

.. raw:: latex

   \diilbookstyleinputcell

.. code:: shell-session

   % info

要想了解简单的介绍，请键入 ``h``\ ；要想快速获得命令参考，请键入 ``?``\ 。