diff --git a/zh_CN.UTF-8/articles/linux-users/article.xml b/zh_CN.UTF-8/articles/linux-users/article.xml
index 01f4c45b5b..6a81577faa 100644
--- a/zh_CN.UTF-8/articles/linux-users/article.xml
+++ b/zh_CN.UTF-8/articles/linux-users/article.xml
@@ -1,572 +1,572 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
 	"http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd">
 <!--
      The FreeBSD Documentation Project
      The FreeBSD Chinese (Simplified) Documentation Project
 
-     Original Revision: r39170
+     Original Revision: e91a05271f (r39170)
 -->
 <article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="zh_cn">
   <info><title>&linux; 用户的 FreeBSD 快速入门向导</title>
     
 
     <authorgroup>
       <author><personname><firstname>John</firstname><surname>Ferrell</surname></personname></author>
     </authorgroup>
 
     <pubdate>$FreeBSD$</pubdate>
 
     <copyright>
       <year>2008</year>
       <holder>The FreeBSD Documentation Project</holder>
     </copyright>
 
     <releaseinfo>$FreeBSD$</releaseinfo>
 
     <legalnotice xml:id="trademarks" role="trademarks">
       &tm-attrib.freebsd;
       &tm-attrib.linux;
       &tm-attrib.intel;
       &tm-attrib.redhat;
       &tm-attrib.unix;
       &tm-attrib.general;
     </legalnotice>
 
     <abstract>
       <para>本文档旨在快速使那些高级 &linux;
         用户熟悉FreeBSD的一些基础知识。</para>
     </abstract>
   </info>
 
   <sect1 xml:id="intro">
     <title>简介</title>
 
     <para>本文档将突出介绍 &os; 与 &linux; 的差别，
       以使得那些 &linux; 高级用户能自己快速熟悉 &os;
       的基础内容。这只是份技术上的快速入门，
       并非是试图描绘这两种操作系统之间的"哲学"上的差异。</para>
 
     <para>此文档假定认为你已经安装好了 &os;。
       如果你还没有安装 &os; 或者对 &os;
       的安装过程方面需要帮助，请参考 &os; 手册的
       <link xlink:href="&url.base;/doc/en_US.ISO8859-1/books/handbook/install.html">
         安装 FreeBSD</link>一章。</para>
   </sect1>
 
   <sect1 xml:id="shells">
     <title>Shell程序：没有Bash吗？</title>
 
     <para>那些从 &linux; 转过来的用户经常会惊讶于
       <application>Bash</application> 不是 &os; 的默认 Shell。
       事实上，<application>Bash</application> 甚至没有包括在
       &os; 的默认安装中。代替的是，&os; 使用 &man.tcsh.1;
       作为自己的默认 Shell，尽管如此，<application>Bash</application>
       和其他你喜爱的 Shell 程序在 &os; 的
       <link xlink:href="article.html#SOFTWARE">Packages 和 Ports 套件</link>
       里都可以找到。</para>
 
     <para>如果你安装了其他的 Shell 你可以使用 &man.chsh.1;
       来设置一个用户的默认 Shell。 通常情况下，
       强烈建议不要去更改 <systemitem class="username">root</systemitem>
       用户的默认 Shell。原因是这些 Shell
       没有包括在基本系统中，正常情况下它们会被安装到
       <filename>/usr/local/bin</filename> 和
       <filename>/usr/bin</filename> 目录下。万一某天
       <filename>/usr/local/bin</filename> 和
       <filename>/usr/bin</filename> 的文件系统不能被挂载，
       这样情况下 <systemitem class="username">root</systemitem>
       将不能进入自己默认的 Shell，从而
       <systemitem class="username">root</systemitem> 将不能够登录进去。
       鉴于这个原因，第二个系统管理员帐户
       <systemitem class="username">toor</systemitem> 创建时使用的是非默认的
       Shell。在安全 FAQ 可以查阅到关于 <link xlink:href="&url.base;/doc/en_US.ISO8859-1/books/faq/security.html#TOOR-ACCOUNT">toor 帐户</link>
       的信息。</para>
   </sect1>
 
   <sect1 xml:id="software">
     <title>Packages和Ports：在 &os; 中添加软件</title>
 
     <para>除了经典的 &unix; 安装软件的方法
       （下载源码包，解压，编辑源码，编译）外，&os;
       还提供了另外两种方法来安装应用程序：packages 和 ports。
       你可以在 <link xlink:href="http://www.freebsd.org/ports/master-index.html">这里</link>
       到一份完整可用的 ports 和 packages 的软件清单。</para>
 
     <sect2 xml:id="packages">
       <title>Packages</title>
 
       <para>Packages 是预编译好的应用程序，在 &os;
         中等价于基于 Debian/Ubuntu 的系统中的
         <filename>.deb</filename> 软件包以及基于
         Red&nbsp;Hat/Fedora 的系统中的
         <filename>.rpm</filename> 软件包。
         Packages使用 &man.pkg.add.1; 来进行安装。
         例如，下面的命令将用来安装
         <application>Apache 2.2</application>：</para>
 
       <screen>&prompt.root; <userinput>pkg_add /tmp/apache-2.2.6_2.tbz</userinput></screen>
 
       <para>使用 <option>-r</option> 操作将告诉 &man.pkg.add.1;
         来自动获取并安装一个软件包，以及解决所有的依赖关系：</para>
 
       <screen>&prompt.root; <userinput>pkg_add -r apache22</userinput>
 Fetching ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-6.2-release/Latest/apache22.tbz... Done.
 Fetching ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-6.2-release/All/expat-2.0.0_1.tbz... Done.
 Fetching ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-6.2-release/All/perl-5.8.8_1.tbz... Done.
 [snip]
 
 To run apache www server from startup, add apache22_enable="YES"
 in your /etc/rc.conf. Extra options can be found in startup script.</screen>
 
       <note>
         <para>如果你正运行着 release 版本的 &os; （6.2，6.3，7.0等，
           通常从 CD-ROM 被安装的）<command>pkg_add -r</command>
           会为其下载专门为这些特定版本构建好的软件包。
           这些软件包 <emphasis>可能</emphasis> 不是当前最新的程序。
           你可以使用 <envar>PACKAGESITE</envar> 变量来覆盖默认的动作。
           例如，把 <envar>PACHAGESITE</envar> 设置成
           <uri xlink:href="ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-6-stable/Latest/">ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-6-stable/Latest/</uri>
           来下载 6.X 系列最新的包。</para>
       </note>
 
       <para>想了解更多的 packages 信息请查阅 &os;
         手册的 4.4 小节：<link xlink:href="&url.base;/doc/en_US.ISO8859-1/books/handbook/packages-using.html">使用 Packages 系统</link>。</para>
     </sect2>
 
     <sect2 xml:id="ports">
       <title>Ports</title>
 
       <para>&os; 的第二种安装应用程序的方法就是使用 Ports 套件了。
         Ports 套件是 &os; 上的一个利用 <filename>Makefile</filename>
         和一些补丁文件来特定从源码定制安装各种软件程序的框架。
         当安装一个 port 时系统会获取程序源码，
         应用任何所需要的补丁，编译源码，
         并安装应用程序（并针对依赖关系以同样的方式安装解决）。</para>
 
       <para>Ports 套件，常被称作 ports 树，可以在
         <filename>/usr/ports</filename> 下找到。
         假设Ports套件已经在安装 &os; 时安装过了。
         如果 Ports 套件还没有被安装可以通过 &man.sysinstall.8;
         来进行安装，或者使用 &man.csup.1; 或 &man.portsnap.8;
         来从 &os; 的服务器上面拉下来。在手册的 <link xlink:href="&url.base;/doc/en_US.ISO8859-1/books/handbook/ports-using.html">4.5.1 小节</link>
         可以找到安装 Ports 套件的详细介绍。</para>
 
       <para>安装一个 port 就像进入 port
         的目录并开始构建过程一样简单（通常情况下），
         下面是从 Ports 套件安装
         <application>Apache 2.2</application> 的例子：</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/www/apache22</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
 
       <para>使用 ports 安装软件的最大好处就是能够自定义安装选项。
         例如，从 ports 安装 <application>Apache 2.2</application>
         时你可以通过设置 <varname>WITH_LDAP</varname> &man.make.1;
         变量来启用 <application>mod_ldap</application>：</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/www/apache22</userinput>
 &prompt.root; <userinput>make WITH_LDAP="YES" install clean</userinput></screen>
 
       <para>请查看 &os; 手册的 4.5 小节，<link xlink:href="&url.base;/doc/en_US.ISO8859-1/books/handbook/ports-using.html">
 	 使用 Ports&nbsp;Collection</link>，
         以获取更多关于Ports&nbsp;Collection 的信息。</para>
     </sect2>
 
     <sect2 xml:id="which">
       <title>Ports还是packages，我应该使用哪个？</title>
 
       <para>Packages 就是预编译好的 ports，
         所以从源码（ports）安装与从二进制 packages
         安装这两者间确实有很大关联。每种方法各有自己的优点：</para>
 
       <itemizedlist>
         <title>Packages（二进制）</title>
 
         <listitem><simpara>更快速的安装
             （比较大的应用程序编译起来会花很长时间）。</simpara></listitem>
 
         <listitem><simpara>你不需要知道如何编译软件。</simpara></listitem>
 
         <listitem><simpara>不需要在操作系统上安装编译器。</simpara></listitem>
       </itemizedlist>
 
       <itemizedlist>
         <title>Ports（源码）</title>
 
         <listitem><simpara>能够定制安装选项。
             （Packages通常都是使用标准选项构建的。使用 ports
             你能够定义各种各样的选项，
             比如类似构建附加的模块或是更改安装路径之类的。）</simpara></listitem>
 
         <listitem><simpara>如果你喜欢的话还可以使用自己的补丁。</simpara></listitem>
       </itemizedlist>
 
       <para>如果你没有一些特别的需求， packages
         可能刚好最适合你的情况。如果你需要进一步定制，
         ports 是最适合的方法了。（请记得，
         如果你需要定制而自己又更倾向于使用 packages，
         你可以使用 <command>make</command>
 	<buildtarget>package</buildtarget> 从 ports
         构建一个定制的 package，然后复制到其他的服务器。）</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="startup">
     <title>系统启动：运行级别在哪里？</title>
 
     <para>&linux; 使用 Sysv init 初始化系统，而 &os;
       使用的是传统的 BSD 风格的 &man.init.8;。在 BSD 风格的
       &man.init.8; 中没有运行级别和 <filename>/etc/inittab</filename>，
       代替控制启动的是 &man.rc.8; 实用程序。
       <filename>/etc/rc</filename> 脚本读取
       <filename>/etc/defaults/rc.conf</filename> 和
       <filename>/etc/rc.conf</filename> 文件来决定哪个服务将被启动。
       特殊服务在此后由处于 <filename>/etc/rc.d/</filename> 和
       <filename>/usr/local/etc/rc.d/</filename>
       下的相应服务初始化脚本文件所启动。
       这些脚本类似于位于 &linux; 系统中的
       <filename>/etc/init.d/</filename> 目录下的脚本。</para>
 
     <sidebar>
       <para><emphasis>为何会有两个服务初始化脚本的目录呢？</emphasis>
         <filename>/etc/rc.d/</filename> 下的脚本是属于
         <quote>基本</quote> 系统一部分的应用程序所使用的。
         （&man.cron.8;，&man.sshd.8;，&man.syslog.3;，以及其他。）
         <filename>/usr/local/etc/rc.d/</filename>
         下的脚本是用户安装的应用程序如 <application>Apache</application>，
         <application>Squid</application> 等使用的。</para>
 
       <para><emphasis><quote>基本</quote>
           系统和用户安装的应用程序之间的区别是什么？</emphasis> FreeBSD
         是一套开发出来的完整的操作系统，也就是说，内核，系统类库，
         还有实用应用程序（如 &man.ls.1;，&man.cat.1;，&man.cp.1; 等）
         全部被做为一个整体一起开发并释出。这就是被认为归属于
         <quote>基本</quote>系统的程序。用户安装的程序并不是
         <quote>基本</quote>系统的一部分，如
         <application>Apache</application>，<application>X11</application>，
         <application>Moazilla&nbsp;Firefox</application>，等等。这
         些用户安装的应用程序通常是使用 &os; 的 Packages 和 Ports
         套件安装上去的。为了将这些程序和 <quote>基本</quote>
         系统区分开来，用户安装的应用程序通常被安装到
         <filename>/usr/local/</filename>下。
         因此用户安装的二进制执行文件存在于
         <filename>/usr/local/bin</filename>下，配置文件在
         <filename>/usr/local/etc</filename>下，以此类推。</para>
     </sidebar>
 
     <para>您可以通过在
       <filename>/etc/rc.conf</filename>（&man.rc.conf.5;）
       文件中增加与之对应的
       <literal>ServiceName_enable="YES"</literal>
       配置来启用服务。 看一下系统默认的
       <filename>/etc/defaults/rc.conf</filename> 文件， 这些默认配置可以使用
       <filename>/etc/rc.conf</filename> 文件来改变。 因此，
       当安装附加应用程序时最好回顾下文档来决定到底该如何启用任何相关的服务。</para>
 
     <para>下面的一小段内容用来在 <filename>/etc/rc.conf</filename>
       中启用 &man.sshd.8; 和 <application>Apache 2.2</application>。
       还指定了 <application>Apache</application> 应该通过
       SSL 方式启动。</para>
 
     <programlisting># enable SSHD
 sshd_enable="YES"
 # enable Apache with SSL
 apache22_enable="YES"
 apache22_flags="-DSSL"</programlisting>
 
     <para>一旦服务已经在 <filename>/etc/rc.conf</filename>
       中启用，服务将能够从命令行启动（不需要重新启动系统）：</para>
 
     <screen>&prompt.root; <userinput>/etc/rc.d/sshd start</userinput></screen>
 
     <para>如果服务还没有被启用，可以使用
       <option>forcestart</option> 来从命令行启动：</para>
 
     <screen>&prompt.root; <userinput>/etc/rc.d/sshd forcestart</userinput></screen>
   </sect1>
 
   <sect1 xml:id="network">
     <title>网络配置</title>
 
     <sect2 xml:id="interfaces">
       <title>网络接口</title>
 
       <para>代替 &linux; 中所使用的标识网络接口所常用的
         <emphasis>ethX</emphasis> 格式的是，&os;
         使用驱动名字后跟一个数字来标识。下面
         &man.ifconfig.8; 的输出显示了两个 &intel;&nbsp;Pro&nbsp;1000
         的网络接口（<filename>em0</filename> 和 <filename>em1</filename>）：</para>
 
       <screen>&prompt.user; <userinput>ifconfig</userinput>
 em0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; mtu 1500
         options=b&lt;RXCSUM,TXCSUM,VLAN_MTU&gt;
         inet 10.10.10.100 netmask 0xffffff00 broadcast 10.10.10.255
         ether 00:50:56:a7:70:b2
         media: Ethernet autoselect (1000baseTX &lt;full-duplex&gt;)
         status: active
 em1: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; mtu 1500
         options=b&lt;RXCSUM,TXCSUM,VLAN_MTU&gt;
         inet 192.168.10.222 netmask 0xffffff00 broadcast 192.168.10.255
         ether 00:50:56:a7:03:2b
         media: Ethernet autoselect (1000baseTX &lt;full-duplex&gt;)
         status: active</screen>
     </sect2>
 
     <sect2 xml:id="ipaddress">
       <title>IP配置</title>
 
       <para>一个 IP 地址可以使用 &man.ifconfig.8;
         来指定到一个网络接口。通常，要保持重启后依然能够使用的
         IP 配置信息需要包含在 <filename>/etc/rc.conf</filename>
         中。下列例子指定了主机名，IP 地址，以及默认网关：</para>
 
       <programlisting>hostname="server1.example.com"
 ifconfig_em0="inet 10.10.10.100  netmask 255.255.255.0"
 defaultrouter="10.10.10.1"</programlisting>
 
       <para>使用下面内容来为网络接口配置DHCP：</para>
 
       <programlisting>hostname="server1.example.com"
 ifconfig_em0="DHCP"</programlisting>
 
     </sect2>
   </sect1>
 
   <sect1 xml:id="firewall">
     <title>防火墙</title>
 
     <para>像 &linux; 中的 <application>IPTABLES</application>
       一样， &os; 也提供了一个内核级的防火墙；
       实际上 &os; 提供了三个防火墙：</para>
 
     <itemizedlist>
       <listitem><simpara><link xlink:href="&url.base;/doc/en_US.ISO8859-1/books/handbook/firewalls-ipfw.html">IPFIREWALL</link></simpara></listitem>
       <listitem><simpara><link xlink:href="&url.base;/doc/en_US.ISO8859-1/books/handbook/firewalls-ipf.html">IPFILTER</link></simpara></listitem>
       <listitem><simpara><link xlink:href="&url.base;/doc/en_US.ISO8859-1/books/handbook/firewalls-pf.html">PF</link></simpara></listitem>
     </itemizedlist>
 
     <para><application>IPFIREWALL</application> 或是
       <application>IPFW</application>（管理
       <application>IPFW</application> 规则的 &man.ipfw.8; 命令）
       是 &os; 开发者开发并维持的。
       <application>IPFW</application> 能够与 &man.dummynet.4;
       配合使用来提供流量图形功能以及模拟不同网络连接类型的功能。</para>
 
     <para>允许 <application>SSH</application>
       进入的 <application>IPFW</application> 规则样例如下：</para>
 
     <programlisting>ipfw add allow tcp from any to me 22 in via $ext_if</programlisting>
 
     <para><application>IPFILTER</application> 是
       Darren&nbsp;Reed 所开发的防火墙程序。不是专门针对
       &os; 的，它已经被移植到 NetBSD，OpenBSD，SunOS，HP/UX，
       还有Solaris等一些操作系统之上。</para>
 
     <para>允许 <application>SSH</application>
       进入的 <application>IPFILTER</application>
       命令样例如下：</para>
 
     <programlisting>pass in on $ext_if proto tcp from any to any port = 22</programlisting>
 
     <para>最后一种防火墙程序，<application>PF</application>，
       是 OpenBSD 项目所开发的。<application>PF</application>
       是被作为 <application>IPFILTER</application>
       的一个替代品而被创建出的。就这点而言，
       <application>PF</application> 的语法与
       <application>IPFILTER</application> 的非常相似。
       <application>PF</application> 可以与 &man.altq.4;
       配合来提供 QoS 的特性。</para>
 
      <para>允许 <application>SSH</application>
        进入的 <application>PF</application>
        命令样例如下：</para>
 
      <programlisting>pass in on $ext_if inet proto tcp from any to ($ext_if) port 22</programlisting>
   </sect1>
 
   <sect1 xml:id="updates">
     <title>升级 &os;</title>
 
     <para>共有三种方法来升级 &os; 系统：
       源码，二进制更新，还有安装光盘。</para>
 
     <para>从源码升级是最复杂的升级方法，但是提供了最棒的总体灵活性。
       这个过程包含了使用 &os; <application>CVS</application>
       （并行版本系统）来同步一个本地的 &os; 源代码。
       一旦本地源码已经更新到当前最新你便可以构建新版本的内核以及应用程序。
       关于源码更新的更多信息可见于 &os; 手册
       <link xlink:href="&url.base;/doc/en_US.ISO8859-1/books/handbook/cutting-edge.html">
         关于如何更新操作系统的章节</link>。</para>
 
     <para>二进制更新类似于使用 <command>yum</command> 或
       <command>apt-get</command> 更新 &linux; 系统。
       &man.freebsd-update.8; 命令会获取新的更新并安装它们。
       这些更新可以通过 &man.cron.8; 使用程序来调度。</para>
 
     <note>
       <para>如果你使用 &man.cron.8; 来预定更新，
         请确信在你的 &man.crontab.1; 中使用了
         <command>freebsd-update cron</command>
         来控制大数目的机器同时获取更新。</para>
 
       <programlisting>0 3 * * * root /usr/sbin/freebsd-update cron</programlisting>
     </note>
 
     <para>最后一种更新的方法，从安装光盘来升级，是个直接的过程。
       从安装光盘启动并选择该选项来更新。</para>
   </sect1>
 
   <sect1 xml:id="procfs">
     <title>procfs：已是过去式但仍未被遗忘</title>
 
     <para>&linux; 中，你可能会通过看一看
       <filename>/proc/sys/net/ipv4/ip_forward</filename>
       来确定 IP 转发是否被启用。在 &os; 中你应该使用 &man.sysctl.8;
       来查看这和其他方面的系统设置，在当前的 &os; 版本中
       &man.procfs.5; 已经不赞成使用了。（虽然
       <command>sysctl</command>在 &os; 也同样可用。）</para>
 
     <para>在 IP 转发样例中，你应该使用下列内容来确定 &os;
       系统中是否已经开启了 IP 转发：</para>
 
     <screen>&prompt.user; <userinput>sysctl net.inet.ip.forwarding</userinput>
 net.inet.ip.forwarding: 0</screen>
 
     <para><option>-a</option> 标志用来列出所有的系统设置：</para>
 
     <screen>&prompt.user; <userinput>sysctl -a</userinput>
 kern.ostype: FreeBSD
 kern.osrelease: 6.2-RELEASE-p9
 kern.osrevision: 199506
 kern.version: FreeBSD 6.2-RELEASE-p9 #0: Thu Nov 29 04:07:33 UTC 2007
     root@i386-builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC
 
 kern.maxvnodes: 17517
 kern.maxproc: 1988
 kern.maxfiles: 3976
 kern.argmax: 262144
 kern.securelevel: -1
 kern.hostname: server1
 kern.hostid: 0
 kern.clockrate: { hz = 1000, tick = 1000, profhz = 666, stathz = 133 }
 kern.posix1version: 200112
 ...</screen>
 
     <note>
       <para>某些 <command>sysctl</command> 的参数是只读的。</para>
     </note>
 
     <para>需要 procfs 的情况是，运行一些较老的软件，使用
       &man.truss.1; 来跟踪系统信号，以及
       <link xlink:href="&url.base;/doc/en_US.ISO8859-1/books/handbook/linuxemu.html">&linux; 二进制兼容</link>.
       （尽管，&linux; 二进制兼容性使用其本身的 procfs，&man.linprocfs.5;。）
       如果你需要挂载 procfs 你可以在
       <filename>/etc/fstab</filename> 中加入如下内容：</para>
 
     <screen>proc                /proc           procfs  rw,noauto       0       0</screen>
 
     <note>
       <para><option>noauto</option> 会防止
         <filename>/proc</filename> 在启动时被自动挂载。</para>
     </note>
 
     <para>然后使用如下命令挂载 procfs：</para>
 
     <screen>&prompt.root; <userinput>mount /proc</userinput></screen>
   </sect1>
 
   <sect1 xml:id="commands">
     <title>常用命令</title>
 
     <sect2 xml:id="packageCommands">
       <title>软件包管理</title>
 
       <para>
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>&linux; 命令 (Red&nbsp;Hat/Debian)</entry>
 		<entry>&os; 等价命令</entry>
 		<entry>目的</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><command>yum install package</command> / <command>apt-get install package</command></entry>
 		<entry><command>pkg_add -r package</command></entry>
 		<entry>从远程仓库安装 <replaceable>package</replaceable></entry>
 	      </row>
 
 	      <row>
 		<entry><command>rpm -ivh package</command> / <command>dpkg -i package</command></entry>
 		<entry><command>pkg_add -v package</command></entry>
 		<entry>安装 package</entry>
 	      </row>
 
 	      <row>
 		<entry><command>rpm -qa</command> / <command>dpkg -l</command></entry>
 		<entry><command>pkg_info</command></entry>
 		<entry>列出已安装的软件包</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
       </para>
     </sect2>
 
     <sect2 xml:id="systemCommands">
       <title>系统管理</title>
 
       <para>
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>&linux; 命令</entry>
 		<entry>&os; 等价命令</entry>
 		<entry>目的</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><command>lspci</command></entry>
 		<entry><command>pciconf</command></entry>
 		<entry>列出 PCI 设备</entry>
 	      </row>
 
 	      <row>
 		<entry><command>lsmod</command></entry>
 		<entry><command>kldstat</command></entry>
 		<entry>列出已载入的内核模块</entry>
 	      </row>
 
 	      <row>
 		<entry><command>modprobe</command></entry>
 		<entry><command>kldload</command> / <command>kldunload</command></entry>
 		<entry>载入/卸载内核模块</entry>
 	      </row>
 
 	      <row>
 		<entry><command>strace</command></entry>
 		<entry><command>truss</command></entry>
 		<entry>跟踪系统调用</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
       </para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="conclusion">
     <title>总结</title>
 
     <para>非常希望这篇文档能够给予你足够的帮助来开始你的
       &os; 之路。务必要再去看一下 <link xlink:href="&url.base;/doc/en_US.ISO8859-1/books/handbook/index.html">&os;&nbsp;手册</link>
       所提到的但并没有被包含在本文档中的那些更深入广泛的主题。</para>
   </sect1>
 </article>
diff --git a/zh_CN.UTF-8/books/handbook/Makefile b/zh_CN.UTF-8/books/handbook/Makefile
index 7e61b0b781..b33ad425eb 100644
--- a/zh_CN.UTF-8/books/handbook/Makefile
+++ b/zh_CN.UTF-8/books/handbook/Makefile
@@ -1,334 +1,334 @@
 #
 # $FreeBSD$
 #
 # Build the FreeBSD Handbook (Simplified Chinese).
 #
-# Original revision: r38039
+# Original Revision: 71484c537f (r38039)
 
 # ------------------------------------------------------------------------
 #
 # To add a new chapter to the Handbook:
 #
 # - Update this Makefile, chapters.ent and book.xml
 # - Add a descriptive entry for the new chapter in preface/preface.xml
 #
 # ------------------------------------------------------------------------
 
 .PATH: ${.CURDIR}/../../share/xml/glossary
 
 MAINTAINER=	doc@FreeBSD.org
 
 DOC?= book
 
 FORMATS?= html-split
 
 INSTALL_COMPRESSED?= gz
 INSTALL_ONLY_COMPRESSED?=
 
 IMAGES_EN = advanced-networking/isdn-bus.eps
 IMAGES_EN+= advanced-networking/isdn-twisted-pair.eps
 IMAGES_EN+= advanced-networking/natd.eps
 IMAGES_EN+= advanced-networking/net-routing.pic
 IMAGES_EN+= advanced-networking/static-routes.pic
 IMAGES_EN+= bsdinstall/bsdinstall-adduser1.png
 IMAGES_EN+= bsdinstall/bsdinstall-adduser2.png
 IMAGES_EN+= bsdinstall/bsdinstall-adduser3.png
 IMAGES_EN+= bsdinstall/bsdinstall-boot-loader-menu.png
 IMAGES_EN+= bsdinstall/bsdinstall-choose-mode.png
 IMAGES_EN+= bsdinstall/bsdinstall-config-components.png
 IMAGES_EN+= bsdinstall/bsdinstall-config-hostname.png
 IMAGES_EN+= bsdinstall/bsdinstall-config-keymap.png
 IMAGES_EN+= bsdinstall/bsdinstall-config-services.png
 IMAGES_EN+= bsdinstall/bsdinstall-config-crashdump.png
 IMAGES_EN+= bsdinstall/bsdinstall-configure-network-interface-ipv4-dhcp.png
 IMAGES_EN+= bsdinstall/bsdinstall-configure-network-interface-ipv4.png
 IMAGES_EN+= bsdinstall/bsdinstall-configure-network-interface-ipv4-static.png
 IMAGES_EN+= bsdinstall/bsdinstall-configure-network-interface-ipv6.png
 IMAGES_EN+= bsdinstall/bsdinstall-configure-network-interface-ipv6-static.png
 IMAGES_EN+= bsdinstall/bsdinstall-configure-network-interface-slaac.png
 IMAGES_EN+= bsdinstall/bsdinstall-configure-network-interface.png
 IMAGES_EN+= bsdinstall/bsdinstall-configure-network-ipv4-dns.png
 IMAGES_EN+= bsdinstall/bsdinstall-configure-wireless-accesspoints.png
 IMAGES_EN+= bsdinstall/bsdinstall-configure-wireless-scan.png
 IMAGES_EN+= bsdinstall/bsdinstall-configure-wireless-wpa2setup.png
 IMAGES_EN+= bsdinstall/bsdinstall-distfile-extracting.png
 IMAGES_EN+= bsdinstall/bsdinstall-distfile-fetching.png
 IMAGES_EN+= bsdinstall/bsdinstall-distfile-verifying.png
 IMAGES_EN+= bsdinstall/bsdinstall-final-confirmation.png
 IMAGES_EN+= bsdinstall/bsdinstall-finalconfiguration.png
 IMAGES_EN+= bsdinstall/bsdinstall-final-modification-shell.png
 IMAGES_EN+= bsdinstall/bsdinstall-keymap-select-default.png
 IMAGES_EN+= bsdinstall/bsdinstall-mainexit.png
 IMAGES_EN+= bsdinstall/bsdinstall-netinstall-files.png
 IMAGES_EN+= bsdinstall/bsdinstall-netinstall-mirrorselect.png
 IMAGES_EN+= bsdinstall/bsdinstall-part-entire-part.png
 IMAGES_EN+= bsdinstall/bsdinstall-part-guided-disk.png
 IMAGES_EN+= bsdinstall/bsdinstall-part-guided-manual.png
 IMAGES_EN+= bsdinstall/bsdinstall-part-manual-addpart.png
 IMAGES_EN+= bsdinstall/bsdinstall-part-manual-create.png
 IMAGES_EN+= bsdinstall/bsdinstall-part-manual-partscheme.png
 IMAGES_EN+= bsdinstall/bsdinstall-part-review.png
 IMAGES_EN+= bsdinstall/bsdinstall-post-root-passwd.png
 IMAGES_EN+= bsdinstall/bsdinstall-set-clock-local-utc.png
 IMAGES_EN+= bsdinstall/bsdinstall-timezone-confirm.png
 IMAGES_EN+= bsdinstall/bsdinstall-timezone-country.png
 IMAGES_EN+= bsdinstall/bsdinstall-timezone-region.png
 IMAGES_EN+= bsdinstall/bsdinstall-timezone-zone.png
 IMAGES_EN+= geom/striping.pic
 IMAGES_EN+= install/adduser1.scr
 IMAGES_EN+= install/adduser2.scr
 IMAGES_EN+= install/adduser3.scr
 IMAGES_EN+= install/boot-loader-menu.scr
 IMAGES_EN+= install/boot-mgr.scr
 IMAGES_EN+= install/config-country.scr
 IMAGES_EN+= install/config-keymap.scr
 IMAGES_EN+= install/console-saver1.scr
 IMAGES_EN+= install/console-saver2.scr
 IMAGES_EN+= install/console-saver3.scr
 IMAGES_EN+= install/console-saver4.scr
 IMAGES_EN+= install/disklabel-auto.scr
 IMAGES_EN+= install/disklabel-ed1.scr
 IMAGES_EN+= install/disklabel-ed2.scr
 IMAGES_EN+= install/disklabel-fs.scr
 IMAGES_EN+= install/disklabel-root1.scr
 IMAGES_EN+= install/disklabel-root2.scr
 IMAGES_EN+= install/disklabel-root3.scr
 IMAGES_EN+= install/disk-layout.eps
 IMAGES_EN+= install/dist-set.scr
 IMAGES_EN+= install/dist-set2.scr
 IMAGES_EN+= install/docmenu1.scr
 IMAGES_EN+= install/ed0-conf.scr
 IMAGES_EN+= install/ed0-conf2.scr
 IMAGES_EN+= install/edit-inetd-conf.scr
 IMAGES_EN+= install/fdisk-drive1.scr
 IMAGES_EN+= install/fdisk-drive2.scr
 IMAGES_EN+= install/fdisk-edit1.scr
 IMAGES_EN+= install/fdisk-edit2.scr
 IMAGES_EN+= install/ftp-anon1.scr
 IMAGES_EN+= install/ftp-anon2.scr
 IMAGES_EN+= install/hdwrconf.scr
 IMAGES_EN+= install/keymap.scr
 IMAGES_EN+= install/main1.scr
 IMAGES_EN+= install/mainexit.scr
 IMAGES_EN+= install/main-std.scr
 IMAGES_EN+= install/main-options.scr
 IMAGES_EN+= install/main-doc.scr
 IMAGES_EN+= install/main-keymap.scr
 IMAGES_EN+= install/media.scr
 IMAGES_EN+= install/mouse1.scr
 IMAGES_EN+= install/mouse2.scr
 IMAGES_EN+= install/mouse3.scr
 IMAGES_EN+= install/mouse4.scr
 IMAGES_EN+= install/mouse5.scr
 IMAGES_EN+= install/mouse6.scr
 IMAGES_EN+= install/mta-main.scr
 IMAGES_EN+= install/net-config-menu1.scr
 IMAGES_EN+= install/net-config-menu2.scr
 IMAGES_EN+= install/nfs-server-edit.scr
 IMAGES_EN+= install/ntp-config.scr
 IMAGES_EN+= install/options.scr
 IMAGES_EN+= install/pkg-cat.scr
 IMAGES_EN+= install/pkg-confirm.scr
 IMAGES_EN+= install/pkg-install.scr
 IMAGES_EN+= install/pkg-sel.scr
 IMAGES_EN+= install/probstart.scr
 IMAGES_EN+= install/routed.scr
 IMAGES_EN+= install/security.scr
 IMAGES_EN+= install/sysinstall-exit.scr
 IMAGES_EN+= install/timezone1.scr
 IMAGES_EN+= install/timezone2.scr
 IMAGES_EN+= install/timezone3.scr
 IMAGES_EN+= install/userconfig.scr
 IMAGES_EN+= install/userconfig2.scr
 IMAGES_EN+= mail/mutt1.scr
 IMAGES_EN+= mail/mutt2.scr
 IMAGES_EN+= mail/mutt3.scr
 IMAGES_EN+= mail/pine1.scr
 IMAGES_EN+= mail/pine2.scr
 IMAGES_EN+= mail/pine3.scr
 IMAGES_EN+= mail/pine4.scr
 IMAGES_EN+= mail/pine5.scr
 
 IMAGES_EN+= install/example-dir1.eps
 IMAGES_EN+= install/example-dir2.eps
 IMAGES_EN+= install/example-dir3.eps
 IMAGES_EN+= install/example-dir4.eps
 IMAGES_EN+= install/example-dir5.eps
 IMAGES_EN+= security/ipsec-network.pic
 IMAGES_EN+= security/ipsec-crypt-pkt.pic
 IMAGES_EN+= security/ipsec-encap-pkt.pic
 IMAGES_EN+= security/ipsec-out-pkt.pic
 IMAGES_EN+= vinum/vinum-concat.pic
 IMAGES_EN+= vinum/vinum-mirrored-vol.pic
 IMAGES_EN+= vinum/vinum-raid10-vol.pic
 IMAGES_EN+= vinum/vinum-raid5-org.pic
 IMAGES_EN+= vinum/vinum-simple-vol.pic
 IMAGES_EN+= vinum/vinum-striped-vol.pic
 IMAGES_EN+= vinum/vinum-striped.pic
 IMAGES_EN+= virtualization/parallels-freebsd1.png
 IMAGES_EN+= virtualization/parallels-freebsd2.png
 IMAGES_EN+= virtualization/parallels-freebsd3.png
 IMAGES_EN+= virtualization/parallels-freebsd4.png
 IMAGES_EN+= virtualization/parallels-freebsd5.png
 IMAGES_EN+= virtualization/parallels-freebsd6.png
 IMAGES_EN+= virtualization/parallels-freebsd7.png
 IMAGES_EN+= virtualization/parallels-freebsd8.png
 IMAGES_EN+= virtualization/parallels-freebsd9.png
 IMAGES_EN+= virtualization/parallels-freebsd10.png
 IMAGES_EN+= virtualization/parallels-freebsd11.png
 IMAGES_EN+= virtualization/parallels-freebsd12.png
 IMAGES_EN+= virtualization/parallels-freebsd13.png
 IMAGES_EN+= virtualization/virtualpc-freebsd1.png
 IMAGES_EN+= virtualization/virtualpc-freebsd2.png
 IMAGES_EN+= virtualization/virtualpc-freebsd3.png
 IMAGES_EN+= virtualization/virtualpc-freebsd4.png
 IMAGES_EN+= virtualization/virtualpc-freebsd5.png
 IMAGES_EN+= virtualization/virtualpc-freebsd6.png
 IMAGES_EN+= virtualization/virtualpc-freebsd7.png
 IMAGES_EN+= virtualization/virtualpc-freebsd8.png
 IMAGES_EN+= virtualization/virtualpc-freebsd9.png
 IMAGES_EN+= virtualization/virtualpc-freebsd10.png
 IMAGES_EN+= virtualization/virtualpc-freebsd11.png
 IMAGES_EN+= virtualization/virtualpc-freebsd12.png
 IMAGES_EN+= virtualization/virtualpc-freebsd13.png
 IMAGES_EN+= virtualization/vmware-freebsd01.png
 IMAGES_EN+= virtualization/vmware-freebsd02.png
 IMAGES_EN+= virtualization/vmware-freebsd03.png
 IMAGES_EN+= virtualization/vmware-freebsd04.png
 IMAGES_EN+= virtualization/vmware-freebsd05.png
 IMAGES_EN+= virtualization/vmware-freebsd06.png
 IMAGES_EN+= virtualization/vmware-freebsd07.png
 IMAGES_EN+= virtualization/vmware-freebsd08.png
 IMAGES_EN+= virtualization/vmware-freebsd09.png
 IMAGES_EN+= virtualization/vmware-freebsd10.png
 IMAGES_EN+= virtualization/vmware-freebsd11.png
 IMAGES_EN+= virtualization/vmware-freebsd12.png
 
 # Images from the cross-document image library
 IMAGES_LIB=  callouts/1.png
 IMAGES_LIB+= callouts/2.png
 IMAGES_LIB+= callouts/3.png
 IMAGES_LIB+= callouts/4.png
 IMAGES_LIB+= callouts/5.png
 IMAGES_LIB+= callouts/6.png
 IMAGES_LIB+= callouts/7.png
 IMAGES_LIB+= callouts/8.png
 IMAGES_LIB+= callouts/9.png
 IMAGES_LIB+= callouts/10.png
 IMAGES_LIB+= callouts/11.png
 IMAGES_LIB+= callouts/12.png
 IMAGES_LIB+= callouts/13.png
 IMAGES_LIB+= callouts/14.png
 IMAGES_LIB+= callouts/15.png
 
 #
 # SRCS lists the individual XML files that make up the document. Changes
 # to any of these files will force a rebuild
 #
 
 # XML content
 SRCS+= audit/chapter.xml
 SRCS+= book.xml
 SRCS+= bsdinstall/chapter.xml
 SRCS+= colophon.xml
 SRCS+= dtrace/chapter.xml
 SRCS+= advanced-networking/chapter.xml
 SRCS+= basics/chapter.xml
 SRCS+= bibliography/chapter.xml
 SRCS+= boot/chapter.xml
 SRCS+= config/chapter.xml
 SRCS+= cutting-edge/chapter.xml
 SRCS+= desktop/chapter.xml
 SRCS+= disks/chapter.xml
 SRCS+= eresources/chapter.xml
 SRCS+= firewalls/chapter.xml
 SRCS+= filesystems/chapter.xml
 SRCS+= geom/chapter.xml
 SRCS+= install/chapter.xml
 SRCS+= introduction/chapter.xml
 SRCS+= jails/chapter.xml
 SRCS+= kernelconfig/chapter.xml
 SRCS+= l10n/chapter.xml
 SRCS+= linuxemu/chapter.xml
 SRCS+= mac/chapter.xml
 SRCS+= mail/chapter.xml
 SRCS+= mirrors/chapter.xml
 SRCS+= multimedia/chapter.xml
 SRCS+= network-servers/chapter.xml
 SRCS+= pgpkeys/chapter.xml
 SRCS+= ports/chapter.xml
 SRCS+= ppp-and-slip/chapter.xml
 SRCS+= preface/preface.xml
 SRCS+= printing/chapter.xml
 SRCS+= security/chapter.xml
 SRCS+= serialcomms/chapter.xml
 SRCS+= users/chapter.xml
 SRCS+= vinum/chapter.xml
 SRCS+= virtualization/chapter.xml
 SRCS+= x11/chapter.xml
 
 # Entities
 SRCS+= chapters.ent
 
 SYMLINKS=	${DESTDIR} index.html handbook.html
 
 # Turn on all the chapters.
 CHAPTERS?= ${SRCS:M*chapter.xml}
 
 XMLFLAGS+= ${CHAPTERS:S/\/chapter.xml//:S/^/-i chap./}
 XMLFLAGS+= -i chap.freebsd-glossary
 
 DOC_PREFIX?= ${.CURDIR}/../../..
 
 URL_RELPREFIX?=	../../../..
 DOC_PREFIX?=	${.CURDIR}/../../..
 
 #
 # rules generating lists of mirror site from XML database.
 #
 XMLDOCS=	lastmod:::mirrors.lastmod.inc \
 		mirrors-ftp-index:::mirrors.xml.ftp.index.inc \
 		mirrors-ftp:::mirrors.xml.ftp.inc \
 		mirrors-cvsup-index:::mirrors.xml.cvsup.index.inc \
 		mirrors-cvsup:::mirrors.xml.cvsup.inc \
 		eresources-index:::eresources.xml.www.index.inc \
 		eresources:::eresources.xml.www.inc
 DEPENDSET.DEFAULT=	transtable mirror
 XSLT.DEFAULT=		${XSL_MIRRORS}
 XML.DEFAULT=		${XML_MIRRORS}
 
 PARAMS.lastmod+=	--param 'target' "'lastmod'"
 PARAMS.mirrors-ftp-index+=	--param 'type' "'ftp'" \
 				--param 'proto' "'ftp'" \
 				--param 'target' "'index'"
 PARAMS.mirrors-ftp+=	--param 'type' "'ftp'" \
 			--param 'proto' "'ftp'" \
 			--param 'target' "'handbook/mirrors/chapter.xml'"
 PARAMS.mirrors-cvsup-index+=	--param 'type' "'cvsup'" \
 				--param 'proto' "'cvsup'" \
 				--param 'target' "'index'"
 PARAMS.mirrors-cvsup+=	--param 'type' "'cvsup'" \
 			--param 'proto' "'cvsup'" \
 			--param 'target' "'handbook/mirrors/chapter.xml'"
 PARAMS.eresources-index+=	--param 'type' "'www'" \
 				--param 'proto' "'http'" \
 				--param 'target' "'index'"
 PARAMS.eresources+=	--param 'type' "'www'" \
 			--param 'proto' "'http'" \
 			--param 'target' "'handbook/eresources/chapter.xml'"
 
 EXTRAS=		mirrors.lastmod.inc \
 		mirrors.xml.ftp.inc \
 		mirrors.xml.ftp.index.inc \
 		mirrors.xml.cvsup.inc \
 		mirrors.xml.cvsup.index.inc \
 		eresources.xml.www.inc \
 		eresources.xml.www.index.inc
 
 XMLDOCS_NO_SRCS=YES
 CLEANFILES+= ${EXTRAS}
 
 _extras: ${EXTRAS}
 mirrors/chapter.xml: ${EXTRAS}
 
 .include "${DOC_PREFIX}/share/mk/doc.project.mk"
diff --git a/zh_CN.UTF-8/books/handbook/advanced-networking/chapter.xml b/zh_CN.UTF-8/books/handbook/advanced-networking/chapter.xml
index 78855a63f4..64951c519a 100644
--- a/zh_CN.UTF-8/books/handbook/advanced-networking/chapter.xml
+++ b/zh_CN.UTF-8/books/handbook/advanced-networking/chapter.xml
@@ -1,5519 +1,5519 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      The FreeBSD Documentation Project
      The FreeBSD Chinese Documentation Project
 
-     Original revision: r38600
+     Original Revision: 2bdc87af7b (r38600)
      $FreeBSD$
 -->
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="advanced-networking">
   <title>高级网络</title>
 
   <sect1 xml:id="advanced-networking-synopsis">
     <title>概述</title>
 
     <para>本章将就一系列与网络有关的高级话题进行讨论。</para>
 
     <para>读完这章，您将了解：</para>
 
     <itemizedlist>
       <listitem>
 	<para>关于网关和路由的基础知识。</para>
       </listitem>
 
       <listitem>
 	<para>如何配置 &ieee; 802.11 和 &bluetooth; 设备。</para>
       </listitem>
 
       <listitem>
 	<para>如何用 FreeBSD 做网桥。</para>
       </listitem>
 
       <listitem>
 	<para>如何为无盘机上配置网络启动。</para>
       </listitem>
 
       <listitem>
         <para>如何配置从网络 PXE 启动一个 NFS 根文件系统。</para>
       </listitem>
 
       <listitem>
 	<para>如何配置网络地址转换 (NAT)。</para>
       </listitem>
 
       <listitem>
 	<para>如何使用 PLIP 连接两台计算机。</para>
       </listitem>
 
       <listitem>
 	<para>如何在运行 FreeBSD 的计算机上配置 IPv6。</para>
       </listitem>
 
       <listitem>
 	<para>如何配置 ATM。</para>
       </listitem>
 
       <listitem>
 	<para>如何利用 CARP， &os; 支持的
 	  Common Address Redundancy Protocol (共用地址冗余协议)</para>
       </listitem>
     </itemizedlist>
 
     <para>在读这章之前， 您应：</para>
 
     <itemizedlist>
       <listitem>
 	<para>理解 <filename>/etc/rc</filename> 脚本的基本知识。</para>
       </listitem>
 
       <listitem>
 	<para>熟悉基本的网络术语。</para>
       </listitem>
 
       <listitem>
 	<para>了解如何配置和安装新的 FreeBSD 内核
           (<xref linkend="kernelconfig"/>)。</para>
       </listitem>
 
       <listitem>
 	<para>了解如何安装第三方软件 (<xref linkend="ports"/>)。</para>
       </listitem>
 
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="network-routing">
     <info><title>网关和路由</title>
       <authorgroup>
 	<author><personname><firstname>Coranth</firstname><surname>Gryphon</surname></personname><contrib>贡献者：</contrib></author>
       </authorgroup>
       <authorgroup>
 	<author><personname><firstname>张</firstname><surname>雪平</surname></personname><contrib>中文翻译：</contrib><affiliation>
 	    <address><email>zxpmyth@yahoo.com.cn</email></address>
 	  </affiliation></author>
 	<author><personname><firstname>袁</firstname><surname>苏义</surname></personname></author>
       </authorgroup>
     </info>
     
 
     <indexterm><primary>路由</primary></indexterm>
     <indexterm><primary>网关</primary></indexterm>
     <indexterm><primary>子网</primary></indexterm>
     <para>要让网络上的两台计算机能够相互通讯，
       就必须有一种能够描述如何从一台计算机到另一台计算机的机制， 这一机制称作
       <firstterm>路由选择(routing)</firstterm>。
       <quote>路由项</quote> 是一对预先定义的地址：
       <quote>目的地(destination)</quote> 和 <quote>网关(gateway)</quote>。
       这个地址对所表达的意义是， 通过 <emphasis>网关</emphasis>
       能够完成与 <emphasis>目的地</emphasis> 的通信。
       有三种类型的目的地址： 单个主机、 子网、 以及 <quote>默认</quote>。
       如果没有可用的其它路由， 就会使用 <quote>默认路由</quote>，
       有关默认路由的内容， 将在稍后的章节中进行讨论。 网关也有三种类型：
       单个主机， 网络接口 (也叫 <quote>链路 (links)</quote>)
       和以太网硬件地址 (MAC 地址)。
     </para>
 
     <sect2>
       <title>实例</title>
 
       <para>为了说明路由选择的各个部分， 首先来看看下面的例子。
 	这是 <command>netstat</command> 命令的输出：</para>
 
       <screen>&prompt.user; <userinput>netstat -r</userinput>
 Routing tables
 
 Destination      Gateway            Flags     Refs     Use     Netif Expire
 
 default          outside-gw         UGSc       37      418      ppp0
 localhost        localhost          UH          0      181       lo0
 test0            0:e0:b5:36:cf:4f   UHLW        5    63288       ed0     77
 10.20.30.255     link#1             UHLW        1     2421
 example.com      link#1             UC          0        0
 host1            0:e0:a8:37:8:1e    UHLW        3     4601       lo0
 host2            0:e0:a8:37:8:1e    UHLW        0        5       lo0 =&gt;
 host2.example.com link#1             UC          0        0
 224              link#1             UC          0        0</screen>
 
       <indexterm><primary>默认路由</primary></indexterm>
       <para>头两行给出了当前配置中的默认路由 (将在 <link linkend="network-routing-default">下一节</link> 中进行介绍)
 	和 <systemitem>localhost (本机)</systemitem> 路由。</para>
 
       <indexterm><primary>回环设备</primary></indexterm>
       <para>这里的路由表中给出的用于 <literal>localhost</literal> 的接口
 	(<literal>Netif</literal> 列) 是 <filename>lo0</filename>，
 	也就是大家熟知的 <quote>回环设备</quote>。
 	它表示所有以此为 <quote>目的地</quote> 的通信都留在本机，
 	而不通过 LAN 发出， 因为这些流量最终会回到起点。</para>
 
       <indexterm>
 	<primary>以太网</primary> <secondary>MAC 地址</secondary>
       </indexterm>
       <para>接着出现的是以 <systemitem class="etheraddress">0:e0:</systemitem>
 	开头的地址。这些是以太网硬件地址，也称为 MAC 地址。
 	FreeBSD 会自动识别在同一个以太网中的任何主机 (如
 	<systemitem>test0</systemitem>)， 并为其新增一个路由，
 	并通过那个以太网接口 &mdash; <filename>ed0</filename>
 	直接与它通讯 (译者注：那台主机)。与这类路由表相关的也有一个超时项
 	(<literal>Expire</literal>列)，当我们在指定时间内没有收到从那个主机发来的信息，
 	这项就派上用场了。这种情况下，到这个主机的路由就会被自动删除。
 	这些主机被使用一种叫做RIP(路由信息协议--Routing Information
 	Protocol)的机制所识别，这种机制利用基于<quote>最短路径选择
 	(shortest path determination)</quote>的办法计算出到本地主机的路由。</para>
 
       <indexterm><primary>子网</primary></indexterm>
       <para>FreeBSD 也会为本地子网添加子网路由(<systemitem class="ipaddress">10.20.30.255</systemitem> 是子网
 	<systemitem class="ipaddress">10.20.30</systemitem> 的广播地址，而 <systemitem class="fqdomainname">example.com</systemitem> 是这个子网相联的域名)。
 	名称 <literal>link#1</literal> 代表主机上的第一块以太网卡。
 	您会发现，对于它们没有指定另外的接口。</para>
 
       <para>这两个组(本地网络主机和本地子网)的路由是由守护进程
 	<application>routed</application> 自动配置的。如果它没有运行，
 	那就只有被静态定义 (例如，明确输入的) 的路由才存在了。</para>
 
       <para><literal>host1</literal> 行代表我们的主机，它通过以太网地址来识别。
 	因为我们是发送端，FreeBSD知道使用回环接口 (<filename>lo0</filename>)
 	而不是通过以太网接口来进行发送。</para>
 
       <para>两个 <literal>host2</literal> 行是我们使用 &man.ifconfig.8;
 	别名 (请看关于以太网的那部分就会知道我们为什么这么做)
 	时产生的一个实例。在 <filename>lo0</filename>
 	接口之后的 <literal>=&gt;</literal> 符号表明我们不仅使用了回环
 	(因为这个地址也涉及了本地主机)，而且明确指出它是个别名。
 	这类路由只有在支持别名的主机上才能显现出来。
 	所有本地网上的其它的主机对于这类路由只会简单拥有
 	<literal>link#1</literal>。</para>
 
       <para>最后一行 (目标子网<systemitem class="ipaddress">224</systemitem>)
 	用于处理多播――它会覆盖到其它的区域。</para>
 
       <para>最后，每个路由的不同属性可以在 <literal>Flags</literal>
 	列中看到。下边是个关于这些标志和它们的含义的一个简表：</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <colspec colwidth="1*"/>
 	  <colspec colwidth="4*"/>
 
 	  <tbody>
 	    <row>
 	      <entry>U</entry>
 	      <entry>Up: 路由处于活动状态。</entry>
 	    </row>
 
 	    <row>
 	      <entry>H</entry>
 	      <entry>Host: 路由目标是单个主机。</entry>
 	    </row>
 
 	    <row>
 	      <entry>G</entry>
 	      <entry>Gateway: 所有发到目的地的网络传到这一远程系统上，
 		并由它决定最后发到哪里。</entry>
 	    </row>
 
 	    <row>
 	      <entry>S</entry>
 	      <entry>Static: 这个路由是手工配置的，不是由系统自动生成的。</entry>
 	    </row>
 
 	    <row>
 	      <entry>C</entry>
 	      <entry>Clone: 生成一个新的路由，
 		通过这个路由我们可以连接上这些机子。
 		这种类型的路由通常用于本地网络。</entry>
 	    </row>
 
 	    <row>
 	      <entry>W</entry>
 	      <entry>WasCloned: 指明一个路由――它是基于本地区域网络
 		(克隆) 路由自动配置的。</entry>
 	    </row>
 
 	    <row>
 	      <entry>L</entry>
 	      <entry>Link: 路由涉及到了以太网硬件。</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
 
     </sect2>
 
     <sect2 xml:id="network-routing-default">
       <title>默认路由</title>
 
       <indexterm><primary>默认路由</primary></indexterm>
       <para>当本地系统需要与远程主机建立连接时，
 	它会检查路由表以决定是否有已知的路径存在。
 	如果远程主机属于一个我们已知如何到达 (克隆的路由)
 	的子网内，那么系统会检查看沿着那个接口是否能够连接。</para>
 
       <para>如果所有已知路径都失败，系统还有最后一个选择：
 	<quote>默认</quote>路由。这个路由是特殊类型的网关路由
 	(通常只有一个存在于系统里)，并且总是在标志栏使用一个
 	<literal>c</literal>来进行标识。对于本地区域网络里的主机，
 	这个网关被设置到任何与外界有直接连接的机子里 (无论是通过
 	PPP、DSL、cable modem、T1 或其它的网络接口连接)。</para>
 
       <para>如果您正为某台本身就做为网关连接外界的机子配置默认路由的话，
 	那么该默认路由应该是您的<quote>互联网服务商
 	(ISP)</quote>那方的网关机子。</para>
 
       <para>让我们来看一个关于默认路由的例子。这是个很普遍的配置：</para>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="advanced-networking/net-routing"/>
 	</imageobject>
 
 	<textobject>
 	  <literallayout class="monospaced">
 [Local2]  &lt;--ether--&gt;  [Local1]  &lt;--PPP--&gt; [ISP-Serv]  &lt;--ether--&gt;  [T1-GW]
       </literallayout>
 	</textobject>
       </mediaobject>
 
       <para>主机 <systemitem>Local1</systemitem> 和 <systemitem>Local2</systemitem>
 	在您那边。<systemitem>Local1</systemitem> 通过 PPP 拨号连接到了 ISP。这个
 	PPP 服务器通过一个局域网连接到另一台网关机子――它又通过一个外部接口连接到
 	ISP 提供的互联网上。</para>
 
       <para>您的每一台机子的默认路由应该是：</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="3">
 	  <thead>
 	    <row>
 	      <entry>Host</entry>
 	      <entry>Default Gateway</entry>
 	      <entry>Interface</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry>Local2</entry>
 	      <entry>Local1</entry>
 	      <entry>Ethernet</entry>
 	    </row>
 
 	    <row>
 	      <entry>Local1</entry>
 	      <entry>T1-GW</entry>
 	      <entry>PPP</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
 
       <para>一个常见的问题是<quote>我们为什么 (或怎样)
 	能将 <systemitem>T1-GW</systemitem> 设置成为 <systemitem>Local1</systemitem>
 	默认网关，而不是它所连接 ISP 服务器？</quote></para>
 
       <para>记住，因为 PPP 接口使用的一个地址是在 ISP
 	的局域网里的，用于您那边的连接，对于 ISP
 	的局域网里的其它机子，其路由会自动产生。
 	因此，您就已经知道了如何到达机子 <systemitem>T1-GW</systemitem>，
 	那么也就没必要中间那一步了――发送通信给 ISP 服务器。</para>
 
       <para>通常使用地址 <systemitem class="ipaddress">X.X.X.1</systemitem> 做为一个局域网的网关。
 	因此 (使用相同的例子)，如果您本地的 C 类地址空间是
 	<systemitem class="ipaddress">10.20.30</systemitem>，而您的 ISP
 	使用的是 <systemitem class="ipaddress">10.9.9</systemitem>，
 	那么默认路由表将是：</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Host</entry>
 	      <entry>Default Route</entry>
 	    </row>
 	  </thead>
 	  <tbody>
 	    <row>
 	      <entry>Local2 (10.20.30.2)</entry>
 	      <entry>Local1 (10.20.30.1)</entry>
 	    </row>
 	    <row>
 	      <entry>Local1 (10.20.30.1, 10.9.9.30)</entry>
 	      <entry>T1-GW (10.9.9.1)</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
 
       <para>您可以很轻易地通过 <filename>/etc/rc.conf</filename>
 	文件设定默认路由。在我们的实例里，在主机 <systemitem>Local2</systemitem>
 	里，我们在文件 <filename>/etc/rc.conf</filename>
 	里增加了下边内容：</para>
 
       <programlisting>defaultrouter="10.20.30.1"</programlisting>
 
       <para>也可以直接在命令行使用 &man.route.8; 命令:</para>
 
       <screen>&prompt.root; <userinput>route add default 10.20.30.1</userinput></screen>
 
       <para>要了解关于如何手工维护网络路由表的进一步细节， 请参考
 	&man.route.8; 联机手册。</para>
     </sect2>
 
     <sect2 xml:id="network-dual-homed-hosts">
       <title>重宿主机(Dual Homed Hosts)</title>
 
       <indexterm><primary>重宿 主机</primary></indexterm>
       <para>还有一种其它的类型的配置是我们要提及的，
 	这就是一个主机处于两个不同的网络。技术上，任何作为网关
 	(上边的实例中，使用了 PPP 连接) 的机子就算作是重宿主机。
 	但这个词实际上仅用来指那种处于两个局域网之中的机子。</para>
 
       <para>有一种情形，一台机子有两个网卡，
 	对于各个子网都有各自的一个地址。另一种情况，
 	这台机子仅有一张网卡，但使用 &man.ifconfig.8;
 	做了别名。如果有两个独立的以太网在使用的情形就使用前者，
 	如果只有一个物理网段，但逻辑上分成了两个独立的子网，
 	就使用后者。</para>
 
       <para>每种情况都要设置路由表以便两子网都知道这台主机是到其它子网的网关――入站路由
 	(inbound route)。将一台主机配置成两个子网间的路由器，
 	这种配置经常在我们需要实现单向或双向的包过滤或防火墙时被用到。</para>
 
       <para>如果想让主机在两个接口间转发数据包，您需要激活
 	FreBSD 的这项功能。至于怎么做，请看下一部分了解更多。</para>
     </sect2>
 
     <sect2 xml:id="network-dedicated-router">
       <title>建立路由器</title>
 
       <indexterm><primary>路由器</primary></indexterm>
 
       <para>网络路由器只是一个将数据包从一个接口转发到另一个接口的系统。
 	互联网标准和良好的工程实践阻止了 FreeBSD 计划在 FreeBSD
 	中把它置成默认值。您在可以在 &man.rc.conf.5; 中改变下列变量的值为
 	<literal>YES</literal>，使这个功能生效：</para>
 
       <programlisting>gateway_enable="YES"          # Set to YES if this host will be a gateway</programlisting>
 
       <para>这个选项会把&man.sysctl.8;
 	变量――<varname>net.inet.ip.forwarding</varname>
 	设置成 <literal>1</literal>。如果您要临时地停止路由，
 	您可以把它重设为 <literal>0</literal>。</para>
 
       <indexterm><primary>BGP</primary></indexterm>
       <indexterm><primary>RIP</primary></indexterm>
       <indexterm><primary>OSPF</primary></indexterm>
       <para>新的路由器需要有路由才知道将数据传向何处。
 	如果网络够简单，您可以使用静态路由。FreeBSD
 	也自带一个标准的BSD路由选择守护进程 &man.routed.8;，
 	称之为 RIP ( version 1和 version 2) 和 IRDP。对 BGP v4，OSPF v2
 	和其它复杂路由选择协议的支持可以从
 	<package>net/zebra</package> 包中得到。
 	像 <application>&gated;</application>
 	一样的商业产品也提供了更复杂的网络路由解决方案。</para>
     </sect2>
 
     <sect2 xml:id="network-static-routes">
       <info><title>设置静态路由</title>
 	<authorgroup>
 	  <author><personname><firstname>Coranth</firstname><surname>Gryphon</surname></personname><contrib>贡献者：</contrib></author>
 	</authorgroup>
       <authorgroup>
 	<author><personname><firstname>张</firstname><surname>雪平</surname></personname><contrib>中文翻译：</contrib><affiliation>
 	    <address><email>zxpmyth@yahoo.com.cn</email></address>
 	  </affiliation></author>
 	<author><personname><firstname>袁</firstname><surname>苏义</surname></personname></author>
       </authorgroup>
       </info>
       <!-- Feb 2004 --> 
 
       <sect3>
 	<title>手动配置</title>
 
 	<para>假设如下这样一个网络：</para>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="advanced-networking/static-routes"/>
 	  </imageobject>
 
 	  <textobject>
 	<literallayout class="monospaced">
     INTERNET
       | (10.0.0.1/24) Default Router to Internet
       |
       |Interface xl0
       |10.0.0.10/24
    +------+
    |      | RouterA
    |      | (FreeBSD gateway)
    +------+
       | Interface xl1
       | 192.168.1.1/24
       |
   +--------------------------------+
    Internal Net 1      | 192.168.1.2/24
                        |
                    +------+
                    |      | RouterB
                    |      |
                    +------+
                        | 192.168.2.1/24
                        |
                      Internal Net 2
 	</literallayout>
 	  </textobject>
 	</mediaobject>
 
 	<para>在这里，<systemitem>RouterA</systemitem> 是我们的 &os;
 	  机子，它充当连接到互联网其它部分的路由器的角色。
 	  默认路由设置为<systemitem class="ipaddress">10.0.0.1</systemitem>，
 	  它就允许与外界连接。我们假定已经正确配置了
 	  <systemitem>RouterB</systemitem>，并且知道如何连接到想去的任何地方。
 	  (在这个图里很简单。只须在 <systemitem>RouterB</systemitem>
 	  上增加默认路由，使用 <systemitem>192.168.1.1</systemitem> 做为网关。)</para>
 
 	<para>如果我们查看一下<systemitem>RouterA</systemitem>的路由表，
 	  我们就会看到如下一些内容：</para>
 
 	<screen>&prompt.user; <userinput>netstat -nr</userinput>
 Routing tables
 
 Internet:
 Destination        Gateway            Flags    Refs      Use  Netif  Expire
 default            10.0.0.1           UGS         0    49378    xl0
 127.0.0.1          127.0.0.1          UH          0        6    lo0
 10.0.0.0/24        link#1             UC          0        0    xl0
 192.168.1.0/24     link#2             UC          0        0    xl1</screen>
 
 	<para>使用当前的路由表，<systemitem>RouterA</systemitem>
 	  是不能到达我们的内网――Internal Net 2 的。它没有到 <systemitem class="ipaddress">192.168.2.0/24</systemitem> 的路由。
 	  一种可以接受的方法是手工增加这条路由。以下的命令会把
 	  Internal Net 2 网络加入到 <systemitem>RouterA</systemitem> 的路由表中，使用<systemitem class="ipaddress">192.168.1.2</systemitem> 做为下一个跳跃：</para>
 
 	<screen>&prompt.root; <userinput>route add -net 192.168.2.0/24 192.168.1.2</userinput></screen>
 
 	<para>现在 <systemitem>RouterA</systemitem>
 	  就可以到达 <systemitem class="ipaddress">192.168.2.0/24</systemitem>
 	  网络上的任何主机了。</para>
       </sect3>
 
       <sect3>
 	<title>永久配置</title>
 
 	<para>上面的实例对于运行着的系统来说配置静态路由是相当不错了。
 	  只是，有一个问题――如果您重启您的 &os; 机子，路由信息就会消失。
 	  处理附加的静态路由的方法是把它放到您的
 	  <filename>/etc/rc.conf</filename> 文件里去。</para>
 
 	<programlisting># Add Internal Net 2 as a static route
 static_routes="internalnet2"
 route_internalnet2="-net 192.168.2.0/24 192.168.1.2"</programlisting>
 
 	<para>配置变量 <literal>static_routes</literal>
 	  是一串以空格隔开的字符串。每一串表示一个路由名字。
 	  在上面的例子中我们中有一个串在 <literal>static_routes</literal>
 	  里。这个字符串中 <replaceable>internalnet2</replaceable>。
 	  然后我们新增一个配置变量
 	  <literal>route_internalnet2</literal>，
 	  这里我们把所有传给 &man.route.8;命令的参数拿了过来。
 	  在上面的实例中的我使用的命令是：</para>
 
 	  <screen>&prompt.root; <userinput>route add -net 192.168.2.0/24 192.168.1.2</userinput></screen>
 
 	  <para>因此，我们需要的是 <literal>"-net 192.168.2.0/24 192.168.1.2"</literal>。</para>
 
 	<para>前边已经提到， 可以把多个静态路由的名称， 放到
 	  <literal>static_routes</literal> 里边。
 	  接着我们就来建立多个静态路由。 下面几行所展示的，
 	  是在一个假想的路由器上增加 <systemitem class="ipaddress">192.168.0.0/24</systemitem> 和 <systemitem class="ipaddress">192.168.1.0/24</systemitem>
 	  之间静态路由的例子：</para>
 
         <programlisting>static_routes="net1 net2"
 route_net1="-net 192.168.0.0/24 192.168.0.1"
 route_net2="-net 192.168.1.0/24 192.168.1.1"</programlisting>
       </sect3>
     </sect2>
 
     <sect2 xml:id="network-routing-propagation">
       <title>路由传播</title>
       <indexterm><primary>路由 传播</primary></indexterm>
       <para>我们已经讨论了如何定义通向外界的路由，
 	但未谈及外界是如何找到我们的。</para>
 
       <para>我们已经知道可以设置路由表，
 	这样任何指向特定地址空间 (在我们的例子中是一个
 	C 类子网) 的数据都会被送往网络上特定的主机，
 	然后由这台主机向地址空间内部转发数据。</para>
 
       <para>当您得到一个分配给您的网络的地址空间时，
 	ISP(网络服务商)会设置它们的路由表，
 	这样指向您子网的数据就会通过 PPP 连接下传到您的网络。
 	但是其它跨越国界的网络是如何知道将数据传给您的
 	ISP 的呢？</para>
 
       <para>有一个系统(很像分布式 DNS 信息系统)，
 	它一直跟踪被分配的地址空间，
 	并说明它们连接到互联网骨干(Internet backbone)的点。
 	<quote>骨干(Backbone)</quote> 指的是负责全世界和跨国的传输的主要干线。
 	每一台骨干主机(backbone machine)有一份主要表集的副本，
 	它将发送给特定网络的数据导向相应的骨干载体上(backbone carrier)，
 	从结点往下遍历服务提供商链，直到数据到达您的网络。</para>
 
       <para>服务提供商的任务是向骨干网络广播，以声明它们就是通向您的网点的连接结点
 	(以及进入的路径)。这就是路由传播。</para>
     </sect2>
 
     <sect2 xml:id="network-routing-troubleshooting">
       <title>问题解答</title>
       <indexterm>
         <primary><command>traceroute</command></primary>
       </indexterm>
       <para>有时候，路由传播会有一个问题，一些网络无法与您连接。
 	或许能帮您找出路由是在哪里中断的最有用的命令就是
 	&man.traceroute.8;了。当您无法与远程主机连接时，
 	这个命令一样有用(例如 &man.ping.8; 失败)。</para>
 
       <para>&man.traceroute.8; 命令将以您想连接的主机的名字作为参数执行。
 	不管是到达了目标，还是因为没有连接而终止，
 	它都会显示所经过的所有网关主机。</para>
 
       <para>想了解更多的信息，查看 &man.traceroute.8; 的手册。</para>
     </sect2>
 
     <sect2 xml:id="network-routing-multicast">
       <title>多播路由</title>
       <indexterm>
 	<primary>多播路由</primary>
       </indexterm>
       <indexterm>
 	<primary>内核选项</primary>
 	<secondary>MROUTING</secondary>
       </indexterm>
       <para>FreeBSD 一开始就支持多播应用软件和多播路由选择。
 	多播程序并不要求FreeBSD的任何特殊的配置，
 	就可以工作得很好。多播路由需要支持被编译入内核：</para>
 
       <programlisting>options MROUTING</programlisting>
 
       <para>另外，多播路由守护进程――&man.mrouted.8;
 	必须通过 <filename>/etc/mrouted.conf</filename>
 	配置来开启通道和 <acronym>DVMRP</acronym>。
 	更多关于多播路由配置的信息可以在 &man.mrouted.8;
 	的手册里找到。</para>
 
       <note>
 	<para>多播路由服务 &man.mrouted.8; 实现了
 	  <acronym>DVMRP</acronym> 多播路由协议，
 	  在许多采用多播的场合，
 	  它已被 &man.pim.4; 取代。 &man.mrouted.8; 以及相关的
           &man.map-mbone.8; 和 &man.mrinfo.8; 工具可以在 &os; 的 Ports&nbsp;Collection
           <package>net/mrouted</package> 中找到。</para>
       </note>
     </sect2>
   </sect1>
 
 
 
 <sect1 xml:id="network-wireless">
     <info><title>无线网络</title>
       <authorgroup>
 	<author><personname><othername>陈福康</othername></personname></author>
 
 	<author><personname><firstname>Marc</firstname><surname>Fonvieille</surname></personname></author>
 
 	<author><personname><firstname>Murray</firstname><surname>Stokely</surname></personname></author>
       </authorgroup>
     </info>
     
 
     <indexterm><primary>wireless networking (无线网络)</primary></indexterm>
     <indexterm>
       <primary>802.11</primary>
       <see>wireless networking (无线网络)</see>
     </indexterm>
 
     <sect2>
       <title>无线网络基础</title>
 
       <para>绝大多数无线网络都采用了 &ieee; 802.11
 	标准。 基本的无线网络中， 都包含多个以 2.4GHz 或 5GHz
 	频段的无线电波广播的站点 (不过， 随所处地域的不同，
 	或者为了能够更好地进行通讯， 具体的频率会在
 	2.3GHz 和 4.9GHz 的范围内变化)。</para>
 
       <para>802.11 网络有两种组织方式： 在
 	<emphasis>infrastructure 模式</emphasis> 中，
 	一个通讯站作为主站， 其他通讯站都与其关联；
 	这种网络称为 BSS， 而主站则成为无线访问点 (AP)。
 	在 BSS 中， 所有的通讯都是通过 AP 来完成的；
 	即使通讯站之间要相互通讯， 也必须将消息发给 AP。
 	在第二种形式的网络中， 并不存在主站，
 	通讯站之间是直接通讯的。 这种网络形式称作 IBSS，
 	通常也叫做 <emphasis>ad-hoc
 	网络</emphasis>。</para>
 
       <para>802.11 网络最初在 2.4GHz 频段上部署，
 	并采用了由 &ieee; 802.11 和 802.11b
 	标准所定义的协议。 这些标准定义了采用的操作频率、
 	包括分帧和传输速率 (通讯过程中可以使用不同的速率) 在内的 MAC 层特性等。
 	稍后的 802.11a 标准定义了使用
 	5GHz 频段进行操作， 以及不同的信号机制和更高的传输速率。
 	其后定义的 802.11g 标准启用了在 2.4GHz 上如何使用 802.11a 信号和传输机制，
 	以提供对较早的 802.11b 网络的向前兼容。</para>
 
       <para>802.11 网络中采用的各类底层传输机制提供了不同类型的安全机制。
 	最初的 802.11 标准定义了一种称为 WEP 的简单安全协议。
 	这个协议采用固定的预发布密钥， 并使用 RC4
 	加密算法来对在网络上传输的数据进行编码。
 	全部通讯站都必须采用同样的固定密钥才能通讯。
 	这一格局已经被证明很容易被攻破， 因此目前已经很少使用了，
 	采用这种方法只能让那些接入网络的用户迅速断开。
 	最新的安全实践是由
 	&ieee; 802.11i 标准给出的， 它定义了新的加密算法，
 	并通过一种附加的协议来让通讯站向无线访问点验证身份，
 	并交换用于进行数据通讯的密钥。 更进一步，
 	用于加密的密钥会定期地刷新，
 	而且有机制能够监测入侵的尝试 (并阻止这种尝试)。
 	无线网络中另一种常用的安全协议标准是 WPA。 这是在 802.11i
 	之前由业界组织定义的一种过渡性标准。 WPA 定义了在 802.11i
 	中所规定的要求的子集， 并被设计用来在旧式硬件上实施。
 	特别地， WPA 要求只使用由最初 WEP
 	所采用的算法派生的 TKIP 加密算法。 802.11i 则不但允许使用 TKIP，
 	而且还要求支持更强的加密算法 AES-CCM 来用于加密数据。 (在 WPA
 	中并没有要求使用 AES 加密算法，
 	因为在旧式硬件上实施这种算法时所需的计算复杂性太高。)</para>
 
       <para>除了前面介绍的那些协议标准之外，
 	还有一种需要介绍的标准是 802.11e。 它定义了用于在 802.11
 	网络上运行多媒体应用， 如视频流和使用 IP 传送的语音 (VoIP) 的协议。
 	与 802.11i 类似， 802.11e 也有一个前身标准，
 	通常称作 WME (后改名为 WMM)， 它也是由业界组织定义的 802.11e
 	的子集， 以便能够在旧式硬件中使用多媒体应用。
 	关于  802.11e 与 WME/WMM 之间的另一项重要区别是，
 	前者允许对流量通过服务品质
 	(QoS) 协议和增强媒体访问协议来安排优先级。
 	对于这些协议的正确实现， 能够实现高速突发数据和流量分级。</para>
 
       <para>&os; 支持采用 802.11a, 802.11b 和 802.11g
 	的网络。 类似地， 它也支持 WPA 和 802.11i 安全协议 (与
 	11a、 11b 和 11g 配合)， 而 WME/WMM 所需要的 QoS 和流量分级，
 	则在部分无线设备上提供了支持。</para>
     </sect2>
 
     <sect2 xml:id="network-wireless-basic">
       <title>基本安装</title>
 
       <sect3>
 	<title>内核配置</title>
 
 	<para>要使用无线网络， 您需要一块无线网卡，
 	  并适当地配置内核令其提供无线网络支持。
 	  后者被分成了多个模块，
 	  因此您只需配置使用您所需要的软件就可以了。</para>
 
 	<para>首先您需要的是一个无线设备。 最为常用的一种无线配件是
 	  Atheros 生产的。 这些设备由 &man.ath.4;
 	  驱动程序提供支持， 您需要把下面的配置加入到
 	  <filename>/boot/loader.conf</filename> 文件中：</para>
 
 	<programlisting>if_ath_load="YES"</programlisting>
 
 	<para>Atheros 驱动分为三个部分： 驱动部分 (&man.ath.4;)、
 	  用于处理芯片专有功能的支持层
 	  (&man.ath.hal.4;)， 以及一组用以选择传输帧速率的算法
 	  (ath_rate_sample here)。 当以模块方式加载这一支持时，
 	  所需的其它模块会自动加载。 如果您使用的不是 Atheros
 	  设备， 则应选择对应的模块； 例如：</para>
 
 	<programlisting>if_wi_load="YES"</programlisting>
 
 	<para>表示使用基于 Intersil Prism 产品的无线设备
 	  (&man.wi.4; 驱动)。</para>
 
 	<note>
 	  <para>在这篇文档余下的部分中， 我们将以
 	    &man.ath.4; 卡来进行示范， 如果要套用这些配置的话，
 	    可能需要根据您实际的配置情况来修改示例中的设备名称。
 	    在 &os; 兼容硬件说明中提供了目前可用的无线网络驱动，
 	    以及兼容硬件的列表。 针对不同版本和硬件平台的说明可以在
 	    &os; 网站的 <link xlink:href="http://www.FreeBSD.org/releases/index.html">Release
 	    Information</link> 页面找到。
 	    如果您的无线设备没有与之对应的 &os; 专用驱动程序，
 	    也可以尝试使用 <link linkend="config-network-ndis">NDIS</link>
 	    驱动封装机制来直接使用 &windows; 驱动。</para>
 	</note>
 
 	<para>对于 &os;&nbsp;7.X， 在配置好设备驱动之后， 您还需要引入驱动程序所需要的 802.11
 	  网络支持。 对于 &man.ath.4; 驱动而言， 至少需要 &man.wlan.4;
           <literal>wlan_scan_ap</literal> 和
           <literal>wlan_scan_sta</literal>
 	  模块； &man.wlan.4; 模块会自动随无线设备驱动一同加载，
           剩下的模块必须要在系统引导时加载， 就需要在
           <filename>/boot/loader.conf</filename>
           中加入下面的配置：</para>
 
         <programlisting>wlan_scan_ap_load="YES"
 wlan_scan_sta_load="YES"</programlisting>
 
 	<para>从 &os;&nbsp;8.0 起，
 	  这些模块成为了 &man.wlan.4; 驱动的基础组件，
 	  并会随适配器驱动一起动态加载。</para>
 
 	<para>除此之外， 您还需要提供您希望使用的安全协议所需的加密支持模块。
 	  这些模块是设计来让 &man.wlan.4; 模块根据需要自动加载的，
 	  但目前还必须手工进行配置。 您可以使用下面这些模块： &man.wlan.wep.4;、 &man.wlan.ccmp.4;
 	  和 &man.wlan.tkip.4;。 &man.wlan.ccmp.4; 和
 	  &man.wlan.tkip.4; 这两个驱动都只有在您希望采用 WPA 和/或 802.11i
 	  安全协议时才需要。 如果您的网络不采用加密，
 	  就不需要 &man.wlan.wep.4; 支持了。
 	  要在系统引导时加载这些模块， 需要在
 	  <filename>/boot/loader.conf</filename> 中加入下面的配置：</para>
 
 	<programlisting>wlan_wep_load="YES"
 wlan_ccmp_load="YES"
 wlan_tkip_load="YES"</programlisting>
 
 	<para>通过系统引导配置文件 (也就是
 	  <filename>/boot/loader.conf</filename>) 中的这些信息生效，
 	  您必须重新启动运行 &os; 的计算机。 如果不想立刻重新启动，
 	  也可以使用
 	  &man.kldload.8; 来手工加载。</para>
 
 	<note>
 	  <para>如果不想加载模块， 也可以将这些驱动编译到内核中，
 	    方法是在内核的编译配置文件中加入下面的配置：</para>
 
 	  <programlisting>device wlan              # 802.11 support
 device wlan_wep          # 802.11 WEP support
 device wlan_ccmp         # 802.11 CCMP support
 device wlan_tkip         # 802.11 TKIP support
 device wlan_amrr         # AMRR transmit rate control algorithm
 device ath               # Atheros pci/cardbus NIC's
 device ath_hal           # pci/cardbus chip support
 options AH_SUPPORT_AR5416 # enable AR5416 tx/rx descriptors
 device ath_rate_sample   # SampleRate tx rate control for ath</programlisting>
 
 	  <para>使用 &os;&nbsp;7.X 时， 还需要配置下面这两行；
 	    &os; 的其他版本不需要它们。</para>
 
 	  <programlisting>device wlan_scan_ap      # 802.11 AP mode scanning
 device wlan_scan_sta     # 802.11 STA mode scanning</programlisting>
 
 	  <para>将这些信息写到内核编译配置文件中之后，
 	    您需要重新编译内核， 并重新启动运行 &os;
 	    的计算机。</para>
 	</note>
 
 	<para>在系统启动之后， 您会在引导时给出的信息中，
 	  找到类似下面这样的关于无线设备的信息：</para>
 
 	<screen>ath0: &lt;Atheros 5212&gt; mem 0x88000000-0x8800ffff irq 11 at device 0.0 on cardbus1
 ath0: [ITHREAD]
 ath0: AR2413 mac 7.9 RF2413 phy 4.5</screen>
       </sect3>
     </sect2>
 
     <sect2>
       <title>Infrastructure 模式</title>
 
       <para>通常的情形中使用的是 infrastructure 模式或称 BSS 模式。
 	在这种模式中， 有一系列无线访问点接入了有线网络。
 	每个无线网都会有自己的名字， 这个名字称作网络的 SSID。
 	无线客户端都通过无线访问点来完成接入。</para>
 
       <sect3>
 	<title>&os; 客户机</title>
 
 	<sect4>
 	  <title>如何查找无线访问点</title>
 
 	  <para>您可以通过使用
 	    <command>ifconfig</command> 命令来扫描网络。
 	    由于系统需要在操作过程中切换不同的无线频率并探测可用的无线访问点，
 	    这种请求可能需要数分钟才能完成。
 	    只有超级用户才能启动这种扫描：</para>
 
 	  <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0</userinput>
 &prompt.root; <userinput>ifconfig wlan0 up scan</userinput>
 SSID/MESH ID    BSSID              CHAN RATE   S:N     INT CAPS
 dlinkap         00:13:46:49:41:76   11   54M -90:96   100 EPS  WPA WME
 freebsdap       00:11:95:c3:0d:ac    1   54M -83:96   100 EPS  WPA</screen>
 
 	  <note>
 	    <para>在开始扫描之前， 必须将网络接口设为 <option>up</option>。
 	      后续的扫描请求就不需要再将网络接口设为 up 了。</para>
 	  </note>
 
 	  <note>
 	    <para>在 &os;&nbsp;7.X 中， 会直接适配器设备， 例如
 	      <filename>ath0</filename>，
 	      而不是
 	      <filename>wlan0</filename>
 	      设备。 因此您需要把前面的命令行改为：</para>
 
 	    <screen>&prompt.root; <userinput>ifconfig ath0 up scan</userinput></screen>
 
 	    <para>在这份文档余下的部分中， 您也需要注意 &os;&nbsp;7.X
 	      上的这些差异， 并对命令行示例进行类似的改动。</para>
 	  </note>
 
 	  <para>扫描会列出所请求到的所有 BSS/IBSS
 	    网络列表。 除了网络的名字
 	    <literal>SSID</literal> 之外， 我们还会看到
 	    <literal>BSSID</literal> 即无线访问点的 MAC 地址。
 	    而 <literal>CAPS</literal> 字段则给出了网络类型及其提供的功能，
 	    其中包括：</para>
 
         <table frame="none" pgwide="0">
           <title>通讯站功能代码</title>
 
           <tgroup cols="2">
             <thead>
               <row>
                 <entry>功能代码</entry>
                 <entry>含义</entry>
               </row>
             </thead>
 
 
             <tbody>
               <row>
 	        <entry><literal>E</literal></entry>
 		<entry>Extended Service Set (ESS)。 表示通讯站是
 		  infrastructure 网络 (相对于 IBSS/ad-hoc 网络) 的成员。</entry>
               </row>
 
 	      <row>
                 <entry><literal>I</literal></entry>
 		<entry>IBSS/ad-hoc 网络。 表示通讯站是 ad-hoc
 		  网络 (相对于 ESS 网络) 的成员。</entry>
               </row>
 
 	      <row>
                 <entry><literal>P</literal></entry>
 		<entry>私密。 在 BSS 中交换的全部数据帧均需保证数据保密性。
 		  这表示 BSS 需要通讯站使用加密算法，
 		  例如 WEP、 TKIP 或 AES-CCMP 来加密/解密与其他通讯站交换的数据帧。</entry>
               </row>
 
               <row>
 	        <entry><literal>S</literal></entry>
 		<entry>短前导码 (Short Preamble)。 表示网络采用的是短前导码
 		  (由 802.11b High
 		  Rate/DSSS PHY 定义， 短前导码采用 56-位 同步字段，
 		  而不是在长前导码模式中所采用的 128-位 字段)。</entry>
               </row>
 
               <row>
 	        <entry><literal>s</literal></entry>
 		<entry>短碰撞槽时间 (Short slot time)。 表示由于不存在旧式 (802.11b)
 		  通讯站， 802.11g 网络正使用短碰撞槽时间。</entry>
               </row>
             </tbody>
           </tgroup>
         </table>
 
 	  <para>要显示目前已知的网络， 可以使用下面的命令：</para>
 
 	  <screen>&prompt.root; <userinput>ifconfig wlan0 list scan</userinput></screen>
 
 	  <para>这些信息可能会由无线适配器自动更新，
 	    也可使用 <option>scan</option> 手动更新。
 	    快取缓存中的旧数据会自动删除，
 	    因此除非进行更多扫描，
 	    这个列表会逐渐缩小。</para>
 	</sect4>
 
 	<sect4>
 	  <title>基本配置</title>
 
 	  <para>在这一节中我们将展示一个简单的例子来介绍如何让无线网络适配器在 &os;
 	    中以不加密的方式工作。 在您熟悉了这些概念之后，
 	    我们强烈建议您在实际的使用中采用 <link linkend="network-wireless-wpa">WPA</link> 来配置网络。</para>
 
 	  <para>配置无线网络的过程可分为三个基本步骤： 选择无线访问点、
 	    验证您的通讯站身份， 以及配置 IP 地址。
 	    下面的几节中将分步骤地介绍它们。</para>
 
 	  <sect5>
 	    <title>选择无线访问点</title>
 
 	    <para>多数时候让系统以内建的探测方式选择无线访问点就可以了。
 	      这是在您将网络接口置为 up 或在
 	      <filename>/etc/rc.conf</filename> 中配置 IP 地址时的默认方式，
 	      例如：</para>
 
 	    <programlisting>wlans_ath0="wlan0"
 ifconfig_wlan0="DHCP"</programlisting>
 
 	    <note>
 	      <para>如前面提到的那样， &os;&nbsp;7.X 只需要一行配置：</para>
 
 	      <programlisting>ifconfig_ath0="DHCP"</programlisting>
 	    </note>
 
 	    <para>如果存在多个无线访问点， 而您希望从中选择具体的一个，
 	      则可以通过指定 SSID 来实现：</para>
 
 	    <programlisting>wlans_ath0="wlan0"
 ifconfig_wlan0="ssid <replaceable>your_ssid_here</replaceable> DHCP"</programlisting>
 
 	    <para>在某些环境中， 多个访问点可能会使用同样的 SSID (通常，
 	      这样做的目的是简化漫游)， 这时可能就需要与某个具体的设备关联了。
 	      这种情况下， 您还应指定无线访问点的
 	      BSSID (这时可以不指定
 	      SSID)：</para>
 
 	    <programlisting>wlans_ath0="wlan0"
 ifconfig_wlan0="ssid <replaceable>your_ssid_here</replaceable> bssid <replaceable>xx:xx:xx:xx:xx:xx</replaceable> DHCP"</programlisting>
 
 	    <para>除此之外， 还有一些其它的方法能够约束查找无线访问点的范围，
 	      例如限制系统扫描的频段， 等等。 如果您的无线网卡支持多个频段，
 	      这样做可能会非常有用， 因为扫描全部可用频段是一个十分耗时的过程。
 	      要将操作限制在某个具体的频段， 可以使用 <option>mode</option>
 	      参数； 例如：</para>
 
 	    <programlisting>wlans_ath0="wlan0"
 ifconfig_wlan0="mode <replaceable>11g</replaceable> ssid <replaceable>your_ssid_here</replaceable> DHCP"</programlisting>
 
 	    <para>就会强制卡使用采用 2.4GHz 的 802.11g， 这样在扫描的时候，
 	      就不会考虑那些 5GHz 的频段了。 除此之外， 还可以通过
 	      <option>channel</option> 参数来将操作锁定在特定频率， 以及通过
 	      <option>chanlist</option> 参数来指定扫描的频段列表。
 	      关于这些参数的进一步信息， 可以在联机手册 &man.ifconfig.8;
 	      中找到。</para>
 	  </sect5>
 
 	  <sect5>
 	    <title>验证身份</title>
 
 	    <para>一旦您选定了无线访问点， 您的通讯站就需要完成身份验证，
 	      以便开始发送和接收数据。 身份验证可以通过许多方式进行，
 	      最常用的一种方式称为开放式验证，
 	      它允许任意通讯站加入网络并相互通信。
 	      这种验证方式只应在您第一次配置无线网络进行测试时使用。
 	      其它的验证方式则需要在进行数据通讯之前，
 	      首先进行密钥协商握手； 这些方式要么使用预先分发的密钥或密码，
 	      要么是用更复杂一些的后台服务， 如 RADIUS。
 	      绝大多数用户会使用默认的开放式验证，
 	      而第二多的则是 WPA-PSK， 它也称为个人 WPA， 在 <link linkend="network-wireless-wpa-wpa-psk">下面</link>
 	      的章节中将进行介绍。</para>
 
 	    <note>
 	      <para>如果您使用 &apple; &airport; Extreme 基站作为无线访问点，
 		则可能需要同时在两端配置 WEP 共享密钥验证。 这可以通过在
 		<filename>/etc/rc.conf</filename> 文件中进行设置， 或使用
 		&man.wpa.supplicant.8; 程序来手工完成。 如果您只有一个
 		&airport; 基站， 则可以用类似下面的方法来配置：</para>
 
 	      <programlisting>wlans_ath0="wlan0"
 ifconfig_wlan0="authmode shared wepmode on weptxkey <replaceable>1</replaceable> wepkey <replaceable>01234567</replaceable> DHCP"</programlisting>
 
 	      <para>一般而言， 应尽量避免使用共享密钥这种验证方法，
 		因为它以非常受限的方式使用 WEP 密钥，
 		使得攻击者能够很容易地破解密钥。 如果必须使用 WEP (例如，
 		为了兼容旧式的设备) 最好使用
 		WEP 配合 <literal>open</literal> 验证方式。
 		关于 WEP 的更多资料请参见 <xref linkend="network-wireless-wep"/>。</para>
 	    </note>
 	  </sect5>
 
 	  <sect5>
 	    <title>通过 DHCP 获取 IP 地址</title>
 
 	    <para>在您选定了无线访问点， 并配置了验证参数之后，
 	      还必须获得 IP 地址才能真正开始通讯。 多数时候，
 	      您会通过 DHCP 来获得无线 IP 地址。 要达到这个目的，
 	      需要编辑 <filename>/etc/rc.conf</filename> 并在配置中加入
 	      <literal>DHCP</literal>：</para>
 
 	    <programlisting>wlans_ath0="wlan0"
 ifconfig_wlan0="DHCP"</programlisting>
 
 	    <para>现在您已经完成了启用无线网络接口的全部准备工作了，
 	      下面的操作将启用它：</para>
 
 	    <screen>&prompt.root; <userinput>/etc/rc.d/netif start</userinput></screen>
 
 	    <para>一旦网络接口开始运行， 就可以使用
 	      <command>ifconfig</command> 来查看网络接口 <filename>ath0</filename>
 	      的状态了：</para>
 
 	    <screen>&prompt.root; <userinput>ifconfig wlan0</userinput>
 wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; mtu 1500
         ether 00:11:95:d5:43:62
         inet 192.168.1.100 netmask 0xffffff00 broadcast 192.168.1.255
         media: IEEE 802.11 Wireless Ethernet OFDM/54Mbps mode 11g
         status: associated
         ssid dlinkap channel 11 (2462 Mhz 11g) bssid 00:13:46:49:41:76
         country US ecm authmode OPEN privacy OFF txpower 21.5 bmiss 7
         scanvalid 60 bgscan bgscanintvl 300 bgscanidle 250 roam:rssi 7
         roam:rate 5 protmode CTS wme burst</screen>
 
 	    <para>这里的 <literal>status: associated</literal>
 	      表示您已经连接到了无线网络 (在这个例子中， 这个网络的名字是
 	      <literal>dlinkap</literal>)。
 	      <literal>bssid 00:13:46:49:41:76</literal> 是指您所用无线访问点的
 	      MAC 地址；
 	      <literal>authmode OPEN</literal> 表示您通讯的内容将将不加密。</para>
 	  </sect5>
 
 	  <sect5>
 	    <title>静态 IP 地址</title>
 
 	    <para>如果无法从某个 DHCP 服务器获得 IP 地址，
 	      则可以配置一个静态 IP 地址，
 	      方法是将前面的 <literal>DHCP</literal> 关键字替换为地址信息。
 	      请务必保持其他用于连接无线访问点的参数：</para>
 
 	    <programlisting>wlans_ath0="wlan0"
 ifconfig_wlan0="inet <replaceable>192.168.1.100</replaceable> netmask <replaceable>255.255.255.0</replaceable> ssid <replaceable>your_ssid_here</replaceable>"</programlisting>
 	  </sect5>
         </sect4>
 
 	<sect4 xml:id="network-wireless-wpa">
 	  <title>WPA</title>
 
 	  <para>WPA (Wi-Fi 保护访问) 是一种与 802.11 网络配合使用的安全协议，
 	    其目的是消除 <link linkend="network-wireless-wep">WEP</link> 中缺少身份验证能力的问题，
 	    以及一些其它的安全弱点。 WPA 采用了 802.1X 认证协议，
 	    并采用从多种与 WEP 不同的加密算法中选择一种来保证数据保密性。
 	    WPA 支持的唯一一种加密算法是 TKIP (临时密钥完整性协议)，
 	    TKIP 是一种对 WEP 所采用的基本 RC4 加密算法的扩展，
 	    除此之外还提供了对检测到的入侵的响应机制。 TKIP
 	    被设计用来与旧式硬件一同工作， 只需要进行部分软件修改；
 	    它提供了一种改善安全性的折衷方案，
 	    但仍有可能受到攻击。 WPA 也指定了
 	    AES-CCMP 加密作为 TKIP 的替代品，
 	    在可能时倾向于使用这种加密； 表达这一规范的常用术语是
 	    WPA2 (或 RSN)。</para>
 
 	  <para>WPA 定义了验证和加密协议。
 	    验证通常是使用两种方法之一来完成的： 通过 802.1X
 	    或类似 RADIUS 这样的后端验证服务，
 	    或通过在通讯站和无线访问点之间通过事先分发的密码来进行最小握手。
 	    前一种通常称作企业 WPA， 而后者通常也叫做个人 WPA。
 	    因为多数人不会为无线网络配置 RADIUS 后端服务器， 因此
 	    WPA-PSK 是在 WPA 中最为常见的一种。</para>
 
 	  <para>对无线连接的控制和身份验证工作 (密钥协商或通过服务器验证)
 	    是通过 &man.wpa.supplicant.8; 工具来完成的。
 	    这个程序运行时需要一个配置文件，
 	    <filename>/etc/wpa_supplicant.conf</filename>。
 	    关于这个文件的更多信息， 请参考联机手册
 	    &man.wpa.supplicant.conf.5;。</para>
 
 	  <sect5 xml:id="network-wireless-wpa-wpa-psk">
 	    <title>WPA-PSK</title>
 
 	    <para>WPA-PSK 也称作 个人-WPA， 它基于预先分发的密钥 (PSK)，
 	      这个密钥是根据作为无线网络上使用的主密钥的密码生成的。
 	      这表示每个无线用户都会使用同样的密钥。 WPA-PSK
 	      主要用于小型网络， 在这种网络中，
 	      通常不需要或没有办法架设验证服务器。</para>
 
 	    <warning>
 	      <para>无论何时， 都应使用足够长， 且包括尽可能多字母和数字的强口令，
 		以免被猜出和/或攻击。</para>
 	    </warning>
 
 	    <para>第一步是修改配置文件
 	      <filename>/etc/wpa_supplicant.conf</filename>，
 	      并在其中加入在您网络上使用的 SSID 和事先分发的密钥：</para>
 
 	    <programlisting>network={
   ssid="freebsdap"
   psk="freebsdmall"
 }</programlisting>
 
 	    <para>接下来， 在 <filename>/etc/rc.conf</filename> 中，
 	      我们将指定无线设备的配置， 令其采用 WPA，
 	      并通过 DHCP 来获取 IP 地址：</para>
 
 	    <programlisting>wlans_ath0="wlan0"
 ifconfig_wlan0="WPA DHCP"</programlisting>
 
 	    <para>下面启用无线网络接口：</para>
 
 	    <screen>&prompt.root; <userinput>/etc/rc.d/netif start</userinput>
 Starting wpa_supplicant.
 DHCPDISCOVER on wlan0 to 255.255.255.255 port 67 interval 5
 DHCPDISCOVER on wlan0 to 255.255.255.255 port 67 interval 6
 DHCPOFFER from 192.168.0.1
 DHCPREQUEST on wlan0 to 255.255.255.255 port 67
 DHCPACK from 192.168.0.1
 bound to 192.168.0.254 -- renewal in 300 seconds.
 wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; mtu 1500
       ether 00:11:95:d5:43:62
       inet 192.168.0.254 netmask 0xffffff00 broadcast 192.168.0.255
       media: IEEE 802.11 Wireless Ethernet OFDM/36Mbps mode 11g
       status: associated
       ssid freebsdap channel 1 (2412 Mhz 11g) bssid 00:11:95:c3:0d:ac
       country US ecm authmode WPA2/802.11i privacy ON deftxkey UNDEF
       AES-CCM 3:128-bit txpower 21.5 bmiss 7 scanvalid 450 bgscan
       bgscanintvl 300 bgscanidle 250 roam:rssi 7 roam:rate 5 protmode CTS
       wme burst roaming MANUAL</screen>
 
 	    <para>除此之外， 您也可以手动地使用 <link linkend="network-wireless-wpa-wpa-psk">above</link> 中那份
 	      <filename>/etc/wpa_supplicant.conf</filename> 来配置，
 	      方法是执行：</para>
 
 	    <screen>&prompt.root; <userinput>wpa_supplicant -i wlan0 -c /etc/wpa_supplicant.conf</userinput>
 Trying to associate with 00:11:95:c3:0d:ac (SSID='freebsdap' freq=2412 MHz)
 Associated with 00:11:95:c3:0d:ac
 WPA: Key negotiation completed with 00:11:95:c3:0d:ac [PTK=CCMP GTK=CCMP]
 CTRL-EVENT-CONNECTED - Connection to 00:11:95:c3:0d:ac completed (auth) [id=0 id_str=]</screen>
 
 	    <para>接下来的操作， 是运行
 	      <command>dhclient</command> 命令来从 DHCP 服务器获取 IP：</para>
 
 	    <screen>&prompt.root; <userinput>dhclient wlan0</userinput>
 DHCPREQUEST on wlan0 to 255.255.255.255 port 67
 DHCPACK from 192.168.0.1
 bound to 192.168.0.254 -- renewal in 300 seconds.
 &prompt.root; <userinput>ifconfig wlan0</userinput>
 wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; mtu 1500
       ether 00:11:95:d5:43:62
       inet 192.168.0.254 netmask 0xffffff00 broadcast 192.168.0.255
       media: IEEE 802.11 Wireless Ethernet OFDM/36Mbps mode 11g
       status: associated
       ssid freebsdap channel 1 (2412 Mhz 11g) bssid 00:11:95:c3:0d:ac
       country US ecm authmode WPA2/802.11i privacy ON deftxkey UNDEF
       AES-CCM 3:128-bit txpower 21.5 bmiss 7 scanvalid 450 bgscan
       bgscanintvl 300 bgscanidle 250 roam:rssi 7 roam:rate 5 protmode CTS
       wme burst roaming MANUAL</screen>
 
 	    <note>
               <para>如果在 <filename>/etc/rc.conf</filename> 中把
                 <literal>ifconfig_wlan0</literal>
                 设置成了 <literal>DHCP</literal>
                 (像 <literal>ifconfig_wlan0="DHCP"</literal> 这样)，
                 那么在 <command>wpa_supplicant</command>
                 连上了无线接入点 (AP) 之后，则会自动运行
                 <command>dhclient</command>。</para>
 	    </note>
 
 	    <para>如果不打算使用 DHCP 或者 DHCP 不可用， 您可以在
 	      <command>wpa_supplicant</command> 为通讯站完成了身份认证之后，
 	      指定静态 IP 地址：</para>
 
 	    <screen>&prompt.root; <userinput>ifconfig wlan0 inet 192.168.0.100 netmask 255.255.255.0</userinput>
 &prompt.root; <userinput>ifconfig wlan0</userinput>
 wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; mtu 1500
       ether 00:11:95:d5:43:62
       inet 192.168.0.100 netmask 0xffffff00 broadcast 192.168.0.255
       media: IEEE 802.11 Wireless Ethernet OFDM/36Mbps mode 11g
       status: associated
       ssid freebsdap channel 1 (2412 Mhz 11g) bssid 00:11:95:c3:0d:ac
       country US ecm authmode WPA2/802.11i privacy ON deftxkey UNDEF
       AES-CCM 3:128-bit txpower 21.5 bmiss 7 scanvalid 450 bgscan
       bgscanintvl 300 bgscanidle 250 roam:rssi 7 roam:rate 5 protmode CTS
       wme burst roaming MANUAL</screen>
 
 	    <para>如果没有使用 DHCP， 还需要手工配置默认网关，
 	      以及域名服务器：</para>
 
 	    <screen>&prompt.root; <userinput>route add default your_default_router</userinput>
 &prompt.root; <userinput>echo "nameserver your_DNS_server" &gt;&gt; /etc/resolv.conf</userinput></screen>
 	  </sect5>
 
 	  <sect5 xml:id="network-wireless-wpa-eap-tls">
 	    <title>使用 EAP-TLS 的 WPA</title>
 
 	    <para>使用 WPA 的第二种方式是使用 802.1X 后端验证服务器。
 	      在这个例子中， WPA 也称作 企业-WPA，
 	      以便与安全性较差、 采用事先分发密钥的 个人-WPA 区分开来。
 	      在 企业-WPA 中， 验证操作是采用 EAP 完成的
 	      (可扩展认证协议)。</para>
 
 	    <para>EAP 并未附带加密方法。
 	      因此设计者决定将 EAP 放在加密信道中进行传送。
 	      目前有许多 EAP 验证方法，
 	      最常用的方法是 EAP-TLS、 EAP-TTLS 和
 	      EAP-PEAP。</para>
 
 	    <para>EAP-TLS (带 传输层安全 的 EAP)
 	      是一种在无线世界中得到了广泛支持的验证协议，
 	      因为它是 <link xlink:href="http://www.wi-fi.org/">Wi-Fi 联盟</link>
 	      核准的第一个 EAP 方法。
 	      EAP-TLS 需要使用三个证书： CA
 	      证书 (在所有计算机上安装)、 用以向您证明服务器身份的服务器证书，
 	      以及每个无线客户端用于证明身份的客户机证书。 在这种
 	      EAP 方式中， 验证服务器和无线客户端均通过自己的证书向对方证明身份，
 	      它们均验证对方的证书是本机构的证书发证机构 (CA) 签发的。</para>
 
 	    <para>与之前介绍的方法类似， 配置也是通过
 	      <filename>/etc/wpa_supplicant.conf</filename> 来完成的：</para>
 
 	    <programlisting>network={
   ssid="freebsdap" <co xml:id="co-tls-ssid"/>
   proto=RSN  <co xml:id="co-tls-proto"/>
   key_mgmt=WPA-EAP <co xml:id="co-tls-kmgmt"/>
   eap=TLS <co xml:id="co-tls-eap"/>
   identity="loader" <co xml:id="co-tls-id"/>
   ca_cert="/etc/certs/cacert.pem" <co xml:id="co-tls-cacert"/>
   client_cert="/etc/certs/clientcert.pem" <co xml:id="co-tls-clientcert"/>
   private_key="/etc/certs/clientkey.pem" <co xml:id="co-tls-pkey"/>
   private_key_passwd="freebsdmallclient" <co xml:id="co-tls-pwd"/>
 }</programlisting>
 
 	    <calloutlist>
 	      <callout arearefs="co-tls-ssid">
 		<para>这个字段表示网络名
 		  (SSID)。</para>
 	      </callout>
 
 	      <callout arearefs="co-tls-proto">
 		<para>这里， 我们使用 RSN (&ieee; 802.11i) 协议， 也就是
 		  WPA2。</para>
 	      </callout>
 
 	      <callout arearefs="co-tls-kmgmt">
 		<para><literal>key_mgmt</literal> 这行表示所用的密钥管理协议。
 		  在我们的例子中， 它是使用 EAP 验证的 WPA：
 		  <literal>WPA-EAP</literal>。</para>
 	      </callout>
 
 	      <callout arearefs="co-tls-eap">
 		<para>这个字段中， 提到了我们的连接采用 EAP 方式。</para>
 	      </callout>
 
 	      <callout arearefs="co-tls-id">
 		<para><literal>identity</literal> 字段包含了 EAP 的实体串。</para>
 	      </callout>
 
 	      <callout arearefs="co-tls-cacert">
 		<para><literal>ca_cert</literal> 字段给出了 CA 证书文件的路径名。
 		  在验证服务器证书时， 这个文件是必需的。</para>
 	      </callout>
 
 	      <callout arearefs="co-tls-clientcert">
 		<para><literal>client_cert</literal> 这行给出了客户机证书的路径名。
 		  对每个无线客户端而言， 这个证书都是在全网范围内唯一的。</para>
 	      </callout>
 
 	      <callout arearefs="co-tls-pkey">
 		<para><literal>private_key</literal> 字段是客户机证书私钥文件的路径名。</para>
 	      </callout>
 
 	      <callout arearefs="co-tls-pwd">
 		<para><literal>private_key_passwd</literal> 字段是私钥的口令字。</para>
 	      </callout>
 	    </calloutlist>
 
 	    <para>接着， 把下面的配置写入
 	      <filename>/etc/rc.conf</filename>：</para>
 
 	    <programlisting>wlans_ath0="wlan0"
 ifconfig_wlan0="WPA DHCP"</programlisting>
 
 	    <para>下一步是使用 <filename>rc.d</filename> 机制来启用网络接口：</para>
 
 	    <screen>&prompt.root; <userinput>/etc/rc.d/netif start</userinput>
 Starting wpa_supplicant.
 DHCPREQUEST on wlan0 to 255.255.255.255 port 67 interval 7
 DHCPREQUEST on wlan0 to 255.255.255.255 port 67 interval 15
 DHCPACK from 192.168.0.20
 bound to 192.168.0.254 -- renewal in 300 seconds.
 wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; mtu 1500
       ether 00:11:95:d5:43:62
       inet 192.168.0.254 netmask 0xffffff00 broadcast 192.168.0.255
       media: IEEE 802.11 Wireless Ethernet DS/11Mbps mode 11g
       status: associated
       ssid freebsdap channel 1 (2412 Mhz 11g) bssid 00:11:95:c3:0d:ac
       country US ecm authmode WPA2/802.11i privacy ON deftxkey UNDEF
       AES-CCM 3:128-bit txpower 21.5 bmiss 7 scanvalid 450 bgscan
       bgscanintvl 300 bgscanidle 250 roam:rssi 7 roam:rate 5 protmode CTS
       wme burst roaming MANUAL</screen>
 
 	    <para>如前面提到的那样， 也可以手工通过
 	      <command>wpa_supplicant</command> 和
 	      <command>ifconfig</command> 命令达到类似的目的。</para>
 	  </sect5>
 
 	  <sect5 xml:id="network-wireless-wpa-eap-ttls">
 	    <title>使用 EAP-TTLS 的 WPA</title>
 
 	    <para>在使用 EAP-TLS 时， 参与验证过程的服务器和客户机都需要证书，
 	      而在使用 EAP-TTLS (带传输层安全隧道的 EAP) 时，
 	      客户机证书则是可选的。 这种方式与某些安全 web
 	      站点更为接近， 即使访问者没有客户端证书，
 	      这些 web 服务器也能建立安全的 SSL 隧道。
 	      EAP-TTLS 会使用加密的 TLS
 	      隧道来传送验证信息。</para>
 
 	    <para>对于它的配置， 同样是通过
 	      <filename>/etc/wpa_supplicant.conf</filename>
 	      文件来进行的：</para>
 
 	    <programlisting>network={
   ssid="freebsdap"
   proto=RSN
   key_mgmt=WPA-EAP
   eap=TTLS <co xml:id="co-ttls-eap"/>
   identity="test" <co xml:id="co-ttls-id"/>
   password="test" <co xml:id="co-ttls-passwd"/>
   ca_cert="/etc/certs/cacert.pem" <co xml:id="co-ttls-cacert"/>
   phase2="auth=MD5" <co xml:id="co-ttls-pha2"/>
 }</programlisting>
 
 	    <calloutlist>
 	      <callout arearefs="co-ttls-eap">
 		<para>这个字段是我们的连接所采用的 EAP 方式。</para>
 	      </callout>
 
 	      <callout arearefs="co-ttls-id">
 		<para><literal>identity</literal> 字段中是在加密 TLS 隧道中用于 EAP
 		  验证的身份串。</para>
 	      </callout>
 
 	      <callout arearefs="co-ttls-passwd">
 		<para><literal>password</literal> 字段中是用于 EAP
 		  验证的口令字。</para>
 	      </callout>
 
 	      <callout arearefs="co-ttls-cacert">
 		<para><literal>ca_cert</literal> 字段给出了 CA 证书文件的路径名。
 		  在验证服务器证书时， 这个文件是必需的。</para>
 	      </callout>
 
 	      <callout arearefs="co-ttls-pha2">
 		<para>这个字段中给出了加密 TLS 隧道中使用的验证方式。
 		  在这个例子中， 我们使用的是带 MD5-加密口令 的 EAP。
 		  <quote>inner authentication</quote> (译注：内部鉴定) 通常也叫
 		  <quote>phase2</quote>。</para>
 	      </callout>
 	    </calloutlist>
 
 	    <para>您还必须把下面的配置写入
 	      <filename>/etc/rc.conf</filename>：</para>
 
 	    <programlisting>wlans_ath0="wlan0"
 ifconfig_wlan0="WPA DHCP"</programlisting>
 
 	    <para>下一步是启用网络接口：</para>
 
 	    <screen>&prompt.root; <userinput>/etc/rc.d/netif start</userinput>
 Starting wpa_supplicant.
 DHCPREQUEST on wlan0 to 255.255.255.255 port 67 interval 7
 DHCPREQUEST on wlan0 to 255.255.255.255 port 67 interval 15
 DHCPREQUEST on wlan0 to 255.255.255.255 port 67 interval 21
 DHCPACK from 192.168.0.20
 bound to 192.168.0.254 -- renewal in 300 seconds.
 wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; mtu 1500
       ether 00:11:95:d5:43:62
       inet 192.168.0.254 netmask 0xffffff00 broadcast 192.168.0.255
       media: IEEE 802.11 Wireless Ethernet DS/11Mbps mode 11g
       status: associated
       ssid freebsdap channel 1 (2412 Mhz 11g) bssid 00:11:95:c3:0d:ac
       country US ecm authmode WPA2/802.11i privacy ON deftxkey UNDEF
       AES-CCM 3:128-bit txpower 21.5 bmiss 7 scanvalid 450 bgscan
       bgscanintvl 300 bgscanidle 250 roam:rssi 7 roam:rate 5 protmode CTS
       wme burst roaming MANUAL</screen>
 	  </sect5>
 
 	  <sect5 xml:id="network-wireless-wpa-eap-peap">
 	    <title>使用 EAP-PEAP 的 WPA</title>
 
 	    <note>
               <para>PEAPv0/EAP-MSCHAPv2 是最常见的 PEAP 方法。
                 此文档的以下部分将使用 PEAP 指代这些方法。</para>
 	    </note>
 
 	    <para>PEAP (受保护的 EAP) 被设计用以替代 EAP-TTLS，
 	      并且是在 EAP-TLS 之后最为常用的 EAP 标准。
 	      换言之， 如果您的网络中有多种不同的操作系统，
 	      PEAP 将是仅次于 EAP-TLS 的支持最广的标准。</para>
 
 	    <para>PEAP 与 EAP-TTLS 很像： 它使用服务器端证书，
 	      通过在客户端与验证服务器之间建立加密的 TLS 隧道来向用户验证身份，
 	      这保护了验证信息的交换过程。 在安全方面，
 	      EAP-TTLS 与 PEAP 的区别是 PEAP 会以明文广播用户名，
 	      只有口令是通过加密 TLS 隧道传送的。 而
               EAP-TTLS 在传送用户名和口令时， 都使用 TLS 隧道。</para>
 
 	    <para>我们需要编辑
 	      <filename>/etc/wpa_supplicant.conf</filename> 文件，
 	      并加入与 EAP-PEAP 有关的配置：</para>
 
 	    <programlisting>network={
   ssid="freebsdap"
   proto=RSN
   key_mgmt=WPA-EAP
   eap=PEAP <co xml:id="co-peap-eap"/>
   identity="test" <co xml:id="co-peap-id"/>
   password="test" <co xml:id="co-peap-passwd"/>
   ca_cert="/etc/certs/cacert.pem" <co xml:id="co-peap-cacert"/>
   phase1="peaplabel=0" <co xml:id="co-peap-pha1"/>
   phase2="auth=MSCHAPV2" <co xml:id="co-peap-pha2"/>
 }</programlisting>
 
 	    <calloutlist>
 	      <callout arearefs="co-peap-eap">
 		<para>这个字段的内容是用于连接的 EAP 方式。</para>
 	      </callout>
 
 	      <callout arearefs="co-peap-id">
 		<para><literal>identity</literal> 字段中是在加密 TLS 隧道中用于 EAP
 		  验证的身份串。</para>
 	      </callout>
 
 	      <callout arearefs="co-peap-passwd">
 		<para><literal>password</literal> 字段中是用于 EAP
 		  验证的口令字。</para>
 	      </callout>
 
 	      <callout arearefs="co-peap-cacert">
 		<para><literal>ca_cert</literal> 字段给出了 CA 证书文件的路径名。
 		  在验证服务器证书时， 这个文件是必需的。</para>
 	      </callout>
 
 	      <callout arearefs="co-peap-pha1">
 		<para>这个字段包含了第一阶段验证 (TLS
 		  隧道) 的参数。 随您使用的验证服务器的不同，
 		  您需要指定验证的标签。 多数时候，
 		  标签应该是 <quote>客户端 EAP 加密</quote>，
 		  这可以通过使用 <literal>peaplabel=0</literal> 来指定。
 		  更多信息可以在联机手册
 		  &man.wpa.supplicant.conf.5; 中找到。</para>
 	      </callout>
 
 	      <callout arearefs="co-peap-pha2">
 		<para>这个字段的内容是验证协议在加密的 TLS 隧道中使用的信息。
 		  对 PEAP 而言， 这是
 		  <literal>auth=MSCHAPV2</literal>。</para>
 	      </callout>
 	    </calloutlist>
 
 	    <para>您还必须把下面的配置加入到
 	      <filename>/etc/rc.conf</filename>：</para>
 
 	    <programlisting>wlans_ath0="wlan0"
 ifconfig_wlan0="WPA DHCP"</programlisting>
 
 	    <para>下一步是启用网络接口：</para>
 
 	    <screen>&prompt.root; <userinput>/etc/rc.d/netif start</userinput>
 Starting wpa_supplicant.
 DHCPREQUEST on wlan0 to 255.255.255.255 port 67 interval 7
 DHCPREQUEST on wlan0 to 255.255.255.255 port 67 interval 15
 DHCPREQUEST on wlan0 to 255.255.255.255 port 67 interval 21
 DHCPACK from 192.168.0.20
 bound to 192.168.0.254 -- renewal in 300 seconds.
 wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; mtu 1500
       ether 00:11:95:d5:43:62
       inet 192.168.0.254 netmask 0xffffff00 broadcast 192.168.0.255
       media: IEEE 802.11 Wireless Ethernet DS/11Mbps mode 11g
       status: associated
       ssid freebsdap channel 1 (2412 Mhz 11g) bssid 00:11:95:c3:0d:ac
       country US ecm authmode WPA2/802.11i privacy ON deftxkey UNDEF
       AES-CCM 3:128-bit txpower 21.5 bmiss 7 scanvalid 450 bgscan
       bgscanintvl 300 bgscanidle 250 roam:rssi 7 roam:rate 5 protmode CTS
       wme burst roaming MANUAL</screen>
 	  </sect5>
 	</sect4>
 
 	<sect4 xml:id="network-wireless-wep">
 	  <title>WEP</title>
 
 	  <para>WEP (有线等效协议) 是最初
 	    802.11 标准的一部分。 其中没有提供身份验证机制，
 	    只提供了弱访问控制， 而且很容易破解。</para>
 
 	  <para>WEP 可以通过
 	    <command>ifconfig</command> 配置：</para>
 
 	  <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0</userinput>
 &prompt.root; <userinput>ifconfig wlan0 inet 192.168.1.100 netmask 255.255.255.0 \
 	    ssid my_net wepmode on weptxkey 3 wepkey 3:0x3456789012</userinput></screen>
 
 	  <itemizedlist>
 	    <listitem>
 	      <para><literal>weptxkey</literal> 指明了使用哪个 WEP
 		密钥来进行数据传输。 这里我们使用第三个密钥。
 		它必须与无线接入点的配置一致。
                 如果你不清楚你的无线接入点，
                 尝试用 <literal>1</literal>
                 （就是说第一个密钥）来设置这个变量。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para><literal>wepkey</literal> 用于选择 WEP 密钥。
 		其格式应为
 		<replaceable>index:key</replaceable>，
 		key 默认为 <literal>1</literal>;
 		如果需要设置的密钥不是第一个， 就必需指定 index 了。</para>
 
 	      <note>
 		<para>您需要将 <literal>0x3456789012</literal> 改为在无线接入点上配置的那个。</para>
 	      </note>
 	    </listitem>
 	  </itemizedlist>
 
 	  <para>我们建议您阅读联机手册 &man.ifconfig.8; 来了解进一步的信息。</para>
 
 	  <para><command>wpa_supplicant</command> 机制也可以用来配置您的无线网卡使用 WEP。
 	    前面的例子也可以通过在
 	    <filename>/etc/wpa_supplicant.conf</filename> 中加入下述设置来实现：</para>
 
 	  <programlisting>network={
   ssid="my_net"
   key_mgmt=NONE
   wep_key3=3456789012
   wep_tx_keyidx=3
 }</programlisting>
 
 	  <para>接着：</para>
 
 	  <screen>&prompt.root; <userinput>wpa_supplicant -i wlan0 -c /etc/wpa_supplicant.conf</userinput>
 Trying to associate with 00:13:46:49:41:76 (SSID='dlinkap' freq=2437 MHz)
 Associated with 00:13:46:49:41:76</screen>
 	</sect4>
       </sect3>
     </sect2>
 
     <sect2>
       <title>Ad-hoc 模式</title>
 
       <para>IBSS 模式， 也称为 ad-hoc 模式， 是为点对点连接设计的。
 	例如， 如果希望在计算机 <systemitem>A</systemitem> 和
 	<systemitem>B</systemitem> 之间建立 ad-hoc 网络，
 	我们只需选择两个 IP 地址和一个 SSID 就可以了。</para>
 
       <para>在计算机 <systemitem>A</systemitem> 上：</para>
 
       <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0 wlanmode adhoc</userinput>
 &prompt.root; <userinput>ifconfig wlan0 inet 192.168.0.1 netmask 255.255.255.0 ssid freebsdap</userinput>
 &prompt.root; <userinput>ifconfig wlan0</userinput>
   wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
 	  ether 00:11:95:c3:0d:ac
 	  inet 192.168.0.1 netmask 0xffffff00 broadcast 192.168.0.255
 	  media: IEEE 802.11 Wireless Ethernet autoselect mode 11g &lt;adhoc&gt;
 	  status: running
 	  ssid freebsdap channel 2 (2417 Mhz 11g) bssid 02:11:95:c3:0d:ac
 	  country US ecm authmode OPEN privacy OFF txpower 21.5 scanvalid 60
 	  protmode CTS wme burst</screen>
 
       <para>此处的 <literal>adhoc</literal> 参数表示无线网络接口应以 IBSS 模式运转。</para>
 
       <para>此时， 在 <systemitem>B</systemitem> 上应该能够检测到
 	<systemitem>A</systemitem> 的存在了：</para>
 
       <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0 wlanmode adhoc</userinput>
 &prompt.root; <userinput>ifconfig wlan0 up scan</userinput>
   SSID/MESH ID    BSSID              CHAN RATE   S:N     INT CAPS
   freebsdap       02:11:95:c3:0d:ac    2   54M -64:-96  100 IS   WME</screen>
 
       <para>在输出中的 <literal>I</literal> 再次确认了 <systemitem>A</systemitem>
 	机是以 ad-hoc 模式运行的。 我们只需给 <systemitem>B</systemitem> 配置一不同的 IP
 	地址：</para>
 
       <screen>&prompt.root; <userinput>ifconfig wlan0 inet 192.168.0.2 netmask 255.255.255.0 ssid freebsdap</userinput>
 &prompt.root; <userinput>ifconfig wlan0</userinput>
   wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
 	  ether 00:11:95:d5:43:62
 	  inet 192.168.0.2 netmask 0xffffff00 broadcast 192.168.0.255
 	  media: IEEE 802.11 Wireless Ethernet autoselect mode 11g &lt;adhoc&gt;
 	  status: running
 	  ssid freebsdap channel 2 (2417 Mhz 11g) bssid 02:11:95:c3:0d:ac
 	  country US ecm authmode OPEN privacy OFF txpower 21.5 scanvalid 60
 	  protmode CTS wme burst</screen>
 
 	  <para>这样， <systemitem>A</systemitem> 和 <systemitem>B</systemitem> 就可以交换信息了。</para>
     </sect2>
 
     <sect2 xml:id="network-wireless-ap">
       <title>&os; 基于主机的（无线）访问接入点</title>
 
       <para>&os; 可以作为一个（无线）访问接入点（AP），
 	这样可以不必再去买一个硬件 AP 或者使用 ad-hoc 模式的网络。
 	当你的 &os; 机器作为网关连接到另外一个网络的时候将非常有用。</para>
 
       <sect3 xml:id="network-wireless-ap-basic">
 	<title>基本配置</title>
 
 	<para>在把你的 &os; 机器配置成一个 AP 以前，
 	  你首先需要先在内核配置好对你的无线网卡的无线网络支持。
 	  当然你还需要加上你想用的安全协议。想获得更详细的信息，
 	  请参阅 <xref linkend="network-wireless-basic"/>。</para>
 
 	<note>
 	  <para>目前还不支持使用 &windows; 驱动和 NDIS
 	    驱动包装的网卡做为 AP 使用。只有 &os;
 	    原生的无线驱动能够支持 AP 模式。</para>
 	</note>
 
 	<para>一旦装载了无线网络的支持，
 	  你就可以检查一下看看你的无线设备是否支持基于主机的无线访问接入模式
 	  （通常也被称为 hostap 模式）：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0</userinput>
 &prompt.root; <userinput>ifconfig wlan0 list caps</userinput>
 drivercaps=6f85edc1&lt;STA,FF,TURBOP,IBSS,HOSTAP,AHDEMO,TXPMGT,SHSLOT,SHPREAMBLE,MONITOR,MBSS,WPA1,WPA2,BURST,WME,WDS,BGSCAN,TXFRAG&gt;
 cryptocaps=1f&lt;WEP,TKIP,AES,AES_CCM,TKIPMIC&gt;</screen>
 
 	<para>这段输出显示了网卡所支持的各种功能； 其中的关键字
 	  <literal>HOSTAP</literal> 表示这块网卡可以作为无线网络接入点来使用。
 	  此外， 这里还会给出所支持的加密算法： WEP、 TKIP、 AES， 等等。
 	  这些信息对于知道在访问接入点上使用何种安全协议非常重要。</para>
 
 	<para>只有创建网络伪设备时能够配置无线设备是否以 hostap 模式运行，
 	  如果之前已经存在了相应的设备， 则需要首先将其销毁：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig wlan0 destroy</userinput></screen>
 
 	<para>接着， 在配置其它参数前， 以正确的选项重新生成设备：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0 wlanmode hostap</userinput>
 &prompt.root; <userinput>ifconfig wlan0 inet 192.168.0.1 netmask 255.255.255.0 ssid freebsdap mode 11g channel 1</userinput></screen>
 
 	<para>再次使用 <command>ifconfig</command> 检查
 	  <filename>wlan0</filename> 网络接口的状态：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig wlan0</userinput>
   wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
 	  ether 00:11:95:c3:0d:ac
 	  inet 192.168.0.1 netmask 0xffffff00 broadcast 192.168.0.255
 	  media: IEEE 802.11 Wireless Ethernet autoselect mode 11g &lt;hostap&gt;
 	  status: running
 	  ssid freebsdap channel 1 (2412 Mhz 11g) bssid 00:11:95:c3:0d:ac
 	  country US ecm authmode OPEN privacy OFF txpower 21.5 scanvalid 60
 	  protmode CTS wme burst dtimperiod 1 -dfs</screen>
 
 	<para><literal>hostap</literal> 参数指定了接口以主机接入点的方式运行。</para>
 
 	<para>通过在 <filename>/etc/rc.conf</filename> 中加入下面的配置，
 	  也可以在系统引导的过程中自动完成对于网络接口的配置：</para>
 
 	<programlisting>wlans_ath0="wlan0"
 create_args_wlan0="wlanmode hostap"
 ifconfig_wlan0="inet <replaceable>192.168.0.1</replaceable> netmask <replaceable>255.255.255.0</replaceable> ssid <replaceable>freebsdap</replaceable> mode 11g channel <replaceable>1</replaceable>"</programlisting>
       </sect3>
 
       <sect3>
 	<title>不使用认证或加密的（无线）访问接入点</title>
 
 	<para>尽管我们不推荐运行一个不使用任何认证或加密的 AP，
 	  但这是一个非常简单的检测 AP 是否正常工作的方法。
 	  这样配置对于调试客户端问题也非常重要。</para>
 
 	<para>一旦 AP 被配置成了我们前面所展示的那样，
 	  就可以在另外一台无线机器上初始化一次扫描来找到这个 AP：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0</userinput>
 &prompt.root; <userinput>ifconfig wlan0 up scan</userinput>
 SSID/MESH ID    BSSID              CHAN RATE   S:N     INT CAPS
 freebsdap       00:11:95:c3:0d:ac    1   54M -66:-96  100 ES   WME</screen>
 
 	<para>在客户机上能看到已经连接上了（无线）访问接入点：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig wlan0 inet 192.168.0.2 netmask 255.255.255.0 ssid freebsdap</userinput>
 &prompt.root; <userinput>ifconfig wlan0</userinput>
   wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
 	  ether 00:11:95:d5:43:62
 	  inet 192.168.0.2 netmask 0xffffff00 broadcast 192.168.0.255
 	  media: IEEE 802.11 Wireless Ethernet OFDM/54Mbps mode 11g
 	  status: associated
 	  ssid freebsdap channel 1 (2412 Mhz 11g) bssid 00:11:95:c3:0d:ac
 	  country US ecm authmode OPEN privacy OFF txpower 21.5 bmiss 7
 	  scanvalid 60 bgscan bgscanintvl 300 bgscanidle 250 roam:rssi 7
 	  roam:rate 5 protmode CTS wme burst</screen>
       </sect3>
 
       <sect3>
 	<title>使用 WPA 的（无线）访问接入点</title>
 
 	<para>这一段将注重介绍在 &os; （无线）访问接入点上配置使用
 	  WPA 安全协议。 更多有关 WPA 和配置基于 WPA 无线客户端的细节
 	  请参阅 <xref linkend="network-wireless-wpa"/>。</para>
 
 	<para><application>hostapd</application>
 	  守护进程将被用于处理与客户端的认证和在启用 WPA
 	  （无线）访问接入点上的密钥管理。</para>
 
 	<para>接下来，所有的配置操作都将在作为 AP 的 &os; 机器上完成。
 	  一旦 AP 能够正确的工作了，便把如下这行加入
 	  <filename>/etc/rc.conf</filename> 使得
 	  <application>hostapd</application>
 	  能在机器启动的时候自动运行：</para>
 
 	<programlisting>hostapd_enable="YES"</programlisting>
 
 	<para>在配置 <application>hostapd</application> 以前，
 	  请确保你已经完成了基本配置中所介绍的步骤 <xref linkend="network-wireless-ap-basic"/>。</para>
 
 	<sect4>
 	  <title>WPA-PSK</title>
 
 	  <para>WPA-PSK 旨在为没有认证服务器的小型网络而设计的。</para>
 
 	  <para>配置文件为
 	    <filename>/etc/hostapd.conf</filename> file：</para>
 
 	  <programlisting>interface=wlan0 <co xml:id="co-ap-wpapsk-iface"/>
 debug=1 <co xml:id="co-ap-wpapsk-dbug"/>
 ctrl_interface=/var/run/hostapd <co xml:id="co-ap-wpapsk-ciface"/>
 ctrl_interface_group=wheel <co xml:id="co-ap-wpapsk-cifacegrp"/>
 ssid=freebsdap <co xml:id="co-ap-wpapsk-ssid"/>
 wpa=1 <co xml:id="co-ap-wpapsk-wpa"/>
 wpa_passphrase=freebsdmall <co xml:id="co-ap-wpapsk-pass"/>
 wpa_key_mgmt=WPA-PSK <co xml:id="co-ap-wpapsk-kmgmt"/>
 wpa_pairwise=CCMP TKIP <co xml:id="co-ap-wpapsk-pwise"/></programlisting>
 
 	  <calloutlist>
 	    <callout arearefs="co-ap-wpapsk-iface">
 	      <para>这一项标明了访问接入点所使用的无线接口。</para>
 	    </callout>
 
 	    <callout arearefs="co-ap-wpapsk-dbug">
 	      <para>这一项设置了执行 <application>hostapd</application>
 		时候显示相关信息的详细程度。
 		<literal>1</literal> 表示最小的级别。</para>
 	    </callout>
 
 	    <callout arearefs="co-ap-wpapsk-ciface">
 	      <para><literal>ctrl_interface</literal> 这项给出了
 		<application>hostapd</application>
 		存储与其他外部程序（比如 &man.hostapd.cli.8;)
 		通信的域套接口文件路径。这里使用了默认值。</para>
 	    </callout>
 
 	    <callout arearefs="co-ap-wpapsk-cifacegrp">
 	      <para><literal>ctrl_interface_group</literal>
 		这行设置了允许访问控制界面文件的组属性
 		（这里我们使用了 <systemitem class="groupname">wheel</systemitem> 组）。</para>
 	    </callout>
 
 	    <callout arearefs="co-ap-wpapsk-ssid">
 	      <para>这一项是设置网络的名称。</para>
 	    </callout>
 
 	    <callout arearefs="co-ap-wpapsk-wpa">
 	      <para><literal>wpa</literal> 这项表示启用了 WPA
 		而且指明要使用何种 WPA 认证协议。
 		值 <literal>1</literal> 表示 AP 将使用 WPA-PSK。</para>
 	    </callout>
 
 	    <callout arearefs="co-ap-wpapsk-pass">
 	      <para><literal>wpa_passphrase</literal>
 		这项包含用于 WPA 认证的 ASCII 密码。</para>
 
 	      <warning>
 		<para>通常使用从丰富的字母表生成足够长度的强壮密码，
 		  以不至于被轻易的猜测或攻击到。</para>
 	      </warning>
 	    </callout>
 
 	    <callout arearefs="co-ap-wpapsk-kmgmt">
 	      <para><literal>wpa_key_mgmt</literal>
 		这行表明了我们所使用的密钥管理协议。
 		在这个例子中是 WPA-PSK。</para>
 	    </callout>
 
 	    <callout arearefs="co-ap-wpapsk-pwise">
 	      <para><literal>wpa_pairwise</literal>
 		这项表示（无线）访问接入点所接受的加密算法。
 		在这个例子中，TKIP(WPA) 和 CCMP(WPA2) 密码都会被接受。
 		CCMP 密码是除 TKIP 外的另一种选择，
 		CCMP 一般作为首选密码；
 		仅有在 CCMP 不能被使用的环境中选择 TKIP。</para>
 	    </callout>
 	  </calloutlist>
 
 	  <para>接下来的一步就是运行
 	    <application>hostapd</application>：</para>
 
 	  <screen>&prompt.root; <userinput>/etc/rc.d/hostapd forcestart</userinput></screen>
 
 	<screen>&prompt.root; <userinput>ifconfig wlan0</userinput>
   wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; mtu 2290
 	  inet 192.168.0.1 netmask 0xffffff00 broadcast 192.168.0.255
 	  inet6 fe80::211:95ff:fec3:dac%ath0 prefixlen 64 scopeid 0x4
 	  ether 00:11:95:c3:0d:ac
 	  media: IEEE 802.11 Wireless Ethernet autoselect mode 11g &lt;hostap&gt;
 	  status: associated
 	  ssid freebsdap channel 1 bssid 00:11:95:c3:0d:ac
 	  authmode WPA2/802.11i privacy MIXED deftxkey 2 TKIP 2:128-bit txpowmax 36 protmode CTS dtimperiod 1 bintval 100</screen>
 
 	<para>现在客户端能够连接上运行的（无线）访问接入点了，
 	  更多细节可以参阅 <xref linkend="network-wireless-wpa"/>。
 	    查看有哪些客户连接上了 AP 可以运行命令
 	    <command>ifconfig wlan0 list
 	      sta</command>。</para>
 	</sect4>
       </sect3>
 
       <sect3>
 	<title>使用 WEP 的（无线）访问接入点</title>
 
 	<para>我们不推荐使用 WEP 来设置一个（无线）访问接入点，
 	  因为没有认证的机制并容易被破解。 一些历史遗留下的无线网卡仅支持
 	  WEP 作为安全协议， 这些网卡仅允许搭建不含认证或 WEP
 	  协议的 AP。</para>
 
 	<para>在设置了正确的 SSID 和 IP 地址后，无线设备就可以进入
 	  hostap 模式了：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0 wlanmode hostap</userinput>
 &prompt.root; <userinput>ifconfig wlan0 inet 192.168.0.1 netmask 255.255.255.0 \
 	ssid freebsdap wepmode on weptxkey 3 wepkey 3:0x3456789012 mode 11g</userinput></screen>
 
 	<itemizedlist>
 	  <listitem>
 	    <para><literal>weptxkey</literal> 表示传输中使用哪一个
 	      WEP 密钥。 这个例子中用了第3把密钥（请注意密钥的编号从
 	      <literal>1</literal>开始）。
 	      这个参数必须设置以用来加密数据。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><literal>wepkey</literal> 表示设置所使用的 WEP
 	      密钥。 它应该符合 <replaceable>index:key</replaceable>
 	      这样的格式。 如果没有指定 index，那么默认值为
 	      <literal>1</literal>。
 	      这就是说如果我们使用了除第一把以外的密钥，
 	      那么就需要指定 index。</para>
 	  </listitem>
 	</itemizedlist>
 
 	<para>再使用一次 <command>ifconfig</command> 命令查看
 	  <filename>wlan0</filename> 接口的状态：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig wlan0</userinput>
   wlan0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
 	  ether 00:11:95:c3:0d:ac
 	  inet 192.168.0.1 netmask 0xffffff00 broadcast 192.168.0.255
 	  media: IEEE 802.11 Wireless Ethernet autoselect mode 11g &lt;hostap&gt;
 	  status: running
 	  ssid freebsdap channel 4 (2427 Mhz 11g) bssid 00:11:95:c3:0d:ac
 	  country US ecm authmode OPEN privacy ON deftxkey 3 wepkey 3:40-bit
 	  txpower 21.5 scanvalid 60 protmode CTS wme burst dtimperiod 1 -dfs</screen>
 
 	<para>现在可以从另外一台无线机器上初始化一次扫描来找到这个
 	  AP 了：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0</userinput>
 &prompt.root; <userinput>ifconfig wlan0 up scan</userinput>
 SSID            BSSID              CHAN RATE  S:N   INT CAPS
 freebsdap       00:11:95:c3:0d:ac    1   54M 22:1   100 EPS</screen>
 
 	<para>现在客户机能够使用正确的参数（密钥等）
 	  找到并连上（无线）访问接入点了，
 	  更多细节请参阅<xref linkend="network-wireless-wep"/>。</para>
       </sect3>
     </sect2>
 
     <sect2>
       <title>同时使用有线和无线连接</title>
 
       <para>一般而言， 有线网络的速度更快而且更可靠，
 	而无线网络则提供更好的灵活及机动性， 使用笔记本的用户，
 	往往会希望结合两者的优点， 并能够在两种连接之间无缝切换。</para>
 
       <para>在 &os; 上可以将多个网络接口合并到一起，
 	并以 <quote>故障转移</quote> 的方式自动切换，
 	也就是说， 这一组网络接口有一定的优先顺序，
 	而操作系统在链路状态发生变化时则自动进行切换，
 	例如当同时存在有线和无线连接的时候优先使用有线网络，
 	而当有线网络断开时， 则自动切换到无线网络。</para>
 
       <para>我们将在稍后的 <xref linkend="network-aggregation"/>
 	中介绍链路聚合和故障转移， 并在
 	<xref linkend="networking-lagg-wired-and-wireless"/>
 	中对这种配置方式进行示范。</para>
     </sect2>
 
     <sect2>
       <title>故障排除</title>
 
       <para>如果您在使用无线网络时遇到了麻烦，
 	此处提供了一系列用以帮助排除故障的步骤。</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>如果您在列表中找不到无线访问点，
 	    请确认您没有将无线设备配置为使用有限的一组频段。</para>
 	</listitem>
 
 	<listitem>
 	  <para>如果您无法关联到无线访问点，
 	    请确认您的通讯站配置与无线访问点的配置一致。
 	    这包括认证模式以及安全协议。 尽可能简化您的配置。
 	    如果您正使用类似 WPA 或 WEP 这样的安全协议，
 	    请将无线访问点配置为开放验证和不采用安全措施，
 	    并检查是否数据能够通过。</para>
 	</listitem>
 
 	<listitem>
 	  <para>一旦您能够关联到无线访问点之后，
 	    就可以使用简单的工具如 &man.ping.8; 来诊断安全配置了。</para>
 
 	  <para><command>wpa_supplicant</command> 提供了许多调试支持；
 	    尝试手工运行它， 在启动时指定
 	    <option>-dd</option> 选项， 并察看输出结果。</para>
 	</listitem>
 
 	<listitem>
 	  <para>除此之外还有许多其它的底层调试工具。
 	    您可以使用 <filename>/usr/src/tools/tools/net80211</filename>
 	    中的 <command>wlandebug</command> 命令来启用 802.11
 	    协议支持层的调试功能。 例如：</para>
 
 	  <screen>&prompt.root; <userinput>wlandebug -i ath0 +scan+auth+debug+assoc</userinput>
   net.wlan.0.debug: 0 =&gt; 0xc80000&lt;assoc,auth,scan&gt;</screen>
 
 	  <para>可以用来启用与扫描无线访问点和 802.11
 	    协议在安排通讯时与握手有关的控制台信息。</para>
 
 	  <para>还有许多有用的统计信息是由 802.11 层维护的；
 	    <command>wlanstats</command> 工具可以显示这些信息。
 	    这些统计数据能够指出由 802.11 层识别出来的错误。
 	    请注意某些错误可能是由设备驱动在 802.11 层之下识别出来的，
 	    因此这些错误可能并不显示。 要诊断与设备有关的问题，
 	    您需要参考设备驱动程序的文档。</para>
 	</listitem>
       </itemizedlist>
 
       <para>如果上述信息没能帮助您找到具体的问题所在，
 	请提交问题报告， 并在其中附上这些工具的输出。</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="network-bluetooth">
     <info><title>蓝牙</title>
       <authorgroup>
         <author><personname><firstname>Pav</firstname><surname>Lucistnik</surname></personname><contrib>作者：</contrib><affiliation>
 	    <address><email>pav@FreeBSD.org</email></address>
           </affiliation></author>
       </authorgroup>
       <authorgroup>
 	<author><personname><firstname>张</firstname><surname>雪平</surname></personname><contrib>中文翻译：</contrib><affiliation>
 	    <address><email>zxpmyth@yahoo.com.cn</email></address>
 	  </affiliation></author>
 	<author><personname><firstname>袁</firstname><surname>苏义</surname></personname></author>
       </authorgroup>
     </info>
     
 
     <indexterm><primary>蓝牙</primary></indexterm>
     <sect2>
       <title>简介</title>
       <para>Bluetooth (蓝牙) 是一项无线技术，
 	用于建立带宽为 2.4GHZ，波长为 10 米的私有网络。
 	网络一般是由便携式设备，比加手机 (cellular phone)，
 	掌上电脑 (handhelds) 和膝上电脑 (laptops)) 以 ad-hoc
 	形式组成。不象其它流行的无线技术――Wi-Fi，Bluetooth
 	提供了更高级的服务层面，像类 FTP 的文件服务、文件推送
 	(file pushing)、语音传送、串行线模拟等等。</para>
 
       <para>在 &os; 里，蓝牙栈 (Bluetooth stack) 通过使用
 	Netgraph 框架 (请看 &man.netgraph.4;) 来的实现。
 	大量的"Bluetooth USB dongle"由 &man.ng.ubt.4; 驱动程序支持。
 	基于 Broadcom BCM2033 芯片组的 Bluetooth 设备可以通过
 	&man.ubtbcmfw.4; 和 &man.ng.ubt.4; 驱动程序支持。
 	3Com Bluetooth PC 卡 3CRWB60-A 由 &man.ng.bt3c.4; 驱动程序支持。
 	基于 Serial 和 UART 的蓝牙设备由 &man.sio.4;、&man.ng.h4.4;
 	和 &man.hcseriald.8;。本节介绍 USB Bluetooth dongle
 	的使用。</para>
     </sect2>
 
     <sect2>
       <title>插入设备</title>
       <para>默认的 Bluetooth 设备驱动程序已存在于内核模块里。
 	接入设备前，您需要将驱动程序加载入内核：</para>
 
       <screen>&prompt.root; <userinput>kldload ng_ubt</userinput></screen>
 
       <para>如果系统启动时 Bluetooth 设备已经存在于系统里，
 	那么从 <filename>/boot/loader.conf</filename> 里加载这个模块：</para>
 
       <programlisting>ng_ubt_load="YES"</programlisting>
 
       <para>插入USB dongle。控制台(console)(或syslog中)会出现类似如下的信息：</para>
 
       <screen>ubt0: vendor 0x0a12 product 0x0001, rev 1.10/5.25, addr 2
 ubt0: Interface 0 endpoints: interrupt=0x81, bulk-in=0x82, bulk-out=0x2
 ubt0: Interface 1 (alt.config 5) endpoints: isoc-in=0x83, isoc-out=0x3,
       wMaxPacketSize=49, nframes=6, buffer size=294</screen>
 
       <para>脚本 <filename>/etc/rc.d/bluetooth</filename>
         是用来启动和停止 Bluetooth stack (蓝牙栈)的。
         最好在拔出设备前停止 stack(stack)，当然也不是非做不可。
         启动 stack (栈) 时，会得到如下的输出：</para>
 
       <screen>&prompt.root; <userinput>/etc/rc.d/bluetooth start ubt0</userinput>
 BD_ADDR: 00:02:72:00:d4:1a
 Features: 0xff 0xff 0xf 00 00 00 00 00
 &lt;3-Slot&gt; &lt;5-Slot&gt; &lt;Encryption&gt; &lt;Slot offset&gt;
 &lt;Timing accuracy&gt; &lt;Switch&gt; &lt;Hold mode&gt; &lt;Sniff mode&gt;
 &lt;Park mode&gt; &lt;RSSI&gt; &lt;Channel quality&gt; &lt;SCO link&gt;
 &lt;HV2 packets&gt; &lt;HV3 packets&gt; &lt;u-law log&gt; &lt;A-law log&gt; &lt;CVSD&gt;
 &lt;Paging scheme&gt; &lt;Power control&gt; &lt;Transparent SCO data&gt;
 Max. ACL packet size: 192 bytes
 Number of ACL packets: 8
 Max. SCO packet size: 64 bytes
 Number of SCO packets: 8</screen>
 
     </sect2>
 
     <sect2>
       <title>主控制器接口 (HCI)</title>
 
       <indexterm><primary>HCI</primary></indexterm>
 
       <para>主控制器接口 (HCI)
 	提供了通向基带控制器和连接管理器的命令接口及访问硬件状态字和控制寄存器的通道。
 	这个接口提供了访问蓝牙基带 (Bluetooth baseband) 功能的统一方式。
 	主机上的 HCI 层与蓝牙硬件上的 HCI 固件交换数据和命令。
 	主控制器的传输层 (如物理总线) 驱动程序提供两个 HCI
 	层交换信息的能力。</para>
 
       <para>为每个蓝牙 (Bluetooth) 设备创建一个
 	<emphasis>hci</emphasis> 类型的 Netgraph 结点。
 	HCI 结点一般连接蓝牙设备的驱动结点 (下行流) 和
 	L2CAP 结点 (上行流)。 所有的HCI操作必须在 HCI
 	结点上进行而不是设备驱动结点。HCI 结点的默认名是
 	<quote>devicehci</quote>。更多细节请参考
 	&man.ng.hci.4; 的联机手册。</para>
 
       <para>最常见的任务是发现在 RF proximity
 	中的蓝牙 (Bluetooth) 设备。这个就叫做
 	<emphasis>质询(inquiry)</emphasis>。质询及 HCI
 	相关的操作可以由 &man.hccontrol.8; 工具来完成。
 	以下的例子展示如何找出范围内的蓝牙设备。
 	在几秒钟内您应该得到一张设备列表。
 	注意远程主机只有被置于
 	<emphasis>discoverable(可发现)</emphasis>
 	模式才能答应质询。</para>
 
       <screen>&prompt.user; <userinput>hccontrol -n ubt0hci inquiry</userinput>
 Inquiry result, num_responses=1
 Inquiry result #0
        BD_ADDR: 00:80:37:29:19:a4
        Page Scan Rep. Mode: 0x1
        Page Scan Period Mode: 00
        Page Scan Mode: 00
        Class: 52:02:04
        Clock offset: 0x78ef
 Inquiry complete. Status: No error [00]</screen>
 
       <para><literal>BD_ADDR</literal> 是蓝牙设备的特定地址，
 	类似于网卡的 MAC 地址。需要用此地址与某个设备进一步地通信。
 	可以为 BD_ADDR 分配由人可读的名字 (human readable name)。
 	文件 <filename>/etc/bluetooth/hosts</filename>
 	包含已知蓝牙主机的信息。
 	下面的例子展示如何获得分配给远程设备的可读名。</para>
 
       <screen>&prompt.user; <userinput>hccontrol -n ubt0hci remote_name_request 00:80:37:29:19:a4</userinput>
 BD_ADDR: 00:80:37:29:19:a4
 Name: Pav's T39</screen>
 
       <para>如果在远程蓝牙上运行质询，您会发现您的计算机是
 	<quote>your.host.name (ubt0)</quote>。
 	分配给本地设备的名字可随时改变。</para>
 
       <para>蓝牙系统提供点对点连接 (只有两个蓝牙设备参与)
 	和点对多点连接。在点对多点连接中，连接由多个蓝牙设备共享。
 	以下的例子展示如何取得本地设备的活动基带 (baseband)
 	连接列表。</para>
 
       <screen>&prompt.user; <userinput>hccontrol -n ubt0hci read_connection_list</userinput>
 Remote BD_ADDR    Handle Type Mode Role Encrypt Pending Queue State
 00:80:37:29:19:a4     41  ACL    0 MAST    NONE       0     0 OPEN</screen>
 
       <para><emphasis>connection handle(连接柄)</emphasis>
 	在需要终止基带连接时有用。注意：一般不需要手动完成。
 	栈 (stack) 会自动终止不活动的基带连接。</para>
 
       <screen>&prompt.root; <userinput>hccontrol -n ubt0hci disconnect 41</userinput>
 Connection handle: 41
 Reason: Connection terminated by local host [0x16]</screen>
 
       <para>参考 <command>hccontrol help</command>
 	获取完整的 HCI 命令列表。大部分 HCI
 	命令不需要超级用户权限。</para>
 
     </sect2>
 
     <sect2>
       <title>逻辑连接控制和适配协议(L2CAP)</title>
 
       <indexterm><primary>L2CAP</primary></indexterm>
 
       <para>逻辑连接控制和适配协议 (L2CAP)
 	为上层协议提供面向连接和无连接的数据服务，
 	并提供多协议功能和分割重组操作。L2CAP
 	充许上层协议和应用软件传输和接收最大长度为
 	64K 的 L2CAP 数据包。</para>
 
       <para>L2CAP 基于 <emphasis>通道(channel)</emphasis> 的概念。
 	通道 (Channel) 是位于基带 (baseband) 连接之上的逻辑连接。
 	每个通道以多对一的方式绑定一个单一协议 (single protocol)。
 	多个通道可以绑定同一个协议，但一个通道不可以绑定多个协议。
 	每个在通道里接收到的 L2CAP 数据包被传到相应的上层协议。
 	多个通道可共享同一个基带连接。</para>
 
       <para>为每个蓝牙 (Bluetooth) 设备创建一个
 	<emphasis>l2cap</emphasis> 类型的 Netgraph 结点。
 	L2CAP 结点一般连接 HCI 结点(下行流)和蓝牙设备的驱动结点(上行流)。
 	L2CAP 结点的默认名是 <quote>devicel2cap</quote>。
 	更多细节请参考 &man.ng.l2cap.4; 的联机手册。</para>
 
       <para>一个有用的命令是 &man.l2ping.8;，
 	它可以用来 ping 其它设备。
 	一些蓝牙实现可能不会返回所有发送给它们的数据，
 	所以下例中的 <literal>0 bytes</literal> 是正常的。</para>
 
       <screen>&prompt.root; <userinput>l2ping -a 00:80:37:29:19:a4</userinput>
 0 bytes from 0:80:37:29:19:a4 seq_no=0 time=48.633 ms result=0
 0 bytes from 0:80:37:29:19:a4 seq_no=1 time=37.551 ms result=0
 0 bytes from 0:80:37:29:19:a4 seq_no=2 time=28.324 ms result=0
 0 bytes from 0:80:37:29:19:a4 seq_no=3 time=46.150 ms result=0</screen>
 
       <para>&man.l2control.8; 工具用于在 L2CAP 上进行多种操作。
 	以下这个例子展示如何取得本地设备的逻辑连接 (通道)
 	和基带连接的列表：</para>
 
       <screen>&prompt.user; <userinput>l2control -a 00:02:72:00:d4:1a read_channel_list</userinput>
 L2CAP channels:
 Remote BD_ADDR     SCID/ DCID   PSM  IMTU/ OMTU State
 00:07:e0:00:0b:ca    66/   64     3   132/  672 OPEN
 &prompt.user; <userinput>l2control -a 00:02:72:00:d4:1a read_connection_list</userinput>
 L2CAP connections:
 Remote BD_ADDR    Handle Flags Pending State
 00:07:e0:00:0b:ca     41 O           0 OPEN</screen>
 
       <para>另一个诊断工具是 &man.btsockstat.1;。
 	它完成与 &man.netstat.1; 类似的操作，
 	只是用了蓝牙网络相关的数据结构。
 	以下这个例子显示与 &man.l2control.8; 相同的逻辑连接。</para>
 
       <screen>&prompt.user; <userinput>btsockstat</userinput>
 Active L2CAP sockets
 PCB      Recv-Q Send-Q Local address/PSM       Foreign address   CID   State
 c2afe900      0      0 00:02:72:00:d4:1a/3     00:07:e0:00:0b:ca 66    OPEN
 Active RFCOMM sessions
 L2PCB    PCB      Flag MTU   Out-Q DLCs State
 c2afe900 c2b53380 1    127   0     Yes  OPEN
 Active RFCOMM sockets
 PCB      Recv-Q Send-Q Local address     Foreign address   Chan DLCI State
 c2e8bc80      0    250 00:02:72:00:d4:1a 00:07:e0:00:0b:ca 3    6    OPEN</screen>
 
     </sect2>
 
     <sect2>
       <title>RFCOMM 协议</title>
 
       <indexterm><primary>RFCOMM</primary></indexterm>
 
       <para>RFCOMM 协议提供基于 L2CAP 协议的串行端口模拟。
 	该协议基于 ETSI TS 07.10 标准。RFCOMM 是一个简单的传输协议，
 	附加了摸拟 9 针 RS-232(EIATIA-232-E) 串行端口的定义。
 	RFCOMM 协议最多支持 60 个并发连接 (RFCOMM通道)。</para>
 
       <para>为了实现 RFCOMM，
 	运行于不同设备上的应用程序建立起一条关于它们之间通信段的通信路径。
 	RFCOMM实际上适用于使用串行端口的应用软件。
 	通信段是一个设备到另一个设备的蓝牙连接 (直接连接)。</para>
 
       <para>RFCOMM 关心的只是直接连接设备之间的连接，
 	或在网络里一个设备与 modem 之间的连接。RFCOMM 能支持其它的配置，
 	比如在一端通过蓝牙无线技术通讯而在另一端使用有线接口。</para>
 
       <para>在&os;，RFCOMM 协议在蓝牙套接字层 (Bluetooth sockets layer) 实现。</para>
     </sect2>
 
     <sect2>
       <title>设备的结对(Pairing of Devices)</title>
 
       <indexterm><primary>结对</primary></indexterm>
 
       <para>默认情况下，蓝牙通信是不需要验证的，
 	任何设备可与其它任何设备对话。一个蓝牙设备 (比如手机)
 	可以选择通过验证以提供某种特殊服务 (比如拨号服务)。
 	蓝牙验证一般使用 <emphasis>PIN码(PIN codes)</emphasis>。
 	一个 PIN 码是最长为 16 个字符的 ASCII 字符串。
 	用户需要在两个设备中输入相同的PIN码。用户输入了 PIN 码后，
 	两个设备会生成一个 <emphasis>连接密匙(link key)</emphasis>。
 	接着连接密钥可以存储在设备或存储器中。
 	连接时两个设备会使用先前生成的连接密钥。
 	以上介绍的过程被称为 <emphasis>结对(pairing)</emphasis>。
 	注意如果任何一方丢失了连接密钥，必须重新进行结对。</para>
 
       <para>守护进程 &man.hcsecd.8; 负责处理所有蓝牙验证请求。
 	默认的配置文件是 <filename>/etc/bluetooth/hcsecd.conf</filename>。
 	下面的例子显示一个手机的 PIN 码被预设为<quote>1234</quote>：</para>
 
       <programlisting>device {
         bdaddr  00:80:37:29:19:a4;
         name    "Pav's T39";
         key     nokey;
         pin     "1234";
       }</programlisting>
 
       <para>PIN 码没有限制(除了长度)。有些设备
 	(例如蓝牙耳机) 会有一个预置的 PIN 码。<option>-d</option>
 	开关强制 &man.hcsecd.8; 守护进程处于前台，因此很容易看清发生了什么。
 	设置远端设备准备接收结对 (pairing)，然后启动蓝牙连接到远端设备。
 	远端设备应该回应接收了结对并请求PIN码。输入与
 	<filename>hcsecd.conf</filename> 中一样的 PIN 码。
 	现在您的个人计算机已经与远程设备结对了。
 	另外您也可以在远程设备上初始结点。</para>
 
       <para>可以通过在
 	<filename>/etc/rc.conf</filename> 文件中增加下面的行， 以便让
 	<application>hcsecd</application> 在系统启动时自动运行：</para>
 
       <programlisting>hcsecd_enable="YES"</programlisting>
 
       <para>以下是简单的
 	<application>hcsecd</application> 服务输出样本：</para>
 
 <programlisting>hcsecd[16484]: Got Link_Key_Request event from 'ubt0hci', remote bdaddr 0:80:37:29:19:a4
 hcsecd[16484]: Found matching entry, remote bdaddr 0:80:37:29:19:a4, name 'Pav's T39', link key doesn't exist
 hcsecd[16484]: Sending Link_Key_Negative_Reply to 'ubt0hci' for remote bdaddr 0:80:37:29:19:a4
 hcsecd[16484]: Got PIN_Code_Request event from 'ubt0hci', remote bdaddr 0:80:37:29:19:a4
 hcsecd[16484]: Found matching entry, remote bdaddr 0:80:37:29:19:a4, name 'Pav's T39', PIN code exists
 hcsecd[16484]: Sending PIN_Code_Reply to 'ubt0hci' for remote bdaddr 0:80:37:29:19:a4</programlisting>
 
     </sect2>
 
     <sect2>
       <title>服务发现协议 (SDP)</title>
 
       <indexterm><primary>SDP</primary></indexterm>
 
       <para>服务发现协议 (SDP) 提供给客户端软件一种方法，
 	它能发现由服务器软件提供的服务及属性。
 	服务的属性包括所提供服务的类型或类别，
 	使用该服务所需要的机制或协议。</para>
 
       <para>SDP 包括 SDP 服务器和 SDP 客户端之间的通信。
 	服务器维护一张服务记录列表，它介绍服务器上服务的特性。
 	每个服务记录包含关于单个服务的信息。通过发出 SDP 请求，
 	客户端会得到服务记录列表的信息。如果客户端 (或者客户端上的应用软件)
 	决定使用一个服务，为了使用这个服务它必须与服务提供都建立一个独立的连接。
 	SDP 提供了发现服务及其属性的机制，但它并不提供使用这些服务的机制。</para>
 
       <para>一般地，SDP客户端按照服务的某种期望特征来搜索服务。
 	但是，即使没有任何关于由 SDP 服务端提供的服务的预设信息，
 	有时也能令人满意地发现它的服务记录里所描述的是哪种服务类型。
 	这种发现所提供服务的过程称为 <emphasis>浏览(browsing)</emphasis>。</para>
 
       <para>蓝牙 SDP 服务端 &man.sdpd.8; 和命令行客户端
 	&man.sdpcontrol.8; 都包括在了标准的 &os; 安装里。
 	下面的例子展示如何进行 SDP 浏览查询。</para>
 
       <screen>&prompt.user; <userinput>sdpcontrol -a 00:01:03:fc:6e:ec browse</userinput>
 Record Handle: 00000000
 Service Class ID List:
         Service Discovery Server (0x1000)
 Protocol Descriptor List:
         L2CAP (0x0100)
                 Protocol specific parameter #1: u/int/uuid16 1
                 Protocol specific parameter #2: u/int/uuid16 1
 
 Record Handle: 0x00000001
 Service Class ID List:
         Browse Group Descriptor (0x1001)
 
 Record Handle: 0x00000002
 Service Class ID List:
         LAN Access Using PPP (0x1102)
 Protocol Descriptor List:
         L2CAP (0x0100)
         RFCOMM (0x0003)
                 Protocol specific parameter #1: u/int8/bool 1
 Bluetooth Profile Descriptor List:
         LAN Access Using PPP (0x1102) ver. 1.0
 </screen>
 
       <para>...等等。注意每个服务有一个属性
 	(比如 RFCOMM 通道)列表。
 	根据服务您可能需要为一些属性做个注释。
 	有些<quote>蓝牙实现 (Bluetooth implementation)</quote>不支持服务浏览，
 	可能会返回一个空列表。这种情况，可以搜索指定的服务。
 	下面的例子展示如何搜索 OBEX Object Push (OPUSH) 服务：</para>
 
       <screen>&prompt.user; <userinput>sdpcontrol -a 00:01:03:fc:6e:ec search OPUSH</userinput></screen>
 
       <para>要在 &os; 里为蓝牙客户端提供服务，可以使用 &man.sdpd.8; 服务。
 	您可以通过在
 	<filename>/etc/rc.conf</filename> 中加入下面的行：</para>
 
       <programlisting>sdpd_enable="YES"</programlisting>
 
       <para>然后用下面的命令来启动 <application>sdpd</application> 服务：</para>
 
       <screen>&prompt.root; <userinput>/etc/rc.d/sdpd start</userinput></screen>
 
       <para>需要为远端提供蓝牙服务的本地的服务程序会使用本地 SDP
 	进程注册服务。像这样的程序就有 &man.rfcomm.pppd.8;。
 	一旦启动它，就会使用本地 SDP 进程注册蓝牙 LAN 服务。</para>
 
       <para>使用本地 SDP 进程注册的服务列表，可以通过本地控制通道发出
 	SDP 浏览查询获得：</para>
 
       <screen>&prompt.root; <userinput>sdpcontrol -l browse</userinput></screen>
 
     </sect2>
 
     <sect2>
       <title>拨号网络 (DUN) 和使用 PPP(LAN) 层面的网络接入</title>
 
       <para>拨号网络 (DUN) 配置通常与 modem 和手机一起使用。
 	如下是这一配置所涉及的内容：</para>
 
       <itemizedlist>
         <listitem><para>计算机使用手机或 modem 作为无线
 	  modem 来连接拨号因特网连入服务器，
 	  或者使用其它的拨号服务；</para></listitem>
 
         <listitem><para>计算机使用手机或 modem 接收数据请求。</para></listitem></itemizedlist>
 
       <para>使用 PPP(LAN) 层面的网络接入常使用在如下情形：</para>
 
       <itemizedlist><listitem><para>单个蓝牙设备的局域网连入；
            </para></listitem>
 
         <listitem><para>多个蓝牙设备的局域网接入；
           </para></listitem>
 
         <listitem><para>PC 到 PC (使用基于串行线模拟的 PPP 网络)。</para></listitem></itemizedlist>
 
       <para>在 &os; 中，两个层面使用 &man.ppp.8; 和
 	&man.rfcomm.pppd.8; (一种封装器，可以将 RFCOMM
 	蓝牙连接转换为 PPP 可操作的东西) 来实现。
 	在使用任何层面之前，一个新的 PPP 标识必须在
 	<filename>/etc/ppp/ppp.conf</filename> 中建立。
 	想要实例请参考 &man.rfcomm.pppd.8;。</para>
 
       <para>在下面的例子中，&man.rfcomm.pppd.8; 用来在
 	NUN RFCOMM 通道上打开一个到 BD_ADDR 为 00:80:37:29:19:a4
 	的设备的 RFCOMM 连接。具体的 RFCOMM 通道号要通过 SDP
 	从远端设备获得。也可以手动指定通 RFCOMM，这种情况下
 	&man.rfcomm.pppd.8; 将不能执行 SDP 查询。使用
 	&man.sdpcontrol.8; 来查找远端设备上的 RFCOMM 通道。</para>
 
       <screen>&prompt.root; <userinput>rfcomm_pppd -a 00:80:37:29:19:a4 -c -C dun -l rfcomm-dialup</userinput></screen>
 
       <para>为了提供 PPP(LAN) 网络接入服务，必须运行
 	&man.sdpd.8; 服务。一个新的 LAN 客户端条目必须在
 	<filename>/etc/ppp/ppp.conf</filename> 文件中建立。
 	想要实例请参考 &man.rfcomm.pppd.8;。
 	最后，在有效地通道号上开始 RFCOMM PPP 服务。
 	RFCOMM PPP 服务会使用本地 SDP 进程自动注册蓝牙 LAN
 	服务。下面的例子展示如何启动 RFCOMM PPP 服务。</para>
 
       <screen>&prompt.root; <userinput>rfcomm_pppd -s -C 7 -l rfcomm-server</userinput></screen>
 
     </sect2>
 
     <sect2>
       <title>OBEX 对象推送 (OBEX Object Push - OPUSH) 层面</title>
 
       <indexterm><primary>OBEX</primary></indexterm>
 
       <para>OBEX协议被广泛地用于移动设备之间简单的文件传输。
 	它的主要用处是在红外线通信领域，
 	被用于笔记本或手持设备之间的一般文件传输。</para>
 
       <para>OBEX 服务器和客户端由第三方软件包
 	<application>obexapp</application>实现，它可以从
 	<package>comms/obexapp</package>
 	port 安装。</para>
 
       <para>OBEX 客户端用于向 OBEX 服务器推入或接出对象。
 	一个对像可以是(举个例子)商业卡片或约会。 OBEX 客户能通过
 	SDP 从远程设备取得 RFCOMM 通道号。这可以通过指定服务名代替
 	RFCOMM 通道号来完成。支持的服务名是有：IrMC、FTRN 和 OPUSH。
 	也可以用数字来指定 RFCOMM 通道号。下面是一个 OBEX
 	会话的例子，一个设备信息对像从手机中被拉出，
 	一个新的对像被推入手机的目录。</para>
 
       <screen>&prompt.user; <userinput>obexapp -a 00:80:37:29:19:a4 -C IrMC</userinput>
 obex&gt; get telecom/devinfo.txt devinfo-t39.txt
 Success, response: OK, Success (0x20)
 obex&gt; put new.vcf
 Success, response: OK, Success (0x20)
 obex&gt; di
 Success, response: OK, Success (0x20)</screen>
 
       <para>为了提供 OBEX 推入服务，&man.sdpd.8;
 	必须处于运行状态。必须创建一个根目录用于存放所有进入的对象。
 	根文件夹的默认路径是 <filename>/var/spool/obex</filename>。
 	最后，在有效的 RFCOMM 通道号上开始 OBEX 服务。OBEX 服务会使用
 	SDP 进程自动注册 OBEX 对象推送 (OBEX Object Push) 服务。
 	下面的例子展示如何启动 OBEX 服务。</para>
 
       <screen>&prompt.root; <userinput>obexapp -s -C 10</userinput></screen>
     </sect2>
 
     <sect2>
       <title>串口(SP)层面</title>
       <para>串口(SP)层面允许蓝牙设备完成 RS232 (或类似) 串口线的仿真。
 	这个层面所涉及到情形是，
 	通过虚拟串口使用蓝牙代替线缆来处理以前的程序。</para>
 
       <para>工具 &man.rfcomm.sppd.1; 来实现串口层。
 	<quote>Pseudo tty</quote> 用来作为虚拟的串口。
 	下面的例子展示如何连接远程设备的串口服务。
 	注意您不必指定 RFCOMM 通道――&man.rfcomm.sppd.1;
 	能够通过 SDP 从远端设备那里获得。
 	如果您想代替它的话，可以在命令行里指定 RFCOMM
 	通道来实现：</para>
 
       <screen>&prompt.root; <userinput>rfcomm_sppd -a 00:07:E0:00:0B:CA -t /dev/ttyp6</userinput>
 rfcomm_sppd[94692]: Starting on /dev/ttyp6...</screen>
 
       <para>一旦连接上，<quote>pseudo tty</quote>就可以充当串口了：</para>
 
       <screen>&prompt.root; <userinput>cu -l ttyp6</userinput></screen>
 
     </sect2>
 
     <sect2>
       <title>问题解答</title>
 
       <sect3>
         <title>不能连接远端设备</title>
         <para>一些较老的蓝牙设备并不支持角色转换
 	  (role switching)。默认情况下，&os; 接受一个新的连接时，
 	  它会尝试进行角色转换并成为主控端 (master)。
 	  不支持角色转换的设备将无法连接。
 	  注意角色转换是在新连接建立时运行的，
 	  因此如果远程设备不支持角色转换，就不可能向它发出请求。
 	  一个 HCI 选项用来在本地端禁用角色转换。</para>
 
         <screen>&prompt.root; <userinput>hccontrol -n ubt0hci write_node_role_switch 0</userinput></screen>
 
       </sect3>
 
       <sect3>
         <title>如果有错， 能否知道到底正在发生什么？</title>
         <para>可以。 需要借助第三方软件包
           <application>hcidump</application>， 它可以通过
 	  <package>comms/hcidump</package> port
 	  来安装。 <application>hcidump</application> 工具和
           &man.tcpdump.1; 非常相像。 它可以用来显示蓝牙数据包的内容，
           并将其记录到文件中。</para>
       </sect3>
 
     </sect2>
 
   </sect1>
 
 
   <sect1 xml:id="network-bridging">
     <info><title>桥接</title>
       <authorgroup>
         <author><personname><firstname>Andrew</firstname><surname>Thompson</surname></personname><contrib>原作 </contrib></author>
       </authorgroup>
     </info>
     
 
     <sect2>
       <title>简介</title>
 	<indexterm>
 	  <primary>IP 子网</primary>
 	</indexterm>
 	<indexterm>
 	  <primary>桥接</primary>
 	</indexterm>
       <para>有时， 会有需要将一个物理网络分成两个独立的网段，
 	而不是创建新的 IP 子网， 并将其通过路由器相连。
 	以这种方式连接两个网络的设备称为 <quote>网桥 (bridge)</quote>。
 	有两个网络接口的 FreeBSD 系统可以作为网桥来使用。</para>
 
       <para>网桥通过学习每个网络接口上的 MAC 层地址 (以太网地址) 工作。
 	只当数据包的源地址和目标地址处于不同的网络时， 网桥才进行转发。</para>
 
       <para>在很多方面，网桥就像一个带有很少端口的以太网交换机。</para>
     </sect2>
 
     <sect2>
       <title>适合桥接的情况</title>
 
       <para>适合使用网桥的， 有许多种不同的情况。</para>
 
       <sect3>
 	<title>使多个网络相互联通</title>
 
 	<para>网桥的基本操作是将两个或多个网段连接在一起。
 	  由于各式各样的原因， 人们会希望使用一台真正的计算机，
 	  而不是网络设备来充任网桥的角色， 常见的原因包括线缆的限制、
 	  需要进行防火墙， 或为虚拟机网络接口连接虚拟网络。
 	  网桥也可以将无线网卡以 hostap 模式接入有线网络。</para>
       </sect3>
 
       <sect3>
 	<title>过滤/数据整形防火墙</title>
 	<indexterm><primary>防火墙</primary></indexterm>
 	<indexterm><primary>NAT</primary></indexterm>
 
 	<para>使用防火墙的常见情形是无需进行路由或网络地址转换的情况 (NAT)。</para>
 
 	<para>举例来说， 一家通过 DSL 或 ISDN 连接到 ISP 的小公司，
 	  拥有 13 个 ISP 分配的全局 IP 地址和 10 台 PC。
 	  在这种情况下， 由于划分子网的问题，
 	  采用路由来实现防火墙会比较困难。</para>
 
 	<indexterm>
 	  <primary>路由器</primary>
 	</indexterm>
 	<indexterm>
 	  <primary>DSL</primary>
 	</indexterm>
 	<indexterm>
 	  <primary>ISDN</primary>
 	</indexterm>
 	<para>基于网桥的防火墙可以串接在 DSL/ISDN
 	  路由器的后面， 而无需考虑 IP 编制的问题。</para>
       </sect3>
 
       <sect3>
 	<title>网络监视</title>
 
 	<para>网桥可以用于连接两个不同的网段， 并用于监视往返的以太网帧。
 	  这可以通过在网桥接口上使用 &man.bpf.4;/&man.tcpdump.1;，
 	  或通过将全部以太网帧复制到另一个网络接口 (span 口) 来实现。</para>
       </sect3>
 
       <sect3>
 	<title>2层 VPN</title>
 
 	<para>通过 IP 连接的网桥， 可以利用 EtherIP 隧道或基于 &man.tap.4;
 	  的解决方案， 如 OpenVPN 可以将两个以太网连接到一起。</para>
       </sect3>
 
       <sect3>
 	<title>2层 冗余</title>
 
 	<para>网络可以通过多条链路连接在一起， 并使用生成树协议 (Spanning Tree Protocol)
 	  来阻止多余的通路。 为使以太网能够正确工作， 两个设备之间应该只有一条激活通路，
 	  而生成树能够检测环路， 并将多余的链路置为阻断状态。 当激活通路断开时，
 	  协议能够计算另外一棵树， 并重新激活阻断的通路，
 	  以恢复到网络各点的连通性。</para>
       </sect3>
     </sect2>
 
     <sect2>
       <title>内核配置</title>
 
       <para>这一节主要介绍 &man.if.bridge.4; 网桥实现。
 	除此之外， 还有一个基于 netgraph 的网桥实现， 如欲了解进一步细节，
 	请参见联机手册 &man.ng.bridge.4;。</para>
 
       <para>网桥驱动是一个内核模块， 并会随使用 &man.ifconfig.8;
 	创建网桥接口时自动加载。 您也可以将 <literal>device if_bridge</literal>
 	加入到内核配置文件中， 以便将其静态联编进内核。</para>
 
       <para>包过滤可以通过使用了 &man.pfil.9; 框架的任意一种防火墙软件包来完成。
 	这些防火墙可以以模块形式加载， 也可以静态联编进内核。</para>
 
       <para>通过配合
 	&man.altq.4; 和 &man.dummynet.4;， 网桥也可以用于流量控制。</para>
     </sect2>
 
     <sect2>
       <title>启用网桥</title>
 
       <para>网桥是通过接口复制来创建的。
 	您可以使用 &man.ifconfig.8; 来创建网桥接口， 如果内核不包括网桥驱动，
 	则它会自动将其载入。</para>
 
       <screen>&prompt.root; <userinput>ifconfig bridge create</userinput>
 bridge0
 &prompt.root; <userinput>ifconfig bridge0</userinput>
 bridge0: flags=8802&lt;BROADCAST,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
         ether 96:3d:4b:f1:79:7a
         id 00:00:00:00:00:00 priority 32768 hellotime 2 fwddelay 15
         maxage 20 holdcnt 6 proto rstp maxaddr 100 timeout 1200
         root id 00:00:00:00:00:00 priority 0 ifcost 0 port 0</screen>
 
       <para>如此就建立了一个网桥接口， 并为其随机分配了以太网地址。
 	<literal>maxaddr</literal> 和 <literal>timeout</literal>
 	参数能够控制网桥在转发表中保存多少个 MAC 地址，
 	以及表项中主机的过期时间。 其他参数控制生成树的运转方式。</para>
 
       <para>将成员网络接口加入网桥。 为了让网桥能够为所有网桥成员接口转发包，
 	网桥接口和所有成员接口都需要处于启用状态：</para>
 
       <screen>&prompt.root; <userinput>ifconfig bridge0 addm fxp0 addm fxp1 up</userinput>
 &prompt.root; <userinput>ifconfig fxp0 up</userinput>
 &prompt.root; <userinput>ifconfig fxp1 up</userinput></screen>
 
       <para>网桥现在会在
 	<filename>fxp0</filename> 和
 	<filename>fxp1</filename> 之间转发以太网帧。
 	等效的 <filename>/etc/rc.conf</filename> 配置如下，
 	如此配置将在系统启动时创建同样的网桥。</para>
 
       <programlisting>cloned_interfaces="bridge0"
 ifconfig_bridge0="addm fxp0 addm fxp1 up"
 ifconfig_fxp0="up"
 ifconfig_fxp1="up"</programlisting>
 
       <para>如果网桥主机需要 IP 地址， 则应将其绑在网桥设备本身，
 	而不是某个成员设备上。 这可以通过静态设置或 DHCP 来完成：</para>
 
       <screen>&prompt.root; <userinput>ifconfig bridge0 inet 192.168.0.1/24</userinput></screen>
 
       <para>除此之外， 也可以为网桥接口指定 IPv6 地址。</para>
     </sect2>
 
     <sect2>
       <title>防火墙</title>
       <indexterm><primary>firewall (防火墙)</primary></indexterm>
 
       <para>当启用包过滤时， 通过网桥的包可以分别在进入的网络接口、
 	网桥接口和发出的网络接口上进行过滤。 这些阶段均可禁用。
 	当包的流向很重要时， 最好在成员接口而非网桥接口上配置防火墙。</para>
 
       <para>网桥上可以进行许多配置以决定非 IP 及 ARP 包能否通过，
 	以及通过 IPFW 实现二层防火墙。 请参见
 	&man.if.bridge.4; 联机手册以了解进一步的细节。</para>
     </sect2>
 
     <sect2>
       <title>生成树</title>
 
       <para>网桥驱动实现了快速生成树协议 (RSTP 或 802.1w)，
 	并与较早的生成树协议 (STP) 兼容。
 	生成树可以用来在网络拓扑中检测并消除环路。 RSTP
 	提供了比传统 STP 更快的生成树覆盖速度，
 	这种协议会在相邻的交换机之间交换信息，
 	以迅速进入转发状态， 并避免产生环路。
 	&os; 支持以 RSTP 和 STP 模式运行， 而 RSTP
 	是默认模式。</para>
 
       <para>使用 <literal>stp</literal> 命令可以在成员接口上启用生成树。 对包含
 	<filename>fxp0</filename> 和
 	<filename>fxp1</filename> 的网桥，
 	可以用下列命令启用 STP：</para>
 
       <screen>&prompt.root; <userinput>ifconfig bridge0 stp fxp0 stp fxp1</userinput>
 bridge0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
         ether d6:cf:d5:a0:94:6d
         id 00:01:02:4b:d4:50 priority 32768 hellotime 2 fwddelay 15
         maxage 20 holdcnt 6 proto rstp maxaddr 100 timeout 1200
         root id 00:01:02:4b:d4:50 priority 32768 ifcost 0 port 0
         member: fxp0 flags=1c7&lt;LEARNING,DISCOVER,STP,AUTOEDGE,PTP,AUTOPTP&gt;
                 port 3 priority 128 path cost 200000 proto rstp
                 role designated state forwarding
         member: fxp1 flags=1c7&lt;LEARNING,DISCOVER,STP,AUTOEDGE,PTP,AUTOPTP&gt;
                 port 4 priority 128 path cost 200000 proto rstp
                 role designated state forwarding</screen>
 
       <para>网桥的生成树 ID 为
 	<literal>00:01:02:4b:d4:50</literal> 而优先级为
 	<literal>32768</literal>。 其中 <literal>root id</literal>
 	与生成树相同， 表示这是作为生成树根的网桥。</para>
 
       <para>另一个网桥也启用了生成树：</para>
 
       <screen>bridge0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
         ether 96:3d:4b:f1:79:7a
         id 00:13:d4:9a:06:7a priority 32768 hellotime 2 fwddelay 15
         maxage 20 holdcnt 6 proto rstp maxaddr 100 timeout 1200
         root id 00:01:02:4b:d4:50 priority 32768 ifcost 400000 port 4
         member: fxp0 flags=1c7&lt;LEARNING,DISCOVER,STP,AUTOEDGE,PTP,AUTOPTP&gt;
                 port 4 priority 128 path cost 200000 proto rstp
                 role root state forwarding
         member: fxp1 flags=1c7&lt;LEARNING,DISCOVER,STP,AUTOEDGE,PTP,AUTOPTP&gt;
                 port 5 priority 128 path cost 200000 proto rstp
                 role designated state forwarding</screen>
 
       <para>这里的 <literal>root id 00:01:02:4b:d4:50 priority 32768
 	ifcost 400000 port 4</literal> 表示根网桥是前面的
 	<literal>00:01:02:4b:d4:50</literal>，
 	而从此网桥出发的通路代价为 <literal>400000</literal>,
 	此通路到根网桥是通过 <literal>port 4</literal> 即
 	<filename>fxp0</filename> 连接的。</para>
     </sect2>
 
     <sect2>
       <title>网桥的高级用法</title>
 
       <sect3>
 	<title>重建流量流</title>
 
 	<para>网桥支持监视模式， 在 &man.bpf.4; 处理之后会将包丢弃，
 	  而不是继续处理或转发。 这可以用于将两个或多个接口上的输入转化为一个
 	  &man.bpf.4; 流。 在将两个独立的接口上的传输的 RX/TX 信号重整为一个时，
 	  这会非常有用。</para>
 
 	<para>如果希望将四个网络接口上的输入转成一个流：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig bridge0 addm fxp0 addm fxp1 addm fxp2 addm fxp3 monitor up</userinput>
 &prompt.root; <userinput>tcpdump -i bridge0</userinput></screen>
       </sect3>
 
       <sect3>
 	<title>镜像口 (Span port)</title>
 
 	<para>网桥收到的每个以太网帧都可以发到镜像口上。
 	  网桥上的镜像口数量没有限制， 如果一个接口已经被配置为镜像口，
 	  则它就不能再作为网桥的成员口来使用。
 	  这种用法主要是为与网桥镜像口相连的监听机配合使用。</para>
 
 	<para>如果希望将所有帧发到名为
 	  <filename>fxp4</filename> 的接口上：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig bridge0 span fxp4</userinput></screen>
       </sect3>
 
       <sect3>
 	<title>专用接口 (Private interface)</title>
 
 	<para>专用接口不会转发流量到除专用接口之外的其他端口。
 	  这些流量会无条件地阻断， 因此包括 ARP 在内的以太网帧均不会被转发。
 	  如果需要选择性地阻断流量， 则应使用防火墙。</para>
       </sect3>
 
       <sect3>
 	<title>自学习接口 (Sticky Interfaces)</title>
 
 	<para>如果网桥的成员接口标记为自学习， 则动态学习的地址项一旦进入转发快取缓存，
 	  即被认为是静态项。 自学习项不会从快取缓存中过期或替换掉，
 	  即使地址在另一接口上出现也是如此。 这使得不必事先发布转发表，
 	  也能根据学习结果得到静态项的有点， 但在这些网段被网桥看到的客户机，
 	  就不能漫游至另一网段了。</para>
 
 	<para>另一种用法是将网桥与 VLAN 功能连用，
 	  这样客户网络会被隔离在一边， 而不会浪费 IP 地址空间。 考虑 <systemitem class="fqdomainname">CustomerA</systemitem> 在
 	  <literal>vlan100</literal> 上， 而 <systemitem class="fqdomainname">CustomerB</systemitem> 则在
 	  <literal>vlan101</literal> 上。 网桥地址为
 	  <systemitem class="ipaddress">192.168.0.1</systemitem>， 同时作为
 	  internet 路由器使用。</para>
 
 	<screen>&prompt.root; <userinput>ifconfig bridge0 addm vlan100 sticky vlan100 addm vlan101 sticky vlan101</userinput>
 &prompt.root; <userinput>ifconfig bridge0 inet 192.168.0.1/24</userinput></screen>
 
 	<para>两台客户机均将 <systemitem class="ipaddress">192.168.0.1</systemitem> 作为默认网关，
 	  由于网桥快取缓存是自学习的， 因而它们无法伪造
 	  MAC 地址来截取其他客户机的网络流量。</para>
 
 	<para>在 VLAN 之间的通讯可以通过专用接口 (或防火墙) 来阻断：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig bridge0 private vlan100 private vlan101</userinput></screen>
 
 	<para>这样这些客户机就完全相互隔离了。
 	  可以使用整个的 <systemitem class="netmask">/24</systemitem> 地址空间，
 	  而无需划分子网。</para>
       </sect3>
 
       <sect3>
 	<title>地址限制</title>
 
 	<para>接口后的源 MAC 地址数量是可以控制的。
 	  一旦到达了限制未知源地址的包将会被丢弃，
 	  直至现有缓存中的一项过期或被移除。</para>
 
 	<para>下面的例子是设置 <systemitem class="fqdomainname">CustomerA</systemitem>
 	  在 <literal>vlan100</literal> 上可连接的以太网设备最大值为
 	  10。</para>
 
 	<screen>&prompt.root; <userinput>ifconfig bridge0 ifmaxaddr vlan100 10</userinput></screen>
       </sect3>
 
       <sect3>
 	<title>SNMP 管理</title>
 
 	<para>网桥接口和 STP 参数能够由 &os; 基本系统的 SNMP
 	  守护进程进行管理。导出的网桥 MIB 符和 IETF 标准，
 	  所以任何 SNMP 客户端或管理包都可以被用来接收数据。</para>
 
 	<para>在网桥机器上从<filename>/etc/snmp.config</filename>
 	  文件中去掉以下这行的注释
 	  <literal>begemotSnmpdModulePath."bridge" =
 	  "/usr/lib/snmp_bridge.so"</literal>
 	  并启动 <application>bsnmpd</application> 守护进程。
 	  其他的配置选项诸如 community names 和 access lists
 	  可能也许也需要修改。 参阅 &man.bsnmpd.1; 和
 	  &man.snmp.bridge.3; 获取更多信息。</para>
 
 	<para>以下的例子中使用了
 	  <application>Net-SNMP</application> 软件
 	  (<package>net-mgmt/net-snmp</package>)
 	  来查询一个网桥，当然同样也能够使用port
 	  <package>net-mgmt/bsnmptools</package>。
 	  在 SNMP 客户端 <application>Net-SNMP</application>
 	  的配置文件 <filename>$HOME/.snmp/snmp.conf</filename> 中
 	  加入以下几行来导入网桥的 MIB 定义：</para>
 
 	<programlisting>mibdirs +/usr/share/snmp/mibs
 mibs +BRIDGE-MIB:RSTP-MIB:BEGEMOT-MIB:BEGEMOT-BRIDGE-MIB</programlisting>
 
 	<para>通过 IETF BRIDGE-MIB(RFC4188) 监测一个单独的网桥</para>
 
 	<screen>&prompt.user; <userinput>snmpwalk -v 2c -c public bridge1.example.com mib-2.dot1dBridge</userinput>
 BRIDGE-MIB::dot1dBaseBridgeAddress.0 = STRING: 66:fb:9b:6e:5c:44
 BRIDGE-MIB::dot1dBaseNumPorts.0 = INTEGER: 1 ports
 BRIDGE-MIB::dot1dStpTimeSinceTopologyChange.0 = Timeticks: (189959) 0:31:39.59 centi-seconds
 BRIDGE-MIB::dot1dStpTopChanges.0 = Counter32: 2
 BRIDGE-MIB::dot1dStpDesignatedRoot.0 = Hex-STRING: 80 00 00 01 02 4B D4 50
 ...
 BRIDGE-MIB::dot1dStpPortState.3 = INTEGER: forwarding(5)
 BRIDGE-MIB::dot1dStpPortEnable.3 = INTEGER: enabled(1)
 BRIDGE-MIB::dot1dStpPortPathCost.3 = INTEGER: 200000
 BRIDGE-MIB::dot1dStpPortDesignatedRoot.3 = Hex-STRING: 80 00 00 01 02 4B D4 50
 BRIDGE-MIB::dot1dStpPortDesignatedCost.3 = INTEGER: 0
 BRIDGE-MIB::dot1dStpPortDesignatedBridge.3 = Hex-STRING: 80 00 00 01 02 4B D4 50
 BRIDGE-MIB::dot1dStpPortDesignatedPort.3 = Hex-STRING: 03 80
 BRIDGE-MIB::dot1dStpPortForwardTransitions.3 = Counter32: 1
 RSTP-MIB::dot1dStpVersion.0 = INTEGER: rstp(2)</screen>
 
 	<para><literal>dot1dStpTopChanges.0</literal>的值为2
 	  意味着 STP 网桥拓扑改变了2次，拓扑的改变表示1个或多个
 	  网络中的连接改变或失效并且有一个新树生成。
 	  <literal>dot1dStpTimeSinceTopologyChange.0</literal>
 	  的值则能够显示这是何时改变的。</para>
 
 	<para>监测多个网桥接口可以使用 private
 	  BEGEMOT-BRIDGE-MIB：</para>
 
 	<screen>&prompt.user; <userinput>snmpwalk -v 2c -c public bridge1.example.com</userinput>
 enterprises.fokus.begemot.begemotBridge
 BEGEMOT-BRIDGE-MIB::begemotBridgeBaseName."bridge0" = STRING: bridge0
 BEGEMOT-BRIDGE-MIB::begemotBridgeBaseName."bridge2" = STRING: bridge2
 BEGEMOT-BRIDGE-MIB::begemotBridgeBaseAddress."bridge0" = STRING: e:ce:3b:5a:9e:13
 BEGEMOT-BRIDGE-MIB::begemotBridgeBaseAddress."bridge2" = STRING: 12:5e:4d:74:d:fc
 BEGEMOT-BRIDGE-MIB::begemotBridgeBaseNumPorts."bridge0" = INTEGER: 1
 BEGEMOT-BRIDGE-MIB::begemotBridgeBaseNumPorts."bridge2" = INTEGER: 1
 ...
 BEGEMOT-BRIDGE-MIB::begemotBridgeStpTimeSinceTopologyChange."bridge0" = Timeticks: (116927) 0:19:29.27 centi-seconds
 BEGEMOT-BRIDGE-MIB::begemotBridgeStpTimeSinceTopologyChange."bridge2" = Timeticks: (82773) 0:13:47.73 centi-seconds
 BEGEMOT-BRIDGE-MIB::begemotBridgeStpTopChanges."bridge0" = Counter32: 1
 BEGEMOT-BRIDGE-MIB::begemotBridgeStpTopChanges."bridge2" = Counter32: 1
 BEGEMOT-BRIDGE-MIB::begemotBridgeStpDesignatedRoot."bridge0" = Hex-STRING: 80 00 00 40 95 30 5E 31
 BEGEMOT-BRIDGE-MIB::begemotBridgeStpDesignatedRoot."bridge2" = Hex-STRING: 80 00 00 50 8B B8 C6 A9</screen>
 
 	<para>通过 <literal>mib-2.dot1dBridge</literal>
 	  子树改变正在被监测的网桥接口：</para>
 
 	<screen>&prompt.user; <userinput>snmpset -v 2c -c private bridge1.example.com</userinput>
 BEGEMOT-BRIDGE-MIB::begemotBridgeDefaultBridgeIf.0 s bridge2</screen>
       </sect3>
     </sect2>
   </sect1>
 
   <sect1 xml:id="network-aggregation">
     <info><title>链路聚合与故障转移</title>
       <authorgroup>
         <author><personname><firstname>Andrew</firstname><surname>Thompson</surname></personname><contrib>Written by </contrib></author>
       </authorgroup>
     </info>
     
 
     <indexterm><primary>lagg</primary></indexterm>
     <indexterm><primary>failover (故障转移)</primary></indexterm>
     <indexterm><primary>fec</primary></indexterm>
     <indexterm><primary>lacp</primary></indexterm>
     <indexterm><primary>loadbalance (负载均衡)</primary></indexterm>
     <indexterm><primary>roundrobin (轮转)</primary></indexterm>
 
     <sect2>
       <title>介绍</title>
       <para>使用 &man.lagg.4; 接口， 能够将多个网络接口聚合为一个虚拟接口，
 	以提供容灾和高速连接的能力。</para>
     </sect2>
 
     <sect2>
       <title>运行模式</title>
 
       <variablelist>
 
 	<varlistentry><term>Failover (故障转移)</term>
 
 	<listitem>
 	<para>只通过主网口收发数据。 如果主网口不可用， 则使用下一个激活的网口。
 	  您在这里加入的第一个网口便会被视为主网口； 此后加入的其他网口，
 	  则会被视为故障转移的备用网口。 如果发生故障转移之后，
 	  原先的网口又恢复了可用状态， 则它仍会作为主网口使用。</para>
         </listitem>
         </varlistentry>
 
 	<varlistentry><term>&cisco; Fast &etherchannel;</term>
 
 	<listitem>
 	<para>&cisco; Fast &etherchannel; (FEC) 是一种静态配置，
 	  并不进行节点间协商或交换以太网帧来监控链路情况。
 	  如果交换机支持 LACP， 则应使用后者而非这种配置。</para>
 
 	<para><acronym>FEC</acronym> 将输出流量在激活的网口之间以协议头散列信息为依据分拆，
 	  并接收来自任意激活网口的入流量。 散列信息包含以太网源地址、
 	  目的地址， 以及 (如果有的话) VLAN tag 和 IPv4/IPv6 源地址及目的地址信息。</para>
         </listitem>
 	</varlistentry>
 
 	<varlistentry><term>LACP</term>
 
 	<listitem>
 	<para>支持 &ieee; 802.3ad 链路聚合控制协议
 	  (LACP) 和标记协议。 LACP 能够在节点与若干链路聚合组之间协商链路。
 	  每一个链路聚合组 (LAG) 由一组相同速度、 以全双工模式运行的网口组成。
 	  流量在 LAG 中的网口之间， 会以总速度最大的原则进行分摊。
 	  当物理链路发生变化时， 链路聚合会迅速适应变动形成新的配置。</para>
 
 	<para><acronym>LACP</acronym> 也是将输出流量在激活的网口之间以协议头散列信息为依据分拆，
 	  并接收来自任意激活网口的入流量。 散列信息包含以太网源地址、
 	  目的地址， 以及 (如果有的话) VLAN tag 和 IPv4/IPv6 源地址及目的地址信息。</para>
         </listitem>
 	</varlistentry>
 
 	<varlistentry><term>Loadbalance (负载均衡)</term>
 
 	<listitem>
 	<para>这是 <emphasis>FEC</emphasis> 模式的别名。</para>
         </listitem>
         </varlistentry>
 
 	<varlistentry><term>Round-robin (轮转)</term>
 
 	<listitem>
 	<para>将输出流量以轮转方式在所有激活端口之间调度， 并从任意激活端口接收进入流量。
 	  这种模式违反了以太网帧排序规则， 因此应小心使用。</para>
         </listitem>
 	</varlistentry>
       </variablelist>
     </sect2>
 
     <sect2>
       <title>例子</title>
 
       <example xml:id="networking-lacp-aggregation-cisco">
 	<title>与 &cisco; 交换机配合完成 LACP 链路聚合</title>
 
 	<para>在这个例子中， 我们将 &os; 的两个网口作为一个负载均衡和故障转移链路聚合组接到交换机上。
 	  在此基础上， 还可以增加更多的网口， 以提高吞吐量和故障容灾能力。
 	  由于以太网链路上两节点间的帧序是强制性的， 因此两个节点之间的连接速度，
 	  会取决于一块网卡的最大速度。 传输算法会尽量采用更多的信息，
 	  以便将不同的网络流量分摊到不同的网络接口上， 并平衡不同网口的负载。</para>
 
 	<para>在 &cisco; 交换机上将
 	  <replaceable>FastEthernet0/1</replaceable> 和
 	  <replaceable>FastEthernet0/2</replaceable> 这两个网口添加到
 	  channel-group <replaceable>1</replaceable>：</para>
 
 	<screen><userinput>interface FastEthernet0/1
  channel-group 1 mode active
  channel-protocol lacp</userinput>
 !
 <userinput>interface FastEthernet0/2
  channel-group 1 mode active
  channel-protocol lacp</userinput></screen>
 
 	<para>使用
 	  <replaceable>fxp0</replaceable> 和 <replaceable>fxp1</replaceable>
 	  创建 &man.lagg.4; 接口， 启用这个接口并配置 IP 地址
 	  <replaceable>10.0.0.3/24</replaceable>：</para>
 
         <screen>&prompt.root; <userinput>ifconfig fxp0 up</userinput>
 &prompt.root; <userinput>ifconfig fxp1 up</userinput>
 &prompt.root; <userinput>ifconfig lagg0 create </userinput>
 &prompt.root; <userinput>ifconfig lagg0 up laggproto lacp laggport fxp0 laggport fxp1 10.0.0.3/24</userinput></screen>
 
 	<para>用下面的命令查看接口状态：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig lagg0</userinput></screen>
 
 	<para>标记为
 	  <emphasis>ACTIVE</emphasis> 的接口是激活据合组的部分，
 	  这表示它们已经完成了与远程交换机的协商，
 	  同时， 流量将通过这些接口来收发。 在 &man.ifconfig.8;
 	  的详细输出中会给出 LAG 的标识。</para>
 
 	<screen>lagg0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
         options=8&lt;VLAN_MTU&gt;
         ether 00:05:5d:71:8d:b8
         media: Ethernet autoselect
         status: active
         laggproto lacp
         laggport: fxp1 flags=1c&lt;ACTIVE,COLLECTING,DISTRIBUTING&gt;
         laggport: fxp0 flags=1c&lt;ACTIVE,COLLECTING,DISTRIBUTING&gt;</screen>
 
 	<para>如果需要查看交换机上的端口状态， 则应使用 <userinput>show
 	  lacp neighbor</userinput> 命令：</para>
 
 	<screen>switch# show lacp neighbor
 Flags:  S - Device is requesting Slow LACPDUs
         F - Device is requesting Fast LACPDUs
         A - Device is in Active mode       P - Device is in Passive mode
 
 Channel group 1 neighbors
 
 Partner's information:
 
                   LACP port                        Oper    Port     Port
 Port      Flags   Priority  Dev ID         Age     Key     Number   State
 Fa0/1     SA      32768     0005.5d71.8db8  29s    0x146   0x3      0x3D
 Fa0/2     SA      32768     0005.5d71.8db8  29s    0x146   0x4      0x3D</screen>
 
 	<para>如欲查看进一步的详情， 则需要使用 <userinput>show lacp neighbor
 	  detail</userinput> 命令。</para>
 
 	<para>如果希望在系统重启时保持这些设置， 应在
 	  <filename>/etc/rc.conf</filename> 中增加如下配置：</para>
 
 	<programlisting>ifconfig_<replaceable>fxp0</replaceable>="up"
 ifconfig_<replaceable>fxp1</replaceable>="up"
 cloned_interfaces="<literal>lagg0</literal>"
 ifconfig_<literal>lagg0</literal>="laggproto lacp laggport <replaceable>fxp0</replaceable> laggport <replaceable>fxp1</replaceable> <replaceable>10.0.0.3/24</replaceable>"
 </programlisting>
       </example>
       <example xml:id="networking-lagg-failover">
 	<title>故障转移模式</title>
 
 	<para>故障转移模式中， 当首选链路发生问题时，
 	  会自动切换到备用端口。 首先启用成员接口，
 	  接着是配置 &man.lagg.4; 接口， 其中， 使用
 	  <replaceable>fxp0</replaceable> 作为首选接口，
 	  <replaceable>fxp1</replaceable> 作为备用接口，
 	  并在整个接口上配置 IP 地址 <replaceable>10.0.0.15/24</replaceable>：</para>
 
         <screen>&prompt.root; <userinput>ifconfig fxp0 up</userinput>
 &prompt.root; <userinput>ifconfig fxp1 up</userinput>
 &prompt.root; <userinput>ifconfig lagg0 create</userinput>
 &prompt.root; <userinput>ifconfig lagg0 up laggproto failover laggport fxp0 laggport fxp1 10.0.0.15/24</userinput></screen>
 
 	<para>创建成功之后， 接口状态会是类似下面这样，
 	  主要的区别是 <acronym>MAC</acronym> 地址和设备名：</para>
 
         <screen>&prompt.root; <userinput>ifconfig lagg0</userinput>
 lagg0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
         options=8&lt;VLAN_MTU&gt;
         ether 00:05:5d:71:8d:b8
         inet 10.0.0.15 netmask 0xffffff00 broadcast 10.0.0.255
         media: Ethernet autoselect
         status: active
         laggproto failover
         laggport: fxp1 flags=0&lt;&gt;
         laggport: fxp0 flags=5&lt;MASTER,ACTIVE&gt;</screen>
 
 	<para>系统将在
 	  <replaceable>fxp0</replaceable> 上进行流量的收发。 如果
 	  <replaceable>fxp0</replaceable>  的连接中断， 则 <replaceable>fxp1</replaceable>
 	  会自动成为激活连接。 如果主端口的连接恢复， 则它又会成为激活连接。</para>
 
 	<para>如果希望在系统重启时保持这些设置， 应在
 	  <filename>/etc/rc.conf</filename> 中增加如下配置：</para>
 
 	<programlisting>ifconfig_<replaceable>fxp0</replaceable>="up"
 ifconfig_<replaceable>fxp1</replaceable>="up"
 cloned_interfaces="<literal>lagg0</literal>"
 ifconfig_<literal>lagg0</literal>="laggproto failover laggport <replaceable>fxp0</replaceable> laggport <replaceable>fxp1</replaceable> <replaceable>10.0.0.15/24</replaceable>"
 </programlisting>
       </example>
       <example xml:id="networking-lagg-wired-and-wireless">
 	<title>有线网络和无线网络接口间的自动切换</title>
 
 	<para>对于使用笔记本的用户来说， 通常会希望使用无线网络接口作为备用接口，
 	  以便在有线网络不可用时继续保持网络连接。 通过使用 &man.lagg.4;， 我们可以只使用一个
 	  IP 地址的情况下， 优先使用性能和安全性都更好的有线网络，
 	  同时保持通过无线网络连接来传输数据的能力。</para>
 
 	<para>要实现这样的目的， 就需要将用于连接无线网络的物理接口的
 	  <acronym>MAC</acronym> 地址修改为与所配置的 &man.lagg.4; 一致，
 	  后者是从主网络接口， 也就是有线网络接口， 继承而来。</para>
 
 	<para>在这个配置中， 我们将优先使用有线网络接口
 	  <replaceable>bge0</replaceable> 作为主网络接口，
 	  而将无线网络接口
 	  <replaceable>wlan0</replaceable> 作为备用网络接口。 这里的
 	  <replaceable>wlan0</replaceable> 使用的物理设备是
 	  <replaceable>iwn0</replaceable>，
 	  我们需要将它的 <acronym>MAC</acronym> 地址修改为与有线网络接口一致。
 	  为了达到这个目的首先要得到有线网络接口上的
 	  <acronym>MAC</acronym> 地址：</para>
 
         <screen>&prompt.root; <userinput>ifconfig bge0</userinput>
 bge0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
 	options=19b&lt;RXCSUM,TXCSUM,VLAN_MTU,VLAN_HWTAGGING,VLAN_HWCSUM,TSO4&gt;
 	ether 00:21:70:da:ae:37
 	inet6 fe80::221:70ff:feda:ae37%bge0 prefixlen 64 scopeid 0x2
 	nd6 options=29&lt;PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL&gt;
 	media: Ethernet autoselect (1000baseT &lt;full-duplex&gt;)
 	status: active</screen>
 
 	<para>您可能需要将 <replaceable>bge0</replaceable> 改为您系统上实际使用的接口，
 	  并从输出结果中的 <literal>ether</literal>
 	  这行找出有线网络的 <acronym>MAC</acronym> 地址。 接着是修改物理的无线网络接口，
 	  <replaceable>iwn0</replaceable>：</para>
 
         <screen>&prompt.root; <userinput>ifconfig iwn0 ether 00:21:70:da:ae:37</userinput></screen>
 
 	<para>启用无线网络接口， 但不在其上配置 IP
 	  地址：</para>
 
         <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev iwn0 ssid my_router up</userinput></screen>
 
 	<para>启用 <replaceable>bge0</replaceable> 接口。 创建
 	  &man.lagg.4;  接口， 其中 <replaceable>bge0</replaceable>
 	  作为主网络接口， 而以 <replaceable>wlan0</replaceable> 作为备选接口：</para>
 
         <screen>&prompt.root; <userinput>ifconfig bge0 up</userinput>
 &prompt.root; <userinput>ifconfig lagg0 create</userinput>
 &prompt.root; <userinput>ifconfig lagg0 up laggproto failover laggport bge0 laggport wlan0</userinput></screen>
 
 	<para>新创建的接口的状态如下， 您系统上的 <acronym>MAC</acronym>
 	  地址和设备名等可能会有所不同：</para>
 
         <screen>&prompt.root; <userinput>ifconfig lagg0</userinput>
 lagg0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
         options=8&lt;VLAN_MTU&gt;
         ether 00:21:70:da:ae:37
         media: Ethernet autoselect
         status: active
         laggproto failover
         laggport: wlan0 flags=0&lt;&gt;
         laggport: bge0 flags=5&lt;MASTER,ACTIVE&gt;</screen>
 
 	<para>接着用 DHCP 客户端来获取 IP 地址：</para>
 
 	<screen>&prompt.root; <userinput>dhclient lagg0</userinput></screen>
 
 	<para>如果希望在系统重启时保持这些设置， 应在
 	  <filename>/etc/rc.conf</filename> 中增加如下配置：</para>
 
 	<programlisting>ifconfig_bge0="up"
 ifconfig_iwn0="ether 00:21:70:da:ae:37"
 wlans_iwn0="wlan0"
 ifconfig_wlan0="WPA"
 cloned_interfaces="<literal>lagg0</literal>"
 ifconfig_<literal>lagg0</literal>="laggproto failover laggport bge0 laggport wlan0 DHCP"
 </programlisting>
       </example>
     </sect2>
   </sect1>
 
   <sect1 xml:id="network-diskless">
     <info><title>无盘操作</title>
       <authorgroup>
 	<author><personname><firstname>Jean-Fran&ccedil;ois</firstname><surname>Dock&egrave;s</surname></personname><contrib>更新： </contrib></author>
       </authorgroup>
       <authorgroup>
 	<author><personname><firstname>Alex</firstname><surname>Dupre</surname></personname><contrib>重新组织及增强：</contrib></author>
       </authorgroup>
       <authorgroup>
 	<author><personname><firstname>张</firstname><surname>雪平</surname></personname><contrib>中文翻译：</contrib><affiliation>
 	    <address><email>zxpmyth@yahoo.com.cn</email></address>
 	  </affiliation></author>
 	<author><personname><firstname>袁</firstname><surname>苏义</surname></personname></author>
       </authorgroup>
     </info>
     
 
     <indexterm>
       <primary>无盘工作站</primary>
     </indexterm>
     <indexterm>
       <primary>无盘操作</primary>
     </indexterm>
 
     <para>FreeBSD 主机可以从网络启动而无需本地磁盘就可操作，
       使用的是从 <acronym>NFS</acronym> 服务器装载的文件系统。
       除了标准的配置文件，无需任何的系统修改。
       很容易设置这样的系统因为所有必要的元素都很容易得到：</para>
     <itemizedlist><listitem>
 	<para>至少有两种可能的方法从网络加载内核：</para>
 	<itemizedlist><listitem>
 	    <para><acronym>PXE</acronym>：&intel;
 	      的先启动执行环境 (Preboot eXecution Environment)
 	      系统是一种灵活的引导 ROM 模式，这个 ROM
 	      内建在一些网卡或主板的中。查看 &man.pxeboot.8;
 	      以获取更多细节。</para>
 	  </listitem> <listitem>
 	    <para><application>Etherboot</application> port (<package>net/etherboot</package>)
 	      产生通过网络加载内核的可 ROM 代码。这些代码可以烧入网卡上的
 	      PROM 上，或从本地软盘 (或硬盘) 驱动器加载，或从运行着的
 	      &ms-dos; 系统加载。它支持多种网卡。</para>
 	  </listitem></itemizedlist></listitem>
 
       <listitem>
 	<para>一个样板脚本
 	  (<filename>/usr/share/examples/diskless/clone_root</filename>)
 	  简化了对服务器上的工作站根文件系统的创建和维护。
 	  这个脚本需要少量的自定义，但您能很快的熟悉它。</para>
       </listitem>
 
       <listitem>
 	<para><filename>/etc</filename>
 	  存在标准的系统启动文件用于侦测和支持无盘的系统启动。</para>
       </listitem>
 
       <listitem>
 	<para>可以向 <acronym>NFS</acronym>
 	  文件或本地磁盘进行交换(如果需要的话)。</para>
       </listitem></itemizedlist>
 
     <para>设置无盘工作站有许多方法。
       有很多相关的元素大部分可以自定义以适合本地情况。
       以下将介绍一个完整系统的安装，强调的是简单性和与标准
       FreeBSD 启动脚本的兼容。介绍的系统有以下特性：</para>
 
     <itemizedlist>
       <listitem>
 	<para>无盘工作站使用一个共享的只读 <filename>/</filename>
 	  文件系统和一个共享的只读<filename>/usr</filename>。</para>
 	<para>root 文件系统是一份标准的 FreeBSD 根文件系统
 	  (一般是服务器的)，只是一些配置文件被特定于无盘操作的配置文件覆盖。</para>
 	<para>root 文件系统必须可写的部分被 &man.md.4; 文件系统覆盖。
 	  任何的改写在重启后都会丢失。</para>
       </listitem>
       <listitem>
 	<para>内核由 <application>etherboot</application> 或
 	  <acronym>PXE</acronym> 传送和加载，
 	  有些情况可能会指定使用其中之一。</para>
       </listitem>
     </itemizedlist>
 
     <caution><para>如上所述，这个系统是不安全的。
       它应该处于网络的受保护区域并不被其它主机信任。</para>
     </caution>
 
     <para>这部分所有的信息均在
       5.2.1-RELEASE 上测试过。</para>
 
     <sect2>
       <title>背景信息</title>
 
       <para>设置无盘工作站相对要简单而又易出错。
 	有时分析一些原因是很难的。例如：</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>编译时选项在运行时可能产生不同的行为。</para>
 	</listitem>
 
 	<listitem>
 	  <para>出错信息经常是加密了的或根本就没有。</para>
 	</listitem></itemizedlist>
 
       <para>在这里，
 	涉及到的一些背景知识对于可能出现的问题的解决是很有帮助的。</para>
 
       <para>要成功地引导系统还有些操作需要做。</para>
 
       <itemizedlist><listitem>
 	  <para>机子需要获取初始的参数，如它的 IP
 	    地址、执行文件、服务器名、根路径。这个可以使用
 	    <acronym/>或 BOOTP 协议来完成。
 	    <acronym>DHCP</acronym> 是 BOOTP 的兼容扩展，
 	    并使用相同的端口和基本包格式。</para>
 
 	  <para>只使用 BOOTP 来配置系统也是可行的。
 	    &man.bootpd.8; 服务程序被包含在基本的
 	    &os; 系统里。</para>
 
 	  <para>不过，<acronym>DHCP</acronym> 相比
 	    BOOTP 有几个好处 (更好的配置文件，使用 <acronym>PXE</acronym>
 	    的可能性，以及许多其它并不直接相关的无盘操作)，
 	    接着我们会要描述一个 <acronym>DHCP</acronym> 配置，
 	    可能的话会利用与使用 &man.bootpd.8;
 	    相同的例子。这个样板配置会使用<application>ISC DHCP</application>
 	    软件包 (3.0.1.r12 发行版安装在测试服务器上)。</para>
 	</listitem>
 
 	<listitem>
 	  <para>机子需要传送一个或多个程序到本地内存。
 	    <acronym>TFTP</acronym> 或 <acronym>NFS</acronym>
 	    会被使用。选择<acronym>TFTP</acronym> 还是 <acronym>NFS</acronym>
 	    需要在几个地方的<quote>编译时间</quote>选项里设置。
 	    通常的错误源是为文件名指定了错误的协议：<acronym>TFTP</acronym>
 	    通常从服务器里的一个单一目录传送所有文件，并需要相对这个目录的文件名。
 	    <acronym>NFS</acronym> 需要的是绝对文件路径。</para>
 	</listitem>
 
 	<listitem>
 	  <para>介于启动程序和内核之间的可能的部分需要被初始化并执行。
 	    在这部分有几个重要的变量：</para>
 
 	  <itemizedlist><listitem>
 	      <para><acronym>PXE</acronym> 会装入
 		&man.pxeboot.8;――它是 &os; 第三阶段装载器的修改版。
 		&man.loader.8; 会获得许多参数用于系统启动，
 		并在传送控制之前把它们留在内核环境里。
 		在这种情况下，使用 <filename>GENERIC</filename>
 		内核就可能了。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para><application>Etherboot</application>
 		会做很少的准备直接装载内核。
 		您要使用指定的选项建立 (build) 内核。</para>
 	    </listitem>
 	  </itemizedlist>
 
 	  <para><acronym>PXE</acronym> 和
 	    <application>Etherboot</application> 工作得一样的好。
 	    不过， 因为一般情况下内核希望 &man.loader.8;
 	    做了更多的事情， <acronym>PXE</acronym> 是推荐的方法。</para>
 
 	  <para>如果您的 <acronym>BIOS</acronym> 和网卡都支持
 	    <acronym>PXE</acronym>， 就应该使用它。</para>
 	</listitem>
 
 	<listitem>
 	  <para>最后，机子需要访问它的文件系统。
 	    <acronym>NFS</acronym> 使用在所有的情况下。</para>
 	</listitem></itemizedlist>
 
       <para>查看 &man.diskless.8; 手册页。</para>
     </sect2>
 
     <sect2>
       <title>安装说明</title>
 
       <sect3>
 	  <title>配置使用<application>ISC DHCP</application></title>
 	  <indexterm>
 	    <primary>DHCP</primary>
 	    <secondary>无盘操作</secondary>
 	  </indexterm>
 
 	  <para><application>ISC DHCP</application>
 	    服务器可以回应 BOOTP 和 <acronym>DHCP</acronym>
 	    的请求。</para>
 
 	  <para><application>ISC DHCP 4.2</application>
 	    并不属于基本系统。首先您需要安装
 	    <package>net/isc-dhcp42-server</package>
 	    port 或相应的<quote>包</quote>。</para>
 
 	  <para>一旦安装了 <application>ISC DHCP</application>，
 	    还需要一个配置文件才能运行 (通常名叫
 	    <filename>/usr/local/etc/dhcpd.conf</filename>)。
 	    这里有个注释过的例子，里边主机 <systemitem>margaux</systemitem>
 	    使用 <application>Etherboot</application>，
 	    而主机<systemitem>corbieres</systemitem> 使用 <acronym>PXE</acronym>：</para>
 
           <programlisting>
 default-lease-time 600;
 max-lease-time 7200;
 authoritative;
 
 option domain-name "example.com";
 option domain-name-servers 192.168.4.1;
 option routers 192.168.4.1;
 
 subnet 192.168.4.0 netmask 255.255.255.0 {
   use-host-decl-names on; <co xml:id="co-dhcp-host-name"/>
   option subnet-mask 255.255.255.0;
   option broadcast-address 192.168.4.255;
 
   host margaux {
     hardware ethernet 01:23:45:67:89:ab;
     fixed-address margaux.example.com;
     next-server 192.168.4.4; <co xml:id="co-dhcp-next-server"/>
     filename "/data/misc/kernel.diskless"; <co xml:id="co-dhcp-filename"/>
     option root-path "192.168.4.4:/data/misc/diskless"; <co xml:id="co-dhcp-root-path"/>
   }
   host corbieres {
     hardware ethernet 00:02:b3:27:62:df;
     fixed-address corbieres.example.com;
     next-server 192.168.4.4;
     filename "pxeboot";
     option root-path "192.168.4.4:/data/misc/diskless";
   }
 }
           </programlisting>
 
 	  <calloutlist>
 	    <callout arearefs="co-dhcp-host-name">
 	      <para>这个选项告诉 <application>dhcpd</application>
 		发送<literal>host</literal> 里声明的用于无盘主机的主机名的值。
 		另外可能会增加一个
 		<literal>option host-name margaux</literal>
 		到 <literal>host</literal> 声明里。</para>
 	    </callout>
 
 	    <callout arearefs="co-dhcp-next-server">
 	      <para><literal>next-server</literal> 正式指定
 		<acronym>TFTP</acronym> 或 <acronym>NFS</acronym>
 		服务用于载入装载器或内核文件
 		(默认使用的是相同的主机作为<acronym>DHCP</acronym>
 		服务器)。</para>
 	    </callout>
 
 	    <callout arearefs="co-dhcp-filename">
 	      <para><literal>filename</literal>
 		正式定义这样的文件――<application>etherboot</application>
 		或 <acronym>PXE</acronym> 为执行下一步将装载它。
 		根据使用的传输方式，它必须要指定。
 		<application>Etherboot</application> 可以被编译来使用
 		<acronym>NFS</acronym> 或 <acronym>TFTP</acronym>。
 		&os; port 默认配置了<acronym>NFS</acronym>。
 		<acronym>PXE</acronym> 使用 <acronym>TFTP</acronym>，
 		这就是为什么在这里使用相对文件名 (这可能依赖于
 		<acronym>TFTP</acronym> 服务器配置，不过会相当典型)。
 		同样，<acronym>PXE</acronym> 会装载 <filename>pxeboot</filename>，
 		而不是内核。另外有几个很有意思的可能，如从 &os; CD-ROM
 		的 <filename>/boot</filename> 目录装载
 		<filename>pxeboot</filename> (因为 &man.pxeboot.8; 能够装载
 		<filename>GENERIC</filename> 内核，这就使得可以使用
 		<acronym>PXE</acronym> 从远程的 CD-ROM 里启动)。</para>
 	    </callout>
 
 	    <callout arearefs="co-dhcp-root-path">
 	      <para><literal>root-path</literal> 选项定义到根
 		(root) 文件系统的路径，通常是 <acronym>NFS</acronym>
 		符号。当使用 <acronym>PXE</acronym> 时，只要您不启用内核里的
 		BOOTP 选项，可以不管主机的IP。<acronym>NFS</acronym>
 		服务器然后就如同 <acronym>TFTP</acronym> 一样。</para>
 	    </callout></calloutlist>
 
       </sect3>
       <sect3>
 	  <title>配置使用BOOTP</title>
 	  <indexterm>
 	    <primary>BOOTP</primary>
 	    <secondary>无盘操作</secondary>
 	  </indexterm>
 
 	  <para>这里紧跟的是一个等效的 <application>bootpd</application>
 	    配置 (减少到一个客户端)。这个可以在
 	    <filename>/etc/bootptab</filename> 里找到。</para>
 
 	  <para>请注意：为了使用BOOTP，<application>etherboot</application>
 	    必须使用非默认选项 <literal>NO_DHCP_SUPPORT</literal>
 	    来进行编译，而且 <acronym>PXE</acronym> <emphasis> 需要
 	    </emphasis> <acronym>DHCP</acronym>。<application>bootpd</application>
 	    的唯一可见的好处是它存在于基本系统中。</para>
 
           <programlisting>
 .def100:\
   :hn:ht=1:sa=192.168.4.4:vm=rfc1048:\
   :sm=255.255.255.0:\
   :ds=192.168.4.1:\
   :gw=192.168.4.1:\
   :hd="/tftpboot":\
   :bf="/kernel.diskless":\
   :rp="192.168.4.4:/data/misc/diskless":
 
 margaux:ha=0123456789ab:tc=.def100</programlisting>
       </sect3>
 
       <sect3>
 	<title>使用<application>Etherboot</application>准备启动程序</title>
 
 	<indexterm>
 	  <primary>Etherboot</primary>
 	</indexterm>
 
 	<para><link xlink:href="http://etherboot.sourceforge.net">Etherboot
 	  的网站</link> 包含有<link xlink:href="http://etherboot.sourceforge.net/doc/html/userman/t1.html">更多的文档
 	  </link>――主要瞄准的是 Linux 系统，但无疑包含有有用的信息。
 	  如下列出的是关于在 FreeBSD 系统里使用
 	  <application>Etherboot</application>。</para>
 
 	<para>首先您必须安装<package>net/etherboot</package> 包或 port。</para>
 
 	<para>您可以改变 <application>Etherboot</application> 的配置
 	  (如使用 <acronym>TFTP</acronym> 来代替 <acronym>NFS</acronym>)，
 	  方法是修改 <filename>Config</filename> 文件――在
 	  <application>Etherboot</application> 源目录里。</para>
 
 	<para>对于我们的设置，我们要使用一张启动软盘。
 	  对于其它的方法(PROM，或 &ms-dos;程序)，
 	  请参考 <application>Etherboot</application> 文档。</para>
 
 	<para>想要使用启动软盘，先插入一张软盘到安装有
 	  <application>Etherboot</application> 的机器的驱动器里，
 	  然后把当前路径改到 <filename>src</filename>
 	  目录――在 <application>Etherboot</application> 树下，
 	  接着输入：</para>
 
 	<screen>
 &prompt.root; <userinput>gmake bin32/devicetype.fd0</userinput>
 	</screen>
 
 	<para><replaceable>devicetype</replaceable>
 	  依赖于无盘工作站上的以太网卡的类型。
 	  参考在同一个目录下的 <filename>NIC</filename>
 	  文件确认正确的 <replaceable>devicetype</replaceable>。</para>
 
       </sect3>
 
       <sect3>
 	<title>使用<acronym>PXE</acronym>启动</title>
 
 	<para>默认地，&man.pxeboot.8; 装载器通过 <acronym>NFS</acronym>
 	  装载内核。它可以编译来使用 <acronym>TFTP</acronym>――通过在文件
 	  <filename>/etc/make.conf</filename> 里指定
 	  <literal>LOADER_TFTP_SUPPORT</literal> 选项来代替。 请参见
 	  <filename>/usr/share/examples/etc/make.conf</filename> 里的注释
 	  了解如何配置。</para>
 
 	<para>除此之外还有两个未说明的 <filename>make.conf</filename>
 	  选项――它可能对于设置一系列控制台无盘机器会有用：
 	  <literal>BOOT_PXELDR_PROBE_KEYBOARD</literal>和
 	  <literal>BOOT_PXELDR_ALWAYS_SERIAL</literal>。</para>
 
 	<para>当机器启动里，要使用 <acronym>PXE</acronym>，
 	  通常需要选择 <literal>Boot from network</literal>
 	  选项――在 <acronym>BIOS</acronym> 设置里，
 	  或者在 PC 初始化的时候输入一个功能键 (function key)。</para>
       </sect3>
 
       <sect3>
 	<title>配置 <acronym>TFTP</acronym> 和 <acronym>NFS</acronym> 服务器</title>
 
 	<indexterm>
 	  <primary>TFTP</primary>
 	  <secondary>无盘操作</secondary>
 	</indexterm>
 	<indexterm>
 	  <primary>NFS</primary>
 	  <secondary>无盘操作</secondary>
 	</indexterm>
 
 	<para>如果您正在使用 <acronym>PXE</acronym> 或
 	  <application>Etherboot</application>――配置使用了
 	  <acronym>TFTP</acronym>，那么您需要在文件服务器上启用
 	  <application>tftpd</application>：</para>
         <procedure>
           <step>
 	    <para>建立一个目录――从那里 <application>tftpd</application>
 	      可以提供文件服务，如 <filename>/tftpboot</filename>。</para>
 	  </step>
 
           <step>
             <para>把这一行加入到 <filename>/etc/inetd.conf</filename>里：</para>
 
 	    <programlisting>tftp	dgram	udp	wait	root	/usr/libexec/tftpd	tftpd -l -s /tftpboot</programlisting>
 
 	    <note><para>好像有一些版本的 <acronym>PXE</acronym>
 	      需要 <acronym>TCP</acronym> 版本的 <acronym>TFTP</acronym>。
 	      在这种情况下，加入第二行，使用 <literal>stream tcp</literal>
 	      来代替 <literal>dgram udp</literal>。</para>
 	    </note>
 	  </step>
 	  <step>
 	    <para>让 <application>inetd</application> 重读其配置文件。
 	      要正确执行这个命令， 在 <filename>/etc/rc.conf</filename> 文件中必须加入
 	      <option>inetd_enable="YES"</option>：</para>
 	    <screen>&prompt.root; <userinput>/etc/rc.d/inetd restart</userinput></screen>
 	  </step>
 	</procedure>
 
 	<para>您可把 <filename>tftpboot</filename> 目录放到服务器上的什何地方。
 	  确定这个位置设置在 <filename>inetd.conf</filename> 和
 	  <filename>dhcpd.conf</filename> 里。</para>
 
 	<para>在所有的情况下，您都需要启用 <acronym>NFS</acronym>，
 	并且 <acronym>NFS</acronym> 服务器上导出相应的文件系统。</para>
 
         <procedure><step>
             <para>把这一行加入到<filename>/etc/rc.conf</filename>里：</para>
 	    <programlisting>nfs_server_enable="YES"</programlisting></step>
 
           <step>
             <para>通过往 <filename>/etc/exports</filename>
 	      里加入下面几行(调整<quote>载入点</quote>列，
 	      并且使用无盘工作站的名字替换
 	      <replaceable>margaux corbieres</replaceable>)，
 	      导出文件系统――无盘根目录存在于此：</para>
 
 	    <programlisting><replaceable>/data/misc</replaceable> -alldirs -ro <replaceable>margaux corbieres</replaceable></programlisting>
 	  </step>
 	  <step>
 	    <para>让 <application>mountd</application>
 	      重读它的配置文件。如果您真的需要启用第一步的
 	      <filename>/etc/rc.conf</filename> 里 <acronym>NFS</acronym>，
 	      您可能就要重启系统了。</para>
 	    <screen>&prompt.root; <userinput>/etc/rc.d/mountd restart</userinput></screen>
 	  </step>
 	</procedure>
 
       </sect3>
 
       <sect3>
 	<title>建立无盘内核</title>
 
 	<indexterm>
 	  <primary>无盘操作</primary>
 	  <secondary>内核配置</secondary>
 	</indexterm>
 
 	<para>如果您在使用 <application>Etherboot</application>，
 	  您需要为无盘客户端建立内核配置文件，
 	  使用如下选项(除了常使用的外)：</para>
 
 	<programlisting>
 options     BOOTP          # Use BOOTP to obtain IP address/hostname
 options     BOOTP_NFSROOT  # NFS mount root filesystem using BOOTP info
 	</programlisting>
 
 	<para>您可能也想使用 <literal>BOOTP_NFSV3</literal>，
 	  <literal>BOOT_COMPAT</literal> 和 <literal>BOOTP_WIRED_TO</literal>
 	  (参考 <filename>NOTES</filename> 文件)。</para>
 
 	<para>这些名字具有历史性，并且有些有些误导，
 	  因为它们实际上启用了内核里 (它可能强制限制 BOOTP 或
 	  <acronym>DHCP</acronym> 的使用)，与 <acronym>DHCP</acronym>
 	  和 BOOTP 的无关的应用。</para>
 
 	<para>编译内核(参考<xref linkend="kernelconfig"/>)，
 	  然后将它复制到 <filename>dhcpd.conf</filename>
 	  里指定的地方。</para>
 
 	<note>
 	  <para>当使用 <acronym>PXE</acronym> 里，
 	    使用以上选项建立内核并不做严格要求(尽管建议这样做)。
 	    启用它们会在内核启动时引起更多的 <acronym>DHCP</acronym>
 	    提及过的请求，带来的小小的风险是在有些特殊情况下新值和由
 	    &man.pxeboot.8; 取回的值之间的不一致性。
 	    使用它们的好处是主机名会被附带设置。否则，
 	    您就需要使用其它的方法来设置主机名，如在客户端指定的
 	    <filename>rc.conf</filename> 文件里。</para>
 	</note>
 
 	<note>
 	  <para>为了使带有 <application>Etherboot</application>
 	    的内核可引导，就需要把设备提示 (device hint)
 	    编译进去。通常要在配置文件(查看 <filename>NOTES</filename>
 	    配置注释文件) 里设置下列选项：</para>
 
 	  <programlisting>hints		"GENERIC.hints"</programlisting></note>
 
       </sect3>
 
       <sect3>
 	  <title>准备根(root)文件系统</title>
 
 	<indexterm>
 	  <primary>根文件系统</primary>
 	  <secondary>无盘操作</secondary>
 	</indexterm>
 
 	<para>您需要为无盘工作站建立根文件系统， 它就是
 	  <filename>dhcpd.conf</filename> 里的 <literal>root-path</literal>
 	  所指定的目录。</para>
 
 	<sect4>
 	  <title>使用 <command>make world</command> 来复制根文件系统</title>
 
 	  <para>这种方法可以迅速安装一个彻底干净的系统 (不仅仅是根文件系统) 到
 	    <envar>DESTDIR</envar>。 您要做的就是简单地执行下面的脚本：</para>
 
 	  <programlisting>#!/bin/sh
 export DESTDIR=/data/misc/diskless
 mkdir -p ${DESTDIR}
 cd /usr/src; make buildworld &amp;&amp; make buildkernel
 make installworld &amp;&amp; make installkernel
 cd /usr/src/etc; make distribution</programlisting>
 
 	  <para>一旦完成，您可能需要定制 <filename>/etc/rc.conf</filename>
 	    和 <filename>/etc/fstab</filename>――根据您的需要放到
 	    <envar>DESTDIR</envar>里。</para>
 	</sect4>
       </sect3>
 
       <sect3>
 	<title>配置 swap(交换)</title>
 
 	<para>如果需要，位于服务器上的交换文件可以通过
 	  <acronym>NFS</acronym> 来访问。</para>
 
 	<sect4>
 	  <title><acronym>NFS</acronym> 交换区</title>
 
 	  <para>内核并不支持在引导时启用 <acronym>NFS</acronym>
 	    交换区。 交换区必须通过启动脚本启用， 其过程是挂接一个可写的文件系统，
 	    并在其上创建并启用交换文件。 要建立尺寸合适的交换文件，
 	    可以这样做：</para>
 
 	  <screen>&prompt.root; <userinput>dd if=/dev/zero of=/path/to/swapfile bs=1k count=1 oseek=100000</userinput></screen>
 
 	  <para>要启用它，您须要把下面几行加到
 	    <filename>rc.conf</filename>里：</para>
 
 	  <programlisting>swapfile=<replaceable>/path/to/swapfile</replaceable></programlisting>
         </sect4>
       </sect3>
 
       <sect3>
 	<title>杂项问题</title>
 
 
 	<sect4>
 	  <title>运行时 <filename>/usr</filename> 是只读在</title>
 
 	  <indexterm>
 	    <primary>无盘操作</primary>
 	    <secondary>只读的 /usr</secondary>
 	  </indexterm>
 
 	    <para>如果无盘工作站是配置来支持 X，
 	      那么您就必须调整 <application>XDM</application>
 	      配置文件，因为它默认把错误信息写到
 	      <filename>/usr</filename>。</para>
 	</sect4>
 	<sect4>
 	  <title>使用非 FreeBSD 服务器</title>
 
 	  <para>当用作根文件系统的服务器运行的是不
 	    FreeBSD，您须要在 FreeBSD 机器上建立根文件系统，
 	    然后把它复制到它的目的地，使用的命令可以是
 	    <command>tar</command> 或 <command>cpio</command>。</para>
 
 	  <para>在这种情况下，有时对于 <filename>/dev</filename>
 	    里的一些特殊的文件会有问题，原因就是不同的
 	    <quote>最大/最小</quote>整数大小。
 	    一种解决的方法就是从非 FreeBSD 服务里导出一个目录，
 	    并把它载入 FreeBSD 到机子上， 并使用 &man.devfs.5;
 	    来为用户透明地分派设备节点。</para>
 
 	</sect4>
 
       </sect3>
 
     </sect2>
   </sect1>
 
   <sect1 xml:id="network-pxe-nfs">
     <info><title>从 PXE 启动一个 NFS 根文件系统</title>
       <authorgroup>
 	<author><personname><firstname>Craig</firstname><surname>Rodrigues</surname></personname><affiliation>
 	    <address>rodrigc@FreeBSD.org</address>
 	  </affiliation><contrib>原作者 </contrib></author>
       </authorgroup>
     </info>
     
 
     <para>&intel; 预启动执行环境 （<acronym>PXE</acronym>）
       能让操作系统从网络启动。 通常由近代主板的 <acronym>BIOS</acronym>
       提供 <acronym>PXE</acronym> 支持，它可以通过在 <acronym>BIOS</acronym>
       设置里选择从网络启动开启。 一个功能完整的 <acronym>PXE</acronym>
       配置还需要正确地设置 <acronym>DHCP</acronym> 和 <acronym>TFTP</acronym>
       服务。</para>
 
     <para>当计算机启动的时候， 通过 <acronym>DHCP</acronym> 获取关于
       从 <acronym>TFTP</acronym> 得到引导加载器（boot loader）的信息。 
       在计算机接受此信息以后， 便通过 <acronym>TFTP</acronym>
       下载并执行引导加载器。 这些记载于
       <link xlink:href="http://download.intel.com/design/archives/wfm/downloads/pxespec.pdf">
         预启动执行环境 (PXE) 规范</link> 的 2.2.1 章节中。
       在 &os; 中， 在 <acronym>PXE</acronym> 过程中获取的引导加载器为
       <filename>/boot/pxeboot</filename>。 在 <filename>/boot/pxeboot</filename>
       执行之后， &os; 的内核被加载， 接着是其他的 &os; 相关引导部分依次被执行。
       更多关于 &os; 启动过程的详细信息请参阅 <xref linkend="boot"/>。</para>
 
     <sect2>
       <title>配置用于 NFS 根文件系统的 <command>chroot</command> 环境</title>
 
 	<procedure>
 	  <step>
 	    <para>Choose a directory which will have a &os; installation
 	      which will be NFS mountable.  For example, a directory such
 	      as <filename>/b/tftpboot/FreeBSD/install</filename> can be used.</para>
             <para>选择一个可被用户 NFS 挂载并安装有 &os; 的目录。
               比如可以使用像 <filename>/b/tftpboot/FreeBSD/install</filename>
               这样的一个目录。</para>
 
 	  <screen>&prompt.root; <userinput>export NFSROOTDIR=/b/tftpboot/FreeBSD/install</userinput>
 &prompt.root; <userinput>mkdir -p ${NFSROOTDIR}</userinput></screen>
 	  </step>
 
 	  <step>
 	    <para>使用如下的命令开启 NFS 服务
 	      <xref linkend="network-configuring-nfs"/>.</para>
 	  </step>
 
 	  <step>
 	    <para>将下面这行加入 <filename>/etc/exports</filename>
               用以通过 NFS 导出此目录：</para>
 
 	      <programlisting>/b -ro -alldirs</programlisting>
 	  </step>
 
 	  <step>
 	    <para>重起 NFS 服务：</para>
 
 	    <screen>&prompt.root; <userinput>/etc/rc.d/nfsd restart</userinput></screen>
 	  </step>
 
 	  <step>
 	    <para>按照 <xref linkend="network-inetd-settings"/>
                 中标明的步骤启用 &man.inetd.8;。</para>
 	  </step>
 
 	  <step>
             <para>将如下这行加入到
 	      <filename>/etc/inetd.conf</filename>：</para>
 
 	    <programlisting>tftp dgram udp wait root /usr/libexec/tftpd tftpd -l -s /b/tftpboot</programlisting>
 	  </step>
 
 	  <step>
             <para>重启 inetd：</para>
 
 	    <screen>&prompt.root; <userinput>/etc/rc.d/inetd restart</userinput></screen>
 	  </step>
 
 	  <step>
             <para><link linkend="makeworld">重新编译 &os; 内核和用户态</link>：</para>
 
 	    <screen>&prompt.root; <userinput>cd /usr/src</userinput>
 &prompt.root; <userinput>make buildworld</userinput>
 &prompt.root; <userinput>make buildkernel</userinput></screen>
 	  </step>
 
 	  <step>
 	    <para>把 &os; 安装到 <acronym>NFS</acronym> 挂载目录：</para>
 
 	    <screen>
 &prompt.root; <userinput>make installworld DESTDIR=${NFSROOTDIR}</userinput>
 &prompt.root; <userinput>make installkernel DESTDIR=${NFSROOTDIR}</userinput>
 &prompt.root; <userinput>make distribution DESTDIR=${NFSROOTDIR}</userinput>
 	    </screen>
 	  </step>
 
 	  <step>
             <para>测试 <acronym>TFTP</acronym> 服务是否能下载将从
               <acronym>PXE</acronym> 获取的引导加载器：</para>
 
 	    <screen>
 &prompt.root; <userinput>tftp localhost</userinput>
 tftp&gt; <userinput>get FreeBSD/install/boot/pxeboot</userinput>
 Received 264951 bytes in 0.1 seconds
 	    </screen>
 	  </step>
 
 	  <step>
             <para>编辑 <filename>${NFSROOTDIR}/etc/fstab</filename>
               并加入以下这行挂载 NFS 根文件系统：</para>
 
 	    <programlisting>
 # Device                                         Mountpoint    FSType   Options  Dump Pass
 myhost.example.com:/b/tftpboot/FreeBSD/install       /         nfs      ro        0    0
 	    </programlisting>
 
             <para>用你的 <acronym>NFS</acronym> 服务器主机名或者 IP 地址替换
               <replaceable>myhost.example.com</replaceable>。 在此例中，
               根文件系统是以“只读”的方式挂载用来防止 <acronym>NFS</acronym>
               客户端可能意外删除根文件系统上的文件。</para>
 	  </step>
 
 	  <step>
             <para>设置 &man.chroot.8; 环境中的 root 密码。</para>
 	      <screen>&prompt.root; <userinput>chroot ${NFSROOTDIR}</userinput>
 &prompt.root; <userinput>passwd</userinput></screen>
               <para>此为设置从 <acronym>PXE</acronym>
                 启动的客户机的 root 密码。</para>
 	  </step>
 
 	  <step>
             <para>允许 ssh root 登录从 <acronym>PXE</acronym> 启动的客户机，
               编辑 <filename>${NFSROOTDIR}/etc/ssh/sshd_config</filename>
               并开启 <literal>PermitRootLogin</literal> 选项。
               关于此选项的说明请参阅 &man.sshd.config.5;。</para>
 	  </step>
 
 	  <step>
             <para>对 ${NFSROOTDIR} 的 &man.chroot.8; 环境做些其他的定制。
               这可以是像使用 &man.pkg.add.1; 安装二进制包，
               使用 &man.vipw.8; 修改密码， 或者编辑 &man.amd.conf.5;
               映射自动挂载等。例如：</para>
 
 	    <screen>
 &prompt.root; <userinput>chroot ${NFSROOTDIR}</userinput>
 &prompt.root; <userinput>pkg_add -r bash</userinput></screen>
 	  </step>
 	</procedure>
       </sect2>
 
       <sect2>
         <title>配置 <filename>/etc/rc.initdiskless</filename> 中用到的内存文件系统</title>
 
         <para>如果你从一个 NFS 根卷启动，
 	  <filename>/etc/rc</filename>
           如果检测到是从 NFS 启动便会运行
 	  <filename>/etc/rc.initdiskless</filename> 脚本。
           请阅读此脚本中的注释部分以便了解到底发生了什么。
           我们需要把 <filename>/etc</filename> 和
 	  <filename>/var</filename>
           做成内存文件系统的原因是这些目录需要能被写入，
           但 NFS 根文件系统是只读的。</para>
 	<screen>
 &prompt.root; <userinput>chroot ${NFSROOTDIR}</userinput>
 &prompt.root; <userinput>mkdir -p conf/base</userinput>
 &prompt.root; <userinput>tar -c -v -f conf/base/etc.cpio.gz --format cpio --gzip etc</userinput>
 &prompt.root; <userinput>tar -c -v -f conf/base/var.cpio.gz --format cpio --gzip var</userinput></screen>
 
         <para>当系统启动的时候， <filename>/etc</filename> 和
           <filename>/var</filename> 内存文件系统就会被创建并挂载，
           <filename>cpio.gz</filename> 就会被复制进去。</para>
       </sect2>
 
       <sect2>
         <title>配置 DHCP 服务</title>
 
         <para>PXE 需要配置一个 <acronym>TFTP</acronym> 服务器和一个
           <acronym>DHCP</acronym> 服务器。 <acronym>DHCP</acronym>
           服务并不要求与 <acronym>TFTP</acronym> 服务在同一台机器上，
           但是必须能够从你的网络访问到它。</para>
 
 	<procedure>
 	  <step>
             <para>按照此文档处 <xref linkend="network-dhcp-server"/>
                 方法安装 <acronym>DHCP</acronym> 服务。
                 确保 <filename>/etc/rc.conf</filename> 和
                 <filename>/usr/local/etc/dhcpd.conf</filename>
                 都配置正确。</para>
 	  </step>
 
 	  <step>
             <para>在 <filename>/usr/local/etc/dhcpd.conf</filename> 中配置
               <literal>next-server</literal>， <literal>filename</literal>，
               <literal>option root-path</literal> 选项指向你的
               <acronym>TFTP</acronym> 服务器的 IP 地址，
               以及 <acronym>TFTP</acronym> 上 <filename>/boot/pxeboot</filename>
               文件的路径， 和 <acronym>NFS</acronym> 根文件系统的路径。
               这里一份 <filename>dhcpd.conf</filename> 实例：</para>
 
 	    <programlisting>
 subnet 192.168.0.0 netmask 255.255.255.0 {
    range 192.168.0.2 192.168.0.3 ;
    option subnet-mask 255.255.255.0 ;
    option routers 192.168.0.1 ;
    option broadcast-address 192.168.0.255 ;
    option domain-name-server 192.168.35.35, 192.168.35.36 ;
    option domain-name "example.com";
 
    # IP address of TFTP server
    next-server 192.168.0.1 ;
 
    # path of boot loader obtained
    # via tftp
    filename "FreeBSD/install/boot/pxeboot" ;
 
    # pxeboot boot loader will try to NFS mount this directory for root FS
    option root-path "192.168.0.1:/b/tftpboot/FreeBSD/install/" ;
 
 }
 	    </programlisting>
 	  </step>
 	</procedure>
       </sect2>
 
       <sect2>
         <title>配置 PXE 客户端与调试连接问题</title>
 
 	<procedure>
 	  <step>
             <para>当客户端启动的时候， 进入 <acronym>BIOS</acronym>
               配置菜单。 设置 <acronym>BIOS</acronym> 从网络启动。
               如果之前你所有的配置步骤都正确的话， 那么所有部分应该能
               &quot;正常工作&quot;。</para>
 	  </step>
 
 	  <step>
             <para>使用 <package>net/wireshark</package>
               port 查看 <acronym>DHCP</acronym> 和 <acronym>TFTP</acronym>
               的网络流量来调试各种问题。</para>
 	  </step>
 
 	  <step>
             <para>确保 <filename>pxeboot</filename> 能从
               <acronym>TFTP</acronym> 获取。
               在你的 <acronym>TFTP</acronym> 服务器上检查
               <filename>/var/log/xferlog</filename> 日志确保
               <filename>pxeboot</filename> 被从正确的位置获取。
               可以这样测试上面例子 <filename>dhcpd.conf</filename>
               中所设置的：</para>
 
 	    <screen>&prompt.root; <userinput>tftp 192.168.0.1</userinput>
 tftp&gt; <userinput>get FreeBSD/install/boot/pxeboot</userinput>
 Received 264951 bytes in 0.1 seconds</screen>
 
           <para>请阅读 &man.tftpd.8; 和 &man.tftp.1;。
             其中的 <literal>BUGS</literal> 列出了
             <acronym>TFTP</acronym> 的一些限制。</para>
 	</step>
 
 	<step>
           <para>确保根文件系统能够从 <acronym>NFS</acronym> 挂载。
             可以这样测试上面例子 <filename>dhcpd.conf</filename>
             中所设置的：</para>
 
 	  <screen>&prompt.root; <userinput>mount -t nfs 192.168.0.1:/b/tftpboot/FreeBSD/install /mnt</userinput></screen>
 	</step>
 
 	<step>
           <para>阅读 <filename>src/sys/boot/i386/libi386/pxe.c</filename>
             中的代码以了解 <filename>pxeboot</filename> 加载器如何设置诸如
             <literal>boot.nfsroot.server</literal> 和
             <literal>boot.nfsroot.path</literal> 之类的变量。
             这些变量被用在了
             <filename>src/sys/nfsclient/nfs_diskless.c</filename>
             的 NFS 无盘根挂载代码中。</para>
 	</step>
 
 	<step>
 	  <para>Read &man.pxeboot.8; and &man.loader.8;.</para>
 	</step>
       </procedure>
     </sect2>
   </sect1>
 
   <sect1 xml:id="network-isdn">
     <title>ISDN</title>
 
     <indexterm><primary>ISDN</primary></indexterm>
 
     <para>关于 ISDN 技术和硬件的一个好的资源是<link xlink:href="http://www.alumni.caltech.edu/~dank/isdn/">Dan Kegel
       的 ISDN 主页</link>。</para>
 
     <para>一个快速简单的到 ISDN 的路线图如下：</para>
 
     <itemizedlist><listitem>
         <para>如果您住在欧洲，您可能要查看一下 ISDN 卡部分。</para>
       </listitem>
 
       <listitem>
 	<para>如果您正计划首要地使用 ISDN
 	  基于拨号非专用线路连接到带有提供商的互联网，
 	  您可能要了解一下终端适配器。如果您更改提供商的话，
 	  这会给您带来最大的灵活性、最小的麻烦。</para>
       </listitem>
 
       <listitem>
 	<para>如果您连接了两个局域网 (LAN)，或使用了专用的
 	  ISDN 连线连接到互联网，您可能要考虑选择单独的路由器/网桥。</para>
       </listitem></itemizedlist>
 
     <para>在决定选择哪一种方案的时候，价格是个很关键的因素。
       下面列有从不算贵到最贵的选择：</para>
 
     <sect2 xml:id="network-isdn-cards">
       <info><title>ISDN 卡</title>
 	<authorgroup>
 	  <author><personname><firstname>Hellmuth</firstname><surname>Michaelis</surname></personname><contrib>贡献者：</contrib></author>
 	</authorgroup>
 	<authorgroup>
 	  <author><personname><firstname>张</firstname><surname>雪平</surname></personname><contrib>中文翻译：</contrib><affiliation>
 	      <address><email>zxpmyth@yahoo.com.cn</email></address>
 	    </affiliation></author>
 	</authorgroup>
       </info>
       
 
       <indexterm>
 	<primary>ISDN</primary>
 	<secondary>卡</secondary>
       </indexterm>
 
       <para>FreeBSD 的 ISDN 工具通过被动卡
 	(passive card) 仅支持 DSS1/Q.931(或 Euro-ISDN) 标准。
 	此外也支持一些 active card， 它们的固件也支持其它信号协议，
 	这其中包括最先得到支持的
 	<quote>Primary Rate (PRI) ISDN</quote>卡。</para>
 
       <para><application>isdn4bsd</application> 软件允许连接到其它
 	ISDN 路由器，使用的是原始的 HDLC 上的 IP 或利用同步 PPP：使用带有
 	<literal>isppp</literal> (一个修改过的 &man.sppp.4; 驱动程序)的
 	PPP 内核，或使用用户区 (userland) &man.ppp.8;。通过使用
 	userland &man.ppp.8;，两个或更多 ISDN 的 B 通道联结变得可能。
 	除了许多如 300 波特 (Baud) 的软 modem 一样的工具外，
 	还可以实现电话应答机应用。</para>
 
       <para>在 FreeBSD 里，正有更多的 PC ISDN 卡被支持；
 	报告显示在整个欧洲及世界的其它许多地区可以成功使用。</para>
 
       <para>被支持的主动型 ISDN 卡主要是带有 Infineon (以前的 Siemens)
 	ISAC/HSCX/IPAC ISDN 芯片组，另外还有带有 Cologne (只有 ISA 总线)
 	芯片的 ISDN 卡、带有 Winbond W6692 芯片的 PCI 卡、一部分带有
 	Tiger300/320/ISAC 芯片组的卡以及带有一些商家专有的芯片组的卡
 	(如 AVM Fritz&excl;Card PCI V.1.0 和 the AVM Fritz&excl;Card PnP)。</para>
 
       <para>当前积极的支持的 ISDN 卡有 AVM B1 (ISA 和 PCI) BRI
 	卡和 AVM T1 PCI PRI 卡。</para>
 
       <para>关于 <application>isdn4bsd</application> 的文档，请查看 <link xlink:href="http://www.freebsd-support.de/i4b/">isdn4bsd的主页</link>，
 	  那里也有提示、勘误表以及更多的文档 (如 <link xlink:href="http://people.FreeBSD.org/~hm/">isdn4bsd手册</link>)。</para>
 
       <para>要是您有兴趣增加对不同 ISDN 协议的支持，对当前还不支持的
 	ISDN PC 卡的支持或想增强 <application>isdn4bsd</application>
 	的性能，请联系 &a.hm;。</para>
 
       <para>对于安装、配置以及 <application>isdn4bsd</application>
 	故障排除的问题，可以利用 &a.isdn.name; 邮件列表。</para>
     </sect2>
 
     <sect2>
       <title>ISDN 终端适配器</title>
 
       <para>终端适配器 (TA) 对于 ISDN 就好比 modem 对于常规电话线。</para>
       <indexterm><primary>modem</primary></indexterm>
       <para>许多 TA 使用标准的 Hayes modem AT 命令集，并且可以降级来代替 modem。</para>
 
       <para>TA 基本的运作同 modem 一样，不同之处是连接和整个速度更比老
 	modem 更快。同 modem 的安装一样，您也需要配置
 	<link linkend="ppp">PPP</link>。确认您的串口速度已足够高。</para>
       <indexterm>
 	<primary>PPP</primary>
       </indexterm>
       <para>使用 TA 连接互联网提供商的主要好处是您可以做动态的 PPP。
 	由于 IP 地址空间变得越来越紧张，许多提供商都不愿再提供静态
 	IP。许多的独立的路由器是不支持动态 IP 分配的。</para>
 
       <para>TA 完全依赖于您在运行的 PPP 进程，
 	以完成它们的功能和稳定的连接。这可以让您在 FreeBSD
 	机子里轻易地从使用 modem 升级到 ISDN，要是您已经安装了
 	PPP 的话。只是，在您使用 PPP 程序时所体验到任何问题同时也存在。</para>
 
       <para>如果您想要最大的稳定性，请使用 <link linkend="ppp">PPP</link> 内核选项，而不要使用 <link linkend="userppp">userland PPP</link>。</para>
 
       <para>下面的 TA 就可以同 FreeBSD 一起工作：</para>
 
       <itemizedlist><listitem>
 	  <para>Motorola BitSurfer 和 Bitsurfer Pro</para>
 	</listitem>
 
 	<listitem>
 	  <para>Adtran</para>
 	</listitem></itemizedlist>
 
       <para>大部分其它的 TA 也可能工作，TA
 	提供商试图让他们的产品可以接受大部分的标准 modem AT 命令集。</para>
 
       <para>对于外置 TA 的实际问题是：象 modem
 	要一样，您机子需要有一个好的串行卡。</para>
 
       <para>想要更深入地理解串行设备以及异步和同步串口这间的不同点，
 	您就要读读 <link xlink:href="&url.articles.serial-uart;/index.html">FreeBSD
 	串行硬件</link>教程了。</para>
 
       <para>TA 将标准的 PC 串口 (同步的) 限制到了 115.2 Kbs，即使您有
 	128 Kbs 的连接。 想要完全利用 ISDN 有能力达到的 128 Kbs，您就需要把
 	TA 移到同步串行卡上。</para>
 
       <para>当心被骗去买一个内置的 TA 以及自认为可以避免同步/异步问题。内置的
 	TA 只是简单地将一张标准 PC 串口芯片内建在里边。
 	所做的这些只是让您省去买另一根串行线以及省去寻找另一个空的插孔。</para>
 
       <para>带有 TA 的同步卡至少和一个独立的路由器同一样快地，
 	而且仅使用一个简单的 386 FreeBSD 盒驱动它。</para>
 
       <para>选择同步卡/TA 还是独立的路由器，是个要高度谨慎的问题。
 	在邮件列表里有些相关的讨论。我们建议您去搜索一下关于完整讨论的<link xlink:href="&url.base;/search/index.html">记录</link>。</para>
     </sect2>
 
     <sect2>
       <title>单独的 ISDN 桥/路由器</title>
       <indexterm>
 	<primary>ISDN</primary>
 	<secondary>单独的 桥/路由器</secondary>
       </indexterm>
       <para>ISDN 桥或路由器根本就没有指定要 FreeBSD
 	或其它任何的操作系统。更多完整的关于路由和桥接技术的描述，
 	请参考网络指南的书籍。</para>
 
       <para>这部分的内容里，路由器和桥接这两个词汇将会交替地使用。</para>
 
       <para>随着 ISDN 路由器/桥的价格下滑，对它们的选择也会变得越来越流行。
 	ISDN 路由器是一个小盒子，可以直接地接入您的本地以太网，
 	并且自我管理到其它桥/路由器的连接。它有个内建的软件用于与通信――通过
 	PPP 和其它流行的协议。</para>
 
       <para>路由器有比标准 TA 更快的吞吐量，因为它会使用完全同步的 ISDN 连接。</para>
 
       <para>使用 ISDN 路由器和桥的主要问题是两个生产商之间的协同性仍存在问题。
 	如果您计划连接到互联网提供商，您应该跟他们进行交涉。</para>
 
       <para>如果您计划连接两个局域网网段，如您的家庭网和办公网，
 	这将是最简单最低维护的解决方案。因为您买的设备是用于连接两边的，
 	可以保证这种连接一定会成功。</para>
 
       <para>例如连接到家里的计算机，或者是办公网里的一个分支连接到办公主网，
 	那么下面的设置就可能用到：</para>
 
       <example><title>办公室局部或家庭网</title>
 
 	<indexterm><primary>10 base 2</primary></indexterm>
 	<para>网络使用基于总线拓扑的 10 base 2 以太网
 	  (<quote>瘦网(thinnet)</quote>)。如果有必要，用网线连接路由器和
 	  AUI/10BT 收发器。</para>
 
         <mediaobject>
           <imageobject>
             <imagedata fileref="advanced-networking/isdn-bus"/>
           </imageobject>
 
 	  <textobject>
 	    <literallayout class="monospaced">---Sun workstation
 |
 ---FreeBSD box
 |
 ---Windows 95
 |
 Stand-alone router
    |
 ISDN BRI line</literallayout>
           </textobject>
 
 	  <textobject>
 	    <phrase>10 Base 2 Ethernet</phrase>
 	  </textobject>
 	</mediaobject>
 
 	<para>如果您的家里或办公室支部里只有一台计算机，
 	  您可以使用一根交叉的双绞线直接连接那台独立路由器。</para>
       </example>
 
       <example><title>主办公室或其它网络</title>
 
 	<indexterm><primary>10 base T</primary></indexterm>
 	<para>网络使用的是星形拓扑的 10 base T 以太网(<quote>双绞线</quote>)。</para>
 
         <mediaobject>
           <imageobject>
             <imagedata fileref="advanced-networking/isdn-twisted-pair"/>
           </imageobject>
 
 	  <textobject>
 	    <literallayout class="monospaced">    -------Novell Server
     | H |
     |   ---Sun
     |   |
     | U ---FreeBSD
     |   |
     |   ---Windows 95
     | B |
     |___---Stand-alone router
                 |
         ISDN BRI line</literallayout>
 	  </textobject>
 
 	  <textobject>
 	    <phrase>ISDN Network Diagram</phrase>
 	  </textobject>
 	</mediaobject>
       </example>
 
       <para>大部分路由器/网桥有一大好处就是，它们允许您在
 	<emphasis>同一</emphasis> 时间，有两个 <emphasis>分开独立的</emphasis>
 	PPP 连接到两个分开的点上。这点在许多的 TA 上是不支持的，
 	除非带有两个串口的特定模式(通常都很贵)。请不要把它与通道连接、MPP
 	等相混淆。</para>
 
       <para>这是个非常有用的功能，例如，如果在您的办公室里您有个专有的
 	ISDN 连接，而且您想接入到里边，但休想让另一根 ISDN 线也能工作。
 	办公室里的路由器能够管理专有的B通道连接到互联网 (64 Kbps)
 	以及使用另一个通道 B 来完成单独的数据连接。 第二个 B
 	通道可以用于拨进、拨出或动态与第一个B通道进行连接
 	(MPP等)，以获取更大宽带。</para>
 
       <indexterm><primary>IPX/SPX</primary></indexterm>
       <para>以太网桥也允许您传输的不仅仅是 IP 通信。您也可以发送
 	IPX/SPX 或其它任何您所使用的协议。</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="network-natd">
     <info><title>网络地址转换</title>
       <authorgroup>
 	<author><personname><firstname>Chern</firstname><surname>Lee</surname></personname><contrib>作者：</contrib></author>
       </authorgroup>
       <authorgroup>
 	<author><personname><firstname>李</firstname><surname>鑫</surname></personname><contrib>译者：</contrib><affiliation>
 	    <address><email>delphij@FreeBSD.org.cn</email></address>
 	  </affiliation></author>
       </authorgroup>
     </info>
 
     
 
     <sect2 xml:id="network-natoverview">
       <title>概要</title>
       <indexterm>
         <primary><application>natd</application></primary>
       </indexterm>
       <para>FreeBSD 的网络地址转换服务， 通常也被叫做
         &man.natd.8;， 是一个能够接收连入的未处理 IP 包，
         将源地址修改为本级地址然后重新将这些包注入到发出
         IP 包流中。 &man.natd.8; 同时修改源地址和端口，
         当接收到响应数据时，它作逆向转换以便把数据发回原先的请求者。</para>
       <indexterm><primary>Internet 连接共享</primary></indexterm>
       <indexterm><primary>NAT</primary></indexterm>
       <para>NAT 最常见的用途是为人们所熟知的
         Internet 连接共享。</para>
     </sect2>
 
     <sect2 xml:id="network-natsetup">
       <title>安装</title>
       <para>随着 IPv4 的 IP 地址空间的日益枯竭，
 	以及使用如 DSL 和电缆等高速连接的用户的逐渐增多，
 	越来越多的人开始需要 Internet 连接共享这样的解决方案。
 	由于能够将许多计算机通过一个对外的 IP 地址进行接入，
 	&man.natd.8; 成为了一个理想的选择。</para>
 
       <para>更为常见的情况， 一个用户通过电缆或者 DSL 线路
 	接入，并拥有一个 IP 地址，同时，希望通过这台接入
 	Internet 的计算机来为
 	LAN 上更多的计算机提供接入服务。</para>
 
       <para>为了完成这一任务， 接入 Internet 的 FreeBSD
 	机器必须扮演网关的角色。
 	这台网关必须有两块网卡 &mdash; 一块用于连接
 	Internet 路由器， 另一块用来连接 LAN。 所有 LAN
 	上的机器通过 Hub 或交换机进行连接。</para>
 
       <note>
 	<para>有多种方法能够通过 &os; 网关将 LAN 接入 Internet。
 	  这个例子只介绍了有至少两块网卡的网关。</para>
       </note>
 
       <mediaobject>
         <imageobject>
           <imagedata fileref="advanced-networking/natd"/>
         </imageobject>
 	<textobject>
 	  <literallayout class="monospaced">  _______       __________       ________
  |       |     |          |     |        |
  |  Hub  |-----| Client B |-----| Router |----- Internet
  |_______|     |__________|     |________|
      |
  ____|_____
 |          |
 | Client A |
 |__________|</literallayout>
         </textobject>
 
 	<textobject>
 	  <phrase>Network Layout</phrase>
 	</textobject>
       </mediaobject>
 
       <para>上述配置被广泛地用于共享 Internet 连接。
         <acronym>LAN</acronym> 中的一台机器连接到 Internet 中。
         其余的计算机则通过那台 <quote>网关</quote> 机来连接 Internet。</para>
     </sect2>
 
     <sect2 xml:id="network-natdloaderconfiguration">
 
       <title>引导加载器配置</title>
 
       <indexterm>
 	<primary>boot loader (引导加载器)</primary>
 	<secondary>configuration (配置)</secondary>
       </indexterm>
 
       <para>在默认的 <filename>GENERIC</filename>
 	内核中， 并没有启用通过 &man.natd.8; 进行网址翻译的功能，
 	不过， 这一功能可以通过在 <filename>/boot/loader.conf</filename>
 	中添加两项配置来在引导时自动予以加载：</para>
 
       <programlisting>ipfw_load="YES"
 ipdivert_load="YES"</programlisting>
 
       <para>此外， 还可以将引导加载器变量
 	<literal>net.inet.ip.fw.default_to_accept</literal>
 	设为 <literal>1</literal>：</para>
 
       <programlisting>net.inet.ip.fw.default_to_accept="1"</programlisting>
 
       <note>
 	<para>在刚开始配置防火墙和 NAT 网关时，
 	  增加这个配置是个好主意。 默认的 &man.ipfw.8;
 	  规则将是 <literal>allow ip from any to
 	  any</literal> 而不是默认的 <literal>deny ip from
 	  any to any</literal>， 这样， 在系统重启时，
 	  也就不太容易被反锁在外面。</para>
       </note>
     </sect2>
 
     <sect2 xml:id="network-natdkernconfiguration">
       <title>内核配置</title>
 
       <indexterm>
         <primary>内核</primary>
 	<secondary>配置</secondary>
       </indexterm>
       <para>当不能使用内核模块， 或更希望将全部需要的功能联编进内核时，
 	可以在内核配置中添加下面的设置来实现：</para>
 
       <programlisting>options IPFIREWALL
 options IPDIVERT</programlisting>
 
       <para>此外，下列是一些可选的选项：</para>
       <programlisting>options IPFIREWALL_DEFAULT_TO_ACCEPT
 options IPFIREWALL_VERBOSE</programlisting>
     </sect2>
 
     <sect2 xml:id="network-natdsystemconfiguration">
       <title>系统引导时的配置</title>
 
       <para>如果希望在系统引导过程中启用防火墙和 NAT 支持，
 	应在 <filename>/etc/rc.conf</filename>中添加下列配置：</para>
 
       <programlisting>gateway_enable="YES" <co xml:id="co-natd-gateway-enable"/>
 firewall_enable="YES" <co xml:id="co-natd-firewall-enable"/>
 firewall_type="OPEN" <co xml:id="co-natd-firewall-type"/>
 natd_enable="YES"
 natd_interface="<replaceable>fxp0</replaceable>" <co xml:id="co-natd-natd-interface"/>
 natd_flags="" <co xml:id="co-natd-natd-flags"/></programlisting>
 
       <calloutlist>
         <callout arearefs="co-natd-gateway-enable">
           <para>将机器配置为网关。 执行
             <command>sysctl net.inet.ip.forwarding=1</command> 效果相同。</para>
 	</callout>
 
         <callout arearefs="co-natd-firewall-enable">
           <para>在启动时启用
             <filename>/etc/rc.firewall</filename> 中的防火墙规则。</para>
 	</callout>
 
         <callout arearefs="co-natd-firewall-type">
           <para>指定一个预定义的允许所有包进入的防火墙规则集。 参见
             <filename>/etc/rc.firewall</filename> 以了解其他类型的规则集。</para>
 	</callout>
 
         <callout arearefs="co-natd-natd-interface">
           <para>指定通过哪个网络接口转发包
             (接入 Internet 的那一个)。</para>
 	</callout>
 
         <callout arearefs="co-natd-natd-flags">
           <para>其他希望在启动时传递给
             &man.natd.8; 的参数。</para>
 	</callout>
       </calloutlist>
 
       <para>在 <filename>/etc/rc.conf</filename> 中加入上述选项将在系统启动时运行
         <command>natd -interface fxp0</command>。 这一工作也可以手工完成。</para>
 
       <note>
 	<para>当有太多选项要传递时，也可以使用一个 &man.natd.8;
 	  的配置文件来完成。这种情况下，这个配置文件必须通过在
 	  <filename>/etc/rc.conf</filename> 里增加下面内容来定义：</para>
 
 	<programlisting>natd_flags="-f /etc/natd.conf"</programlisting>
 
 	<para><filename>/etc/natd.conf</filename> 文件会包含一个配置选项列表，
 	  每行一个。在紧跟部分的例子里将使用下面的文件：</para>
 
 	<programlisting>redirect_port tcp 192.168.0.2:6667 6667
 redirect_port tcp 192.168.0.3:80 80</programlisting>
 
 	<para>关于配置文件的更多信息，参考 &man.natd.8; 手册页中关于
 	  <option>-f</option> 选项那一部分。</para>
       </note>
 
       <para>在LAN后面的每一台机子和接口应该被分配私有地址空间(由<link xlink:href="ftp://ftp.isi.edu/in-notes/rfc1918.txt">RFC 1918</link>定义)
 	里的 IP 地址，并且默认网关设成 <application>natd</application>
 	机子的内连 IP 地址。</para>
 
       <para>例如：客户端 <systemitem>A</systemitem> 和 <systemitem>B</systemitem> 在
 	LAN 后面，IP 地址是 <systemitem class="ipaddress">192.168.0.2</systemitem> 和 <systemitem class="ipaddress">192.168.0.3</systemitem>，同时 natd 机子的 LAN 接口上的 IP 地址是 <systemitem class="ipaddress">192.168.0.1</systemitem>。客户端 <systemitem>A</systemitem> 和
 	<systemitem>B</systemitem> 的默认网关必须要设成 <application>natd</application>
 	机子的 IP――<systemitem class="ipaddress">192.168.0.1</systemitem>。<application>natd</application>
 	机子外连，或互联网接口不需要为了 &man.natd.8;
 	而做任何特别的修改就可工作。</para>
     </sect2>
 
     <sect2 xml:id="network-natdport-redirection">
       <title>端口重定向</title>
 
       <para>使用 &man.natd.8; 的缺点就是 LAN 客户不能从互联网访问。LAN
 	上的客户可以进行到外面的连接，而不能接收进来的连接。如果想在
 	LAN 的客户端机子上运行互联网服务，这就会有问题。
 	对此的一种简单方法是在 <application>natd</application>
 	机子上重定向选定的互联网端口到 LAN 客户端。
       </para>
 
       <para>例如：在客户端 <systemitem>A</systemitem> 上运行 IRC
 	服务，而在客户端 <systemitem>B</systemitem> 上运行 web 服务。
 	想要正确的工作，在端口 6667 (IRC) 和 80 (web)
 	上接收到的连接就必须重定向到相应的机子上。
       </para>
 
       <para><option>-redirect_port</option>
 	需要使用适当的选项传送给 &man.natd.8;。语法如下：</para>
       <programlisting>     -redirect_port proto targetIP:targetPORT[-targetPORT]
                  [aliasIP:]aliasPORT[-aliasPORT]
                  [remoteIP[:remotePORT[-remotePORT]]]</programlisting>
 
       <para>在上面的例子中，参数应该是：</para>
 
         <programlisting>    -redirect_port tcp 192.168.0.2:6667 6667
     -redirect_port tcp 192.168.0.3:80 80</programlisting>
 
       <para>
 	这就会重定向适当的 <emphasis>tcp</emphasis> 端口到 LAN 上的客户端机子。
       </para>
 
       <para><option>-redirect_port</option>
 	参数可以用来指出端口范围来代替单个端口。例如，
 	<replaceable>tcp 192.168.0.2:2000-3000 2000-3000</replaceable>
 	就会把所有在端口 2000 到 3000 上接收到的连接重定向到主机
 	<systemitem>A</systemitem> 上的端口 2000 到 3000。</para>
 
       <para>当直接运行 &man.natd.8; 时，就可以使用这些选项，
 	把它们放到 <filename>/etc/rc.conf</filename> 里的
 	<literal>natd_flags=""</literal> 选项上，
 	或通过一个配置文件进行传送。</para>
 
       <para>想要更多配置选项，请参考 &man.natd.8;。</para>
     </sect2>
 
     <sect2 xml:id="network-natdaddress-redirection">
       <title>地址重定向</title>
       <indexterm>
 	<primary>地址重定向</primary>
       </indexterm>
       <para>如果有几个 IP 地址提供，那么地址重定向就会很有用，
 	然而他们必须在一个机子上。使用它，&man.natd.8;
 	就可以分配给每一个 LAN 客户端它们自己的外部 IP 地址。&man.natd.8;
 	然后会使用适当的处部 IP 地址重写从 LAN 客户端外出的数据包，
 	以及重定向所有进来的数据包――一定的 IP 地址回到特定的
 	LAN 客户端。这也叫做静态 NAT。例如，IP 地址
 	<systemitem class="ipaddress">128.1.1.1</systemitem>、
 	<systemitem class="ipaddress">128.1.1.2</systemitem> 和
 	<systemitem class="ipaddress">128.1.1.3</systemitem> 属于
 	<application>natd</application> 网关机子。
 	<systemitem class="ipaddress">128.1.1.1</systemitem> 可以用来作
 	<application>natd</application> 网关机子的外连 IP 地址，而
 	<systemitem class="ipaddress">128.1.1.2</systemitem> 和
 	<systemitem class="ipaddress">128.1.1.3</systemitem> 用来转发回 LAN 客户端
 	<systemitem>A</systemitem> 和 <systemitem>B</systemitem>。</para>
 
       <para><option>-redirect_address</option> 语法如下：</para>
 
       <programlisting>-redirect_address localIP publicIP</programlisting>
 
 
       <informaltable frame="none" pgwide="1">
         <tgroup cols="2">
           <tbody>
             <row>
               <entry>localIP</entry>
               <entry>LAN 客户端的内部 IP 地址。</entry>
             </row>
             <row>
               <entry>publicIP</entry>
               <entry>相应 LAN 客户端的外部 IP 地址。</entry>
             </row>
           </tbody>
         </tgroup>
       </informaltable>
 
       <para>在这个例子里，参数是：</para>
 
       <programlisting>-redirect_address 192.168.0.2 128.1.1.2 -redirect_address 192.168.0.3 128.1.1.3</programlisting>
 
       <para>象 <option>-redirect_port</option> 一样，这些参数也是放在
 	<filename>/etc/rc.conf</filename> 里的
 	<literal>natd_flags=""</literal> 选项上，
 	或通过一个配置文件传送给它。使用地址重定向，
 	就没有必要用端口重定向了，因为所有在某个 IP
 	地址上收到的数据都被重定向了。</para>
 
       <para>在 <application>natd</application> 机子上的外部 IP
 	地址必须激活并且别名到 (aliased) 外连接口。要这做就看看
 	&man.rc.conf.5;。</para>
 
     </sect2>
   </sect1>
 
   <sect1 xml:id="network-plip">
     <title>并口电缆 IP (PLIP)</title>
 
     <indexterm><primary>PLIP</primary></indexterm>
     <indexterm>
       <primary>并口电缆 IP</primary>
       <see>PLIP</see>
     </indexterm>
 
     <para>PLIP 允许我们在两个并口间运行 TCP/IP。
       在使用笔记本电脑， 或没有网卡的计算机时， 这会非常有用。
       这一节中， 我们将讨论：</para>
 
     <itemizedlist><listitem>
 	<para>制作用于并口的 (laplink) 线缆。</para>
       </listitem>
 
       <listitem>
 	<para>使用 PLIP 连接两台计算机。</para>
       </listitem></itemizedlist>
 
     <sect2 xml:id="network-create-parallel-cable">
       <title>制作并口电缆。</title>
 
       <para>您可以在许多计算机供应店里买到并口电缆。
 	如果买不到， 或者希望自行制作， 则可以参阅下面的表格，
 	它介绍了如何利用普通的打印机并口电缆来改制：</para>
 
       <table frame="none">
 	<title>用于网络连接的并口电缆接线方式</title>
 
 	<tgroup cols="5"><thead><row><entry>A-name</entry>
 
 	      <entry>A 端</entry>
 
 	      <entry>B 端</entry>
 
 	      <entry>描述</entry>
 
 	      <entry>Post/Bit</entry></row></thead>
 
 	  <tbody><row><entry><literallayout>DATA0 -ERROR</literallayout></entry>
 
 	      <entry><literallayout>2 15</literallayout></entry>
 
 	      <entry><literallayout>15 2</literallayout></entry>
 
 	      <entry>数据</entry>
 
 	      <entry><literallayout>0/0x01 1/0x08</literallayout></entry></row>
 
 	    <row><entry><literallayout>DATA1 +SLCT</literallayout></entry>
 
 	      <entry><literallayout>3 13</literallayout></entry>
 
 	      <entry><literallayout>13 3</literallayout></entry>
 
 	      <entry>数据</entry>
 
 	      <entry><literallayout>0/0x02 1/0x10</literallayout></entry></row>
 
 	    <row><entry><literallayout>DATA2 +PE</literallayout></entry>
 
 	      <entry><literallayout>4 12</literallayout></entry>
 
 	      <entry><literallayout>12 4</literallayout></entry>
 
 	      <entry>数据</entry>
 
 	      <entry><literallayout>0/0x04 1/0x20</literallayout></entry></row>
 
 	    <row><entry><literallayout>DATA3 -ACK</literallayout></entry>
 
 	      <entry><literallayout>5 10</literallayout></entry>
 
 	      <entry><literallayout>10 5</literallayout></entry>
 
 	      <entry>脉冲 (Strobe)</entry>
 
 	      <entry><literallayout>0/0x08 1/0x40</literallayout></entry></row>
 
 	    <row><entry><literallayout>DATA4 BUSY</literallayout></entry>
 
 	      <entry><literallayout>6 11</literallayout></entry>
 
 	      <entry><literallayout>11 6</literallayout></entry>
 
 	      <entry>数据</entry>
 
 	      <entry><literallayout>0/0x10 1/0x80</literallayout></entry></row>
 
 	    <row><entry>GND</entry>
 
 	      <entry>18-25</entry>
 
 	      <entry>18-25</entry>
 
 	      <entry>GND</entry>
 
 	      <entry>-</entry></row></tbody></tgroup></table>
     </sect2>
 
     <sect2 xml:id="network-plip-setup">
       <title>设置 PLIP</title>
 
       <para>首先，您需要一根 laplink 线。然后，
 	确认两台计算机的内核都有对 &man.lpt.4;
 	驱动程序的支持：</para>
 
       <screen>&prompt.root; <userinput>grep lp /var/run/dmesg.boot</userinput>
 lpt0: &lt;Printer&gt; on ppbus0
 lpt0: Interrupt-driven port</screen>
 
       <para>并口必须是一个中断驱动的端口， 您应在
 	<filename>/boot/device.hints</filename> 文件中配置：</para>
 
       <programlisting>hint.ppc.0.at="isa"
 hint.ppc.0.irq="7"</programlisting>
 
       <para>然后检查内核配置文件中是否有一行
 	<literal>device plip</literal> 或加载了
 	<filename>plip.ko</filename> 内核模块。
 	这两种情况下， 在使用 &man.ifconfig.8; 命令时都会显示并口对应的网络接口，
 	类似这样：</para>
 
       <screen>&prompt.root; <userinput>ifconfig plip0</userinput>
 plip0: flags=8810&lt;POINTOPOINT,SIMPLEX,MULTICAST&gt; mtu 1500</screen>
 
       <para>用 laplink 线接通两台计算机的并口。</para>
 
       <para>在两边以 <systemitem class="username">root</systemitem> 身份配置通讯参数。
 	例如， 如果你希望将 <systemitem>host1</systemitem> 通过另一台机器 <systemitem>host2</systemitem>
 	连接：</para>
 
       <programlisting>                 host1 &lt;-----&gt; host2
 IP Address    10.0.0.1      10.0.0.2</programlisting>
 
       <para>配置 <systemitem>host1</systemitem> 上的网络接口，照此做：</para>
 
       <screen>&prompt.root; <userinput>ifconfig plip0 10.0.0.1 10.0.0.2</userinput></screen>
 
       <para>配置 <systemitem>host2</systemitem> 上的网络接口，照此做：</para>
 
       <screen>&prompt.root; <userinput>ifconfig plip0 10.0.0.2 10.0.0.1</userinput></screen>
 
 
       <para>您现在应该有个工作的连接了。想要更详细的信息，
 	请阅读 &man.lp.4; 和 &man.lpt.4; 手册页。</para>
 
       <para>您还应该增加两个主机到 <filename>/etc/hosts</filename>：</para>
 
       <programlisting>127.0.0.1               localhost.my.domain localhost
 10.0.0.1                host1.my.domain host1
 10.0.0.2                host2.my.domain host2</programlisting>
 
       <para>要确认连接是否工作，可以到每一台机子上，然后
 	ping 另外一台。例如，在 <systemitem>host1</systemitem> 上：</para>
 
           <screen>&prompt.root; <userinput>ifconfig plip0</userinput>
 plip0: flags=8851&lt;UP,POINTOPOINT,RUNNING,SIMPLEX,MULTICAST&gt; mtu 1500
         inet 10.0.0.1 --&gt; 10.0.0.2 netmask 0xff000000
 &prompt.root; <userinput>netstat -r</userinput>
 Routing tables
 
 Internet:
 Destination        Gateway          Flags     Refs     Use      Netif Expire
 host2              host1            UH          0       0       plip0
 &prompt.root; <userinput>ping -c 4 host2</userinput>
 PING host2 (10.0.0.2): 56 data bytes
 64 bytes from 10.0.0.2: icmp_seq=0 ttl=255 time=2.774 ms
 64 bytes from 10.0.0.2: icmp_seq=1 ttl=255 time=2.530 ms
 64 bytes from 10.0.0.2: icmp_seq=2 ttl=255 time=2.556 ms
 64 bytes from 10.0.0.2: icmp_seq=3 ttl=255 time=2.714 ms
 
 --- host2 ping statistics ---
 4 packets transmitted, 4 packets received, 0% packet loss
 round-trip min/avg/max/stddev = 2.530/2.643/2.774/0.103 ms</screen>
 
     </sect2>
   </sect1>
 
   <sect1 xml:id="network-ipv6">
     <info><title>IPv6</title>
       <authorgroup>
 	<author><personname><firstname>Aaron</firstname><surname>Kaplan</surname></personname><contrib>原始作者：</contrib></author>
       </authorgroup>
       <authorgroup>
 	<author><personname><firstname>Tom</firstname><surname>Rhodes</surname></personname><contrib>重新组织和增加：</contrib></author>
       </authorgroup>
       <authorgroup>
 	<author><personname><firstname>张</firstname><surname>雪平</surname></personname><contrib>中文翻译：</contrib><affiliation>
 	    <address><email>zxpmyth@yahoo.com.cn</email></address>
 	  </affiliation></author>
       </authorgroup>
       <authorgroup>
 	<author><personname><firstname>Brad</firstname><surname>Davis</surname></personname><contrib>Extended by </contrib></author>
       </authorgroup>
 
     </info>
 
     
     <para>IPv6 (也被称作 IPng <quote>下一代 IP</quote>)
       是众所周知的 IP 协议 (也叫
       <acronym>IPv4</acronym>) 的新版本。 和其他现代的 *BSD 系统一样，
       FreeBSD 包含了 KAME 的 IPv6 参考实现。 因此，
       您的 FreeBSD 系统包含了尝试 IPv6 所需要的所有工具。
       这一节主要集中讨论如何配置和使用 IPv6。</para>
 
     <para>在 1990 年代早期， 人们开始担心可用的 IPv4 地址空间在不断地缩小。 随着
       Internet 的爆炸式发展， 主要的两个担心是：</para>
 
     <itemizedlist>
       <listitem>
 	<para>用尽所有的地址。 当然现在这个问题已经不再那样尖锐，
 	  因为 RFC1918 私有地址空间
 	  (<systemitem class="ipaddress">10.0.0.0/8</systemitem>、
 	  <systemitem class="ipaddress">172.16.0.0/12</systemitem>， 以及
 	  <systemitem class="ipaddress">192.168.0.0/16</systemitem>)
 	  和网络地址转换 (<acronym>NAT</acronym>) 技术已经被广泛采用。</para>
       </listitem>
 
       <listitem>
 	<para>路由表条目变得太大。这点今天仍然是焦点。</para>
       </listitem></itemizedlist>
 
     <para>IPv6 解决这些和其它许多的问题：</para>
 
     <itemizedlist><listitem>
 	<para>128 位地址空间。换句话，理论上有
 	  340,282,366,920,938,463,463,374,607,431,768,211,456
 	  个地址可以使用。这意味着在我们的星球上每平方米大约有
 	  6.67 * 10^27 个 IPv6 地址。</para>
       </listitem>
 
       <listitem>
 	<para>路由器仅在它们的路由表里存放网络地址集，
 	  这就减少路由表的平均空间到 8192 个条目。</para>
       </listitem></itemizedlist>
 
     <para>IPv6 还有其它许多有用的功能，如：</para>
 
     <itemizedlist><listitem>
 	<para>地址自动配置 (<link xlink:href="http://www.ietf.org/rfc/rfc2462.txt">RFC2462</link>)</para>
       </listitem>
 
       <listitem>
 	<para>Anycast (任意播) 地址(<quote>一对多</quote>)</para>
       </listitem>
 
       <listitem>
 	<para>强制的多播地址</para>
       </listitem>
 
       <listitem>
 	<para>IPsec (IP 安全)</para>
       </listitem>
 
       <listitem>
 	<para>简单的头结构</para>
       </listitem>
 
       <listitem>
 	<para>移动的 (Mobile) <acronym>IP</acronym></para>
       </listitem>
 
       <listitem>
 	<para>IPv6 到 IPv4 的转换机制</para>
       </listitem>
     </itemizedlist>
 
 
     <para>要更多信息，请查看：</para>
 
     <itemizedlist><listitem>
 	<para>IPv6 概观，在<link xlink:href="http://playground.sun.com/pub/ipng/html/ipng-main.html">
 	  playground.sun.com</link></para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.kame.net">KAME.net</link></para>
       </listitem>
     </itemizedlist>
 
     <sect2>
       <title>关于 IPv6 地址的背景知识</title>
       <para>有几种不同类型的 IPv6 地址：Unicast，Anycast 和 Multicast。</para>
 
       <para>Unicast 地址是为人们所熟知的地址。一个被发送到
 	unicast 地址的包实际上会到达属于这个地址的接口。</para>
 
       <para>Anycast 地址语义上与 unicast 地址没有差别，
 	只是它们强调一组接口。指定为 anycast 地址的包会到达最近的
 	(以路由为单位) 接口。Anycast 地址可能只被路由器使用。</para>
 
       <para>Multicast 地址标识一组接口。指定为 multicast
 	地址的包会到达属于 multicast 组的所有的接口。</para>
 
 	<note><para>IPv4 广播地址 (通常为
 	  <systemitem class="ipaddress">xxx.xxx.xxx.255</systemitem>) 由
 	  IPv6 的 multicast 地址来表示。</para></note>
 
       <table frame="none">
 	<title>保留的 IPv6 地址</title>
 
 	<tgroup cols="4">
 	  <thead>
 	    <row>
 	      <entry>IPv6 地址</entry>
 	      <entry>预定长度 (bits)</entry>
 	      <entry>描述</entry>
 	      <entry>备注</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry><systemitem>::</systemitem></entry>
 	      <entry>128 bits</entry>
 	      <entry>未指定</entry>
 	      <entry>类似 IPv4 中的 <systemitem class="ipaddress">0.0.0.0</systemitem></entry>
 	    </row>
 
 	    <row>
 	      <entry><systemitem>::1</systemitem></entry>
 	      <entry>128 bits</entry>
 	      <entry>环回地址</entry>
 	      <entry>类似 IPv4 中的 <systemitem class="ipaddress">127.0.0.1</systemitem></entry>
 	    </row>
 
 	    <row>
 	      <entry><systemitem>::00:xx:xx:xx:xx</systemitem></entry>
 	      <entry>96 bits</entry>
 	      <entry>嵌入的 IPv4</entry>
 	      <entry>低 32 bits 是 IPv4 地址。这也称作
 		<quote>IPv4 兼容 IPv6
 		地址</quote></entry>
 	    </row>
 
 	    <row>
 	      <entry><systemitem>::ff:xx:xx:xx:xx</systemitem></entry>
 	      <entry>96 bits</entry>
 	      <entry>IPv4 影射的 IPv6 地址</entry>
 	      <entry>低的 32 bits 是 IPv4 地址。 用于那些不支持 IPv6 的主机。</entry>
 	    </row>
 
 	    <row>
 	      <entry><systemitem>fe80::</systemitem> - <systemitem>feb::</systemitem></entry>
 	      <entry>10 bits</entry>
 	      <entry>链路环回</entry>
 	      <entry>类似 IPv4 的环回地址。</entry>
 	    </row>
 
 	    <row>
 	      <entry><systemitem>fec0::</systemitem> - <systemitem>fef::</systemitem></entry>
 	      <entry>10 bits</entry>
 	      <entry>站点环回</entry>
 	      <entry>&nbsp;</entry>
 	    </row>
 
 	    <row>
 	      <entry><systemitem>ff::</systemitem></entry>
 	      <entry>8 bits</entry>
 	      <entry>多播</entry>
 	      <entry>&nbsp;</entry>
 	    </row>
 
 	    <row>
 	      <entry><systemitem>001</systemitem> (base
 		2)</entry>
 	      <entry>3 bits</entry>
 	      <entry>全球多播</entry>
 	      <entry>所有的全球多播地址都指定到这个地址池中。前三个二进制位是
 		<quote>001</quote>。</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
     </sect2>
 
     <sect2>
       <title>IPv6 地址的读法</title>
 
       <para>规范形式被描述为：<systemitem>x:x:x:x:x:x:x:x</systemitem>，
 	每一个<quote>x</quote>就是一个 16 位的 16 进制值。当然，
 	每个十六进制块以三个<quote>0</quote>开始头的也可以省略。如
 	<systemitem>FEBC:A574:382B:23C1:AA49:4592:4EFE:9982</systemitem></para>
 
       <para>通常一个地址会有很长的子串全部为零，
 	因此每个地址的这种子串常被简写为<quote>::</quote>。
 	例如：<systemitem>fe80::1</systemitem>
 	对应的规范形式是
 	<systemitem>fe80:0000:0000:0000:0000:0000:0000:0001</systemitem>。</para>
 
       <para>第三种形式是以众所周知的用点<quote>.</quote>作为分隔符的十进制
 	IPv4 形式，写出最后 32 Bit 的部分。例如
 	<systemitem>2002::10.0.0.1</systemitem>
 	对应的十进制正规表达方式是
 	<systemitem>2002:0000:0000:0000:0000:0000:0a00:0001</systemitem>
 	它也相当于写成
 	<systemitem>2002::a00:1</systemitem>.</para>
 
       <para>到现在，读者应该能理解下面的内容了：</para>
 
       <screen>&prompt.root; <userinput>ifconfig</userinput></screen>
 
       <programlisting>rl0: flags=8943&lt;UP,BROADCAST,RUNNING,PROMISC,SIMPLEX,MULTICAST&gt; mtu 1500
          inet 10.0.0.10 netmask 0xffffff00 broadcast 10.0.0.255
          inet6 fe80::200:21ff:fe03:8e1%rl0 prefixlen 64 scopeid 0x1
          ether 00:00:21:03:08:e1
          media: Ethernet autoselect (100baseTX )
          status: active</programlisting>
 
       <para><systemitem>fe80::200:21ff:fe03:8e1%rl0</systemitem>
 	是一个自动配置的链路环回地址。它作为自动配置的一部分由 MAC 生成。</para>
 
       <para>关于 IPv6 地址的结构的更多信息，请参看 <link xlink:href="http://www.ietf.org/rfc/rfc3513.txt">RFC3513</link>。</para>
     </sect2>
 
     <sect2>
       <title>进行连接</title>
 
       <para>目前，有四种方式可以连接到其它 IPv6 主机和网络：</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>咨询你的互联网服务提供商是否提供 IPv6。</para>
 	</listitem>
 
 	<listitem>
 	  <para><link xlink:href="http://www.sixxs.net">SixXS</link>
 	    向全球范围提供通道。</para>
 	</listitem>
 
 	<listitem>
 	  <para>使用 6-to-4 通道 (<link xlink:href="http://www.ietf.org/rfc/rfc3068.txt">RFC3068</link>)</para>
 	</listitem>
 
 	<listitem>
 	  <para>如果您使用的是拨号连接， 则可以使用 <package>net/freenet6</package> port。</para>
 	</listitem>
       </itemizedlist>
     </sect2>
 
     <sect2>
       <title>IPv6 世界里的 DNS</title>
       <para>对于 IPv6 有两种类型的 DNS 记录：IETF
 	已经宣布 A6 是过时标准；现行的标准是 AAAA 记录。</para>
 
       <para>使用AAAA记录是很简单的。通过增加下面内容，
 	给您的主机分配置您刚才接收到的新的 IPv6 地址：</para>
 
       <programlisting>MYHOSTNAME           AAAA    MYIPv6ADDR</programlisting>
 
       <para>到您的主域 DNS 文件里，就可以完成。要是您自已没有
 	<acronym>DNS</acronym> 域服务，您可以询问您的 <acronym>DNS</acronym>
 	提供商。目前的 <application>bind</application> 版本 (version 8.3 与 9)
 	和 <package>dns/djbdns</package>(含IPv6补丁) 支持 AAAA 记录。</para>
     </sect2>
 
     <sect2>
       <title>在 <filename>/etc/rc.conf</filename> 中进行所需的修改</title>
 
       <sect3>
 	<title>IPv6 客户机设置</title>
 
 	<para>这些设置将帮助您把一台您 LAN 上的机器配置为一台客户机， 而不是路由器。
 	  要让 &man.rtsol.8; 在启动时自动配置您的网卡， 只需添加：</para>
 
 	<programlisting>ipv6_enable="YES"</programlisting>
 
 	<para>要自动地静态指定 IP 地址， 例如 <systemitem>
 	  2001:471:1f11:251:290:27ff:fee0:2093</systemitem>， 到
 	  <filename>fxp0</filename> 上， 则写上：</para>
 
 	<programlisting>ipv6_ifconfig_fxp0="2001:471:1f11:251:290:27ff:fee0:2093"</programlisting>
 
 	<para>要指定
 	  <systemitem>2001:471:1f11:251::1</systemitem>
 	  作为默认路由， 需要在 <filename>/etc/rc.conf</filename> 中加入：</para>
 
 	<programlisting>ipv6_defaultrouter="2001:471:1f11:251::1"</programlisting>
 
       </sect3>
 
       <sect3>
 	<title>IPv6 路由器/网关配置</title>
 
 	<para>这将帮助您从隧道提供商那里取得必要的资料，
 	  并将这些资料转化为在重启时能够保持住的设置。 要在启动时恢复您的隧道，
 	  需要在 <filename>/etc/rc.conf</filename> 中增加：</para>
 
 	<para>列出要配置的通用隧道接口， 例如
 	  <filename>gif0</filename>：</para>
 
 	<programlisting>gif_interfaces="gif0"</programlisting>
 
 	<para>配置该接口使用本地端地址
 	  <replaceable>MY_IPv4_ADDR</replaceable> 和远程端地址
 	  <replaceable>REMOTE_IPv4_ADDR</replaceable>：</para>
 
 	<programlisting>gifconfig_gif0="<replaceable>MY_IPv4_ADDR REMOTE_IPv4_ADDR</replaceable>"</programlisting>
 
 	<para>应用分配给您用于 IPv6 隧道远端的 IPv6
 	  地址， 需要增加：</para>
 
 	<programlisting>ipv6_ifconfig_gif0="<replaceable>MY_ASSIGNED_IPv6_TUNNEL_ENDPOINT_ADDR</replaceable>"</programlisting>
 
 	<para>此后十设置 IPv6 的默认路由。 这是 IPv6 隧道的另一端：</para>
 
 	<programlisting>ipv6_defaultrouter="<replaceable>MY_IPv6_REMOTE_TUNNEL_ENDPOINT_ADDR</replaceable>"</programlisting>
 
       </sect3>
 
       <sect3>
 	<title>IPv6 隧道配置</title>
 
 	<para>如果服务器将您的网络通过 IPv6 路由到世界的其他角落，
 	  您需要在 <filename>/etc/rc.conf</filename>
 	  中添加下面的配置：</para>
 
 	<programlisting>ipv6_gateway_enable="YES"</programlisting>
 
       </sect3>
     </sect2>
 
     <sect2>
       <title>路由宣告和主机自动配置</title>
 
       <para>这节将帮助您配置 &man.rtadvd.8; 来宣示默认的
 	IPv6 路由。</para>
 
       <para>要启用 &man.rtadvd.8; 您需要在
 	<filename>/etc/rc.conf</filename> 中添加：</para>
 
       <programlisting>rtadvd_enable="YES"</programlisting>
 
       <para>指定由哪个网络接口来完成
 	IPv6 路由请求非常重要。 举例来说， 让 &man.rtadvd.8; 使用
 	<filename>fxp0</filename>：</para>
 
       <programlisting>rtadvd_interfaces="fxp0"</programlisting>
 
       <para>接下来我们需要创建配置文件，
 	<filename>/etc/rtadvd.conf</filename>。 示例如下：</para>
 
       <programlisting>fxp0:\
 	:addrs#1:addr="2001:471:1f11:246::":prefixlen#64:tc=ether:</programlisting>
 
       <para>将 <filename>fxp0</filename> 改为您打算使用的接口名。</para>
 
       <para>接下来， 将 <systemitem>2001:471:1f11:246::</systemitem>
 	改为分配给您的地址前缀。</para>
 
       <para>如果您拥有专用的 <systemitem class="netmask">/64</systemitem> 子网，
 	则不需要修改其他设置。 反之， 您需要把
 	<literal>prefixlen#</literal> 改为正确的值。</para>
 
    </sect2>
   </sect1>
 <sect1 xml:id="network-atm">
     <info><title>异步传输模式 (ATM)</title>
       <authorgroup>
 	<author><personname><firstname>Harti</firstname><surname>Brandt</surname></personname><contrib>贡献者：</contrib></author>
       </authorgroup>
       <authorgroup>
 	<author><personname><firstname>张</firstname><surname>雪平</surname></personname><contrib>中文翻译：</contrib><affiliation>
 	    <address><email>zxpmyth@yahoo.com.cn</email></address>
 	  </affiliation></author>
       </authorgroup>
     </info>
 
     
 
     <sect2>
       <title>配置 classical IP over ATM (PVCs)</title>
 
       <para>Classical IP over ATM (<acronym>CLIP</acronym>)
 	是一种最简单的使用带 IP 的 ATM 的方法。
 	这种方法可以用在交换式连接 (SVC) 和永久连接
 	(PVC) 上。这部分描述的就是配置基于 PVC 的网络。</para>
 
       <sect3>
 	<title>完全互连的配置</title>
 
 	<para>第一种使用PVC来设置 <acronym>CLIP</acronym>
 	  的方式就是通过专用的 PVC 让网络里的每一台机子都互连在一起。
 	  尽管这样配置起来很简单，但对于数量更多一点的机子来说就有些不切实际了。
 	  例如我们有四台机子在网络里，每一台都使用一张 ATM 适配器卡连接到 ATM
 	  网络。第一步就是规划 IP 地址和机子间的 ATM 连接。我们使用下面的：</para>
 
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="2">
 	    <colspec colwidth="1*"/>
 	    <colspec colwidth="1*"/>
 	    <thead>
 	      <row>
 		<entry>主机</entry>
 		<entry>IP 地址</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><systemitem>hostA</systemitem></entry>
 		<entry><systemitem class="ipaddress">192.168.173.1</systemitem></entry>
 	      </row>
 
 	      <row>
 		<entry><systemitem>hostB</systemitem></entry>
 		<entry><systemitem class="ipaddress">192.168.173.2</systemitem></entry>
 	      </row>
 
 	      <row>
 		<entry><systemitem>hostC</systemitem></entry>
 		<entry><systemitem class="ipaddress">192.168.173.3</systemitem></entry>
 	      </row>
 
 	      <row>
 		<entry><systemitem>hostD</systemitem></entry>
 		<entry><systemitem class="ipaddress">192.168.173.4</systemitem></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
 
 	<para>为了建造完全交错的网络，我们需要在第一对机子间有一个 ATM 连接：</para>
 
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="2">
 	    <colspec colwidth="1*"/>
 	    <colspec colwidth="1*"/>
 	    <thead>
 	      <row>
 		<entry>机器</entry>
 		<entry>VPI.VCI 对</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><systemitem>hostA</systemitem> - <systemitem>hostB</systemitem></entry>
 		<entry>0.100</entry>
 	      </row>
 
 	      <row>
 		<entry><systemitem>hostA</systemitem> - <systemitem>hostC</systemitem></entry>
 		<entry>0.101</entry>
 	      </row>
 
 	      <row>
 		<entry><systemitem>hostA</systemitem> - <systemitem>hostD</systemitem></entry>
 		<entry>0.102</entry>
 	      </row>
 
 	      <row>
 		<entry><systemitem>hostB</systemitem> - <systemitem>hostC</systemitem></entry>
 		<entry>0.103</entry>
 	      </row>
 
 	      <row>
 		<entry><systemitem>hostB</systemitem> - <systemitem>hostD</systemitem></entry>
 		<entry>0.104</entry>
 	      </row>
 
 	      <row>
 		<entry><systemitem>hostC</systemitem> - <systemitem>hostD</systemitem></entry>
 		<entry>0.105</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
 
 
 	<para>在每一个连接端 VPI 和 VCI 的值都可能会不同，
 	  只是为了简单起见，我们假定它们是一样的。
 	  下一步我们需要配置每一个主机上的 ATM 接口：</para>
 
 	<screen>hostA&prompt.root; <userinput>ifconfig hatm0 192.168.173.1 up</userinput>
 hostB&prompt.root; <userinput>ifconfig hatm0 192.168.173.2 up</userinput>
 hostC&prompt.root; <userinput>ifconfig hatm0 192.168.173.3 up</userinput>
 hostD&prompt.root; <userinput>ifconfig hatm0 192.168.173.4 up</userinput></screen>
 
 	<para>假定所有主机上的 ATM 接口都是 <filename>hatm0</filename>。
 	  现在 PVC 需要配置到 <systemitem>hostA</systemitem> 上
 	  (我们假定它们都已经配置在了 ATM 交换机上，至于怎么做的，
 	  您就需要参考一下该交换机的手册了)。</para>
 
 	<screen>hostA&prompt.root; <userinput>atmconfig natm add 192.168.173.2 hatm0 0 100 llc/snap ubr</userinput>
 hostA&prompt.root; <userinput>atmconfig natm add 192.168.173.3 hatm0 0 101 llc/snap ubr</userinput>
 hostA&prompt.root; <userinput>atmconfig natm add 192.168.173.4 hatm0 0 102 llc/snap ubr</userinput>
 
 hostB&prompt.root; <userinput>atmconfig natm add 192.168.173.1 hatm0 0 100 llc/snap ubr</userinput>
 hostB&prompt.root; <userinput>atmconfig natm add 192.168.173.3 hatm0 0 103 llc/snap ubr</userinput>
 hostB&prompt.root; <userinput>atmconfig natm add 192.168.173.4 hatm0 0 104 llc/snap ubr</userinput>
 
 hostC&prompt.root; <userinput>atmconfig natm add 192.168.173.1 hatm0 0 101 llc/snap ubr</userinput>
 hostC&prompt.root; <userinput>atmconfig natm add 192.168.173.2 hatm0 0 103 llc/snap ubr</userinput>
 hostC&prompt.root; <userinput>atmconfig natm add 192.168.173.4 hatm0 0 105 llc/snap ubr</userinput>
 
 hostD&prompt.root; <userinput>atmconfig natm add 192.168.173.1 hatm0 0 102 llc/snap ubr</userinput>
 hostD&prompt.root; <userinput>atmconfig natm add 192.168.173.2 hatm0 0 104 llc/snap ubr</userinput>
 hostD&prompt.root; <userinput>atmconfig natm add 192.168.173.3 hatm0 0 105 llc/snap ubr</userinput></screen>
 
 	<para>当然，除 UBR 外其它的通信协定也可让 ATM 适配器支持这些。
 	  此种情况下，通信协定的名字要跟人通信参数后边。工具
 	  &man.atmconfig.8; 的帮助可以这样得到：</para>
 
 	<screen>&prompt.root; <userinput>atmconfig help natm add</userinput></screen>
 
 	<para>或者在 &man.atmconfig.8; 手册页里得到。</para>
 
 	<para>相同的配置也可以通过 <filename>/etc/rc.conf</filename>
 	  来完成。对于 <systemitem>hostA</systemitem>，看起来就象这样：</para>
 
 <programlisting>network_interfaces="lo0 hatm0"
 ifconfig_hatm0="inet 192.168.173.1 up"
 natm_static_routes="hostB hostC hostD"
 route_hostB="192.168.173.2 hatm0 0 100 llc/snap ubr"
 route_hostC="192.168.173.3 hatm0 0 101 llc/snap ubr"
 route_hostD="192.168.173.4 hatm0 0 102 llc/snap ubr"</programlisting>
 
 	<para>所有 <acronym>CLIP</acronym> 路由的当前状态可以使用如下命令获得：</para>
 
 	<screen>hostA&prompt.root; <userinput>atmconfig natm show</userinput></screen>
       </sect3>
     </sect2>
   </sect1>
 
   <sect1 xml:id="carp">
     <info><title>Common Address Redundancy Protocol (CARP， 共用地址冗余协议)</title>
       <authorgroup>
 	<author><personname><firstname>Tom</firstname><surname>Rhodes</surname></personname><contrib>原作 </contrib></author>
       </authorgroup>
     </info>
     
 
     <indexterm><primary>CARP</primary></indexterm>
     <indexterm><primary>Common Address Redundancy Protocol, 共用地址冗余协议</primary></indexterm>
 
     <para>Common Address Redundancy Protocol， 或简称
       <acronym>CARP</acronym> 能够使多台主机共享同一
       <acronym>IP</acronym> 地址。 在某些配置中， 这样做可以提高可用性，
       或实现负载均衡。 下面的例子中， 这些主机也可以同时使用其他的不同的
       <acronym>IP</acronym> 地址。</para>
 
     <para>要启用 <acronym>CARP</acronym> 支持， 必须在 &os;
       内核配置中增加下列选项， 并按照 <xref linkend="kernelconfig"/>
       章节介绍的方法重新联编内核：</para>
 
     <programlisting>device	carp</programlisting>
 
     <para>另外的一个方法是在启动时加载
       <filename>if_carp.ko</filename> 模块。
       把如下的这行加入到 <filename>/boot/loader.conf</filename>：</para>
 
     <programlisting>if_carp_load="YES"</programlisting>
 
     <para>这样就可以使用 <acronym>CARP</acronym> 功能了，
       一些具体的参数， 可以通过一系列 <command>sysctl</command>
       <acronym>OID</acronym> 来调整。</para>
 
     <informaltable frame="none" pgwide="1">
       <tgroup cols="2">
         <thead>
           <row>
             <entry>OID</entry>
 	    <entry>描述</entry>
           </row>
         </thead>
 
         <tbody>
           <row>
             <entry><varname>net.inet.carp.allow</varname></entry>
 	    <entry>接受进来的 <acronym>CARP</acronym> 包。
 	      默认启用。</entry>
           </row>
 
           <row>
             <entry><varname>net.inet.carp.preempt</varname></entry>
 	    <entry>当主机中有一个 <acronym>CARP</acronym> 网络接口失去响应时，
 	      这个选项将停止这台主机上所有的 <acronym>CARP</acronym>
 	      接口。 默认禁用。</entry>
           </row>
 
           <row>
             <entry><varname>net.inet.carp.log</varname></entry>
 	    <entry>当值为 <literal>0</literal> 表示禁止记录所有日志。
 	      值为 <literal>1</literal> 表示记录损坏的 <acronym>CARP</acronym>
 	      包。任何大于 <literal>1</literal> 表示记录 <acronym>CARP</acronym>
 	      网络接口的状态变化。默认值为 <literal>1</literal>。</entry>
           </row>
 
           <row>
             <entry><varname>net.inet.carp.arpbalance</varname></entry>
 	    <entry>使用 <acronym>ARP</acronym> 均衡本地网络流量。
 	      默认禁用。</entry>
           </row>
 
           <row>
             <entry><varname>net.inet.carp.suppress_preempt</varname></entry>
 	    <entry>此只读 <acronym>OID</acronym> 显示抑制抢占的状态。
 	      如果一个接口上的连接失去响应, 则抢占会被抑制。
 	      当这个变量的值为 <literal>0</literal> 时，表示抢占未被抑制。
 	      任何问题都会使 <acronym>OID</acronym> 递增。</entry>
           </row>
         </tbody>
       </tgroup>
     </informaltable>
 
     <para><acronym>CARP</acronym> 设备可以通过 <command>ifconfig</command>
       命令来创建。</para>
 
     <screen>&prompt.root; <userinput>ifconfig carp0 create</userinput></screen>
 
     <para>在真实环境中， 这些接口需要一个称作 <acronym>VHID</acronym> 的标识编号。 这个
       <acronym>VHID</acronym> 或 Virtual Host Identification (虚拟主机标识)
       用于在网络上区分主机。</para>
 
     <sect2>
       <title>使用 CARP 来改善服务的可用性 (CARP)</title>
 
       <para>如前面提到的那样， <acronym>CARP</acronym> 的作用之一是改善服务的可用性。
 	这个例子中， 将为三台主机提供故障转移服务， 这三台服务器各自有独立的 <acronym>IP</acronym>
 	地址， 并提供完全一样的 web 内容。 三台机器以 <acronym>DNS</acronym>
 	轮询的方式提供服务。 用于故障转移的机器有两个
 	<acronym>CARP</acronym> 接口，
 	分别配置另外两台服务器的 <acronym>IP</acronym> 地址。
 	当有服务器发生故障时， 这台机器会自动得到故障机的
 	<acronym>IP</acronym> 地址。 这样以来，
 	用户就完全感觉不到发生了故障。 故障转移的服务器提供的内容和服务，
 	应与其为之提供热备份的服务器一致。</para>
 
       <para>两台机器的配置， 除了主机名和 <acronym>VHID</acronym> 之外应完全一致。
 	在我们的例子中， 这两台机器的主机名分别是
 	<systemitem>hosta.example.org</systemitem> 和
 	<systemitem>hostb.example.org</systemitem>。 首先，
 	需要将 <acronym>CARP</acronym> 配置加入到 <filename>rc.conf</filename>。 对于
 	<systemitem>hosta.example.org</systemitem> 而言，
 	<filename>rc.conf</filename> 文件中应包含下列配置：</para>
 
       <programlisting>hostname="hosta.example.org"
 ifconfig_fxp0="inet 192.168.1.3 netmask 255.255.255.0"
 cloned_interfaces="carp0"
 ifconfig_carp0="vhid 1 pass testpass 192.168.1.50/24"</programlisting>
 
       <para>在 <systemitem>hostb.example.org</systemitem> 上，
 	对应的 <filename>rc.conf</filename> 配置则是：</para>
 
       <programlisting>hostname="hostb.example.org"
 ifconfig_fxp0="inet 192.168.1.4 netmask 255.255.255.0"
 cloned_interfaces="carp0"
 ifconfig_carp0="vhid 2 pass testpass 192.168.1.51/24"</programlisting>
 
       <note>
 	<para>在两台机器上由 <command>ifconfig</command> 的
 	  <option>pass</option> 选项指定的密码必须是一致的，
 	  这一点非常重要。 <filename>carp</filename> 设备只会监听和接受来自持有正确密码的机器的公告。
 	  此外， 不同虚拟主机的 <acronym>VHID</acronym> 必须不同。</para>
       </note>
 
       <para>第三台机器，
 	<systemitem>provider.example.org</systemitem> 需要进行配置，
 	以便在另外两台机器出现问题时接管。 这台机器需要两个 <filename>carp</filename>
 	设备， 分别处理两个机器。 对应的 <filename>rc.conf</filename>
 	配置类似下面这样：</para>
 
       <programlisting>hostname="provider.example.org"
 ifconfig_fxp0="inet 192.168.1.5 netmask 255.255.255.0"
 cloned_interfaces="carp0 carp1"
 ifconfig_carp0="vhid 1 advskew 100 pass testpass 192.168.1.50/24"
 ifconfig_carp1="vhid 2 advskew 100 pass testpass 192.168.1.51/24"</programlisting>
 
       <para>配置两个 <filename>carp</filename> 设备，
         能够让 <systemitem>provider.example.org</systemitem> 在两台机器中的任何一个停止响应时，
 	立即接管其 <acronym>IP</acronym> 地址。</para>
 
       <note>
         <para>默认的 &os; 内核 <emphasis>可能</emphasis> 启用了主机间抢占。
 	  如果是这样的话，
 	  <systemitem>provider.example.org</systemitem> 可能在正式的内容服务器恢复时不释放
 	  <acronym>IP</acronym> 地址。 此时， 管理员必须手工强制 IP
 	  回到原来内容服务器。 具体做法是在
 	  <systemitem>provider.example.org</systemitem> 上使用下面的命令：</para>
 
 	<screen>&prompt.root; <userinput>ifconfig carp0 down &amp;&amp; ifconfig carp0 up</userinput></screen>
 
 	<para>这个操作需要在与出现问题的主机对应的那个 <filename>carp</filename>
 	  接口上进行。</para>
       </note>
 
       <para>现在您已经完成了 <acronym>CARP</acronym> 的配置， 并可以开始测试了。
 	测试过程中， 可以随时重启或切断两台机器的网络。</para>
 
       <para>如欲了解更多细节， 请参见 &man.carp.4;
         联机手册。</para>
     </sect2>
   </sect1>
 </chapter>
diff --git a/zh_CN.UTF-8/books/handbook/audit/chapter.xml b/zh_CN.UTF-8/books/handbook/audit/chapter.xml
index 3a3ecbc6c4..aab66b71f6 100644
--- a/zh_CN.UTF-8/books/handbook/audit/chapter.xml
+++ b/zh_CN.UTF-8/books/handbook/audit/chapter.xml
@@ -1,602 +1,602 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      The FreeBSD Documentation Project
      The FreeBSD Simplified Chinese Project
 
-     Original Revision: r36653
+     Original Revision: fffad858e3 (r36653)
      $FreeBSD$
 -->
 <!-- Need more documentation on praudit, auditreduce, etc.  Plus more info
 on the triggers from the kernel (log rotation, out of space, etc).
 And the /dev/audit special file if we choose to support that.  Could use
 some coverage of integrating MAC with Event auditing and perhaps discussion
 on how some companies or organizations handle auditing and auditing
 requirements. -->
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="audit">
   <info><title>安全事件审计</title>
     <authorgroup>
       <author><personname><firstname>Tom</firstname><surname>Rhodes</surname></personname><contrib>原作 </contrib></author>
       <author><personname><firstname>Robert</firstname><surname>Watson</surname></personname></author>
     </authorgroup>
   </info>
 
   
 
   <sect1 xml:id="audit-synopsis">
     <title>概述</title>
 
     <indexterm><primary>AUDIT</primary></indexterm>
     <indexterm>
       <primary>安全事件审计</primary>
       <see>MAC</see>
     </indexterm>
 
     <para>&os; 中包含了对于细粒度安全事件审计的支持。
       事件审计能够支持可靠的、 细粒度且可配置的， 对于各类与安全有关的系统事件，
       包括登录、 配置变更， 以及文件和网络访问等的日志记录。
       这些日志记录对于在正在运行的系统上实施监控、
       入侵检测和事后分析都十分重要。 &os; 实现了 Sun 所发布的
       <acronym>BSM</acronym> API 和文件格式，
       并且与 &sun; 的 &solaris; 和 &apple; 的 &macos; X 审计实现兼容。</para>
 
     <para>这一章的重点是安装和配置事件审计。 它介绍了事件策略， 并提供了一个审计的配置例子。</para>
 
     <para>读完这章， 您将了解：</para>
 
     <itemizedlist>
       <listitem>
         <para>事件审计是什么， 以及它如何工作。</para>
       </listitem>
 
       <listitem>
 	<para>如何在 &os; 上为用户和进程配置事件审计。</para>
       </listitem>
 
       <listitem>
 	<para>如何使用审计记录摘要和复审工具来对审计记录进行复审。</para>
       </listitem>
     </itemizedlist>
 
     <para>阅读这章之前， 您应该：</para>
 
     <itemizedlist>
       <listitem>
 	<para>理解 &unix; 和 &os; 的基础知识
 	  (<xref linkend="basics"/>)。</para>
       </listitem>
 
       <listitem>
 	<para>熟悉关于内核配置和编译的基本方法
 	  (<xref linkend="kernelconfig"/>)。</para>
       </listitem>
 
       <listitem>
 	<para>熟悉安全知识以及如何在 &os; 运用它们 (<xref linkend="security"/>)。</para>
       </listitem>
     </itemizedlist>
 
     <warning>
       <para>审计机制中存在一些已知的限制，
 	例如并不是所有与安全有关的系统事件都可以审计，
 	另外某些登录机制， 例如基于 X11 显示管理器，
 	以及第三方服务的登录机制， 都不会在用户的登录会话中正确配置审计。</para>
 
       <para>安全审计机制能够对系统活动生成非常详细的记录信息： 在繁忙的系统中，
 	记帐数据如果配置不当会非常的大， 并在一周内迅速超过几个 GB 的尺寸。
 	管理员应考虑审计配置中的导致磁盘空间需求的这些问题。 例如，
 	可能需要为 <filename>/var/audit</filename> 目录单独分配一个文件系统，
 	以防止在审计日志所用的文件系统被填满时影响其它文件系统。</para>
     </warning>
 
   </sect1>
 
   <sect1 xml:id="audit-inline-glossary">
     <title>本章中的一些关键术语</title>
 
     <para>在开始阅读这章之前， 我们需要解释一下与审计有关的一些关键的术语：</para>
 
     <itemizedlist>
       <listitem>
 	<para><emphasis>事件 (event)</emphasis>：
 	  可审计事件是指能够被审计子系统记录的任何事件。
 	  举例说来， 与安全有关的事件包括创建文件、
 	  建立网络连接， 以及以某一用户身份登录， 等等。
 	  任何事件必要么是 <quote>有主 (attributable)</quote> 的，
 	  即可以最终归于某一已通过验证的用户的身份， 反之， 则称该事件是
 	  <quote>无主 (non-attributable)</quote> 的。
 	  无主事件可以是发生在登录过程成功之前的任何事件， 例如尝试一次无效密码等。</para>
       </listitem>
 
       <listitem>
         <para><emphasis>类 (class)</emphasis>： 事件类是指相关事件的一个命名集合，
 	  通常在筛选表达式中使用。 常用的事件类包括 <quote>创建文件</quote> (fc)、
 	  <quote>执行</quote> (ex) 和 <quote>登入和注销</quote>
 	  (lo)。</para>
       </listitem>
 
       <listitem>
 	<para><emphasis>记录 (record)</emphasis>： 记录是指描述一个安全事件的日志项。
 	  记录包括记录事件类型、 执行操作的主体 (用户) 信息、
 	  日期和事件信息， 以及与之相关的对象或参数信息， 最后是操作成功或失败。</para>
       </listitem>
 
       <listitem>
 	<para><emphasis>账目 (trail)</emphasis>： 审计账目， 或日志文件，
 	  包含了一系列描述安全事件的审计记录。 典型情况下，
 	  审计账目基本上是以事件发生的时间顺序记录的。 只有获得授权的进程，
 	  才能够向审计账目中提交记录。</para>
       </listitem>
 
       <listitem>
 	<para><emphasis>筛选表达式 (selection expression)</emphasis>：
 	  筛选表达式是包含一系列前缀和审计事件类名字，
 	  用以匹配事件的字符串。</para>
       </listitem>
 
       <listitem>
 	<para><emphasis>预选 (preselection)</emphasis>： 系统通过这一过程来识别事件是否是管理员所感兴趣的，
 	  从而避免为他们不感兴趣的事件生成记录。 预选配置使用一系列选择表达式，
 	  用以识别事件类别、 要审计的用户， 以及适用于验证过用户身份， 以及未验证用户身份的进程的全局配置。</para>
       </listitem>
 
       <listitem>
 	<para><emphasis>浓缩 (reduction)</emphasis>： 从现有的审计记帐中筛选出用于保留、
 	  打印或分析的过程。 除此之外， 它也表示从审计记帐中删去不需要的审计记录的过程。
 	  通过使用浓缩操作， 管理员可以实现预留审计数据的策略。 例如， 详细的审计记帐信息，
 	  可能会保留一个月之久， 但在这之后， 则对这些记帐信息执行浓缩操作，
 	  只保留登录信息用于存档。</para>
       </listitem>
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="audit-install">
     <title>安装审计支持</title>
 
     <para>对于事件审计的支持， 已经随标准的 <buildtarget>installworld</buildtarget>
       过程完成。 管理员可以通过查看
       <filename>/etc/security</filename> 的内容来确认这一点。
       您应能看到一些名字以 <emphasis>audit</emphasis> 开头的文件，
       例如 <filename>audit_event</filename>。</para>
 
     <para>对于审计功能的用户态支持目前是作为 &os; 基本系统的一部分来安装的。
       默认内核中也包含了对于事件审计的内核支持， 但如果您使用的是定制内核，
       就必须在内核配置文件中明确指定希望添加这一支持：</para>
 
     <programlisting>options	AUDIT</programlisting>
 
     <para>接下来， 您应按照
       <xref linkend="kernelconfig"/> 中所介绍的步骤来完成一次内核的编译和安装。</para>
 
     <para>在编译好并安装了内核， 并重新启动了系统之后， 就可以在
       &man.rc.conf.5; 中增加下列配置来启用审计服务了：</para>
 
     <para>在编译、安装了开启审计功能的内核，并重新启动计算机之后，
       就可以在 &man.rc.conf.5; 中增加下列配置来启用审计服务了：</para>
 
     <programlisting>auditd_enable="YES"</programlisting>
 
     <para>此后， 必须重新启动系统， 或通过下面的命令手工启动审计服务来启动审计支持：</para>
 
     <programlisting>/etc/rc.d/auditd start</programlisting>
   </sect1>
 
   <sect1 xml:id="audit-config">
     <title>对审计进行配置</title>
 
     <para>所有用于安全审计的配置文件， 都可以在
       <filename>/etc/security</filename> 找到。
       要启动审计服务， 下面这些文件必须存在：</para>
 
     <itemizedlist>
       <listitem>
 	<para><filename>audit_class</filename> - 包含对于审计类的定义。</para>
       </listitem>
 
       <listitem>
 	<para><filename>audit_control</filename> - 控制审计子系统的特性，
 	  例如默认审计类、 在审计日志所在的卷上保留的最小空间、
 	  审计日志的最大尺寸， 等等。</para>
       </listitem>
 
       <listitem>
 	<para><filename>audit_event</filename> - 文字化的系统审计事件名称和描述，
 	  以及每个事件属于哪个类别。</para>
       </listitem>
 
       <listitem>
 	<para><filename>audit_user</filename> - 针对特定用户的审计需求，
 	  这些配置在登录时会与全局的默认值合并。</para>
       </listitem>
 
       <listitem>
 	<para><filename>audit_warn</filename> - 由 <application>auditd</application> 调用的一个可定制的 shell
 	  脚本， 用于在意外情况， 如用于审计日志的空间过少， 或审计日志文件被翻转时，
 	  生成警告信息。</para>
       </listitem>
     </itemizedlist>
 
     <warning>
       <para>在编辑和维护审计配置文件时一定要小心， 因为配置文件中的错误会导致记录事件不正确。</para>
     </warning>
 
     <sect2>
       <title>事件筛选表达式</title>
 
       <para>在审计配置文件中的许多地方会用到筛选表达式来确定哪些事件是需要审计的。
 	表达式中需要指定要匹配的事件类型， 并使用前缀指定是否应接受或忽略匹配的事件，
 	此外， 还可以指定一个可选项指明匹配成功或失败的操作。
 	选择表达式是按从左到右的顺序计算的， 而对于两个表达式的情形，
 	则是通过将后一个追加到前一个之后来实现的。</para>
 
       <para>下面列出了在 <filename>audit_class</filename> 中的默认事件类型：</para>
 
       <itemizedlist>
 	<listitem>
 	  <para><literal>all</literal> - <emphasis>all (全部)</emphasis> - 表示匹配全部事件类。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>ad</literal> - <emphasis>administrative (管理)</emphasis>
 	    - 所有在系统上所进行的管理性操作。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>ap</literal> - <emphasis>application (应用)</emphasis> -
 	    应用程序定义的动作。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>cl</literal> - <emphasis>file close (文件关闭)</emphasis> -
 	    审计对 <function>close</function> 系统调用的操作。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>ex</literal> - <emphasis>exec (执行)</emphasis> - 审计程序的执行。
 	    对于命令行参数和环境变量的审计是通过在 &man.audit.control.5;
 	    中 <literal>policy</literal> 的 <literal>argv</literal> 和 <literal>envv</literal>
 	    参数来控制的。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>fa</literal> - <emphasis>file attribute access (造访文件属性)</emphasis>
 	    - 审计访问对象属性， 例如
 	    &man.stat.1;、 &man.pathconf.2; 以及类似事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>fc</literal> - <emphasis>file create (创建文件)</emphasis>
 	    - 审计创建了文件的事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>fd</literal> - <emphasis>file delete (删除文件)</emphasis>
 	    - 审计所发生的文件删除事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>fm</literal> - <emphasis>file attribute modify (修改文件属性)</emphasis>
 	    - 审计文件属性发生变化的事件，
 	    例如 &man.chown.8;、 &man.chflags.1;、 &man.flock.2;，
 	    等等。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>fr</literal> - <emphasis>file read (读文件数据)</emphasis>
 	    - 审计读取数据、 文件以读方式打开等事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>fw</literal> - <emphasis>file write (写文件数据)</emphasis> -
 	    审计写入数据、 文件以写方式打开等事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>io</literal> - <emphasis>ioctl</emphasis> -
 	    审计对 &man.ioctl.2; 系统调用的使用。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>ip</literal> - <emphasis>ipc</emphasis> - 审计各种形式的进程间通信 (IPC)，
 	    包括 POSIX 管道和 System V <acronym>IPC</acronym> 操作。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>lo</literal> - <emphasis>login_logout</emphasis> -
 	    审计系统中发生的 &man.login.1; 和 &man.logout.1; 事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>na</literal> - <emphasis>non attributable (无主)</emphasis> -
 	    审计无法归类的事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>no</literal> - <emphasis>invalid class (无效类)</emphasis> -
 	    表示不匹配任何事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>nt</literal> - <emphasis>network (网络)</emphasis> -
 	    与网络操作有关的事件， 例如
 	    &man.connect.2; 和 &man.accept.2;。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>ot</literal> - <emphasis>other (其它)</emphasis> -
 	    审计各类杂项事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>pc</literal> - <emphasis>process (进程)</emphasis> -
 	    审计进程操作， 例如 &man.exec.3; 和
 	    &man.exit.3;。</para>
 	</listitem>
 
       </itemizedlist>
 
       <para>这些审计事件， 可以通过修改
 	<filename>audit_class</filename> 和
 	<filename>audit_event</filename> 这两个配置文件来进行定制。</para>
 
       <para>这个列表中， 每个审计类均包含一个表示匹配成功/失败操作的前缀，
 	以及这一项是否是增加或删去对事件类或类型的匹配。</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>(none) 审计事件的成功和失败实例。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>+</literal> 审计这一类的成功事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>-</literal> 审计这一类的失败事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>^</literal> 不审计本类中的成功或失败事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>^+</literal> 不审计本类中的成功事件。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>^-</literal> 不审计本类中的失败事件。</para>
 	</listitem>
 
       </itemizedlist>
 
       <para>下面例子中的筛选字符串表示筛选成功和失败的登录/注销事件，
 	而对执行事件， 则只审计成功的：</para>
 
       <programlisting>lo,+ex</programlisting>
 
     </sect2>
 
     <sect2>
       <title>配置文件</title>
 
       <para>多数情况下， 在配置审计系统时，
 	管理员只需修改两个文件： <filename>audit_control</filename>
 	和 <filename>audit_user</filename>。 前者控制系统级的审计属性和策略，
 	而后者则用于针对具体的用户来微调。</para>
 
       <sect3 xml:id="audit-auditcontrol">
         <title><filename>audit_control</filename> 文件</title>
 
 	<para><filename>audit_control</filename> 文件指定了一系列用于审计子系统的默认设置。
 	  通过查看这个文件， 我们可以看到下面的内容：</para>
 
 	<programlisting>dir:/var/audit
 flags:lo
 minfree:20
 naflags:lo
 policy:cnt
 filesz:0</programlisting>
 
 	<para>这里的 <option>dir</option> 选项可以用来设置用于保存审计日志的一个或多个目录。
 	  如果指定了多个目录， 则将在填满一个之后换用下一个。 一般而言，
 	  审计通常都会配置为保存在一个专用的文件系统之下，
 	  以避免审计系统与其它子系统在文件系统满的时候所产生的冲突。
 	  </para>
 
 	<para><option>flags</option> 字段用于为有主事件配置系统级的预选条件。
 	  在前面的例子中， 所有用户成功和失败的登录和注销都会被审计。</para>
 
 	<para><option>minfree</option> 参数用于定义保存审计日志的文件系统上剩余空间的最小百分比。
 	  当超过这一阈值时， 将产生一个警告。 前面的例子中， 最小剩余空间比例设置成了两成。</para>
 
 	<para><option>naflags</option> 选项表示审计类审计无主事件，
 	  例如作为登录进程和系统服务的那些进程的事件。</para>
 
 	<para><option>policy</option> 选项用于指定一个以逗号分隔的策略标志表，
 	  以控制一系列审计行为。 默认的 <literal>cnt</literal> 标志表示系统应在审计失败时继续运行
 	  (强烈建议使用这个标志)。 另一个常用的标志是
 	  <literal>argv</literal>， 它表示在审计命令执行操作时，
 	  同时审计传给 &man.execve.2; 系统调用的命令行参数。</para>
 
 	<para><option>filesz</option> 选项指明了审计日志在自动停止记录和翻转之前允许的最大尺寸。
 	  默认值 0 表示禁用自动日志翻转。 如果配置的值不是零， 但小于最小值 512k，
 	  则这个配置会被忽略， 并在日志中记录这一消息。</para>
       </sect3>
 
       <sect3 xml:id="audit-audituser">
 	<title><filename>audit_user</filename> 文件</title>
 
 	<para><filename>audit_user</filename> 文件允许管理员为特定用户指定进一步的审计需求。
 	  每一行使用两个字段来配置用户的审计：
 	  第一个是 <literal>alwaysaudit</literal> 字段， 它指明了一组对该用户总会进行审计的事件；
 	  而第二个则是 <literal>neveraudit</literal> 字段，
 	  它指明了一系列对该用户不审计的事件。</para>
 
 	<para>在下述 <filename>audit_user</filename> 示例文件中，
 	  审计了 <systemitem class="username">root</systemitem> 用户的 登录/注销 事件， 以及成功的命令执行事件，
 	  此外， 还审计了 <systemitem class="username">www</systemitem> 用户的文件创建和成功的命令执行事件。
 	  如果与前面的示范 <filename>audit_control</filename> 文件配合使用，
 	  则 <systemitem class="username">root</systemitem> 的 <literal>lo</literal> 项就是多余的， 而对
 	  <systemitem class="username">www</systemitem> 用户而言， 其登录/注销事件也会被审计：</para>
 
 	<programlisting>root:lo,+ex:no
 www:fc,+ex:no</programlisting>
 
       </sect3>
     </sect2>
   </sect1>
 
   <sect1 xml:id="audit-administration">
     <title>管理审计子系统</title>
 
     <sect2>
       <title>查看审计日志</title>
 
       <para>审计记帐是以 BSM 二进制格式保存的， 因此必须使用工具来对其进行修改，
 	或将其转换为文本。 &man.praudit.1;
 	命令能够将记帐文件转换为简单的文本格式； 而
 	&man.auditreduce.1; 命令则可以为分析、 存档或打印目的来浓缩审计日志文件。
 	<command>auditreduce</command> 支持一系列筛选参数， 包括事件类型、 事件类、
 	用户、 事件的日期和时间， 以及文件路径或操作对象。</para>
 
       <para>例如， <command>praudit</command> 工具会将指定的审计记帐转存为简单文本格式的审计日志：</para>
 
       <screen>&prompt.root; <userinput>praudit /var/audit/AUDITFILE</userinput></screen>
 
       <para>此处 <filename>AUDITFILE</filename> 是要转存的审计日志文件。</para>
 
       <para>审计记帐中包括一系列审计记录， 这些记录由一系列短语 (token) 组成，
 	而 <command>praudit</command> 能把它们顺序显示为一行。
 	每个短语都属于某个特定的类型， 例如
 	<literal>header</literal> 表示审计记录头， 而
 	<literal>path</literal> 则表示在一次名字查找中的文件路径。 下面是一个
 	<literal>execve</literal> 事件的例子：</para>
 
       <programlisting>header,133,10,execve(2),0,Mon Sep 25 15:58:03 2006, + 384 msec
 exec arg,finger,doug
 path,/usr/bin/finger
 attribute,555,root,wheel,90,24918,104944
 subject,robert,root,wheel,root,wheel,38439,38032,42086,128.232.9.100
 return,success,0
 trailer,133</programlisting>
 
       <para>这个审计记录表示一次成功的 <literal>execve</literal>
 	调用， 执行了 <literal>finger doug</literal>。 在参数短语中是由 shell 提交给内核的命令行。
 	<literal>path</literal> 短语包含了由内核查找得到的可执行文件路径。 <literal>attribute</literal> 短语中包含了对可执行文件的描述，
 	特别地， 它包括了文件的权限模式， 用以确定应用程序是否是 setuid 的。
 	<literal>subject</literal>(主体) 短语描述了主体进程， 并顺序记录了审计用户 ID、 生效用户 ID 和组 ID、
 	实际用户 ID 和组 ID、 进程 ID、 会话 ID、 端口 ID， 以及登录地址。
 	注意审计用户 ID 和实际用户 ID 是不同的：
 	用户 <systemitem class="username">robert</systemitem> 在执行这个命令之前已经切换为
 	<systemitem class="username">root</systemitem> 帐户， 但它会以最初进行身份验证的用户身份进行审计。
 	最后， <literal>return</literal> 短语表示执行成功，
 	而 <literal>trailer</literal> 表示终结这一记录。</para>
 
       <para><command>praudit</command>
 	可以选择使用 <option>-x</option> 参数来支持 XML 格式的输出。</para>
 
     </sect2>
 
     <sect2>
       <title>浓缩审计记帐</title>
 
       <para>由于审计日志可能会很大， 管理员可能会希望选择记录的一个子集来使用，
 	例如与特定用户相关的记录：</para>
 
       <screen>&prompt.root; <userinput>auditreduce -u trhodes /var/audit/AUDITFILE | praudit</userinput></screen>
 
     <para>这将选择保存在
 	<filename>AUDITFILE</filename> 中的所有由
       <systemitem class="username">trhodes</systemitem> 产生的审计日志。</para>
     </sect2>
 
     <sect2>
       <title>委派审计复审权限</title>
 
       <para>在 <systemitem class="groupname">audit</systemitem> 组中的用户，
 	拥有读取 <filename>/var/audit</filename> 下的审计记帐的权限；
 	默认情况下， 这个组是空的， 因此只有 <systemitem class="username">root</systemitem> 用户可以读取审计记帐。
 	如果希望给某个用户指定审计复审权， 则可以将其加入 <systemitem class="groupname">audit</systemitem>。
 	由于查看审计日志的内容可以提供关于用户和进程行为的大量深度信息，
 	在您委派这些权力时， 请务必谨慎行事。</para>
     </sect2>
 
     <sect2>
       <title>通过审计管道来实时监控</title>
 
       <para>审计管道是位于设备文件系统中的自动复制 (cloning) 的虚拟设备，
 	用于让应用程序控制正在运行的审计记录流， 这主要是为了满足入侵检测和系统监控软件作者的需要。
 	不过， 对管理员而言， 审计管道设备也提供了一种无需冒审计记帐文件属主出现问题的麻烦，
 	或由于日志翻转而打断事件流的麻烦， 而实现实时监控的方便途径。 要跟踪实时事件流，
 	使用下面的命令行：</para>
 
       <screen>&prompt.root; <userinput>praudit /dev/auditpipe</userinput></screen>
 
       <para>默认情况下， 审计管道设备节点只有 <systemitem class="username">root</systemitem> 用户才能访问。 如果希望
 	<systemitem class="groupname">audit</systemitem> 组的成员能够访问它， 应在 <filename>devfs.rules</filename>
 	中加入下述 <literal>devfs</literal> 规则：</para>
 
       <programlisting>add path 'auditpipe*' mode 0440 group audit</programlisting>
 
       <para>请参见 &man.devfs.rules.5; 以了解关于配置 devfs 文件系统的进一步信息。</para>
 
       <warning>
 	<para>很容易配置出审计事件反馈循环， 也就是查看事件的操作本身会产生更多的事件。
 	  例如， 如果所有的网络 I/O 均被审计， 又在 SSH 会话中执行
 	  &man.praudit.1;， 就会以很高的速率产生持续的审计事件流，
 	  因为每显示一个事件都会产生新的事件。 建议您在需要在审计管道设备上执行
 	  <command>praudit</command> 时， 选择一个没有进行细粒度
 	  I/O 审计的会话来运行。</para>
       </warning>
     </sect2>
 
     <sect2>
       <title>审计记帐文件的轮转</title>
 
       <para>审计计账只由内核写入， 且只能由
 	<application>auditd</application> 管理。 管理员不应尝试使用 &man.newsyslog.conf.5;
 	或其它工具来完成审计日志的轮转工作。 您可以使用 <command>audit</command>
 	管理工具来关闭审计、 重新配置审计系统， 并完成日志轮转。
 	下面的命令将让审计服务创建新的审计日志，
 	并发信号给内核要求其使用新的日志。 旧日志将终止并被改名，
 	此时， 管理员就可以操作它了。</para>
 
       <screen>&prompt.root; <userinput>audit -n</userinput></screen>
 
       <warning>
 	<para>如果 <application>auditd</application> 服务程序没有在运行，
 	  则这个命令将失败并给出错误提示。</para>
       </warning>
 
       <para>在 <filename>/etc/crontab</filename> 加入如下设置，
 	将使 &man.cron.8; 每十二小时将日志轮转一次。</para>
 
       <programlisting>0     */12       *       *       *       root    /usr/sbin/audit -n</programlisting>
 
       <para>这些修改会在您保存 <filename>/etc/crontab</filename> 后生效。</para>
 
       <para>对于审计记帐文件基于尺寸的自动翻转， 可以通过
 	&man.audit.control.5; 中的 <option>filesz</option> 选项来配置，
 	这个选项在这一章的配置文件一节中已经介绍过。</para>
     </sect2>
 
     <sect2>
       <title>压缩审计记帐</title>
 
       <para>由于审计记帐文件会变得很大， 通常会希望在审计服务关闭它时，
 	对其进行压缩或归档。 <filename>audit_warn</filename> 脚本可以用来在一系列与审计有关的事件发生时，
 	执行一些用户定义的操作， 这也包括在审计记帐翻转时进行清理操作。 举例而言， 可以在
 	<filename>audit_warn</filename> 脚本中加入下列内容来在审计记帐关闭时压缩它：</para>
 
       <programlisting>#
 # Compress audit trail files on close.
 #
 if [ "$1" = closefile ]; then
         gzip -9 $2
 fi</programlisting>
 
       <para>其它存档操作也包括将审计记帐复制到一个中央的服务器， 删除旧的记帐文件，
 	或浓缩审计记帐并删除不需要的记录等。 这个脚本会在审计记帐文件正常关闭时执行一次，
 	因此在非正常关闭系统时， 就不会执行它了。</para>
     </sect2>
   </sect1>
 </chapter>
diff --git a/zh_CN.UTF-8/books/handbook/basics/chapter.xml b/zh_CN.UTF-8/books/handbook/basics/chapter.xml
index dd0d171deb..36eac49a1f 100644
--- a/zh_CN.UTF-8/books/handbook/basics/chapter.xml
+++ b/zh_CN.UTF-8/books/handbook/basics/chapter.xml
@@ -1,2476 +1,2476 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      The FreeBSD Documentation Project
      The FreeBSD Simplified Chinese Project
 
-     Original Revision: r38448
+     Original Revision: 4b18d4f577 (r38448)
      $FreeBSD$
 -->
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="basics">
   <info><title>UNIX 基础</title>
     <authorgroup>
       <author><personname><firstname>Chris</firstname><surname>Shumway</surname></personname><contrib>Rewritten by </contrib></author>
     </authorgroup>
     
   </info>
 
   
 
   <sect1 xml:id="basics-synopsis">
     <title>概述</title>
 
    <para>下列章节的命令和功能适用于FreeBSD操作系统。
      同时这里许多内容和一些 类-&unix; 操作系统相关。
      假如您已经熟悉这些内容可跳过不阅读。
      假如您是FreeBSD新手， 那您应该认真详细地从头到尾读一遍这些章节。</para>
 
     <para>读取这些内容，您将了解：</para>
 
     <itemizedlist>
       <listitem>
         <para>怎样在FreeBSD使用 <quote>虚拟控制台</quote>。</para>
       </listitem>
       <listitem>
 	<para>在 &unix; 中文件权限如何运作，
 	  以及理解 &os; 中的文件标志。</para>
       </listitem>
       <listitem>
 	<para>&os; 默认文件系统的架构。</para>
       </listitem>
       <listitem>
 	<para>&os;磁盘架构。</para>
       </listitem>
       <listitem>
 	<para>怎样挂接或卸下文件系统。</para>
       </listitem>
       <listitem>
 	<para>什么是进程、守护进程、信号。</para>
       </listitem>
       <listitem>
 	<para>什么是shell，应当怎样去改变登录进入的默认环境。
 	</para>
       </listitem>
       <listitem>
 	<para>怎样使用基本的文本编辑器。</para>
       </listitem>
       <listitem>
 	<para>什么是设备，什么是设备节点。</para>
       </listitem>
       <listitem>
 	<para>&os; 下，使用的是什么可执行文件格式。</para>
       </listitem>
       <listitem>
 	<para>怎样使用 man 手册并取得更多资讯。</para>
       </listitem>
     </itemizedlist>
 
   </sect1>
 
   <sect1 xml:id="consoles">
     <title>虚拟控制台和终端</title>
     <indexterm><primary>虚拟控制台</primary></indexterm>
     <indexterm><primary>终端</primary></indexterm>
 
     <para>可以用多种不同的方式使用 FreeBSD， 在文本终端输入命令是其中之一。
       通过使用这种方式， 您可以容易地使用 FreeBSD 来获得 &unix;
       操作系统的灵活而强大的功能。 这一节将介绍 <quote>终端</quote> 和
       <quote>控制台</quote>， 以及如何在 FreeBSD 中使用它们。</para>
 
     <sect2 xml:id="consoles-intro">
       <title>控制台</title>
       <indexterm><primary>控制台</primary></indexterm>
 
       <para>假如您没有设置 FreeBSD 在启动期间开启图形登录界面，
 	那么系统将在引导和启动脚本正确运行完成后，给您一个登录的提示。
 	您会看到类似这样的界面:</para>
 
       <screen>Additional ABI support:.
 Local package initialization:.
 Additional TCP options:.
 
 Fri Sep 20 13:01:06 EEST 2002
 
 FreeBSD/i386 (pc3.example.org) (ttyv0)
 
 login:</screen>
 
       <para>这些信息可能和您的系统稍微有点不同，但不会有很大差别。
 	最后两行是我们感兴趣的，
         理解这一行:</para>
 
       <programlisting>FreeBSD/i386 (pc3.example.org) (ttyv0)</programlisting>
 
       <para>这一行是您刚才启动的系统信息其中一块，
 	您所看到的是一个<quote>FreeBSD</quote>控制台，
 	运行在一个Intel或兼容的x86体系架构上面<footnote>
 	  <para>现在理解一下<literal>i386</literal>的含义。
 	    请注意尽管您的 FreeBSD 并非在 Intel 386 CPU
 	    上运行， 但也会显示为 <literal>i386</literal>。
 	    这不是指您的处理器， 而是指处理器的
 	    <quote>体系结构</quote>。</para>
 	</footnote>。 这台计算机的名字 (每台 &unix; 计算机都有自己的名字) 叫
 	<systemitem>pc3.example.org</systemitem>， 就是现在这个系统控制台&mdash;这个 <filename>ttyv0</filename>
 	终端的样子。</para>
 
       <para>在最后，最后一行一直保持这样:</para>
 
       <programlisting>login:</programlisting>
 
       <para>这里， 您将可以输入用户名
 	<quote>username</quote> 并登录到 &os; 系统中。
 	接下来的一节， 将介绍如何登录系统。</para>
     </sect2>
 
     <sect2 xml:id="consoles-login">
       <title>进入FreeBSD</title>
 
       <para>FreeBSD是一个多用户多任务的系统，
 	换句话来说就是一个系统中可以容纳许多不同的用户，
 	而这些用户都可以同时在这台机器中运行大量的程序。</para>
 
       <para>每一个多用户系统都必须在某方面去区分 <quote>user</quote>，
 	在 FreeBSD 里 (以及 类-&unix; 操作系统)， 完成这方面工作是有必要的，
 	因而， 每位使用者在运行程序之前都必须首先 <quote>登录</quote>，
 	而每位用户都有与之对应的用户名 (<quote>username</quote>) 和密码
 	(<quote>password</quote>)。 FreeBSD
 	会在用户进入之前作出询问这两项信息。</para>
 
       <indexterm><primary>启动脚本</primary></indexterm>
       <para>当 FreeBSD 引导并运行完启动脚本之后，
 	<footnote>
 	  <para>启动脚本这些程序在FreeBSD在启动过程中运行。
 	   它们的主要功能为其他每方面的运行作好准备，
 	   和运行您的配置所用到的相关环境。</para>
 	</footnote>， 它会给出一个提示， 并要求输入有效的用户名：
 	</para>
 
       <screen>login:</screen>
 
       <para>举个例子更容易理解，我们假设您的用户名叫 <systemitem class="username">john</systemitem>。
 	在提示符下输入 <literal>john</literal> 并按 <keycap>Enter</keycap>，
 	此时您应该看到这个提示 <quote>password</quote>：
      </para>
 
       <screen>login: <userinput>john</userinput>
 Password:</screen>
 
       <para>现在输入 <systemitem class="username">john</systemitem>的密码并按下
 	<keycap>Enter</keycap>。 输入密码时是 <emphasis>不回显的!</emphasis>
 	不必为此担心， 这样做是出于安全考虑。</para>
 
       <para>假如您输入的密码是正确的， 这时你应该已进入 FreeBSD，
 	并可以开始尝试可用的命令了。</para>
 
       <para>您应该看见 <acronym>MOTD</acronym> 或者出现一个命令提示符
 	(<literal>#</literal>、<literal>$</literal> 或 <literal>%</literal> 字符).
 	这表明您已成功登录进入FreeBSD。</para>
     </sect2>
 
     <sect2 xml:id="consoles-virtual">
       <title>多个控制台</title>
 
       <para>在一个控制台运行 &unix; 命令虽说很好， 但 FreeBSD 具有一次运行
 	多个程序的能力。 仅使用一个控制台只会浪费 FreeBSD 同时运行多任务的能力。
 	而 <quote>虚拟控制台</quote> 在这方面发挥强大的功能。</para>
 
       <para>FreeBSD 能配置出满足您不同需求的虚拟控制台，
 	在键盘上您用一组键就能从各个虚拟控制台之间切换。
 	各个控制台有自己的传输通道，
 	当您在各个控制台切换时 FreeBSD
 	会切换到合适的键盘传输通道和显示器传输通道。</para>
 
       <para>FreeBSD 各个控制台之间可利用特殊组键切换并保留原有控制台
 	<footnote>
 	  <para>关于 FreeBSD
 	    的控制台和键盘设备这些详细资料或使用技巧可在手册里找到:
 	    &man.syscons.4;、&man.atkbd.4;、&man.vidcontrol.1;
 	    和 &man.kbdcontrol.1;。 我们不在这里详细介绍，
 	    但是爱好者总会在手册里找到详细的答案。</para>
 	</footnote>，您可这样做:
 	<keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo>，
 	<keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>， 一直到
 	<keycombo><keycap>Alt</keycap><keycap>F8</keycap></keycombo>
 	在FreeBSD里切换到其中一个虚拟控制台。</para>
 
       <para>同样地, 您正在从其中某个控制台切换到另一个控制台的时候,
 	FreeBSD 会保存正在使用和恢复将要使用屏幕传输通道。
 	这种结果形成一种 <quote>错觉</quote>，
 	您拥有许多<quote>虚拟</quote>屏幕和键盘可以输入很多的命令。
 	这些程序需要在一个虚拟控制台不能停止运行而又不需要观察它，
 	它继续运行而您可以切换到其他的虚拟控制台。</para>
     </sect2>
 
     <sect2 xml:id="consoles-ttys">
       <title><filename>/etc/ttys</filename>文件</title>
 
       <para>FreeBSD 虚拟控制台的默认配置为8个，但并不是硬性设置，
         您可以很容易设置虚拟控制台的个数增多或减少。
         虚拟控制台的的编号和设置在 <filename>/etc/ttys</filename> 文件里。</para>
 
       <para>您可以使用 <filename>/etc/ttys</filename> 文件在 FreeBSD 下配置虚拟控制台。
         文件里每一未加注释的行都能设置一个终端或虚拟控制台
         (当行里含有 <literal>#</literal> 这个字符时不能使用) 。
         FreeBSD 默认配置是配置出9个虚拟控制台而只能启动8个，
 	以下这些行是 <literal>ttyv</literal> 一起启动:</para>
 
       <programlisting># name  getty                           type    status          comments
 #
 ttyv0   "/usr/libexec/getty Pc"         cons25  on  secure
 # Virtual terminals
 ttyv1   "/usr/libexec/getty Pc"         cons25  on  secure
 ttyv2   "/usr/libexec/getty Pc"         cons25  on  secure
 ttyv3   "/usr/libexec/getty Pc"         cons25  on  secure
 ttyv4   "/usr/libexec/getty Pc"         cons25  on  secure
 ttyv5   "/usr/libexec/getty Pc"         cons25  on  secure
 ttyv6   "/usr/libexec/getty Pc"         cons25  on  secure
 ttyv7   "/usr/libexec/getty Pc"         cons25  on  secure
 ttyv8   "/usr/X11R6/bin/xdm -nodaemon"  xterm   off secure</programlisting>
 
       <para>如果要了解这个文件中每一列的详细介绍，
 	以及虚拟控制台上所能使用的配置，
 	请参考联机手册 &man.ttys.5;。</para>
     </sect2>
 
     <sect2 xml:id="consoles-singleuser">
       <title>单用户模式的控制台</title>
 
       <para>关于 <quote>单用户模式</quote> 详细介绍在 <xref linkend="boot-singleuser"/>
 	这里可以找到。 当您运行单用户模式时只能使用一个控制台，
 	没有多个虚拟控制台可使用。 单用户模式的控制台同也可以在
 	<filename>/etc/ttys</filename> 文件设置，
 	可在这行找到要启动的<literal>控制台</literal>：</para>
 
       <programlisting># name  getty                           type    status          comments
 #
 # If console is marked "insecure", then init will ask for the root password
 # when going to single-user mode.
 console none                            unknown off secure</programlisting>
 
       <note>
         <para>这个 <literal>console</literal> 已经注释掉,
         您可编辑这行把 <literal>secure</literal> 改为
 	  <literal>insecure</literal>。 这样，
 	  当用单用户进入 FreeBSD 时， 它仍然要求提供
 	  <systemitem class="username">root</systemitem> 用户的密码。</para>
 
 	<para><emphasis>在把这个选项改为
 	  <literal>insecure</literal></emphasis> 的时候一定要小心，
 	  如果您忘记了
 	  <systemitem class="username">root</systemitem>用户的密码， 进入单用户会有点麻烦。
 	  尽管仍然能进入单用户模式， 但如果您不熟悉它就会非常令人头疼。</para>
       </note>
     </sect2>
 
     <sect2 xml:id="consoles-vidcontrol">
       <title>改变控制台的显示模式</title>
 
       <para>FreeBSD 控制台默认的显示模式可以被调整为 1024x768， 1280x1024，
 	或者任何你的显卡芯片和显示器所支持的其他尺寸。
 	要使用一个不同的显示模式，
 	你必须首先重新编译内核并包含以下2个选项：</para>
 
       <programlisting>options VESA
 options SC_PIXEL_MODE</programlisting>
 
       <para>在内核用这2个选项编译完成后，你就可以使用 &man.vidcontrol.1;
 	工具来测定你的硬件支持何种显示模式了。 以 root
 	身份在控制台键入以下命令来获得一份所支持的显示模式列表。</para>
 
       <screen>&prompt.root; <userinput>vidcontrol -i mode</userinput></screen>
 
       <para>这个命令的输出是一份你的硬件所支持的显示模式列表。
 	你可以在以 root	身份在控制台上键入 &man.vidcontrol.1;
 	命令来改变显示模式：</para>
 
       <screen>&prompt.root; <userinput>vidcontrol MODE_279</userinput></screen>
 
       <para>如果你对于新的显示模式满意，那么可以把它加入到
 	<filename>/etc/rc.conf</filename> 使机器在每次启动的时候都能生效，
 	我们使用了上一个例子中的模式：</para>
 
       <programlisting>allscreens_flags="MODE_279"</programlisting>
     </sect2>
   </sect1>
 
   <sect1 xml:id="permissions">
     <title>权限</title>
     <indexterm><primary>UNIX</primary></indexterm>
 
     <para>FreeBSD，是 BSD &unix; 的延续， 并基于几个关键的 &unix; 观念。
       从一开始就多处提到 FreeBSD 是一个多用户的操作系统，
       它能分别处理几个同时工作的用户所分配的毫无关联任务。
       并负责为每位用户的硬件设备、 外设、 内存和
       CPU 处理时间作出合理安排。</para>
 
     <para>因为系统有能力支持多用户， 在每一方面系统都会作出谁能读、
       写和执行的资源权力限制。 这点权限以三个八位元的方式储存着，
       一个是表示文件所属者， 一个是表示文件所属群组， 一个是表示其他人。
       这些数字以下列方式表示：</para>
 
     <indexterm><primary>权限</primary></indexterm>
     <indexterm>
       <primary>文件权限</primary>
     </indexterm>
     <informaltable frame="none" pgwide="1">
       <tgroup cols="3">
 	<thead>
 	  <row>
 	    <entry>数值</entry>
 	    <entry>权限</entry>
 	    <entry>目录列表</entry>
 	  </row>
 	</thead>
 
 	<tbody>
 	  <row>
 	    <entry>0</entry>
 	    <entry>不能读，不能写，不能执行</entry>
 	    <entry><literal>---</literal></entry>
 	  </row>
 
 	  <row>
 	    <entry>1</entry>
 	    <entry>不能读，不能写，可执行</entry>
 	    <entry><literal>--x</literal></entry>
 	  </row>
 
 	  <row>
 	    <entry>2</entry>
 	    <entry>不能读，可写，不能执行</entry>
 	    <entry><literal>-w-</literal></entry>
 	  </row>
 
 	  <row>
 	    <entry>3</entry>
 	    <entry>不能读，可写，可执行</entry>
 	    <entry><literal>-wx</literal></entry>
 	  </row>
 
 	  <row>
 	    <entry>4</entry>
 	    <entry>可读，不能写，不能执行</entry>
 	    <entry><literal>r--</literal></entry>
 	  </row>
 
 	  <row>
 	    <entry>5</entry>
 	    <entry>可读，不能写，可执行</entry>
 	    <entry><literal>r-x</literal></entry>
 	  </row>
 
 	  <row>
 	    <entry>6</entry>
 	    <entry>可读，可写，不能执行</entry>
 	    <entry><literal>rw-</literal></entry>
 	  </row>
 
 	  <row>
 	    <entry>7</entry>
 	    <entry>可读，可写，可执行</entry>
 	    <entry><literal>rwx</literal></entry>
 	  </row>
 	</tbody>
       </tgroup>
     </informaltable>
     <indexterm>
       <primary><command>ls</command></primary>
     </indexterm>
     <indexterm><primary>目录</primary></indexterm>
 
     <para>使用命令的 <option>-l</option> (&man.ls.1;)
       参数可以显示出文件的所属者、 所属组和其他人等属性。
       请看以下的例子：</para>
 
     <screen>&prompt.user; <userinput>ls -l</userinput>
 total 530
 -rw-r--r--  1 root  wheel     512 Sep  5 12:31 myfile
 -rw-r--r--  1 root  wheel     512 Sep  5 12:31 otherfile
 -rw-r--r--  1 root  wheel    7680 Sep  5 12:31 email.txt
 ...</screen>
 
     <para>使用 <command>ls -l</command> 在每行的开始出现了：</para>
 
     <screen>-rw-r--r--</screen>
 
     <para>从左边起的第一个字，告诉我们这个文件是一怎样的文件:
       普通文件?目录?特殊设备?socket?或是设备文件?
       在这个例子， <literal>-</literal> 表示一个普通文件。
       接下来三个字是 <literal>rw-</literal> 是文件拥有者的权限。
       再接下来的三个字是 <literal>r--</literal> 是文件所属群组的权限。
       最後三个字是 <literal>r--</literal> 是其他人的权限。
       以这一个文件为例，他的权限设定是拥有者可以读写这个文件、群组可以读取、
       其他使用者也能读取这个文件。
       根据上面的表格， 用数字表示这个文件其三部分的权限应该是
       <literal>644</literal>。 </para>
 
     <para>这样很好，但系统怎样对设备进行权限控制的?
        事实上 FreeBSD 将大部份硬件设备当作一个文件看待，
        用程序能打开、读取、写入数据就如其他的文件一样。
        而设备文件放在 <filename>/dev</filename> 目录。
        </para>
 
     <para>目录也视为一种文件，也有读取、写入、执行的权限。
          但目录的执行权限意义并不与普通文件相同，
          实际上执行权限是进入权限。
          当一个目录是被标示可以执行的时， 表示可以进入它，
          或者换言之， 利用 <quote>cd</quote> (改变当前目录) 进入它。
          此外， 这也表示有权进入目录的用户， 可以访问其下的已知名字的文件
          (当然目录下的文件也受到访问限制)。</para>
 
     <para>详细方面，想读取一个目录的列表就必须设为可读权限，
      同时想删除一个已知的文件，就必须把目录下这个文件设为可写
       <emphasis>和</emphasis> 执行权限。
      </para>
 
     <para>还有更多权限设定，
     但是他们大多用在特殊状况下如一个setuid的执行文件和粘贴性目录，
     如果想要得知有关文件权限和如何设定的更多资讯，请看手册&man.chmod.1;。
      </para>
 
     <sect2>
       <info><title>权限的符号化表示</title>
 	<authorgroup>
 	  <author><personname><firstname>Tom</firstname><surname>Rhodes</surname></personname><contrib>Contributed by </contrib></author>
 	</authorgroup>
       </info>
 
       
       <indexterm><primary>权限</primary><secondary>符号</secondary></indexterm>
 
       <para>权限符号，某些时候就是指符号表达式，
       使用八进制的字符给目录或文件分配权限。
 	  权限符号的使用语法是 (谁) (作用) (权限)。
       看看下列数值的在那些地方所起什么样的作用:</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="3">
 	  <thead>
 	    <row>
 	      <entry>选项</entry>
 	      <entry>字母</entry>
 	      <entry>介绍</entry>
 	    </row>
 	  </thead>
 
 	<tbody>
 	  <row>
 	    <entry>(谁)</entry>
 	    <entry>u</entry>
 	    <entry>用户</entry>
 	  </row>
 
 	  <row>
 	    <entry>(谁)</entry>
 	    <entry>g</entry>
 	    <entry>所属群体</entry>
 	  </row>
 
 	  <row>
 	    <entry>(谁)</entry>
 	    <entry>o</entry>
 	    <entry>其他人</entry>
 	  </row>
 
 	  <row>
 	    <entry>(谁)</entry>
 	    <entry>a</entry>
 	    <entry>所有人 (<quote>全部</quote>)</entry>
 	  </row>
 
 	  <row>
 	    <entry>(作用)</entry>
 	    <entry>+</entry>
 	    <entry>增加权限</entry>
 	  </row>
 
 	  <row>
 	    <entry>(作用)</entry>
 	    <entry>-</entry>
 	    <entry>减少权限</entry>
 	  </row>
 
 	  <row>
 	    <entry>(作用)</entry>
 	    <entry>=</entry>
 	    <entry>确定权限</entry>
 	  </row>
 
 	  <row>
 	    <entry>(权限)</entry>
 	    <entry>r</entry>
 	    <entry>可读</entry>
 	  </row>
 
 	  <row>
 	    <entry>(权限)</entry>
 	    <entry>w</entry>
 	    <entry>可写</entry>
 	  </row>
 
 	  <row>
 	    <entry>(权限)</entry>
 	    <entry>x</entry>
 	    <entry>执行</entry>
 	  </row>
 
 	  <row>
 	    <entry>(权限)</entry>
 	    <entry>t</entry>
 	    <entry>粘贴位</entry>
 	  </row>
 
 	  <row>
 	    <entry>(权限)</entry>
 	    <entry>s</entry>
 	    <entry>设置 UID 或 GID</entry>
 	  </row>
 	</tbody>
       </tgroup>
     </informaltable>
 
     <para>这些数值 &man.chmod.1; 以习惯标定的。
       举个例子，用以下命令阻止其他人访问
       <replaceable>FILE</replaceable>文件:</para>
 
     <screen>&prompt.user; <userinput>chmod go= FILE</userinput></screen>
 
     <para>如果需要对文件一次进行多项变动， 则可用逗号分开， 在下面的例子中，
       将去掉 <replaceable>FILE</replaceable> 文件的群体和 <quote>全体其他用户</quote> 可写权限，
       并为所有人增加可执行权限：</para>
 
     <screen>&prompt.user; <userinput>chmod go-w,a+x FILE</userinput></screen>
 
 <!--
     <para>大部份用户没有注意到这点，
       应当指出这个方法仅使用在配置一个文件权限，不会添加或删除(文件)。
       </para>
 -->
     </sect2>
 
     <sect2>
       <info><title>&os; 文件标志</title>
 	<authorgroup>
 	  <author><personname><firstname>Tom</firstname><surname>Rhodes</surname></personname><contrib>Contributed by </contrib></author>
 	</authorgroup>
       </info>
 
       
 
       <para>在前面所介绍的文件权限的基础之上， &os;
 	还支持使用 <quote>文件标志</quote>。
 	这些标志为文件提供了进一步的安全控制机制，
 	但这些控制并不适用于目录。</para>
 
       <para>这些文件标志提供了针对文件的进一步控制，
 	帮助确保即使是
 	<systemitem class="username">root</systemitem> 用户也无法删除或修改文件。</para>
 
       <para>文件标志可以通过使用 &man.chflags.1; 工具来修改，
 	其用户界面很简单。 例如， 要在文件 <filename>file1</filename>
 	上应用系统禁删标志， 应使用下述命令：</para>
 
       <screen>&prompt.root; <userinput>chflags sunlink file1</userinput></screen>
 
       <para>要禁用系统禁删标志， 只需在前述命令中的
 	<option>sunlink</option> 标志前加 <quote>no</quote>。
 	例如：</para>
 
       <screen>&prompt.root; <userinput>chflags nosunlink file1</userinput></screen>
 
       <para>要显示文件上的标志， 应使用命令 &man.ls.1;
 	的 <option>-lo</option> 参数：</para>
 
       <screen>&prompt.root; <userinput>ls -lo file1</userinput></screen>
 
       <para>输出结果应类似于：</para>
 
       <programlisting>-rw-r--r--  1 trhodes  trhodes  sunlnk 0 Mar  1 05:54 file1</programlisting>
 
       <para>许多标志只可以由
 	<systemitem class="username">root</systemitem> 用户来增加， 而另一些，
 	则可以由文件的所有者来增加。 建议管理员仔细阅读
 	&man.chflags.1; 和 &man.chflags.2; 联机手册，
 	以对其加深理解。</para>
     </sect2>
 
     <sect2>
       <info><title>setuid、 setgid 和 sticky 权限</title>
 	<authorgroup>
 	  <author><personname><firstname>Tom</firstname><surname>Rhodes</surname></personname><contrib>原作 </contrib></author>
 	</authorgroup>
       </info>
 
       
 
       <para>除了前面已经讨论过的那些权限之外， 还有三个管理员应该知道的权限配置。
 	它们是 <literal>setuid</literal>、
 	<literal>setgid</literal> 和 <literal>sticky</literal>。</para>
 
       <para>这些配置对于一些 &unix; 操作而言很重要，
 	因为它们能提供一些一般情况下不会授予普通用户的功能。
 	为了便于理解， 我们首先介绍真实用户 ID (real
 	user ID) 和生效用户 ID (effective user ID)。</para>
 
       <para>真实用户 ID 是拥有或启动进程的用户 <acronym>UID</acronym>。
 	生效 <acronym>UID</acronym>
 	是进程以其身份运行的用户 ID。 举例来说，
 	&man.passwd.1; 工具通常是以发起修改密码的用户身份启动，
 	也就是说其进程的真实用户 ID 是那个用户的 ID；
 	但是， 由于需要修改密码数据库， 它会以
 	<systemitem class="username">root</systemitem> 用户作为生效用户 ID 的身份运行。
 	这样， 普通的非特权用户就可以修改口令， 而不是看到
 	<errorname>Permission Denied</errorname> 错误了。</para>
 
       <note>
 	<para>&man.mount.8; 的 <literal>nosuid</literal>
 	  选项可以令系统在不给出任何错误提示的情况下不执行这些程序。
 	  另一方面， 这个选项并不是万无一失的， 正如
 	  &man.mount.8; 联机手册所提到的那样，
 	  如果系统中安装了绕过 <literal>nosuid</literal>
 	  的封装程序， 那么这种保护就可以被绕过了。</para>
       </note>
 
       <para>setuid 权限可以通过在普通权限前面加上一个数字四 (4)
 	来设置， 如下面的例子所示：</para>
 
       <screen>&prompt.root; <userinput>chmod 4755 suidexample.sh</userinput></screen>
 
       <para>这样一来，
 	<filename>suidexample.sh</filename>
 	的权限应该如下面这样：</para>
 
       <programlisting>-rwsr-xr-x   1 trhodes  trhodes    63 Aug 29 06:36 suidexample.sh</programlisting>
 
       <para>您会注意到， 在原先的属主执行权限的位置变成了
 	<literal>s</literal>。 这样， 需要提升特权的可执行文件，
 	例如 <command>passwd</command> 就可以正常运行了。</para>
 
       <para>可以打开两个终端来观察这一情形。 在其中一个终端里面，
 	以普通用户身份启动 <command>passwd</command> 进程。
 	在它等待输入新口令时， 在另一个终端中查看进程表中关于
 	<command>passwd</command> 命令的信息。</para>
 
       <para>在终端 A 中：</para>
 
       <screen>Changing local password for trhodes
 Old Password:</screen>
 
       <para>在终端 B 中：</para>
 
       <screen>&prompt.root; <userinput>ps aux | grep passwd</userinput></screen>
 
       <screen>trhodes  5232  0.0  0.2  3420  1608   0  R+    2:10AM   0:00.00 grep passwd
 root     5211  0.0  0.2  3620  1724   2  I+    2:09AM   0:00.01 passwd</screen>
 
       <para>正如前面所说的那样， <command>passwd</command> 是以普通用户的身份启动的，
 	但其生效
 	<acronym>UID</acronym> 是 <systemitem class="username">root</systemitem>。</para>
 
       <para>与此对应， <literal>setgid</literal> 权限的作用，
 	与 <literal>setuid</literal> 权限类似，
 	只是当应用程序配合这一设定运行时， 它会被授予拥有文件的那个组的权限。</para>
 
       <para>如果需要在文件上配置 <literal>setgid</literal> 权限，
 	可以在权限数值前面增加数字二 (2) 来运行 <command>chmod</command> 命令，
 	如下面的例子所示：</para>
 
       <screen>&prompt.root; <userinput>chmod 2755 sgidexample.sh</userinput></screen>
 
       <para>可以用与前面类似的方法来检视新设定的生效情况， 在组权限的地方的
 	<literal>s</literal> 表示这一配置已经生效：</para>
 
       <screen>-rwxr-sr-x   1 trhodes  trhodes    44 Aug 31 01:49 sgidexample.sh</screen>
 
       <note>
 	<para>在这些例子中， 尽管 shell 脚本也属于可执行文件的一种，
 	  但它们不会以您配置的 <acronym>EUID</acronym> 或生效用户 ID 的身份运行。
 	  这是因为 shell 脚本可能无法直接呼叫
 	  &man.setuid.2; 调用。</para>
       </note>
 
       <para>我们已经讨论了两个特殊权限位
 	(<literal>setuid</literal> 和 <literal>setgid</literal>
 	权限位)， 它们让用户在使用程序时能够用到更高的权限，
 	有时这会削弱系统的安全性。 除了这两个之外， 还有第三个特殊权限位：
 	<literal>sticky bit</literal>， 它能够增强安全性。</para>
 
       <para>当在目录上设置了 <literal>sticky bit</literal> 之后，
 	其下的文件就只能由文件的所有者删除了。 这个权限设置能够防止用户删除类似
 	<filename>/tmp</filename> 这样的公共目录中不属于他们的文件。
 	要应用这种权限， 可以在权限设置前面加上数字一 (1)。 例如：</para>
 
       <screen>&prompt.root; <userinput>chmod 1777 /tmp</userinput></screen>
 
       <para>现在， 可以用
 	<command>ls</command> 命令来查看效果：</para>
 
       <screen>&prompt.root; <userinput>ls -al / | grep tmp</userinput></screen>
 
       <screen>drwxrwxrwt  10 root  wheel         512 Aug 31 01:49 tmp</screen>
 
       <para>这里的结尾的 <literal>t</literal> 表示了
 	<literal>sticky bit</literal> 权限。</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="dirstructure">
     <title>目录架构</title>
     <indexterm><primary>目录层次</primary></indexterm>
 
     <para>理解 FreeBSD 的目录层次结构对于建立对系统整体的理解十分重要的基础。
       其中， 最重要的概念是根目录，
       <quote>/</quote>。 这个目录是系统引导时挂接的第一个目录，
       它包含了用以准备多用户操作所需的操作系统基础组件。
       根目录中也包含了用于在启动时转换到多用户模式之前挂接其他文件系统所需的挂接点。</para>
 
     <para>挂接点 (mount point) 是新增的文件系统在接入现有系统时的起点位置 (通常是根目录)。
       在 <xref linkend="disk-organization"/> 对此进行了详细的阐述。
       标准的挂接点包括
       <filename>/usr</filename>、 <filename>/var</filename>、 <filename>/tmp</filename>、
       <filename>/mnt</filename>， 以及 <filename>/cdrom</filename>。
       这些目录通常会在
       <filename>/etc/fstab</filename>
       文件中提及。 <filename>/etc/fstab</filename>
       是一张包含系统中各个文件系统及挂接点的表。
       在 <filename>/etc/fstab</filename> 中的绝大多数文件系统都会在启动时由
       &man.rc.8; 脚本自动挂接， 除非特别指定了 <option>noauto</option> 选项。
       更多细节请参考 <xref linkend="disks-fstab"/>。</para>
 
     <para>您可以通过 &man.hier.7; 来了解完整的文件系统层次说明。
       现在， 让我们先来看一看绝大多数的常见的目录以供参考。</para>
 
     <para>
       <informaltable frame="none" pgwide="1">
         <tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>目录</entry>
 	      <entry>介绍</entry>
 	    </row>
 	  </thead>
 	  <tbody valign="top">
             <row>
 	      <entry><filename>/</filename></entry>
 	      <entry>文件系统的根目录。</entry>
             </row>
 
 	    <row>
 	      <entry><filename>/bin/</filename></entry>
 	      <entry>在单个用户和多用户环境下的基本工具目录。
 	      </entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/boot/</filename></entry>
 	      <entry>在操作系统在启动加载期间所用的程序和配置。
 	      </entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/boot/defaults/</filename></entry>
 	      <entry>默认每步引导启动的配置内容，请查阅&man.loader.conf.5;。
        </entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/dev/</filename></entry>
 	      <entry>设备节点，请查阅 &man.intro.4;。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/etc/</filename></entry>
 	      <entry>系统启动的配置和脚本。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/etc/defaults/</filename></entry>
 	      <entry>系统默认的启动配置和脚本，请参考 &man.rc.8; 。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/etc/mail/</filename></entry>
 	      <entry>关系到邮件系统运作的配置， 请参考 &man.sendmail.8;。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/etc/namedb/</filename></entry>
 	      <entry><command>named</command> 配置文件，请参考 &man.named.8;。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/etc/periodic/</filename></entry>
 	      <entry>每天、每星期和每月周期性地运行的脚本，
 		请通过 &man.cron.8;查阅 &man.periodic.8;。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/etc/ppp/</filename></entry>
 	      <entry><command>ppp</command>配置文件，请查阅&man.ppp.8;。
 	      </entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/mnt/</filename></entry>
 	      <entry>由管理员习惯使用挂接点的临时空目录。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/proc/</filename></entry>
 	      <entry>运行中的文件系统，请参阅 &man.procfs.5;
 	        和 &man.mount.procfs.8;。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/rescue/</filename></entry>
 	      <entry>用于紧急恢复的一组静态联编的程序； 参见
 		&man.rescue.8;。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/root/</filename></entry>
 	      <entry><systemitem class="username">root</systemitem>用户的Home(主)目录。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/sbin/</filename></entry>
 	      <entry>在单个用户和多用户环境下的存放系统程序和管理所需的基本实用目录。</entry>
 	    </row>
 
 
 	    <row>
 	      <entry><filename>/tmp/</filename></entry>
 	      <entry>临时文件。
 		<filename>/tmp</filename> 目录中的内容，
 		一般不会在系统重新启动之后保留。 通常会将基于内存的文件系统挂在
 		<filename>/tmp</filename> 上。
 		这一工作可以用一系列 tmpmfs 相关的 &man.rc.conf.5; 变量来自动完成。
 		(或者， 也可以在
 		<filename>/etc/fstab</filename> 增加对应项； 参见 &man.mdmfs.8;)。</entry>
 	    </row>
 
 
 	    <row>
 	      <entry><filename>/usr/</filename></entry>
 	      <entry>存放大多数用户的应用软件。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/usr/bin/</filename></entry>
 	      <entry>存放实用命令，程序设计工具，和应用软件。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/usr/include/</filename></entry>
 	      <entry>存放标准 C include 文件.</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/usr/lib/</filename></entry>
 	      <entry>存放库文件。</entry>
 	    </row>
 
 
 	    <row>
 	      <entry><filename>/usr/libdata/</filename></entry>
 	      <entry>存放各种实用工具的数据文件。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/usr/libexec/</filename></entry>
 	      <entry>存放系统实用或后台程序 (从另外的程序启动执行)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/usr/local/</filename></entry>
 
 	      <entry>存放本地执行文件， 库文件等等，
 	        同时也是 FreeBSD ports 安装的默认安装目录。
 	        <filename>/usr/local</filename> 在
 	        <filename>/usr</filename> 中的目录布局大体相同，
 	        请查阅 &man.hier.7;。 但
 	        man 目录例外， 它们是直接放在
 	        <filename>/usr/local</filename> 而不是
 	        <filename>/usr/local/share</filename> 下的，
 	        而 ports 说明文档在
 	        <filename>share/doc/port</filename>。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/usr/obj/</filename></entry>
 	      <entry>通过联编 <filename>/usr/src</filename> 得到的目标文件。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/usr/ports/</filename></entry>
 	      <entry>存放 FreeBSD 的 Ports Collection (可选)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/usr/sbin/</filename></entry>
 	      <entry>存放系统后台程序 和 系统工具 (由用户执行)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/usr/share/</filename></entry>
 	      <entry>存放架构独立的文件。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/usr/src/</filename></entry>
 	      <entry>存放 BSD 或者本地源码文件。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/usr/X11R6/</filename></entry>
 	      <entry>存放 X11R6 可执行文件、 库文件、 配置文件等的目录(可选)。
 	      </entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/var/</filename></entry>
 	      <entry>多用途日志、 临时或短期存放的， 以及打印假脱机系统文件。
 		有时会将基于内存的文件系统挂在
 		<filename>/var</filename> 上。
 		这一工作可以通过在 &man.rc.conf.5; 中设置一系列 varmfs 变量
 		(或在
 		<filename>/etc/fstab</filename> 中加入一行配置； 参见 &man.mdmfs.8;)
 		来完成。</entry>
 	    </row>
 
 
 	    <row>
 	      <entry><filename>/var/log/</filename></entry>
 	      <entry>存放各种的系统记录文件。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/var/mail/</filename></entry>
 	      <entry>存放用户mailbox(一种邮件存放格式)文件。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/var/spool/</filename></entry>
 	      <entry>各种打印机和邮件系统spooling(回环)的目录。
 	      </entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/var/tmp/</filename></entry>
 	      <entry>临时文件。 这些文件在系统重新启动时通常会保留，
 		除非 <filename>/var</filename>
 		是一个内存中的文件系统。</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>/var/yp/</filename></entry>
 	      <entry>NIS 映射。</entry>
 	    </row>
 
 	  </tbody>
 	</tgroup>
       </informaltable>
     </para>
 
   </sect1>
 
   <sect1 xml:id="disk-organization">
       <title>磁盘组织</title>
 
       <para>FreeBSD 查找文件的最小单位是文件名。
 	而文件名区分大小写，这就意味着
 	<filename>readme.txt</filename> 和 <filename>README.TXT</filename>
 	是两个不相同的文件。 FreeBSD 不凭文件扩展名
 	(<filename>.txt</filename>) 去识别这个文件是
 	程序、 文档， 或是其他格式的数据。</para>
 
       <para>各种文件存放在目录里。 一个目录可以为空，
 	也可以含有多个的文件。一个目录同样可以包含其他的目录，
 	允许您在一个目录里建立多个不同层次的目录。
 	这将帮助您轻松地组织您的数据。</para>
 
       <para>文件或目录是由文件名或目录名，加上斜线符号 <literal>/</literal>，
 	再根据需要在目录名后面加上其他目录的名称。
 	如果您有一个名为 <filename>foo</filename>
 	的目录， 它包含另一个目录
 	<filename>bar</filename>， 后者包括一个叫
 	<filename>readme.txt</filename> 的文件， 则全名， 或者说到文件的
 	<firstterm>路径</firstterm> 就是
 	<filename>foo/bar/readme.txt</filename>。</para>
 
       <para>在文件系统里目录和文件的作用是存储数据。
 	每一个文件系统都有且只有一个顶级目录 <firstterm>根目录</firstterm>，
 	这个根目录则可以容纳其他目录。</para>
 
       <para>您也许在其他的一些操作系统碰到类似这里的情况，
 	当然也有不同的情况。 举些例子， &ms-dos; 是用
 	<literal>\</literal> 分隔文件名或目录名，
 	而 &macos; 则使用<literal>:</literal>。</para>
 
       <para>FreeBSD在路径方面不使用驱动器名符号或驱动器名称，
 	在FreeBSD里您不能这样使用：
 	<filename>c:/foo/bar/readme.txt</filename>。</para>
 
       <para>为了代替(驱动器名符号)， 一个文件系统会指定 <firstterm>根
 	文件系统</firstterm>， 根文件系统的根目录是
 	<literal>/</literal>。 其他每一个文件系统
 	<firstterm>挂接在</firstterm>根文件系统下。
 	无论有多少磁盘在FreeBSD 系统里， 每个磁盘都会以目录的方式加上。</para>
 
       <para>假设您有三个文件系统， 名为 <literal>A</literal>、
 	<literal>B</literal>  和 <literal>C</literal>。
 	每个文件系统有一个根目录， 而各自含有两个其他的目录， 名为
 	<literal>A1</literal>, <literal>A2</literal> (
 	<literal>B1</literal>, <literal>B2</literal> 和
 	<literal>C1</literal>, <literal>C2</literal>)。</para>
 
       <para>看看 <literal>A</literal> 这个根文件系统。  假如您用
 	<command>ls</command> 命令来查看这个目录您会见到两个子目录:
 	 <literal>A1</literal> 和 <literal>A2</literal>。
 	 这个目录树是这个样子:</para>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="install/example-dir1"/>
 	</imageobject>
 
 	<textobject>
 	  <literallayout class="monospaced"> /
  |
  +--- A1
  |
  `--- A2</literallayout>
 	</textobject>
       </mediaobject>
 
       <para>一个文件系统必须挂到另一个文件系统的某一目录，
 	所以现在假设把 <literal>B</literal> 文件系统挂到
 	<literal>A1</literal>目录， 那 <literal>B</literal> 根目录因此代替
 	了 <literal>A1</literal>，而显示出 <literal>B</literal>
 	目录(的内容)：</para>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="install/example-dir2"/>
 	</imageobject>
 
 	<textobject>
 	  <literallayout class="monospaced"> /
  |
  +--- A1
  |     |
  |     +--- B1
  |     |
  |     `--- B2
  |
  `--- A2</literallayout>
 	</textobject>
       </mediaobject>
 
       <para>无论<literal>B1</literal> 或
 	<literal>B2</literal> 目录在那里而延伸出来的路径必须为
 	<filename>/A1/B1</filename> 或 <filename>/A1/B2</filename>。
 	而在 <filename>/A1</filename> 里原有的文件会临时隐藏。
 	想这些文件再出现把 <literal>B</literal> 从 A
 	<firstterm>挂接释放</firstterm>。</para>
       <para>所有在<literal>B1</literal> 或 <literal>B2</literal>
 	目录里的文件都可以通过 <filename>/A1/B1</filename> 或
 	<filename>/A1/B2</filename> 访问。而在 <filename>/A1</filename>
 	中原有的文件会被临时隐藏，直到 <literal>B</literal> 从 A
 	上被<firstterm>卸载</firstterm> (unmout) 为止。</para>
 
       <para>把 <literal>B</literal> 挂接在 <literal>A2</literal>
 	那图表的样子就是这样子:</para>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="install/example-dir3"/>
 	</imageobject>
 
 	<textobject>
 	  <literallayout class="monospaced"> /
  |
  +--- A1
  |
  `--- A2
        |
        +--- B1
        |
        `--- B2</literallayout>
 	</textobject>
       </mediaobject>
 
       <para>这个路径分别是 <filename>/A2/B1</filename> 和
 	<filename>/A2/B2</filename> 。</para>
 
       <para>文件系统能把顶部挂接在另一个文件系统上。
 	继续这个例子， 把 <literal>C</literal> 文件系统挂接在
 	<literal>B</literal> 文件系统里的 <literal>B1</literal> 目录，
 	排列如下:</para>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="install/example-dir4"/>
 	</imageobject>
 
 	<textobject>
 	  <literallayout class="monospaced"> /
  |
  +--- A1
  |
  `--- A2
        |
        +--- B1
        |     |
        |     +--- C1
        |     |
        |     `--- C2
        |
        `--- B2</literallayout>
 	</textobject>
       </mediaobject>
 
       <para>或者把 <literal>C</literal> 文件系统挂接在 <literal>A</literal>
 	文件系统里的<literal>A1</literal>目录：</para>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="install/example-dir5"/>
 	</imageobject>
 
 	<textobject>
 	  <literallayout class="monospaced"> /
  |
  +--- A1
  |     |
  |     +--- C1
  |     |
  |     `--- C2
  |
  `--- A2
        |
        +--- B1
        |
        `--- B2</literallayout>
 	</textobject>
       </mediaobject>
 
       <para>假如您熟悉 &ms-dos; 并知道 <command>join</command> 命令，
 	尽管不相同，其实功能是相似的。</para>
 
       <para>这方面不是普通知识而且涉及到您自己所关心的，
 	当您安装FreeBSD并在以后添加新磁盘时，
 	您必须知到该如何新建文件系统和挂接上。</para>
 
       <para>(FreeBSD系统)它有一个主要的根文件系统， 不需要另外新建立，
 	但当需要手工处理时，这是一个有用的知识。</para>
 
       <itemizedlist>
 	<title>多个文件系统的益处</title>
 
 	<listitem>
 	  <para>不同的文件系统可用不同的 <firstterm>挂接参数</firstterm>。
 	    举些例子， 仔细想一下， 根文件系统能用只读的方式挂接上，
 	    防止不经意删除或编辑到一个危险的文件。
 	    把各用户能写入的文件系统分开，
 	    像<filename>/home</filename>这样，
 	    由另外的文件系统分别用
 	    <firstterm>nosuid</firstterm> 参数挂接，这个参数防止
 	    <firstterm>suid</firstterm>/<firstterm>guid</firstterm>
 	    在执行这个文件系统中的文件时生效， 从而缓解了一些安全问题。</para>
 	</listitem>
 
 	<listitem>
 	  <para>FreeBSD 能根据一个文件系统使用的情况自动优化
 	    这个文件系统上的文件布局。
 	    所以对一个存储了大量小文件并会被频繁写入文件系统的优化与一个存储了少量大文件的优化是不同的。
 	    而在一个大的单一文件系统上则无法体现这样的优化。</para>
 	</listitem>
 
 	<listitem>
 	  <para>FreeBSD 的文件系统能够在断电时尽可能避免损失。
 	    然而， 在关键点时的电源失效仍然可能会破坏文件系统的结构。
 	    将您的文件系统分成多个有助于分散风险， 并方便备份和恢复。</para>
 	</listitem>
       </itemizedlist>
 
       <itemizedlist>
 	<title>单一文件系统的益处</title>
 
 	<listitem>
 	  <para>文件系统是固定大小的。
 	    当安装FreeBSD时新建一个文件系统并设定一个大小，
 	    您会在稍后发觉到必须去建一个大的分区。
 	    如果配置不当， 则需要备份、 重新创建文件系统，
 	    然后再恢复数据。</para>
 
 	  <important>
 	    <para>FreeBSD 提供了 &man.growfs.8;
 	      命令。 这使得能够实时地调整文件系统的大小，
 	      因而不再受其限制。</para>
 	  </important>
 	</listitem>
       </itemizedlist>
 
       <para>文件系统是和分区一一对应的。
 	这里的分区和常用的术语分区 (例如， &ms-dos; 分区)
 	的意思并不一样， 这是由于 &os; 的 &unix; 传统造成的。
 	每一个分区使用一个从 <literal>a</literal> 到
 	<literal>h</literal> 的字母来表示。 每个分区只能包含一个文件系统，
 	这意味着文件系统通常可以由它们在文件系统目录结构中的挂接点，
 	或对应的分区字母来表示。</para>
 
       <para>FreeBSD 的 <firstterm>交换分区</firstterm> 也需要使用磁盘空间。
 	  交换分区是给 FreeBSD 作 <firstterm>虚拟内存</firstterm> 使用的，
 	这样能令您的计算机有更多的内存可使用，
 	当FreeBSD在运行而内存不够的时候，
 	它会把其他一些可转移的数据转移到交换分区，
 	空出内存的位置以供使用。</para>
 
       <para>某些 partitions 的用途是确定的。</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <colspec colwidth="1*"/>
 	  <colspec colwidth="5*"/>
 
 	  <thead>
 	    <row>
 	      <entry>分区</entry>
 
 	      <entry>约定</entry>
 	    </row>
 	  </thead>
 
 	  <tbody valign="top">
 	    <row>
 	      <entry><literal>a</literal></entry>
 
 	      <entry>通常指定为根文件系统</entry>
 	    </row>
 
 	    <row>
 	      <entry><literal>b</literal></entry>
 
 	      <entry>通常指定为交换分区</entry>
 	    </row>
 
 	    <row>
 	      <entry><literal>c</literal></entry>
 
 	      <entry>通常它和所在的 slice 大小相同。
 		<literal>c</literal> 分区上工作时必定会影响到事整个
 		slice (举个例子，坏块扫描器)。
 		您通常不愿意在这个partition建立文件系统。</entry>
 	    </row>
 
 	    <row>
 	      <entry><literal>d</literal></entry>
 
 	      <entry>分区 <literal>d</literal> 曾经有特殊的含义，
 		不过这种意义在现时的系统上已不再适用， 因此
 		<literal>d</literal> 可以和任何其它普通的分区一样使用了。</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
 
       <para>每一个包含了文件系统的分区被保存在
 	FreeBSD 称为 <firstterm>slice</firstterm> 的部分上。
 	Slice 是一个 FreeBSD 术语， 通常被叫做分区，
 	再次强调， 这是由于
 	FreeBSD 的 &unix; 背景。 Slices 有其编号， 从1到4。</para>
 
 	<indexterm><primary>slices</primary></indexterm>
 	<indexterm><primary>partitions</primary></indexterm>
 	<indexterm><primary>专用 (dangerously dedicated)</primary></indexterm>
 
       <para>Slice 编号在设备名后面， 并有一个 <literal>s</literal>
 	前缀， 从 1 开始。 因此 <quote>da0<emphasis>s1</emphasis></quote>
 	是第一个 SCSI 驱动器的第一个 slice。 每个磁盘上只能有四个物理的
 	slices， 但您可以在物理 slice 中使用适当的类型来创建逻辑 slice。
 	这些扩展 slice 编号从 5 开始， 因此
 	<quote>ad0<emphasis>s5</emphasis></quote> 是第一个 IDE 磁盘中的第一个
 	扩展 slice。 文件系统所使用的设备应该占满 slice。</para>
 
       <para>Slices, <quote>专用指定</quote> 物理驱动器，
 	和其他驱动器都包含 <firstterm>partitions</firstterm>，
 	那几个的 partitions 都是用字母从 <literal>a</literal>
 	到 <literal>h</literal> 来标定的，
 	而这些字母都在驱动器名字之后，所以
 	<quote>da0<emphasis>a</emphasis></quote> 是指首个da设备的 a partition，
 	而那个就是 <quote>专项指定</quote>。
 	<quote>ad1s3<emphasis>e</emphasis></quote> 是指IDE磁盘上第三个slice的第五个partition。
 	</para>
 
       <para>最终，每个磁盘都被系统识别。
 	一个磁盘名字是用磁盘类型代码和编号来标识的，
 	它不像slices，磁盘的编号是由0开始的。
 	对应代码请看这里所列出的<xref linkend="basics-dev-codes"/>。</para>
 
       <para>当在 FreeBSD 中指定 partition 名字时，
 	必须同时包含这个分区的 slice 和磁盘的名字； 类似地，
 	在指定 slice 时， 也应该给出包含该 slice 的磁盘名字。 可这样列出：
 	磁盘名称，<literal>s</literal>，slice 编号，和partition标定字母。
 	例子请看
 	<xref linkend="basics-disk-slice-part"/>。</para>
 
       <para><xref linkend="basics-concept-disk-model"/>
 	这里显示了一个磁盘的布局，有更清楚的帮助。</para>
 
       <para>在安装FreeBSD时，您首先要配置好磁盘slices，
 	然后在FreeBSD使用的slice上建立partitions。
 	并在每个partition上建立一个文件系统(或交换分区)，
 	和指定文件系统的挂接位置。</para>
 
       <table frame="none" pgwide="1" xml:id="basics-dev-codes">
 	<title>磁盘设备的代码</title>
 
 	<tgroup cols="2">
           <colspec colwidth="1*"/>
           <colspec colwidth="5*"/>
 
 	  <thead>
 	    <row>
 	      <entry>代码</entry>
 
 	      <entry>说明</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry><filename>ad</filename></entry>
 
 	      <entry>ATAPI (IDE) 磁盘</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>da</filename></entry>
 
 	      <entry>SCSI 直接存取磁盘</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>acd</filename></entry>
 
 	      <entry>ATAPI (IDE) 光驱</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>cd</filename></entry>
 
 	      <entry>SCSI 光驱</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>fd</filename></entry>
 
 	      <entry>软驱</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <example xml:id="basics-disk-slice-part">
 	<title>样例磁盘, Slice, 和 Partition 它们的命名</title>
 
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="2">
             <colspec colwidth="1*"/>
             <colspec colwidth="5*"/>
 
 	    <thead>
 	      <row>
 		<entry>命名</entry>
 
 		<entry>说明</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>ad0s1a</literal></entry>
 
 		<entry>在首个IDE磁盘(<literal>ad0</literal>)上的
               第一个slice (<literal>s1</literal>)里的
               第一个partition (<literal>a</literal>)。
 		  </entry>
 	      </row>
 
 	      <row>
 		<entry><literal>da1s2e</literal></entry>
 
 		<entry>在第二个SCSI磁盘(<literal>da1</literal>)上的
                第二个slice(<literal>s2</literal>)里的
                第五个partition(<literal>e</literal>)。
 		  </entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
       </example>
 
       <example xml:id="basics-concept-disk-model">
 	<title>一个磁盘的布局</title>
 
 	<para>从在系统里的首个IDE磁盘图表可以显示出FreeBSD的见解。
 	  假设磁盘大小为4&nbsp;GB，它里面包含了两个2&nbsp;GB 大小的slices (但在&ms-dos;叫partitions)。
 	  首个slice是一个&ms-dos;磁盘叫<filename>C:</filename>，
 	  而第二个slice是FreeBSD配置好的slice。
 	  FreeBSD配置好的slice有三个partitions和另一个交换分区。</para>
 
 	<para>这三个partitions各自控制一个文件系统。
 	  partition<literal>a</literal> 用于根文件系统，
 	  partition<literal>e</literal> 用于 <filename>/var</filename> 目录层，
 	  partition<literal>f</literal> 用于 <filename>/usr</filename> 目录层。</para>
 
         <mediaobject>
           <imageobject>
             <imagedata fileref="install/disk-layout"/>
           </imageobject>
 
           <textobject>
 	    <literallayout class="monospaced">.-----------------.  --.
 |                 |    |
 |  DOS / Windows  |    |
 :                 :     &gt;  First slice, ad0s1
 :                 :    |
 |                 |    |
 :=================:  ==:                               --.
 |                 |    |  Partition a, mounted as /      |
 |                 |     &gt; referred to as ad0s2a          |
 |                 |    |                                 |
 :-----------------:  ==:                                 |
 |                 |    |  Partition b, used as swap      |
 |                 |     &gt; referred to as ad0s2b          |
 |                 |    |                                 |
 :-----------------:  ==:                                 |  Partition c, no
 |                 |    |  Partition e, used as /var       &gt; file system, all
 |                 |     &gt; referred to as ad0s2e          |  of FreeBSD slice,
 |                 |    |                                 |  ad0s2c
 :-----------------:  ==:                                 |
 |                 |    |                                 |
 :                 :    |  Partition f, used as /usr      |
 :                 :     &gt; referred to as ad0s2f          |
 :                 :    |                                 |
 |                 |    |                                 |
 |                 |  --'                                 |
 `-----------------'                                    --'</literallayout>
           </textobject>
         </mediaobject>
       </example>
   </sect1>
 
 
 
   <sect1 xml:id="mount-unmount">
     <title>文件系统的挂接和卸下</title>
 
     <para>
       这种文件系统就像一棵树那样用<filename>/</filename>确立根部，
       是比较理想的文件系统。
       而<filename>/dev</filename>、 <filename>/usr</filename>
       和其他目录就是根目录的分枝，
       另外这些目录可以再分枝，例如<filename>/usr/local</filename>。
       </para>
 
     <indexterm><primary>根文件系统</primary></indexterm>
     <para>应该考虑给某些目录一些空间从而分散文件系统。
       <filename>/var</filename>
       之下包含目录 <filename>log/</filename>，目录<filename>spool/</filename>，
       和不同类型的临时文件，很可能把它塞满。
       把什么都塞进根文件系统不是一个好主意，
       好的做法是应该把 <filename>/var</filename> 从
       <filename>/</filename>分离出去。</para>
 
     <para>另一个要考虑的是，给物理设备或虚拟磁盘这些自带空间的文件系统确定目录结构树。
     例如 <link linkend="network-nfs">网络文件系统</link> 或光驱的挂接。
       </para>
 
     <sect2 xml:id="disks-fstab">
       <title><filename>fstab</filename> 文件</title>
       <indexterm>
 	<primary>文件系统</primary>
 	<secondary>使用fstab的挂接</secondary>
       </indexterm>
 
       <para>在 <link linkend="boot">引导过程</link> 期间，
 	自动挂上<filename>/etc/fstab</filename>所列出的文件系统。
 	(除非他们注明为<option>noauto</option> 选项)。
 	</para>
 
       <para> <filename>/etc/fstab</filename> 文件包含的各行的列表格式如下:
 	</para>
 
       <programlisting><replaceable>device</replaceable>       <replaceable>/mount-point</replaceable> <replaceable>fstype</replaceable>     <replaceable>options</replaceable>      <replaceable>dumpfreq</replaceable>     <replaceable>passno</replaceable></programlisting>
 
       <variablelist>
 	<varlistentry>
 	  <term><literal>device</literal></term>
 	  <listitem>
 	    <para>设备名称(设备必须存在)， 说明在
 	      <xref linkend="disks-naming"/>.</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><literal>mount-point</literal></term>
 
 	  <listitem><para>目录 (目录必须存在)，
 	      用在那个挂接上的文件系统上。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><literal>fstype</literal></term>
 
 	  <listitem><para>文件系统类型，请通过&man.mount.8;查阅。
 		 默认的FreeBSD文件系统类型是<literal>ufs</literal>。
 	      </para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><literal>options</literal></term>
 
 	  <listitem><para>
           设为可读写文件系统的<option>rw</option>选项，
           或设为只读文件系统的<option>ro</option>选项，
           或其他一些选项，可随意选一个。
 	      一个常用的选项 <option>noauto</option> 用在不需在引导过程期间挂接的文件系统。
 	      其他的选项在 &man.mount.8; 手册里列出。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><literal>dumpfreq</literal></term>
 
          <listitem><para>&man.dump.8;
 	     使用这项去决定那个文件系统必须移贮。
 	     假如缺少这项，默认的数值为0。</para>
          </listitem>
        </varlistentry>
 
        <varlistentry>
          <term><literal>passno</literal></term>
 
          <listitem>
            <para>这一项决定文件系统的检查顺序，
            文件系统想跳过检查应将<literal>passno</literal>设为0。
            根文件系统(那个是在每方面开始之前必须检查的)
            应该将它的 <literal>passno</literal> 设为1，
            其他文件系统的 <literal>passno</literal>
            必须把数值设到大于1。假如多个文件系统的<literal>passno</literal>的值相同，
            那么 &man.fsck.8; 在允许的情况下将尝试并行地去检查文件系统。
            </para>
          </listitem>
 	</varlistentry>
       </variablelist>
 
       <para>请参阅 &man.fstab.5; 联机手册，
 	以获得关于 <filename>/etc/fstab</filename> 文件格式，
 	以及其中所包含的选项的进一步信息。</para>
     </sect2>
 
     <sect2 xml:id="disks-mount">
       <title> <command>mount</command> 命令</title>
       <indexterm>
 	<primary>文件系统</primary>
 	<secondary>挂接</secondary>
       </indexterm>
 
       <para>这个 &man.mount.8; 命令是挂接文件系统的基本运用。
 	</para>
 
       <para>使用最多的基本格式:</para>
 
       <informalexample>
 	<screen>&prompt.root; <userinput>mount device mountpoint</userinput></screen>
       </informalexample>
 
       <para>它的选项非常多，而&man.mount.8; 手册同样提及， 但常用的都在这里:</para>
 
       <variablelist>
 	<title>挂接的各种选项</title>
 
 	<varlistentry>
 	  <term><option>-a</option></term>
 
 	  <listitem>
 	    <para>挂接<filename>/etc/fstab</filename>里所有列出的文件系统。
 	      除非标记为 <quote>noauto</quote> 或作了排除在外的
 	      <option>-t</option> 类型标记，或者在这之前已挂上。
 	      </para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><option>-d</option></term>
 
 	  <listitem>
 	    <para>除了实际上系统调用以外，可以完成任何事情，这个选项是和
 	    <option>-v</option>参数一起连在一块使用，可以决定&man.mount.8;所做的事情。
      </para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><option>-f</option></term>
 
 	  <listitem>
 	    <para>强制去挂接一个未知的文件系统(会有危险)，
 	    或当把一个文件系统挂接状态由可读写降为只读时，强制撤消可写通道。
 	      </para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
           <term><option>-r</option></term>
 
 	  <listitem>
 	    <para>以只读方式挂接文件系统。
 	      这和在指定了 <option>-o</option> 选项配合
 	      <option>ro</option> 参数的效果是一样的。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><option>-t</option>
 	    <replaceable>fstype</replaceable></term>
 
 	  <listitem>
 	    <para>根据给出的文件系统类型挂接文件系统，
 	       假如给于<option>-a</option>选项，仅挂接这个类型的文件系统。
 	      </para>
 
 	    <para><quote>ufs</quote> 是默认的文件系统类型。
 	      </para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><option>-u</option></term>
 
 	  <listitem>
 	    <para>在文件系统上修改挂接选项。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><option>-v</option></term>
 
 	  <listitem>
 	    <para>版本模式。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><option>-w</option></term>
 
 	  <listitem>
 	    <para>以可读写方式挂接文件系统。</para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
 
       <para>The <option>-o</option> 选项采用一个逗号分开以下多个选项:</para>
 
       <variablelist>
 	<varlistentry>
 	  <term>noexec</term>
 
 	  <listitem>
               <para>不允许文件系统上的二进制程序执行。这也是一个有用的安全选项。
 	      </para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>nosuid</term>
 
 	  <listitem>
 	    <para>不允许文件系统上的 setuid 或 setgid 标记生效。这也是一个有用的安全选项。
 	      </para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
     </sect2>
 
     <sect2 xml:id="disks-umount">
       <title> <command>umount</command> 命令</title>
       <indexterm>
 	<primary>文件系统</primary>
 	<secondary>卸下</secondary>
       </indexterm>
 
       <para>&man.umount.8; 命令同样采用一个参数、一个挂接点、一个设备名。
       或采用<option>-a</option>选项，又或采用<option>-A</option>选项。
 	</para>
 
       <para>所有格式都可采用 <option>-f</option> 去强行卸下，
         或采用<option>-v</option> 用那适当的版本。 但警告，采用
         <option>-f</option>并不是一个好主意，
         强行卸下文件系统可能损坏计算机或破坏文件系统上的数据。
         </para>
 
       <para><option>-a</option> 和 <option>-A</option> 会卸下所有已挂接的文件系，
 	可能通过<option>-t</option>后面列出的文件系统进行修改，
 	但无论如何，<option>-A</option>都不会尝试去卸下根文件系统。
 	</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="basics-processes">
     <title>进程</title>
 
     <para>FreeBSD 是一个多任务操作系统。
       这就意味着好像一次可以运行一个以上的程序。
       每个占用一定时间运行的程序就叫 <firstterm>进程</firstterm> (process)。
       你运行的每一个命令会至少启动一个新进程，还有很多一直运行着的系统进程，
       用以维持系统的正常运作。
     </para>
 
     <para>每个进程用来标识的一个编号就叫
       <firstterm>进程 ID</firstterm>， 或叫 <firstterm>PID</firstterm>。
       而且，就像文件那样，每个进程也有所属用户和所属群体。
       所属用户和所属群体使用在这方面:确定这个进程可以打开那些文件和那些设备，
       从而在初期使用文件的权限。 多数的进程都有一个父进程，
       而进程是依靠父进程来启动的。
       例如，假如您把命令输入到shell里那shell是一个进程，而您运行的各个命令同样是进程，
       那么，shell就是您各个运行进程的父进程。
       而这方面有一个例外的进程就叫&man.init.8;。
       <command>init</command>始终是首个进程,，所以他的PID始终是1，
       而<command>init</command>在FreeBSD起动时由内核自动启动。</para>
 
     <para>在系统上，有两个命令对进程观察非常有用:&man.ps.1; 和 &man.top.1;。
     这个<command>ps</command>命令作用是观察当前运行进程的状态，
     显示他们的PID，使用了多少内存，它们启动的命令行。
     而<command>top</command>命令则是显示所有运行进程，并在以秒计的短时内更新数据。
     您能交互式的观察您计算机的工作。
     </para>
 
     <para>默认情况下， <command>ps</command>仅显示出您自己所运行的命令。
      例如:</para>
 
     <screen>&prompt.user; <userinput>ps</userinput>
   PID  TT  STAT      TIME COMMAND
   298  p0  Ss     0:01.10 tcsh
  7078  p0  S      2:40.88 xemacs mdoc.xsl (xemacs-21.1.14)
 37393  p0  I      0:03.11 xemacs freebsd.dsl (xemacs-21.1.14)
 48630  p0  S      2:50.89 /usr/local/lib/netscape-linux/navigator-linux-4.77.bi
 48730  p0  IW     0:00.00 (dns helper) (navigator-linux-)
 72210  p0  R+     0:00.00 ps
   390  p1  Is     0:01.14 tcsh
  7059  p2  Is+    1:36.18 /usr/local/bin/mutt -y
  6688  p3  IWs    0:00.00 tcsh
 10735  p4  IWs    0:00.00 tcsh
 20256  p5  IWs    0:00.00 tcsh
   262  v0  IWs    0:00.00 -tcsh (tcsh)
   270  v0  IW+    0:00.00 /bin/sh /usr/X11R6/bin/startx -- -bpp 16
   280  v0  IW+    0:00.00 xinit /home/nik/.xinitrc -- -bpp 16
   284  v0  IW     0:00.00 /bin/sh /home/nik/.xinitrc
   285  v0  S      0:38.45 /usr/X11R6/bin/sawfish</screen>
 
     <para>在这个例子里您可看到，从 &man.ps.1; 输出的每一列是有规律的。
        <literal>PID</literal> 就是进程ID，这个较早前已讨论过了。
         PID号的分配由 1一直上升直到99999，
       当您运行到超过限制时，这些编号会回转分配
       (仍在使用中的 PID 不会分配给其他进程)。
       <literal>TT</literal>这一列显示了程序运行所在的终端， 目前可以安全地忽略。
       <literal>STAT</literal> 显示程序的状态，也可以安全地被忽略。
       <literal>TIME</literal>是程序在CPU处理时间&mdash;运行的时间量，
       并不是指您程序启动到现在的所用的时间。
       许多程序碰巧遇到某方面在他们之前要花费大量CPU处理时间时，他们就必须等候。
 
       最后， <literal>COMMAND</literal> 是运行程序时使所用的命令行。</para>
 
     <para>&man.ps.1;支持使用各种选项去改变显示出来的内容，
      最有用的一个就是<literal>auxww</literal>。
      <option>a</option>选项显示出所有运行进程的内容， 而不仅仅是您的进程。
       <option>u</option>选项显示出进程所归属的用户名字以及内存使用，
       <option>x</option> 选项显示出后台进程。 而
       <option>ww</option> 选项表示为 &man.ps.1; 把每个进程的整个命令行全部显示完，
       而不是由于命令行过长就把它从屏幕上截去。</para>
 
     <para>下面和从&man.top.1;输出是类似的，一个示例式对话就象这样子:
       </para>
 
     <screen>&prompt.user; <userinput>top</userinput>
 last pid: 72257;  load averages:  0.13,  0.09,  0.03    up 0+13:38:33  22:39:10
 47 processes:  1 running, 46 sleeping
 CPU states: 12.6% user,  0.0% nice,  7.8% system,  0.0% interrupt, 79.7% idle
 Mem: 36M Active, 5256K Inact, 13M Wired, 6312K Cache, 15M Buf, 408K Free
 Swap: 256M Total, 38M Used, 217M Free, 15% Inuse
 
   PID USERNAME PRI NICE  SIZE    RES STATE    TIME   WCPU    CPU COMMAND
 72257 nik       28   0  1960K  1044K RUN      0:00 14.86%  1.42% top
  7078 nik        2   0 15280K 10960K select   2:54  0.88%  0.88% xemacs-21.1.14
   281 nik        2   0 18636K  7112K select   5:36  0.73%  0.73% XF86_SVGA
   296 nik        2   0  3240K  1644K select   0:12  0.05%  0.05% xterm
 48630 nik        2   0 29816K  9148K select   3:18  0.00%  0.00% navigator-linu
   175 root       2   0   924K   252K select   1:41  0.00%  0.00% syslogd
  7059 nik        2   0  7260K  4644K poll     1:38  0.00%  0.00% mutt
 ...</screen>
 
     <para>这个输出分成两部份。 前面部份(起始前五行)
       显示了:运行于最后进程的PID、 系统负载均衡
       (那个是指系统繁忙时的调节方式)、 系统正常运行时间 (
       指从启动算起所用的时间) 和当前时间。  前面部份另外的图表
       涉及:多少进程在运行(这个情况是47)， 多少内存和多少交换分区在使用，
       和在不同CPU状态里系统消耗多少时间。</para>
 
     <para>在那下面一连串的纵列和从&man.ps.1;输出的的内存是相似的。
     如以前&man.ps.1;一样，您能见到:PID、用户名、CPU处理时间合计、运行的命令。
      &man.top.1;默认是显示您的进程所用内存空间的合计。
      内存空间这里分成两列，一列为总体大小，另一列是必须请求驻留大小是多少内存&mdash;总体大小。
      而驻留大小实际上是瞬间使用的多少。
      在以上那个例子，您会看到那<application>&netscape;</application>总计需要30&nbsp;MB内存，
      但实际只用了9&nbsp;MB。
      </para>
 
     <para>&man.top.1; 每两秒自动刷新一次，您可以用<option>s</option>改变刷新的秒数。
       </para>
   </sect1>
 
   <sect1 xml:id="basics-daemons">
     <title>守护进程，信号和杀死进程</title>
 
     <para>当您运行一个编辑器时它是很容易控制的，告诉它去加载文件它就加载。
     您之所以能这样做，是因为编辑器提供这样便利去这样做，和因为有编辑器去附上的<firstterm>终端</firstterm>。
     一些程序在运行中不需要连续的用户输入，一有机会就从终端里分离到后台去。
     例如，一个web系统整天都在作web请求的响应，他不需要您输入任何东西就能完成，
     这个类别的另一个例子就是把email的传送。
     </para>
 
     <para>我们把那些程序叫 <firstterm>守护进程</firstterm>。
     守护神是希腊神话中的一些人物，非正非邪，他们是些守护小精灵， 大体上为人类作出贡献。
     许多类似web服务或mail服务的系统对于今天仍有用途，
     这就是为什么在那么长的时间里，BSD的吉祥物保持为一双鞋加一把钢叉的守护神模样。
     </para>
 
     <para>守护进程的程序命名通常在最后加一个 <quote>d</quote>。
     <application>BIND</application> 是伯克利互联网域名服务 (而实际执行的程序名称则是
       <command>named</command>)，
       <application>Apache</application> web系统的程序就叫 <command>httpd</command>，
       在行式打印机上的打印守护进程就是 <command>lpd</command>。
       这只是一种惯例，不是标准或硬性规定。
       例如，为<application>Sendmail</application>而应用的主要mail守护进程就叫<command>sendmail</command>，
       却不叫<command>maild</command>，这和您推测的一样。
       </para>
 
     <para>有时可能会需要与守护进程进行通讯。 而 <firstterm>信号</firstterm> 则是其中的一种通讯机制。
     可以发送信号给守护进程 (或相关的另一些进程) 来与它进行通信，
     不同的信号都有自己的数字编号&mdash;其中一些有特殊的含义，
     其它的则可以被应用程序自己进行解释， 而一般来说，
     应用程序的文档会告诉哪些信号会被如何处理。
      您只能给所属于您的进程发信号，假如您给其他人的进程发信号，
      进程就会用&man.kill.1; 或 &man.kill.2;权限进行拒绝。
       当然,<systemitem class="username">root</systemitem> 用户会例外，它能把各种信号发送给每个进程。
       </para>
 
     <para>在某些情况下，FreeBSD也会向应用软件发送信号。
     假如一个应用软件含有恶意写入并试图去访问内存，那是不可想象的，FreeBSD会向那个进程发送
     <firstterm>段式违规</firstterm> 信号 (<literal>SIGSEGV</literal>)。
     假如一个应用软件使用&man.alarm.3;系统去进行周期性调用闹钟功能，每当达到时间时，
     FreeBSD会向应用软件发送闹钟信号(<literal>SIGALRM</literal>)。
     </para>
 
     <para>有两个信号可以停止进程:<literal>SIGTERM</literal> 和 <literal>SIGKILL</literal>。
       <literal>SIGTERM</literal>比较友好，进程能<emphasis>捕捉</emphasis>这个信号，
       根据您的需要来关闭程序。在关闭程序之前，您可以结束打开的记录文件和完成正在做的任务。
       在某些情况下， 假如进程正在进行作业而且不能中断，那么进程可以忽略这个
       <literal>SIGTERM</literal>信号。
      </para>
 
     <para>对于<literal>SIGKILL</literal>信号，进程是不能忽略的。 这是一个
        '<quote>我不管您在做什么,立刻停止</quote>'的信号。
       假如您发送<literal>SIGKILL</literal>信号给进程，
       FreeBSD就将进程停止在那里。<footnote>
 	<para>有点不正确&mdash;少数的东西是不能中断的。
 	  例如， 假如进程试图读取网络上另一计算机上的文件，
 	  而那个的计算机会因为某些原因拿走了这个文件，
 	  那这个进程从上述情况来看是 <quote>不能中断</quote>。
       最终这个进程会超时，典型的两分钟。一出现超时进程将被杀死。
     </para>
       </footnote>.</para>
 
     <para>您可能会去使用
       <literal>SIGHUP</literal>、 <literal>SIGUSR1</literal> 和
       <literal>SIGUSR2</literal>信号。  这都是些通用的信号，各种应用程序都可以应用
       在各方面的信号发送。
       </para>
 
     <para>假如您改变了web系统的配置文件&mdash;并想web系统去重读它的配置，
     您可以停止然后再启动<command>httpd</command>。但这样做web系统会导致一个短暂
     的中断周期，那样是不受欢迎的。几乎所有的守护进程在编写时，都会指定对<literal>SIGHUP</literal>
     信号进行响应从而重读配置文件。
     所以， 最好的方法， 就不是杀死并重启
     <command>httpd</command>，
     而是发一个 <literal>SIGHUP</literal> 信号给它。
     因为在这方面没有一个标准，不同的守护进程有不同的用法，所以不了解时应读一下守护进程的文档。
      </para>
 
     <para>发送信号可用&man.kill.1; 命令， 请参考&man.kill.1;所列出的例子。
      </para>
 
     <procedure>
       <title>发送一个信号给进程</title>
 
       <para>这个例子显示了怎样去发一个信号给&man.inetd.8;。
       <command>inetd</command>配置文件是<filename>/etc/inetd.conf</filename>，
       如果想<command>inetd</command> 去重读文件系统的话，可以给它发一个<literal>SIGHUP</literal>
       信号。
 	  </para>
 
       <step>
 	<para>寻找您要发送信号的进程ID，可以用&man.ps.1; 加 &man.grep.1;来完成。
       &man.grep.1;命令被用在搜索输出方面，搜索您指定的字符串。
      这命令是由普通用户来执行的，而&man.inetd.8;是<systemitem class="username">root</systemitem>用户运行的，
      所以必须给&man.ps.1;带上<option>ax</option>选项。
      </para>
 
 	<screen>&prompt.user; <userinput>ps -ax | grep inetd</userinput>
   198  ??  IWs    0:00.00 inetd -wW</screen>
 
 	<para>得出 &man.inetd.8; PID号是198。 有时
 	  <literal>grep inetd</literal> 命令也出现在输出中，
 	  这是因为在这方面 &man.ps.1; 也是寻找列表中运行进程。</para>
       </step>
 
       <step>
 	<para>使用 &man.kill.1; 去发送信号。 因为 &man.inetd.8;
 	  是由 <systemitem class="username">root</systemitem>启动的， 您必须使用 &man.su.1; 去
 	  变为 <systemitem class="username">root</systemitem> 用户。</para>
 
 	<screen>&prompt.user; <userinput>su</userinput>
 <prompt>Password:</prompt>
 &prompt.root; <userinput>/bin/kill -s HUP 198</userinput></screen>
 
 	<para>和大多数 &unix; 命令一样， &man.kill.1; 如果完成了任务, 就不会给出任何消息。
 	假如您发送信号给一个不属于您的进程，
 	您会看到 <errorname>kill:
 	    <replaceable>PID</replaceable>: Operation not
 	    permitted</errorname>.
      假如输错了PID号，把信号发送到其他进程，那是坏事。
      或者您侥幸，把信号发送到不存在的进程，
      您会看见 <errorname>kill:
 	    <replaceable>PID</replaceable>: No such process</errorname>.</para>
 
 	<note>
 	  <title>为什么使用 <command>/bin/kill</command>?</title>
 
 	  <para>许多shell提供了内建 <command>kill</command> 命令，
 	    这样， shell就能直接发送信号，而不是运行 <filename>/bin/kill</filename>。
 	    这点非常有用， 但不同shell有不同的语法来指定发送信号的名字，
         与其试图把它们学完倒不如简单地直接使用
         <command>/bin/kill ...</command>。
         </para>
 	</note>
       </step>
     </procedure>
 
     <para>发送其他的信号也很相似，
       只要在命令行替换 <literal>TERM</literal> 或
       <literal>KILL</literal> 就行了。
      </para>
 
     <important>
       <para>在系统上随意杀死进程是个坏主意，特别是&man.init.8;，
 	它的进程ID是1，它非常特殊。可以运行
 	<command>/bin/kill -s KILL 1</command> 命令来让系统迅速关机。
 	当您按下 <keycap>Return</keycap> （回车）键之前，
 	<emphasis>一定要</emphasis> 详细检查您运行 &man.kill.1;
 	时所指定的参数。</para>
     </important>
   </sect1>
 
   <sect1 xml:id="shells">
     <title>Shells</title>
     <indexterm><primary>shells</primary></indexterm>
     <indexterm><primary>命令行</primary></indexterm>
 
     <para>在FreeBSD里，每日有一大堆工作是在命令行的界面完成的,那就叫做shell。
     一个shell的主要功能就是从输入取得命令然后去执行他。
     许多的shell同样能帮我们完成内建的每日功能，例如:文件管理、文件寻找、命令行编辑、
     宏指令和环境变量。FreeBSD内含了一些shell，例如:<command>sh</command>、Bourne Shell、
     <command>tcsh</command>和改良过的C-shell。
     另外也有些shell也可在FreeBSD的Ports得到，例如:<command>zsh</command>和<command>bash</command>。
     </para>
 
     <para>您想使用哪一种shell取决于您的喜好，
     假如您是C程序设计师，您可能选择一个C-like shell例如<command>tcsh</command>。
     假如您是从Linux过来的或是一个命令行的新手，您可能会试一下<command>bash</command>。
     这一点告诉我们每一个shell都有各自的特性，可能适用于您的工作环境，也可能不适用于您的工作环境。
      </para>
 
     <para>每个shell都有一个共通点就是文件名补全。
           输入命令或文件名的前几个字，然后按<keycap>Tab</keycap>键，就能靠shell的自动补全功能得出
           命令或文件名。这里有一个例子，假设您有两个文件叫
       <filename>foobar</filename> 和<filename>foo.bar</filename>，而您想删除
       <filename>foo.bar</filename>，  可这样在键盘上输入
       <command>rm fo[Tab].[Tab]</command>。</para>
 
     <para>那么shell就会输出 <command>rm
       foo[BEEP].bar</command>。</para>
 
     <para>这个[BEEP] 是这控制台铃声， 那个是告诉我们它不能完成文件名补全，因为有多个文件名符合。
       <filename>foobar</filename> 和
       <filename>foo.bar</filename> 都是以 <literal>fo</literal>开头， 它只可以补全到
       <literal>foo</literal>。  输入
       <literal>.</literal>并再按一次 <keycap>Tab</keycap>，shell才把其余的文件名全部显示出来。
       </para>
     <indexterm><primary>环境变量</primary></indexterm>
 
     <para>另一个特点就是shell利用环境变量运行。环境变量是贮存在shell环境空间上相对应的键和可变值，
       这个空间能够补程序从shell里读出，而且包含了许多程序的配置。
       这个一个常用环境变量列和其含义的列表：</para>
     <indexterm><primary>environment variables (环境变量)</primary></indexterm>
 
     <informaltable frame="none" pgwide="1">
       <tgroup cols="2">
 	<thead>
 	  <row>
 	    <entry>变量</entry>
 	    <entry>说明</entry>
 	  </row>
 	</thead>
 
 	<tbody>
 	  <row>
 	    <entry><envar>USER</envar></entry>
 	    <entry>当前登录进入的用户名。</entry>
 	  </row>
 
 	  <row>
 	    <entry><envar>PATH</envar></entry>
 	    <entry>搜索程序路径，以两点的冒号分隔开。</entry>
 	  </row>
 
 	  <row>
 	    <entry><envar>DISPLAY</envar></entry>
 	    <entry>假如有这个变量的话，就是X11显示器的网络名称。
      </entry>
 	  </row>
 
 	  <row>
 	    <entry><envar>SHELL</envar></entry>
 	    <entry>当前所用的shell。</entry>
 	  </row>
 
 	  <row>
 	    <entry><envar>TERM</envar></entry>
 	    <entry>用户终端的名字，通常用在确定终端的能力。</entry>
 	  </row>
 
 	  <row>
 	    <entry><envar>TERMCAP</envar></entry>
 	    <entry>各种终端功能所用终端分离编码的基本数据项目。</entry>
 	  </row>
 
 	  <row>
 	    <entry><envar>OSTYPE</envar></entry>
 	    <entry>操作系统类型，默认是FreeBSD。</entry>
 	  </row>
 
 	  <row>
 	    <entry><envar>MACHTYPE</envar></entry>
 	    <entry>是指系统上运行的CPU体系结构。
 	      </entry>
 	  </row>
 
 	  <row>
 	    <entry><envar>EDITOR</envar></entry>
 	    <entry>用户首选的文本编辑器。</entry>
 	  </row>
 
 	  <row>
 	    <entry><envar>PAGER</envar></entry>
 	    <entry>用户首选的文本页面调度程序 。</entry>
 	  </row>
 
 	  <row>
 	    <entry><envar>MANPATH</envar></entry>
 	    <entry>搜索联机手册路径，以两点的冒号分隔开。</entry>
 	  </row>
 	</tbody>
       </tgroup>
     </informaltable>
 
     <indexterm><primary>Bourne shells</primary></indexterm>
     <para>不同的shell设置环境变量也不相同。举个例子，
       在如<command>tcsh</command> 和 <command>csh</command>这样的C-Style shell，
       您必须使用<command>setenv</command>去设置环境变量。
       而在如<command>sh</command>和<command>bash</command>这样的Bourne shell，
       您必须使用<command>export</command>去设置当前环境变量。
       再举个例子，要去设置或改变<envar>EDITOR</envar>环境变量，
       在<command>csh</command>或<command>tcsh</command>下将<envar>EDITOR</envar>设为
       <filename>/usr/local/bin/emacs</filename>:</para>
 
     <screen>&prompt.user; <userinput>setenv EDITOR /usr/local/bin/emacs</userinput></screen>
 
     <para>而在Bourne shell下，则是:</para>
 
     <screen>&prompt.user; <userinput>export EDITOR="/usr/local/bin/emacs"</userinput></screen>
 
     <para>您也可以在命令行上加一个<literal>$</literal>字符在变量之前从而取得环境变量。
       举个例子，用<command>echo $TERM</command> 就会显示出<envar>$TERM</envar>的设定值，
       其实就是shell取得<envar>$TERM</envar>并传给<command>echo</command>来显示的。</para>
 
     <para>shell里有许多特别的字符代表着特别的资料，我们把叫做meta-characters。
       最常用的就是<literal>*</literal>字符，它可代表文件名的任何字符。
       这些特别字符应用到文件名全域方面。假如，输入
       <command>echo *</command>和输入
       <command>ls</command>的效果是相同的，其实就是 shell 取得了全部符合
       <literal>*</literal>的文件名，并传给
       <command>echo</command> 在命令行下显示出来。</para>
 
     <para>为了防止shell去分析这些特别字符， 我们可在它之前加一个
       <literal>\</literal>字符去说明它只是普通字符。
       <command>echo $TERM</command>就会显示出您的终端情况，
       而 <command>echo \$TERM</command> 就会显示出 <envar>$TERM</envar>
       这几个字。</para>
 
     <sect2 xml:id="changing-shells">
       <title>改变您用的Shell</title>
 
       <para>改变您的Shell的最简单方法是使用
 	<command>chsh</command> 命令。 执行 <command>chsh</command> 将根据您设定的<envar>EDITOR</envar>
 	环境变量进入到那个编辑器，假如没有设定，就会进入<command>vi</command>编辑器。
 	请改变<quote>Shell:</quote>这行对应值。</para>
 
       <para>您可使用<command>chsh</command> 的<option>-s</option>选项，
 	这样就能设置您的shell却又不用编辑器。假如您想把shell改为<command>bash</command>
 	可用下面的技巧。</para>
 
       <screen>&prompt.user; <userinput>chsh -s /usr/local/bin/bash</userinput></screen>
 
       <note>
 	<para>您使用的shells<emphasis>必须</emphasis>
 	  在<filename>/etc/shells</filename> 文件里列出。 假如您从
 	  <link linkend="ports">ports</link>里装一个shell， 那就不用做这步了。
 	  假如您手工装一个shell，那就要手工添加进去。</para>
 
       <para>举个例了子，假如您手工把 <command>bash</command>装到
 	<filename>/usr/local/bin</filename>里，您还要进行这一步:
 	</para>
 
       <screen>&prompt.root; <userinput>echo &quot;/usr/local/bin/bash&quot; &gt;&gt; /etc/shells</userinput></screen>
 
        <para>然后运行<command>chsh</command>。</para>
      </note>
    </sect2>
   </sect1>
 
   <sect1 xml:id="editors">
     <title>文本编辑器</title>
     <indexterm><primary>文本编辑器</primary></indexterm>
     <indexterm><primary>编辑器</primary></indexterm>
 
     <para>FreeBSD 的很多配置都可以通过编辑文本文件来完成。
       因此， 最好能熟悉某种文本编辑器。
       FreeBSD 基本系统中提供了一些， 您也可以从 Ports Collection
       安装其它编辑器。</para>
 
     <indexterm>
       <primary><command>ee</command></primary>
     </indexterm>
     <indexterm>
       <primary>editors</primary>
       <secondary><command>ee</command></secondary>
     </indexterm>
     <para>最容易学的而又简单的编辑器是
       <application>ee</application>编辑器， 是个标准的简易编辑器。  要启动
       <application>ee</application>，首先就要在命令行输入
       <command>ee filename</command>，
       <replaceable>filename</replaceable> 是一个要编辑的文件名。
       例如，要编辑 <filename>/etc/rc.conf</filename>就要输入
       <command>ee /etc/rc.conf</command>，在
       <command>ee</command>的控制内， 编辑器所有功能的操作方法都显示在最上方。
       这个<literal>^</literal> 字符代表
       键盘上的<keycap>Ctrl</keycap> 键， 所以<literal>^e</literal> 就是
       <keycombo action="simul"><keycap>Ctrl</keycap><keycap>e</keycap></keycombo>组合键。
       假如想离开<application>ee</application>，
       按<keycap>Esc</keycap>键，就可选择离开编辑器。
       当您修改了内容的时候，编辑器会提示您保存。</para>
 
     <indexterm>
       <primary><command>vi</command></primary>
     </indexterm>
     <indexterm>
       <primary>编辑器</primary>
       <secondary><command>vi</command></secondary>
     </indexterm>
     <indexterm>
       <primary><command>emacs</command></primary>
     </indexterm>
     <indexterm>
       <primary>编辑器</primary>
       <secondary><command>emacs</command></secondary>
     </indexterm>
     <para>FreeBSD本身也带许可多有强大功能的文本编辑器， 例如
       <application>vi</application>。还有其他在FreeBSD Ports里几种， 像
       <application>emacs</application> 和 <application>vim</application>。
       这些编辑器有着强大的功能，但同时学习起来比较复杂。
       不管怎样，假如您从事文字编辑方面的工作，
       学习如<application>vim</application> 或 <application>emacs</application>
       这些有强大功能的编辑器用法，
       在长时间工作里会帮您节省不少的时间。</para>
 
     <para>很多需要修改文件或打字输入的应用程序都会自动打开一个文本编辑器。
       更改默认使用的编辑器， 请设置 <envar>EDITOR</envar>
       环境变量。 参阅 <link linkend="shells">shells</link>
       以获取更多详细信息。</para>
   </sect1>
 
   <sect1 xml:id="basics-devices">
     <title>设备和设备节点</title>
 
     <para>在一个系统里，硬件描述通常用法就是一个设备对应一个术语，包括磁盘、打印机、显卡和键盘。
       当 FreeBSD 启动过程中，大多数的设备都能探测到并显示出来，
       您也可以查阅<filename>/var/run/dmesg.boot</filename>，
       引导时所有信息都在里面。</para>
 
     <para>例如， <filename>acd0</filename> 就是
       首个 IDE 光盘设备， 而 <filename>kbd0</filename>
       则代表键盘。</para>
 
     <para>在&unix;操作系统里，大多数设备存在的特殊访问文件就是叫做设备节点，
       他们都定位在<filename>/dev</filename>目录里。</para>
 
     <sect2>
       <title>建立设备节点</title>
       <para>当在系统中添加新设备或将附加设备的支持编译进内核之后，
 	都必须为其建立设备节点。</para>
 
       <sect3>
 	<title><literal>DEVFS</literal> (DEVice 文件系统)</title>
 
 	<para> 这个设备文件系统， 或叫 <literal>DEVFS</literal>，
 	  为内核的设备命名在整体文件系统命名里提供通道，
 	  并不是建立或更改设备节点，
 	  <literal>DEVFS</literal>只是为您的特别文件系统进行维护。</para>
 
 	<para>请参见 &man.devfs.5; 联机手册以了解更多细节。</para>
       </sect3>
     </sect2>
   </sect1>
 
   <sect1 xml:id="binary-formats">
     <title>二进制文件格式</title>
 
     <para>要理解为什么 &os; 使用 &man.elf.5; 格式， 您必须首先了解一些 &unix; 系统中的
       三种 <quote>主要</quote> 可执行文件格式的有关知识：</para>
 
     <itemizedlist>
       <listitem>
         <para>&man.a.out.5;</para>
 
         <para>是最古老和<quote>经典的</quote> &unix; 目标文件格式，
 	  这种格式在其文件的开始处有一个短小而又紧凑的首部，
 	  该首部带有一个魔幻数字，用来标识具体的格式(更多详情参见&man.a.out.5;)。
 	  这种格式包含3个要装载入内存的段：.text， .data， 和 .bss，以及
 	  一个符号表和一个字符串表。</para>
       </listitem>
 
       <listitem>
         <para><acronym>COFF</acronym></para>
 
         <para>SVR3目标文件格式。其文件头现在包括一个区段表(section table)，
           因此除了.text，.data，和.bss区段以外，您还可以包含其它的区段。</para>
       </listitem>
 
       <listitem>
         <para>&man.elf.5;</para>
 
         <para><acronym>COFF</acronym> 的后继， 其特点是可以有多个区段，
 	  并可以使用32位或64位的值。 它有一个主要的缺点：
 	  <acronym>ELF</acronym> 在其设计时假设每个系统体系结构只有一种 ABI。
 	  这种假设事实上相当错误， 甚至在商业化的SYSV世界中都是错误的
 	  (它们至少有三种ABI: SVR4, Solaris, SCO)。</para>
 
         <para>FreeBSD试图在某种程度上解决这个问题，它提供一个工具，可以
 	  对一个已知的<acronym>ELF</acronym>可执行文件
 	  <emphasis>标识</emphasis>它所遵从的ABI的信息。
 	  更多这方面的知识可以参见手册页&man.brandelf.1;</para>
       </listitem>
     </itemizedlist>
 
     <para>FreeBSD从<quote>经典</quote>阵营中来，因此使用了&man.a.out.5;格式，
     	众多BSD版本的发行(直到3.X分支的开始)也证明了这种格式的有效性。
     	虽然在那以前的某段时间，在FreeBSD系统上创建和运行<acronym>ELF</acronym>格式
     	的二进制可执行文件(和内核)也是可能的，但FreeBSD一开始并不积极<quote>进步</quote>
     	到使用<acronym>ELF</acronym>作为其缺省的格式。为什么？噢，当Linux阵营完成了
     	转换到<acronym>ELF</acronym>格式的痛苦历程后，却发现并不足以由此而放弃
     	<filename>a.out</filename>可执行文件格式，因为正是由于它们不灵活的，
     	基于跳转表的共享库机制，使得销售商和开发者们构建共享库非常困难。
     	直到已有的<acronym>ELF</acronym>工具提供了一种解决共享库问题的办法，
     	并被普遍认为是<quote>前进方向</quote>以后，迁徙的代价在FreeBSD界才被接受，
     	并由此完成了迁徙。FreeBSD的共享库机制其基础更类似于Sun &sunos;的共享库机制，
     	并且正因为此，其易用性很好。</para>
 
     <para>那么，为什么会有这么多不同的格式呢？</para>
 
     <para>回溯到蒙昧和黑暗的过去，那时只有简单的硬件。这种简单的硬件支撑了一个简单
     	和小型的系统。在这样的简单系统上(PDP-11)<filename>a.out</filename>格式
     	足以胜任表达二进制文件的任务。当人们将&unix;从这种简单的系统中移植出来的时候，
     	<filename>a.out</filename>格式被保留了下来，因为对于早期将&unix;移植到
     	Motorola 68k，VAXen等系统来说，它还是足够可用的。</para>
 
     <para>然后，一些聪明的硬件工程师认为，如果可以让软件完成一些简单的聪明操作，
     	那么他们就可以在硬件设计中减少若干门电路，并可以让CPU核心运行得更快。
     	当<filename>a.out</filename>格式用于这种新型的硬件系统时(现在我们叫它
     	<acronym>RISC</acronym>)，显得并不合适。因此，人们设计了许多新的格式
     	以便在这样的硬件系统上能获得比简单的<filename>a.out</filename>格式更优越
     	的性能。诸如<acronym>COFF</acronym>，<acronym>ECOFF</acronym>，还有其它
     	一些晦涩难懂的格式正是在这个阶段被发明出来的，人们也研究了这些格式的局限性，
     	慢慢地最终落实到<acronym>ELF</acronym>格式。</para>
 
     <para>同时，程序的大小变得越来越大，磁盘空间(以及物理内存)相对来说却仍然较小，
 	因此共享库的概念便产生了。VM系统也变得越来越复杂了。当所有这些进步都建立在
 	<filename>a.out</filename>格式的基础上的时候，它的可用性随着每个新特性
 	的产生就受到了严重考验。并且，人们还希望可以在运行时动态装载某些东西，或者
 	在初始化代码运行以后可以丢弃部分程序代码，以便节约主存储器和交换区。编程语言
 	也变得越来越复杂，人们希望可以在main()函数执行之前自动执行某些代码。为了实现
 	所有这些功能，人们对<filename>a.out</filename>格式作了很多改动(hack)，
 	他们在某个阶段里基本也是可行的。随着时间的推移，<filename>a.out</filename>格式
 	不得不增加大量的代码和复杂度来满足这些需求。虽然<acronym>ELF</acronym>格式
 	解决了许多这样的问题，但是从一个可用的系统迁移到另一个系统却是痛苦的。因此
 	直到继续保留<filename>a.out</filename>格式的代价比迁移到<acronym>ELF</acronym>格式
 	的代价还大的时候，人们才会最终转换到<acronym>ELF</acronym>格式。</para>
 
     <para>然而，随着时间的推移，FreeBSD系统本身的编译工具(特别是汇编器和装载器)
     	赖以派生的编译工具，其发展却形成了两个平行的分支。FreeBSD这个分支增加了共享库，
     	并修改了一些错误。而原先编写了这些工具的GNU人则重写了这些工具，并对交叉编译提供了
     	更简化的支持，还随意插入了不同格式的支持，等等。虽然很多人希望创建针对FreeBSD的
     	交叉编译器，但他们却并未如愿以偿，因为FreeBSD的<application>as</application>
     	和<application>ld</application>的源代码更为老旧，所以无法完成这个任务。
     	新的GNU工具链(<application>binutils</application>)则确实支持交叉编译，<acronym>ELF</acronym>
     	格式，共享库，C++扩展，等等。并且，由于很多供应商都发布<acronym>ELF</acronym>格式的
     	二进制文件，因而让FreeBSD能够运行它们将是一个很好的事情。</para>
 
     <para><acronym>ELF</acronym>格式比<filename>a.out</filename>格式开销要大些，同时也
     	允许基础系统有更好的扩展性。<acronym>ELF</acronym>格式的有关工具有着更好的维护，
     	并且提供交叉编译支持，这对许多人来说是很重要的。<acronym>ELF</acronym>格式可能会稍微
     	慢一些，但很难测量出来。另外，在这两者之间，有许多细节也是不同的，比如它们映射页面的方式，
     	处理初始化代码的方式，等等。所有这些都不太重要，但这也确实是不同之处。在将来的适当时候，
     	<filename>GENERIC</filename>内核将不再支持<filename>a.out</filename>格式，并且，
     	当不再需要运行遗留的<filename>a.out</filename>格式程序时，内核也将不再提供对其的支持。</para>
   </sect1>
 
   <sect1 xml:id="basics-more-information">
     <title>取得更多的资讯</title>
 
     <sect2 xml:id="basics-man">
       <title>联机手册</title>
       <indexterm><primary>联机手册</primary></indexterm>
 
       <para>最详细的使用说明文档莫过于 FreeBSD 里的联机手册了。
 	几乎每一个程序都会附上一份简短说明，
 	以介绍这个程序的的基本功能以及参数的用法。
 	我们能通过 <command>man</command> 命令来阅读这些说明， 而使用
 	<command>man</command> 命令却是简单的事情:</para>
 
       <screen>&prompt.user; <userinput>man command</userinput></screen>
 
       <para><literal>command</literal> 就是您要了解的命令命称。
         举个例子，想了解 <command>ls</command> 命令就输入:</para>
 
       <screen>&prompt.user; <userinput>man ls</userinput></screen>
 
       <para>这些在线手册分下列章节:</para>
 
       <orderedlist>
 	<listitem>
 	  <para>用户命令。</para>
 	</listitem>
 
 	<listitem>
 	  <para>系统调用以及错误代码。</para>
 	</listitem>
 
 	<listitem>
 	  <para>C 库文件里的函数说明。</para>
 	</listitem>
 
 	<listitem>
 	  <para>设备驱动程序。</para>
 	</listitem>
 
 	<listitem>
 	  <para>文件格式。</para>
 	</listitem>
 
 	<listitem>
 	  <para>游戏以及其他娱乐。</para>
 	</listitem>
 
 	<listitem>
 	  <para>各种资讯。</para>
 	</listitem>
 
 	<listitem>
 	  <para>系统维护以及命令。</para>
 	</listitem>
 
 	<listitem>
 	  <para>内核开发情况。</para>
 	</listitem>
       </orderedlist>
 
       <para>在某些情况下，同样的主题也会出现在在线手册的不同章节。
 	举个例子，系统里有<command>chmod</command>这个用户命令，而又有个
 	<function>chmod()</function> 系统调用。 在这种情形下，您应当向
 	<command>man</command> 命令指定需要的内容:
 	</para>
 
       <screen>&prompt.user; <userinput>man 1 chmod</userinput></screen>
 
       <para>这样就会显示出手册里的用户 <command>chmod</command> 命令。
 	传统上，我们在写入文档时把特定详细参考内容在在线手册括号里注明。
 	所以 &man.chmod.1; 是指 <command>chmod</command> 用户命令，
 	而 &man.chmod.2; 是指系统调用。
 	</para>
 
       <para>如果您已经知道命令的名字，只是不知道要怎样使用的话，那就比较好办。
 	但您连名字都不知道呢?这个时候您就可以利用 <command>man</command> 的搜寻功能，
 	它会在手册的介绍部份找寻您要搜寻的关键字，它的选项是 <option>-k</option>：</para>
 
       <screen>&prompt.user; <userinput>man -k mail</userinput></screen>
 
       <para>当您使用这个命令的时候，man会把介绍里含有<quote>mail</quote>关键字
       的命令列出来，实际上这和<command>apropos</command>命令的功能是相同的。</para>
 
       <para>有时您会看到<filename>/usr/bin</filename> 下有许多命令但不知他们的用途，
 	您只需这样做:</para>
 
 	<screen>&prompt.user; <userinput>cd /usr/bin</userinput>
 &prompt.user; <userinput>man -f *</userinput></screen>
 
 	<para>或者这样做</para>
 
 	<screen>&prompt.user; <userinput>cd /usr/bin</userinput>
 &prompt.user; <userinput>whatis *</userinput></screen>
 
 	<para>两个命令是一样的。</para>
     </sect2>
 
     <sect2 xml:id="basics-info">
       <title>GNU Info 文件</title>
       <indexterm><primary>Free软件基金会</primary></indexterm>
 
       <para>FreeBSD许多应用软件以及实用工具来自Free软件基金会(FSF)。
 	  作为手册的扩充，这些程序提供了一种更具有活力的超文档说明<literal>info</literal>，
 	  您可用<command>info</command>命令来阅读他们。
 	  假如您装上<application>emacs</application>，也能利用<application>emacs</application>
 	  的info模式来阅读。
 	</para>
 
       <para>使用 &man.info.1; 这个命令只需简单地输入:</para>
 
       <screen>&prompt.user; <userinput>info</userinput></screen>
 
       <para>想得到简单介绍， 请按 <literal>h</literal>。  想快速得到的命令说明，
 	请按 <literal>?</literal>。</para>
     </sect2>
   </sect1>
 </chapter>
diff --git a/zh_CN.UTF-8/books/handbook/bibliography/chapter.xml b/zh_CN.UTF-8/books/handbook/bibliography/chapter.xml
index a16969f774..bcea95139b 100644
--- a/zh_CN.UTF-8/books/handbook/bibliography/chapter.xml
+++ b/zh_CN.UTF-8/books/handbook/bibliography/chapter.xml
@@ -1,636 +1,636 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      The FreeBSD Chinese Documentation Project
 
-     Original Revision: r38244
+     Original Revision: 8c959e7027 (r38244)
      $FreeBSD$
 -->
 <appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="bibliography">
   <title>参考文献</title>
 
   <para>尽管手册页能够提供对于 FreeBSD 操作系统最为权威的参考资料，
     它们有时却不能告诉我们如何让整个系统很好地运转起来。 因此，
     一本关于 &unix; 系统管理的好书，
     以及一份好的用户手册是不可或缺的。</para>
   
   <sect1 xml:id="bibliography-freebsd">
     <title>关于 FreeBSD 的专业书籍与杂志</title>
 
     <para><emphasis>非英文的书籍和杂志：</emphasis></para>
 
     <itemizedlist>
       <listitem>
 	<para><link xlink:href="http://jdli.tw.FreeBSD.org/publication/book/freebsd2/index.htm">FreeBSD 入门与应用</link> (繁体中文)，
 	 出版商： <link xlink:href="http://www.drmaster.com.tw/">Drmaster</link>，
 	 1997. ISBN 9-578-39435-7.</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD 技术内幕 (简体中文译本)，
           <link xlink:href="http://www.hzbook.com/">机械工业出版社</link>。
           ISBN 7-111-10201-0。
 	</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD 使用大全 第一版 （简体中文），
 	  机械工业出版社。ISBN 7-111-07482-3。
 	</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD 使用大全 第二版 （简体中文），
 	  机械工业出版社。ISBN 7-111-10286-X。
 	</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD Handbook (第二版简体中文译本)，
 	  <link xlink:href="http://www.ptpress.com.cn/">人民邮电出版社</link>。ISBN 7-115-10541-3。
 	</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD 3.x Internet 高级服务器的架设与管理 （简体中文），
 	  <link xlink:href="http://www.tup.tsinghua.edu.cn/">清华大学出版社</link>。ISBN 7-900625-66-6。</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD &amp; Windows 集成组网实务 （简体中文），
 	  <link xlink:href="http://www.tdpress.com/">中国铁道出版社</link>。
 	    ISBN 7-113-03845-X。</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD 网站架设实务 （简体中文），
 	  中国铁道出版社。ISBN 7-113-03423-3。</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD for PC 98'ers (日文, 出版商：SHUWA System
 	  Co, LTD.  ISBN 4-87966-468-5 C3055 P2900E。</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD (日文, 出版商：CUTT. ISBN 4-906391-22-2
 	  C3055 P2400E.</para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.shoeisha.com/book/Detail.asp?bid=650">
 	    Complete Introduction to FreeBSD</link> （日文）,
 	  出版商：<link xlink:href="http://www.shoeisha.co.jp/">Shoeisha Co., Ltd</link>. ISBN 4-88135-473-6 P3600E.</para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.ascii.co.jp/pb/book1/shinkan/detail/1322785.html">
 	    Personal UNIX Starter Kit FreeBSD</link> （日文）,
 	  出版商：<link xlink:href="http://www.ascii.co.jp/">ASCII</link>.  ISBN 4-7561-1733-3 P3000E.</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD Handbook （日文译本）, 出版商：<link xlink:href="http://www.ascii.co.jp/">ASCII</link>.  ISBN 4-7561-1580-2
 	  P3800E.</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD mit Methode （德文）, 出版商：<link xlink:href="http://www.cul.de">Computer und Literatur Verlag</link>/Vertrieb Hanser, 1998.  ISBN 3-932311-31-0.</para>
       </listitem>
 
       <listitem>
         <para><link xlink:href="http://www.cul.de/freebsd.html">FreeBSD 4 - Installieren, Konfigurieren, Administrieren</link>
 	  （德文）, 出版商：<link xlink:href="http://www.cul.de">Computer und Literatur Verlag</link>, 2001.
 	  ISBN 3-932311-88-4.</para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.cul.de/freebsd.html">FreeBSD 5 - Installieren, Konfigurieren, Administrieren</link>
 	  （德文）, 出版商： <link xlink:href="http://www.cul.de">Computer und Literatur Verlag</link>, 2003.
 	  ISBN 3-936546-06-1.</para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.mitp.de/vmi/mitp/detail/pWert/1343/">
 	    FreeBSD de Luxe</link> (德文), 出版商：
 	    <link xlink:href="http://www.mitp.de">Verlag Modere Industrie</link>,
 	    2003. ISBN 3-8266-1343-0.
 	</para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.pc.mycom.co.jp/FreeBSD/install-manual.html">FreeBSD
 	  Install and Utilization Manual</link> （日文）, 出版商：
 	  <link xlink:href="http://www.pc.mycom.co.jp/">Mainichi Communications
 	    Inc.</link>，1998. ISBN 4-8399-0112-0.</para>
       </listitem>
 
       <listitem>
         <para>Onno W Purbo, Dodi Maryanto, Syahrial Hubbany, Widjil Widodo
 	<emphasis><link xlink:href="http://maxwell.itb.ac.id/">Building Internet
         Server with	FreeBSD</link></emphasis> （印尼文）, 
         出版商： <link xlink:href="http://www.elexmedia.co.id/">Elex Media Komputindo</link>.</para>
       </listitem>
 
       <listitem>
 	<para>Absolute BSD: The Ultimate Guide to FreeBSD （繁体中文）
 	  出版商： <link xlink:href="http://www.grandtech.com.tw/">GrandTech Press</link>, 2003.
 	  ISBN 986-7944-92-5.</para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.twbsd.org/cht/book/">The FreeBSD 6.0 Book</link>
 	  （繁体中文）， 出版商：Drmaster, 2006.
 	  ISBN 9-575-27878-X.</para>
       </listitem>
 
     </itemizedlist>
 
     <para><emphasis>英文版的书籍和杂志：</emphasis></para>
 
     <itemizedlist>
       <listitem>
 	<para><link xlink:href="http://www.absoluteFreeBSD.com/">Absolute
 	  FreeBSD, 2nd Edition:  The Complete Guide to FreeBSD</link>,
 	  出版商： <link xlink:href="http://www.nostarch.com/">No Starch Press</link>, 2007.
 	  ISBN: 978-1-59327-151-0</para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.freebsdmall.com/cgi-bin/fm/bsdcomp">
 	  The Complete FreeBSD</link>, 出版商：
 	  <link xlink:href="http://www.oreilly.com/">O'Reilly</link>, 2003.
 	  ISBN: 0596005164</para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.freebsd-corp-net-guide.com/">The
 	  FreeBSD Corporate Networker's Guide</link>, 出版商：
 	  <link xlink:href="http://www.awl.com/aw/">Addison-Wesley</link>, 2000.
 	  ISBN: 0201704811</para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://andrsn.stanford.edu/FreeBSD/introbook/">
 	  FreeBSD: An Open-Source Operating System for Your Personal
 	  Computer</link>， 出版商： The Bit Tree Press, 2001.
 	  ISBN: 0971204500</para>
       </listitem>
 
       <listitem>
 	<para>Teach Yourself FreeBSD in 24 Hours, 出版商：
 	  <link xlink:href="http://www.samspublishing.com/">Sams</link>, 2002.
 	  ISBN: 0672324245</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD 6 Unleashed，出版商：
 	  <link xlink:href="http://www.samspublishing.com/">Sams</link>, 2006.
 	  ISBN: 0672328755</para>
       </listitem>
 
       <listitem>
 	<para>FreeBSD: The Complete Reference, 出版商：
 	  <link xlink:href="http://books.mcgraw-hill.com">McGrawHill</link>, 2003.
 	  ISBN: 0072224096 </para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.bsdmag.org">BSD Magazine</link>,
 	  出版商： Software Press Sp. z o.o. SK.
 	  ISSN 1898-9144</para>
       </listitem>
 
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="bibliography-userguides">
     <title>用户指南</title>
 
     <itemizedlist>
       <listitem>
 	<para>Computer Systems Research Group, UC Berkeley.  <emphasis>4.4BSD
 	  User's Reference Manual</emphasis>.  O'Reilly &amp; Associates,
 	  Inc., 1994. ISBN 1-56592-075-9</para>
       </listitem>
 
       <listitem>
 	<para>Computer Systems Research Group, UC Berkeley.  <emphasis>4.4BSD
 	  User's Supplementary Documents</emphasis>. O'Reilly &amp;
 	  Associates, Inc., 1994. ISBN 1-56592-076-7</para>
       </listitem>
 
       <listitem>
 	<para><emphasis>UNIX in a Nutshell</emphasis>.  O'Reilly &amp;
 	  Associates, Inc., 1990. ISBN 093717520X</para>
       </listitem>
 
       <listitem>
 	<para>Mui, Linda.  <emphasis>What You Need To Know When You Can't Find
 	  Your UNIX System Administrator</emphasis>.  O'Reilly &amp;
 	  Associates, Inc., 1995. ISBN 1-56592-104-6</para>
       </listitem>
 
       <listitem>
 	<para>Ohio State University 编写了一份 <link xlink:href="http://www.cs.duke.edu/csl/docs/unix_course/">UNIX
           入门教程</link> 并提供了在线的 HTML 和
           PostScript 格式的版本。</para>
       </listitem>
 
       <listitem>
 	<para>这份文档的意大利文 <link xlink:href="&url.doc.base;/it_IT.ISO8859-15/books/unix-introduction/index.html">翻译</link>
 	    是 FreeBSD Italian Documentation Project 的一部分。</para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.jp.FreeBSD.org/">Jpman Project, Japan
           FreeBSD Users Group</link>.  <link xlink:href="http://www.pc.mycom.co.jp/FreeBSD/urm.html">FreeBSD User's
 	  Reference Manual</link> (日文译本). <link xlink:href="http://www.pc.mycom.co.jp/">Mainichi Communications
 	  Inc.</link>, 1998.  ISBN4-8399-0088-4 P3800E.</para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.ed.ac.uk/">Edinburgh
 	  University</link> has written an <link xlink:href="http://unixhelp.ed.ac.uk/">Online Guide</link> for
 	  newcomers to the UNIX environment.</para>
       </listitem>
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="bibliography-adminguides">
     <title>管理员指南</title>
 
     <itemizedlist>
       <listitem>
 	<para>Albitz, Paul and Liu, Cricket.  <emphasis>DNS and
 	  BIND</emphasis>, 4th Ed. O'Reilly &amp; Associates, Inc., 2001.
 	  ISBN 1-59600-158-4</para>
       </listitem>
 
       <listitem>
 	<para>Computer Systems Research Group, UC Berkeley.  <emphasis>4.4BSD
 	  System Manager's Manual</emphasis>.  O'Reilly &amp; Associates,
 	  Inc., 1994.  ISBN 1-56592-080-5</para>
       </listitem>
 
       <listitem>
 	<para>Costales, Brian, et al.  <emphasis>Sendmail</emphasis>, 2nd Ed.
 	  O'Reilly &amp; Associates, Inc., 1997. ISBN 1-56592-222-0</para>
       </listitem>
 
       <listitem>
 	<para>Frisch, &AElig;leen.  <emphasis>Essential System
 	  Administration</emphasis>, 2nd Ed. O'Reilly &amp; Associates,
 	  Inc., 1995.  ISBN 1-56592-127-5</para>
       </listitem>
 
       <listitem>
 	<para>Hunt, Craig.  <emphasis>TCP/IP Network
 	  Administration</emphasis>, 2nd Ed. O'Reilly &amp; Associates, Inc.,
 	  1997.  ISBN 1-56592-322-7</para>
       </listitem>
 
       <listitem>
 	<para>Nemeth, Evi.  <emphasis>UNIX System Administration
 	  Handbook</emphasis>.  3rd Ed. Prentice Hall, 2000.  ISBN
           0-13-020601-6</para>
       </listitem>
 
       <listitem>
 	<para>Stern, Hal <emphasis>Managing NFS and NIS</emphasis> O'Reilly
 	  &amp; Associates, Inc., 1991.  ISBN 0-937175-75-7</para>
       </listitem>
 
       <listitem>
 	<para><link xlink:href="http://www.jp.FreeBSD.org/">Jpman Project, Japan
           FreeBSD Users Group</link>.  <link xlink:href="http://www.pc.mycom.co.jp/FreeBSD/sam.html">FreeBSD System
 	  Administrator's Manual</link> (日文译本). <link xlink:href="http://www.pc.mycom.co.jp/">Mainichi Communications
 	  Inc.</link>, 1998.  ISBN4-8399-0109-0 P3300E.</para>
       </listitem>
 
       <listitem>
 	<para>Dreyfus, Emmanuel.  <link xlink:href="http://www.eyrolles.com/Informatique/Livre/9782212114638/">Cahiers
 	  de l'Admin: BSD</link> 2nd Ed. (in French), Eyrolles, 2004.
 	  ISBN 2-212-11463-X</para>
       </listitem>
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="bibliography-programmers">
     <title>开发指南</title>
 
     <itemizedlist>
       <listitem>
 	<para>Asente, Paul, Converse, Diana, and Swick, Ralph.
 	  <emphasis>X Window System Toolkit</emphasis>.  Digital Press,
 	  1998.  ISBN 1-55558-178-1</para>
       </listitem>
 
       <listitem>
 	<para>Computer Systems Research Group, UC Berkeley.  <emphasis>4.4BSD
 	  Programmer's Reference Manual</emphasis>. O'Reilly &amp;
 	  Associates, Inc., 1994.  ISBN 1-56592-078-3</para>
       </listitem>
 
       <listitem>
 	<para>Computer Systems Research Group, UC Berkeley.  <emphasis>4.4BSD
 	  Programmer's Supplementary Documents</emphasis>.  O'Reilly &amp;
 	  Associates, Inc., 1994.  ISBN 1-56592-079-1</para>
       </listitem>
 
       <listitem>
 	<para>Harbison, Samuel P. and Steele, Guy L. Jr.  <emphasis>C: A
 	  Reference Manual</emphasis>.  4th ed. Prentice Hall, 1995.
 	  ISBN 0-13-326224-3</para>
       </listitem>
 
       <listitem>
 	<para>Kernighan, Brian and Dennis M. Ritchie.  <emphasis>The C
 	  Programming Language</emphasis>.  2nd Ed. PTR Prentice Hall, 1988.
 	  ISBN 0-13-110362-8</para>
       </listitem>
 
       <listitem>
 	<para>Lehey, Greg.  <emphasis>Porting UNIX Software</emphasis>.
 	  O'Reilly &amp; Associates, Inc., 1995.  ISBN 1-56592-126-7</para>
       </listitem>
 
       <listitem>
 	<para>Plauger, P. J. <emphasis>The Standard C Library</emphasis>.
 	  Prentice Hall, 1992.  ISBN 0-13-131509-9</para>
       </listitem>
 
       <listitem>
 	<para>Spinellis, Diomidis.  <link xlink:href="http://www.spinellis.gr/codereading/"><emphasis>Code
 	  Reading: The Open Source Perspective</emphasis></link>.
 	  Addison-Wesley, 2003.  ISBN 0-201-79940-5</para>
       </listitem>
 
       <listitem>
 	<para>Spinellis, Diomidis.  <link xlink:href="http://www.spinellis.gr/codequality/"><emphasis>Code
 	  Quality: The Open Source Perspective</emphasis></link>.
 	  Addison-Wesley, 2006.  ISBN 0-321-16607-8</para>
       </listitem>
 
       <listitem>
 	<para>Stevens, W. Richard and Stephen A. Rago.
 	<emphasis>Advanced Programming in the UNIX
 	  Environment</emphasis>.  2nd Ed.
 	  Reading, Mass. : Addison-Wesley, 2005.
 	  ISBN 0-201-43307-9</para>
       </listitem>
 
       <listitem>
 	<para>Stevens, W. Richard.  <emphasis>UNIX Network
 	  Programming</emphasis>.  2nd Ed, PTR Prentice Hall, 1998.  ISBN
 	  0-13-490012-X</para>
       </listitem>
 
       <listitem>
 	<para>Wells, Bill.  <quote>Writing Serial Drivers for UNIX</quote>.
 	  <emphasis>Dr. Dobb's Journal</emphasis>. 19(15), December 1994.
 	  pp68-71, 97-99.</para>
       </listitem>
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="bibliography-osinternals">
     <title>操作系统原理</title>
 
     <itemizedlist>
       <listitem>
 	<para>Andleigh, Prabhat K.  <emphasis>UNIX System
 	  Architecture</emphasis>.  Prentice-Hall, Inc., 1990.  ISBN
           0-13-949843-5</para>
       </listitem>
 
       <listitem>
 	<para>Jolitz, William.  <quote>Porting UNIX to the 386</quote>.
 	  <emphasis>Dr. Dobb's Journal</emphasis>.  1991年1月 - 1992年6月 </para>
       </listitem>
 
       <listitem>
 	<para>Leffler, Samuel J., Marshall Kirk McKusick, Michael J Karels and
 	  John Quarterman <emphasis>The Design and Implementation of the
 	  4.3BSD UNIX Operating System</emphasis>.  Reading, Mass. :
 	  Addison-Wesley, 1989.  ISBN 0-201-06196-1</para>
       </listitem>
 
       <listitem>
 	<para>Leffler, Samuel J., Marshall Kirk McKusick, <emphasis>The Design
 	  and Implementation of the 4.3BSD UNIX Operating System: Answer
 	  Book</emphasis>.  Reading, Mass. : Addison-Wesley, 1991.  ISBN
           0-201-54629-9</para>
       </listitem>
 
       <listitem>
 	<para>McKusick, Marshall Kirk, Keith Bostic, Michael J Karels, and
 	  John Quarterman.  <emphasis>The Design and Implementation of the
 	  4.4BSD Operating System</emphasis>.  Reading, Mass. :
 	  Addison-Wesley, 1996.  ISBN 0-201-54979-4</para>
 
 	<para>(这本书的第二章的 <link xlink:href="&url.books.design-44bsd;/book.html">在线版本</link> 是
 	  FreeBSD Documentation Project 的一部分。)</para>
       </listitem>
 
       <listitem>
 	<para>Marshall Kirk McKusick, George V. Neville-Neil <emphasis>The
 	  Design and Implementation of the FreeBSD Operating
 	  System</emphasis>.   Boston, Mass. : Addison-Wesley, 2004.
 	  ISBN 0-201-70245-2</para>
       </listitem>
 
       <listitem>
 	<para>Stevens, W. Richard.  <emphasis>TCP/IP Illustrated, Volume 1:
 	  The Protocols</emphasis>.  Reading, Mass. : Addison-Wesley,
 	  1996.  ISBN 0-201-63346-9</para>
       </listitem>
 
       <listitem>
 	<para>Schimmel, Curt.  <emphasis>Unix Systems for Modern
 	  Architectures</emphasis>.  Reading, Mass. : Addison-Wesley, 1994.
 	  ISBN 0-201-63338-8</para>
       </listitem>
 
       <listitem>
 	<para>Stevens, W. Richard.  <emphasis>TCP/IP Illustrated, Volume 3:
 	  TCP for Transactions, HTTP, NNTP and the UNIX Domain
 	  Protocols</emphasis>.  Reading, Mass. : Addison-Wesley, 1996.
 	  ISBN 0-201-63495-3</para>
       </listitem>
 
       <listitem>
 	<para>Vahalia, Uresh.  <emphasis>UNIX Internals -- The New
 	  Frontiers</emphasis>.  Prentice Hall, 1996.  ISBN
           0-13-101908-2</para>
       </listitem>
 
       <listitem>
 	<para>Wright, Gary R. and W. Richard Stevens.  <emphasis>TCP/IP
 	  Illustrated, Volume 2: The Implementation</emphasis>. Reading,
 	  Mass. : Addison-Wesley, 1995.  ISBN 0-201-63354-X</para>
       </listitem>
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="bibliography-security">
     <title>安全方面的参考文献</title>
 
     <itemizedlist>
       <listitem>
 	<para>Cheswick, William R. and Steven M. Bellovin. <emphasis>Firewalls
 	  and Internet Security: Repelling the Wily Hacker</emphasis>.
 	  Reading, Mass. : Addison-Wesley, 1995.  ISBN
 	  0-201-63357-4</para>
       </listitem>
 
       <listitem>
 	<para>Garfinkel, Simson and Gene Spafford.
 	  <emphasis>Practical UNIX &amp; Internet Security</emphasis>.
 	  2nd Ed. O'Reilly &amp; Associates, Inc., 1996.  ISBN
 	  1-56592-148-8</para>
       </listitem>
 
       <listitem>
 	<para>Garfinkel, Simson.  <emphasis>PGP Pretty Good
 	  Privacy</emphasis> O'Reilly &amp; Associates, Inc., 1995.  ISBN
           1-56592-098-8</para>
       </listitem>
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="bibliography-hardware">
     <title>硬件参考</title>
 
     <itemizedlist>
       <listitem>
 	<para>Anderson, Don and Tom Shanley.  <emphasis>Pentium Processor
 	  System Architecture</emphasis>.  2nd Ed. Reading, Mass. :
 	  Addison-Wesley, 1995.  ISBN 0-201-40992-5</para>
       </listitem>
 
       <listitem>
 	<para>Ferraro, Richard F.  <emphasis>Programmer's Guide to the EGA,
 	  VGA, and Super VGA Cards</emphasis>.  3rd ed. Reading, Mass. :
 	  Addison-Wesley, 1995.  ISBN 0-201-62490-7</para>
       </listitem>
 
       <listitem>
 	<para>Intel 公司在他们的 <link xlink:href="http://developer.intel.com/">开发人员网站</link>上,
 	  提供了关于他们的 CPU，芯片组，以及标准的文档。多数是PDF文件.</para>
       </listitem>
 
       <listitem>
 	<para>Shanley, Tom.  <emphasis>80486 System Architecture</emphasis>.
 	  3rd ed. Reading, Mass. : Addison-Wesley, 1995.  ISBN
 	  0-201-40994-1</para>
       </listitem>
 
       <listitem>
 	<para>Shanley, Tom.  <emphasis>ISA System Architecture</emphasis>.
 	  3rd ed. Reading, Mass. : Addison-Wesley, 1995.  ISBN
 	  0-201-40996-8</para>
       </listitem>
 
       <listitem>
 	<para>Shanley, Tom.  <emphasis>PCI System Architecture</emphasis>.
 	  4th ed. Reading, Mass. : Addison-Wesley, 1999.  ISBN
 	  0-201-30974-2</para>
       </listitem>
 
       <listitem>
 	<para>Van Gilluwe, Frank.  <emphasis>The Undocumented PC</emphasis>,
 	  2nd Ed.  Reading, Mass: Addison-Wesley Pub. Co., 1996.  ISBN
 	  0-201-47950-8</para>
       </listitem>
 
       <listitem>
 	<para>Messmer, Hans-Peter.  <emphasis>The Indispensable PC Hardware
 	  Book</emphasis>, 4th Ed.
 	  Reading, Mass: Addison-Wesley Pub. Co., 2002.  ISBN
 	  0-201-59616-4</para>
       </listitem>
 
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="bibliography-history">
     <title>&unix; 历史</title>
 
     <itemizedlist>
       <listitem>
 	<para>Lion, John <emphasis>Lion's Commentary on UNIX, 6th Ed. With
 	  Source Code</emphasis>.  ITP Media Group, 1996.  ISBN
 	  1573980137</para>
       </listitem>
 
       <listitem>
 	<para>Raymond, Eric S.  <emphasis>The New Hacker's Dictionary, 3rd
 	  edition</emphasis>.  MIT Press, 1996.  ISBN
 	  0-262-68092-0.  它也被称作 <link xlink:href="http://www.catb.org/~esr/jargon/html/index.html">Jargon
 	  File</link></para>
       </listitem>
 
       <listitem>
 	<para>Salus, Peter H.  <emphasis>A quarter century of UNIX</emphasis>.
 	  Addison-Wesley Publishing Company, Inc., 1994.  ISBN
 	  0-201-54777-5</para>
       </listitem>
 
       <listitem>
 	<para>Simon Garfinkel, Daniel Weise, Steven Strassmann. <emphasis>The
 	  UNIX-HATERS Handbook</emphasis>.  IDG Books Worldwide, Inc.,
 	  1994.  ISBN 1-56884-203-1.  Out of print, but available <link xlink:href="http://www.simson.net/ref/ugh.pdf">online</link>.</para>
       </listitem>
 
       <listitem>
 	<para>Don Libes, Sandy Ressler <emphasis>Life with UNIX</emphasis>
 	  &mdash; special edition.  Prentice-Hall, Inc., 1989.  ISBN
           0-13-536657-7</para>
       </listitem>
 
       <listitem>
 	<para><emphasis>BSD 族谱</emphasis>.
 	  <uri xlink:href="http://www.FreeBSD.org/cgi/cvsweb.cgi/src/share/misc/bsd-family-tree">http://www.FreeBSD.org/cgi/cvsweb.cgi/src/share/misc/bsd-family-tree</uri>
 	   或在 FreeBSD 机器上的 <link xlink:href="file://localhost/usr/share/misc/bsd-family-tree"><filename>/usr/share/misc/bsd-family-tree</filename></link>
 	   。</para>
       </listitem>
 
       <listitem>
 	<para><emphasis>Networked Computer Science Technical Reports
 	  Library</emphasis>.  <uri xlink:href="http://www.ncstrl.org/">http://www.ncstrl.org/</uri></para>
       </listitem>
 
       <listitem>
 	<para><emphasis>Old BSD releases from the Computer Systems Research
 	  group (CSRG)</emphasis>.
 	  <uri xlink:href="http://www.mckusick.com/csrg/">http://www.mckusick.com/csrg/</uri>:
 	  The 4CD set covers all BSD versions from 1BSD to 4.4BSD and
 	  4.4BSD-Lite2 (but not 2.11BSD, unfortunately).  The last
 	  disk also holds the final sources plus the SCCS files.</para>
       </listitem>
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="bibliography-journals">
     <title>各种期刊</title>
 
     <itemizedlist>
       <listitem>
 	<para><emphasis>The C/C++ Users Journal</emphasis>.  R&amp;D
 	  Publications Inc.  ISSN 1075-2838</para>
       </listitem>
 
       <listitem>
 	<para><emphasis>Sys Admin &mdash; The Journal for UNIX System
 	  Administrators</emphasis> Miller Freeman, Inc., ISSN
 	  1061-2688</para>
       </listitem>
 
       <listitem>
 	<para><emphasis>freeX &mdash; Das Magazin f&uuml;r Linux - BSD - UNIX</emphasis>
 	  (德文) Computer- und Literaturverlag GmbH, ISSN 1436-7033</para>
       </listitem>
 
     </itemizedlist>
   </sect1>
 </appendix>
diff --git a/zh_CN.UTF-8/books/handbook/book.xml b/zh_CN.UTF-8/books/handbook/book.xml
index 5cb7d00565..4e7d714072 100644
--- a/zh_CN.UTF-8/books/handbook/book.xml
+++ b/zh_CN.UTF-8/books/handbook/book.xml
@@ -1,308 +1,308 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE book PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
 	"http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" [
 <!ENTITY % chapters SYSTEM "chapters.ent">
 %chapters;
 <!ENTITY % txtfiles SYSTEM "txtfiles.ent">
 %txtfiles;
 ]>
 <!--
      The FreeBSD Documentation Project
      The FreeBSD Simplified Chinese Documentation Project
 
-     Original Revision: r38410
+     Original Revision: cbc1c2d0dd (r38410)
      $FreeBSD$
 -->
 <book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="zh_cn">
   <info><title>FreeBSD 使用手册</title>
     
 
     <author><orgname>The FreeBSD Documentation Project</orgname></author>
 
     <pubdate>1999 年 2 月</pubdate>
 
     <releaseinfo>$FreeBSD$</releaseinfo>
 
     <copyright>
       <year>1995</year>
       <year>1996</year>
       <year>1997</year>
       <year>1998</year>
       <year>1999</year>
       <year>2000</year>
       <year>2001</year>
       <year>2002</year>
       <year>2003</year>
       <year>2004</year>
       <year>2005</year>
       <year>2006</year>
       <year>2007</year>
       <year>2008</year>
       <year>2009</year>
       <year>2010</year>
       <year>2011</year>
       <year>2012</year>
       <holder>The FreeBSD Documentation Project</holder>
     </copyright>
 
     <author><orgname>&cnproj.freebsd.org;</orgname></author>
     <pubdate>2005 年 12 月</pubdate>
 
     <copyright>
       <year>2003</year>
       <year>2004</year>
       <year>2005</year>
       <year>2006</year>
       <year>2007</year>
       <year>2008</year>
       <year>2009</year>
       <year>2010</year>
       <year>2011</year>
       <year>2012</year>
       <holder>&cnproj.freebsd.org;</holder>
     </copyright>
 
     &legalnotice;
 
     <legalnotice xml:id="trademarks" role="trademarks">
       &tm-attrib.freebsd;
       &tm-attrib.3com;
       &tm-attrib.3ware;
       &tm-attrib.arm;
       &tm-attrib.adaptec;
       &tm-attrib.adobe;
       &tm-attrib.apple;
       &tm-attrib.corel;
       &tm-attrib.creative;
       &tm-attrib.cvsup;
       &tm-attrib.heidelberger;
       &tm-attrib.ibm;
       &tm-attrib.ieee;
       &tm-attrib.intel;
       &tm-attrib.intuit;
       &tm-attrib.linux;
       &tm-attrib.lsilogic;
       &tm-attrib.m-systems;
       &tm-attrib.macromedia;
       &tm-attrib.microsoft;
       &tm-attrib.netscape;
       &tm-attrib.nexthop;
       &tm-attrib.opengroup;
       &tm-attrib.oracle;
       &tm-attrib.powerquest;
       &tm-attrib.realnetworks;
       &tm-attrib.redhat;
       &tm-attrib.sap;
       &tm-attrib.sun;
       &tm-attrib.symantec;
       &tm-attrib.themathworks;
       &tm-attrib.thomson;
       &tm-attrib.usrobotics;
       &tm-attrib.vmware;
       &tm-attrib.waterloomaple;
       &tm-attrib.wolframresearch;
       &tm-attrib.xfree86;
       &tm-attrib.xiph;
       &tm-attrib.general;
     </legalnotice>
 
     <abstract>
       <para>欢迎使用 FreeBSD！ 本手册适用于安装
 	<emphasis>FreeBSD &rel2.current;-RELEASE</emphasis> 和
 	<emphasis>FreeBSD &rel.current;-RELEASE</emphasis> 以及它们的日常使用。
 	这个手册目前由很多人 <emphasis>持续地</emphasis> 维护。
 	其中的内容需要不断地更新。 如果您有兴趣参加这个项目，
 	请发邮件到 &a.doc;。 此文档最新的英文原始版本可以从
 	<link xlink:href="http://www.FreeBSD.org/">FreeBSD 网站</link>
 	上获得
 	(本手册的较早期版本可以在 
 	<uri xlink:href="http://docs.FreeBSD.org/doc/">http://docs.FreeBSD.org/doc/</uri> 找到)。
 	由 <link xlink:href="&cnproj.url.base;/">&cnproj.freebsd.org;</link>
 	维护的最新译本可以在 <link xlink:href="&cnsnap.url.base;/zh_CN/">&cnproj.freebsd.org;
 	  快照网站</link> 获得， 这一译本会持续地向主站同步。
 	此外， 您也可以从
 	<link xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">FreeBSD
 	  FTP 服务器</link> 及其众多
 	<link linkend="mirrors-ftp">镜像站点</link>
 	取得这份文档的各种其它格式， 以及压缩形式的版本。
 	如果您希望得到一份印刷版本的手册， 可以从
 	<link xlink:href="http://www.freebsdmall.com/">FreeBSD Mall</link>
 	购买。 除此之外， 您还可以
 	<link xlink:href="&url.base;/search/index.html">在手册中搜索内容</link>。</para>
     </abstract>
   </info>
 
   &chap.preface;
 
   <part xml:id="getting-started">
     <title>起步</title>
 
     <partintro>
       <para>手册的以下章节主要是针对刚开始使用 FreeBSD 的用户及管理员:</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>FreeBSD 入门。</para>
 	</listitem>
 
 	<listitem>
 	  <para>安装过程向导。</para>
 	</listitem>
 
 	<listitem>
 	  <para>教您 &unix; 基本知识和基本原理。</para>
 	</listitem>
 
 	<listitem>
 	  <para>展示如何在 FreeBSD 上安装大量的第三方应用程序。</para>
 	</listitem>
 
 	<listitem>
 	  <para>介绍使用 X，&unix; 窗口系统，
 	    以及为一些能够提高工作效率的桌面环境配置细节。</para>
 	</listitem>
       </itemizedlist>
 
       <para>我们尝试用最少的页数来保持前言的索引，以至于可以用最少翻页次数将该手册从头至尾读过。</para>
     </partintro>
 
     &chap.introduction;
     &chap.install;
     &chap.bsdinstall;
     &chap.basics;
     &chap.ports;
     &chap.x11;
   </part>
 
   <part xml:id="common-tasks">
     <title>常见的任务</title>
 
     <partintro>
       <para>前面已经介绍了必要的基础知识， 手册的这一部分将讨论
 	FreeBSD 的一些最常用的功能。 这些章节包括：</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>向您介绍流行和实用的桌面应用程序：
 	    浏览器、产品工具、文档察看程序，等等。</para>
 	</listitem>
 
 	<listitem>
 	  <para>向您介绍一系列可以在 FreeBSD 上使用的多媒体工具。</para>
 	</listitem>
 
 	<listitem>
 	  <para>介绍联编定制的 FreeBSD 内核以启用附加功能的方法。</para>
 	</listitem>
 
         <listitem>
 	  <para>详细介绍包括桌面和网络打印机在内的打印系统设置。</para>
         </listitem>
 
         <listitem>
 	  <para>向您展示如何在 FreeBSD 上运行 Linux 应用程序。</para>
         </listitem>
 
       </itemizedlist>
 
       <para>某些章节希望您首先阅读过其他部分，
 	在这些章的开头部分也会给出类似的提示。</para>
     </partintro>
 
     &chap.desktop;
     &chap.multimedia;
     &chap.kernelconfig;
     &chap.printing;
     &chap.linuxemu;
   </part>
 
   <part xml:id="system-administration">
     <title>系统管理</title>
 
     <partintro>
       <para>FreeBSD 手册中其余章节的内容都是关于系统管理。
 	每一章节都从描述这章将要介绍的内容开始，
 	由浅入深对相关内容进行介绍。</para>
 
       <para>这些章节在撰写时， 已经设计成了许多相互独立的部分，
 	如果您需要了解某部分内容， 直接阅读这部分内容即可，
 	而无需按照顺序， 也不必在您开始使用 FreeBSD
 	之前完整地阅读它们。</para>
     </partintro>
 
     &chap.config;
     &chap.boot;
     &chap.users;
     &chap.security;
     &chap.jails;
     &chap.mac;
     &chap.audit;
     &chap.disks;
     &chap.geom;
     &chap.filesystems;
     &chap.vinum;
     &chap.virtualization;
     &chap.l10n;
     &chap.cutting-edge;
     &chap.dtrace;
   </part>
 
   <part xml:id="network-communication">
     <title>网络通讯</title>
 
     <partintro>
       <para>FreeBSD 是目前以高性能网络服务为目的而部署范围最广的操作系统之一。
 	讨论这些话题的章节包括：</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>串口通讯</para>
 	</listitem>
 
 	<listitem>
 	  <para>PPP 和以太网上的 PPP</para>
 	</listitem>
 
 	<listitem>
 	  <para>电子邮件</para>
 	</listitem>
 
 	<listitem>
 	  <para>运行网络服务</para>
 	</listitem>
 
 	<listitem>
 	  <para>防火墙</para>
 	</listitem>
 
 	<listitem>
 	  <para>其他进阶网络话题</para>
 	</listitem>
       </itemizedlist>
 
       <para>这些章节主要供您在需要时参考。
 	不必按特定的顺序来阅读它们， 此外，
 	您开始在网络中使用 FreeBSD 之前也不需要先把它们都读完。</para>
     </partintro>
 
     &chap.serialcomms;
     &chap.ppp-and-slip;
     &chap.mail;
     &chap.network-servers;
     &chap.firewalls;
     &chap.advanced-networking;
 
   </part>
 
   <part xml:id="appendices">
     <title>附录</title>
 
     &chap.mirrors;
     &chap.bibliography;
     &chap.eresources;
     &chap.pgpkeys;
   </part>
   &chap.freebsd-glossary;
   &chap.index;
   &chap.colophon;
 </book>
diff --git a/zh_CN.UTF-8/books/handbook/boot/chapter.xml b/zh_CN.UTF-8/books/handbook/boot/chapter.xml
index 4057b891e1..7a696a4568 100644
--- a/zh_CN.UTF-8/books/handbook/boot/chapter.xml
+++ b/zh_CN.UTF-8/books/handbook/boot/chapter.xml
@@ -1,849 +1,849 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      The FreeBSD Documentation Project
      The FreeBSD Chinese (Simplified) Project
 
-     Original Revision: r36653
+     Original Revision: fffad858e3 (r36653)
      $FreeBSD$
 -->
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="boot"> <title>FreeBSD 引导过程</title>
 
   <sect1 xml:id="boot-synopsis"> <title>概述</title>
   <indexterm><primary>引导</primary></indexterm>
 
     <para>启动电脑以及加载操作系统的过程被称为<quote>引导过程</quote>，
       或者简称为<quote>引导</quote>。
       FreeBSD 的引导过程给用户自定义启动提供了很大的伸缩性，
       您可以选择启动不同的操作系统，或者是同一系统的不同版本及内核。</para>
     <para>本章将详细介绍您能在 FreeBSD 引导过程中设置的配置选项。
       这包括了引导内核、探测设备并启动 &man.init.8; 等等之前所发生的所有事情。
       这些事项一般发生在文本由白变灰时。</para>
 
     <para>读完这章您将会知道：</para>
 
     <itemizedlist>
       <listitem>
 	<para>FreeBSD 引导系统里的各项组件，
 	  以及它们之间的交互方式.</para>
       </listitem>
 
       <listitem>
 	<para>在 FreeBSD 引导时给各组件配置选项以控制引导过程。</para>
       </listitem>
 
       <listitem>
 	<para> &man.device.hints.5;的基本知识。</para>
       </listitem>
     </itemizedlist>
 
     <note>
       <title>只适用于x86 </title>
 
       <para>本章只描述了运行于 Intel x86 体系之上的 FreeBSD 的引导过程。</para>
     </note>
   </sect1>
 
   <sect1 xml:id="boot-introduction">
     <title>引导问题</title>
 
     <para>启动电脑及启动和引导操作系统构成了一个有趣的两难境地。
       按照定义在操作系统被启动之前计算机是无法完成任何任务的，包括运行磁盘上的程序。
       如果计算机在没有操作系统的情况下不能运行来自于磁盘上的程序而操作系统又是放在磁盘上的，
       那操作系统是如何启动的呢？</para>
 
     <para>在 <citetitle>Munchausen男爵历险记 (The Adventures of
       Baron Munchausen)</citetitle> 这本书中有一个和这个过程类似的故事，
       一个人掉到了下水管道里， 然后靠着拉自己的靴襻 (bootstrap)
       克服重重困难爬了出来。 在早期文献中， 多以术语
       <firstterm>bootstrap</firstterm> 来指代操作系统的加载机制，
       如今它逐渐被简写为 <quote>booting</quote>。</para>
 
     <indexterm><primary>BIOS</primary></indexterm>
 
     <indexterm><primary>基本输入/输出系统</primary><see>BIOS</see></indexterm>
 
     <para>在 x86 硬件体系中，基本输入/输出系统 (BIOS) 负责加载操作系统，
       为了做到这一点，BIOS 在磁盘上寻找主引导记录 (MBR)，而 MBR
       必须在放置的磁盘的特定位置。BIOS 有足够的能力来读入和运行 MBR，
       且假使地认为 MBR 能完成加载操作系统的剩余任务，
       MBR可能需要BIOS的帮助。</para>
 
     <indexterm><primary>Master Boot Record (MBR)</primary></indexterm>
 
     <indexterm><primary>Boot Manager</primary></indexterm>
 
     <indexterm><primary>Boot Loader</primary></indexterm>
 
     <para>在MBR中的代码通常被提为<emphasis>引导管理器</emphasis>，
       尤其是与用户交互的那类。这一类引导器通常有更多代码位于磁盘第一
       <emphasis>轨道</emphasis>或在操作系统的文件系统中。
       (引导管理器有时也被称为<emphasis>boot loader</emphasis>，
       但是FreeBSD对后面的引导阶段才使用这个术语。)
       流行的引导管理器包括<application>boot0</application>(亦称<application>Boot
       Easy</application>，标准的 &os; 引导管理器)、
       <application>Grub</application>、<application>GAG</application>，以及
       <application>LILO</application>。
       (只有<application>boot0</application>能装得进MBR。)</para>
 
     <para>如果您只安装了一个操作系统，那么一个标准的 MBR 就足够了。
       这个 MBR 先在磁盘上搜索可引导的(亦称“活动的”)分区，
       然后运行分区上的代码以加载操作系统的其它部分。
       MBR由&man.fdisk.8;安装，是一个缺省的MBR。相关文件为
       <filename>/boot/mbr</filename>。</para>
 
     <para>如果您在磁盘上安装了多个操作系统那么您可以安装一个不同的
       引导管理器，它能显示一张操作系统的列表，您能从中选择启动哪个。
       这样的两种引导器将在下一小节中讨论。</para>
 
     <para>启动系统的剩余部分被分为三个阶段。第一阶段由
       MBR 执行,它只是使计算机进入特定的状态然后执行第二阶段。
       第二阶段稍微干得多一些。第三阶段完成加载操作系统的任务。
       工作被分为三个阶段是因为 PC 标准对第一第二阶段执行的程序的大小有所限制。
       把这些任务连在一起使得 FreeBSD 可以提供更大伸缩性的加载器 (loader)。</para>
 
     <indexterm><primary>内核</primary></indexterm>
     <indexterm><primary><command>init</command></primary></indexterm>
 
     <para>然后内核启动，它开始探测设备并初始化它们。
       一旦内核引导进程完成任务，内核将控制权交给用户进程 &man.init.8;，
       它确认磁盘是否处于可用状态。&man.init.8; 然后开始用户级资源配置：
       加载文件系统启动网卡，及粗略地启动所有 FreeBSD
       系统加载时经常运行的进程。</para>
   </sect1>
 
   <sect1 xml:id="boot-blocks">
     <title>引导管理器和各引导阶段</title>
 
     <indexterm><primary>Boot Manager</primary></indexterm>
 
     <sect2 xml:id="boot-boot0">
       <title>The Boot Manager</title>
       <indexterm><primary>主引导记录 (MBR)</primary></indexterm>
 
       <para>在MBR或引导管理器中的代码有时被提为引导过程的
         <emphasis>阶段0</emphasis>。这一小节便是前面提到引导器中的两种：
         <application>boot0</application>和<application>LILO</application>。</para>
 
       <formalpara><title><application>boot0</application>引导管理器：</title>
          <para>由 FreeBSD 的安装程序以及 boot0cfg(8) 所安装的 MBR，
           默认基于 <filename>/boot/boot0</filename>。
           (程序<application>boot0</application>非常简单，
           由于在<abbrev>MBR</abbrev>中的程序只能有446字节长，
           分区表和MBR末端的<literal>0x55AA</literal>标识也要挤占一些空间。)
           如果你已经安装<application>boot0</application>
           并且有多个操作系统在你的硬盘上，
           那么你如果您安装了 FreeBSD MBR 而且安装了多个操作系统，
           则会在系统启动时看到类似下面的提示：</para></formalpara>
 
       <example xml:id="boot-boot0-example">
 	<title><filename>boot0</filename> 截屏</title>
 
 	<screen>F1 DOS
 F2 FreeBSD
 F3 Linux
 F4 ??
 F5 Drive 1
 
 Default: F2</screen>
       </example>
 
       <para>目前已经知道一些其它操作系统，特别是 &windows;&nbsp;， 会以自己的
 	MBR 覆盖现有 MBR。 如果发生了这种事情， 或者您想用
 	FreeBSD 的 MBR 覆盖现有的 MBR，您可以使用以下的命令：</para>
 
       <screen>&prompt.root; <userinput>fdisk -B -b /boot/boot0 device</userinput></screen>
 
       <para><replaceable>device</replaceable> 是要写入 MBR
 	的设备名，比如 <filename>ad0</filename>
 	代表第一个 IDE 磁盘，<filename>ad2</filename>
 	代表第二个 IDE 控制器上的第一个 IDE 磁盘，
 	<filename>da0</filename> 代表第一个 SCSI 磁盘，等等。
 	抑或，如果你需要一个自行配置的MBR，请使用&man.boot0cfg.8;。</para>
 
       <formalpara><title>The LILO Boot Manager:</title>
 
       <para>要想安装这个引导管理器并也用来引导FreeBSD，
 	首先启动Linux，并将以下选项加入到已有的配置文件
 	<filename>/etc/lilo.conf</filename>：</para></formalpara>
 
       <programlisting>other=/dev/hdXY
 table=/dev/hdX
 loader=/boot/chain.b
 label=FreeBSD</programlisting>
 
       <para>在上面的内容里，使用Linux的标示符指定了FreeBSD的主分区和驱动器，
 	将<replaceable>X</replaceable>替换为Linux驱动器字母，
 	将<replaceable>Y</replaceable>替换为Linux主分区号。
 	如果您使用的是 <acronym>SCSI</acronym> 驱动器，您需要将
 	<replaceable>/dev/hd</replaceable> 改成 <replaceable>/dev/sd</replaceable>，
 	这里再次使用了 <replaceable>XY</replaceable> 的语法。
 	如果您安装的两个系统在同一驱动器上，<option>loader=/boot/chain.b</option>
 	选项可以去掉。现在您可以执行 <command>/sbin/lilo&nbsp;-v</command>
 	使修改生效；应检查屏幕上的消息确认修改。</para>
     </sect2>
 
     <sect2 xml:id="boot-boot1">
       <title>第一阶段，<filename>/boot/boot1</filename>，和第二阶段，
 	<filename>/boot/boot2</filename></title>
 
       <para>概念上，第一，第二阶段同属于一个程序，处于磁盘的相同区域。但由于空间限制，
 	它们被分为两部分。可是您总是会一起安装它们。它们由安装器或
 	<application>bsdlabel</application>(见下文)复制自被组合而成的
 	<filename>/boot/boot</filename>。</para>
 
       <para>它们位于文件系统外，引导分区的第一轨道，从第一扇区开始。在这里<link linkend="boot-boot0">boot0</link>，或者任何其它引导管理器，
 	期望找到一个程序运行，继续引导进程。
 	所使用的扇区数可由<filename>/boot/boot</filename>的大小确定。</para>
 
       <para><filename>boot1</filename> 非常简单，因为它再多也只能有 512 字节，
 	只能识别储存着分区信息的 <firstterm>bsdlabel</firstterm>，
 	及寻找执行 <filename>boot2</filename>。</para>
 
       <para><filename>boot2</filename> 稍微有点加强，能够理解 FreeBSD
 	的文件系统以便于寻找里面的文件，
 	能提供选择内核和加载器的简单界面。</para>
 
       <para>因为 <link linkend="boot-loader">loader</link> 有着更强的功能，
 	提供了一套易于使用的引导配置，<filename>boot2</filename> 一般都执行 loader，
 	但以前它的任务是直接运行内核。</para>
 
       <example xml:id="boot-boot2-example">
 	<title><filename>boot2</filename> 的屏幕输出</title>
 
 	<screen>&gt;&gt; FreeBSD/i386 BOOT
 Default: 0:ad(0,a)/boot/loader
 boot:</screen>
       </example>
 
       <para>如果您要更改已安装的 <filename>boot1</filename> 和
 	<filename>boot2</filename>，请使用命令
 	&man.bsdlabel.8;。</para>
 
       <screen>&prompt.root; <userinput>bsdlabel -B diskslice</userinput></screen>
 
       <para><replaceable>diskslice</replaceable> 是用于引导的磁盘和分区，
 	比如 <filename>ad0s1</filename>
 	代表第一个 IDE 磁盘上的第一个分区。</para>
 
       <warning>
 	<title>dangerously dedicated</title>
 
 	<para>如果您在 &man.bsdlabel.8; 命令中只使用了磁盘名，比如
 	  <filename>ad0</filename>，就会破坏磁盘上的所有分区。
 	  这当然不是您所希望的，所以在按下 <keycap>回车</keycap> 之前
 	  一定要对命令进行多次确认。</para>
       </warning>
     </sect2>
 
   <sect2 xml:id="boot-loader">
     <title>第三阶段，<filename>/boot/loader</filename></title>
 
     <indexterm><primary>boot-loader</primary></indexterm>
     <para>加载器 (loader) 是三个阶段中的最后阶段，
       且是放置在文件系统之中的，一般是文件
       <filename>/boot/loader</filename>。</para>
 
     <para>loader 被作为一种友好的配置方式，使用了一组内建且易用的命令集。
       这些命令由一个强大的多的解释器支持构建，其本身带有复杂得多的命令集。</para>
 
     <sect3 xml:id="boot-loader-flow">
       <title>Loader 程序流程</title>
 
       <para>初始时，loader 会探测控制台和磁盘，识别是从哪块盘引导的。
 	它会根据这些信息设置变量，
 	启动解释器以接受通过脚本或交互方式传来的用户命令。</para>
       <indexterm><primary>loader</primary></indexterm>
       <indexterm><primary>loader 配置</primary></indexterm>
 
       <para>loader 然后会读取并运行 <filename>/boot/loader.rc</filename>，
 	默认地读取 <filename>/boot/defaults/loader.conf</filename>
 	以设置可靠的默认变量，读取 <filename>/boot/loader.conf</filename>
 	对这些变量作本地修改。<filename>loader.rc</filename>
 	依据这些变量进行动作，加载任何被选择的模块和内核。</para>
 
       <para>最后，默认地，loader 会停留 10 秒等待按键，
 	若没有发生中断，就开始引导内核。如果被中断，用户会得到一个命令行提示符，
 	在这里用户得更改变量、卸载所有模块、加载模块、最后引导
 	或重新引导。</para>
 
     </sect3>
 
     <sect3 xml:id="boot-loader-commands">
       <title>Loader 内建的命令</title>
 
       <para>这些是最常用的 loader 命令.对所有可用命令的解释请参见
 	&man.loader.8;。</para>
 
       <variablelist>
 	<varlistentry>
 	  <term>autoboot<replaceable>seconds</replaceable></term>
 
 	  <listitem>
 	    <para>在给定的时间内如果没有中断发生就引导内核。它显示一个倒数计时，
 	      默认的时间范围是 10 秒。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>boot
 	    <optional>-options</optional>
 	    <optional>kernelname</optional></term>
 
 	  <listitem>
 	    <para>立即按指定的选项启动指定名字的内核 (如果有指定的话)。
 	      只有首先执行过 <emphasis>unload</emphasis>
 	      命令之后指定的内核名字才会生效，
 	      否则， 启动的将是先前已经加载的内核。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>boot-conf</term>
 
 	  <listitem>
 	    <para>基于变量对各种模块进行自动配置 (和引导内核时发生的一样)。
 	      您只须记住要先使用 <command>unload</command> 命令，
 	      然后修改一些变量，比如 <envar>kernel</envar>。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>help
 	    <optional>topic</optional></term>
 
 	  <listitem>
 	    <para>显示从文件 <filename>/boot/loader.help</filename>
 	      读取的帮助信息。如果给定的主题是 <literal>index</literal>，
 	      那么列出来的是所有可用的主题。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>include <replaceable>filename</replaceable>
 	    &hellip;</term>
 
 	  <listitem>
 	    <para>通过给定的文件名处理文件。文件被读入，然后被一行一行地解释。
 	      任何错误都会立即中止 include 命令。</para>
 	  </listitem>
 	</varlistentry>
 	<varlistentry>
 	  <term>load <optional>-t
 	    type</optional>
 	    <replaceable>filename</replaceable></term>
 
 	  <listitem>
 	    <para>加载内核、内核模块，或者是给定类型的文件 (通过给定的文件名)。
 	      任何在文件名后面的参数都会被传给文件。</para>
 	  </listitem>
 	</varlistentry>
 	<varlistentry>
 	  <term>ls <optional>-l</optional>
 	    <optional>path</optional></term>
 
 	  <listitem>
 	    <para>显示给定路径或者是根目录 (如果路径没有指定) 下面的文件列表。
 	      如果指定了 <option>-l</option> 选项，文件大小也会显示。</para>
 	  </listitem>
 	</varlistentry>
 	<varlistentry>
 	  <term>lsdev <optional>-v</optional></term>
 
 	  <listitem>
 	    <para>列出所有可以加载模块的设备。
 	      如果指定了<option>-v</option> 选项，会显示出更多的细节。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>lsmod <optional>-v</optional></term>
 
 	  <listitem>
 	    <para>显示已被加载的模块。如果指明了 <option>-v</option> 选项，
 	      会显示更多的细节。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>more <replaceable>filename</replaceable></term>
 
 	  <listitem>
 	    <para>显示指定的文件，每隔 <varname>LINES</varname> 停顿一次。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>reboot</term>
 
 	  <listitem>
 	    <para>立即重启系统。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>set <replaceable>variable</replaceable></term>
 	  <term>set
 	    <replaceable>variable</replaceable>=<replaceable>value</replaceable></term>
 
 	  <listitem>
 	    <para>设置 loader 的环境变量。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term>unload</term>
 
 	  <listitem>
 	    <para>移除所有已被加载的模块。</para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
     </sect3>
 
     <sect3 xml:id="boot-loader-examples">
       <title>Loader 示例</title>
 
       <para>这里有一些实际中 loader 用法的示例</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>只是简单的引导默认内核，不同的是进入单用户模式：<indexterm><primary>single-user mode</primary></indexterm></para>
 
 	  <screen><userinput>boot -s</userinput></screen>
 	</listitem>
 
 	<listitem>
 	  <para>卸载默认内核和模块，然后加载旧的 (或者其它) 的内核：</para>
 
 	  <screen><userinput>unload</userinput>
 <userinput>load kernel.old</userinput></screen>
 
 	  <para>您可以使用被称为通用内核的 <filename>kernel.GENERIC</filename>，
 	    或者您以前安装的内核 <filename>kernel.old</filename><indexterm><primary><filename>kernel.old</filename></primary></indexterm>
 	    (当您升级或配置了您自己的内核等时候)。</para>
 
 	  <note>
 	    <para>使用以下命令加载常用的模块和另一个内核：</para>
 
 	    <screen><userinput>unload</userinput>
 <userinput>set kernel="kernel.old"</userinput>
 <userinput>boot-conf</userinput></screen></note>
 	</listitem>
 
 	<listitem>
 	  <para>加载内核配置脚本：</para>
 
 	  <screen><userinput>load -t userconfig_script /boot/kernel.conf</userinput></screen>
 	</listitem>
       </itemizedlist>
   </sect3>
 
       <sect3 xml:id="boot-splash">
 	<info><title>启动时的 Splash 图像</title>
 	  <authorgroup>
 	    <author><personname><firstname>Joseph J.</firstname><surname>Barbish</surname></personname><contrib>Contributed by </contrib></author>
 	  </authorgroup>
 	</info>
 
         
 
         <para>在启动时出现的 splash 图像比起原本的启动信息更加可视话。
           这个图像将被始终显示在屏幕上直到出现控制台的登录提示或者
           X 显示管理器提供了登录画面。</para>
 
         <para>在 &os; 系统中有两个基本的环境。
           第一个是默认传统的控制台命令行环境。 在系统启动之后，
           会在控制台上出现一个登录提示。 第二个环境是 X11
           桌面图形环境。 在安装了 <link linkend="x-install">X11</link>
           和一种图形 <link linkend="x11-wm">桌面环境</link>，
           比如 <application>GNOME</application>，
 	  <application>KDE</application>， 或者
 	  <application>XFce</application>，
           X11 桌面可以用 <command>startx</command> 命令运行。</para>
 
         <para>比起传统基于字符的登录提示，有些用户可能更喜欢 X11
           图形化的登录界面。 图形化的登录管理器像
           &xorg; 的 <application>XDM</application>，
           <application>GNOME</application> 的 <application>gdm</application>，
           <application>KDE</application> 的 <application>kdm</application>
           (还有其他 Port Collection 中的)
           基本上都提供了一个图形化的登录界面代替控制台上的登录提示符。
           在成功登录之后， 它们展现给用户一个图形化的桌面。</para>
 
         <para>在命令行环境， splash
           图像将在显示登录提示符之前隐藏所有启动时的监测与任务启动的消息。
           在 X11 环境， 用户将会获得一个视觉上更加清爽启动体验，
           类似于某些像 (&microsoft; &windows; 或者非 &unix; 类型的系统)
           用户所希望体验到的。</para>
 
 	<sect4 xml:id="boot-splash-function">
 	  <title>Splash 图像功能</title>
 
           <para>目前的 splash 图像的功能仅限于支持 256 色的位图
             (<filename>.bmp</filename>) 或者 ZSoft
             <acronym>PCX</acronym> (<filename>.pcx</filename>) 文件。
             此外， splash 图像文件的分辨率必须是 320x200 像素或者更少，
             才够能在标准 VGA 适配器上使用。</para>
 
           <para>要使用尺寸更大的图像， 达到最大分辨率 1024x768 像素，
             则需开启 &os; 的 <acronym>VESA</acronym> 支持。
             这可以通过在系统启动时加载 <acronym>VESA</acronym> 模块完成，
             或者在内核配置文件中加入 <literal>VESA</literal> 选项并编译
             (参阅 <xref linkend="kernelconfig"/>)。 <acronym>VESA</acronym>
             支持给予了用户显示覆盖整个显示器的启动画面能力。</para>
 
           <para>在启动的时候 splash 图像就会被显示在屏幕上，
             它可以在任何时候都按任意键关闭。</para>
 
           <para>Splash 图像同样也会是 X11 之外默认的屏幕保护。
             在一段时间的闲置后，屏幕便会转为周期性的变换显示 splash 图像，
             从明亮至暗淡， 周而复始。 默认的 splash 图像 (屏幕保护)
             可由 <filename>/etc/rc.conf</filename> 中的
             <literal>saver=</literal> 选项控制。
             <literal>saver=</literal> 选项有一些内置的屏幕保护可供选择，
             完整的列表可以再 &man.splash.4; 手册页中找到。
             默认的屏幕保护被称为 <quote>warp</quote>。
             请注意在 <filename>/etc/rc.conf</filename> 中所指定
             <literal>saver=</literal> 选项仅限应用于虚拟控制台。
             对于 X11 图形化的登录管理器无效。</para>
 
           <para>一些有关启动引导器的信息，
             包括启动选项菜单和一个定时倒数提示符都会在启动时显示，
             即是开启了 splash 图像功能。</para>
 
 	  <para>splash 图像文件样本可以从 <link xlink:href="http://artwork.freebsdgr.org/node/3/">http://artwork.freebsdgr.org</link> 下载。
 	    安装了 <package>sysutils/bsd-splash-changer</package>
 	    port 之后， 每次启动的时候便能从集合中随机选择
 	    splash 图像。</para>
 	</sect4>
 
 	<sect4 xml:id="boot-splash-enable">
           <title>开启 Splash 图像功能</title>
 
           <para>Splash 图像 (<filename>.bmp</filename>) 或者
             (<filename>.pcx</filename>) 文件必须放置在 root 分区上，
             比如 <filename>/boot</filename> 目录。</para>
 
           <para>对于默认的显示分辨率 (256 色，320x200 像素或更少)
             编辑 <filename>/boot/lodaer.conf</filename>，
             添加如下的设置：</para>
 
 	  <programlisting>splash_bmp_load="YES"
 bitmap_load="YES"
 bitmap_name="<replaceable>/boot/splash.bmp</replaceable>"</programlisting>
 
           <para>对于更高的分辨率，最大至 1024x768 像素，
             编辑 <filename>/boot/lodaer.conf</filename>，
             添加如下的设置：</para>
 
 	  <programlisting>vesa_load="YES"
 splash_bmp_load="YES"
 bitmap_load="YES"
 bitmap_name="<replaceable>/boot/splash.bmp</replaceable>"</programlisting>
 
           <para>以上这些设置假设
             <filename>/boot/splash.bmp</filename>
             为需要被使用的 splash 图像。 当需要使用 <acronym>PCX</acronym>
             文件的时候， 添加入下列设置， 根据分辨率的高低添加
             <literal>vesa_load="YES"</literal>。</para>
 	  <programlisting>splash_pcx_load="YES"
 bitmap_load="YES"
 bitmap_name="<replaceable>/boot/splash.pcx</replaceable>"</programlisting>
 
           <para>文件名并不限于以上例子中的 <quote>splash</quote>。
             它可以是任何名称，只要是 <acronym>BMP</acronym> 或者
             <acronym>PCX</acronym> 类型的文件， 比如
 	    <filename>splash_640x400.bmp</filename>
             或者
 	    <filename>blue_wave.pcx</filename>.</para>
 
           <para>一些有趣的 <filename>loader.conf</filename> 选项：</para>
 
 	  <variablelist>
 	    <varlistentry>
 	      <term><literal>beastie_disable="YES"</literal></term>
 
 	      <listitem>
                 <para>这将关闭显示启动选项菜单，
                   但是倒数记时仍然会出现。 即是在启动菜单选项被禁用的时候，
                   在倒数记时段键入相应的启动选项仍然有效。</para>
 	      </listitem>
 	    </varlistentry>
 
 	    <varlistentry>
 	      <term><literal>loader_logo="beastie"</literal></term>
 
 	      <listitem>
                 <para>这将替换启动选项菜单右侧默认显示的
                   <quote>&os;</quote> 为彩色的小魔鬼标志，
                   就像以往的发行版那样。</para>
 	      </listitem>
 	    </varlistentry>
 	  </variablelist>
 
           <para>请参阅 &man.splash.4;， &man.loader.conf.5; 和
             &man.vga.4; 手册页获取更多详细信息。</para>
 	</sect4>
       </sect3>
     </sect2>
   </sect1>
 
   <sect1 xml:id="boot-kernel">
     <title>内核在引导时的交互</title>
     <indexterm>
       <primary>内核</primary>
       <secondary>引导交互</secondary>
     </indexterm>
 
     <para>一旦内核被 <link linkend="boot-loader">loader</link> (一般情况下) 或者 <link linkend="boot-boot1">boot2</link> (越过 loader) 加载，
       它将检查引导标志，如果有的话，就会进行必要的动作调整。</para>
 
     <sect2 xml:id="boot-kernel-bootflags">
       <title>内核引导标志</title>
 
       <indexterm>
         <primary>内核</primary>
         <secondary>引导标志</secondary>
       </indexterm>
 
       <para>这里是一些常用的引导标志：</para>
 
       <variablelist xml:id="boot-kernel-bootflags-list">
 	<varlistentry>
 	  <term><option>-a</option></term>
 
 	  <listitem>
 	    <para>在内核初始化时，询问作为根加载的设备。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><option>-C</option></term>
 
 	  <listitem>
 	    <para>从 CDROM 引导。</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><option>-c</option></term>
 
 	  <listitem>
 	    <para>运行 UserConfig (引导时的内核配置器)</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><option>-s</option></term>
 
 	  <listitem>
 	    <para>引导进入单用户模式</para>
 	  </listitem>
 	</varlistentry>
 
 	<varlistentry>
 	  <term><option>-v</option></term>
 
 	  <listitem>
 	    <para>在内核引导过程中显示更有的信息</para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
 
       <note>
 	<para>还有更多的引导标志，阅读 &man.boot.8;
 	  以获取有关它们的信息。</para></note>
     </sect2>
 
 <!--    <sect2 id="boot-kernel-userconfig">
       <title>UserConfig: 引导时的内核配置器</title>
 
       <para> </para>
     </sect2> -->
   </sect1>
 
   <sect1 xml:id="device-hints">
     <info><title>Device Hints</title>
       <authorgroup>
 	<author><personname><firstname>Tom</firstname><surname>Rhodes</surname></personname><contrib>Contributed by </contrib></author>
       </authorgroup>
       
     </info>
 
     
 
     <indexterm>
       <primary>device.hints</primary>
     </indexterm>
 
     <para>在初始化系统启动时，&man.loader.8; 会读取
       &man.device.hints.5; 文件。这个文件以变量的形式储存着内核引导信息，
       有时被称为 <quote>device hints</quote>。
       设备驱动程序用<quote>device hints</quote>
       对设备进行配置。</para>
 
     <para>Device hints 也可以在 <link linkend="boot-loader">
       第三阶段的boot loader</link> 的命令行提示符中指定。变量可以用
       <command>set</command> 命令添加，<command>unset</command> 命令删除，
       <command>show</command> 命令查看。在文件 <filename>/boot/device.hints</filename>
       设置的变量亦可以在这里被覆盖。键入 boot loader
       中的变量不是永久性的，在下次启动时就会被忘记。</para>
 
     <para>一旦系统引导成功，&man.kenv.1; 命令可以用来清楚所有的变量。</para>
 
     <para>文件 <filename>/boot/device.hints</filename> 的语法是一行一个变量，
       使用<quote>#</quote>作为注释标记。
       每行是按照如下方式组织的：</para>
 
     <screen><userinput>hint.driver.unit.keyword="value"</userinput></screen>
 
     <para>第三阶段 boot loader 的语法是：</para>
     <screen><userinput>set hint.driver.unit.keyword=value</userinput></screen>
 
     <para><literal>driver</literal> 是设备驱动程序名，<literal>unit</literal>
       是设备驱动程序单位名，<literal>keyword</literal> 是 hint 关键字。
       关键字可以由以下选项组成：</para>
 
     <itemizedlist>
       <listitem>
 	<para><literal>at</literal>：指明设备所绑定的总线</para>
       </listitem>
 
       <listitem>
 	<para><literal>port</literal>：指明所使用 <acronym>I/O</acronym>
 	  的起始地址。</para>
       </listitem>
 
       <listitem>
 	<para><literal>irq</literal>：指明所使用的中断请求号。</para>
       </listitem>
 
       <listitem>
 	<para><literal>drq</literal>：指明 DMA channel 号。</para>
       </listitem>
 
       <listitem>
 	<para><literal>maddr</literal>：指明设备占用的物理内存地址。</para>
       </listitem>
 
       <listitem>
 	<para><literal>flags</literal>：给设备设置各种标志位。</para>
       </listitem>
 
       <listitem>
 	<para><literal>disabled</literal>：如果设成 <literal>1</literal>，
 	  设备被禁用。</para>
       </listitem>
     </itemizedlist>
 
     <para>设备驱动程序能够接受更多的 hints，推荐您参看它们的联机手册。参看
       &man.device.hints.5;、&man.kenv.1;、&man.loader.conf.5; 和
       &man.loader.8; 联机手册以获取更多的信息。</para>
   </sect1>
 
   <sect1 xml:id="boot-init">
     <title>Init：进程控制及初始化</title>
 
     <indexterm>
       <primary><command>init</command></primary>
     </indexterm>
 
     <para>一旦内核完成引导，它就把控制权交给了用户进程
       &man.init.8;，它放置在 <filename>/sbin/init</filename>，
       或者 <envar>init_path</envar> 变量指定的程序路径中。
       这个变量是在 <command>loader</command> 里面设置的。</para>
 
     <sect2 xml:id="boot-autoreboot">
       <title>自动重启过程</title>
 
       <para>自动重启过程会确认系统中可用的文件系统处于健康的状态。
 	如果不是， 而且使用 &man.fsck.8; 也无法修复这些问题，
 	&man.init.8; 会进入 <link linkend="boot-singleuser">单用户模式</link>
 	以便系统管理员直接修正这些问题。</para>
     </sect2>
 
     <sect2 xml:id="boot-singleuser">
       <title>单用户模式</title>
       <indexterm><primary>单用户模式</primary></indexterm>
       <indexterm><primary>控制台</primary></indexterm>
 
       <para>此模式可以通过
 	<link linkend="boot-autoreboot">自动重启过程</link> 或者通过带有
 	<option>-s</option> 选项的用户引导或通过在 <command>loader</command>
 	里设置 <envar>boot_single</envar> 变量等多种方式来达到。</para>
 
       <para>也可以在多用户模式下调动无重启 (<option>-r</option>) 选项和停机
 	(<option>-h</option>) 选项的 &man.shutdown.8;
 	命令来进入单用户模式。</para>
 
       <para>如果系统 <literal>控制台</literal> 在文件
 	<filename>/etc/ttys</filename> 中被设置为
 	<literal>不安全(insecure)</literal>，
 	在初始化单用户模式前会出现要求输入 <systemitem class="username">root</systemitem>
 	密码的命令行提示符。</para>
 
       <example xml:id="boot-insecure-console">
 	<title>在 <filename>/etc/ttys</filename> 文件中的不安全控制台</title>
 
 	<programlisting># name  getty                           type    status          comments
 #
 # If console is marked "insecure", then init will ask for the root password # when going to single-user mode.
 console none                            unknown off insecure</programlisting>
       </example>
 
       <note>
 	<para>把控制台设置成 <literal>不安全 (insecure)</literal>
 	  使只知道 <systemitem class="username">root</systemitem> 密码的人才能进入单用户模式，
 	  因为您认为控制台在物理上是不安全的。因此如果您考虑到安全性，
 	  请选择 <literal>不安全 (insecure)</literal>，而非
 	  <literal>安全 (secure)</literal>。</para>
       </note>
     </sect2>
 
     <sect2 xml:id="boot-multiuser">
       <title>多用户模式</title>
       <indexterm><primary>多用户模式</primary></indexterm>
 
       <para>如果 &man.init.8; 发现您的文件系统一切正常，又或者用户在<link linkend="boot-singleuser">单用户模式</link>完成了工作，
 	系统就会进入多用户模式，开始系统的资源配置。</para>
 
       <sect3 xml:id="boot-rc">
 	<title>资源配置 (rc)</title>
 
       <indexterm><primary>rc 文件</primary></indexterm>
 
 	<para>资源配置分别从文件 <filename>/etc/defaults/rc.conf</filename>、
 	  <filename>/etc/rc.conf</filename> 中读取默认配置和细节配置，
 	  然后加载在文件 <filename>/etc/fstab</filename> 中提及的文件系统、
 	  启动网络服务、启动各种系统守护进程，最后启动本地安装包的启动脚本。</para>
 
 	<para>&man.rc.8; 联机手册是关于资源配置的很好的参考。</para>
       </sect3>
     </sect2>
   </sect1>
 
   <sect1 xml:id="boot-shutdown">
     <title>关机 (shutdown) 过程</title>
     <indexterm>
       <primary><command>shutdown</command></primary>
     </indexterm>
 
     <para>由命令 &man.shutdown.8; 的发起的关机过程中，
       &man.init.8; 会试着运行 <filename>/etc/rc.shutdown</filename> 脚本，
       给所有进程发送 <literal>TERM</literal> 信号， 最后给不按时停止的进程发送
       <literal>KILL</literal> 信号。</para>
 
     <para>在支持电源管理的平台上关闭 FreeBSD 系统的电源， 只要简单地使用命令
       <command>shutdown -p now</command> 即可。 此外， 可以用命令
       <command>shutdown -r now</command> 来重启 FreeBSD。 要执行 &man.shutdown.8;
       您必须是 <systemitem class="username">root</systemitem> 用户或 <systemitem class="groupname">operator</systemitem> 组的成员。
       也可以使用 &man.halt.8; 和 &man.reboot.8; 命令来关闭系统，
       请参看它们的联机手册以获得更多的信息。</para>
 
     <note>
       <para>电源管理需要支持， 这要求内核支持
 	&man.acpi.4; 或以模块形式加载它。</para>
     </note>
 
   </sect1>
 </chapter>
diff --git a/zh_CN.UTF-8/books/handbook/bsdinstall/Makefile b/zh_CN.UTF-8/books/handbook/bsdinstall/Makefile
index aa0464c01c..af293d96ea 100644
--- a/zh_CN.UTF-8/books/handbook/bsdinstall/Makefile
+++ b/zh_CN.UTF-8/books/handbook/bsdinstall/Makefile
@@ -1,16 +1,16 @@
 #
 # Build the Handbook with just the content from this chapter.
 #
-# Original revision: r39631
+# Original Revision: b4346b9b2d (r39631)
 # $FreeBSD$
 #
 
 CHAPTERS= 	bsdinstall/chapter.xml
 
 VPATH=		..
 
 MASTERDOC=	${.CURDIR}/../${DOC}.${DOCBOOKSUFFIX}
 
 DOC_PREFIX?= 	${.CURDIR}/../../../..
 
 .include "../Makefile"
diff --git a/zh_CN.UTF-8/books/handbook/bsdinstall/chapter.xml b/zh_CN.UTF-8/books/handbook/bsdinstall/chapter.xml
index 6f2ee05132..76082fb878 100644
--- a/zh_CN.UTF-8/books/handbook/bsdinstall/chapter.xml
+++ b/zh_CN.UTF-8/books/handbook/bsdinstall/chapter.xml
@@ -1,2340 +1,2340 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      The FreeBSD Documentation Project
      The FreeBSD Simplified Chinese Project
 
-     Original Revision: r38646
+     Original Revision: e9f1e1a61d (r38646)
      $FreeBSD$
 -->
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="bsdinstall">
   <info><title>安装 &os;（适用于 9.<replaceable>x</replaceable> 及以后版本）</title>
     <authorgroup>
       <author><personname><firstname>Jim</firstname><surname>Mock</surname></personname><contrib>重构、 重整及部分重写：</contrib></author>
     </authorgroup>
     <authorgroup>
       <author><personname><firstname>Randy</firstname><surname>Pratt</surname></personname><contrib>sysinstall 操作流程、 屏幕截图及一般性文字：</contrib></author>
     </authorgroup>
     <authorgroup>
       <author><personname><firstname>Gavin</firstname><surname>Atkinson</surname></personname><contrib>对 bsdinstall 的更新：</contrib></author>
 
       <author><personname><firstname>Warren</firstname><surname>Block</surname></personname></author>
     </authorgroup>
   </info>
 
   
 
   <sect1 xml:id="bsdinstall-synopsis">
     <title>概述</title>
 
     <indexterm><primary>安装</primary></indexterm>
 
     <para>&os; 提供了一个以文字为主、 便于使用的安装程序：
       从 &os; 9.0-RELEASE 开始是指 <application>bsdinstall</application>，
       而在之前则是指 <application>sysinstall</application>。
       本章介绍 <application>bsdinstall</application> 的使用，
       有关 <application>sysinstall</application>
       的使用参见 <xref linkend="install"/>。</para>
 
     <para>学习完本章之后， 您将知道：</para>
 
     <itemizedlist>
       <listitem>
 	<para>如何创建 &os; 安装介质。</para>
       </listitem>
 
       <listitem>
 	<!-- WB: verify this, including GPT partition notation (ada0p2) -->
 	<para>&os; 如何划分目标硬盘。</para>
       </listitem>
 
       <listitem>
 	<para>如何启动
 	  <application>bsdinstall</application>。</para>
       </listitem>
 
       <listitem>
 	<para>运行 <application>bsdinstall</application> 时需要回答的问题，
 	  问题的具体含义， 以及应该如何回答。</para>
       </listitem>
     </itemizedlist>
 
     <para>阅读本章之前， 您应该：</para>
 
     <itemizedlist>
       <listitem>
 	<para>查看将要安装的 &os; 版本所附的硬件支持列表，
 	  以确定您的硬件能够被支持。</para>
       </listitem>
     </itemizedlist>
 
     <note>
       <para>一般来说， 此安装说明是针对 &i386;（“PC 兼容机”） 架构的计算机；
 	同时也会尽可能地对其他架构下的安装予以说明。 虽然本文档经常更新，
 	但仍可能与所安装版本上附带的说明文档有些许出入，
 	因此建议您仅将其作为常规的安装指导。</para>
     </note>
   </sect1>
 
   <sect1 xml:id="bsdinstall-hardware">
     <title>硬件需求</title>
 
     <sect2 xml:id="bsdinstall-hardware-minimal">
       <title>最低配置</title>
 
       <para>安装 &os; 所需的最低配置， 随版本及硬件架构而有所不同。</para>
 
       <para>以下几节对这些信息进行了总结。 根据所选的安装方式，
 	可能需要使用 &os; 支持的 CDROM 或网络适配器，
 	详见 <xref linkend="bsdinstall-installation-media"/>。</para>
 
       <sect3>
 	<title>&os;/&arch.i386;</title>
 
 	<para>&os;/&arch.i386; 需要 486 或更快的处理器， 最小 64&nbsp;MB 的内存，
 	  以及至少 1.1&nbsp;GB 的硬盘空间。</para>
 
 	<note>
 	  <para>通常情况下对于老旧的计算机而言，
     安装更大的内存和腾出更多的硬盘空间，
 	    会比使用更快的处理器对性能的提升更加明显。</para>
 	</note>
       </sect3>
 
       <sect3>
 	<title>&os;/&arch.amd64;</title>
 
 	<para>&os;/&arch.amd64; 支持两种处理器。 第一种是 AMD64 处理器，
 	  包括 &amd.athlon;64、 &amd.athlon;64-FX、 &amd.opteron;
 	  以及更高级别的处理器。</para>
 
 	<para>能够使用 &os;/&arch.amd64; 的另一种处理器是采用了
 	  &intel;&nbsp;EM64 架构的处理器。 这类处理器包括
 	  &intel;&nbsp;&core;&nbsp;2 Duo、 Quad 和 Extreme 家族，
 	  还包括 &intel;&nbsp;&xeon; 3000、 5000 和 7000 系列，
 	  以及 &intel;&nbsp;&core; i3、 i5 和 i7。</para>
 
 	<para>对于使用了 nVidia nForce3 Pro-150 的机器， <emphasis>必须</emphasis>
 	  在 BIOS 设置中禁用 IO APIC， 如果没有这样的选项就只能转而禁用 ACPI。
 	  因为 Pro-150 芯片组存在 bug，而目前还没有能够规避此问题的方法。</para>
       </sect3>
 
       <sect3>
 	<title>&os;/&arch.powerpc; &apple; &macintosh;</title>
 
 	<para>支持所有内建 USB 的 New World &apple; &macintosh; 系统，
 	  同时也为配置多 CPU 的机器提供 SMP 支持。</para>
 
 	<para>注意 32 位的内核只能使用内存的前 2 GB，而 PowerMac G3
 	  蓝白机上的 &firewire; 也不被支持。</para>
       </sect3>
 
       <sect3>
 	<title>&os;/&arch.sparc64;</title>
 
 	<para>有关 &os;/&arch.sparc64; 的系统支持，
 	  详见 <link xlink:href="http://www.freebsd.org/platforms/sparc.html">
 	  FreeBSD/sparc64</link> 项目。</para>
 
 	<para>&os;/&arch.sparc64; 需要独占一块磁盘。
 	  目前还不支持与其他操作系统共享同一块磁盘。</para>
       </sect3>
     </sect2>
 
     <sect2 xml:id="bsdinstall-hardware-supported">
       <title>支持的硬件</title>
 
       <para>&os; 发行版所支持的硬件架构及设备会列在硬件兼容说明文件中，
 	此文件通常名为 <filename>HARDWARE.TXT</filename>，
 	位于发行版介质的根目录下。 这些内容也可以在 &os; 网站的 <link xlink:href="http://www.FreeBSD.org/releases/index.html">发行版信息</link>
 	页面上找到。</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="bsdinstall-pre">
     <title>安装前的准备工作</title>
 
     <sect2>
       <title>备份您的数据</title>
 
       <para>在将 &os; 安装至目标机器前，
 	应首先备份其上的重要数据并对备份进行测试。
 	&os; 安装程序对硬盘做任何改动前都会进行询问，
 	而一旦操作开始就无法撤销。</para>
     </sect2>
 
     <sect2 xml:id="bsdinstall-where">
       <title>决定将 &os; 安装在何处</title>
 
       <para>如果整个硬盘上仅安装 &os; 一个操作系统， 那么请直接跳过此节；
 	但如果需要让 &os; 与其他操作系统并存，
 	那么首先应当了解 &os; 的硬盘布局结构。</para>
 
       <sect3 xml:id="bsdinstall-where-i386">
 	<title>&os;/&arch.i386; 与
 	  &os;/&arch.amd64; 的硬盘布局</title>
 
 	<para>硬盘可以分割成多个区域，
 	  这些区域称作 <firstterm>partition（分区）</firstterm>。</para>
 
 	<para>有两种硬盘分区方式。
 	  传统的 <firstterm>Master Boot Record</firstterm>
 	  (<acronym role="Master Boot Record">MBR</acronym>， 主引导记录)
 	  的分区表中可以定义四个 <firstterm>primary
 	    partitions (主分区)</firstterm>。 (由于历史原因， &os;
 	  中将主分区称作 <firstterm>slice</firstterm>。)
 	  为了突破四个分区的限制， 可以将其中一个主分区创建为
 	  <firstterm>extended partition (扩展分区)</firstterm>，
 	  并在其中建立
 	  <firstterm>logical partitions (逻辑分区)</firstterm>。
 	  正如您看到的那样， 这种方法十分笨拙。</para>
 
 	<para>新式的 <firstterm>GUID Partition Table (GUID 分区表)</firstterm>
 	  (<acronym role="GUID Partition Table">GPT</acronym>)
 	  提供了更为简便的磁盘分区方法。
 	  与传统的 MBR 分区相比， <acronym role="GUID Partition Table">GPT</acronym> 功能更为强大。 常见的
 	  <acronym>GPT</acronym> 实现可以在一块磁盘上支持多达 128
 	  个分区， 从而无需再采用类似逻辑分区这样迭床架屋的结构。</para>
 
 	<warning>
 	  <para>一些旧式的操作系统， 如 &windows;&nbsp;XP
 	    并不兼容 <acronym>GPT</acronym>
 	    分区格式。 如果需要让 &os; 与这样的操作系统共用一块硬盘，
 	    就必须使用 <acronym role="Master Boot        Record">MBR</acronym> 分区了。</para>
 	</warning>
 
 	<para>&os; 的标准引导加载器需要使用一个主分区或
 	  <acronym>GPT</acronym> 分区。 (有关 &os; 引导过程的详情，
 	  请参阅 <xref linkend="boot"/>。) 如果所有的主分区或
 	  <acronym>GPT</acronym> 分区都已在使用中，
 	  则必须为 &os; 腾出一个来使用。</para>
 
 	<para>最小安装的 &os; 只需
 	  1&nbsp;GB 磁盘空间。 不过， 这是
 	  <emphasis>非常</emphasis> 基本的安装，
 	  而且也不会留下多少可用的空间。 比较实用的情况下，
 	  如果不使用图形界面， 最小安装应分配至少 3&nbsp;GB 的空间，
 	  而使用图形界面， 则应分配至少 5&nbsp;GB 的空间。
 	  此外， 第三方应用程序可能还需要更多的空间。</para>
 
 	<para>有很多 <link xlink:href="http://en.wikipedia.org/wiki/List_of_disk_partitioning_software">
 	    免费或商业的分区调整工具</link> 可供使用。 例如，
 	  以 Live CD 形式提供的 <link xlink:href="http://gparted.sourceforge.net/livecd.php">GParted
 	  Live</link> 中的 GParted
 	  分区编辑器。 此外， GParted 也可以在许多其它
 	  Linux Live CD 发行版中找到。</para>
 
 	<warning>
 	  <para>磁盘分区程序有可能会破坏现有的数据。 在修改磁盘分区之前，
 	    应先做一次完整的备份并校验其完整性。</para>
 	</warning>
 
 	<para>调整 &microsoft;&nbsp;Vista 分区大小时可能会遇到一些问题。
 	  如果要这样做， 请提前准备好 Vista 安装光盘。</para>
 
 	<example>
 	  <title>使用现有的分区</title>
 
 	  <para>假设一台安装了 &windows; 的计算机上有一块 40&nbsp;GB 的硬盘，
 	    分成了两个 20&nbsp;GB 的分区。 &windows;
 	    将它们分别叫做 <filename>C:</filename> 和
 	    <filename>D:</filename>。 
 	    <filename>C:</filename> 分区包含了 10&nbsp;GB
 	    数据， 而 <filename>D:</filename> 分区包含了
 	    5&nbsp;GB 数据。</para>
 
 	  <para>将数据从 <filename>D:</filename> 移动到
 	    <filename>C:</filename>， 就可将第二个分区腾出来供
 	    &os; 使用了。</para>
 	</example>
 
 	<example>
 	  <title>缩小现有的分区</title>
 
 	  <para>假设一台安装了 &windows; 的计算机上有一块 40&nbsp;GB 的硬盘，
 	    一个大的分区使用了整块磁盘的全部空间。 &windows;
 	    将这个 40&nbsp;GB 分区叫做
 	    <filename>C:</filename>。 目前占用了 15&nbsp;GB 空间。
 	    现希望将 &windows; 分区减少到
 	    20&nbsp;GB， 并将余下的 20&nbsp;GB
 	    分给 &os; 使用。</para>
 
 	  <para>可以在以下两种方法中任选一种：</para>
 
 	  <orderedlist>
 	    <listitem>
 	      <para>备份 &windows; 数据。 接着， 重新安装
 		&windows;， 在安装过程中建立一个 20&nbsp;GB 的分区。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>使用类似 <application>GParted</application> 这样的分区调整工具来缩小
 		&windows; 分区， 并腾出空间给 &os; 使用。</para>
 	    </listitem>
 	  </orderedlist>
 	</example>
 
 	<para>包含不同操作系统的磁盘分区令您能够在任何时候使用其中的一种。
 	  如果希望同时运行多种不同的操作系统， 可以使用在
 	  <xref linkend="virtualization"/> 中介绍的方法。</para>
       </sect3>
     </sect2>
 
     <sect2 xml:id="bsdinstall-collect-network-information">
       <title>收集网络配置信息</title>
 
       <para>某些 &os; 安装方式需要通过网络连接下载相关文件。
 	若要连接至以太网 (或电视电缆/DSL 调制解调器上的以太网接口)，
 	则需要向安装程序提供必要的网络配置信息。</para>
 
       <para><firstterm><acronym role="Dynamic Host Configuration      Protocol">DHCP</acronym></firstterm>
 	可以用来提供自动配置网络的信息。 假如没有可用的
 	<acronym>DHCP</acronym>， 则必须从局域网管理员，
 	或网络服务提供商那里获得必要的配置信息：</para>
 
       <orderedlist>
 	<title>网络配置信息</title>
 
 	<listitem>
 	  <para><acronym role="Internet Protocol">IP</acronym>
 	    地址</para>
 	</listitem>
 
 	<listitem>
 	  <para>子网掩码</para>
 	</listitem>
 
 	<listitem>
 	  <para>默认网关的 <acronym>IP</acronym> 地址</para>
 	</listitem>
 
 	<listitem>
 	  <para>本地网络域名</para>
 	</listitem>
 
 	<listitem>
 	  <para><acronym role="Domain Name System">DNS</acronym>
 	    服务器的 <acronym>IP</acronym> 地址</para>
 	</listitem>
       </orderedlist>
     </sect2>
 
     <sect2>
       <title>检查 &os; 发行勘误</title>
 
       <para>尽管 &os; 项目会确保每个发行版尽可能地稳定，
 	但 bug 总是在所难免。 极少数情况下， 这些 bug 甚至会影响安装。
 	一旦这些问题被发现并修正后， 就会列在 &os; 网站的 <link xlink:href="&url.base;/releases/9.0R/errata.html">&os; 发行勘误</link> 中。
 	在安装之前， 应首先检查这些勘误， 以确保安装可以顺利进行。</para>
 
       <para>有关所有发行版的信息及勘误， 可以在
 	<link xlink:href="&url.base;/index.html">&os; 网站</link> 的
 	<link xlink:href="&url.base;/releases/index.html">发行版信息</link>
 	一节中找到。</para>
     </sect2>
 
     <sect2 xml:id="bsdinstall-installation-media">
       <title>准备安装介质</title>
 
       <para>&os; 的安装介质包括 CD、 DVD 及 USB 记忆棒。
 	若要开始安装， 只需使用安装介质引导计算机即可；
 	注意不能通过在其他操作系统中执行安装程序这种方式进行安装。</para>
 
       <para>标准的安装介质中包含了 &os; 安装所需的全部文件，
 	除此之外， 还有一种 <emphasis>bootonly</emphasis> 安装介质。
 	这种介质并不在其中直接包含安装所需的全部文件，
 	而是在需要时通过网络进行下载。 因此， 与标准的安装介质相比，
 	bootonly安装介质体积更小。</para>
 
       <para>&os; 安装介质的副本可以从
 	<link xlink:href="&url.base;/where.html#download">&os; 网站</link> 获取。</para>
 
       <tip>
 	<para>如果您已经有 &os; 的安装 CD、 DVD 或 USB 记忆棒，
 	则可以跳过此节。</para>
       </tip>
 
       <para>&os; 的安装 CD 或 DVD 映像均为可引导的 ISO 文件。 只需要
 	CD 或 DVD 其中的一种即可完成安装操作。
 	任选一种在当前操作系统中刻录成可引导光盘即可。</para>
 
       <para>若要创建可引导的记忆棒， 请执行以下操作：</para>
 
       <procedure>
 	<step>
 	  <title>获取记忆棒映像</title>
 
 	  <para>&os;&nbsp;9.0-RELEASE 和更高版本的记忆棒映像文件可以在
 	    <literal>ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/arch/arch/ISO-IMAGES/version/&os;-version-RELEASE-arch-memstick.img</literal>
 	    中的
 	    <filename>ISO-IMAGES/</filename>
 	    目录中找到， 其中， <replaceable>arch</replaceable>
 	    是指要安装的架构， 而
 	    <replaceable>version</replaceable>
 	    则是指要安装的版本号。 举例来说， &os;/&arch.i386; 9.0-RELEASE
 	    的记忆棒映像位于 <uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/&arch.i386;/&arch.i386;/ISO-IMAGES/9.0/&os;-9.0-RELEASE-&arch.i386;-memstick.img">ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/&arch.i386;/&arch.i386;/ISO-IMAGES/9.0/&os;-9.0-RELEASE-&arch.i386;-memstick.img</uri>
 	    找到。</para>
 
 	  <tip>
 	    <para>在 &os;&nbsp;8.<replaceable>X</replaceable> 以及更早的版本中，
 	      映像文件的下载位置略有不同。 关于 &os;&nbsp;8.<replaceable>X</replaceable>
 	      和更早版本的安装操作请参阅 <xref linkend="install"/>。</para>
 	  </tip>
 
 	  <para>记忆棒映像的扩展名为 <filename>.img</filename>。
 	    在 <filename>ISO-IMAGES/</filename>
 	    目录中提供了多个不同的映像， 可以根据需要的 &os; 版本，
 	    有时也包括安装对象的硬件状况进行选择。</para>
 
 	  <important>
 	    <para>执行以下步骤前， 应 <emphasis>备份</emphasis> USB
 	    记忆棒上的数据， 因为之后的操作将 <emphasis>擦除</emphasis>
 	    这些数据。</para>
 	  </important>
 	</step>
 
 	<step>
 	  <title>将映像文件写入记忆棒</title>
 
 	  <procedure>
 	    <title>在 &os; 中操作</title>
 
 	    <warning>
 	      <para>在下面的例子中， 目标记忆棒对应的设备节点是 <filename>/dev/da0</filename>。
 		操作前请仔细确认目标设备是否正确，
 		以免损坏现有的数据。</para>
 	    </warning>
 
 	    <step>
 	      <title>使用 &man.dd.1; 写入映像</title>
 
 	      <para>扩展名为 <filename>.img</filename> 的映像文件
 		<emphasis>不是</emphasis> 一种普通的文件。
 		它是对记忆棒上完整内容所做的 <emphasis>映像</emphasis>，
 		因此 <emphasis>不能</emphasis> 只是像普通文件一样简单的复制，
 		而应使用
 		&man.dd.1; 将其直接写入目标设备：</para>
 
 	      <screen>&prompt.root; <userinput>dd if=&os;-9.0-RELEASE-&arch.i386;-memstick.img of=/dev/da0 bs=64k</userinput></screen>
 	    </step>
 	  </procedure>
 
 	  <procedure>
 	    <title>在 &windows; 中操作</title>
 
 	    <warning>
 	      <para>操作前请确认是否为目标设备选择了正确的驱动器号，
 		否则可能会覆盖并损坏您的现有数据。</para>
 	    </warning>
 
 	    <step>
 	      <title>获取 <application>Image Writer for
 		  &windows;</application></title>
 
 	      <para><application>Image Writer for
 		  &windows;</application> 是一种能将映像正确写入到记忆棒中的免费应用程序。
 		从 <uri xlink:href="https://launchpad.net/win32-image-writer/">https://launchpad.net/win32-image-writer/</uri>
 		下载并将其提取至任意文件夹后即可开始使用。</para>
 	    </step>
 
 	    <step>
 	      <title>使用 Image Writer 写入映像</title>
 
 	      <para>双击图标 <application>Win32DiskImager</application>
 		运行程序后， 确定 <computeroutput>Device</computeroutput>
 		下面显示的驱动器号所对应的是记忆棒。
 		点击文件夹图标以选择需要写入的映像文件，
 		然后点击 <guibutton>[ Save ]</guibutton> 接受选择。
 		在确认所有操作无误且没有其他窗口访问记忆棒后，
 		点击 <guibutton>[ Write ]</guibutton> 将映像文件写入记忆棒。</para>
 	    </step>
 	  </procedure>
 	</step>
       </procedure>
 
       <note>
 	<para>系统不再支持从软盘进行安装了。</para>
       </note>
 
       <para>您现在可以开始安装 &os; 了。</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="bsdinstall-start">
     <title>开始安装</title>
 
     <important>
       <para>默认情况下， 在您看到下面这条信息之前，
 	安装程序不会对硬盘数据做任何修改：</para>
 
       <literallayout class="monospaced">Your changes will now be written to disk.  If you
 have chosen to overwrite existing data, it will
 be PERMANENTLY ERASED. Are you sure you want to
 commit your changes?</literallayout>
 
       <para>在此之前均可安全退出， 抑或您担心进行了某些错误的配置，
 	也可以直接关闭电源。</para>
     </important>
 
     <sect2 xml:id="bsdinstall-starting">
       <title>开机启动</title>
 
       <sect3 xml:id="bsdinstall-starting-i386">
 	<title>引导 &i386; 及 &arch.amd64; 系统</title>
 
 	<procedure>
 	  <step>
 	    <para>若要使用 <xref linkend="bsdinstall-installation-media"/>
 	      所述的 USB 记忆棒引导， 则应在开机前将其插入计算机。</para>
 
 	    <para>若要使用 CDROM 引导， 则应在开机后立刻将其放入计算机。</para>
 	  </step>
 
 	  <step>
 	    <para>根据所使用的安装介质， 选择从 CDROM 或 USB启动。 在
 	      <acronym role="Basic Input/Output System">BIOS</acronym> 设置中，
 	      可以选择特定的引导设备。 大多数系统还可以在启动时选择引导设备，
 	      通常需要按 <keycap>F10</keycap>、  <keycap>F11</keycap>、
 	      <keycap>F12</keycap> 或 <keycap>Escape</keycap> 键。</para>
 	  </step>
 
 	  <step>
 	    <para>如果您的计算机正常启动并加载了现有的操作系统，
 	      那么请检查：</para>
 
 	    <orderedlist>
 	      <listitem>
 		<para>USB 记忆棒插入过晚或 CDROM 放入过晚， 请将其拔下或取出，
 		  然后重新启动计算机并再次尝试。</para>
 	      </listitem>
 
 	      <listitem>
 		<para><acronym>BIOS</acronym> 设置错误， 请重新设置。</para>
 	      </listitem>
 
 	      <listitem>
 		<para><acronym>BIOS</acronym> 不支持从当前介质启动； 可以使用
 		  <link xlink:href="http://www.plop.at/en/bootmanager.html">Plop
 		  Boot Manager</link>， 它能够让老式计算机支持
 		  CD 或 USB 启动。</para>
 	      </listitem>
 	    </orderedlist>
 	  </step>
 
 	  <step>
 	    <para>&os; 将开始启动。 如果使用的是CDROM，
 	      则会看到类似这样的显示（版本信息可以忽略）：</para>
 
 	    <screen>Booting from CD-ROM...
 645MB medium detected
 CD Loader 1.2
 
 Building the boot loader arguments
 Looking up /BOOT/LOADER... Found
 Relocating the loader and the BTX
 Starting the BTX loader
 
 BTX loader 1.00 BTX version is 1.02
 Consoles: internal video/keyboard
 BIOS CD is cd0
 BIOS drive C: is disk0
 BIOS drive D: is disk1
 BIOS 636kB/261056kB available memory
 
 FreeBSD/i386 bootstrap loader, Revision 1.1
 
 Loading /boot/defaults/loader.conf
 /boot/kernel/kernel text=0x64daa0 data=0xa4e80+0xa9e40 syms=[0x4+0x6cac0+0x4+0x88e9d]
 \</screen>
 	  </step>
 
 	  <step>
 	    <para>&os; 引导加载器会显示：</para>
 
 	    <figure xml:id="bsdinstall-boot-loader-menu">
 	      <title>&os; 引导加载器菜单</title>
 	      <mediaobject>
 		<imageobject>
 		  <imagedata fileref="bsdinstall/bsdinstall-boot-loader-menu"/>
 		</imageobject>
 	      </mediaobject>
 	    </figure>
 
 	    <para>您可以等待十秒或按 <keycap>Enter</keycap> 键。</para>
 	  </step>
 	</procedure>
       </sect3>
 
       <sect3>
 	<title>引导 &macintosh; &powerpc;</title>
 
 	<para>在大多数机器上， 开机时按住 <keycap>C</keycap> 键可以从 CD 启动。
 	  除此之外， 按住
 	  <keycombo action="simul">
 	    <keycap>Command</keycap>
 	    <keycap>Option</keycap>
 	    <keycap>O</keycap>
 	    <keycap>F</keycap>
 	  </keycombo>， 在非 &apple; 键盘上是
 	  <keycombo action="simul">
 	    <keycap>Windows</keycap>
 	    <keycap>Alt</keycap>
 	    <keycap>O</keycap>
 	    <keycap>F</keycap>
 	  </keycombo>， 然后在出现的提示符 <prompt>0 &gt;</prompt> 下输入</para>
 
 	<screen><userinput>boot cd:,\ppc\loader cd:0</userinput></screen>
 
 	<para>对于不带键盘的 Xserves 机器，请参考
 	  <link xlink:href="http://support.apple.com/kb/TA26930">&apple;
 	  支持网站</link> 以了解如何引导至 Open Firmware。</para>
       </sect3>
 
       <sect3>
 	<title>引导 &sparc64;</title>
 
 	<para>多数 &sparc64; 系统均设置成了硬盘自启动。 若要安装 &os;，
 	  则应从网络或 CDROM 启动， 这就需要首先进入
 	  <acronym role="Programmable Read Only Memory">
 	  PROM</acronym>（OpenFirmware）。</para>
 
 	<para>重启系统后等待引导信息出现， 虽然其具体内容取决于机器型号，
 	  但应该会类似：</para>
 
 	<screen>Sun Blade 100 (UltraSPARC-IIe), Keyboard Present
 Copyright 1998-2001 Sun Microsystems, Inc.  All rights reserved.
 OpenBoot 4.2, 128 MB memory installed, Serial #51090132.
 Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
 
 	<para>如果此时系统已经开始从硬盘启动， 那么请按下
 	  <keycombo action="simul"><keycap>L1</keycap><keycap>A</keycap></keycombo>
 	  或
 	  <keycombo action="simul"><keycap>Stop</keycap><keycap>A</keycap></keycombo>
 	  或在串口控制台发送 <command>BREAK</command>（在 &man.tip.1; 或 &man.cu.1;
 	  中是 <command>~#</command>）以进入
 	  <acronym role="Programmable Read Only Memory">PROM</acronym> 提示符，
 	  它应该如下所示：</para>
 
 	  <screen><prompt>ok     </prompt><co xml:id="bsdinstall-prompt-single"/>
 <prompt>ok {0} </prompt><co xml:id="bsdinstall-prompt-smp"/></screen>
 
 	  <calloutlist>
 	    <callout arearefs="bsdinstall-prompt-single">
 	      <para>这是在单 CPU 系统上的提示符。</para>
 	    </callout>
 
 	    <callout arearefs="bsdinstall-prompt-smp">
 	      <para>这是在 SMP 系统上的提示符，
 		其中的数字表示可用的 CPU 个数。</para>
 	    </callout>
 	  </calloutlist>
 
 	<para>现在， 放入 CDROM 并在 <acronym>PROM</acronym> 提示符后输入
 	  <command>boot cdrom</command>。</para>
 
       </sect3>
 
     </sect2>
 
     <sect2 xml:id="bsdinstall-view-probe">
       <title>查看设备探测结果</title>
 
       <para>为了便于查阅，
 	屏幕上所显示的最后几百行字符会始终保存在缓冲区里。</para>
 
       <para>若要浏览缓冲区， 可以按下 <keycap>Scroll Lock</keycap>
 	键来开启屏幕的滚动功能； 开启后即可使用方向键、
 	<keycap>PageUp</keycap> 键或 <keycap>PageDown</keycap> 键进行翻阅；
 	再次按下 <keycap>Scroll Lock</keycap> 键将关闭滚动功能。</para>
 
       <para>浏览时将看到内核进行了设备探测，
 	其结果类似 <xref linkend="bsdinstall-dev-probe"/> 中的文本，
 	但具体内容会因计算机中所包含的设备而有所不同。</para>
 
       <figure xml:id="bsdinstall-dev-probe">
 	<title>典型的设备探测结果</title>
 
 	<screen>Copyright (c) 1992-2011 The FreeBSD Project.
 Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994
         The Regents of the University of California. All rights reserved.
 FreeBSD is a registered trademark of The FreeBSD Foundation.
 FreeBSD 9.0-RELEASE #0 r225473M: Sun Sep 11 16:07:30 BST 2011
     root@psi:/usr/obj/usr/src/sys/GENERIC amd64
 CPU: Intel(R) Core(TM)2 Duo CPU     T9400  @ 2.53GHz (2527.05-MHz K8-class CPU)
   Origin = "GenuineIntel"  Id = 0x10676  Family = 6  Model = 17  Stepping = 6
   Features=0xbfebfbff&lt;FPU,VME,DE,PSE,TSC,MSR,PAE,MCE,CX8,APIC,SEP,MTRR,PGE,MCA,CMOV,PAT,PSE36,CLFLUSH,DTS,ACPI,MMX,FXSR,SSE,SSE2,SS,HTT,TM,PBE&gt;
   Features2=0x8e3fd&lt;SSE3,DTES64,MON,DS_CPL,VMX,SMX,EST,TM2,SSSE3,CX16,xTPR,PDCM,SSE4.1&gt;
   AMD Features=0x20100800&lt;SYSCALL,NX,LM&gt;
   AMD Features2=0x1&lt;LAHF&gt;
   TSC: P-state invariant, performance statistics
 real memory  = 3221225472 (3072 MB)
 avail memory = 2926649344 (2791 MB)
 Event timer "LAPIC" quality 400
 ACPI APIC Table: &lt;TOSHIB A0064   &gt;
 FreeBSD/SMP: Multiprocessor System Detected: 2 CPUs
 FreeBSD/SMP: 1 package(s) x 2 core(s)
  cpu0 (BSP): APIC ID:  0
  cpu1 (AP): APIC ID:  1
 ioapic0: Changing APIC ID to 1
 ioapic0 &lt;Version 2.0&gt; irqs 0-23 on motherboard
 kbd1 at kbdmux0
 acpi0: &lt;TOSHIB A0064&gt; on motherboard
 acpi0: Power Button (fixed)
 acpi0: reservation of 0, a0000 (3) failed
 acpi0: reservation of 100000, b6690000 (3) failed
 Timecounter "ACPI-safe" frequency 3579545 Hz quality 850
 acpi_timer0: &lt;24-bit timer at 3.579545MHz&gt; port 0xd808-0xd80b on acpi0
 cpu0: &lt;ACPI CPU&gt; on acpi0
 ACPI Warning: Incorrect checksum in table [ASF!] - 0xFE, should be 0x9A (20110527/tbutils-282)
 cpu1: &lt;ACPI CPU&gt; on acpi0
 pcib0: &lt;ACPI Host-PCI bridge&gt; port 0xcf8-0xcff on acpi0
 pci0: &lt;ACPI PCI bus&gt; on pcib0
 vgapci0: &lt;VGA-compatible display&gt; port 0xcff8-0xcfff mem 0xff400000-0xff7fffff,0xe0000000-0xefffffff irq 16 at device 2.0 on pci0
 agp0: &lt;Intel GM45 SVGA controller&gt; on vgapci0
 agp0: aperture size is 256M, detected 131068k stolen memory
 vgapci1: &lt;VGA-compatible display&gt; mem 0xffc00000-0xffcfffff at device 2.1 on pci0
 pci0: &lt;simple comms&gt; at device 3.0 (no driver attached)
 em0: &lt;Intel(R) PRO/1000 Network Connection 7.2.3&gt; port 0xcf80-0xcf9f mem 0xff9c0000-0xff9dffff,0xff9fe000-0xff9fefff irq 20 at device 25.0 on pci0
 em0: Using an MSI interrupt
 em0: Ethernet address: 00:1c:7e:6a:ca:b0
 uhci0: &lt;Intel 82801I (ICH9) USB controller&gt; port 0xcf60-0xcf7f irq 16 at device 26.0 on pci0
 usbus0: &lt;Intel 82801I (ICH9) USB controller&gt; on uhci0
 uhci1: &lt;Intel 82801I (ICH9) USB controller&gt; port 0xcf40-0xcf5f irq 21 at device 26.1 on pci0
 usbus1: &lt;Intel 82801I (ICH9) USB controller&gt; on uhci1
 uhci2: &lt;Intel 82801I (ICH9) USB controller&gt; port 0xcf20-0xcf3f irq 19 at device 26.2 on pci0
 usbus2: &lt;Intel 82801I (ICH9) USB controller&gt; on uhci2
 ehci0: &lt;Intel 82801I (ICH9) USB 2.0 controller&gt; mem 0xff9ff800-0xff9ffbff irq 19 at device 26.7 on pci0
 usbus3: EHCI version 1.0
 usbus3: &lt;Intel 82801I (ICH9) USB 2.0 controller&gt; on ehci0
 hdac0: &lt;Intel 82801I High Definition Audio Controller&gt; mem 0xff9f8000-0xff9fbfff irq 22 at device 27.0 on pci0
 pcib1: &lt;ACPI PCI-PCI bridge&gt; irq 17 at device 28.0 on pci0
 pci1: &lt;ACPI PCI bus&gt; on pcib1
 iwn0: &lt;Intel(R) WiFi Link 5100&gt; mem 0xff8fe000-0xff8fffff irq 16 at device 0.0 on pci1
 pcib2: &lt;ACPI PCI-PCI bridge&gt; irq 16 at device 28.1 on pci0
 pci2: &lt;ACPI PCI bus&gt; on pcib2
 pcib3: &lt;ACPI PCI-PCI bridge&gt; irq 18 at device 28.2 on pci0
 pci4: &lt;ACPI PCI bus&gt; on pcib3
 pcib4: &lt;ACPI PCI-PCI bridge&gt; at device 30.0 on pci0
 pci5: &lt;ACPI PCI bus&gt; on pcib4
 cbb0: &lt;RF5C476 PCI-CardBus Bridge&gt; at device 11.0 on pci5
 cardbus0: &lt;CardBus bus&gt; on cbb0
 pccard0: &lt;16-bit PCCard bus&gt; on cbb0
 isab0: &lt;PCI-ISA bridge&gt; at device 31.0 on pci0
 isa0: &lt;ISA bus&gt; on isab0
 ahci0: &lt;Intel ICH9M AHCI SATA controller&gt; port 0x8f58-0x8f5f,0x8f54-0x8f57,0x8f48-0x8f4f,0x8f44-0x8f47,0x8f20-0x8f3f mem 0xff9fd800-0xff9fdfff irq 19 at device 31.2 on pci0
 ahci0: AHCI v1.20 with 4 3Gbps ports, Port Multiplier not supported
 ahcich0: &lt;AHCI channel&gt; at channel 0 on ahci0
 ahcich1: &lt;AHCI channel&gt; at channel 1 on ahci0
 ahcich2: &lt;AHCI channel&gt; at channel 4 on ahci0
 acpi_lid0: &lt;Control Method Lid Switch&gt; on acpi0
 battery0: &lt;ACPI Control Method Battery&gt; on acpi0
 acpi_button0: &lt;Power Button&gt; on acpi0
 acpi_acad0: &lt;AC Adapter&gt; on acpi0
 acpi_toshiba0: &lt;Toshiba HCI Extras&gt; on acpi0
 acpi_tz0: &lt;Thermal Zone&gt; on acpi0
 attimer0: &lt;AT timer&gt; port 0x40-0x43 irq 0 on acpi0
 Timecounter "i8254" frequency 1193182 Hz quality 0
 Event timer "i8254" frequency 1193182 Hz quality 100
 atkbdc0: &lt;Keyboard controller (i8042)&gt; port 0x60,0x64 irq 1 on acpi0
 atkbd0: &lt;AT Keyboard&gt; irq 1 on atkbdc0
 kbd0 at atkbd0
 atkbd0: [GIANT-LOCKED]
 psm0: &lt;PS/2 Mouse&gt; irq 12 on atkbdc0
 psm0: [GIANT-LOCKED]
 psm0: model GlidePoint, device ID 0
 atrtc0: &lt;AT realtime clock&gt; port 0x70-0x71 irq 8 on acpi0
 Event timer "RTC" frequency 32768 Hz quality 0
 hpet0: &lt;High Precision Event Timer&gt; iomem 0xfed00000-0xfed003ff on acpi0
 Timecounter "HPET" frequency 14318180 Hz quality 950
 Event timer "HPET" frequency 14318180 Hz quality 450
 Event timer "HPET1" frequency 14318180 Hz quality 440
 Event timer "HPET2" frequency 14318180 Hz quality 440
 Event timer "HPET3" frequency 14318180 Hz quality 440
 uart0: &lt;16550 or compatible&gt; port 0x3f8-0x3ff irq 4 flags 0x10 on acpi0
 sc0: &lt;System console&gt; at flags 0x100 on isa0
 sc0: VGA &lt;16 virtual consoles, flags=0x300&gt;
 vga0: &lt;Generic ISA VGA&gt; at port 0x3c0-0x3df iomem 0xa0000-0xbffff on isa0
 ppc0: cannot reserve I/O port range
 est0: &lt;Enhanced SpeedStep Frequency Control&gt; on cpu0
 p4tcc0: &lt;CPU Frequency Thermal Control&gt; on cpu0
 est1: &lt;Enhanced SpeedStep Frequency Control&gt; on cpu1
 p4tcc1: &lt;CPU Frequency Thermal Control&gt; on cpu1
 Timecounters tick every 1.000 msec
 hdac0: HDA Codec #0: Realtek ALC268
 hdac0: HDA Codec #1: Lucent/Agere Systems (Unknown)
 pcm0: &lt;HDA Realtek ALC268 PCM #0 Analog&gt; at cad 0 nid 1 on hdac0
 pcm1: &lt;HDA Realtek ALC268 PCM #1 Analog&gt; at cad 0 nid 1 on hdac0
 usbus0: 12Mbps Full Speed USB v1.0
 usbus1: 12Mbps Full Speed USB v1.0
 usbus2: 12Mbps Full Speed USB v1.0
 usbus3: 480Mbps High Speed USB v2.0
 ugen0.1: &lt;Intel&gt; at usbus0
 uhub0: &lt;Intel UHCI root HUB, class 9/0, rev 1.00/1.00, addr 1&gt; on usbus0
 ugen1.1: &lt;Intel&gt; at usbus1
 uhub1: &lt;Intel UHCI root HUB, class 9/0, rev 1.00/1.00, addr 1&gt; on usbus1
 ugen2.1: &lt;Intel&gt; at usbus2
 uhub2: &lt;Intel UHCI root HUB, class 9/0, rev 1.00/1.00, addr 1&gt; on usbus2
 ugen3.1: &lt;Intel&gt; at usbus3
 uhub3: &lt;Intel EHCI root HUB, class 9/0, rev 2.00/1.00, addr 1&gt; on usbus3
 uhub0: 2 ports with 2 removable, self powered
 uhub1: 2 ports with 2 removable, self powered
 uhub2: 2 ports with 2 removable, self powered
 uhub3: 6 ports with 6 removable, self powered
 ugen2.2: &lt;vendor 0x0b97&gt; at usbus2
 uhub8: &lt;vendor 0x0b97 product 0x7761, class 9/0, rev 1.10/1.10, addr 2&gt; on usbus2
 ugen1.2: &lt;Microsoft&gt; at usbus1
 ada0 at ahcich0 bus 0 scbus1 target 0 lun 0
 ada0: &lt;Hitachi HTS543225L9SA00 FBEOC43C&gt; ATA-8 SATA 1.x device
 ada0: 150.000MB/s transfers (SATA 1.x, UDMA6, PIO 8192bytes)
 ada0: Command Queueing enabled
 ada0: 238475MB (488397168 512 byte sectors: 16H 63S/T 16383C)
 ada0: Previously was known as ad4
 ums0: &lt;Microsoft Microsoft 3-Button Mouse with IntelliEyeTM, class 0/0, rev 1.10/3.00, addr 2&gt; on usbus1
 SMP: AP CPU #1 Launched!
 cd0 at ahcich1 bus 0 scbus2 target 0 lun 0
 cd0: &lt;TEAC DV-W28S-RT 7.0C&gt; Removable CD-ROM SCSI-0 device
 cd0: 150.000MB/s transfers (SATA 1.x, ums0: 3 buttons and [XYZ] coordinates ID=0
 UDMA2, ATAPI 12bytes, PIO 8192bytes)
 cd0: cd present [1 x 2048 byte records]
 ugen0.2: &lt;Microsoft&gt; at usbus0
 ukbd0: &lt;Microsoft Natural Ergonomic Keyboard 4000, class 0/0, rev 2.00/1.73, addr 2&gt; on usbus0
 kbd2 at ukbd0
 uhid0: &lt;Microsoft Natural Ergonomic Keyboard 4000, class 0/0, rev 2.00/1.73, addr 2&gt; on usbus0
 Trying to mount root from cd9660:/dev/iso9660/FREEBSD_INSTALL [ro]...</screen>
       </figure>
 
       <para>请仔细检查设备探测结果， 以确定 &os; 找到了所有您希望使用的设备。
 	没有找到的设备并不会在这里列出， 因为默认的
 	<filename>GENERIC</filename> 内核中不包含它们； 可以通过
 	<link linkend="kernelconfig-modules">内核模块</link>
 	对这些设备提供支持。</para>
 
       <para>设备探测完成后， 您将看到 <xref linkend="bsdinstall-choose-mode"/>，
 	表明安装介质共有三种用途： 安装 &os; 、
 	作为“Live CD”或引导至 &os; 的命令行界面。
 	请使用方向键选择一项后按 <keycap>Enter</keycap> 键确认。</para>
 
       <figure xml:id="bsdinstall-choose-mode">
 	<title>选择安装介质的使用方式</title>
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-choose-mode"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>在这里， 请选择 <guibutton>[ Install ]</guibutton>
 	以运行安装程序。</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="using-bsdinstall">
     <title>介绍 <application>bsdinstall</application></title>
 
     <para><application>bsdinstall</application> 是一个基于文本的 &os; 安装程序，
       作者是 &a.nwhitehorn;， 于 2011 年被 &os; 9.0 采用。</para>
 
     <note>
       <para>&a.kmoore; 为 <link xlink:href="http://pcbsd.org">PC-BSD</link>
 	编写的 <application>pc-sysinstall</application> 也可以用于
 	<link xlink:href="http://wiki.pcbsd.org/index.php/Use_PC-BSD_Installer_to_Install_FreeBSD">安装
 	  &os;</link>。 虽然有时会同
 	<application>bsdinstall</application> 混淆，
 	但实际两者并不相关。</para>
     </note>
 
     <para><application>bsdinstall</application> 菜单系统的主要控制键包括方向键、
       <keycap>Enter</keycap> 键、
       <keycap>Tab</keycap> 键、 <keycap>Space</keycap>
       键等。</para>
 
     <sect2 xml:id="bsdinstall-keymap">
       <title>选择键盘映射</title>
 
       <para>根据当前正在使用的系统控制台，
 	<application>bsdinstall</application>
 	可能会首先提示选择一种非默认的键盘布局。</para>
 
       <figure xml:id="bsdinstall-keymap-select-default">
 	<title>键盘映射选择</title>
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-keymap-select-default"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>选择了 <guibutton>[ YES ]</guibutton> 后， 将显示下面的键盘选择画面；
 	否则将不显示此画面而直接使用默认键盘映射。</para>
 
       <figure xml:id="bsdinstall-config-keymap">
 	<title>键盘选择菜单</title>
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-config-keymap"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>使用上/下方向键选择最适合当前系统的键盘映射后， 按
 	 <keycap>Enter</keycap> 键确认。</para>
 
       <note>
 	<para>按 <keycap>Esc</keycap> 键以使用默认的键盘映射。
 	  如果不清楚该选择哪一项， 推荐
 	  <guimenuitem>United States of America
 	    ISO-8859-1</guimenuitem>。</para>
       </note>
     </sect2>
 
     <sect2 xml:id="bsdinstall-hostname">
       <title>设置主机名</title>
 
       <para>下面， <application>bsdinstall</application>
 	将提示为新安装的系统设置主机名。</para>
 
       <figure xml:id="bsdinstall-config-hostname">
 	<title>设置主机名</title>
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-config-hostname"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>应该输入完整的主机名，
 	例如
 	<systemitem class="fqdomainname">machine3.example.com</systemitem>。</para>
     </sect2>
 
     <sect2 xml:id="bsdinstall-components">
       <title>选择要安装的组件</title>
 
       <para>下面， <application>bsdinstall</application> 
 	将提示选择要安装的组件。</para>
 
       <figure xml:id="bsdinstall-config-components">
 	<title>选择要安装的组件</title>
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-config-components"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>安装哪些组件很大程度取决于系统用途及可用磁盘空间。
 	注意， 任何情况下都会安装
 	&os; 内核及用户空间（统称<quote>基系统</quote>）。</para>
 
       <para>根据安装类型的不同， 某些组件可能不会显示。</para>
 
       <itemizedlist>
 	<title>可选组件</title>
 
 	<listitem>
 	  <para><literal>doc</literal> - 附加文档， 主要是与项目历史相关的内容。
 	    稍后还可以安装 &os; 文档计划所提供的文档。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>games</literal> - 一些传统的 BSD 游戏，
 	    包括 <application>fortune</application> 与
 	    <application>rot13</application> 等。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>lib32</literal> - 兼容库文件，
 	    用于在 64 位版本的 &os; 上运行 32 位程序。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>ports</literal> - &os; 的 ports 集。</para>
 
 	  <para>ports 集提供了一种简单而方便的途径来安装软件。
 	    在 ports 集中， 并不包含编译软件所需的源代码，
 	    取而代之的是一组能够自动下载、 编译并安装第三方软件包的文件。
 	    <xref linkend="ports"/> 会讲述如何使用 ports 集。</para>
 
 	  <warning>
 	    <para>选择此项时， 必须保证有足够的硬盘空间，
 	      注意安装程序并不会对此进行检查。
 	      &os; 9.0 的 ports 集约需 &ports.size; 的磁盘空间；
 	      您也可以为稍后的版本预留更大的空间。</para>
 	  </warning>
 	</listitem>
 
 	<listitem>
 	  <para><literal>src</literal> - 系统源代码。</para>
 
 	  <para>&os; 提供了与内核及用户空间有关的完整源代码。
 	    大部分程序并不需要这些源代码，
 	    它们主要用于联编特定软件（例如设备驱动或内核模块）或者
 	    &os; 本身的开发。</para>
 
 	  <para>完整的源代码树需要 1 GB 的磁盘空间，
 	    而重新编译整个 &os; 系统则额外还需要 5 GB 的空间。</para>
 	</listitem>
       </itemizedlist>
     </sect2>
   </sect1>
 
   <sect1 xml:id="bsdinstall-netinstall">
     <title>通过网络安装</title>
 
     <para><emphasis>bootonly</emphasis> 安装介质中并不会包含所有的安装文件。
       如果使用这种介质进行安装， 那么需要的文件就必须通过网络下载。</para>
 
     <figure xml:id="bsdinstall-netinstall-notify">
       <title>通过网络安装</title>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="bsdinstall/bsdinstall-netinstall-files"/>
 	</imageobject>
       </mediaobject>
     </figure>
 
     <para>根据
       <xref linkend="bsdinstall-config-network-dev"/> 配置了网络连接后，
       即可开始选择像站点。 镜像站点上缓存有 &os; 的安装文件，
       选择一个更近的镜像站点有助于更快的获取这些文件， 从而减少安装时间。</para>
 
     <figure xml:id="bsdinstall-netinstall-mirror">
       <title>选择一个镜像站点</title>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="bsdinstall/bsdinstall-netinstall-mirrorselect"/>
 	</imageobject>
       </mediaobject>
     </figure>
 
     <para>连接至所选镜像站点并查询到所需文件后， 安装将继续进行。</para>
   </sect1>
 
   <sect1 xml:id="bsdinstall-partitioning">
     <title>分配磁盘空间</title>
 
     <para>&os; 提供了三种方式来分配磁盘空间： 
       <emphasis>Guided（向导式）</emphasis> 分区能够自动设置磁盘分区；
       而 <emphasis>Manual（手动式）</emphasis> 分区则允许高级用户创建自定义分区；
       还可以进入 shell 中直接使用类似 &man.gpart.8;、 &man.fdisk.8; 与
       &man.bsdlabel.8; 这样的命令行程序。</para>
     <!-- WB: mention ZFS here? -->
 
     <figure xml:id="bsdinstall-part-guided-manual">
       <title>选择分配磁盘空间的方式</title>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="bsdinstall/bsdinstall-part-guided-manual"/>
 	</imageobject>
       </mediaobject>
     </figure>
 
     <sect2 xml:id="bsdinstall-part-guided">
       <title>向导式分区</title>
 
       <para>如果机器上配有多块磁盘， 则需要为 &os; 的安装指定目标磁盘。</para>
 
       <figure xml:id="bsdinstall-part-guided-disk">
 	<title>从多块磁盘中进行选择</title>
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-part-guided-disk"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>可以将整个磁盘都分配给 &os;， 也可以只分配其中的一部分。
 	若选择的是
 	<guibutton>[&nbsp;Entire&nbsp;Disk&nbsp;]</guibutton>，
 	则创建分区布局时会直接使用整个磁盘； 若选择的是
 	<guibutton>[&nbsp;Partition&nbsp;]</guibutton>，
 	则创建分区时仅会使用磁盘上的空闲空间。</para>
 
       <figure xml:id="bsdinstall-part-entire-part">
 	<title>选择如何创建分区布局</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-part-entire-part"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>请仔细检查分区布局的创建结果。
 	如果发现有错误之处， 可以选择
 	<guibutton>[&nbsp;Revert&nbsp;]</guibutton> 来还原之前的分区；
 	此外， 也可以选择
 	<guibutton>[&nbsp;Auto&nbsp;]</guibutton> 重新让 &os; 自动创建分区。
 	也可以手动创建、 修改或删除分区。 正确创建了分区之后，
 	请选择 <guibutton>[&nbsp;Finish&nbsp;]</guibutton> 以继续安装。</para>
 
       <figure xml:id="bsdinstall-part-review">
 	<title>检查已创建分区</title>
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-part-review"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
     </sect2>
 
     <sect2 xml:id="bsdinstall-part-manual">
       <title>手动式分区</title>
 
       <para>手动式分区将直接使用分区编辑器进行操作。</para>
 
       <figure xml:id="bsdinstall-part-manual-create">
 	<title>手动创建分区</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-part-manual-create"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>高亮目标驱动器（本例中为 <filename>ada0</filename>）并选择
 	<guibutton>[&nbsp;Create&nbsp;]</guibutton> 以显示
 	<firstterm>partitioning scheme（分区方案）</firstterm> 菜单。</para>
 
       <figure xml:id="bsdinstall-part-manual-partscheme">
 	<title>手动创建分区</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-part-manual-partscheme"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>对于 PC 兼容机来说， <acronym>GPT</acronym> 分区通常是最合适的选择，
 	而某些不兼容 <acronym>GPT</acronym> 的老式操作系统则可能需要使用
 	<acronym>MBR</acronym> 分区。
 	除此之外的分区方案仅用于一些不常见的或其他的老式操作系统。</para>
 
       <table frame="none" rowsep="1" pgwide="1">
 	<title>分区方案</title>
 
 	<tgroup cols="2" align="left">
 	  <thead>
 	    <row>
 	      <entry align="left">缩写</entry>
 	      <entry align="left">说明</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry>APM</entry>
 	      
 	      <entry><link xlink:href="http://support.apple.com/kb/TA21692">Apple
 		  Partition Map， 用于 &powerpc;
 		  &macintosh;。</link></entry>
 	    </row>
 
 	    <row>
 	      <entry>BSD</entry>
 	      <entry>不带 MBR 的 BSD Label， 有时也称作危险的专用模式，
 		“dangerously dedicated mode”。 请参阅
 		&man.bsdlabel.8;。</entry>
 	    </row>
 
 	    <row>
 	      <entry>GPT</entry>
 	      <entry><link xlink:href="http://en.wikipedia.org/wiki/GUID_Partition_Table">GUID
 		  分区表。</link></entry>
 	    </row>
 
 	    <row>
 	      <entry>MBR</entry>
 	      <entry><link xlink:href="http://en.wikipedia.org/wiki/Master_boot_record">Master
 		  Boot Record， 主引导记录。</link></entry>
 	    </row>
 
 	    <row>
 	      <entry>PC98</entry>
 	      <entry><link xlink:href="http://en.wikipedia.org/wiki/Pc9801">MBR
 		  变体， 用于 NEC PC-98
 		  计算机。</link></entry>
 	    </row>
 
 	    <row>
 	      <entry>VTOC8</entry>
 	      <entry>Volume Table Of Contents， 用于 Sun SPARC64 和
 		UltraSPARC 计算机。</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <para>确定了分区方案并创建完成后， 可再次选择
 	<guibutton>[&nbsp;Create&nbsp;]</guibutton> 以创建新的分区。</para>
 
       <figure xml:id="bsdinstall-part-manual-addpart">
 	<title>手动创建分区</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-part-manual-addpart"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>&os; 的标准 <acronym>GPT</acronym> 安装至少会使用三个分区：</para>
 
       <itemizedlist>
 	<title>标准 &os; <acronym>GPT</acronym> 分区</title>
 
 	<listitem>
 	  <para><literal>freebsd-boot</literal> - &os; 引导分区，
 	    它必须处于首位。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>freebsd-ufs</literal> - &os; 的 UFS 文件系统。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>freebsd-swap</literal> - &os; 的交换空间。</para>
 	</listitem>
       </itemizedlist>
 
       <para>也可以同时创建多个文件系统分区。
 	有些用户会喜欢传统的分区格局，
 	为 <filename>/</filename>、
 	<filename>/var</filename>、 <filename>/tmp</filename>， 以及 <filename>/usr</filename>
 	文件系统分别创建分区。 请参阅 <xref linkend="bsdinstall-part-manual-splitfs"/>
 	中的例子。</para>
 
       <para>可用的
 	<acronym>GPT</acronym> 分区类型可以在 &man.gpart.8;
 	中找到。</para>
 
       <para>在指定尺寸时， 可以使用常用的缩写：
 	<emphasis>K</emphasis> 表示 kilobytes、 <emphasis>M</emphasis>
 	表示 megabytes， 而 <emphasis>G</emphasis> 表示 gigabytes。</para>
 
       <tip>
 	<para>正确地对齐磁盘扇区能够获取最佳性能。
 	  无论磁盘的每个扇区为 512 字节还是 4K 字节，
 	  将分区大小设置为 4K 字节的倍数都能够确保对齐。
 	  实际操作中， 只要使分区的大小等于 1M 或 1G 的倍数即可。
 	  唯一的例外是 <emphasis>freebsd-boot</emphasis> 分区，
 	  目前由于引导代码所限， 此分区不能大于 512K。</para>
       </tip>
 
       <para>若分区包含文件系统，则需要在 Mountpoint 项中为其输入挂载点；
 	若仅创建了一个 UFS 分区， 则应在此项中输入 <filename>/</filename>。</para>
 
       <para>最后需要输入的是 <firstterm>Label（标签）</firstterm> 项，
 	用于命名所创建的分区。 如果将驱动器连接至不同的控制器或端口，
 	其名称或编号会发生改变， 但对应的标签并不会变化。
 	在类似 <filename>/etc/fstab</filename> 这样的文件中，
 	通过标签引用分区比通过驱动器名加分区编号引用更加灵活，
 	因为这样引用使系统对硬件的改变更加宽容。
 	GPT 的标签会在磁盘连接后出现在 <filename>/dev/gpt/</filename> 中；
 	而其他分区方案中的标签也有不同的功能， 它们会出现在
 	<filename>/dev/</filename> 中的不同目录里。</para>
 
       <tip>
 	<para>为避免冲突， 请给每个文件系统指定独一无二的标签。
 	  与计算机的名称、 用途或位置相关的字符均可添加至标签。 例如，
 	  实验室计算机的 UFS 根目录可以命名为 “labroot” 或 “rootfs-lab”。</para>
       </tip>
 
       <example xml:id="bsdinstall-part-manual-splitfs">
 	<title>创建传统的分割式文件系统分区</title>
 
 	<para>在传统的分区布局中， 目录 <filename>/</filename>、
 	  <filename>/var</filename>、 <filename>/tmp</filename> 及
 	  <filename>/user</filename> 都是位于自己分区上的独立文件系统；
 	  在 GPT 分区方案中也可以创建这样的分区布局。
 	  本例中所使用的是一块 20G 的硬盘， 如果使用更大的硬盘，
 	  建议创建更大的交换或 <filename>/var</filename> 分区。
 	  标签的前缀 <literal>ex</literal> 是指 “example”，
 	  具体操作时您可以使用任何独一无二的字符。</para>
 
         <informaltable frame="none">
           <tgroup cols="4">
             <thead>
               <row>
                 <entry>分区类型</entry>
                 <entry>大小</entry>
                 <entry>挂载点</entry>
                 <entry>标签</entry>
               </row>
             </thead>
 
             <tbody>
               <row>
                 <entry><literal>freebsd-boot</literal></entry>
                 <entry><literal>512K</literal></entry>
 		<entry/>
 		<entry/>
               </row>
 
               <row>
                 <entry><literal>freebsd-ufs</literal></entry>
                 <entry><literal>2G</literal></entry>
                 <entry><filename>/</filename></entry>
                 <entry><literal>exrootfs</literal></entry>
               </row>
 
               <row>
                 <entry><literal>freebsd-swap</literal></entry>
                 <entry><literal>4G</literal></entry>
                 <entry/>
                 <entry><literal>exswap</literal></entry>
               </row>
 
               <row>
                 <entry><literal>freebsd-ufs</literal></entry>
                 <entry><literal>2G</literal></entry>
                 <entry><filename>/var</filename></entry>
                 <entry><literal>exvarfs</literal></entry>
               </row>
 
               <row>
                 <entry><literal>freebsd-ufs</literal></entry>
                 <entry><literal>1G</literal></entry>
                 <entry><filename>/tmp</filename></entry>
                 <entry><literal>extmpfs</literal></entry>
               </row>
 
               <row>
                 <entry><literal>freebsd-ufs</literal></entry>
                 <entry>接受默认值（剩余空间）</entry>
                 <entry><filename>/usr</filename></entry>
                 <entry><literal>exusrfs</literal></entry>
               </row>
             </tbody>
           </tgroup>
         </informaltable>
       </example>
 
       <para>创建了自定义分区后， 请选择
 	<guibutton>[&nbsp;Finish&nbsp;]</guibutton> 以继续安装。</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="bsdinstall-final-warning">
     <title>安装确认</title>
 
     <para>下面， 安装程序将真正对硬盘进行写操作，
       这也是取消安装的最后机会。</para>
 
     <figure xml:id="bsdinstall-final-confirmation">
       <title>最后确认</title>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="bsdinstall/bsdinstall-final-confirmation"/>
 	</imageobject>
       </mediaobject>
     </figure>
 
     <para>选择 <guibutton>[&nbsp;Commit&nbsp;]</guibutton>
       并按 <keycap>Enter</keycap> 键确认安装；
       选择 <guibutton>[&nbsp;Back&nbsp;]</guibutton> 以返回分区编辑器进行修改；
       选择 <guibutton>[&nbsp;Revert&nbsp;&amp;&nbsp;Exit&nbsp;]
       </guibutton>以退出安装而不修改任何硬盘数据。</para>
 
     <para>根据所选组件、 安装介质和机器速度的不同， 需要的时间会有所变化。
       安装时会有一系列信息显示目前的进度。</para>
 
     <para>首先， 安装程序会将分区布局写入磁盘， 并执行
       <command>newfs</command> 初始化分区。</para>
 
     <para>如果是通过网络安装，
       <application>bsdinstall</application>
       将根据之前所选的组件下载对应的文件。</para>
     <!-- XXXGA: What does it do if fetch fails? -->
 
     <figure xml:id="bsdinstall-distfile-fetching">
       <title>获取组件对应的文件</title>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="bsdinstall/bsdinstall-distfile-fetching"/>
 	</imageobject>
       </mediaobject>
     </figure>
 
     <para>接下来， 会验证这些文件的完整性，
       以防止其在下载时损坏或从安装介质中误读。</para>
 
     <figure xml:id="bsdinstall-distfile-verify">
       <title>验证组件对应的文件</title>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="bsdinstall/bsdinstall-distfile-verifying"/>
 	</imageobject>
       </mediaobject>
     </figure>
 
     <para>最后， 验证过的组件文件会被提取至磁盘。</para>
 
     <figure xml:id="bsdinstall-distfile-extract">
       <title>提取组件对应的文件</title>
 
       <mediaobject>
 	<imageobject>
 	  <imagedata fileref="bsdinstall/bsdinstall-distfile-extracting"/>
 	</imageobject>
       </mediaobject>
     </figure>
 
     <para>文件提取全部完成后， <application>bsdinstall</application>
       将开始安装后的配置任务（参见
       <xref linkend="bsdinstall-post"/>）。</para>
   </sect1>
 
   <sect1 xml:id="bsdinstall-post">
     <title>安装后的配置</title>
 
     <para>成功安装 &os; 后， 还需要依次进行一些配置。
       在重启进入新系统前， 这些配置始终可以通过最终的配置菜单进行修改。</para>
 
     <sect2 xml:id="bsdinstall-post-root">
       <title>设置 <systemitem class="username">root</systemitem> 密码</title>
 
       <para>必须设置 <systemitem class="username">root</systemitem> 密码。 请注意输入密码时，
         被输入的字符并不会在屏幕上显示， 因此为防止输入错误，
         必须再次输入相同的字符。</para>
 
       <figure xml:id="bsdinstall-post-set-root-passwd">
 	<title>设置 <systemitem class="username">root</systemitem> 密码</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-post-root-passwd"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>成功设置密码后， 安装将继续进行。</para>
     </sect2>
 
     <sect2 xml:id="bsdinstall-config-network-dev">
       <title>配置网络接口</title>
 
       <note>
 	<para>如果已经在 <emphasis>bootonly</emphasis> 安装时配置过网络接口，
 	  则可略过此步。</para>
       </note>
 
       <para>这里将显示一个网络接口列表，
 	其中的接口都是在当前计算机上侦测到的， 请选择一个进行配置。</para>
 
       <figure xml:id="bsdinstall-configure-net-interface">
 	<title>选择一个网络接口</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-configure-network-interface"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <sect3 xml:id="bsdinstall-configure-net-wireless">
 	<title>配置无线网络接口</title>
 
 	<para>如果选择了无线网络接口，
 	  则必须输入相关的无线网络验证及安全参数，
 	  以允许其连接至特定的网络。</para>
 
 	<para>无线网络是通过 Service Set Identifier（服务集标识符，
 	  简写为 <acronym role="Service Set Identifier">
 	  SSID</acronym>）来表示的，
 	  它是唯一表示无线网络的短字符串。</para>
 
 	<para>大多数无线网络都会以加密方式传输数据，
 	  藉此保护信息不被未经授权者查看。 强烈建议采用 <acronym role="Wi-Fi Protected Access II">WPA2</acronym> 加密。
 	  旧式的加密类型， 如
 	  <acronym role="Wired Equivalent Privacy">WEP</acronym>，
 	  几乎没有任何安全性可言。</para>
 
 	<para>若要连接至一个无线网络， 首先需要扫描无线接入点。</para>
 
 	<figure xml:id="bsdinstall-wireless-scan">
 	  <title>扫描无线接入点</title>
 
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="bsdinstall/bsdinstall-configure-wireless-scan"/>
 	    </imageobject>
 	  </mediaobject>
 	</figure>
 
 	<para>扫描完成后， 会列出所有发现的
 	  <acronym role="Service Set Identifiers">SSID</acronym>
 	  以及它们支持的加密类型说明。
 	  如果需要连接的 <acronym role="Service Set      Identifier">SSID</acronym> 没有列出，
 	  请选择 <guibutton>[&nbsp;Rescan&nbsp;]</guibutton> 再次扫描。
 	  如果还没有出现， 请检查天线， 或将计算机移至更靠近接入点的地方。
 	  在做过这些改善措施之后， 再重新扫描。</para>
 
 	<figure xml:id="bsdinstall-wireless-accesspoints">
 	  <title>选择一个无线网络</title>
 
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="bsdinstall/bsdinstall-configure-wireless-accesspoints"/>
 	    </imageobject>
 	  </mediaobject>
 	</figure>
 
 	<para>选择所要连接的无线网络， 即可输入连接所需的加密信息。
 	  对于 <acronym role="Wi-Fi Protected Access      II">WPA2</acronym>， 只需输入一个密码 （也叫预共享密钥，(
 	  简称 <acronym role="Pre-Shared      Key">PSK</acronym>）。 为安全起见，
 	  在输入框中键入的字符将显示为星号。</para>
 
 	<figure xml:id="bsdinstall-wireless-wpa2">
 	  <title>WPA2 设置</title>
 
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="bsdinstall/bsdinstall-configure-wireless-wpa2setup"/>
 	    </imageobject>
 	  </mediaobject>
 	</figure>
 
 	<para>在选择了无线网络并输入了连接所需的信息后，
 	  网络配置将继续进行。</para>
       </sect3>
 
       <sect3 xml:id="bsdinstall-ipv4">
 	<title>配置 IPv4 网络</title>
 
 	<para>选择是否使用 IPv4 网络。 这是最常见的网络连接类型。</para>
 
 	<figure xml:id="bsdinstall-configure-net-ipv4">
 	  <title>选择 IPv4 网络</title>
 
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="bsdinstall/bsdinstall-configure-network-interface-ipv4"/>
 	    </imageobject>
 	  </mediaobject>
 	</figure>
 
 	<para>有两种配置 IPv4 的方式。
 	  <firstterm><acronym role="Dynamic Host Configuration      Protocol">DHCP</acronym></firstterm> 会自动地为网络接口进行正确的配置，
 	  通常情况下， 这是首选的方式。 而 <firstterm>Static</firstterm>
 	  （静态） 方式则需要手工输入网络的配置信息。</para>
 
 	<note>
 	  <para>不要随意输入网络的配置信息， 因为这样的话网络就无法正常工作。
 	    请向网络管理员或服务提供商那里取得
 	    <xref linkend="bsdinstall-collect-network-information"/>
 	    所列出的配置信息。</para>
 	</note>
 
 	<sect4 xml:id="bsdinstall-net-ipv4-dhcp-config">
 	  <title>使用 DHCP 方式</title>
 
 	  <para>若存在可用的 DHCP 服务器， 请选择
 	    <guibutton>[ Yes ]</guibutton> 以自动配置网络接口。</para>
 
 	  <figure xml:id="bsdinstall-net-ipv4-dhcp">
 	    <title>选择 DHCP 配置 IPv4</title>
 
 	    <mediaobject>
 	      <imageobject>
 		<imagedata fileref="bsdinstall/bsdinstall-configure-network-interface-ipv4-dhcp"/>
 	      </imageobject>
 	    </mediaobject>
 	  </figure>
 	</sect4>
 
 	<sect4 xml:id="bsdinstall-net-ipv4-static-config">
 	  <title>使用静态配置方式</title>
 
 	  <para>网络接口的静态配置需要输入相关的 IPv4 配置信息。</para>
 
 	  <figure xml:id="bsdinstall-net-ipv4-static">
 	    <title>静态配置 IPv4</title>
 
 	    <mediaobject>
 	      <imageobject>
 		<imagedata fileref="bsdinstall/bsdinstall-configure-network-interface-ipv4-static"/>
 	      </imageobject>
 	    </mediaobject>
 	  </figure>
 
 	  <itemizedlist>
 	    <listitem>
 	      <para><literal>IP Address</literal> - IP 地址，
 		即给当前计算机手动分配的 IPv4 地址。 此地址必须是唯一的，
 		并且在本地网络上还没有被其他设备使用。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para><literal>Subnet Mask</literal> - 子网掩码， 用于本地网络。
 		通常是 <literal>255.255.255.0</literal>。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para><literal>Default Router</literal>（默认路由）
 		- 网络上默认路由的 IP 地址。 通常，
 		这是将本地网络连接至 Internet
 		的路由器或其他网络设备的地址。 也称作 <emphasis>default
 		  gateway （默认网关）</emphasis>。</para>
 	    </listitem>
 	  </itemizedlist>
 	</sect4>
       </sect3>
 
       <sect3 xml:id="bsdinstall-ipv6">
 	<title>配置 IPv6 网络</title>
 
 	<para>IPv6 是一种新的网络配置方式。 如果您有可用的
 	  IPv6 连接， 并需要使用它， 选择
 	  <guibutton>[&nbsp;Yes&nbsp;]</guibutton> 来开始配置。</para>
 
 	<figure xml:id="bsdinstall-net-ipv6">
 	  <title>选择 IPv6 网络</title>
 
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="bsdinstall/bsdinstall-configure-network-interface-ipv6"/>
 	    </imageobject>
 	  </mediaobject>
 	</figure>
 
 	<para>IPv6 也有两种配置方式。
 	  <firstterm><acronym role="StateLess Address      AutoConfiguration">SLAAC</acronym> </firstterm>， 或
 	  <emphasis>StateLess Address AutoConfiguration</emphasis>
 	  （无状态地址自动配置）
 	  方式能够自动配置正确的网络接口， 而 <firstterm>Static（静态）</firstterm>
 	  配置方式则需要手动输入网络信息。</para>
 
 	<sect4 xml:id="bsdinstall-net-ipv6-slaac-config">
 	  <title>使用 Stateless Address Autoconfiguration 方式</title>
 
 	  <para><acronym>SLAAC</acronym> 允许 IPv6
 	    组件从本地路由器请求自动配置信息， 详情参见 <link xlink:href="http://tools.ietf.org/html/rfc4862">RFC4862</link>。</para>
 
 	  <figure xml:id="bsdinstall-net-ipv6-slaac">
 	    <title>选择 SLAAC 配置 IPv6</title>
 
 	    <mediaobject>
 	      <imageobject>
 		<imagedata fileref="bsdinstall/bsdinstall-configure-network-interface-slaac"/>
 	      </imageobject>
 	    </mediaobject>
 	  </figure>
 	</sect4>
 
 	<sect4 xml:id="bsdinstall-net-ipv6-static-config">
 	  <title>使用静态配置方式</title>
 
 	  <para>网络接口的静态配置需要输入相关的 IPv6 配置信息。</para>
 
 	  <figure xml:id="bsdinstall-net-ipv6-static">
 	    <title>静态配置 IPv6</title>
 
 	    <mediaobject>
 	      <imageobject>
 		<imagedata fileref="bsdinstall/bsdinstall-configure-network-interface-ipv6-static"/>
 	      </imageobject>
 	    </mediaobject>
 	  </figure>
 
 	  <itemizedlist>
 	    <listitem>
 	      <para><literal>IPv6 Address</literal> （IPv6地址） -
 		为当前计算机手工分配的 <acronym>IP</acronym> 地址。
 		这个地址必须是唯一的， 并且没有被其他本地网络设备使用。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para><literal>Default Router</literal> （默认路由） -
 		网络上默认路由的地址。 通常，
 		这是将本地网络连接至 Internet
 		的路由器或其他网络设备的地址。 也称作 <emphasis>default
 		  gateway （默认网关）</emphasis>。</para>
 	    </listitem>
 	  </itemizedlist>
 	</sect4>
       </sect3>
 
       <sect3 xml:id="bsdinstall-net-dns">
 	<title>配置 <acronym role="Domain Name      System">DNS</acronym></title>
 
 	<para><firstterm>Domain Name System</firstterm> （域名系统，简称
 	  <emphasis><acronym role="Domain Name        System">DNS</acronym></emphasis>）
 	  解析器用于主机名和网络地址间的相互转换。 如果使用的是
 	  <acronym>DHCP</acronym> 或 <acronym>SLAAC</acronym>，
 	  那么其配置很可能已经存在； 否则， 请在 Search 字段中输入本地网络的域名，
 	  在 <acronym>DNS</acronym> #1 和 <acronym>DNS</acronym> #2 中输入本地
 	  <acronym>DNS</acronym> 服务器的 <acronym>IP</acronym> 地址。
 	  至少需要配置一个 <acronym>DNS</acronym> 服务器。</para>
 
 	<figure xml:id="bsdinstall-net-dns-config">
 	  <title>DNS 配置</title>
 
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="bsdinstall/bsdinstall-configure-network-ipv4-dns"/>
 	    </imageobject>
 	  </mediaobject>
 	</figure>
       </sect3>
     </sect2>
 
     <sect2 xml:id="bsdinstall-timezone">
       <title>设置时区</title>
 
       <para>为您的机器设置时区将允许其自动校时，
 	并正确执行一些与时区相关的操作。</para>
 
       <para>示例中的机器位于美国东部时区。 根据所处的地理位置，
 	您的选择可能会有所不同。</para>
 
       <figure xml:id="bsdinstall-local-utc">
 	<title>选择本地或 UTC 时钟</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-set-clock-local-utc"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>选择 <guibutton>[&nbsp;Yes&nbsp;]</guibutton>
 	或 <guibutton>[&nbsp;No&nbsp;]</guibutton> 以确定机器时钟的配置方式，
 	然后按 <keycap>Enter</keycap> 键。 如果您并不知道系统使用的是
 	UTC 还是本地时间， 请选择 <guibutton>[&nbsp;No&nbsp;]</guibutton>
 	以使用更为常见的本地时间。</para>
 
       <figure xml:id="bsdinstall-timezone-region">
 	<title>选择地区</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-timezone-region"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>使用方向键选择合适的地区后按下 <keycap>Enter</keycap> 键。</para>
 
       <figure xml:id="bsdinstall-timezone-country">
 	<title>选择国家</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-timezone-country"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>用方向键选择合适的国家后按下 <keycap>Enter</keycap> 键。</para>
 
       <figure xml:id="bsdinstall-timezone-zone">
 	<title>选择时区</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-timezone-zone"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>用方向键选择合适的时区后按下 <keycap>Enter</keycap> 键。</para>
 
       <figure xml:id="bsdinstall-timezone-confirmation">
 	<title>确认时区选择</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-timezone-confirm"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>确认时区的缩写是正确的， 然后按 <keycap>Enter</keycap>
 	键以继续安装后的配置。</para>
     </sect2>
 
     <sect2 xml:id="bsdinstall-sysconf">
       <title>选择需要开启的服务</title>
 
       <para>可以开启额外的系统服务， 它们会在系统启动时自动运行。
 	所有这些服务都是可选的。</para>
 
       <figure xml:id="bsdinstall-config-serv">
 	<title>选择需要开启的服务</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-config-services"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <itemizedlist>
 	<title>额外的系统服务</title>
 
 	<listitem>
 	  <para><literal>sshd</literal> - Secure Shell（即
 	    <acronym role="Secure Shell">SSH</acronym>） 守护进程，
 	    提供安全的远程访问。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>moused</literal> - 支持在系统控制台中使用鼠标。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>ntpd</literal> - Network Time Protocol（网络时间协议，
 	    简称 <acronym role="Network Time Protocol">NTP</acronym>） 守护进程，
 	    提供时钟自动同步。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>powerd</literal> - 系统电量控制程序，
 	    用于控制电量及节能。</para>
 	</listitem>
       </itemizedlist>
     </sect2>
 
     <sect2 xml:id="bsdinstall-crashdump">
       <title>启用崩溃转储</title>
 
       <para><application>bsdinstall</application>
 	将询问是否在目标系统上启用崩溃转储。 由于在调试系统时非常有用，
 	因此鼓励用户尽可能地启用崩溃转储。
 	选择 <guibutton>[&nbsp;Yes&nbsp;]</guibutton> 以启用崩溃转储，
 	或选择 <guibutton>[&nbsp;No&nbsp;]</guibutton> 以不启用崩溃转储。</para>
 
       <figure xml:id="bsdinstall-config-crashdump">
 	<title>启用崩溃转储</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-config-crashdump"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
     </sect2>
 
     <sect2 xml:id="bsdinstall-addusers">
       <title>添加用户</title>
 
       <para>在安装过程中， 应至少添加一位普通用户， 而不要始终以
 	<systemitem class="username">root</systemitem> 身份登入。 当以
 	<systemitem class="username">root</systemitem> 身份登入系统时，
 	系统几乎不会对其操作提供任何限制或保护。
 	以普通用户身份登录更为安全。</para>
 
       <para>选择 <guibutton>[ Yes ]</guibutton> 来添加新用户。</para>
 
       <figure xml:id="bsdinstall-add-user1">
 	<title>添加用户帐号</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-adduser1"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>为需要添加的用户输入信息。</para>
 
       <figure xml:id="bsdinstall-add-user2">
 	<title>输入用户信息</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-adduser2"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <itemizedlist>
 	<title>用户信息</title>
 
 	<listitem>
 	  <para><literal>Username</literal> - 用户名， 即登入时用户所输入的名称。
 	    通常是名的首字母加姓的组合。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Full name</literal> - 用户的全名。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Uid</literal> - 用户 ID。 通常留空以自动分配。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Login group</literal> - 用户组。
 	    通常留空以接受默认取值。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Invite user into
 	    other groups?</literal> - 是否同时将用户加入其他权限组？
 	    如果需要， 请输入权限组名称。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Login class</literal> - 登录类别。
 	    通常留空以接受默认取值。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Shell</literal> - 用户 shell。
 	    在本例中选择的是 &man.csh.1;。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Home directory</literal> - 用户主目录。
 	    通常留空以接受默认取值。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Home directory permissions</literal> -
 	    用户主目录的权限。 通常留空以接受默认取值。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Use password-based authentication?</literal> -
 	    是否使用基于密码的认证？ 通常为 “yes”。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Use an empty password?</literal> - 是否使用空密码？
 	    通常为 “no”。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Use a random password?</literal> - 是否使用随机密码？
 	    通常为 “no”。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Enter password</literal> - 用户的实际密码。
 	    输入的字符不会在屏幕上显示。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Enter password again</literal> -
 	    必须再次输入密码以进行验证。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Lock out the account after
 	    creation?</literal> - 创建后锁定帐号？ 通常为 “no”。</para>
 	</listitem>
       </itemizedlist>
 
       <para>全部信息输入完成后， 系统会显示摘要并询问是否正确。
 	如果发现了错误， 可以输入 <literal>no</literal> 后进行修改；
 	如果没有错误， 请输入 <literal>yes</literal> 以创建新用户。</para>
 
       <figure xml:id="bsdinstall-add-user3">
 	<title>退出用户与组管理</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-adduser3"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>若需添加更多用户， 请在问题“Add another user?”后输入
 	 <literal>yes</literal>； 输入 <literal>no</literal>
 	 以完成用户添加并继续安装。</para>
 
       <para>更多有关用户添加及管理的信息， 请参见 <xref linkend="users"/>。</para>
     </sect2>
 
     <sect2 xml:id="bsdinstall-final-conf">
       <title>最终配置</title>
 
       <para>所有的安装及配置完成后， 仍有机会对其进行修改。</para>
 
       <figure xml:id="bsdinstall-final-config">
 	<title>最终的配置菜单</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-finalconfiguration"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>使用此菜单， 可以在完成安装前添加或修改任何配置。</para>
 
       <itemizedlist>
 	<title>最终的配置选项</title>
 
 	<listitem>
 	  <para><literal>Add User</literal> - 添加用户，
 	    详见 <xref linkend="bsdinstall-addusers"/>。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Root Password</literal> - root 密码，
 	    详见 <xref linkend="bsdinstall-post-root"/>。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Hostname</literal> - 主机名，
 	    详见 <xref linkend="bsdinstall-hostname"/>。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Network</literal> - 网络，
 	    详见 <xref linkend="bsdinstall-config-network-dev"/>。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Services</literal> - 服务，
 	    详见 <xref linkend="bsdinstall-sysconf"/>.</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Time Zone</literal> - 时区，
 	    详见 <xref linkend="bsdinstall-timezone"/>。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>Handbook</literal> - 手册，将下载并安装
 	    &os; 使用手册（即本书）。</para>
 	</listitem>
       </itemizedlist>
 
       <para>完成了最终配置后，
 	请选择 <guibutton>Exit</guibutton> 以继续安装。</para>
 
       <figure xml:id="bsdinstall-final-modification-shell">
 	<title>手动配置</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-final-modification-shell"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para><application>bsdinstall</application>
 	会询问重启前是否还需要额外的配置： 选择
 	<guibutton>[&nbsp;Yes&nbsp;]</guibutton> 进入 shell
 	做这些配置， 选择
 	<guibutton>[&nbsp;No&nbsp;]</guibutton> 以执行安装的最后一步。</para>
 
       <figure xml:id="bsdinstall-final-main">
 	<title>完成安装</title>
 
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="bsdinstall/bsdinstall-mainexit"/>
 	  </imageobject>
 	</mediaobject>
       </figure>
 
       <para>如果需要进一步的配置或特殊的设置，
 	可以选择 <guibutton>[&nbsp;Live&nbsp;CD&nbsp;]</guibutton>
 	来进入安装介质的 Live CD 模式。</para>
 
       <para>安装完成后，选择
 	<guibutton>[&nbsp;Reboot&nbsp;]</guibutton> 重启计算机，
 	并开始使用全新的 &os; 系统。 请不要忘记移除 &os; 的安装
 	CD、 DVD 或 USB 记忆棒， 否则计算机可能会再次从这些介质启动。</para>
     </sect2>
 
     <sect2 xml:id="bsdinstall-freebsdboot">
       <title>&os; 的启动与关闭</title>
 
       <sect3 xml:id="bsdinstall-freebsdboot-i386">
 	<title>&os;/&arch.i386; 的启动</title>
 
       <para>&os; 启动时会显示许多相关信息， 正常情况下屏幕会不断滚动，
 	而启动完成后则会显示一个登录提示符。 如果需要查看启动时的相关信息，
 	可以按下 <keycap>Scroll-Lock</keycap> 键开启
 	<emphasis>scroll-back buffer（回滚缓存）</emphasis>，
 	然后使用 <keycap>PageUp</keycap> 键、 <keycap>PageDown</keycap>
 	键与方向键行翻阅； 再次按下 <keycap>Scroll Lock</keycap>
 	键将关闭回滚缓存并返回正常的屏幕。</para>
 
       <para>在 <prompt>login:</prompt> 提示符处输入安装时添加的用户名来登录系统，
 	本例中是 <systemitem class="username">asample</systemitem>。 除非有必要，否则请勿作为
 	<systemitem class="username">root</systemitem> 登录。</para>
 
       <para>上述的回滚缓存大小有限， 因而未必全部可见。 登入系统后，
 	在提示符处输入 <command>dmesg | less</command>，
 	能够查看到绝大部分的启动信息， 查看后按
 	<keycap>q</keycap> 键返回命令行。</para>
 
       <para>典型的启动信息（此处略去了版本信息）：</para>
 
 	<screen>Copyright (c) 1992-2011 The FreeBSD Project.
 Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994
         The Regents of the University of California. All rights reserved.
 FreeBSD is a registered trademark of The FreeBSD Foundation.
 
     root@farrell.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC amd64
 CPU: Intel(R) Core(TM)2 Duo CPU     E8400  @ 3.00GHz (3007.77-MHz K8-class CPU)
   Origin = "GenuineIntel"  Id = 0x10676  Family = 6  Model = 17  Stepping = 6
   Features=0x783fbff&lt;FPU,VME,DE,PSE,TSC,MSR,PAE,MCE,CX8,APIC,SEP,MTRR,PGE,MCA,CMOV,PAT,PSE36,MMX,FXSR,SSE,SSE2&gt;
   Features2=0x209&lt;SSE3,MON,SSSE3&gt;
   AMD Features=0x20100800&lt;SYSCALL,NX,LM&gt;
   AMD Features2=0x1&lt;LAHF&gt;
 real memory  = 536805376 (511 MB)
 avail memory = 491819008 (469 MB)
 Event timer "LAPIC" quality 400
 ACPI APIC Table: &lt;VBOX   VBOXAPIC&gt;
 ioapic0: Changing APIC ID to 1
 ioapic0 &lt;Version 1.1&gt; irqs 0-23 on motherboard
 kbd1 at kbdmux0
 acpi0: &lt;VBOX VBOXXSDT&gt; on motherboard
 acpi0: Power Button (fixed)
 acpi0: Sleep Button (fixed)
 Timecounter "ACPI-fast" frequency 3579545 Hz quality 900
 acpi_timer0: &lt;32-bit timer at 3.579545MHz&gt; port 0x4008-0x400b on acpi0
 cpu0: &lt;ACPI CPU&gt; on acpi0
 pcib0: &lt;ACPI Host-PCI bridge&gt; port 0xcf8-0xcff on acpi0
 pci0: &lt;ACPI PCI bus&gt; on pcib0
 isab0: &lt;PCI-ISA bridge&gt; at device 1.0 on pci0
 isa0: &lt;ISA bus&gt; on isab0
 atapci0: &lt;Intel PIIX4 UDMA33 controller&gt; port 0x1f0-0x1f7,0x3f6,0x170-0x177,0x376,0xd000-0xd00f at device 1.1 on pci0
 ata0: &lt;ATA channel 0&gt; on atapci0
 ata1: &lt;ATA channel 1&gt; on atapci0
 vgapci0: &lt;VGA-compatible display&gt; mem 0xe0000000-0xe0ffffff irq 18 at device 2.0 on pci0
 em0: &lt;Intel(R) PRO/1000 Legacy Network Connection 1.0.3&gt; port 0xd010-0xd017 mem 0xf0000000-0xf001ffff irq 19 at device 3.0 on pci0
 em0: Ethernet address: 08:00:27:9f:e0:92
 pci0: &lt;base peripheral&gt; at device 4.0 (no driver attached)
 pcm0: &lt;Intel ICH (82801AA)&gt; port 0xd100-0xd1ff,0xd200-0xd23f irq 21 at device 5.0 on pci0
 pcm0: &lt;SigmaTel STAC9700/83/84 AC97 Codec&gt;
 ohci0: &lt;OHCI (generic) USB controller&gt; mem 0xf0804000-0xf0804fff irq 22 at device 6.0 on pci0
 usbus0: &lt;OHCI (generic) USB controller&gt; on ohci0
 pci0: &lt;bridge&gt; at device 7.0 (no driver attached)
 acpi_acad0: &lt;AC Adapter&gt; on acpi0
 atkbdc0: &lt;Keyboard controller (i8042)&gt; port 0x60,0x64 irq 1 on acpi0
 atkbd0: &lt;AT Keyboard&gt; irq 1 on atkbdc0
 kbd0 at atkbd0
 atkbd0: [GIANT-LOCKED]
 psm0: &lt;PS/2 Mouse&gt; irq 12 on atkbdc0
 psm0: [GIANT-LOCKED]
 psm0: model IntelliMouse Explorer, device ID 4
 attimer0: &lt;AT timer&gt; port 0x40-0x43,0x50-0x53 on acpi0
 Timecounter "i8254" frequency 1193182 Hz quality 0
 Event timer "i8254" frequency 1193182 Hz quality 100
 sc0: &lt;System console&gt; at flags 0x100 on isa0
 sc0: VGA &lt;16 virtual consoles, flags=0x300&gt;
 vga0: &lt;Generic ISA VGA&gt; at port 0x3c0-0x3df iomem 0xa0000-0xbffff on isa0
 atrtc0: &lt;AT realtime clock&gt; at port 0x70 irq 8 on isa0
 Event timer "RTC" frequency 32768 Hz quality 0
 ppc0: cannot reserve I/O port range
 Timecounters tick every 10.000 msec
 pcm0: measured ac97 link rate at 485193 Hz
 em0: link state changed to UP
 usbus0: 12Mbps Full Speed USB v1.0
 ugen0.1: &lt;Apple&gt; at usbus0
 uhub0: &lt;Apple OHCI root HUB, class 9/0, rev 1.00/1.00, addr 1&gt; on usbus0
 cd0 at ata1 bus 0 scbus1 target 0 lun 0
 cd0: &lt;VBOX CD-ROM 1.0&gt; Removable CD-ROM SCSI-0 device
 cd0: 33.300MB/s transfers (UDMA2, ATAPI 12bytes, PIO 65534bytes)
 cd0: Attempt to query device size failed: NOT READY, Medium not present
 ada0 at ata0 bus 0 scbus0 target 0 lun 0
 ada0: &lt;VBOX HARDDISK 1.0&gt; ATA-6 device
 ada0: 33.300MB/s transfers (UDMA2, PIO 65536bytes)
 ada0: 12546MB (25694208 512 byte sectors: 16H 63S/T 16383C)
 ada0: Previously was known as ad0
 Timecounter "TSC" frequency 3007772192 Hz quality 800
 Root mount waiting for: usbus0
 uhub0: 8 ports with 8 removable, self powered
 Trying to mount root from ufs:/dev/ada0p2 [rw]...
 Setting hostuuid: 1848d7bf-e6a4-4ed4-b782-bd3f1685d551.
 Setting hostid: 0xa03479b2.
 Entropy harvesting: interrupts ethernet point_to_point kickstart.
 Starting file system checks:
 /dev/ada0p2: FILE SYSTEM CLEAN; SKIPPING CHECKS
 /dev/ada0p2: clean, 2620402 free (714 frags, 327461 blocks, 0.0% fragmentation)
 Mounting local file systems:.
 vboxguest0 port 0xd020-0xd03f mem 0xf0400000-0xf07fffff,0xf0800000-0xf0803fff irq 20 at device 4.0 on pci0
 vboxguest: loaded successfully
 Setting hostname: machine3.example.com.
 Starting Network: lo0 em0.
 lo0: flags=8049&lt;UP,LOOPBACK,RUNNING,MULTICAST&gt; metric 0 mtu 16384
         options=3&lt;RXCSUM,TXCSUM&gt;
         inet6 ::1 prefixlen 128
         inet6 fe80::1%lo0 prefixlen 64 scopeid 0x3
         inet 127.0.0.1 netmask 0xff000000
         nd6 options=21&lt;PERFORMNUD,AUTO_LINKLOCAL&gt;
 em0: flags=8843&lt;UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST&gt; metric 0 mtu 1500
         options=9b&lt;RXCSUM,TXCSUM,VLAN_MTU,VLAN_HWTAGGING,VLAN_HWCSUM&gt;
         ether 08:00:27:9f:e0:92
         nd6 options=29&lt;PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL&gt;
         media: Ethernet autoselect (1000baseT &lt;full-duplex&gt;)
         status: active
 Starting devd.
 Starting Network: usbus0.
 DHCPREQUEST on em0 to 255.255.255.255 port 67
 DHCPACK from 10.0.2.2
 bound to 192.168.1.142 -- renewal in 43200 seconds.
 add net ::ffff:0.0.0.0: gateway ::1
 add net ::0.0.0.0: gateway ::1
 add net fe80::: gateway ::1
 add net ff02::: gateway ::1
 ELF ldconfig path: /lib /usr/lib /usr/lib/compat /usr/local/lib
 32-bit compatibility ldconfig path: /usr/lib32
 Creating and/or trimming log files.
 Starting syslogd.
 No core dumps found.
 Clearing /tmp (X related).
 Updating motd:.
 Configuring syscons: blanktime.
 Generating public/private rsa1 key pair.
 Your identification has been saved in /etc/ssh/ssh_host_key.
 Your public key has been saved in /etc/ssh/ssh_host_key.pub.
 The key fingerprint is:
 10:a0:f5:af:93:ae:a3:1a:b2:bb:3c:35:d9:5a:b3:f3 root@machine3.example.com
 The key's randomart image is:
 +--[RSA1 1024]----+
 |    o..          |
 |   o . .         |
 |  .   o          |
 |       o         |
 |    o   S        |
 |   + + o         |
 |o . + *          |
 |o+ ..+ .         |
 |==o..o+E         |
 +-----------------+
 Generating public/private dsa key pair.
 Your identification has been saved in /etc/ssh/ssh_host_dsa_key.
 Your public key has been saved in /etc/ssh/ssh_host_dsa_key.pub.
 The key fingerprint is:
 7e:1c:ce:dc:8a:3a:18:13:5b:34:b5:cf:d9:d1:47:b2 root@machine3.example.com
 The key's randomart image is:
 +--[ DSA 1024]----+
 |       ..     . .|
 |      o  .   . + |
 |     . ..   . E .|
 |    . .  o o . . |
 |     +  S = .    |
 |    +  . = o     |
 |     +  . * .    |
 |    . .  o .     |
 |      .o. .      |
 +-----------------+
 Starting sshd.
 Starting cron.
 Starting background file system checks in 60 seconds.
 
 Thu Oct  6 19:15:31 MDT 2011
 
 FreeBSD/amd64 (machine3.example.com) (ttyv0)
 
 login:</screen>
 
 	<para>在较慢的机器上， 生成 RSA 和 DSA 密钥可能需要一些时间。
 	  这种情况只会在开启了 <application>sshd</application>
 	  的新系统首次启动时发生， 之后的启动速度不受影响。</para>
 
 	<para>&os; 默认情况下并不会安装图形环境，
 	  但提供了多种不同的选择。 请参阅 <xref linkend="x11"/>
 	  了解详情。</para>
       </sect3>
     </sect2>
 
     <sect2 xml:id="bsdinstall-shutdown">
       <title>关闭 &os;</title>
 
       <para>正常关闭 &os; 有助于保护数据及系统硬件不受损坏。
 	不要直接关闭电源。 如果用户是 <systemitem class="groupname">wheel</systemitem>
 	组的成员， 首先在命令行中输入 <command>su</command>
 	后键入 <systemitem class="username">root</systemitem> 密码成为超级用户。
 	此外， 也可作为 <systemitem class="username">root</systemitem> 登录， 然后使用命令
 	<command>shutdown -p now</command>。
 	这样系统将安全地自行关闭。</para>
 
       <para>虽然也可以使用组合键
 	<keycombo action="simul">
 	  <keycap>Ctrl</keycap>
 	  <keycap>Alt</keycap>
 	  <keycap>Del</keycap>
 	</keycombo>
 	重启系统， 但正常情况下并不推荐这样做。</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="bsdinstall-install-trouble">
     <title>故障排除</title>
 
     <indexterm>
       <primary>installation</primary>
       <secondary>troubleshooting</secondary>
     </indexterm>
     <para>下面将介绍如何排除基本的安装故障，
       例如用户经常报告的问题。</para>
 
     <sect2>
       <title>遇到错误时该如何处理</title>
 
       <para>由于 PC 架构的各种限制， 硬件检测不可能 100% 地可靠探测，
 	然而， 当此类现象发生时， 您有可能可以通过一些操作来自行解决它们。</para>
 
       <para>首先应该根据所安装的 &os; 版本核对 <link xlink:href="http://www.FreeBSD.org/releases/index.html">硬件兼容说明</link>
 	文档， 以确保其支持您的硬件。</para>
 
       <para>如果使用被支持的硬件时仍遇到了死机或其他问题， 请联编一个
 	<link linkend="kernelconfig">自定义内核</link>，
 	这样即可为那些 <filename>GENERIC</filename> 内核中不存在的设备提供支持。
 	引导盘上的内核假定绝大多数硬件的 IRQ、 IO 地址和 DMA 通道均为出厂设置，
 	如果您的硬件被重新配置过， 就很可能需要修改内核配置文件并重新编译内核，
 	以支持 &os; 侦测这些硬件。</para>
 
       <para>还可能出现一种情况，
 	检测某个不存在的设备会导致稍后对其他存在的设备检测失败。
 	在这种情况下， 应该禁止检测引起冲突的设备所对应的驱动程序。</para>
 
       <note>
 	<para>有些安装问题可以通过更新硬件固件来避免或改善， 尤其是主板。
 	  主板固件通常被称作 <acronym>BIOS</acronym>，
 	  大多数主板和计算机制造商都拥有提供升级和相关信息的网站。</para>
 
 	<para>制造商通常建议， 除非有类似关键更新这种必要的原因，
 	  否则应避免升级主板 <acronym>BIOS</acronym>。 升级过程一旦出现错误，
 	  <acronym>BIOS</acronym>信息将遭到破坏， 从而导致计算机无法工作。</para>
       </note>
     </sect2>
 
     <sect2>
       <title>故障排除问答</title>
 
       <qandaset>
 	<qandaentry>
 	  <question>
 	    <para>在启动时， 我的系统在检测硬件时挂起，
 	      或在安装过程中行为异常。</para>
 	  </question>
 
 	  <answer>
 	    <para>在 i386、 amd64 和 ia64 平台的启动过程中， &os; 广泛使用了
 	      ACPI 服务来检测系统配置， 不幸的是 ACPI 驱动和主板
 	      <acronym>BIOS</acronym> 中仍存在一些 bug。 在第三阶段引导加载器中，
 	      可以通过设置 <literal>hint.acpi.0.disabled</literal>
 	      来禁用 ACPI：</para>
 
 	    <screen><userinput>set hint.acpi.0.disabled="1"</userinput></screen>
 
 	    <para>这一设置会在系统重启后失效， 因此必须将
 	      <literal>hint.acpi.0.disabled="1"</literal> 添加至文件
 	      <filename>/boot/loader.conf</filename> 中。
 	      关于引导加载器的更多信息， 请参见
 	      <xref linkend="boot-synopsis"/>。</para>
 	  </answer>
 	</qandaentry>
       </qandaset>
     </sect2>
   </sect1>
 </chapter>
diff --git a/zh_CN.UTF-8/books/handbook/chapters.ent b/zh_CN.UTF-8/books/handbook/chapters.ent
index 38697a125b..c2eae7ac13 100644
--- a/zh_CN.UTF-8/books/handbook/chapters.ent
+++ b/zh_CN.UTF-8/books/handbook/chapters.ent
@@ -1,72 +1,72 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      Creates entities for each chapter in the FreeBSD Handbook. Each entity
      is named chap.foo, where foo is the value of the id attribute on that
      chapter, and corresponds to the name of the directory in which that
      chapter's .xml file is stored.
 
      Chapters should be listed in the order in which they are referenced.
 
-     Original revision: r37791
+     Original Revision: 5dde067e5b (r37791)
      $FreeBSD$
 -->
 
 <!ENTITY chap.preface			SYSTEM "preface/preface.xml">
 <!ENTITY % pgpkeys SYSTEM "../../../share/pgpkeys/pgpkeys.ent"> %pgpkeys;
 
 <!-- Part One -->
   <!ENTITY chap.introduction	SYSTEM "introduction/chapter.xml">
   <!ENTITY chap.install		SYSTEM "install/chapter.xml">
   <!ENTITY chap.bsdinstall	SYSTEM "bsdinstall/chapter.xml">
   <!ENTITY chap.basics		SYSTEM "basics/chapter.xml">
   <!ENTITY chap.ports		SYSTEM "ports/chapter.xml">
   <!ENTITY chap.x11		SYSTEM "x11/chapter.xml">
 
 <!-- Part Two -->
   <!ENTITY chap.desktop		SYSTEM "desktop/chapter.xml">
   <!ENTITY chap.multimedia	SYSTEM "multimedia/chapter.xml">
   <!ENTITY chap.kernelconfig	SYSTEM "kernelconfig/chapter.xml">
   <!ENTITY chap.printing	SYSTEM "printing/chapter.xml">
   <!ENTITY chap.linuxemu	SYSTEM "linuxemu/chapter.xml">
 
 <!-- Part Three -->
   <!ENTITY chap.config		SYSTEM "config/chapter.xml">
   <!ENTITY chap.boot		SYSTEM "boot/chapter.xml">
   <!ENTITY chap.users		SYSTEM "users/chapter.xml">
   <!ENTITY chap.security	SYSTEM "security/chapter.xml">
   <!ENTITY chap.jails		SYSTEM "jails/chapter.xml">
   <!ENTITY chap.mac		SYSTEM "mac/chapter.xml">
   <!ENTITY chap.audit		SYSTEM "audit/chapter.xml">
   <!ENTITY chap.disks		SYSTEM "disks/chapter.xml">
   <!ENTITY chap.geom		SYSTEM "geom/chapter.xml">
   <!ENTITY chap.filesystems	SYSTEM "filesystems/chapter.xml">
   <!ENTITY chap.vinum		SYSTEM "vinum/chapter.xml">
   <!ENTITY chap.virtualization	SYSTEM "virtualization/chapter.xml">
   <!ENTITY chap.l10n		SYSTEM "l10n/chapter.xml">
   <!ENTITY chap.cutting-edge	SYSTEM "cutting-edge/chapter.xml">
   <!ENTITY chap.dtrace		SYSTEM "dtrace/chapter.xml">
 
 <!-- Part Four -->
   <!ENTITY chap.serialcomms	SYSTEM "serialcomms/chapter.xml">
   <!ENTITY chap.ppp-and-slip	SYSTEM "ppp-and-slip/chapter.xml">
   <!ENTITY chap.mail		SYSTEM "mail/chapter.xml">
   <!ENTITY chap.network-servers	SYSTEM "network-servers/chapter.xml">
   <!ENTITY chap.firewalls	SYSTEM "firewalls/chapter.xml">
   <!ENTITY chap.advanced-networking	SYSTEM "advanced-networking/chapter.xml">
 
 <!-- Part Five (appendices) -->
   <!ENTITY chap.mirrors		SYSTEM "mirrors/chapter.xml">
   <!ENTITY chap.mirrors.lastmod.inc	SYSTEM "mirrors.lastmod.inc">
   <!ENTITY chap.mirrors.ftp.index.inc	SYSTEM "mirrors.xml.ftp.index.inc">
   <!ENTITY chap.mirrors.ftp.inc	SYSTEM "mirrors.xml.ftp.inc">
   <!ENTITY chap.mirrors.cvsup.index.inc	SYSTEM "mirrors.xml.cvsup.index.inc">
   <!ENTITY chap.mirrors.cvsup.inc	SYSTEM "mirrors.xml.cvsup.inc">
   <!ENTITY chap.bibliography	SYSTEM "bibliography/chapter.xml">
   <!ENTITY chap.eresources	SYSTEM "eresources/chapter.xml">
   <!ENTITY chap.eresources.www.index.inc	SYSTEM "eresources.xml.www.index.inc">
   <!ENTITY chap.eresources.www.inc	SYSTEM "eresources.xml.www.inc">
   <!ENTITY chap.pgpkeys		SYSTEM "pgpkeys/chapter.xml">
   <!ENTITY chap.freebsd-glossary	SYSTEM "../../share/xml/glossary.ent">
   <!ENTITY chap.index		"<index xmlns='http://docbook.org/ns/docbook'/>">
 
 <!ENTITY chap.colophon	SYSTEM "colophon.xml">
diff --git a/zh_CN.UTF-8/books/handbook/filesystems/chapter.xml b/zh_CN.UTF-8/books/handbook/filesystems/chapter.xml
index 081aac0158..689ce4ad7c 100644
--- a/zh_CN.UTF-8/books/handbook/filesystems/chapter.xml
+++ b/zh_CN.UTF-8/books/handbook/filesystems/chapter.xml
@@ -1,570 +1,570 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      The FreeBSD Documentation Project
-     Original Revision: r37255
+     Original Revision: c7e307c1fb (r37255)
      $FreeBSD$
 -->
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="filesystems">
   <info><title>文件系统 Support</title>
     <authorgroup>
       <author><personname><firstname>Tom</firstname><surname>Rhodes</surname></personname><contrib>Written by </contrib></author>
     </authorgroup>
   </info>
 
   
 
   <sect1 xml:id="filesystems-synopsis">
     <title>概述</title>
 
     <indexterm><primary>File Systems</primary></indexterm>
     <indexterm>
       <primary>File Systems Support</primary>
       <see>File Systems</see>
     </indexterm>
 
     <para>文件系统对于任何操作系统来说都是一个不可缺的部分。
       它们允许用户上载和存储文件，提供对数据的访问，当然，
       是使硬盘能具有实际的用途。不同的操作系统通常都有一个共同的主要方面，
       那就是它们原生的文件系统。在 &os;
       上这个文件系统通常被称为快速文件系统或者 <acronym>FFS</acronym>，
       这是基于原来的 Unix&trade; 文件系统，通常也被称为
       <acronym>UFS</acronym>。 这是 &os;
       用于在磁盘上访问数据的原生的文件系统。</para>
 
     <para>&os; 也支持数量繁多的不同的文件系统，
       用于提供本地从其他操作系统上访问数据的支持，
       那些就是指存放在本地挂载的 <acronym>USB</acronym>
       存储设备，闪存设备和硬盘上的数据。还支持一些非原生的文件系统。
       这些文件系统是在其他的操作系统上开发的，像 &linux;
       的扩展文件系统 （<acronym>EXT</acronym>），和 &sun;
       的 Z 文件系统 （<acronym>ZFS</acronym>）。</para>
 
     <para>&os; 上对于各种文件系统的支持分成不同的层次。
       一些要求加载内核模块，另外的可能要求安装一系列的工具。
       这一章节旨在帮助 &os; 用户在他们的系统上访问其他的文件系统，
       由 &sun; 的 Z 文件系统开始。</para>
 
     <para>在阅读了这一章节之后，你将了解：</para>
 
     <itemizedlist>
       <listitem>
         <para>原生与被支持的文件系统之间的区别。</para>
       </listitem>
 
       <listitem>
         <para>&os; 支持哪些文件系统。</para>
       </listitem>
 
       <listitem>
         <para>如何起用，配置，访问和使用非原生的文件系统。</para>
       </listitem>
     </itemizedlist>
 
     <para>在阅读这章以前，你应该：</para>
 
     <itemizedlist>
       <listitem>
         <para>了解 &unix; 和 &os; 基本知识
 	  (<xref linkend="basics"/>)。</para>
       </listitem>
 
       <listitem>
         <para>熟悉基本的内核配置/编译方法
 	  (<xref linkend="kernelconfig"/>)。</para>
       </listitem>
 
       <listitem>
         <para>熟悉在 &os; 上安装第三方软件
           (<xref linkend="ports"/>)。</para>
       </listitem>
 
       <listitem>
         <para>熟悉 &os; 上的磁盘，存储和设备名
           (<xref linkend="disks"/>)。</para>
       </listitem>
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="filesystems-zfs">
     <title>Z 文件系统 (ZFS)</title>
 
     <para>Z 文件系统是由 &sun; 开发使用存储池方法的新技术。
       这就是说只有在需要存储数据的时候空间才会被使用。
       它也为保护数据最大完整性而设计的，支持数据快照，
       多份拷贝和数据校验。增加了被称为 <acronym>RAID</acronym>-Z
       的新的数据复制类型。<acronym>RAID</acronym>-Z 是种类似于
       <acronym>RAID</acronym>5类型, 但被设计成防止写入漏洞。</para>
 
     <sect2>
       <title>调整 ZFS</title>
 
       <para><acronym>ZFS</acronym> 子系统需利用到大量的系统资源，
         所以可能需要一些调校来为日常应用提供最大化的效能。
         作为 &os; 的一项试验性的特性，这可能在不久的将来有所变化；
         无论如何，下面的这些步骤是我们推荐的：</para>
 
       <sect3>
         <title>内存</title>
 
         <para>总共的系统内存至少应有 1GB，推荐 2GB 或者更多。
           在此处所有的例子中，我们使用了 1GB
           内存的系统并配合了一些恰当的调校。</para>
 
         <para>有些人在少于 1GB 内存的环境有幸正常使用，
           但是在这样有限的物理内存的条件下，当系统的负载很高时，
           &os; 极有可能因于内存耗尽而崩溃。</para>
       </sect3>
 
       <sect3>
         <title>内核配置</title>
 
         <para>我们建议把未使用的驱动和选项从内核配置文件中去除。
           既然大部份的驱动都有以模块的形式存在，它们就可以很容易的通过
           <filename>/boot/loader.conf</filename> 加载。</para>
 
         <para>&i386; 构架的用户应在内核配置文件中加入以下的选项，
           重新编译内核并重启机器：</para>
 
 	<programlisting>options 	KVA_PAGES=512</programlisting>
 
         <para>这个选项将扩展内核的地址空间， 因而允许
           <varname>vm.kvm_size</varname> 能够超越 1&nbsp;GB
           的限制(<acronym>PAE</acronym>为 2&nbsp;GB)。
           为了找出这个选项最合适的值，
           把以兆(MB)为单位所需的地址空间除以 4 得到。
           在这个例子中，<literal>512</literal> 则为 2&nbsp;GB。</para>
       </sect3>
 
       <sect3>
         <title>Loader 可调参数</title>
 
         <para>所有构架上 &os; 都应该加大 <filename>kmem</filename>
           地址空间。在有 1GB 物理内存的测试系统上，在
           <filename>/boot/loader.conf</filename>
           中加入如下的参数并且重启后通过了测试。</para>
 
 	<programlisting>vm.kmem_size="330M"
 vm.kmem_size_max="330M"
 vfs.zfs.arc_max="40M"
 vfs.zfs.vdev.cache.size="5M"</programlisting>
 
 	<para>更多 ZFS 相关推荐调校的细节请参阅
 	  <uri xlink:href="http://wiki.freebsd.org/ZFSTuningGuide">http://wiki.freebsd.org/ZFSTuningGuide</uri>.</para>
       </sect3>
     </sect2>
 
     <sect2>
       <title>使用 <acronym>ZFS</acronym></title>
 
       <para>&os; 有一种启动机制能在系统初始化时挂载
         <acronym>ZFS</acronym> 存储池。
         可以通过以下的命令设置：</para>
 
 	<screen>&prompt.root; <userinput>echo 'zfs_enable="YES"' &gt;&gt; /etc/rc.conf</userinput>
 &prompt.root; <userinput>/etc/rc.d/zfs start</userinput></screen>
 
         <para>这份文档剩余的部分假定系统中有 3 块
           <acronym>SCSI</acronym> 磁盘可用，
           它们的设备名分别为
 	  <filename>da0</filename>，
           <filename>da1</filename>
 	  和 <filename>da2</filename>。
           <acronym>IDE</acronym> 硬件的用户可以使用
           <filename>ad</filename>
           代替 <acronym>SCSI</acronym>。</para>
       <sect3>
         <title>单个磁盘存储池</title>
 
         <para>在单个磁盘上创建一个简单， 非冗余的 <acronym>ZFS</acronym>，
           使用 <command>zpool</command> 命令：</para>
 
 	<screen>&prompt.root; <userinput>zpool create example /dev/da0</userinput></screen>
 
         <para>可以通过 <command>df</command>
           的输出查看新的存储池：</para>
 
 	<screen>&prompt.root; <userinput>df</userinput>
 Filesystem  1K-blocks    Used    Avail Capacity  Mounted on
 /dev/ad0s1a   2026030  235230  1628718    13%    /
 devfs               1       1        0   100%    /dev
 /dev/ad0s1d  54098308 1032846 48737598     2%    /usr
 example      17547136       0 17547136     0%    /example</screen>
 
         <para>这份输出清楚的表明了 <literal>example</literal>
           存储池不仅创建成功而且被 <emphasis>挂载</emphasis> 了。
           我们能像访问普通的文件系统那样访问它，
           就像以下例子中演示的那样，用户能够在上面创建文件并浏览：</para>
 
 	<screen>&prompt.root; <userinput>cd /example</userinput>
 &prompt.root; <userinput>ls</userinput>
 &prompt.root; <userinput>touch testfile</userinput>
 &prompt.root; <userinput>ls -al</userinput>
 total 4
 drwxr-xr-x   2 root  wheel    3 Aug 29 23:15 .
 drwxr-xr-x  21 root  wheel  512 Aug 29 23:12 ..
 -rw-r--r--   1 root  wheel    0 Aug 29 23:15 testfile</screen>
 
         <para>遗憾的是这个存储池并没有利用到
           <acronym>ZFS</acronym> 的任何特性。
           在这个存储池上创建一个文件系统，并启用压缩：</para>
 
 	<screen>&prompt.root; <userinput>zfs create example/compressed</userinput>
 &prompt.root; <userinput>zfs set compression=gzip example/compressed</userinput></screen>
 
         <para>现在 <literal>example/compressed</literal>
           是一个启用了压缩的 <acronym>ZFS</acronym> 文件系统了。
           可以尝试复制一些大的文件到
           <filename>/example/compressed</filename>。</para>
 
         <para>使用这个命令可以禁用压缩：</para>
 
 	<screen>&prompt.root; <userinput>zfs set compression=off example/compressed</userinput></screen>
 
         <para>使用如下的命令卸载这个文件系统，并用
           <command>df</command> 工具确认：</para>
 
 	<screen>&prompt.root; <userinput>zfs umount example/compressed</userinput>
 &prompt.root; <userinput>df</userinput>
 Filesystem  1K-blocks    Used    Avail Capacity  Mounted on
 /dev/ad0s1a   2026030  235232  1628716    13%    /
 devfs               1       1        0   100%    /dev
 /dev/ad0s1d  54098308 1032864 48737580     2%    /usr
 example      17547008       0 17547008     0%    /example</screen>
 
         <para>重新挂在这个文件系统使之能被访问，
           并用 <command>df</command> 确认：</para>
 
 	<screen>&prompt.root; <userinput>zfs mount example/compressed</userinput>
 &prompt.root; <userinput>df</userinput>
 Filesystem         1K-blocks    Used    Avail Capacity  Mounted on
 /dev/ad0s1a          2026030  235234  1628714    13%    /
 devfs                      1       1        0   100%    /dev
 /dev/ad0s1d         54098308 1032864 48737580     2%    /usr
 example             17547008       0 17547008     0%    /example
 example/compressed  17547008       0 17547008     0%    /example/compressed</screen>
 
         <para>存储池与文件系统也可通过 <command>mount</command>
           的输出查看：</para>
 
 	<screen>&prompt.root; <userinput>mount</userinput>
 /dev/ad0s1a on / (ufs, local)
 devfs on /dev (devfs, local)
 /dev/ad0s1d on /usr (ufs, local, soft-updates)
 example on /example (zfs, local)
 example/data on /example/data (zfs, local)
 example/compressed on /example/compressed (zfs, local)</screen>
 
         <para>正如前面所提到的，<acronym>ZFS</acronym> 文件系统，
           在创建之后就能像普通的文件系统那样使用。然而，
           还有很多其他的特性是可用的。在下面的例子中，
           我们将创建一个新的文件系统，<literal>data</literal>。
           并要在上面存储些重要的文件，
           所以文件系统需要被设置成把每一个数据块都保存两份拷贝：</para>
 
 	<screen>&prompt.root; <userinput>zfs create example/data</userinput>
 &prompt.root; <userinput>zfs set copies=2 example/data</userinput></screen>
 
         <para>现在可以再次使用 <command>df</command>
           查看数据和空间的使用状况：</para>
 
 	<screen>&prompt.root; <userinput>df</userinput>
 Filesystem         1K-blocks    Used    Avail Capacity  Mounted on
 /dev/ad0s1a          2026030  235234  1628714    13%    /
 devfs                      1       1        0   100%    /dev
 /dev/ad0s1d         54098308 1032864 48737580     2%    /usr
 example             17547008       0 17547008     0%    /example
 example/compressed  17547008       0 17547008     0%    /example/compressed
 example/data        17547008       0 17547008     0%    /example/data</screen>
 
         <para>请注意存储池上的每一个文件系统都有着相同数量的可用空间。
           这就是我们在这些例子中使用 <command>df</command> 的原因，
           是为了文件系统都是从相同的存储池取得它们所需的空间。
           <acronym>ZFS</acronym> 去掉了诸如卷和分区此类的概念，
           并允许多个文件系统占用同一个存储池。
           不再需要文件系统与存储池的时候能像这样销毁它们：</para>
 
 	<screen>&prompt.root; <userinput>zfs destroy example/compressed</userinput>
 &prompt.root; <userinput>zfs destroy example/data</userinput>
 &prompt.root; <userinput>zpool destroy example</userinput></screen>
 
         <para>磁盘无法避免的会坏掉和停止运转。
           当这块磁盘坏掉的时候，上面的数据都将丢失。
           一个避免因磁盘损坏而丢失数据的方法是使用
           <acronym>RAID</acronym>。<acronym>ZFS</acronym>
           在它的存储池设计中支持这样的特性，
           这便是下一节将探讨的。</para>
 
       </sect3>
 
       <sect3>
 	<title><acronym>ZFS</acronym> RAID-Z</title>
 
         <para>正如前文中所提到的，这一章节将假设存在 3 个
           <acronym>SCSI</acronym> 设备，
           <filename>da0</filename>， <filename>da1</filename>
           和 <filename>da2</filename> (或者 <filename>ad0</filename>
           和超出此例使用了 IDE 磁盘)。 使用如下的命令创建一个
           <acronym>RAID</acronym>-Z 存储池:</para>
 
 	<screen>&prompt.root; <userinput>zpool create storage raidz da0 da1 da2</userinput></screen>
 
         <note><para>&sun; 推荐在一个 <acronym>RAID</acronym>-Z
             配置中使用的磁盘数量为 3 至 9 块。
             如果你要求在单独的一个存储池中使用 10 块或更多的磁盘，
             请考虑分拆成更小 <acronym>RAID</acronym>-z 组。
             如果你只有 2 块磁盘， 并仍然需要冗余，
             请考虑使用 <acronym>ZFS</acronym> 的 mirror 特性。
             更多细节请参考 &man.zpool.8; 手册页。</para></note>
 
         <para>zpool <literal>storage</literal> 至此就创建好了。
           可以如前文提到的那样使用 &man.mount.8; 和 &man.df.1; 确认。
           如需配给更多的磁盘设备则把它们加这个列表的后面。
           在存储池上创建一个叫 <literal>home</literal> 的文件系统，
           用户的文件最终都将被保存在上面：</para>
 
 	<screen>&prompt.root; <userinput>zfs create storage/home</userinput></screen>
 
         <para>像前文中提到的那样，用户的目录与文件也可启用压缩并保存多份拷贝，
           可通过如下的命令完成：</para>
 
 	<screen>&prompt.root; <userinput>zfs set copies=2 storage/home</userinput>
 &prompt.root; <userinput>zfs set compression=gzip storage/home</userinput></screen>
 
         <para>把用户的数据都拷贝过来并创建一个符号链接，
           让他们开始使用这个新的目录：</para>
 
 	<screen>&prompt.root; <userinput>cp -rp /home/* /storage/home</userinput>
 &prompt.root; <userinput>rm -rf /home /usr/home</userinput>
 &prompt.root; <userinput>ln -s /storage/home /home</userinput>
 &prompt.root; <userinput>ln -s /storage/home /usr/home</userinput></screen>
 
         <para>现在用户的数据应该都保存在新创建的
           <filename>/storage/home</filename>
           上了。 测试添加一个新用户并以这个身份登录。</para>
 
         <para>尝试创建一个可日后用来回退的快照：</para>
 
 	<screen>&prompt.root; <userinput>zfs snapshot storage/home@08-30-08</userinput></screen>
 
         <para>请注意快照选项将只会抓取一个真实的文件系统，
           而不是某个用户目录或文件。<literal>@</literal>
           字符为文件系统名或卷名的分隔符。
           当用户目录被损坏时，可用如下命令恢复：</para>
 
 	<screen>&prompt.root; <userinput>zfs rollback storage/home@08-30-08</userinput></screen>
 
         <para>获得所有可用快照的列表，可使用
           <command>ls</command> 命令查看文件系统的
           <filename>.zfs/snapshot</filename>
           目录。例如，执行如下命令来查看之前抓取的快照：</para>
 
 	<screen>&prompt.root; <userinput>ls /storage/home/.zfs/snapshot</userinput></screen>
 
         <para>可以编写一个脚本来每月定期抓取用户数据的快照，久而久之，
           快照可能消耗掉大量的磁盘空间。
           之前创建的快照可用以下命令删除：</para>
 
 	<screen>&prompt.root; <userinput>zfs destroy storage/home@08-30-08</userinput></screen>
 
         <para>在所有这些测试之后，我们没有理由再把
           <filename>/store/home</filename>
           这样放置了。让它称为真正的
           <filename>/home</filename>
           文件系统：</para>
 
 	<screen>&prompt.root; <userinput>zfs set mountpoint=/home storage/home</userinput></screen>
 
         <para>使用 <command>df</command> 和
           <command>mount</command>
           命令将显示现在系统把我们的文件系统真正当作了
 	  <filename>/home</filename>：</para>
 
 	<screen>&prompt.root; <userinput>mount</userinput>
 /dev/ad0s1a on / (ufs, local)
 devfs on /dev (devfs, local)
 /dev/ad0s1d on /usr (ufs, local, soft-updates)
 storage on /storage (zfs, local)
 storage/home on /home (zfs, local)
 &prompt.root; <userinput>df</userinput>
 Filesystem   1K-blocks    Used    Avail Capacity  Mounted on
 /dev/ad0s1a    2026030  235240  1628708    13%    /
 devfs                1       1        0   100%    /dev
 /dev/ad0s1d   54098308 1032826 48737618     2%    /usr
 storage       26320512       0 26320512     0%    /storage
 storage/home  26320512       0 26320512     0%    /home</screen>
 
         <para>这样就基本完成了 <acronym>RAID</acronym>-Z
           的配置了。使用夜间 &man.periodic.8;
           获取有关文件系统创建之类的状态更新，
           执行如下的命令：</para>
 
 	<screen>&prompt.root; <userinput>echo 'daily_status_zfs_enable="YES"' &gt;&gt; /etc/periodic.conf</userinput></screen>
       </sect3>
 
       <sect3>
         <title>修复 <acronym>RAID</acronym>-Z</title>
 
         <para>每一种软 <acronym>RAID</acronym>
           都有监测它们 <literal>状态</literal> 的方法。
           <acronym>ZFS</acronym> 也不例外。
           可以使用如下的命令查看 <acronym>RAID</acronym>-Z
           设备：</para>
 
 	<screen>&prompt.root; <userinput>zpool status -x</userinput></screen>
 
         <para>如果所有的存储池处于健康状态并且一切正常的话，
           将返回如下信息：</para>
 
 	<screen>all pools are healthy</screen>
 
         <para>如果存在问题，可能是一个磁盘设备下线了，
           那么返回的存储池的状态将看上去是类似这个样子的：</para>
 
 	<screen>  pool: storage
  state: DEGRADED
 status: One or more devices has been taken offline by the administrator.
 	Sufficient replicas exist for the pool to continue functioning in a
 	degraded state.
 action: Online the device using 'zpool online' or replace the device with
 	'zpool replace'.
  scrub: none requested
 config:
 
 	NAME        STATE     READ WRITE CKSUM
 	storage     DEGRADED     0     0     0
 	  raidz1    DEGRADED     0     0     0
 	    da0     ONLINE       0     0     0
 	    da1     OFFLINE      0     0     0
 	    da2     ONLINE       0     0     0
 
 errors: No known data errors</screen>
 
         <para>在这个例子中，这是由管理员把此设备下线后的状态。
           可以使用如下的命令将磁盘下线：</para>
 
 	<screen>&prompt.root; <userinput>zpool offline storage da1</userinput></screen>
 
         <para>现在切断系统电源之后就可以替换下
           <filename>da1</filename> 了。
           当系统再次上线时，使用如下的命令替换磁盘：</para>
 
 	<screen>&prompt.root; <userinput>zpool replace storage da1</userinput></screen>
 
         <para>至此可用不带 <option>-x</option>
           标志的命令再次检查状态：</para>
 
 	<screen>&prompt.root; <userinput>zpool status storage</userinput>
  pool: storage
  state: ONLINE
  scrub: resilver completed with 0 errors on Sat Aug 30 19:44:11 2008
 config:
 
 	NAME        STATE     READ WRITE CKSUM
 	storage     ONLINE       0     0     0
 	  raidz1    ONLINE       0     0     0
 	    da0     ONLINE       0     0     0
 	    da1     ONLINE       0     0     0
 	    da2     ONLINE       0     0     0
 
 errors: No known data errors</screen>
 
         <para>在这个例子中，一切都显示正常。</para>
       </sect3>
 
       <sect3>
         <title>数据校验</title>
 
         <para>正如前面所提到的，<acronym>ZFS</acronym>
           使用 <literal>校验和</literal>(checksum) 来检查存储数据的完整性。
           这时在文件系统创建时自动启用的，可使用以下的命令禁用：</para>
 
 	<screen>&prompt.root; <userinput>zfs set checksum=off storage/home</userinput></screen>
 
         <para>这不是个明智的选择，因为校验和
           不仅非常有用而且只需占用少量的存储空间。
           并且启用它们也不会明显的消耗过多资源。
           启用后就可以让 <acronym>ZFS</acronym>
           使用校验和校验来检查数据的完整。
           这个过程通常称为 <quote>scrubbing</quote>。
           可以使用以下的命令检查 <literal>storage</literal>
           存储池里数据的完整性：</para>
 
 	<screen>&prompt.root; <userinput>zpool scrub storage</userinput></screen>
 
         <para>这个过程需花费相当长的时间，取决于存储的数据量。
           而且 <acronym>I/O</acronym> 非常密集，
           所以在任何时间只能执行一个这样的操作。
           在 scrub 完成之后，状态就会被更新，
           可使用如下的命令查看：</para>
 
 	<screen>&prompt.root; <userinput>zpool status storage</userinput>
  pool: storage
  state: ONLINE
  scrub: scrub completed with 0 errors on Sat Aug 30 19:57:37 2008
 config:
 
 	NAME        STATE     READ WRITE CKSUM
 	storage     ONLINE       0     0     0
 	  raidz1    ONLINE       0     0     0
 	    da0     ONLINE       0     0     0
 	    da1     ONLINE       0     0     0
 	    da2     ONLINE       0     0     0
 
 errors: No known data errors</screen>
 
         <para>这个例子中完成时间非常的清楚。
           这个特性可以帮助你在很长的一段时间内确保数据的完整。</para>
 
         <para>Z 文件系统有更多的选项，请参阅
           &man.zfs.8; 和 &man.zpool.8; 手册页。</para>
       </sect3>
     </sect2>
   </sect1>
 
 
   <!--
       XXXTR: stub sections (added later, as needed, as desire,
       after I get opinions from -doc people):
 
       Still need to discuss native and foreign file systems.
 
   <sect1>
     <title>Device File System</title>
   </sect1>
 
   <sect1>
     <title>DOS and NTFS File Systems</title>
     <para>This is a good section for those who transfer files, using
       USB devices, from Windows to FreeBSD and vice-versa.  My camera,
       and many other cameras I have seen default to using FAT16.  There
       is (was?) a kde utility, I think called kamera, that could be used
       to access camera devices.  A section on this would be useful.</para>
 
     <para>XXXTR: Though!  The disks chapter, covers a bit of this and
       devfs under it's USB devices.  It leaves a lot to be desired though,
       see:
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/usb-disks.html
       It may be better to flesh out that section a bit more.  Add the
       word "camera" to it so that others can easily notice.</para>
   </sect1>
 
   <sect1>
     <title>Linux EXT 文件系统</title>
 
     <para>Probably NOT as useful as the other two, but it requires
       knowledge of the existence of the tools.  Which are hidden in
       the ports collection.  Most Linux guys would probably only use
       Linux, BSD guys would be smarter and use NFS.</para>
   </sect1>
 
   <sect1>
     <title>HFS</title>
 
     <para>I think this is the file system used on Apple OSX.  There are
       tools in the ports collection, and with Apple being a big
       FreeBSD supporter and user of our technologies, surely there
       is enough cross over to cover this?</para>
   </sect1>
   -->
 
 </chapter>
diff --git a/zh_CN.UTF-8/books/handbook/firewalls/chapter.xml b/zh_CN.UTF-8/books/handbook/firewalls/chapter.xml
index b3d01cadf7..6070e21b11 100644
--- a/zh_CN.UTF-8/books/handbook/firewalls/chapter.xml
+++ b/zh_CN.UTF-8/books/handbook/firewalls/chapter.xml
@@ -1,2956 +1,2956 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      The FreeBSD Documentation Project
      The FreeBSD Simplified Chinese Project
 
-     Original Revision: r38826
+     Original Revision: 35babe0ae5 (r38826)
      $FreeBSD$
 -->
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="firewalls">
   <info><title>防火墙</title>
     <authorgroup>
       <author><personname><firstname>Joseph J.</firstname><surname>Barbish</surname></personname><contrib>Contributed by </contrib></author>
     </authorgroup>
     <authorgroup>
       <author><personname><firstname>Brad</firstname><surname>Davis</surname></personname><contrib>Converted to SGML and updated by </contrib></author>
     </authorgroup>
   </info>
 
   
 
   <indexterm><primary>防火墙</primary></indexterm>
 
   <indexterm>
     <primary>安全</primary>
 
     <secondary>防火墙</secondary>
   </indexterm>
 
   <sect1 xml:id="firewalls-intro">
     <title>入门</title>
 
     <para>防火墙的存在， 使得过滤出入系统的数据流成为可能。
       防火墙可以使用一组或多组 <quote>规则 (rules)</quote>，
       来检查出入您的网络连接的数据包， 并决定允许或阻止它们通过。
       这些规则通常可以检查数据包的某个或某些特征，
       这些特征包括， 但不必限于协议类型、 来源或目的主机地址，
       以及来源或目的端口。</para>
 
     <para>防火墙可以大幅度地改善主机或网络的安全。
       它可以用来完成下面的任务：</para>
 
     <itemizedlist>
       <listitem>
 	<para>保护和隔离应用程序、 服务程序， 以及您内部网络上的机器，
 	  不受那些来自公共的 Internet 网络上您所不希望的数据流量的干扰。</para>
       </listitem>
 
       <listitem>
 	<para>限制或禁止从内部网访问公共的 Internet 上的服务。</para>
       </listitem>
 
       <listitem>
 	<para>支持网络地址转换
 	  (<acronym>NAT</acronym>)，
 	  它使得您的内部网络能够使用私有的 <acronym>IP</acronym> 地址，
 	  并分享一条通往公共的 Internet 的连接 (使用一个
 	  <acronym>IP</acronym> 地址， 或者一组公网地址)。</para>
       </listitem>
     </itemizedlist>
 
     <para>读完这章， 您将了解：</para>
 
     <itemizedlist>
       <listitem>
 	<para>如何正确地定义包过滤规则。</para>
       </listitem>
 
       <listitem>
 	<para>&os; 中内建的几种防火墙之间的差异。</para>
       </listitem>
 
       <listitem>
 	<para>如何使用和配置 OpenBSD 的
 	  <application>PF</application> 防火墙。</para>
       </listitem>
 
       <listitem>
 	<para>如何使用和配置
 	  <application>IPFILTER</application>。</para>
       </listitem>
 
       <listitem>
 	<para>如何使用和配置
 	  <application>IPFW</application>。</para>
       </listitem>
     </itemizedlist>
 
     <para>阅读这章之前， 您需要：</para>
 
     <itemizedlist>
       <listitem>
 	<para>理解基本的 &os; 和 Internet 概念。</para>
       </listitem>
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="firewalls-concepts">
     <title>防火墙的概念</title>
 
     <indexterm>
       <primary>防火墙</primary>
 
       <secondary>规则集</secondary>
     </indexterm>
 
     <para>建立防火墙规则集的基本方法有两种：
       <quote>明示允许 (inclusive)</quote>型 或
       <quote>明示禁止 (exclusive)</quote>型。 明示禁止的防火墙规则，
       默认允许所有数据通过防火墙， 而这种规则集中定义的，
       则是不允许通过防火墙的流量， 换言之，
       与这些规则不匹配的数据， 全部是允许通过防火墙的。
       明示允许的防火墙正好相反， 它只允许符合规则集中定义规则的流量通过，
       而其他所有的流量都被阻止。</para>
 
     <para>明示允许型防火墙能够提供对于传出流量更好的控制，
       这使其更适合那些直接对 Internet 公网提供服务的系统的需要。
       它也能够控制来自 Internet 公网到您的私有网络的访问类型。
       所有和规则不匹配的流量都会被阻止并记录在案。
       一般来说明示允许防火墙要比明示禁止防火墙更安全，
       因为它们显著地减少了允许不希望的流量通过可能造成的风险。</para>
 
     <note>
       <para>除非特别说明，
 	这一章的配置和示范的规则集都是创建明示允许防火墙的。</para>
     </note>
 
     <para>使用了 <quote>带状态功能的防火墙 (stateful
 	firewall)</quote>， 可以进一步地收紧安全机制。
       这种防火墙能够记录通过防火墙的连接，
       进而只允许与现有连接匹配的连接， 或创建新的连接。
       带状态功能的防火墙的缺点是， 在很短时间内有大量的连接请求时，
       它们可能会受到拒绝服务 (<acronym>DoS</acronym>) 攻击。
       绝大多数防火墙都提供了同时启用两种防火墙的能力，
       以便为站点提供更好的保护。</para>
   </sect1>
 
   <sect1 xml:id="firewalls-apps">
     <title>防火墙软件包</title>
 
     <para>&os; 的基本系统内建了三种不同的防火墙软件包。
       它们是 <emphasis>IPFILTER</emphasis>
       (也被称作 <acronym>IPF</acronym>)、
       <emphasis>IPFIREWALL</emphasis> (也被称作 <acronym>IPFW</acronym>)，
       以及 <emphasis>OpenBSD 的 PacketFilter</emphasis> (也被称为
       <acronym>PF</acronym>)。 &os; 也提供了两个内建的、
       用于流量整形 (基本上是控制带宽占用) 的软件包：
       &man.altq.4; 和 &man.dummynet.4;。 Dummynet 在过去一直和
       <acronym>IPFW</acronym> 紧密集成， 而
       <acronym>ALTQ</acronym> 则需要配合
       <acronym>PF</acronym> 使用。 IPFILTER
       的流量整形功能可以使用 IPFILTER 的 NAT
       和过滤功能以及 <acronym>IPFW</acronym> 的 &man.dummynet.4; 配合,
       <emphasis>或者</emphasis> 使用 <acronym>PF</acronym> 跟
       <acronym>ALTQ</acronym> 的组合。
       IPFW， 以及 PF 都是用规则来控制是否允许数据包出入您的系统，
       虽然它们采取了不同的实现方法和规则语法。</para>
 
     <para>&os; 包含多个内建的防火墙软件包的原因在于，
       不同的人会有不同的需求和偏好。 任何一个防火墙软件包都很难说是最好的。</para>
 
     <para>作者倾向于使用 IPFILTER， 因为它提供的状态式规则，
       在 <acronym>NAT</acronym> 的环境中要简单许多，
       而且它内建了 ftp 代理， 这简化了使用外部 FTP 服务时所需的配置。</para>
 
     <para>由于所有的防火墙都基于检查所选定的包控制字段来实现功能，
       撰写防火墙规则集时， 就必须了解
       <acronym>TCP/IP</acronym> 是如何工作的，
       以及包的控制字段在正常会话交互中的作用。
       您可以在这个网站找到一份很好的解释文档：
       <uri xlink:href="http://www.ipprimer.com/overview.cfm">http://www.ipprimer.com/overview.cfm</uri>.</para>
   </sect1>
 
   <sect1 xml:id="firewalls-pf">
       <info><title>OpenBSD Packet Filter (PF) 和
       <acronym>ALTQ</acronym></title>
 	<authorgroup>
 	  <author><personname><firstname>John</firstname><surname>Ferrell</surname></personname><contrib>Revised and updated by </contrib></author>
 	</authorgroup>
       </info>
 
     
 
     <indexterm>
       <primary>防火墙</primary>
 
       <secondary>PF</secondary>
     </indexterm>
 
     <para>2003 年 7 月， OpenBSD 的防火墙，
       也就是常说的 <acronym>PF</acronym> 被成功地移植到了 &os; 上，
       并可以通过 &os; Ports Collection 来安装了；
       第一个将 <acronym>PF</acronym> 集成到基本系统中的版本是
       2004 年 11 月发行的 &os;&nbsp;5.3。
       <acronym>PF</acronym> 是一个完整的提供了大量功能的防火墙软件，
       并提供了可选的 <acronym>ALTQ</acronym> (交错队列， Alternate
       Queuing) 功能。 <acronym>ALTQ</acronym> 提供了服务品质
       (<acronym>QoS</acronym>) 带宽整形功能。</para>
 
     <para>OpenBSD 项目非常杰出的维护着一份
       <link xlink:href="http://www.openbsd.org/faq/pf/">PF FAQ</link>。
       就其本身而言，这一节注重于 &os; 的 <acronym>PF</acronym>
       和提供一些关于使用方面的一般常识。更详细的使用信息请参阅
       <link xlink:href="http://www.openbsd.org/faq/pf/">PF FAQ</link>。</para>
 
     <para>更多的详细信息， 可以在 &os; 版本的
       <acronym>PF</acronym> 网站上找到： <uri xlink:href="http://pf4freebsd.love2party.net/">http://pf4freebsd.love2party.net/</uri>。</para>
 
     <sect2>
       <title>使用 PF 可加载的内核模块</title>
 
         <para>要加载 PF 内核模块， 可以在
 	  <filename>/etc/rc.conf</filename> 中加入下面的设置：</para>
 
         <programlisting>pf_enable="YES"</programlisting>
 
         <para>然后使用启动脚本来加载模块：</para>
 
         <screen>&prompt.root; <userinput>/etc/rc.d/pf start</userinput></screen>
 
 	<para>需要说明的是， 如果系统中没有规则集配置文件，
 	  则上述操作不会加载 PF 模块。 配置文件的默认位置是
 	  <filename>/etc/pf.conf</filename>。 如果 PF 规则集在其他位置，
 	  可以用下面的
 	  <filename>/etc/rc.conf</filename> 配置来告诉 PF：</para>
 
         <programlisting>pf_rules="<replaceable>/path/to/pf.conf</replaceable>"</programlisting>
 
       <para><filename>pf.conf</filename> 的例子可以在 <filename>/usr/share/examples/pf/</filename> 找到。</para>
 
       <para><acronym>PF</acronym> 模块也可以手工从命令行加载：</para>
 
       <screen>&prompt.root; <userinput>kldload pf.ko</userinput></screen>
 
       <para>PF 的日志记录功能是由
         <literal>pflog.ko</literal> 提供的， 通过在
 	<filename>/etc/rc.conf</filename> 中加入下面的设置：</para>
 
       <programlisting>pflog_enable="YES"</programlisting>
 
       <para>然后使用启动脚本来加载模块：</para>
 
       <screen>&prompt.root; <userinput>/etc/rc.d/pflog start</userinput></screen>
 
       <para>如果您需要其他 <acronym>PF</acronym> 特性，
 	则需要将 <acronym>PF</acronym> 支持联编进内核。</para>
     </sect2>
 
     <sect2>
       <title>PF 内核选项</title>
 
       <indexterm>
 	<primary>内核选项</primary>
 
 	<secondary>device pf</secondary>
       </indexterm>
 
       <indexterm>
 	<primary>内核选项</primary>
 
 	<secondary>device pflog</secondary>
       </indexterm>
 
       <indexterm>
 	<primary>内核选项</primary>
 
 	<secondary>device pfsync</secondary>
       </indexterm>
 
       <para>虽然你不必亲自把对 <acronym>PF</acronym> 的支持编译进 &os;
         内核，但是有时你仍然需要这么做来使用到 PF
         的某些没有被收录进可加载模块的高级特性，比如 &man.pfsync.4;
         伪设备用来发送某些改变到<acronym>PF</acronym> 状态表。
         它能配合 &man.carp.4; 使用 PF 建立支持故障转移的防火墙。
         更多有关 <acronym>CARP</acronym> 的详细信息可以参阅本手册的
 	<xref linkend="carp"/>。</para>
 
       <para>The <acronym>PF</acronym> kernel options can be found in
 	<filename>/usr/src/sys/conf/NOTES</filename> and are reproduced
 	below:</para>
       <para>有关 <acronym>PF</acronym> 的内核选项可以在
         <filename>/usr/src/sys/conf/NOTES</filename> 中找到，
         以下也略有阐述：</para>
 
       <programlisting>device pf
 device pflog
 device pfsync</programlisting>
 
       <para><literal>device pf</literal> 选项用于启用
 	<quote>Packet Filter</quote> 防火墙的支持
         （&man.pf.4;）。</para>
 
       <para><literal>device pflog</literal> 启用可选的
 	&man.pflog.4; 伪网络设备， 用以通过 &man.bpf.4;
 	描述符来记录流量。 &man.pflogd.8; 服务可以用来存储信息，
 	并把它们以日志形式记录到磁盘上。</para>
 
       <para><literal>device pfsync</literal> 选项启用可选的
         &man.pfsync.4; 支持，这是用于监视 <quote>状态变更</quote>
         的伪网络设备。</para>
     </sect2>
 
     <sect2>
       <title>可用的 <filename>rc.conf</filename> 选项</title>
 
       <para>The following &man.rc.conf.5; statements configure
 	<acronym>PF</acronym> and &man.pflog.4; at boot:</para>
       <para>以下 &man.rc.conf.5; 中的语句用于启动时配置
         <acronym>PF</acronym> 和 &man.pflog.4;</para>
 
       <programlisting>pf_enable="YES"                 # 启用 PF (如果需要的话， 自动加载内核模块)
 pf_rules="/etc/pf.conf"         # pf 使用的规则定义文件
 pf_flags=""                     # 启动时传递给 pfctl 的其他选项
 pflog_enable="YES"              # 启动 pflogd(8)
 pflog_logfile="/var/log/pflog"  # pflogd 用于记录日志的文件名
 pflog_flags=""                  # 启动时传递给 pflogd 的其他选项</programlisting>
 
       <para>如果您的防火墙后面有一个 LAN，
 	而且需要通过它来转发 LAN 上的包， 或进行 NAT，
 	还需要同时启用下述选项：</para>
 
       <programlisting>gateway_enable="YES"            # 启用为 LAN 网关</programlisting>
     </sect2>
 
     <sect2>
       <title>建立过滤规则</title>
 
       <para><acronym>PF</acronym> 会从 &man.pf.conf.5;
         (默认为 <filename>/etc/pf.conf</filename>)
         文件中读取配置规则， 并根据那里的规则修改、丢弃或让数据包通过。
         默认安装的 &os; 已经提供了一些简单的例子放在
         <filename>/usr/share/examples/pf/</filename> 目录下。
         请参阅 <link xlink:href="http://www.openbsd.org/faq/pf/">PF FAQ</link>
 	获取完整的 <acronym>PF</acronym> 规则信息。</para>
 
       <warning>
 	<para>在浏览 <link xlink:href="http://www.openbsd.org/faq/pf/">PF FAQ</link> 时，
           请时刻注意不同版本的 &os; 可能会使用不同版本的 PF。 目前，
 	  &os;&nbsp;8.<replaceable>X</replaceable> 和之前的系统使用的是与
 	  OpenBSD&nbsp;4.1 相同版本的 <acronym>PF</acronym>。
           &os;&nbsp;9.<replaceable>X</replaceable> 和之后的系统使用的是与
           OpenBSD&nbsp;4.5 相同版本的 <acronym>PF</acronym>。</para>
       </warning>
 
       <para>&a.pf; 是一个提有关配置使用 <acronym>PF</acronym>
         防火墙问题的好地方。请在提问之前查阅邮件列表的归档！</para>
     </sect2>
 
     <sect2>
       <title>使用 PF</title>
 
       <para>使用 &man.pfctl.8; 可以控制 <acronym>PF</acronym>。
         以下是一些实用的命令
         （请查阅 &man.pfctl.8; 获得全部可用的选项）:</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>命令</entry>
 	      <entry>作用</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry><command>pfctl -e</command></entry>
 	      <entry>启用 PF</entry>
 	    </row>
 
 	    <row>
 	      <entry><command>pfctl -d</command></entry>
 	      <entry>禁用 PF</entry>
 	    </row>
 
 	    <row>
 	      <entry><command>pfctl -F all -f /etc/pf.conf</command></entry>
 	      <entry>清除所有规则 (nat, filter, state, table, 等等。)
 		并读取 <filename>/etc/pf.conf</filename></entry>
 	    </row>
 
 	    <row>
 	      <entry><command>pfctl -s [ rules | nat | state ]</command></entry>
 	      <entry>列出 filter 规则, nat 规则,
 		或状态表</entry>
 	    </row>
 
 	    <row>
 	      <entry><command>pfctl -vnf /etc/pf.conf</command></entry>
 	      <entry>检查 <filename>/etc/pf.conf</filename>
                 中的错误，但不加载相关的规则</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
     </sect2>
 
     <sect2>
       <title>启用 <acronym>ALTQ</acronym></title>
 
       <para><acronym>ALTQ</acronym> 只有在作为编译选项加入到 &os;
         内核时才能使用。<acronym>ALTQ</acronym>
         目前还不是所有的可用网卡驱动都能够支持的。
 	请参见 &man.altq.4; 联机手册了解您正使用的 &os;
         版本中的驱动支持情况。</para>
 
       <para>下面这些选项将启用 <acronym>ALTQ</acronym>
         以及一些附加的功能：</para>
 
       <programlisting>options         ALTQ
 options         ALTQ_CBQ        # 基于分类的排列 (CBQ)
 options         ALTQ_RED        # 随机先期检测 (RED)
 options         ALTQ_RIO        # 对进入和发出的包进行 RED
 options         ALTQ_HFSC       # 带等级的包调度器 (HFSC)
 options         ALTQ_PRIQ       # 按优先级的排列 (PRIQ)
 options         ALTQ_NOPCC      # 在联编 SMP 内核时必须使用，禁止读时钟</programlisting>
 
       <para><literal>options ALTQ</literal> 将启用
 	<acronym>ALTQ</acronym> 框架的支持。</para>
 
       <para><literal>options ALTQ_CBQ</literal>
 	用于启用 <emphasis>基于分类的队列</emphasis> (<acronym>CBQ</acronym>) 支持。 <acronym>CBQ</acronym>
 	允许您将连接分成不同的类别， 或者说， 队列，
 	以便在规则中为它们指定不同的优先级。</para>
 
       <para><literal>options ALTQ_RED</literal>
 	将启用 <emphasis>随机预检测</emphasis> (<acronym>RED</acronym>)。
 	<acronym>RED</acronym> 是一种用于防止网络拥塞的技术。
 	<acronym>RED</acronym> 度量队列的长度，
 	并将其与队列的最大和最小长度阈值进行比较。
 	如果队列过长， 则新的包将被丢弃。
 	如名所示， <acronym>RED</acronym> 从不同的连接中随机地丢弃数据包。</para>
 
       <para><literal>options ALTQ_RIO</literal> 将启用 <emphasis>出入的随机预检测</emphasis>。</para>
 
       <para><literal>options ALTQ_HFSC</literal>
 	启用 <emphasis>层次式公平服务平滑包调度器</emphasis>。
 	要了解关于 <acronym>HFSC</acronym> 进一步的信息， 请参见 <uri xlink:href="http://www-2.cs.cmu.edu/~hzhang/HFSC/main.html">http://www-2.cs.cmu.edu/~hzhang/HFSC/main.html</uri>。</para>
 
       <para><literal>options ALTQ_PRIQ</literal> 启用 <emphasis>优先队列</emphasis>
 	(<acronym>PRIQ</acronym>)。 <acronym>PRIQ</acronym>
 	首先允许高优先级队列中的包通过。</para>
 
       <para><literal>options ALTQ_NOPCC</literal> 启用
 	<acronym>ALTQ</acronym> 的
 	<acronym>SMP</acronym> 支持。
 	如果是 <acronym>SMP</acronym> 系统，
 	则必须使用它。</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="firewalls-ipf">
     <title>IPFILTER (IPF) 防火墙</title>
 
     <indexterm>
       <primary>防火墙</primary>
 
       <secondary>IPFILTER</secondary>
     </indexterm>
 
     <para>IPFILTER 的作者是 Darren Reed。 IPFILTER 是独立于操作系统的：
       它是一个开放源代码的应用， 并且已经被移植到了 &os;、 NetBSD、
       OpenBSD、 SunOS、 HP/UX， 以及 Solaris 操作系统上。
       IPFILTER 的支持和维护都相当活跃， 并且有规律地发布更新版本。</para>
 
     <para>IPFILTER 提供了内核模式的防火墙和
       <acronym>NAT</acronym> 机制，
       这些机制可以通过用户模式运行的接口程序进行监视和控制。
       防火墙规则可以使用 &man.ipf.8; 工具来动态地设置和删除。
       <acronym>NAT</acronym> 规则可以通过
       &man.ipnat.1; 工具来维护。 &man.ipfstat.8; 工具则可以用来显示
       IPFILTER 内核部分的统计数据。 最后， 使用
       &man.ipmon.8; 程序可以把 IPFILTER 的动作记录到系统日志文件中。</para>
 
     <para>IPF 最初是使用一组
       <quote>以最后匹配的规则为准</quote> 的策略来实现的，
       这种方式只能支持无状态的规则。 随着时代的进步，
       IPF 被逐渐增强， 并加入了 <quote>quick</quote> 选项，
       以及支持状态的 <quote>keep
       state</quote> 选项， 这使得规则处理逻辑变得更富有现代气息。
       IPF 的官方文档只介绍了传统的规则编写方法和文件处理逻辑。
       新增的功能只是作为一些附加的选项出现， 如果能完全理解这些功能，
       则对于建立更安全的防火墙就很有好处。</para>
 
     <para>这一节中主要是针对 <quote>quick</quote> 选项，
       以及支持状态的 <quote>keep state</quote> 选项的介绍。
       这是明示允许防火墙规则集最基本的编写要素。</para>
 
     <para>要获得关于传统规则处理方式的详细信息，
       请参考： <uri xlink:href="http://www.obfuscation.org/ipf/ipf-howto.html#TOC_1">http://www.obfuscation.org/ipf/ipf-howto.html#TOC_1</uri>
       以及 <uri xlink:href="http://coombs.anu.edu.au/~avalon/ip-filter.html">http://coombs.anu.edu.au/~avalon/ip-filter.html</uri>。</para>
 
     <para>IPF FAQ 可以在 <uri xlink:href="http://www.phildev.net/ipf/index.html">http://www.phildev.net/ipf/index.html</uri> 找到。</para>
 
     <para>除此之外， 您还可以在 <uri xlink:href="http://marc.theaimsgroup.com/?l=ipfilter">http://marc.theaimsgroup.com/?l=ipfilter</uri>
       找到开放源代码的 IPFilter 的邮件列表存档， 并进行搜索。</para>
 
     <sect2>
       <title>启用 IPF</title>
 
       <indexterm>
 	<primary>IPFILTER</primary>
 
 	<secondary>启用</secondary>
       </indexterm>
 
       <para>IPF 作为 &os; 基本安装的一部分，
 	以一个独立的内核模块的形式提供。
 	如果在 <filename>rc.conf</filename> 中配置了
 	<literal>ipfilter_enable="YES"</literal>，
 	系统就会自动地动态加载 IPF 内核模块。
 	这个内核模块在创建时启用了日志支持， 并加入了 <literal>default
 	pass all</literal> 选项。 如果只是需要把默认的规则设置为
 	<literal>block all</literal> 的话， 就不需要把 IPF 编译到内核中。
 	简单地通过把 <literal>block all</literal>
 	这条规则加入自己的规则集来达到同样的目的。</para>
     </sect2>
 
     <sect2>
       <title>内核选项</title>
 
       <indexterm>
 	<primary>内核选项</primary>
 
 	<secondary>IPFILTER</secondary>
       </indexterm>
 
       <indexterm>
 	<primary>内核选项</primary>
 
 	<secondary>IPFILTER_LOG</secondary>
       </indexterm>
 
       <indexterm>
 	<primary>内核选项</primary>
 
 	<secondary>IPFILTER_DEFAULT_BLOCK</secondary>
       </indexterm>
 
       <indexterm>
 	<primary>IPFILTER</primary>
 
 	<secondary>内核选项</secondary>
       </indexterm>
 
       <para>下面这些 &os; 内核编译选项并不是启用 IPF 所必需的。
 	这里只是作为背景知识来加以阐述。 如果将 IPF
 	编入了内核， 则对应的内核模块将不被使用。</para>
 
       <para>关于 IPF 选项语句的内核编译配置的例子， 可以在内核源代码中的
 	<filename>/usr/src/sys/conf/NOTES</filename> 找到。
 	此处列举如下：</para>
 
       <programlisting>options IPFILTER
 options IPFILTER_LOG
 options IPFILTER_DEFAULT_BLOCK</programlisting>
 
       <para><literal>options IPFILTER</literal> 用于启用
 	<quote>IPFILTER</quote> 防火墙的支持。</para>
 
       <para><literal>options IPFILTER_LOG</literal> 用于启用 IPF 的日志支持，
 	所有匹配了包含 <literal>log</literal> 的规则的包，
 	都会被记录到 <filename>ipl</filename> 这个包记录伪&mdash;设备中。</para>
 
       <para><literal>options IPFILTER_DEFAULT_BLOCK</literal>
 	将改变防火墙的默认动作， 进而， 所有不匹配防火墙的 <literal>pass</literal>
 	规则的包都会被阻止。</para>
 
       <para>这些选项只有在您重新编译并安装了上述配置的内核之后才会生效。</para>
     </sect2>
 
     <sect2>
       <title>可用的 <filename>rc.conf</filename> 选项</title>
 
       <para>要在启动时激活 IPF， 需要在 <filename>/etc/rc.conf</filename>
 	中增加下面的设置：</para>
 
       <programlisting>ipfilter_enable="YES"             # 启动 ipf 防火墙
 ipfilter_rules="/etc/ipf.rules"   # 将被加载的规则定义， 这是一个文本文件
 ipmon_enable="YES"                # 启动 IP 监视日志
 ipmon_flags="-Ds"                 # D = 作为服务程序启动
                                   # s = 使用 syslog 记录
                                   # v = 记录 tcp 窗口大小、 ack 和顺序号(seq)
                                   # n = 将 IP 和端口映射为名字</programlisting>
 
       <para>如果在防火墙后面有使用了保留的私有 IP 地址范围的 LAN，
 	还需要增加下面的一些选项来启用 <acronym>NAT</acronym> 功能：</para>
 
       <programlisting>gateway_enable="YES"              # 启用作为 LAN 网关的功能
 ipnat_enable="YES"                # 启动 ipnat 功能
 ipnat_rules="/etc/ipnat.rules"    # 用于 ipnat 的规则定义文件</programlisting>
     </sect2>
 
     <sect2>
       <title>IPF</title>
 
       <indexterm><primary><command>ipf</command></primary></indexterm>
 
       <para>&man.ipf.8; 命令可以用来加载您自己的规则文件。 一般情况下，
 	您可以建立一个包括您自定义的规则的文件，
 	并使用这个命令来替换掉正在运行的防火墙中的内部规则：</para>
 
       <screen>&prompt.root; <userinput>ipf -Fa -f /etc/ipf.rules</userinput></screen>
 
       <para><option>-Fa</option> 表示清除所有的内部规则表。</para>
 
       <para><option>-f</option> 用于指定将要被读取的规则定义文件。</para>
 
       <para>这个功能使得您能够修改自定义的规则文件， 通过运行上面的 IPF 命令，
 	可以将正在运行的防火墙刷新为使用全新的规则集， 而不需要重新启动系统。
 	这对于测试新的规则来说就很方便， 因为您可以任意执行上面的命令。</para>
 
       <para>请参考 &man.ipf.8; 联机手册以了解这个命令提供的其它选项。</para>
 
       <para>&man.ipf.8; 命令假定规则文件是一个标准的文本文件。
 	它不能处理使用符号代换的脚本。</para>
 
       <para>也确实有办法利用脚本的非常强大的符号替换能力来构建 IPF 规则。
 	要了解进一步的细节， 请参考
 	<xref linkend="firewalls-ipf-rules-script"/>。</para>
      </sect2>
 
     <sect2>
       <title>IPFSTAT</title>
 
       <indexterm><primary><command>ipfstat</command></primary></indexterm>
 
       <indexterm>
 	<primary>IPFILTER</primary>
 
 	<secondary>统计</secondary>
       </indexterm>
 
       <para>默认情况下， &man.ipfstat.8; 会获取并显示所有的累积统计，
 	这些统计是防火墙启动以来用户定义的规则匹配的出入流量，
 	您可以通过使用
 	<command>ipf -Z</command> 命令来将这些计数器清零。</para>
 
       <para>请参见 &man.ipfstat.8; 联机手册以了解进一步的细节。</para>
 
       <para>默认的 &man.ipfstat.8; 命令输出类似于下面的样子：</para>
 
       <screen>input packets: blocked 99286 passed 1255609 nomatch 14686 counted 0
  output packets: blocked 4200 passed 1284345 nomatch 14687 counted 0
  input packets logged: blocked 99286 passed 0
  output packets logged: blocked 0 passed 0
  packets logged: input 0 output 0
  log failures: input 3898 output 0
  fragment state(in): kept 0 lost 0
  fragment state(out): kept 0 lost 0
  packet state(in): kept 169364 lost 0
  packet state(out): kept 431395 lost 0
  ICMP replies: 0 <acronym>TCP</acronym> RSTs sent: 0
  Result cache hits(in): 1215208 (out): 1098963
  IN Pullups succeeded: 2 failed: 0
  OUT Pullups succeeded: 0 failed: 0
  Fastroute successes: 0 failures: 0
  <acronym>TCP</acronym> cksum fails(in): 0 (out): 0
  Packet log flags set: (0)</screen>
 
       <para>如果使用了 <option>-i</option> (进入流量)
 	或者 <option>-o</option> (输出流量)，
 	这个命令就只获取并显示内核中所安装的对应过滤器规则的统计数据。</para>
 
       <para><command>ipfstat -in</command> 以规则号的形式显示进入的内部规则表。</para>
 
       <para><command>ipfstat -on</command> 以规则号的形式显示流出的内部规则表。</para>
 
       <para>输出和下面的类似：</para>
 
       <screen>@1 pass out on xl0 from any to any
 @2 block out on dc0 from any to any
 @3 pass out quick on dc0 proto tcp/udp from any to any keep state</screen>
 
       <para><command>ipfstat -ih</command> 显示内部规则表中的进入流量，
 	每一个匹配规则前面会同时显示匹配的次数。</para>
 
       <para><command>ipfstat -oh</command> 显示内部规则表中的流出流量，
 	每一个匹配规则前面会同时显示匹配的次数。</para>
 
       <para>输出和下面的类似：</para>
 
       <screen>2451423 pass out on xl0 from any to any
 354727 block out on dc0 from any to any
 430918 pass out quick on dc0 proto tcp/udp from any to any keep state</screen>
 
       <para><command>ipfstat</command> 命令的一个重要的功能可以通过指定
 	<option>-t</option> 参数来使用， 它会以类似 &man.top.1;
 	的显示 &os; 正运行的进程表的方式来显示统计数据。
 	当您的防火墙正在受到攻击的时候， 这个功能让您得以识别、
 	试验， 并查看攻击的数据包。 这个选项提还提供了实时选择希望监视的目的或源 IP、
 	端口或协议的能力。 请参见 &man.ipfstat.8; 联机手册以了解详细信息。</para>
     </sect2>
 
     <sect2>
       <title>IPMON</title>
 
       <indexterm><primary><command>ipmon</command></primary></indexterm>
 
       <indexterm>
 	<primary>IPFILTER</primary>
 
 	<secondary>记录日志</secondary>
       </indexterm>
 
       <para>为了使 <command>ipmon</command> 能够正确工作，
 	必须打开 <literal>IPFILTER_LOG</literal> 这个内核选项。
 	这个命令提供了两种不同的使用模式。
 	内建模式是默认的模式， 如果您不指定
 	<option>-D</option> 参数， 就会采用这种模式。</para>
 
       <para>服务模式是持续地通过系统日志来记录的工作模式， 这样，
 	您就可以通过查看日志来了解过去曾经发生过的事情。
 	这种模式是 &os; 和 IPFILTER 配合工作的模式。
 	由于在 &os; 中提供了一个内建的系统日志自动轮转功能，
 	因此， 使用 &man.syslogd.8; 比默认的将日志信息记录到一个普通文件要好。
 	在默认的 <filename>rc.conf</filename> 文件中，
 	<literal>ipmon_flags</literal> 语句会指定 <option>-Ds</option> 标志：</para>
 
       <programlisting>ipmon_flags="-Ds"                 # D = 作为服务程序启动
                   # s = 使用 syslog 记录
                   # v = 记录 tcp 窗口大小、 ack 和顺序号(seq)
                   # n = 将 IP 和端口映射为名字</programlisting>
 
       <para>记录日志的好处是很明显的。 它提供了在事后重新审查相关信息，
 	例如哪些包被丢弃， 以及这些包的来源地址等等。
 	这将为查找攻击者提供非常有用的第一手资料。</para>
 
       <para>即使启用了日志机制， IPF 仍然不会对其规则进行任何日志记录工作。
 	防火墙管理员可以决定规则集中的哪些应记录日志，
 	并在这些规则上加入 log 关键字。 一般来说， 只应记录拒绝性的规则。</para>
 
       <para>作为惯例， 通常会有一条默认的、拒绝所有网络流量的规则，
 	并指定 log 关键字， 作为您的规则集的最后一条。
 	这样就能够看到所有没有匹配任何规则的数据包了。</para>
     </sect2>
 
     <sect2>
       <title>IPMON 的日志</title>
 
       <para><application>Syslogd</application> 使用特殊的方法对日志数据进行分类。
 	它使用称为 <quote>facility</quote> 和 <quote>level</quote> 的组。
 	以 <option>-Ds</option> 模式运行的 IPMON 采用 <literal>local0</literal>
 	作为默认的 <quote>facility</quote>
 	名。 如果需要， 可以用下列 levels
 	来进一步区分数据：</para>
 
       <screen>LOG_INFO - 使用 "log" 关键字指定的通过或阻止动作
 LOG_NOTICE - 同时记录通过的那些数据包
 LOG_WARNING - 同时记录阻止的数据包
 LOG_ERR - 进一步记录含不完整的包头的数据包</screen>
 
       <!-- XXX: "can be considered short" == "with incomplete header" -->
 
       <para>要设置 IPFILTER 来将所有的数据记录到
 	<filename>/var/log/ipfilter.log</filename>， 需要首先建立这个文件。
 	下面的命令可以完成这个工作：</para>
 
        <screen>&prompt.root; <userinput>touch /var/log/ipfilter.log</userinput></screen>
 
       <para>&man.syslogd.8; 功能可以通过在 <filename>/etc/syslog.conf</filename> 文件中的语句来定义。
 	<filename>syslog.conf</filename> 提供了相当多的用以控制 syslog
 	如何处理类似 IPF 这样的用用程序所产生的系统消息的方法。</para>
 
       <para>您需要将下列语句加到
 	<filename>/etc/syslog.conf</filename>：</para>
 
       <programlisting>local0.* /var/log/ipfilter.log</programlisting>
 
       <para>这里的 <literal>local0.*</literal>
 	表示把所有的相关日志信息写到指定的文件中。</para>
 
       <para>要让 <filename>/etc/syslog.conf
 	</filename> 中的修改立即生效， 可以重新启动计算机， 或者通过执行
 	<command>/etc/rc.d/syslogd reload</command>
 	来让它重新读取 <filename>/etc/syslog.conf</filename>。</para>
 
       <para>不要忘了修改 <filename>/etc/newsyslog.conf
 	</filename> 来让刚创建的日志进行轮转。</para>
     </sect2>
 
      <sect2>
        <title>记录消息的格式</title>
 
        <para>由 <command>ipmon</command> 生成的消息由空格分隔的数据字段组成。
          所有的消息都包含的字段是：</para>
 
       <orderedlist>
 	<listitem>
 	  <para>接到数据包的日期。</para>
 	</listitem>
 
 	<listitem>
 	  <para>接到数据包的时间。 其格式为
 	    HH:MM:SS.F， 分别是小时、 分钟、 秒，
 	    以及分秒 (这个数字可能有许多位)。</para>
 	</listitem>
 
 	<listitem>
 	  <para>处理数据包的网络接口名字，
 	    例如 <filename>dc0</filename>。</para>
 	</listitem>
 
 	<listitem>
 	  <para>组和规则的编号， 例如 <literal>@0:17</literal>。</para>
 	</listitem>
       </orderedlist>
 
       <para>可以通过 <command>ipfstat -in</command> 来查看这些信息。</para>
 
       <orderedlist>
 	<listitem>
 	  <para>动作： p 表示通过， b 表示阻止， S 表示包头不全，
 	    n 表示没有匹配任何规则， L 表示 log 规则。
 	    显示这些标志的顺序是： S, p, b, n, L。
 	    大写的 P 或 B 表示记录包的原因是某个全局的日志配置，
 	    而不是某个特定的规则。</para>
 	</listitem>
 
 	<listitem>
 	  <para>地址。 这实际上包括三部分：
 	    源地址和端口 (以逗号分开)， 一个 -&gt;
 	    符号， 以及目的地址和端口， 例如：
 	    <literal>209.53.17.22,80 -&gt; 198.73.220.17,1722</literal>。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>PR</literal>， 后跟协议名称或编号，
 	    例如： <literal>PR tcp</literal>。</para>
 	</listitem>
 
 	<listitem>
 	  <para><literal>len</literal>， 后跟包头的长度， 以及包的总长度，
 	    例如： <literal>len 20 40</literal>。</para>
 	</listitem>
       </orderedlist>
 
       <para>对于 <acronym>TCP</acronym> 包， 则还会包括一个附加的字段，
 	由一个连字号开始， 之后是表示所设置的标志的一个字母。
 	请参见 &man.ipf.5; 联机手册， 以了解这些字母所对应的标志。</para>
 
       <para>对于 ICMP 包， 则在最后会有两个字段。
 	前一个总是 <quote>ICMP</quote>， 而后一个则是 ICMP
 	消息和子消息的类型， 中间以斜线分靠， 例如 ICMP 3/3
 	表示端口不可达消息。</para>
     </sect2>
 
     <sect2 xml:id="firewalls-ipf-rules-script">
       <title>构建采用符号替换的规则脚本</title>
 
       <para>一些有经验的 IPF 会创建包含规则的文件，
 	并把它编写成能够与符号替换脚本兼容的方式。
 	这样做最大的好处是能够在修改时只修改符号名字所代表的值，
 	而在脚本执行时直接替换掉所有的名符。
 	作为脚本， 可以使用符号替换来把那些经常使用的值直接用于多个规则。
 	下面将给出一个例子。</para>
 
       <para>这个脚本所使用的语法与 &man.sh.1;、 &man.csh.1;，
 	以及 &man.tcsh.1; 脚本。</para>
 
       <para>符号替换的前缀字段是美元符号： <literal>&dollar;</literal>。</para>
 
       <para>符号字段不使用 &dollar; 前缀。</para>
 
       <para>希望替换符号字段的值，
 	必须使用双引号 (<literal>"</literal>) 括起来。</para>
 
        <para>您的规则文件的开头类似这样：</para>
 
       <programlisting>############# IPF 规则脚本的开头 ########################
 oif="dc0"            # 外网接口的名字
 odns="192.0.2.11"    # ISP 的 DNS 服务器 IP 地址
 myip="192.0.2.7"     # 来自 ISP 的静态 IP 地址
 ks="keep state"
 fks="flags S keep state"
 
 # 可以使用这个脚本来建立 /etc/ipf.rules 文件，
 # 也可以 "直接地" 运行它。
 #
 # 请删除两个注释号之一。
 #
 # 1) 保留下面一行， 则创建 /etc/ipf.rules：
 #cat &gt; /etc/ipf.rules &lt;&lt; EOF
 #
 # 2) 保留下面一行， 则 "直接地" 运行脚本：
 /sbin/ipf -Fa -f - &lt;&lt; EOF
 
 # 允许发出到我的 ISP 的域名服务器的访问
 pass out quick on &dollar;oif proto tcp from any to &dollar;odns port = 53 &dollar;fks
 pass out quick on &dollar;oif proto udp from any to &dollar;odns port = 53 &dollar;ks
 
 # 允许发出未加密的 www 访问请求
 pass out quick on &dollar;oif proto tcp from &dollar;myip to any port = 80 &dollar;fks
 
 # 允许发出使用 TLS SSL 加密的 https www 访问请求
 pass out quick on &dollar;oif proto tcp from &dollar;myip to any port = 443 &dollar;fks
 EOF
 ################## IPF 规则脚本的结束 ########################</programlisting>
 
       <para>这就是所需的全部内容。 这个规则本身并不重要，
 	它们主要是用于体现如何使用符号代换字段，
 	以及如何完成值的替换。
 	如果上面的例子的名字是 <filename>/etc/ipf.rules.script</filename>，
 	就可以通过输入下面的命令来重新加载规则：</para>
 
       <screen>&prompt.root; <userinput>sh /etc/ipf.rules.script</userinput></screen>
 
       <para>在规则文件中嵌入符号有一个问题： IPF 无法识别符号替换，
 	因此它不能直接地读取这样的脚本。</para>
 
       <para>这个脚本可以使用下面两种方法之一来使用：</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>去掉 <literal>cat</literal> 之前的注释，
 	    并注释掉
 	    <literal>/sbin/ipf</literal> 开头的那一行。 像其他配置一样， 将
 	    <literal>ipfilter_enable="YES"</literal> 放到
 	    <filename>/etc/rc.conf</filename> 文件中，
 	    并在此后立刻执行脚本， 以创建或更新
 	    <filename>/etc/ipf.rules</filename>。</para>
 	</listitem>
 
 	<listitem>
 	  <para>通过把 <literal>ipfilter_enable="NO"</literal>
 	    (这是默认值) 加到
 	    <filename>/etc/rc.conf</filename> 中，
 	    来禁止系统启动脚本开启 IPFILTER。</para>
 
 	  <para>在
 	    <filename>/usr/local/etc/rc.d/</filename>
 	    启动目录中增加一个类似下面的脚本。
 	    应该给它起一个显而易见的名字， 例如
 	    <filename>ipf.loadrules.sh</filename>。
 	    请注意， <filename>.sh</filename>
 	    扩展名是必需的。</para>
 
 	  <programlisting>#!/bin/sh
 sh /etc/ipf.rules.script</programlisting>
 
 	  <para>脚本文件必须设置为属于 <systemitem class="username">root</systemitem>，
 	    并且属主可读、 可写、 可执行。</para>
 
 	  <screen>&prompt.root; <userinput>chmod 700 /usr/local/etc/rc.d/ipf.loadrules.sh</userinput></screen>
 	</listitem>
       </itemizedlist>
 
       <para>这样， 在系统启动时， 就会自动加载您的 IPF
 	规则了。</para>
     </sect2>
 
     <sect2>
       <title>IPF 规则集</title>
 
       <para>规则集是指一组编写好的依据包的值决策允许通过或阻止 IPF 规则。
 	包的双向交换组成了一个会话交互。 防火墙规则集会作用于来自于
 	Internet 公网的包以及由系统发出来回应这些包的数据包。
 	每一个 <acronym>TCP/IP</acronym> 服务 (例如 telnet, www,
 	邮件等等) 都由协议预先定义了其特权 (监听) 端口。
 	发到特定服务的包会从源地址使用非特权 (高编号) 端口发出，
 	并发到特定服务在目的地址的对应端口。
 	所有这些参数 (例如： 端口和地址）
 	都是可以为防火墙规则所利用的， 判别是否允许服务通过的标准。</para>
 
       <indexterm>
 	<primary>IPFILTER</primary>
 
 	<secondary>规则处理顺序</secondary>
        </indexterm>
 
       <para>IPF 最初被写成使用一组称作
 	<quote>以最后匹配的规则为准</quote> 的处理逻辑， 且只能处理无状态的规则。
 	随着时代的发展， IPF 进行了改进， 并提供了 <quote>quick</quote>
 	选项， 以及一个有状态的 <quote>keep state</quote> 选项。
 	后者使处理逻辑迅速地跟上了时代的步伐。</para>
 
       <para>这一节中提供的一些指导，
 	是基于使用包含 <quote>quick</quote> 选项和有状态的
 	<quote>keep state</quote> 选项来进行阐述的。
 	这些是编写明示允许防火墙规则集的基本要素。</para>
 
       <warning>
 	<para>当对防火墙规则进行操作时， 应
 	    <emphasis>谨慎行事</emphasis>。 某些配置可能会
 	    <emphasis>将您反锁在</emphasis> 服务器外面。
 	  保险起见， 您可以考虑在第一次进行防火墙配置时在本地控制台上，
 	  而不是远程， 如通过
 	  <application>ssh</application> 来进行。</para>
       </warning>
     </sect2>
 
     <sect2>
       <title>规则语法</title>
 
       <indexterm>
 	<primary>IPFILTER</primary>
 
 	<secondary>规则语法</secondary>
       </indexterm>
 
       <para>这里给出的规则语法已经简化到只处理那些新式的带状态规则，
 	并且都是 <quote>第一个匹配的规则获胜</quote> 逻辑的。
 	要了解完整的传统规则语法描述， 请参见 &man.ipf.8; 联机手册。</para>
 
       <para>以 <literal>#</literal> 字符开头的内容会被认为是注释。
 	这些注释可以出现在一行规则的末尾， 或者独占一行。 空行会被忽略。</para>
 
       <para>规则由关键字组成。 这些关键字必须以一定的顺序，
 	从左到右出现在一行上。 接下来的文字中关键字将使用粗体表示。
 	某些关键字可能提供了子选项， 这些子选项本身可能也是关键字，
 	而且可能会提供更多的子选项。 下面的文字中，
 	每种语法都使用粗体的小节标题呈现， 并介绍了其上下文。</para>
 
       <!-- This section is probably wrong. See the OpenBSD flag -->
       <!-- What is the "OpenBSD flag"?  Reference please -->
 
       <para><replaceable>ACTION IN-OUT OPTIONS SELECTION STATEFUL PROTO
 	SRC_ADDR,DST_ADDR OBJECT PORT_NUM TCP_FLAG
 	STATEFUL</replaceable></para>
 
       <para><replaceable>ACTION</replaceable> = block | pass</para>
 
       <para><replaceable>IN-OUT</replaceable> = in | out</para>
 
       <para><replaceable>OPTIONS</replaceable> = log | quick | on
 	网络接口的名字</para>
 
       <para><replaceable>SELECTION</replaceable> = proto 协议名称 |
 	源/目的 IP | port = 端口号 | flags 标志值</para>
 
       <para><replaceable>PROTO</replaceable> = tcp/udp | udp | tcp |
 	icmp</para>
 
       <para><replaceable>SRC_ADD,DST_ADDR</replaceable> = all | from
 	对象 to 对象</para>
 
       <para><replaceable>OBJECT</replaceable> = IP地址 | any</para>
 
       <para><replaceable>PORT_NUM</replaceable> = port 端口号</para>
 
       <para><replaceable>TCP_FLAG</replaceable> = S</para>
 
       <para><replaceable>STATEFUL</replaceable> = keep state</para>
 
       <sect3>
 	<title>ACTION (动作)</title>
 
 	<para>动作对表示匹配规则的包应采取什么动作。
 	  每一个规则 <emphasis>必须</emphasis> 包含一个动作。
 	  可以使用下面两种动作之一：</para>
 
 	<para><literal>block</literal> 表示如果规则与包匹配，
 	  则丢弃包。</para>
 
 	<para><literal>pass</literal> 表示如果规则与包匹配，
 	  则允许包通过防火墙。</para>
       </sect3>
 
       <sect3>
 	<title>IN-OUT</title>
 	<para>每个过滤器规则都必须明确地指定是流入还是流出的规则。
 	  下一个关键字必须要么是 <literal>in</literal>，
 	  要么是 <literal>out</literal>，
 	  否则将无法通过语法检查。</para>
 
 	<para><literal>in</literal> 表示规则应被应用于刚刚从 Internet
 	  公网上收到的数据包。</para>
 
 	<para><literal>out</literal> 表示规则应被应用于即将发出到
 	  Internet 的数据包。</para>
       </sect3>
 
       <sect3>
 	<title>OPTIONS</title>
 	<note>
 	  <para>这些选项必须按下面指定的顺序出现。</para>
 	</note>
 
 	<para><literal>log</literal> 表示包头应被写入到
 
 	<!-- XXX - xref here -->
 
 	  <filename>ipl</filename> 日志 (如前面 LOGGING 小节所介绍的那样)，
 	  如果它与规则匹配的话。</para>
 
 	<para><literal>quick</literal> 表示如果给出的参数与包匹配，
 	  则以这个规则为准， 这使得能够 "短路" 掉后面的规则。
 	  这个选项对于使用新式的处理逻辑是必需的。</para>
 
 	<para><literal>on</literal> 表示将网络接口的名称作为筛选参数的一部分。
 	  接口的名字会在 &man.ifconfig.8; 的输出中显示。 使用这个选项，
 	  则规则只会应用到某一个网络接口上的出入数据包上。
 	  要配置新式的处理逻辑， 必须使用这个选项。</para>
 
 	<para>当记录包时， 包的头会被写入到 <acronym>IPL</acronym> 包日志伪设备中。
 	  紧跟 <literal>log</literal> 关键字， 可以使用下面几个修饰符
 	  (按照下列顺序)：</para>
 
 	<para><literal>body</literal> 表示应同时记录包的前 128 字节的内容。</para>
 
 	<para><literal>first</literal> 如果 <literal>log</literal> 关键字和
 	  <literal>keep state</literal> 选项同时使用，
 	  则这个选项只在第一个包上触发， 这样就不用记录每一个
 	  <quote>keep state</quote> 包信息了。</para>
       </sect3>
 
       <sect3>
 	<title>SELECTION</title>
 
 	<para>这一节所介绍的关键字可以用于所检察的包的属性。
 	  有一个关键字主题， 以及一组子选项关键字，
 	  您必须从他们中选择一个。 以下是一些通用的属性，
 	  它们必须按下面的顺序使用：</para>
       </sect3>
 
       <sect3>
 	<title>PROTO</title>
 	<para><literal>proto</literal> 是一个主题关键字，
 	  它必须与某个相关的子选项关键字配合使用。
 	  这个值的作用是匹配某个特定的协议。
 	  要使用新式的规则处理逻辑， 就必须使用这个选项。</para>
 
 	<para><literal>tcp/udp | udp | tcp | icmp</literal> 或其他在
 	  <filename>/etc/protocols</filename> 中定义的协议。
 	  特殊的协议关键字 <literal>tcp/udp</literal> 可以用于匹配
 	  <acronym>TCP</acronym> 或 <acronym>UDP</acronym> 包，
 	  引入这个关键字的作用是是避免大量的重复规则的麻烦。</para>
       </sect3>
 
       <sect3>
 	<title>SRC_ADDR/DST_ADDR</title>
 	<para>使用 <literal>all</literal> 关键词， 基本上相当于 <quote>from
 	  any to any</quote> 在没有配合其他关键字的情形。</para>
 
 	<para><literal>from src to dst</literal>： <literal>from</literal> 和 <literal>to</literal>
 	  关键字主要是用来匹配 IP 地址。 所有的规则都必须
 	  <emphasis>同时</emphasis> 给出源和目的两个参数。
 	  <literal>any</literal> 是一个可以用于匹配任意 IP 地址的特殊关键字。
 	  例如， 您可以使用 <literal>from any to any</literal> 或 <literal>from
 	  0.0.0.0/0 to any</literal> 或 <literal>from any to 0.0.0.0/0</literal> 或 <literal>from
 	  0.0.0.0 to any</literal> 以及 <literal>from any to 0.0.0.0</literal>。</para>
 
 	<para>如果无法使用子网掩码来表示 IP 的话， 表达地址就会很麻烦。
 	  使用 <package>net-mgmt/ipcalc</package> port 可以帮助进行计算。
 	  请参见下面的网页了解如何撰写长度掩码：
 	  <uri xlink:href="http://jodies.de/ipcalc">http://jodies.de/ipcalc</uri>。</para>
       </sect3>
 
       <sect3>
 	<title>PORT</title>
 
 	<para>如果为源或目的指定了匹配端口， 规则就只能应用于
 	  <acronym>TCP</acronym> 和 <acronym>UDP</acronym> 包了。
 	  当编写端口比较规则时， 可以指定
 	  <filename>/etc/services</filename> 中所定义的名字，
 	  也可以直接用端口号来指定。 如果端口号出现在源对象一侧，
 	  则被认为是源端口号； 反之， 则被认为是目的端口号。
 	  要使用新式的规则处理逻辑，
 	  就必须与 <literal>to</literal> 对象配合使用这个选项。 使用的例子：
 	  <literal>from any to any port = 80</literal></para>
 
 	<!-- XXX: Rewritten, but probably needs more changes -->
 
 	<para>对单个端口的比较可以多种方式进行， 并可使用不同的比较算符。
 	  此外， 还可以指定端口的范围。</para>
 
 	<para>port "=" | "!=" | "&lt;" | "&gt;" | "&lt;=" | "&gt;=" |
 	  "eq" | "ne" | "lt" | "gt" | "le" | "ge".</para>
 
 	<para>要指定端口范围， 可以使用 "&lt;&gt;" | "&gt;&lt;"。</para>
 
 	<warning>
 	  <para>在源和目的匹配参数之后， 需要使用下面两个参数，
 	    才能够使用新式的规则处理逻辑。</para>
 	</warning>
       </sect3>
 
       <sect3>
 	<title><acronym>TCP</acronym>_FLAG</title>
 
 	<para>标志只对 <acronym>TCP</acronym> 过滤有用。
 	  这些字母用来表达 <acronym>TCP</acronym> 包头的标志。</para>
 
 	<para>新式的规则处理逻辑使用
 	  <literal>flags S</literal> 参数来识别 tcp
 	  会话开始的请求。</para>
       </sect3>
 
       <sect3>
 	<title>STATEFUL</title>
 	<para><literal>keep state</literal> 表示如果有一个包与规则匹配，
 	  则其筛选参数应激活有状态的过滤机制。</para>
 
 	<note>
 	  <para>如果使用新式的处理逻辑， 则这个选项是必需的。</para>
 	</note>
       </sect3>
     </sect2>
 
 
     <sect2>
       <title>有状态过滤</title>
 
       <indexterm>
 	<primary>IPFILTER</primary>
 
 	<secondary>有状态过滤</secondary>
       </indexterm>
 
       <!-- XXX: duplicated -->
 
       <para>有状态过滤将网络流量当作一种双向的包交换来处理。
 	如果激活它， keep-state 会动态地为每一个相关的包在双向会话交互过程中产生内部规则。
 	它能够确认发起者和包的目的地之间的会话是有效的双向包交换过程的一部分。
 	如果包与这些规则不符， 则将自动地拒绝。</para>
 
       <para>状态保持也使得 ICMP 包能够与 <acronym>TCP</acronym>
 	或 UDP 会话相关。 因此， 如果您在浏览网站时收到允许的状态保持规则匹配的
 	ICMP 类型 3 代码 4 响应， 则这些响应会被自动地允许进入。
 	所有 IPF 能够处理的包， 都可以作为某种活跃会话的一部分，
 	即使它是另一种协议的， 也会被允许进入。</para>
 
       <para>所发生的事情是：</para>
 
       <para>将要通过连入 Internet 公网的网络接口发出的包，
 	首先会经过动态状态表的检查。 如果包与会话中预期的下一个包匹配，
 	防火墙就会允许包通过， 并更新状态表中的会话的交互流信息。
 	不属于活跃会话的包， 则简单地交给输出规则集去检查。</para>
 
       <para>发到连入 Internet 公网接口的包， 也会先经过动态状态表的检查。
 	如果包与会话中预期的下一个包匹配，
 	防火墙就会允许包通过， 并更新状态表中的会话的交互流信息。
 	不属于活跃会话的包， 则简单地交给输入规则集去检查。</para>
 
       <para>当会话结束时， 对应的项会在动态状态表中删除。</para>
 
       <para>有状态过滤使得您能够集中于阻止/允许新的会话。
 	一旦新会话被允许通过， 则所有后续的包就都被自动地允许通过，
 	而伪造的包则被自动地拒绝。 如果新的会话被阻止，
 	则后续的包也都不会被允许通过。 有状态过滤从技术角度而言，
 	在阻止目前攻击者常用的洪水式攻击来说， 具有更好的抗御能力。</para>
     </sect2>
 
     <sect2>
       <!-- XXX: This section needs a rewrite -->
 
       <title>明示允许规则集的例子</title>
 
       <para>下面的规则集是如何编写非常安全的明示允许防火墙规则集的一个范例。
 	明示允许防火墙只让允许的服务 <literal>pass</literal> (通过)，
 	而所有其他的访问都会被默认地拒绝。 期望用来保护其他机器的防火墙，
 	通常也叫做 <quote>网络防火墙</quote>， 应使用至少两个网络接口，
 	并且通常只有一个接入到受信的一端 (<acronym>LAN</acronym>)，
 	而另一块则接入不受信的一端 (Internet 公网)。 另外，
 	防火墙也可以配置为只保护它所运行的那个系统 &mdash; 这种类型称作
 	<quote>主机防火墙</quote>， 通常在接入不受信网络的服务器上使用。</para>
 
       <para>包括 &os; 在内的所有类 &unix; 系统通常都会使用
 	<filename>lo0</filename> 和 IP 地址
 	<systemitem class="ipaddress">127.0.0.1</systemitem> 用于操作系统中内部的通讯。
 	防火墙规则必须允许这些包无阻碍地通过。</para>
 
       <para>接入 Internet 公网的网络接口， 是放置规则并允许将访问请求发到
 	Internet 以及接收响应的地方。 这有可能是用户模式的 PPP
 	<filename>tun0</filename> 接口，
 	如果您的网卡同 DSL 或电缆调制解调器相联的话。</para>
 
       <para>如果有网卡是直接接入私有网段的，
 	这些网络接口就可能需要配置允许来自这些 LAN 的包在彼此之间，
 	以及到外界 (Internet) 上的对应的通过规则。</para>
 
       <para>一般说来， 规则应被组织为三个主要的小节：
 	所有允许自由通过的接口规则， 发到公网接口的规则，
 	以及进入公网接口的规则。</para>
 
       <para>每一个公网接口规则中， 经常会匹配到的规则应该放置在尽可能靠前的位置。
 	而最后一个规则应该是阻止包通过， 并记录它们。</para>
 
       <para>下面防火墙规则集中， Outbound 部分是一些使用
 	<literal>pass</literal> 的规则， 这些规则指定了允许访问的公网
 	Internet 服务， 并且指定了 <literal>quick</literal>、 <literal>on</literal>、
 	<literal>proto</literal>、 <literal>port</literal>， 以及 <literal>keep state</literal> 这些选项。 <literal>proto
 	tcp</literal> 规则还指定了 <literal>flag</literal> 这个选项， 这样会话的第一个包将出发状态机制。</para>
 
       <para>接收部分则首先阻止所有不希望的包， 这样做有两个不同的原因。
 	其一是恶意的包可能和某些允许的流量规则存在部分匹配， 而我们希望阻止，
 	而不是让这些包仅仅与 <literal>allow</literal> 规则部分匹配就允许它们进入。
 	其二是， 已经确信要阻止的包被拒绝这件事， 往往并不是我们需要关注的，
 	因此只要简单地予以阻止即可。
 	防火墙规则集中的每个部分的最后一条规则都是阻止并记录包，
 	这有助于为逮捕攻击者留下法律所要求的证据。</para>
 
       <para>另外一个需要注意的事情是确保系统对不希望的数据包不做回应。
 	无效的包应被丢弃和消失。 这样， 攻击者便无法知道包是否到达了您的系统。
 	攻击者对系统了解的越少， 攻陷系统所需的时间也就越多。
 	包含 <literal>log first</literal> 选项的规则只会记录它们第一次被触发时的包，
 	在例子中这个选项被用于记录 <literal>nmap OS 指纹探测</literal> 规则。
 	<package>security/nmap</package>
 	是攻击者常用的一种用于探测目标系统所用操作系统的工具。</para>
 
       <para>如果您看到了 <literal>log first</literal> 规则的日志，
 	就应该用 <command>ipfstat -hio</command> 命令来看看那个规则被匹配的次数。
 	如果数目较大， 则表示系统正在受到洪水式攻击。</para>
 
       <para>如果记录的包的端口号并不是您所知道的，
 	可以在 <filename>/etc/services</filename> 或 <uri xlink:href="http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers">http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers</uri>
 	了解端口号通常的用途。</para>
 
       <para>参考下面的网页， 了解木马使用的端口： <uri xlink:href="http://www.sans.org/security-resources/idfaq/oddports.php">http://www.sans.org/security-resources/idfaq/oddports.php</uri>。</para>
 
       <para>下面是我在自己的系统中使用的完整的， 非常安全的
 	<literal>明示允许</literal> 防火墙规则集。 直接使用这个规则集不会给您造成问题，
 	您所要做的只是注释掉那些您不需要 <literal>pass</literal>(允许通过) 的服务。</para>
 
       <para>如果在日志中发现了希望 <literal>阻止</literal> 的记录， 只需在
 	inbound 小节中增加一条阻止规则集可。</para>
 
       <para>您必须将每一个规则中的 <filename>dc0</filename>
 	替换为您系统上接入 Internet 的网络接口名称， 例如，
 	用户环境下的 PPP 应该是 <filename>tun0</filename>。</para>
 
       <para>在
 	<filename>/etc/ipf.rules</filename> 中加入下面的内容：</para>
 
       <programlisting>#################################################################
 # No restrictions on Inside LAN Interface for private network
 # Not needed unless you have LAN
 #################################################################
 
 #pass out quick on xl0 all
 #pass in quick on xl0 all
 
 #################################################################
 # No restrictions on Loopback Interface
 #################################################################
 pass in quick on lo0 all
 pass out quick on lo0 all
 
 #################################################################
 # Interface facing Public Internet (Outbound Section)
 # Match session start requests originating from behind the
 # firewall on the private network
 # or from this gateway server destined for the public Internet.
 #################################################################
 
 # Allow out access to my ISP's Domain name server.
 # xxx must be the IP address of your ISP's DNS.
 # Dup these lines if your ISP has more than one DNS server
 # Get the IP addresses from /etc/resolv.conf file
 pass out quick on dc0 proto tcp from any to xxx port = 53 flags S keep state
 pass out quick on dc0 proto udp from any to xxx port = 53 keep state
 
 # Allow out access to my ISP's DHCP server for cable or DSL networks.
 # This rule is not needed for 'user ppp' type connection to the
 # public Internet, so you can delete this whole group.
 # Use the following rule and check log for IP address.
 # Then put IP address in commented out rule &amp; delete first rule
 pass out log quick on dc0 proto udp from any to any port = 67 keep state
 #pass out quick on dc0 proto udp from any to z.z.z.z port = 67 keep state
 
 
 # Allow out non-secure standard www function
 pass out quick on dc0 proto tcp from any to any port = 80 flags S keep state
 
 # Allow out secure www function https over TLS SSL
 pass out quick on dc0 proto tcp from any to any port = 443 flags S keep state
 
 # Allow out send &amp; get email function
 pass out quick on dc0 proto tcp from any to any port = 110 flags S keep state
 pass out quick on dc0 proto tcp from any to any port = 25 flags S keep state
 
 # Allow out Time
 pass out quick on dc0 proto tcp from any to any port = 37 flags S keep state
 
 # Allow out nntp news
 pass out quick on dc0 proto tcp from any to any port = 119 flags S keep state
 
 # Allow out gateway &amp; LAN users' non-secure FTP ( both passive &amp; active modes)
 # This function uses the IP<acronym>NAT</acronym> built in FTP proxy function coded in
 # the nat rules file to make this single rule function correctly.
 # If you want to use the pkg_add command to install application packages
 # on your gateway system you need this rule.
 pass out quick on dc0 proto tcp from any to any port = 21 flags S keep state
 
 # Allow out ssh/sftp/scp (telnet/rlogin/FTP replacements)
 # This function is using SSH (secure shell)
 pass out quick on dc0 proto tcp from any to any port = 22 flags S keep state
 
 # Allow out insecure Telnet
 pass out quick on dc0 proto tcp from any to any port = 23 flags S keep state
 
 # Allow out FreeBSD CVSup
 pass out quick on dc0 proto tcp from any to any port = 5999 flags S keep state
 
 # Allow out ping to public Internet
 pass out quick on dc0 proto icmp from any to any icmp-type 8 keep state
 
 # Allow out whois from LAN to public Internet
 pass out quick on dc0 proto tcp from any to any port = 43 flags S keep state
 
 # Block and log only the first occurrence of everything
 # else that's trying to get out.
 # This rule implements the default block
 block out log first quick on dc0 all
 
 #################################################################
 # Interface facing Public Internet (Inbound Section)
 # Match packets originating from the public Internet
 # destined for this gateway server or the private network.
 #################################################################
 
 # Block all inbound traffic from non-routable or reserved address spaces
 block in quick on dc0 from 192.168.0.0/16 to any    #RFC 1918 private IP
 block in quick on dc0 from 172.16.0.0/12 to any     #RFC 1918 private IP
 block in quick on dc0 from 10.0.0.0/8 to any        #RFC 1918 private IP
 block in quick on dc0 from 127.0.0.0/8 to any       #loopback
 block in quick on dc0 from 0.0.0.0/8 to any         #loopback
 block in quick on dc0 from 169.254.0.0/16 to any    #DHCP auto-config
 block in quick on dc0 from 192.0.2.0/24 to any      #reserved for docs
 block in quick on dc0 from 204.152.64.0/23 to any   #Sun cluster interconnect
 block in quick on dc0 from 224.0.0.0/3 to any       #Class D &amp; E multicast
 
 ##### Block a bunch of different nasty things. ############
 # That I do not want to see in the log
 
 # Block frags
 block in quick on dc0 all with frags
 
 # Block short tcp packets
 block in quick on dc0 proto tcp all with short
 
 # block source routed packets
 block in quick on dc0 all with opt lsrr
 block in quick on dc0 all with opt ssrr
 
 # Block nmap OS fingerprint attempts
 # Log first occurrence of these so I can get their IP address
 block in log first quick on dc0 proto tcp from any to any flags FUP
 
 # Block anything with special options
 block in quick on dc0 all with ipopts
 
 # Block public pings
 block in quick on dc0 proto icmp all icmp-type 8
 
 # Block ident
 block in quick on dc0 proto tcp from any to any port = 113
 
 # Block all Netbios service. 137=name, 138=datagram, 139=session
 # Netbios is MS/Windows sharing services.
 # Block MS/Windows hosts2 name server requests 81
 block in log first quick on dc0 proto tcp/udp from any to any port = 137
 block in log first quick on dc0 proto tcp/udp from any to any port = 138
 block in log first quick on dc0 proto tcp/udp from any to any port = 139
 block in log first quick on dc0 proto tcp/udp from any to any port = 81
 
 # Allow traffic in from ISP's DHCP server. This rule must contain
 # the IP address of your ISP's DHCP server as it's the only
 # authorized source to send this packet type. Only necessary for
 # cable or DSL configurations. This rule is not needed for
 # 'user ppp' type connection to the public Internet.
 # This is the same IP address you captured and
 # used in the outbound section.
 pass in quick on dc0 proto udp from z.z.z.z to any port = 68 keep state
 
 # Allow in standard www function because I have apache server
 pass in quick on dc0 proto tcp from any to any port = 80 flags S keep state
 
 # Allow in non-secure Telnet session from public Internet
 # labeled non-secure because ID/PW passed over public Internet as clear text.
 # Delete this sample group if you do not have telnet server enabled.
 #pass in quick on dc0 proto tcp from any to any port = 23 flags S keep state
 
 # Allow in secure FTP, Telnet, and SCP from public Internet
 # This function is using SSH (secure shell)
 pass in quick on dc0 proto tcp from any to any port = 22 flags S keep state
 
 # Block and log only first occurrence of all remaining traffic
 # coming into the firewall. The logging of only the first
 # occurrence avoids filling up disk with Denial of Service logs.
 # This rule implements the default block.
 block in log first quick on dc0 all
 ################### End of rules file #####################################</programlisting>
     </sect2>
 
     <sect2>
       <title><acronym>NAT</acronym></title>
 
       <indexterm><primary>NAT</primary></indexterm>
 
       <indexterm>
 	<primary>IP 伪装</primary>
 
 	<see>NAT</see>
       </indexterm>
 
       <indexterm>
 	<primary>网络地址转换</primary>
 
 	<see>NAT</see>
       </indexterm>
 
       <para><acronym>NAT</acronym> 是 网络地址转换(Network Address
 	Translation) 的缩写。 对于那些熟悉 &linux; 的人来说，
 	这个概念叫做 IP 伪装 (Masquerading)； <acronym>NAT</acronym> 和 IP
 	伪装是完全一样的概念。 由
 	IPF 的 <acronym>NAT</acronym> 提供的一项功能是，
 	将防火墙后的本地局域网 (LAN) 共享一个 ISP 提供的 IP
 	地址来接入 Internet 公网。</para>
 
       <para>有些人可能会问， 为什么需要这么做。 一般而言， ISP
 	会为非商业用户提供动态的 IP 地址。 动态地址意味着每次登录到
 	ISP 都有可能得到不同的 IP 地址， 无论是采用电话拨号登录，
 	或使用 cable 以及 DSL 调制解调器的方式。 这个 IP 是您与
 	Internet 公网交互时使用的身份。</para>
 
       <para>现在考虑家中有五台 PC 需要访问
 	Internet 的情形。 您可能需要向 ISP 为每一台 PC
 	所使用的独立的 Internet 账号付费， 并且拥有五根电话线。</para>
 
       <para>有了 <acronym>NAT</acronym>， 您就只需要一个 ISP 账号，
 	然后将另外四台 PC 的网卡通过交换机连接起来，
 	并通过运行 &os; 系统的那台机器作为网关连接出去。
 	<acronym>NAT</acronym> 会自动地将每一台 PC 在内网的 LAN IP 地址，
 	在离开防火墙时转换为公网的 IP 地址。 此外， 当数据包返回时，
 	也将进行逆向的转换。</para>
 
       <para>在 IP 地址空间中， 有一些特殊的范围是保留供经过
 	<acronym>NAT</acronym> 的内网 LAN IP 地址使用的。 根据
 	RFC 1918， 可以使用下面这些 IP 范围用于内网，
 	它们不会在 Internet 公网上路由：</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="3">
 	  <colspec colwidth="1*"/>
 
 	  <colspec colwidth="1*"/>
 
 	  <colspec colwidth="1*"/>
 
 	  <tbody>
 	    <row>
 	      <entry>起始 IP <systemitem class="ipaddress">10.0.0.0</systemitem></entry>
 
 	      <entry>-</entry>
 
 	      <entry>结束 IP <systemitem class="ipaddress">10.255.255.255</systemitem></entry>
 	    </row>
 
 	    <row>
 	      <entry>起始 IP <systemitem class="ipaddress">172.16.0.0</systemitem></entry>
 
 	      <entry>-</entry>
 
 	      <entry>结束 IP <systemitem class="ipaddress">172.31.255.255</systemitem></entry>
 	    </row>
 
 	    <row>
 	      <entry>起始 IP <systemitem class="ipaddress">192.168.0.0</systemitem></entry>
 
 	      <entry>-</entry>
 
 	      <entry>结束 IP <systemitem class="ipaddress">192.168.255.255</systemitem></entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
     </sect2>
 
     <sect2>
       <title>IP<acronym>NAT</acronym></title>
 
       <indexterm>
 	<primary>NAT</primary>
 
 	<secondary>以及 IPFILTER</secondary>
       </indexterm>
 
       <indexterm><primary><command>ipnat</command></primary></indexterm>
 
       <para><acronym>NAT</acronym> 规则是通过
 	<command>ipnat</command> 命令加载的。 默认情况下，
 	<acronym>NAT</acronym> 规则会保存在
 	<filename>/etc/ipnat.rules</filename> 文件中。 请参见 &man.ipnat.1;
 	了解更多的详情。</para>
 
       <para>如果在 <acronym>NAT</acronym> 已经启动之后想要修改
 	<acronym>NAT</acronym> 规则， 可以修改保存 NAT 规则的那个文件，
 	然后在执行 <command>ipnat</command> 命令时加上 <option>-CF</option> 参数，
 	以删除在用的 <acronym>NAT</acronym> 内部规则表，
 	以及所有地址翻译表中已有的项。</para>
 
       <para>要重新加载 <acronym>NAT</acronym> 规则， 可以使用类似下面的命令：</para>
 
       <screen>&prompt.root; <userinput>ipnat -CF -f /etc/ipnat.rules</userinput></screen>
 
       <para>如果想要看看您系统上
 	<acronym>NAT</acronym> 的统计信息， 可以用下面的命令：</para>
 
       <screen>&prompt.root; <userinput>ipnat -s</userinput></screen>
 
       <para>要列出当前的 <acronym>NAT</acronym> 表的映射关系，
 	使用下面的命令：</para>
 
       <screen>&prompt.root; <userinput>ipnat -l</userinput></screen>
 
       <para>要显示详细的信息并显示与规则处理和当前的规则/表项：</para>
 
       <screen>&prompt.root; <userinput>ipnat -v</userinput></screen>
     </sect2>
 
     <sect2>
       <title>IP<acronym>NAT</acronym> 规则</title>
 
       <para><acronym>NAT</acronym> 规则非常的灵活，
 	能够适应商业用户和家庭用户的各种不同的需求。</para>
 
       <para>这里所介绍的规则语法已经被简化，
 	以适应非商用环境中的一般情况。 完整的规则语法描述，
 	请参考 &man.ipnat.5; 联机手册中的介绍。</para>
 
       <para><acronym>NAT</acronym> 规则的写法与下面的例子类似：</para>
 
       <programlisting>map <replaceable>IF</replaceable> <replaceable>LAN_IP_RANGE</replaceable> -&gt; <replaceable>PUBLIC_ADDRESS</replaceable></programlisting>
 
       <para>关键词 <literal>map</literal> 出现在规则的最前面。</para>
 
       <para>将 <replaceable>IF</replaceable> 替换为对外的网络接口名。</para>
 
       <para><replaceable>LAN_IP_RANGE</replaceable> 是内网中的客户机使用的地址范围。
 	通常情况下， 这应该是类似 <systemitem class="ipaddress">192.168.1.0/24</systemitem> 的地址。</para>
 
       <para><replaceable>PUBLIC_ADDRESS</replaceable>
 	既可以是外网的 IP 地址， 也可以是
 	<literal>0/32</literal> 这个特殊的关键字，
 	它表示分配到 <replaceable>IF</replaceable> 上的所有地址。</para>
     </sect2>
 
     <sect2>
       <title><acronym>NAT</acronym> 的工作原理</title>
 
       <para>当包从 LAN 到达防火墙， 而目的地址是公网地址时，
 	它首先会通过 outbound 过滤规则。 接下来，
 	<acronym>NAT</acronym> 会得到包， 并按自顶向下的顺序处理规则，
 	而第一个匹配的规则将生效。
 	<acronym>NAT</acronym> 接下来会根据包对应的接口名字和源
 	IP 地址检查所有的规则。 如果包和某个 <acronym>NAT</acronym>
 	规则匹配， 则会检查包的
 	(源 IP 地址， 例如， 内网的 IP 地址) 是否在
 	<acronym>NAT</acronym> 规则中箭头左侧指定的 IP 地址范围匹配。
 	如果匹配， 则包的原地址将被根据用 <literal>0/32</literal>
 	关键字指定的 IP 地址重写。
 	<acronym>NAT</acronym> 将向它的内部
 	<acronym>NAT</acronym> 表发送此地址， 这样， 当包从 Internet
 	公网中返回时， 就能够把地址映射回原先的内网 IP 地址，
 	并在随后使用过滤器规则来处理。</para>
     </sect2>
 
     <sect2>
       <title>启用 IP<acronym>NAT</acronym></title>
 
       <para>要启用 IP<acronym>NAT</acronym>， 只需在
 	<filename>/etc/rc.conf</filename> 中加入下面一些语句。</para>
 
       <para>使机器能够在不同的网络接口之间进行包的转发，
 	需要：</para>
 
       <programlisting>gateway_enable="YES"</programlisting>
 
       <para>每次开机时自动启动 IP<acronym>NAT</acronym>：</para>
 
       <programlisting>ipnat_enable="YES"</programlisting>
 
       <para>指定 IP<acronym>NAT</acronym> 规则集文件：</para>
 
       <programlisting>ipnat_rules="/etc/ipnat.rules"</programlisting>
     </sect2>
 
     <sect2>
       <title>大型 LAN 中的 <acronym>NAT</acronym></title>
 
       <para>对于在一个 LAN 中有大量 PC， 以及包含多个 LAN 的情形，
 	把所有的内网 IP 地址都映射到同一个公网 IP 上会导致资源不够的问题，
 	因为同一个端口可能在许多做了
 	<acronym>NAT</acronym> 的 LAN PC 上被多次使用， 并导致碰撞。
 	有两种方法来缓解这个难题。</para>
 
       <sect3>
 	<title>指定使用哪些端口</title>
 
 	<!-- What does it mean ? Is there something missing ?-->
 	<!-- XXXBLAH <- Apparently you can't start a sect
 	     with a <programlisting> tag ?-->
 
 	<para>普通的 NAT 规则类似于：</para>
 
 	<programlisting>map dc0 192.168.1.0/24 -&gt; 0/32</programlisting>
 
 	<para>上面的规则中， 包的源端口在包通过 IP<acronym>NAT</acronym>
 	  时时不会发生变化的。 通过使用 <literal>portmap</literal> 关键字， 您可以要求
 	  IP<acronym>NAT</acronym> 只使用指定范围内的端口地址。
 	  比如说， 下面的规则将让
 	  IP<acronym>NAT</acronym> 把源端口改为指定范围内的端口：</para>
 
 	<programlisting>map dc0 192.168.1.0/24 -&gt; 0/32 portmap tcp/udp 20000:60000</programlisting>
 
 	<para>使用
 	  <literal>auto</literal> 关键字可以让配置变得更简单一些， 它会要求
 	  IP<acronym>NAT</acronym> 自动地检测可用的端口并使用：</para>
 
 	<programlisting>map dc0 192.168.1.0/24 -&gt; 0/32 portmap tcp/udp auto</programlisting>
       </sect3>
 
       <sect3>
 	<title>使用公网地址池</title>
 
 	<para>对很大的 LAN 而言， 总有一天会达到这样一个临界值，
 	  此时的 LAN 地址已经多到了无法只用一个公网地址表现的程度。
 	  如果有可用的一块公网 IP 地址， 则可以将这些地址作为一个
 	  <quote>地址池</quote> 来使用， 让 IP<acronym>NAT</acronym>
 	  来从这些公网 IP 地址中挑选用于发包的地址，
 	  并将其为这些包创建映射关系。</para>
 
 	<para>例如， 如果将下面这个把所有包都映射到同一公网 IP 地址的规则：</para>
 
 	<programlisting>map dc0 192.168.1.0/24 -&gt; 204.134.75.1</programlisting>
 
 	<para>稍作修改， 就可以用子网掩码来表达 IP 地址范围：</para>
 
 	<programlisting>map dc0 192.168.1.0/24 -&gt; 204.134.75.0/255.255.255.0</programlisting>
 
 	<para>或者用 CIDR 记法来指定的一组地址了：</para>
 
 	<programlisting>map dc0 192.168.1.0/24 -&gt; 204.134.75.0/24</programlisting>
       </sect3>
     </sect2>
 
     <sect2>
       <title>端口重定向</title>
 
       <para>非常流行的一种做法是， 将 web 服务器、
 	邮件服务器、 数据库服务器以及 DNS 分别放到 LAN 上的不同的 PC 上。
 	这种情况下， 来自这些服务器的网络流量仍然应该被 <acronym>NAT</acronym>，
 	但必须有办法把进入的流量发到对应的局域网的
 	PC 上。 IP<acronym>NAT</acronym> 提供了 <acronym>NAT</acronym>
 	重定向机制来解决这个问题。 考虑下面的情况，
 	您的 web 服务器的 LAN 地址是 <systemitem class="ipaddress">10.0.10.25</systemitem>， 而您的唯一的公网 IP
 	地址是 <systemitem class="ipaddress">20.20.20.5</systemitem>， 则可以编写这样的规则：</para>
 
 	<programlisting>rdr dc0 20.20.20.5/32 port 80 -&gt; 10.0.10.25 port 80</programlisting>
 
 	<para>或者：</para>
 
 	<programlisting>rdr dc0 0.0.0.0/0 port 80 -&gt; 10.0.10.25 port 80</programlisting>
 
 	<para>另外， 也可以让 LAN 地址 <systemitem class="ipaddress">10.0.10.33</systemitem> 上运行的 LAN DNS 服务器来处理公网上的
 	  DNS 请求：</para>
 
 	<programlisting>rdr dc0 20.20.20.5/32 port 53 -&gt; 10.0.10.33 port 53 udp</programlisting>
     </sect2>
 
     <sect2>
       <title>FTP 和 <acronym>NAT</acronym></title>
 
       <para>FTP 是一个在 Internet 如今天这样为人所熟知之前就已经出现的恐龙，
 	那时， 研究机构和大学是通过租用的线路连到一起的， 而 FTP
 	则被用于在科研人员之间共享大文件。 那时，
 	数据的安全性并不是需要考虑的事情。 若干年之后， FTP
 	协议则被埋进了正在形成中的 Internet 骨干，
 	而它使用明文来交换用户名和口令的缺点，
 	并没有随着新出现的一些安全需求而得到改变。 FTP 提供了两种不同的风格，
 	即主动模式和被动模式。 两者的区别在于数据通道的建立方式。
 	被动模式相对而言要更加安全， 因为数据通道是由发起 ftp
 	会话的一方建立的。 关于 FTP 以及它所提供的不同模式，
 	在 <uri xlink:href="http://www.slacksite.com/other/ftp.html">http://www.slacksite.com/other/ftp.html</uri>
 	进行了很好的阐述。</para>
 
       <sect3>
 	<title>IP<acronym>NAT</acronym> 规则</title>
 
 	<para>IP<acronym>NAT</acronym> 提供了一个内建的 FTP 代理选项，
 	  它可以在 <acronym>NAT</acronym> map 规则中指定。
 	  它能够监视所有外发的 FTP 主动或被动模式的会话开始请求，
 	  并动态地创建临时性的过滤器规则， 只打开用于数据通道的端口号。
 	  这样， 就消除了 FTP 一般会给防火墙带来的，
 	  需要大范围地打开高端口所可能带来的安全隐患。</para>
 
 	<para>下面的规则可以处理来自内网的 FTP 访问：</para>
 
 	<programlisting>map dc0 10.0.10.0/29 -&gt; 0/32 proxy port 21 ftp/tcp</programlisting>
 
 	<para>这个规则能够处理来自网关的 FTP 访问：</para>
 
 	<programlisting>map dc0 0.0.0.0/0 -&gt; 0/32 proxy port 21 ftp/tcp</programlisting>
 
 	<para>这个则处理所有来自内网的非 FTP 网络流量：</para>
 
 	<programlisting>map dc0 10.0.10.0/29 -&gt; 0/32</programlisting>
 
 	<para>FTP map 规则应该在普通的 map 规则之前出现。
 	  所有的包会从最上面的第一个规则开始进行检查。
 	  匹配的顺序是网卡名称， 内网源 IP 地址， 以及它是否是 FTP 包。
 	  如果所有这些规则都匹配成功， 则 FTP
 	  代理将建立一个临时的过滤规则， 以便让 FTP 会话的数据包能够正常出入，
 	  同时对这些包进行 <acronym>NAT</acronym>。
 	  所有的 LAN 数据包， 如果没有匹配第一条规则，
 	  则会继续尝试匹配下面的规则， 并最终被
 	  <acronym>NAT</acronym>。</para>
       </sect3>
 
       <sect3>
 	<title>IP<acronym>NAT</acronym> FTP 过滤规则</title>
 
 	<para>如果使用了
 	  <acronym>NAT</acronym> FTP 代理， 则只需要为 FTP 创建一个规则。</para>
 
 	<para>如果不使用 FTP 代理， 就需要下面这三个规则：</para>
 
 	<programlisting># Allow out LAN PC client FTP to public Internet
 # Active and passive modes
 pass out quick on rl0 proto tcp from any to any port = 21 flags S keep state
 
 # Allow out passive mode data channel high order port numbers
 pass out quick on rl0 proto tcp from any to any port &gt; 1024 flags S keep state
 
 # Active mode let data channel in from FTP server
 pass in quick on rl0 proto tcp from any to any port = 20 flags S keep state</programlisting>
       </sect3>
     </sect2>
   </sect1>
 
   <sect1 xml:id="firewalls-ipfw">
     <title>IPFW</title>
 
     <indexterm>
       <primary>防火墙</primary>
 
       <secondary>IPFW</secondary>
     </indexterm>
 
     <para>IPFIREWALL (<acronym>IPFW</acronym>) 是一个由 &os; 发起的防火墙应用软件，
       它由 &os; 的志愿者成员编写和维护。
       它使用了传统的无状态规则和规则编写方式，
       以期达到简单状态逻辑所期望的目标。</para>
 
     <para>标准的 &os; 安装中， IPFW 所给出的规则集样例 (可以在
       <filename>/etc/rc.firewall</filename> 和
       <filename>/etc/rc.firewall6</filename> 中找到) 非常简单，
       建议不要不加修改地直接使用。 该样例中没有使用状态过滤，
       而该功能在大部分的配置中都是非常有用的，
       因此这一节并不以系统自带的样例作为基础。</para>
 
     <para>IPFW 的无状态规则语法， 是由一种提供复杂的选择能力的技术支持的，
       这种技术远远超出了一般的防火墙安装人员的知识水平。
       IPFW 是为满足专业用户，
       以及掌握先进技术的电脑爱好者们对于高级的包选择需求而设计的。
       要完全释放 IPFW 的规则所拥有的强大能力，
       需要对不同的协议的细节有深入的了解，
       并根据它们独特的包头信息来编写规则。
       这一级别的详细阐述超出了这本手册的范围。</para>
 
     <para>IPFW 由七个部分组成， 其主要组件是内核的防火墙过滤规则处理器，
       及其集成的数据包记帐工具、 日志工具、  用以触发
       <acronym>NAT</acronym> 工具的 <literal>divert</literal> (转发) 规则、
       高级特殊用途工具、 dummynet 流量整形机制，
       <literal>fwd rule</literal> 转发工具， 桥接工具， 以及 ipstealth 工具。
       IPFW 支持 IPv4 和 IPv6。</para>
 
     <sect2 xml:id="firewalls-ipfw-enable">
       <title>启用 IPFW</title>
 
       <indexterm>
 	<primary>IPFW</primary>
 
 	<secondary>启用</secondary>
       </indexterm>
 
       <para>IPFW 是基本的 &os; 安装的一部分， 以单独的可加载内核模块的形式提供。
 	如果在 <filename>rc.conf</filename> 中加入
 	<literal>firewall_enable="YES"</literal> 语句， 就会自动地加载对应的内核模块。
 	除非您打算使用由它提供的
 	<acronym>NAT</acronym> 功能， 一般情况下并不需要把 IPFW 编进
 	&os; 的内核。</para>
 
       <para>如果将
 	<literal>firewall_enable="YES"</literal> 加入到
 	<filename>rc.conf</filename> 中并重新启动系统，
 	则下列信息将在启动过程中， 以高亮的白色显示出来：</para>
 
       <screen>ipfw2 initialized, divert disabled, rule-based forwarding disabled, default to deny, logging disabled</screen>
 
       <para>可加载内核模块在编译时加入了记录日志的能力。 要启用日志功能，
 	并配置详细日志记录的限制， 需要在
 	<filename>/etc/sysctl.conf</filename> 中加入一些配置。
 	这些设置将在重新启动之后生效：</para>
 
       <programlisting>net.inet.ip.fw.verbose=1
 net.inet.ip.fw.verbose_limit=5</programlisting>
     </sect2>
 
     <sect2 xml:id="firewalls-ipfw-kernel">
       <title>内核选项</title>
 
       <indexterm>
 	<primary>内核选项</primary>
 
 	<secondary>IPFIREWALL</secondary>
       </indexterm>
 
       <indexterm>
 	<primary>内核选项</primary>
 
 	<secondary>IPFIREWALL_VERBOSE</secondary>
       </indexterm>
 
       <indexterm>
 	<primary>内核选项</primary>
 
 	<secondary>IPFIREWALL_VERBOSE_LIMIT</secondary>
       </indexterm>
 
       <indexterm>
 	<primary>IPFW</primary>
 
 	<secondary>内核选项</secondary>
       </indexterm>
 
       <para>把下列选项在编译 &os; 内核时就加入， 并不是启用 IPFW 所必需的，
 	除非您需要使用 <acronym>NAT</acronym> 功能。
 	这里只是将这些选项作为背景知识来介绍。</para>
 
       <programlisting>options    IPFIREWALL</programlisting>
 
       <para>这个选项将 IPFW 作为内核的一部分来启用。</para>
 
       <programlisting>options    IPFIREWALL_VERBOSE</programlisting>
 
       <para>这个选项将启用记录通过 IPFW 的匹配了包含
 	<literal>log</literal> 关键字规则的每一个包的功能。</para>
 
       <programlisting>options    IPFIREWALL_VERBOSE_LIMIT=5</programlisting>
 
       <para>以每项的方式， 限制通过 &man.syslogd.8; 记录的包的个数。
 	如果在比较恶劣的环境下记录防火墙的活动可能会需要这个选项。
 	它能够避免潜在的针对 syslog 的洪水式拒绝服务攻击。</para>
 
       <indexterm>
 	<primary>内核选项</primary>
 
 	<secondary>IPFIREWALL_DEFAULT_TO_ACCEPT</secondary>
       </indexterm>
 
       <programlisting>options    IPFIREWALL_DEFAULT_TO_ACCEPT</programlisting>
 
       <para>这个选项默认地允许所有的包通过防火墙，
 	如果您是第一次配置防火墙， 使用这个选项将是一个不错的主意。</para>
 
       <indexterm>
 	<primary>内核选项</primary>
 
 	<secondary>IPDIVERT</secondary>
       </indexterm>
 
       <programlisting>options    IPDIVERT</programlisting>
 
       <para>这一选项启用 <acronym>NAT</acronym>
 	功能。</para>
 
       <note>
 	<para>如果内核选项中没有加入
 	  <literal>IPFIREWALL_DEFAULT_TO_ACCEPT</literal>，
 	  而配置使用的规则集中也没有明确地指定允许连接进入的规则，
 	  默认情况下， 发到本机和从本机发出的所有包都会被阻止。</para>
       </note>
     </sect2>
 
     <sect2 xml:id="firewalls-ipfw-rc">
       <title><filename>/etc/rc.conf</filename> Options</title>
 
       <para>启用防火墙：</para>
 
       <programlisting>firewall_enable="YES"</programlisting>
 
       <para>要选择由 &os; 提供的几种防火墙类型中的一种来作为默认配置，
 	您需要阅读
 	<filename>/etc/rc.firewall</filename> 文件并选出合适的类型，
 	然后在 <filename>/etc/rc.conf</filename> 中加入类似下面的配置：</para>
 
       <programlisting>firewall_type="open"</programlisting>
 
       <para>您还可以指定下列配置规则之一：</para>
 
       <itemizedlist>
 	<listitem>
 	  <para><literal>open</literal> &mdash; 允许所有流量通过。</para>
 	</listitem>
 	<listitem>
 	  <para><literal>client</literal> &mdash; 只保护本机。</para>
 	</listitem>
 	<listitem>
 	  <para><literal>simple</literal> &mdash; 保护整个网络。</para>
 	</listitem>
 	<listitem>
 	  <para><literal>closed</literal> &mdash; 完全禁止除回环设备之外的全部 IP
 	    流量。</para>
 	</listitem>
 	<listitem>
 	  <para><literal>UNKNOWN</literal> &mdash; 禁止加载防火墙规则。</para>
 	</listitem>
 	<listitem>
 	  <para><filename>filename</filename> &mdash; 到防火墙规则文件的绝对路径。</para>
 	</listitem>
       </itemizedlist>
 
       <para>有两种加载自定义 <application>ipfw</application> 防火墙规则的方法。
 	其一是将变量 <literal>firewall_type</literal> 设为包含不带 &man.ipfw.8;
 	命令行选项的 <emphasis>防火墙规则</emphasis>
 	文件的完整路径。 下面是一个简单的规则集例子：</para>
 
      <programlisting>add deny in
 add deny out</programlisting>
 
      <para>除此之外， 也可以将
 	<literal>firewall_script</literal> 变量设为包含
 	<command>ipfw</command> 命令的可执行脚本，
 	这样这个脚本会在启动时自动执行。 与前面规则集文件等价的规则脚本如下：</para>
 
       <para><command>ipfw</command> 命令是在防火墙运行时，
 	用于在其内部规则表中手工逐条添加或删除防火墙规则的标准工具。
 	这一方法的问题在于， 一旦您的关闭计算机或停机，
 	则所有增加或删除或修改的规则也就丢掉了。
 	把所有的规则都写到一个文件中， 并在启动时使用这个文件来加载规则，
 	或一次大批量地替换防火墙规则， 那么推荐使用这里介绍的方法。</para>
 
       <para><command>ipfw</command> 的另一个非常实用的功能是将所有正在运行的防火墙规则显示出来。
 	IPFW 的记账机制会为每一个规则动态地创建计数器，
 	用以记录与它们匹配的包的数量。 在测试规则的过程中，
 	列出规则及其计数器是了解它们是否工作正常的重要手段。</para>
 
       <para>按顺序列出所有的规则：</para>
 
       <screen>&prompt.root; <userinput>ipfw list</userinput></screen>
 
       <para>列出所有的规则， 同时给出最后一次匹配的时间戳：</para>
 
       <screen>&prompt.root; <userinput>ipfw -t list</userinput></screen>
 
       <para>列出所有的记账信息、 匹配规则的包的数量， 以及规则本身。
 	第一列是规则的编号， 随后是发出包匹配的数量， 进入包的匹配数量，
 	最后是规则本身。</para>
 
       <screen>&prompt.root; <userinput>ipfw -a list</userinput></screen>
 
       <para>列出所有的动态规则和静态规则：</para>
 
       <screen>&prompt.root; <userinput>ipfw -d list</userinput></screen>
 
       <para>同时显示已过期的动态规则：</para>
 
       <screen>&prompt.root; <userinput>ipfw -d -e list</userinput></screen>
 
       <para>将计数器清零：</para>
 
       <screen>&prompt.root; <userinput>ipfw zero</userinput></screen>
 
       <para>只把规则号为
 	<replaceable>NUM</replaceable> 的计数器清零：</para>
 
       <screen>&prompt.root; <userinput>ipfw zero NUM</userinput></screen>
     </sect2>
 
     <sect2 xml:id="firewalls-ipfw-rules">
       <title>IPFW 规则集</title>
 
       <!-- This has already appeared once -->
 
       <para>规则集是指一组编写好的依据包的值决策允许通过或阻止 IPFW 规则。
 	包的双向交换组成了一个会话交互。 防火墙规则集会作用于来自于
 	Internet 公网的包以及由系统发出来回应这些包的数据包。
 	每一个 <acronym>TCP/IP</acronym> 服务 (例如 telnet, www,
 	邮件等等) 都由协议预先定义了其特权 (监听) 端口。
 	发到特定服务的包会从源地址使用非特权 (高编号) 端口发出，
 	并发到特定服务在目的地址的对应端口。
 	所有这些参数 (例如： 端口和地址）
 	都是可以为防火墙规则所利用的， 判别是否允许服务通过的标准。</para>
 
       <indexterm>
 	<primary>IPFW</primary>
 
 	<secondary>规则处理顺序</secondary>
       </indexterm>
 
       <!-- Needs rewording to include note below -->
 
       <para>当有数据包进入防火墙时， 会从规则集里的第一个规则开始进行比较，
 	并自顶向下地进行匹配。 当包与某个选择规则参数相匹配时，
 	将会执行规则所定义的动作， 并停止规则集搜索。 这种策略，
 	通常也被称作 <quote>最先匹配者获胜</quote> 的搜索方法。
 	如果没有任何与包相匹配的规则， 那么它就会根据强制的 IPFW
 	默认规则， 也就是 65535 号规则截获。 一般情况下这个规则是阻止包，
 	而且不给出任何回应。</para>
 
       <note>
 	<para>如果规则定义的动作是 <literal>count</literal>、
 	  <literal>skipto</literal> 或 <literal>tee</literal>
 	  规则的话， 搜索会继续。</para>
       </note>
 
       <para>这里所介绍的规则， 都是使用了那些包含状态功能的，
 	也就是 <literal>keep state</literal>、 <literal>limit</literal>、 <literal>in</literal>、 <literal>out</literal>
 	以及 <literal>via</literal> 选项的规则。
 	这是编写明示允许防火墙规则集所需的基本框架。</para>
 
       <warning>
 	<para>在操作防火墙规则时应谨慎行事， 如果操作不当，
 	  很容易将自己反锁在外面。</para>
       </warning>
 
       <sect3 xml:id="firewalls-ipfw-rules-syntax">
 	<title>规则语法</title>
 
 	<indexterm>
 	  <primary>IPFW</primary>
 
 	  <secondary>规则语法</secondary>
 	</indexterm>
 
 	<para>这里所介绍的规则语法已经经过了简化，
 	  只包括了建立标准的明示允许防火墙规则集所必需的那些。
 	  要了解完整的规则语法说明，
 	  请参见 &man.ipfw.8; 联机手册。</para>
 
 	<para>规则是由关键字组成的： 这些关键字必须以特定的顺序从左到右书写。
 	  下面的介绍中， 关键字使用粗体表示。 某些关键字还包括了子选项，
 	  这些子选项本身可能也是关键字， 有些还可以包含更多的子选项。</para>
 
 	<para><literal>#</literal> 用于表示开始一段注释。
 	  它可以出现在一个规则的后面， 也可以独占一行。
 	  空行会被忽略。</para>
 
 	<para><replaceable>CMD RULE_NUMBER ACTION LOGGING SELECTION
 	    STATEFUL</replaceable></para>
 
 	<sect4>
 	  <title>CMD</title>
 
 	  <para>每一个新的规则都应以
 	    <parameter>add</parameter> 作为前缀， 它表示将规则加入内部表。</para>
 	</sect4>
 
 	<sect4>
 	  <title>RULE_NUMBER</title>
 
 	  <para>每一条规则都与一个范围在 1 到 65535 之间的规则编号相关联。</para>
 	</sect4>
 
 	<sect4>
 	  <title>ACTION</title>
 
 	  <para>每一个规则可以与下列的动作之一相关联，
 	    所指定的动作将在进入的数据包与规则所指定的选择标准相匹配时执行。</para>
 
 	  <para><parameter>allow | accept | pass |
 	      permit</parameter></para>
 
 	  <para>这些关键字都表示允许匹配规则的包通过防火墙，
 	    并停止继续搜索规则。</para>
 
 	  <para><parameter>check-state</parameter></para>
 
 	  <para>根据动态规则表检查数据包。 如果匹配，
 	    则执行规则所指定的动作， 亦即生成动态规则；
 	    否则， 转移到下一个规则。 check-state 规则没有选择标准。
 	    如果规则集中没有 check-state 规则，
 	    则会在第一个 keep-state 或 limit 规则处，
 	    对动态规则表实施检查。</para>
 
 	  <para><parameter>deny | drop</parameter></para>
 
 	  <para>这两个关键字都表示丢弃匹配规则的包。
 	    同时， 停止继续搜索规则。</para>
 	</sect4>
 
 	<sect4>
 	  <title>LOGGING</title>
 
 	  <para><parameter>log</parameter> or
 	    <parameter>logamount</parameter></para>
 
 	  <para>当数据包与带 <literal>log</literal> 关键字的规则匹配时，
 	    将通过名为 SECURITY 的 facility 来把消息记录到 &man.syslogd.8;。
 	    只有在记录的次数没有超过 logamount 参数所指定的次数时，
 	    才会记录日志。 如果没有指定 <literal>logamount</literal>，
 	    则会以 sysctl 变量
 	    <literal>net.inet.ip.fw.verbose_limit</literal> 所指定的限制为准。
 	    如果将这两种限制值之一指定为零， 则表示不作限制。
 	    如果达到了限制数，
 	    可以通过将规则的日志计数或包计数清零来重新启用日志，
 	    请参见 <command>ipfw reset log</command> 命令来了解细节。</para>
 
 	  <note>
 	    <para>日志是在所有其他匹配条件都验证成功之后，
 	      在针对包实施最终动作 (accept, deny) 之前进行的。
 	      您可以自行决定哪些规则应启用日志。</para>
 	    </note>
 	</sect4>
 
 	<sect4>
 	  <title>SELECTION</title>
 
 	  <para>这一节所介绍的关键字主要用来描述检查包的哪些属性，
 	    用以判断包是否与规则相匹配。
 	    下面是一些通用的用于匹配包特征的属性，
 	    它们必须按顺序使用：</para>
 
 	  <para><parameter>udp | tcp | icmp</parameter></para>
 
 	  <para>也可以指定在
 	    <filename>/etc/protocols</filename> 中所定义的协议。
 	    这个值定义的是匹配的协议， 在规则中必须指定它。</para>
 
 	  <para><parameter>from src to dst</parameter></para>
 
 	  <para><literal>from</literal> 和 <literal>to</literal> 关键字用于匹配 IP
 	    地址。 规则中必须 <emphasis>同时</emphasis> 指定源和目的两个参数。
 	    如果需要匹配任意 IP 地址，
 	    可以使用特殊关键字 <literal>any</literal>。
 	    还有一个特殊关键字， 即 <literal>me</literal>，
 	    用于匹配您的 &os; 系统上所有网络接口上所配置的 IP 地址，
 	    它可以用于表达网络上的其他计算机到防火墙 (也就是本机)，
 	    例如 <literal>from me to any</literal> 或 <literal>from any to me</literal> 或 <literal>from 0.0.0.0/0 to any</literal> 或
 	    <literal>from any to 0.0.0.0/0</literal> 或 <literal>from 0.0.0.0 to any</literal> 或 <literal>from
 	    any to 0.0.0.0</literal> 以及 <literal>from me to 0.0.0.0</literal>。 IP
 	    地址可以通过 带点的 IP 地址/掩码长度 (CIDR 记法)，
 	    或者一个带点的 IP 地址的形式来指定。
 	    这是编写规则时所必需的。 使用 <package>net-mgmt/ipcalc</package> port 可以用来简化计算。
 	    关于这个工具的更多信息， 也可参考它的主页： <uri xlink:href="http://jodies.de/ipcalc">http://jodies.de/ipcalc</uri>。</para>
 
 	  <para><parameter>port number</parameter></para>
 
 	  <para>这个参数主要用于那些支持端口号的协议 (例如
 	    <acronym>TCP</acronym> 和 <acronym>UDP</acronym>)。 如果要通过端口号匹配某个协议，
 	    就必须指定这个参数。 此外， 也可以通过服务的名字 (根据
 	    <filename>/etc/services</filename>) 来指定服务，
 	    这样会比使用数字指定端口号直观一些。</para>
 
 	  <para><parameter>in | out</parameter></para>
 
 	  <para>相应地， 匹配进入和发出的包。
 	    这里的 <literal>in</literal> 和 <literal>out</literal> 都是关键字， 在编写匹配规则时，
 	    必需作为其他条件的一部分来使用。</para>
 
 	  <para><parameter>via IF</parameter></para>
 
 	  <para>根据指定的网络接口的名称精确地匹配进出的包。
 	    这里的 <literal>via</literal>
 	    关键字将使得接口名称成为匹配过程的一部分。</para>
 
 	  <para><parameter>setup</parameter></para>
 
 	  <para>要匹配 <acronym>TCP</acronym> 会话的发起请求，
 	    就必须使用它。</para>
 
 	  <para><parameter>keep-state</parameter></para>
 
 	  <para>这是一个必须使用的关键字。 在发生匹配时，
 	    防火墙将创建一个动态规则， 其默认行为是，
 	    匹配使用同一协议的、从源到目的 IP/端口 的双向网络流量。</para>
 
 	  <para><parameter>limit {src-addr | src-port | dst-addr |
 	      dst-port}</parameter></para>
 
 	  <para>防火墙只允许匹配规则时， 与指定的参数相同的
 	    <replaceable>N</replaceable> 个连接。
 	    可以指定至少一个源或目的地址及端口。
 	    <literal>limit</literal> 和 <literal>keep-state</literal> 不能在同一规则中同时使用。
 	    <literal>limit</literal> 提供了与 <literal>keep-state</literal> 相同的功能，
 	    并增加了一些独有的能力。</para>
 	</sect4>
       </sect3>
 
       <sect3>
 	<title>状态规则选项</title>
 
 	<indexterm>
 	  <primary>IPFW</primary>
 
 	  <secondary>带状态过滤</secondary>
 	</indexterm>
 
 	<!-- XXX: duplicated -->
 
 	<para>有状态过滤将网络流量当作一种双向的包交换来处理。
 	  它提供了一种额外的检查能力，
 	  用以检测会话中的包是否来自最初的发送者，
 	  并在遵循双向包交换的规则进行会话。
 	  如果包与这些规则不符， 则将自动地拒绝它们。</para>
 
 	<para><literal>check-state</literal> 用来识别在 IPFW
 	  规则集中的包是否符合动态规则机制的规则。
 	  如果匹配， 则允许包通过，
 	  此时防火墙将创建一个新的动态规则来匹配双向交换中的下一个包。
 	  如果不匹配， 则将继续尝试规则集中的下一个规则。</para>
 
 	<para>动态规则机制在 SYN-flood 攻击下是脆弱的，
 	  因为这种情况会产生大量的动态规则， 从而耗尽资源。
 	  为了抵抗这种攻击， 从 &os; 中加入了一个叫做 <literal>limit</literal>
 	  的新选项。
 	  这个选项可以用来限制符合规则的会话允许的并发连接数。
 	  如果动态规则表中的规则数超过 <literal>limit</literal> 的限制数量，
 	  则包将被丢弃。</para>
       </sect3>
 
       <sect3>
 	<title>记录防火墙消息</title>
 
 	<indexterm>
 	  <primary>IPFW</primary>
 
 	  <secondary>记录日志</secondary>
 	</indexterm>
 
 	<para>记录日志的好处是显而易见的： 它提供了在事后检查所发生的状况的方法，
 	  例如哪些包被丢弃了， 这些包的来源和目的地，
 	  从而为您提供找到攻击者所需的证据。</para>
 
 	<para>即使启用了日志机制， IPFW 也不会自行生成任何规则的日志。
 	  防火墙管理员需要指定规则集中的哪些规则应该记录日志，
 	  并在这些规则上增加 <literal>log</literal> 动作。 一般来说， 只有
 	  deny 规则应记录日志， 例如对于进入的
 	  <acronym>ICMP</acronym> ping 的 deny 规则。 另外，
 	  复制 <quote>默认的 ipfw 终极 deny 规则</quote>， 并加入 <literal>log</literal>
 	  动作来作为您的规则集的最后一条规则也是很常见的用法。
 	  这样， 您就能看到没有匹配任何一条规则的那些数据包。</para>
 
 	<para>日志是一把双刃剑， 如果不谨慎地加以利用，
 	  则可能会陷入过多的日志数据中， 并导致磁盘被日志塞满。
 	  将磁盘填满是 DoS 攻击最为老套的手法之一。
 	  由于 <application>syslogd</application> 除了会将日志写入磁盘之外，
 	  还会输出到 root 的控制台屏幕上，
 	  因此有过多的日志信息是很让人恼火的事情。</para>
 
 	<para><literal>IPFIREWALL_VERBOSE_LIMIT=5</literal>
 	  内核选项将限制同一个规则发到系统日志程序 &man.syslogd.8; 的连续消息的数量。
 	  当内核启用了这个选项时，
 	  某一特定规则所产生的连续消息的数量将封顶为这个数字。
 	  一般来说， 没有办法从连续 200 条一模一样的日志信息中获取更多有用的信息。
 	  举例来说， 如果同一个规则产生了 5 次消息并被记录到
 	  <application>syslogd</application>， 余下的相同的消息将被计数，
 	  并像下面这样发给 <application>syslogd</application>：</para>
 
 	<programlisting>last message repeated 45 times</programlisting>
 
 	<para>所有记录的数据包包消息， 默认情况下会最终写到
 	  <filename>/var/log/security</filename> 文件中，
 	  后者在 <filename>/etc/syslog.conf</filename> 文件里进行了定义。</para>
       </sect3>
 
       <sect3 xml:id="firewalls-ipfw-rules-script">
 	<title>编写规则脚本</title>
 
 	<para>绝大多数有经验的 IPFW 用户会创建一个包含规则的文件，
 	  并且， 按能够以脚本形式运行的方式来书写。 这样做最大的一个好处是，
 	  可以大批量地刷新防火墙规则， 而无须重新启动系统就能够激活它们。
 	  这种方法在测试新规则时会非常方便，
 	  因为同一过程在需要时可以多次执行。
 	  作为脚本， 您可以使用符号替换来撰写那些经常需要使用的值，
 	  并用同一个符号在多个规则中反复地表达它。
 	  下面将给出一个例子。</para>
 
 	<para>这个脚本使用的语法同 &man.sh.1;、
 	  &man.csh.1; 以及 &man.tcsh.1; 脚本兼容。 符号替换字段使用美元符号 &dollar;
 	  作为前缀。 符号字段本身并不使用 &dollar; 前缀。
 	  符号替换字段的值必须使用 "双引号" 括起来。</para>
 
 	<para>可以使用类似下面的规则文件：</para>
 
 	<programlisting>############### start of example ipfw rules script #############
 #
 ipfw -q -f flush       # Delete all rules
 # Set defaults
 oif="tun0"             # out interface
 odns="192.0.2.11"      # ISP's DNS server IP address
 cmd="ipfw -q add "     # build rule prefix
 ks="keep-state"        # just too lazy to key this each time
 &dollar;cmd 00500 check-state
 &dollar;cmd 00502 deny all from any to any frag
 &dollar;cmd 00501 deny tcp from any to any established
 &dollar;cmd 00600 allow tcp from any to any 80 out via &dollar;oif setup &dollar;ks
 &dollar;cmd 00610 allow tcp from any to &dollar;odns 53 out via &dollar;oif setup &dollar;ks
 &dollar;cmd 00611 allow udp from any to &dollar;odns 53 out via &dollar;oif &dollar;ks
 ################### End of example ipfw rules script ############</programlisting>
 
 	<para>这就是所要做的全部事情了。 例子中的规则并不重要，
 	  它们主要是用来表示如何使用符号替换。</para>
 
 	<para>如果把上面的例子保存到
 	  <filename>/etc/ipfw.rules</filename> 文件中。
 	  下面的命令来会重新加载规则。</para>
 
 	<screen>&prompt.root; <userinput>sh /etc/ipfw.rules</userinput></screen>
 
 	<para><filename>/etc/ipfw.rules</filename> 这个文件可以放到任何位置，
 	  也可以命名为随便什么别的名字。</para>
 
 	<para>也可以手工执行下面的命令来达到类似的目的：</para>
 
 	<screen>&prompt.root; <userinput>ipfw -q -f flush</userinput>
 &prompt.root; <userinput>ipfw -q add check-state</userinput>
 &prompt.root; <userinput>ipfw -q add deny all from any to any frag</userinput>
 &prompt.root; <userinput>ipfw -q add deny tcp from any to any established</userinput>
 &prompt.root; <userinput>ipfw -q add allow tcp from any to any 80 out via tun0 setup keep-state</userinput>
 &prompt.root; <userinput>ipfw -q add allow tcp from any to 192.0.2.11 53 out via tun0 setup keep-state</userinput>
 &prompt.root; <userinput>ipfw -q add 00611 allow udp from any to 192.0.2.11 53 out via tun0 keep-state</userinput></screen>
       </sect3>
 
       <sect3>
 	<title>带状态规则集</title>
 
 	<para>以下的这组非-<acronym>NAT</acronym> 规则集，
 	  是如何编写非常安全的 '明示允许' 防火墙的一个例子。
 	  明示允许防火墙只允许匹配了 pass 规则的包通过，
 	  而默认阻止所有的其他数据包。
 	  用来保护整个网段的防火墙， 至少需要有两个网络接口，
 	  并且其上必须配置规则， 以便让防火墙正常工作。</para>
 
 	<para>所有类 &unix; 操作系统， 也包括 &os;，
 	  都设计为允许使用网络接口 <filename>lo0</filename> 和 IP
 	  地址 <systemitem class="ipaddress">127.0.0.1</systemitem> 来完成操作系统内部的通讯。
 	  防火墙必须包含一组规则， 使这些数据包能够无障碍地收发。</para>
 
 	<para>接入 Internet 公网的那个网络接口上，
 	  应该配置授权和访问控制， 来限制对外的访问， 以及来自 Internet
 	  公网的访问。 这个接口很可能是您的用户态
 	  <acronym>PPP</acronym> 接口， 例如
 	  <filename>tun0</filename>， 或者您接在 DSL 或电缆 modem
 	  上的网卡。</para>
 
 	<para>如果有至少一个网卡接入了防火墙后的内网 LAN，
 	  则必须为这些接口配置规则，
 	  以便让这些接口之间的包能够顺畅地通过。</para>
 
 	<para>所有的规则应被组织为三个部分， 所有应无阻碍地通过的规则，
 	  公网的发出规则， 以及公网的接收规则。</para>
 
 	<para>公网接口相关的规则的顺序，
 	  应该是最经常用到的放在尽可能靠前的位置，
 	  而最后一个规则， 则应该是阻止那个接口在那一方向上的包。</para>
 
 	<para>发出部分的规则只包含一些 <literal>allow</literal> 规则，
 	  允许选定的那些唯一区分协议的端口号所指定的协议通过，
 	  以允许访问 Internet 公网上的这些服务。
 	  所有的规则中都指定了 <literal>proto</literal>、 <literal>port</literal>、
 	  <literal>in/out</literal>、 <literal>via</literal> 以及 <literal>keep state</literal> 这些选项。 <literal>proto tcp</literal>
 	  规则同时指定 <literal>setup</literal> 选项， 来区分开始协议会话的包，
 	  以触发将包放入
 	  keep state 规则表中的动作。</para>
 
 	<para>接收部分则首先阻止所有不希望的包， 这样做有两个不同的原因。
 	  其一是恶意的包可能和某些允许的流量规则存在部分匹配， 而我们希望阻止，
 	  而不是让这些包仅仅与 <literal>allow</literal> 规则部分匹配就允许它们进入。
 	  其二是， 已经确信要阻止的包被拒绝这件事， 往往并不是我们需要关注的，
 	  因此只要简单地予以阻止即可。
 	  防火墙规则集中的每个部分的最后一条规则都是阻止并记录包，
 	  这有助于为逮捕攻击者留下法律所要求的证据。</para>
 
 	<para>另外一个需要注意的事情是确保系统对不希望的数据包不做回应。
 	  无效的包应被丢弃和消失。 这样， 攻击者便无法知道包是否到达了您的系统。
 	  攻击者对系统了解的越少， 其攻击的难度也就越大。 如果不知道端口号，
 	  可以查阅 <filename>/etc/services/</filename> 或到 <uri xlink:href="http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers">http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers</uri>
 	  并查找一下端口号， 以了解其用途。 另外，
 	  您也可以在这个网页上了解常见木马所使用的端口： <uri xlink:href="http://www.sans.org/security-resources/idfaq/oddports.php">http://www.sans.org/security-resources/idfaq/oddports.php</uri>。</para>
       </sect3>
 
       <sect3>
 	<title>明示允许规则集的例子</title>
 
 	<para>下面是一个非-<acronym>NAT</acronym> 的规则集，
 	  它是一个完整的明示允许规则集。 使用它作为您的规则集不会有什么问题。
 	  只需把那些不需要的服务对应的 pass 规则注释掉就可以了。
 	  如果您在日志中看到消息， 而且不想再看到它们，
 	  只需在接收部分增加一个一个 <literal>deny</literal> 规则。
 	  您可能需要把 <filename>dc0</filename> 改为接入公网的接口的名字。
 	  对于使用用户态 <acronym>PPP</acronym> 的用户而言， 应该是
 	  <filename>tun0</filename>。</para>
 
 	<para>这些规则遵循一定的模式。</para>
 
 	<itemizedlist>
 	  <listitem>
 	    <para>所有请求 Internet 公网上服务的会话开始包，
 	      都使用了 <literal>keep-state</literal>。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>所有来自 Internet 的授权服务请求，
 	      都采用了 <literal>limit</literal> 选项来防止洪水式攻击。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>所有的规则都使用了 <literal>in</literal> 或者 <literal>out</literal> 来说明方向。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>所有的规则都使用了 <literal>via</literal> <replaceable>接口名</replaceable>
 	      来指定应该匹配通过哪一个接口的包。</para>
 	  </listitem>
 	</itemizedlist>
 
 	<para>这些规则都应放到
 	  <filename>/etc/ipfw.rules</filename>。</para>
 
 	<programlisting>################ Start of IPFW rules file ###############################
 # Flush out the list before we begin.
 ipfw -q -f flush
 
 # Set rules command prefix
 cmd="ipfw -q add"
 pif="dc0"     # public interface name of NIC
               # facing the public Internet
 
 #################################################################
 # No restrictions on Inside LAN Interface for private network
 # Not needed unless you have LAN.
 # Change xl0 to your LAN NIC interface name
 #################################################################
 #&dollar;cmd 00005 allow all from any to any via xl0
 
 #################################################################
 # No restrictions on Loopback Interface
 #################################################################
 &dollar;cmd 00010 allow all from any to any via lo0
 
 #################################################################
 # Allow the packet through if it has previous been added to the
 # the "dynamic" rules table by a allow keep-state statement.
 #################################################################
 &dollar;cmd 00015 check-state
 
 #################################################################
 # Interface facing Public Internet (Outbound Section)
 # Interrogate session start requests originating from behind the
 # firewall on the private network or from this gateway server
 # destined for the public Internet.
 #################################################################
 
 # Allow out access to my ISP's Domain name server.
 # x.x.x.x must be the IP address of your ISP.s DNS
 # Dup these lines if your ISP has more than one DNS server
 # Get the IP addresses from /etc/resolv.conf file
 &dollar;cmd 00110 allow tcp from any to x.x.x.x 53 out via &dollar;pif setup keep-state
 &dollar;cmd 00111 allow udp from any to x.x.x.x 53 out via &dollar;pif keep-state
 
 # Allow out access to my ISP's DHCP server for cable/DSL configurations.
 # This rule is not needed for .user ppp. connection to the public Internet.
 # so you can delete this whole group.
 # Use the following rule and check log for IP address.
 # Then put IP address in commented out rule &amp; delete first rule
 &dollar;cmd 00120 allow log udp from any to any 67 out via &dollar;pif keep-state
 #&dollar;cmd 00120 allow udp from any to x.x.x.x 67 out via &dollar;pif keep-state
 
 # Allow out non-secure standard www function
 &dollar;cmd 00200 allow tcp from any to any 80 out via &dollar;pif setup keep-state
 
 # Allow out secure www function https over TLS SSL
 &dollar;cmd 00220 allow tcp from any to any 443 out via &dollar;pif setup keep-state
 
 # Allow out send &amp; get email function
 &dollar;cmd 00230 allow tcp from any to any 25 out via &dollar;pif setup keep-state
 &dollar;cmd 00231 allow tcp from any to any 110 out via &dollar;pif setup keep-state
 
 # Allow out FBSD (make install &amp; CVSUP) functions
 # Basically give user root "GOD" privileges.
 &dollar;cmd 00240 allow tcp from me to any out via &dollar;pif setup keep-state uid root
 
 # Allow out ping
 &dollar;cmd 00250 allow icmp from any to any out via &dollar;pif keep-state
 
 # Allow out Time
 &dollar;cmd 00260 allow tcp from any to any 37 out via &dollar;pif setup keep-state
 
 # Allow out nntp news (i.e., news groups)
 &dollar;cmd 00270 allow tcp from any to any 119 out via &dollar;pif setup keep-state
 
 # Allow out secure FTP, Telnet, and SCP
 # This function is using SSH (secure shell)
 &dollar;cmd 00280 allow tcp from any to any 22 out via &dollar;pif setup keep-state
 
 # Allow out whois
 &dollar;cmd 00290 allow tcp from any to any 43 out via &dollar;pif setup keep-state
 
 # deny and log everything else that.s trying to get out.
 # This rule enforces the block all by default logic.
 &dollar;cmd 00299 deny log all from any to any out via &dollar;pif
 
 #################################################################
 # Interface facing Public Internet (Inbound Section)
 # Check packets originating from the public Internet
 # destined for this gateway server or the private network.
 #################################################################
 
 # Deny all inbound traffic from non-routable reserved address spaces
 &dollar;cmd 00300 deny all from 192.168.0.0/16 to any in via &dollar;pif  #RFC 1918 private IP
 &dollar;cmd 00301 deny all from 172.16.0.0/12 to any in via &dollar;pif     #RFC 1918 private IP
 &dollar;cmd 00302 deny all from 10.0.0.0/8 to any in via &dollar;pif          #RFC 1918 private IP
 &dollar;cmd 00303 deny all from 127.0.0.0/8 to any in via &dollar;pif        #loopback
 &dollar;cmd 00304 deny all from 0.0.0.0/8 to any in via &dollar;pif            #loopback
 &dollar;cmd 00305 deny all from 169.254.0.0/16 to any in via &dollar;pif   #DHCP auto-config
 &dollar;cmd 00306 deny all from 192.0.2.0/24 to any in via &dollar;pif       #reserved for docs
 &dollar;cmd 00307 deny all from 204.152.64.0/23 to any in via &dollar;pif  #Sun cluster interconnect
 &dollar;cmd 00308 deny all from 224.0.0.0/3 to any in via &dollar;pif         #Class D &amp; E multicast
 
 # Deny public pings
 &dollar;cmd 00310 deny icmp from any to any in via &dollar;pif
 
 # Deny ident
 &dollar;cmd 00315 deny tcp from any to any 113 in via &dollar;pif
 
 # Deny all Netbios service. 137=name, 138=datagram, 139=session
 # Netbios is MS/Windows sharing services.
 # Block MS/Windows hosts2 name server requests 81
 &dollar;cmd 00320 deny tcp from any to any 137 in via &dollar;pif
 &dollar;cmd 00321 deny tcp from any to any 138 in via &dollar;pif
 &dollar;cmd 00322 deny tcp from any to any 139 in via &dollar;pif
 &dollar;cmd 00323 deny tcp from any to any 81 in via &dollar;pif
 
 # Deny any late arriving packets
 &dollar;cmd 00330 deny all from any to any frag in via &dollar;pif
 
 # Deny ACK packets that did not match the dynamic rule table
 &dollar;cmd 00332 deny tcp from any to any established in via &dollar;pif
 
 # Allow traffic in from ISP's DHCP server. This rule must contain
 # the IP address of your ISP.s DHCP server as it.s the only
 # authorized source to send this packet type.
 # Only necessary for cable or DSL configurations.
 # This rule is not needed for .user ppp. type connection to
 # the public Internet. This is the same IP address you captured
 # and used in the outbound section.
 #&dollar;cmd 00360 allow udp from any to x.x.x.x 67 in via &dollar;pif keep-state
 
 # Allow in standard www function because I have apache server
 &dollar;cmd 00400 allow tcp from any to me 80 in via &dollar;pif setup limit src-addr 2
 
 # Allow in secure FTP, Telnet, and SCP from public Internet
 &dollar;cmd 00410 allow tcp from any to me 22 in via &dollar;pif setup limit src-addr 2
 
 # Allow in non-secure Telnet session from public Internet
 # labeled non-secure because ID &amp; PW are passed over public
 # Internet as clear text.
 # Delete this sample group if you do not have telnet server enabled.
 &dollar;cmd 00420 allow tcp from any to me 23 in via &dollar;pif setup limit src-addr 2
 
 # Reject &amp; Log all incoming connections from the outside
 &dollar;cmd 00499 deny log all from any to any in via &dollar;pif
 
 # Everything else is denied by default
 # deny and log all packets that fell through to see what they are
 &dollar;cmd 00999 deny log all from any to any
 ################ End of IPFW rules file ###############################</programlisting>
       </sect3>
 
       <sect3>
 	<title>一个 <acronym>NAT</acronym> 和带状态规则集的例子</title>
 
 	<indexterm>
 	  <primary>NAT</primary>
 
 	  <secondary>以及 IPFW</secondary>
 	</indexterm>
 
 	<para>要使用 IPFW 的 <acronym>NAT</acronym> 功能， 还需要进行一些额外的配置。
 	  除了其他 IPFIREWALL 语句之外，
 	  还需要在内核编译配置中加上 <literal>option IPDIVERT</literal> 语句。</para>
 
 	<para>在
 	  <filename>/etc/rc.conf</filename> 中， 除了普通的 IPFW 配置之外，
 	  还需要加入：</para>
 
 	<programlisting>natd_enable="YES"                   # Enable <acronym>NAT</acronym>D function
 natd_interface="rl0"                # interface name of public Internet NIC
 natd_flags="-dynamic -m"            # -m = preserve port numbers if possible</programlisting>
 
 	<para>将带状态规则与 <literal>divert natd</literal> 规则 (网络地址转换)
 	  会使规则集的编写变得非常复杂。 <literal>check-state</literal> 的位置，
 	  以及 <literal>divert natd</literal> 规则将变得非常关键。 这样一来，
 	  就不再有简单的顺序处理逻辑流程了。 提供了一种新的动作类型， 称为
 	  <literal>skipto</literal>。 要使用 <literal>skipto</literal> 命令，
 	  就必须给每一个规则进行编号， 以确定
 	  <literal>skipto</literal> 规则号是您希望跳转到的位置。</para>
 
 	<para>下面给出了一些未加注释的例子来说明如何编写这样的规则，
 	  用以帮助您理解包处理规则集的处理顺序。</para>
 
 	<para>处理流程从规则文件最上边的第一个规则开始处理，
 	  并自顶向下地尝试每一个规则， 直到找到匹配的规则，
 	  且数据包从防火墙中放出为止。 请注意规则号 100 101，
 	  450， 500， 以及 510 的位置非常重要。
 	  这些规则控制发出和接收的包的地址转换过程，
 	  这样它们在 keep-state 动态表中的对应项中就能够与内网的
 	  LAN IP 地址关联。 另一个需要注意的是， 所有的 allow
 	  和 deny 规则都指定了包的方向 (也就是 outbound 或 inbound)
 	  以及网络接口。 最后， 请注意所有发出的会话请求都会请求
 	  <literal>skipto rule 500</literal> 以完成网络地址转换。</para>
 
 	<para>下面以 LAN 用户使用 web 浏览器访问一个 web 页面为例。
 	  Web 页面使用 80 来完成通讯。 当包进入防火墙时，
 	  规则 100 并不匹配， 因为它是发出而不是收到的包。
 	  它能够通过规则 101， 因为这是第一个包，
 	  因而它还没有进入动态状态保持表。
 	  包最终到达规则 125， 并匹配该规则。
 	  最终， 它会通过接入 Internet 公网的网卡发出。
 	  这之前， 包的源地址仍然是内网 IP 地址。
 	  一旦匹配这个规则， 就会触发两个动作。
 	  <literal>keep-state</literal> 选项会把这个规则发到 keep-state 动态规则表中，
 	  并执行所指定的动作。 动作是发到规则表中的信息的一部分。
 	  在这个例子中， 这个动作是 <literal>skipto rule
 	  500</literal>。 规则 500 <acronym>NAT</acronym> 包的 IP 地址，
 	  并将其发出。 请务必牢记， 这一步非常重要。
 	  接下来， 数据包将到达目的地， 之后返回并从规则集的第一条规则开始处理。
 	  这一次， 它将与规则 100 匹配， 其目的 IP 地址将被映射回对应的内网
 	  LAN IP 地址。 其后， 它会被
 	  <literal>check-state</literal> 规则处理， 进而在暨存会话表中找到对应项，
 	  并发到 LAN。 数据包接下来发到了内网 LAN PC 上，
 	  而后者则会发送从远程服务器请求下一段数据的新数据包。
 	  这个包会再次由 <literal>check-state</literal> 规则检查， 并找到发出的表项，
 	  并执行其关联的动作， 即 <literal>skipto 500</literal>。 包跳转到规则 500 并被
 	  <acronym>NAT</acronym> 后发出。</para>
 
 	<para>在接收一侧， 已经存在的会话的数据包会被 <literal>check-state</literal>
 	  规则自动地处理， 并转到 <literal>divert nat</literal> 规则。 我们需要解决的问题是，
 	  阻止所有的坏数据包， 而只允许授权的服务。
 	  例如在防火墙上运行了 Apache 服务， 而我们希望人们在访问 Internet
 	  公网的同时， 也能够访问本地的 web 站点。
 	  新的接入开始请求包将匹配规则 100， 而 IP
 	  地址则为防火墙所在的服务器而映射到了 LAN
 	  IP。 此后， 包会匹配所有我们希望检查的那些令人生厌的东西，
 	  并最终匹配规则 425。 一旦发生匹配， 会发生两件事。
 	  数据包会被发到 keep-state 动态表， 但此时，
 	  所有来自那个源 IP 的会话请求的数量会被限制为 2。
 	  这一做法能够挫败针对指定端口上服务的 DoS 攻击。
 	  动作同时指定了 <literal>allow</literal> 包应被发到 LAN 上。 包返回时，
 	  <literal>check-state</literal> 规则会识别出包属于某一已经存在的会话交互，
 	  并直接把它发到规则 500 做
 	  <acronym>NAT</acronym>， 并发到发出接口。</para>
 
 	<para>示范规则集 #1:</para>
 
 	<programlisting>#!/bin/sh
 cmd="ipfw -q add"
 skip="skipto 500"
 pif=rl0
 ks="keep-state"
 good_tcpo="22,25,37,43,53,80,443,110,119"
 
 ipfw -q -f flush
 
 &dollar;cmd 002 allow all from any to any via xl0  # exclude LAN traffic
 &dollar;cmd 003 allow all from any to any via lo0  # exclude loopback traffic
 
 &dollar;cmd 100 divert natd ip from any to any in via &dollar;pif
 &dollar;cmd 101 check-state
 
 # Authorized outbound packets
 &dollar;cmd 120 &dollar;skip udp from any to xx.168.240.2 53 out via &dollar;pif &dollar;ks
 &dollar;cmd 121 &dollar;skip udp from any to xx.168.240.5 53 out via &dollar;pif &dollar;ks
 &dollar;cmd 125 &dollar;skip tcp from any to any &dollar;good_tcpo out via &dollar;pif setup &dollar;ks
 &dollar;cmd 130 &dollar;skip icmp from any to any out via &dollar;pif &dollar;ks
 &dollar;cmd 135 &dollar;skip udp from any to any 123 out via &dollar;pif &dollar;ks
 
 
 # Deny all inbound traffic from non-routable reserved address spaces
 &dollar;cmd 300 deny all from 192.168.0.0/16  to any in via &dollar;pif  #RFC 1918 private IP
 &dollar;cmd 301 deny all from 172.16.0.0/12   to any in via &dollar;pif  #RFC 1918 private IP
 &dollar;cmd 302 deny all from 10.0.0.0/8      to any in via &dollar;pif  #RFC 1918 private IP
 &dollar;cmd 303 deny all from 127.0.0.0/8     to any in via &dollar;pif  #loopback
 &dollar;cmd 304 deny all from 0.0.0.0/8       to any in via &dollar;pif  #loopback
 &dollar;cmd 305 deny all from 169.254.0.0/16  to any in via &dollar;pif  #DHCP auto-config
 &dollar;cmd 306 deny all from 192.0.2.0/24    to any in via &dollar;pif  #reserved for docs
 &dollar;cmd 307 deny all from 204.152.64.0/23 to any in via &dollar;pif  #Sun cluster
 &dollar;cmd 308 deny all from 224.0.0.0/3     to any in via &dollar;pif  #Class D &amp; E multicast
 
 # Authorized inbound packets
 &dollar;cmd 400 allow udp from xx.70.207.54 to any 68 in &dollar;ks
 &dollar;cmd 420 allow tcp from any to me 80 in via &dollar;pif setup limit src-addr 1
 
 
 &dollar;cmd 450 deny log ip from any to any
 
 # This is skipto location for outbound stateful rules
 &dollar;cmd 500 divert natd ip from any to any out via &dollar;pif
 &dollar;cmd 510 allow ip from any to any
 
 ######################## end of rules  ##################</programlisting>
 
 	<para>下面的这个规则集基本上和上面一样，
 	  但使用了易于读懂的编写方式， 并给出了相当多的注解，
 	  以帮助经验较少的 IPFW 规则编写者更好地理解这些规则到底在做什么。</para>
 
 	<para>示范规则集 #2：</para>
 
 	<programlisting>#!/bin/sh
 ################ Start of IPFW rules file ###############################
 # Flush out the list before we begin.
 ipfw -q -f flush
 
 # Set rules command prefix
 cmd="ipfw -q add"
 skip="skipto 800"
 pif="rl0"     # public interface name of NIC
               # facing the public Internet
 
 #################################################################
 # No restrictions on Inside LAN Interface for private network
 # Change xl0 to your LAN NIC interface name
 #################################################################
 &dollar;cmd 005 allow all from any to any via xl0
 
 #################################################################
 # No restrictions on Loopback Interface
 #################################################################
 &dollar;cmd 010 allow all from any to any via lo0
 
 #################################################################
 # check if packet is inbound and nat address if it is
 #################################################################
 &dollar;cmd 014 divert natd ip from any to any in via &dollar;pif
 
 #################################################################
 # Allow the packet through if it has previous been added to the
 # the "dynamic" rules table by a allow keep-state statement.
 #################################################################
 &dollar;cmd 015 check-state
 
 #################################################################
 # Interface facing Public Internet (Outbound Section)
 # Check session start requests originating from behind the
 # firewall on the private network or from this gateway server
 # destined for the public Internet.
 #################################################################
 
 # Allow out access to my ISP's Domain name server.
 # x.x.x.x must be the IP address of your ISP's DNS
 # Dup these lines if your ISP has more than one DNS server
 # Get the IP addresses from /etc/resolv.conf file
 &dollar;cmd 020 &dollar;skip tcp from any to x.x.x.x 53 out via &dollar;pif setup keep-state
 
 
 # Allow out access to my ISP's DHCP server for cable/DSL configurations.
 &dollar;cmd 030 &dollar;skip udp from any to x.x.x.x 67 out via &dollar;pif keep-state
 
 # Allow out non-secure standard www function
 &dollar;cmd 040 &dollar;skip tcp from any to any 80 out via &dollar;pif setup keep-state
 
 # Allow out secure www function https over TLS SSL
 &dollar;cmd 050 &dollar;skip tcp from any to any 443 out via &dollar;pif setup keep-state
 
 # Allow out send &amp; get email function
 &dollar;cmd 060 &dollar;skip tcp from any to any 25 out via &dollar;pif setup keep-state
 &dollar;cmd 061 &dollar;skip tcp from any to any 110 out via &dollar;pif setup keep-state
 
 # Allow out FreeBSD (make install &amp; CVSUP) functions
 # Basically give user root "GOD" privileges.
 &dollar;cmd 070 &dollar;skip tcp from me to any out via &dollar;pif setup keep-state uid root
 
 # Allow out ping
 &dollar;cmd 080 &dollar;skip icmp from any to any out via &dollar;pif keep-state
 
 # Allow out Time
 &dollar;cmd 090 &dollar;skip tcp from any to any 37 out via &dollar;pif setup keep-state
 
 # Allow out nntp news (i.e., news groups)
 &dollar;cmd 100 &dollar;skip tcp from any to any 119 out via &dollar;pif setup keep-state
 
 # Allow out secure FTP, Telnet, and SCP
 # This function is using SSH (secure shell)
 &dollar;cmd 110 &dollar;skip tcp from any to any 22 out via &dollar;pif setup keep-state
 
 # Allow out whois
 &dollar;cmd 120 &dollar;skip tcp from any to any 43 out via &dollar;pif setup keep-state
 
 # Allow ntp time server
 &dollar;cmd 130 &dollar;skip udp from any to any 123 out via &dollar;pif keep-state
 
 #################################################################
 # Interface facing Public Internet (Inbound Section)
 # Check packets originating from the public Internet
 # destined for this gateway server or the private network.
 #################################################################
 
 # Deny all inbound traffic from non-routable reserved address spaces
 &dollar;cmd 300 deny all from 192.168.0.0/16  to any in via &dollar;pif  #RFC 1918 private IP
 &dollar;cmd 301 deny all from 172.16.0.0/12   to any in via &dollar;pif  #RFC 1918 private IP
 &dollar;cmd 302 deny all from 10.0.0.0/8      to any in via &dollar;pif  #RFC 1918 private IP
 &dollar;cmd 303 deny all from 127.0.0.0/8     to any in via &dollar;pif  #loopback
 &dollar;cmd 304 deny all from 0.0.0.0/8       to any in via &dollar;pif  #loopback
 &dollar;cmd 305 deny all from 169.254.0.0/16  to any in via &dollar;pif  #DHCP auto-config
 &dollar;cmd 306 deny all from 192.0.2.0/24    to any in via &dollar;pif  #reserved for docs
 &dollar;cmd 307 deny all from 204.152.64.0/23 to any in via &dollar;pif  #Sun cluster
 &dollar;cmd 308 deny all from 224.0.0.0/3     to any in via &dollar;pif  #Class D &amp; E multicast
 
 # Deny ident
 &dollar;cmd 315 deny tcp from any to any 113 in via &dollar;pif
 
 # Deny all Netbios service. 137=name, 138=datagram, 139=session
 # Netbios is MS/Windows sharing services.
 # Block MS/Windows hosts2 name server requests 81
 &dollar;cmd 320 deny tcp from any to any 137 in via &dollar;pif
 &dollar;cmd 321 deny tcp from any to any 138 in via &dollar;pif
 &dollar;cmd 322 deny tcp from any to any 139 in via &dollar;pif
 &dollar;cmd 323 deny tcp from any to any 81  in via &dollar;pif
 
 # Deny any late arriving packets
 &dollar;cmd 330 deny all from any to any frag in via &dollar;pif
 
 # Deny ACK packets that did not match the dynamic rule table
 &dollar;cmd 332 deny tcp from any to any established in via &dollar;pif
 
 # Allow traffic in from ISP's DHCP server. This rule must contain
 # the IP address of your ISP's DHCP server as it's the only
 # authorized source to send this packet type.
 # Only necessary for cable or DSL configurations.
 # This rule is not needed for 'user ppp' type connection to
 # the public Internet. This is the same IP address you captured
 # and used in the outbound section.
 &dollar;cmd 360 allow udp from x.x.x.x to any 68 in via &dollar;pif keep-state
 
 # Allow in standard www function because I have Apache server
 &dollar;cmd 370 allow tcp from any to me 80 in via &dollar;pif setup limit src-addr 2
 
 # Allow in secure FTP, Telnet, and SCP from public Internet
 &dollar;cmd 380 allow tcp from any to me 22 in via &dollar;pif setup limit src-addr 2
 
 # Allow in non-secure Telnet session from public Internet
 # labeled non-secure because ID &amp; PW are passed over public
 # Internet as clear text.
 # Delete this sample group if you do not have telnet server enabled.
 &dollar;cmd 390 allow tcp from any to me 23 in via &dollar;pif setup limit src-addr 2
 
 # Reject &amp; Log all unauthorized incoming connections from the public Internet
 &dollar;cmd 400 deny log all from any to any in via &dollar;pif
 
 # Reject &amp; Log all unauthorized out going connections to the public Internet
 &dollar;cmd 450 deny log all from any to any out via &dollar;pif
 
 # This is skipto location for outbound stateful rules
 &dollar;cmd 800 divert natd ip from any to any out via &dollar;pif
 &dollar;cmd 801 allow ip from any to any
 
 # Everything else is denied by default
 # deny and log all packets that fell through to see what they are
 &dollar;cmd 999 deny log all from any to any
 ################ End of IPFW rules file ###############################</programlisting>
       </sect3>
     </sect2>
   </sect1>
 </chapter>
diff --git a/zh_CN.UTF-8/books/handbook/geom/chapter.xml b/zh_CN.UTF-8/books/handbook/geom/chapter.xml
index 9cda0771c0..cdd820d498 100644
--- a/zh_CN.UTF-8/books/handbook/geom/chapter.xml
+++ b/zh_CN.UTF-8/books/handbook/geom/chapter.xml
@@ -1,850 +1,850 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      The FreeBSD Documentation Project
      The FreeBSD Simplified Chinese Project
 
-     Original Revision: r38401
+     Original Revision: f95372cee1 (r38401)
      $FreeBSD$
 -->
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="GEOM">
   <info><title>GEOM： 模块化磁盘变换框架</title>
     <authorgroup>
       <author><personname><firstname>Tom</firstname><surname>Rhodes</surname></personname><contrib>原作 </contrib></author>
     </authorgroup>
   </info>
 
   
 
   <sect1 xml:id="GEOM-synopsis">
     <title>概述</title>
 
     <indexterm>
       <primary>GEOM</primary>
     </indexterm>
     <indexterm>
       <primary>GEOM 磁盘框架</primary>
       <see>GEOM</see>
     </indexterm>
 
     <para>本章将介绍以 &os; GEOM 框架来使用磁盘。
       这包括了使用这一框架来配置的主要的 <acronym role="Redundant Array of Inexpensive Disks">RAID</acronym>
       控制工具。 这一章不会深入讨论 GEOM
       如何处理或控制 I/O、 其下层的子系统或代码。
       您可以从 &man.geom.4; 联机手册及其众多 SEE ALSO 参考文献中得到这些信息。
       这一章也不是对 <acronym>RAID</acronym> 配置的权威介绍，
       它只介绍由 支持GEOM 的 <acronym>RAID</acronym>
       级别。</para>
 
     <para>读完这章， 您将了解：</para>
 
     <itemizedlist>
       <listitem>
 	<para>通过 GEOM 支持的 <acronym>RAID</acronym> 类型。</para>
       </listitem>
 
       <listitem>
 	<para>如何使用基本工具来配置和管理不同的 <acronym>RAID</acronym>
 	  级别。</para>
       </listitem>
 
       <listitem>
         <para>如何通过 GEOM 使用镜像、 条带、 加密和挂接在远程的磁盘设备。</para>
       </listitem>
 
       <listitem>
 	<para>如何排除挂接在 GEOM 框架上的磁盘设备的问题。</para>
       </listitem>
     </itemizedlist>
 
     <para>阅读这章之前， 您应：</para>
 
     <itemizedlist>
       <listitem>
 	<para>理解 &os; 如何处理磁盘设备
 	  (<xref linkend="disks"/>)。</para>
       </listitem>
 
       <listitem>
 	<para>了解如何配置和安装新的 &os; 内核
 	  (<xref linkend="kernelconfig"/>)。</para>
       </listitem>
     </itemizedlist>
   </sect1>
 
   <sect1 xml:id="GEOM-intro">
     <title>GEOM 介绍</title>
 
     <para>GEOM 允许访问和控制类 (classes) &mdash; 主引导记录、
       <acronym>BSD</acronym> 标签 (label)， 等等 &mdash; 通过使用
       provider， 或在
       <filename>/dev</filename> 中的特殊文件。
       它支持许多软件 <acronym>RAID</acronym> 配置， GEOM 能够向操作系统，
       以及在其上运行的工具提供透明的访问方式。</para>
   </sect1>
 
   <sect1 xml:id="GEOM-striping">
   <info><title>RAID0 - 条带</title>
     <authorgroup>
       <author><personname><firstname>Tom</firstname><surname>Rhodes</surname></personname><contrib>原作 </contrib></author>
       <author><personname><firstname>Murray</firstname><surname>Stokely</surname></personname></author>
     </authorgroup>
   </info>
 
     
 
     <indexterm>
       <primary>GEOM</primary>
     </indexterm>
     <indexterm>
       <primary>条带</primary>
     </indexterm>
 
     <para>条带是一种将多个磁盘驱动器合并为一个卷的方法。
       许多情况下， 这是通过硬件控制器来完成的。 GEOM
       磁盘子系统提供了 <acronym>RAID</acronym>0 的软件支持，
       它也成为磁盘条带。</para>
 
     <para>在 <acronym>RAID</acronym>0 系统中， 数据被分为多个块，
       这些块将分别写入阵列的所有磁盘。 与先前需要等待系统将 256k
       数据写到一块磁盘上不同， <acronym>RAID</acronym>0 系统，
       能够同时分别将打碎的 64k 写到四块磁盘上， 从而提供更好的 I/O
       性能。 这一性能提升还能够通过使用多个磁盘控制器来进一步改进。</para>
 
     <para>在 <acronym>RAID</acronym>0 条带中的每一个盘的尺寸必须一样，
       因为 I/O 请求是分散到多个盘上的， 以便让这些盘上的读写并行完成。</para>
 
       <mediaobject>
         <imageobject>
           <imagedata fileref="geom/striping" align="center"/>
         </imageobject>
 
         <textobject>
           <phrase>磁盘条带图</phrase>
         </textobject>
       </mediaobject>
 
     <procedure>
       <title>在未格式化的 ATA 磁盘上建立条带</title>
 
       <step><para>加载 <filename>geom_stripe.ko</filename>
         模块：</para>
 
     <screen>&prompt.root; <userinput>kldload geom_stripe</userinput></screen>
 	</step>
 
       <step><para>确信存在合适的挂接点 (mount point)。 如果这个卷将成为根分区，
         那么暂时把它挂接到其他位置i， 如 <filename>/mnt</filename>：</para>
 
         <screen>&prompt.root; <userinput>mkdir /mnt</userinput></screen>
       </step>
 
       <step>
 	<para>确定将被做成条带卷的磁盘的设备名，
 	  并创建新的条带设备。 举例而言，
 	  要将两个未用的、 尚未分区的 <acronym>ATA</acronym> 磁盘
 	  <filename>/dev/ad2</filename> 和
 	  <filename>/dev/ad3</filename> 做成一个条带设备：</para>
 
         <screen>&prompt.root; <userinput>gstripe label -v st0 /dev/ad2 /dev/ad3</userinput>
 Metadata value stored on /dev/ad2.
 Metadata value stored on /dev/ad3.
 Done.</screen>
 
       </step>
 
       <step>
 	<para>接着需要写标准的 label， 也就是通常所说的分区表到新卷上，
 	  并安装标准的引导代码：</para>
 
         <screen>&prompt.root; <userinput>bsdlabel -wB /dev/stripe/st0</userinput></screen>
       </step>
 
       <step>
 	<para>上述过程将在
 	  <filename>/dev/stripe</filename>
 	  目录中的 <filename>st0</filename> 设备基础上建立两个新设备。
 	  这包括 <filename>st0a</filename> 和
 	  <filename>st0c</filename>。 这时， 就可以在
 	  <filename>st0a</filename> 设备上用下述
 	  <command>newfs</command> 命令来建立文件系统了：</para>
 
 	<screen>&prompt.root; <userinput>newfs -U /dev/stripe/st0a</userinput></screen>
 
 	<para>在屏幕上将滚过一些数字， 整个操作应该能在数秒内完成。
 	  现在可以挂接刚刚做好的卷了。</para>
       </step>
 
   </procedure>
 
   <para>要挂接刚创建的条带盘：</para>
 
   <screen>&prompt.root; <userinput>mount /dev/stripe/st0a /mnt</userinput></screen>
 
     <para>要在启动过程中自动挂接这个条带上的文件系统，
       需要把关于卷的信息放到
       <filename>/etc/fstab</filename> 文件中。为达到此目的，
       需要创建一个叫
       <filename>stripe</filename>
       的永久的挂载点：</para>
 
   <screen>&prompt.root; <userinput>mkdir /stripe</userinput>
 &prompt.root; <userinput>echo "/dev/stripe/st0a /stripe ufs rw 2 2" \</userinput>
     <userinput>&gt;&gt; /etc/fstab</userinput></screen>
 
     <para>此外， <filename>geom_stripe.ko</filename> 模块也必须通过在
       <filename>/boot/loader.conf</filename> 中增加下述设置，
       以便在系统初始化过程中自动加载：</para>
 
   <screen>&prompt.root; <userinput>echo 'geom_stripe_load="YES"' &gt;&gt; /boot/loader.conf</userinput></screen>
 
   </sect1>
 
   <sect1 xml:id="GEOM-mirror">
     <title>RAID1 - 镜像</title>
 
     <indexterm>
       <primary>GEOM</primary>
     </indexterm>
     <indexterm>
       <primary>磁盘镜像</primary>
     </indexterm>
 
     <para>镜像是许多公司和家庭用户使用的一种无须中断的备份技术。
       简单地说， 镜像的概念就是 磁盘B 是同步复制 (replicate) 的 磁盘A 的副本，
       或者 磁盘C+D 是 diskA+B 的同步复制副本， 等等。 无论磁盘配置如何，
       这种技术的共同特点都是一块磁盘或分区的内容会同步复制到另外的地方。
       这样， 除了能够很容易地恢复信息之外，
       还能够在无须中断服务或访问的情况下进行备份，
       甚至直接将副本送到数据保安公司异地储存。</para>
 
     <para>在开始做这件事之前， 首先请准备两个容量相同的磁盘驱动器，
       下面的例子假定它们都是使用直接访问方式 (Direct Access， &man.da.4;) 的
       <acronym>SCSI</acronym> 磁盘。</para>
 
     <sect2>
       <title>对主磁盘进行镜像</title>
 
       <para>假定您现有系统中的 &os; 安装到了第一个， 也就是
 	<filename>da0</filename> 盘上， 则应告诉 &man.gmirror.8;
 	将主要数据保存在这里。</para>
 
       <para>在开始构建镜像卷之前， 可以启用更多的调试信息，
 	并应开放对设备的完全访问。 这可以通过将 &man.sysctl.8; 变量
 	<varname>kern.geom.debugflags</varname>
 	设置为下面的值来实现：</para>
 
       <screen>&prompt.root; <userinput>sysctl kern.geom.debugflags=17</userinput></screen>
 
       <para>接下来需要创建镜像。 这个过程的第一步是在主磁盘上保存元数据信息，
 	也就是用下面的命令来创建
 	<filename>/dev/mirror/gm</filename> 设备：</para>
 
       <warning>
 	<para>在引导用的设备基础上新建镜像时，
 	  有可能会导致保存在磁盘上最后一个扇区的数据丢失。
 	  在新安装 &os; 之后立即创建镜像可以减低此风险。
 	  下面的操作与默认的 &os;&nbsp;9.<replaceable>X</replaceable>
 	  安装过程不兼容， 因为它采用了新的 <acronym>GPT</acronym>
 	  分区格式。 GEOM 会覆盖 <acronym>GPT</acronym> 元数据，
 	  这会导致数据丢失， 并有可能导致系统无法引导。</para>
       </warning>
 
       <screen>&prompt.root; <userinput>gmirror label -vb round-robin gm0 /dev/da0</userinput></screen>
 
       <para>系统应给出下面的回应：</para>
 
       <screen>Metadata value stored on /dev/da0.
 Done.</screen>
 
       <para>初始化 GEOM， 这步操作会加载内核模块
 	<filename>/boot/kernel/geom_mirror.ko</filename>：</para>
 
       <screen>&prompt.root; <userinput>gmirror load</userinput></screen>
 
       <note>
 	<para>当这个命令运行完之后， 系统会在
 	  <filename>/dev/mirror</filename>
 	  目录中创建设备节点
 	  <filename>gm0</filename>。</para>
       </note>
 
       <para>配置在系统初始化过程中自动加载 <filename>geom_mirror.ko</filename>：</para>
 
       <screen>&prompt.root; <userinput>echo 'geom_mirror_load="YES"' &gt;&gt; /boot/loader.conf</userinput></screen>
 
       <para>编辑 <filename>/etc/fstab</filename> 文件，
 	将其中先前的 <filename>da0</filename> 改为新的镜像设备
 	<filename>gm0</filename>。</para>
 
       <note>
         <para>如果 &man.vi.1; 是你喜欢的编辑器，
           以下则是完成此项任务的一个简便方法：</para>
 
         <screen>&prompt.root; <userinput>vi /etc/fstab</userinput></screen>
 
 	<para>在 &man.vi.1; 中备份现有的
 	  <filename>fstab</filename> 内容， 具体操作是
 	  <userinput>:w /etc/fstab.bak</userinput>。 接着，
 	  把所有旧的 <filename>da0</filename>
 	  替换成 <filename>gm0</filename>， 也就是输入命令
 	  <userinput>:%s/da/mirror\/gm/g</userinput>。</para>
       </note>
 
       <para>修改完后的 <filename>fstab</filename> 文件应该是下面的样子。
 	磁盘驱动器是 <acronym>SCSI</acronym> 或 <acronym>ATA</acronym>
 	甚至 <acronym>RAID</acronym> 都没有关系， 最终的结果都是
 	<filename>gm</filename>。</para>
 
       <programlisting># Device		Mountpoint	FStype	Options		Dump	Pass#
 /dev/mirror/gm0s1b	none		swap	sw		0	0
 /dev/mirror/gm0s1a	/		ufs	rw		1	1
 /dev/mirror/gm0s1d	/usr		ufs	rw		0	0
 /dev/mirror/gm0s1f	/home		ufs	rw		2	2
 #/dev/mirror/gm0s2d	/store		ufs	rw		2	2
 /dev/mirror/gm0s1e	/var		ufs	rw		2       2
 /dev/acd0		/cdrom		cd9660	ro,noauto	0	0</programlisting>
 
       <para>重启系统：</para>
 
       <screen>&prompt.root; <userinput>shutdown -r now</userinput></screen>
 
       <para>在系统初始化过程中， 新建的
 	<filename>gm0</filename> 会代替
 	<filename>da0</filename> 设备工作。 系统完成初始化之后，
 	可以通过检查 <command>mount</command> 命令的输出来查看效果：</para>
 
       <screen>&prompt.root; <userinput>mount</userinput>
 Filesystem         1K-blocks    Used    Avail Capacity  Mounted on
 /dev/mirror/gm0s1a   1012974  224604   707334    24%    /
 devfs                      1       1        0   100%    /dev
 /dev/mirror/gm0s1f  45970182   28596 42263972     0%    /home
 /dev/mirror/gm0s1d   6090094 1348356  4254532    24%    /usr
 /dev/mirror/gm0s1e   3045006 2241420   559986    80%    /var
 devfs                      1       1        0   100%    /var/named/dev</screen>
 
       <para>这个输出是正常的。 最后， 使用下面的命令将 <filename>da1</filename>
 	磁盘加到镜像卷中， 以开始同步过程：</para>
 
       <screen>&prompt.root; <userinput>gmirror insert gm0 /dev/da1</userinput></screen>
 
       <para>在构建镜像卷的过程中， 可以用下面的命令查看状态：</para>
 
       <screen>&prompt.root; <userinput>gmirror status</userinput></screen>
 
       <para>一旦镜像卷的构建操作完成， 这个命令的输出就会变成这样：</para>
 
       <screen>      Name    Status  Components
 mirror/gm0  COMPLETE  da0
                       da1</screen>
 
       <para>如果有问题或者构建仍在进行， 输出中的
 	<literal>COMPLETE</literal> 就会是
 	<literal>DEGRADED</literal>。</para>
     </sect2>
 
     <sect2>
       <title>故障排除</title>
       <sect3>
 	<title>系统拒绝引导</title>
 
 	<para>如果系统引导时出现类似下面的提示：</para>
 
 	<programlisting>ffs_mountroot: can't find rootvp
 Root mount failed: 6
 mountroot&gt;</programlisting>
 
 	<para>这种情况应使用电源或复位按钮重启机器。
 	  在引导菜单中， 选择第六 (6) 个选项。
 	  这将让系统进入 &man.loader.8; 提示符。
 	  在此处手工加载内核模块：</para>
 
 	<screen>OK? <userinput>load geom_mirror</userinput>
 OK? <userinput>boot</userinput></screen>
 
 	<para>如果这样做能解决问题， 则说明由于某种原因模块没有被正确加载。
 	  检查 <filename>/boot/loader.conf</filename> 中相关条目是否正确。
 	  如果问题仍然存在，可以在内核配置文件中加入：</para>
 
 	<programlisting>options	GEOM_MIRROR</programlisting>
 
 	<para>然后重新编译和安装内核来解决这个问题。</para>
       </sect3>
     </sect2>
 
     <sect2>
       <title>从磁盘故障中恢复</title>
 
       <para>磁盘镜像的一大好处是在当其中一个磁盘出现故障时，
 	可以很容易地将其替换掉， 并且通常不会丢失数据。</para>
 
       <para>考虑前面的 <acronym>RAID</acronym>1
 	配置， 假设 <filename>da1</filename>
 	出现了故障并需要替换， 要替换它，
 	首先确定哪个磁盘出现了故障， 并关闭系统。
 	此时， 可以用换上新的磁盘， 并重新启动系统。
 	这之后可以用下面的命令来完成磁盘的替换操作：</para>
 
       <screen>&prompt.root; <userinput>gmirror forget gm0</userinput></screen>
 
       <screen>&prompt.root; <userinput>gmirror insert gm0 /dev/da1</userinput></screen>
 
       <para>在重建过程中可以用 <command>gmirror</command> <option>status</option>
 	命令来监看进度。 就是这样简单。</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="GEOM-raid3">
     <info><title><acronym>RAID</acronym>3 - 使用专用校验设备的字节级条带</title>
       <authorgroup>
 	<author><personname><firstname>Mark</firstname><surname>Gladman</surname></personname><contrib>Written by </contrib></author>
 	<author><personname><firstname>Daniel</firstname><surname>Gerzo</surname></personname></author>
       </authorgroup>
       <authorgroup>
 	<author><personname><firstname>Tom</firstname><surname>Rhodes</surname></personname><contrib>Based on documentation by </contrib></author>
 	<author><personname><firstname>Murray</firstname><surname>Stokely</surname></personname></author>
       </authorgroup>
     </info>
 
     
 
     <indexterm>
       <primary>GEOM</primary>
     </indexterm>
     <indexterm>
       <primary>RAID3</primary>
     </indexterm>
 
     <para><acronym>RAID</acronym>3 是一种将多个磁盘组成一个卷的技术，
       在这个配置中包含一个专用于校验的盘。
       在 <acronym>RAID</acronym>3 系统中，
       数据会以字节为单位拆分并写入除校验盘之外的全部驱动器中。 这意味着从
       <acronym>RAID</acronym>3 中读取数据时将会访问所有的驱动器。
       采用多个磁盘控制器可以进一步改善性能。 <acronym>RAID</acronym>3
       阵列最多可以容忍其中的 1 个驱动器出现故障，
       它可以提供全部驱动器总容量的 1 - 1/n，
       此处 n 是阵列中的磁盘数量。 这类配置比较适合保存大容量的数据，
       例如多媒体文件。</para>
 
     <para>在建立
       <acronym>RAID</acronym>3 阵列时， 至少需要 3 块磁盘。
       所有的盘的尺寸必须一致， 因为 I/O 请求会并发分派到不同的盘上。
       另外， 由于
       <acronym>RAID</acronym>3 本身的设计，
       盘的数量必须恰好是 3, 5, 9, 17, 等等 (2^n + 1)。</para>
 
     <sect2>
       <title>建立专用的 <acronym>RAID</acronym>3 阵列</title>
 
       <para>在 &os; 中， <acronym>RAID</acronym>3
 	是通过 &man.graid3.8; <acronym>GEOM</acronym>
 	class 实现的。 在 &os; 中建立专用的
 	<acronym>RAID</acronym>3 阵列需要下述步骤。</para>
 
       <note>
 	<para>虽然理论上从
 	  <acronym>RAID</acronym>3 阵列启动 &os; 是可行的，
 	  但这并不常见， 也不推荐您这样做。</para>
       </note>
 
       <procedure>
 	<step>
 	  <para>首先， 在引导加载器中用下面的命令加载 <filename>geom_raid3.ko</filename>
 	    内核模块：</para>
 
 	  <screen>&prompt.root; <userinput>graid3 load</userinput></screen>
 
 	  <para>此外， 也可以通过命令行手工加载
 	    <filename>geom_raid3.ko</filename> 模块：</para>
 
 	  <screen>&prompt.root; <userinput>kldload geom_raid3.ko</userinput></screen>
 	</step>
 
 	<step>
 	  <para>创建用于挂载卷的挂点目录：</para>
 
 	  <screen>&prompt.root; <userinput>mkdir /multimedia/</userinput></screen>
 	</step>
 
 	<step>
 	  <para>确定将要加入阵列的磁盘设备名， 并创建新的
 	    <acronym>RAID</acronym>3 设备。 最终， 这个设备将代表整个阵列。
 	    下面的例子使用三个未经分区的
 	    <acronym>ATA</acronym> 磁盘：
 	    <filename>ada1</filename>
 	    和 <filename>ada2</filename>
 	    保存数据， 而
 	    <filename>ada3</filename>
 	    用于校验。</para>
 
 	  <screen>&prompt.root; <userinput>graid3 label -v gr0 /dev/ada1 /dev/ada2 /dev/ada3</userinput>
 Metadata value stored on /dev/ada1.
 Metadata value stored on /dev/ada2.
 Metadata value stored on /dev/ada3.
 Done.</screen>
 	</step>
 
 	<step>
 	  <para>为新建的
 	    <filename>gr0</filename> 设备分区，
 	    并在其上创建 UFS 文件系统：</para>
 
 	  <screen>&prompt.root; <userinput>gpart create -s GPT /dev/raid3/gr0</userinput>
 &prompt.root; <userinput>gpart add -t freebsd-ufs /dev/raid3/gr0</userinput>
 &prompt.root; <userinput>newfs -j /dev/raid3/gr0p1</userinput></screen>
 
 	  <para>屏幕上会滚过许多数字， 这个过程需要一段时间才能完成。
 	    此后， 您就完成了创建卷的全部操作，
 	    可以挂载它了。</para>
 	</step>
 
 	<step>
 	  <para>最后一步是挂载文件系统：</para>
 
 	  <screen>&prompt.root; <userinput>mount /dev/raid3/gr0p1 /multimedia/</userinput></screen>
 
 	  <para>现在可以使用 <acronym>RAID</acronym>3 阵列了。</para>
 	</step>
       </procedure>
 
       <para>为了让上述配置在系统重启后继续可用， 还需要进行一些额外的配置操作。</para>
 
       <procedure>
 	<step>
 	  <para>在挂载卷之前必须首先加载 <filename>geom_raid3.ko</filename> 模块。
 	    将下面的配置添加到
 	    <filename>/boot/loader.conf</filename> 文件中，
 	    可以让系统在引导过程中自动加载这个模块：</para>
 
 	  <programlisting>geom_raid3_load="YES"</programlisting>
 	</step>
 
 	<step>
 	  <para>您需要在
 	    <filename>/etc/fstab</filename> 文件中加入下列配置，
 	    以便让系统引导时自动挂载阵列上的文件系统：</para>
 
 	  <programlisting>/dev/raid3/gr0p1	/multimedia	ufs	rw	2	2</programlisting>
 	</step>
       </procedure>
     </sect2>
   </sect1>
 
   <sect1 xml:id="geom-ggate">
     <title>GEOM Gate 网络设备</title>
 
     <para>通过 gate 工具， GEOM 支持以远程方式使用设备， 例如磁盘、
       CD-ROM、 文件等等。 这和 <acronym>NFS</acronym> 类似。</para>
 
     <para>在开始工作之前， 首先要创建一个导出文件。
       这个文件的作用是指定谁可以访问导出的资源，
       以及提供何种级别的访问授权。 例如，
       要把第一块 <acronym>SCSI</acronym> 盘的第四个 slice 导出，
       对应的 <filename>/etc/gg.exports</filename> 会是类似下面的样子：</para>
 
     <programlisting>192.168.1.0/24 RW /dev/da0s4d</programlisting>
 
     <para>这表示允许同属私有子网的所有机器访问
       <filename>da0s4d</filename> 分区上的文件系统。</para>
 
     <para>要导出这个设备， 首先请确认它没有被挂接，
       然后是启动 &man.ggated.8; 服务：</para>
 
     <screen>&prompt.root; <userinput>ggated</userinput></screen>
 
     <para>现在我们将在客户机上 <command>mount</command> 该设备，
       使用下面的命令：</para>
 
     <screen>&prompt.root; <userinput>ggatec create -o rw 192.168.1.1 /dev/da0s4d</userinput>
 ggate0
 &prompt.root; <userinput>mount /dev/ggate0 /mnt</userinput></screen>
 
     <para>到此为止， 设备应该已经可以通过挂接点
       <filename>/mnt</filename> 访问了。</para>
 
     <note>
       <para>请注意， 如果设备已经被服务器或网络上的任何其他机器挂接，
 	则前述操作将会失败。</para>
     </note>
 
     <para>如果不再需要使用这个设备，
       就可以使用 &man.umount.8; 命令来安全地将其卸下了，
       这一点和其他磁盘设备类似。</para>
   </sect1>
 
   <sect1 xml:id="geom-glabel">
     <title>为磁盘设备添加卷标</title>
 
     <indexterm>
       <primary>GEOM</primary>
     </indexterm>
     <indexterm>
       <primary>磁盘卷标</primary>
     </indexterm>
 
     <para>在系统初始化的过程中， &os; 内核会为检测到的设备创建设备节点。
       这种检测方式存在一些问题， 例如，
       在通过 <acronym>USB</acronym> 添加设备时应如何处理？
       很可能有闪存盘设备最初被识别为
       <filename>da0</filename> 而在这之后， 则由
       <filename>da0</filename> 变成了
       <filename>da1</filename>。 而这则会在挂接
       <filename>/etc/fstab</filename> 中的文件系统时造成问题，
       这些问题， 还可能在系统引导时导致无法正常启动。</para>
 
     <para>解决这个问题的一个方法是以连接拓扑方式链式地进行
       <acronym>SCSI</acronym> 设备命名， 这样，
       当在 <acronym>SCSI</acronym> 卡上增加新设备时， 这些设备将使用一个未用的编号。
       但如果 <acronym>USB</acronym> 设备取代了主 <acronym>SCSI</acronym> 磁盘的位置呢？
       由于 <acronym>USB</acronym> 通常会在 <acronym>SCSI</acronym> 卡之前检测到，
       因此很可能出现这种现象。 当然， 可以通过在系统引导之后再插入这些设备来绕过这个问题。
       另一种绕过这个问题的方法， 则是只使用
       <acronym>ATA</acronym> 驱动器， 并避免在
       <filename>/etc/fstab</filename> 中列出
       <acronym>SCSI</acronym> 设备。</para>
 
     <para>还有一种更好的解决方法。 通过使用
       <command>glabel</command> 工具， 管理员或用户可以为磁盘设备打上标签， 并在
       <filename>/etc/fstab</filename> 中使用这些标签。 由于
       <command>glabel</command> 会将标签保存在对应 provider 的最后一个扇区，
       在系统重启之后， 它仍会持续存在。 因此， 通过将具体的设备替换为使用标签表示，
       无论设备节点变成什么， 文件系统都能够顺利地完成挂接。</para>
 
     <note>
       <para>这并不是说标签一定是永久性的。
 	<command>glabel</command> 工具既可以创建永久性标签， 也可以创建临时性标签。
 	在重启时， 只有永久性标签会保持。 请参见联机手册 &man.glabel.8;
 	以了解两者之间的差异。</para>
     </note>
 
     <sect2>
       <title>标签类型和使用示范</title>
 
       <para>有两种类型的标签， 一种是普通标签， 另一种是文件系统标签。
 	标签可以是永久性的或暂时性的。永久性的标签可以通过 
 	&man.tunefs.8; 或 &man.newfs.8; 命令创键。根据文件系统的类型，
 	它们将在 <filename>/dev</filename>
 	下的一个子目录中被创建。例如，
 	<acronym>UFS</acronym>2 文件系统的标签会创建到
 	<filename>/dev/ufs</filename>
 	目录中。永久性的标签还可以使用 <command>glabel label</command>
 	创建。它们不再是文件系统特定的，而是会在
 	<filename>/dev/label</filename>
 	目录中被创建。</para>
 
       <para>暂时性的标签在系统下次重启时会消失， 这些标签会创建到
 	<filename>/dev/label</filename> 目录中，
 	很适合测试之用。可以使用 <command>glabel create</command>
 	创建暂时性的标签。请参阅 &man.glabel.8;
 	手册页以获取更多详细信息。</para>
 
 <!-- XXXTR: How do you create a file system label without running newfs
 	    or when there is no newfs (e.g.: cd9660)? -->
 
       <para>要为一个 <acronym>UFS</acronym>2 文件系统创建永久性标签，
         而不破坏其上的数据，可以使用下面的命令：</para>
 
       <screen>&prompt.root; <userinput>tunefs -L home /dev/da3</userinput></screen>
 
       <warning>
 	<para>如果文件系统满了， 这可能会导致数据损坏； 不过， 如果文件系统快满了，
 	  此时应首先删除一些无用的文件， 而不是增加标签。</para>
       </warning>
 
       <para>现在， 您应可以在
 	<filename>/dev/ufs</filename> 目录中看到标签，
 	并将其加入 <filename>/etc/fstab</filename>：</para>
 
       <programlisting>/dev/ufs/home		/home            ufs     rw              2      2</programlisting>
 
       <note>
 	<para>当运行 <command>tunefs</command> 时， 应首先卸下文件系统。</para>
       </note>
 
       <para>现在可以像平时一样挂接文件系统了：</para>
 
       <screen>&prompt.root; <userinput>mount /home</userinput></screen>
 
       <para>现在， 只要在系统引导时通过 <filename>/boot/loader.conf</filename> 配置加载了内核模块
 	<filename>geom_label.ko</filename>， 或在联编内核时指定了
 	<literal>GEOM_LABEL</literal> 选项，
 	设备节点由于增删设备而顺序发生变化时， 就不会影响文件系统的挂接了。</para>
 
       <para>通过使用 <command>newfs</command> 命令的
 	<option>-L</option> 参数， 可以在创建文件系统时为其添加默认的标签。
 	请参见联机手册 &man.newfs.8; 以了解进一步的详情。</para>
 
       <para>下列命令可以清除标签：</para>
 
       <screen>&prompt.root; <userinput>glabel destroy home</userinput></screen>
 
       <para>以下的例子展示了如何为一个启动磁盘打上标签。</para>
 
       <example>
         <title>为启动磁盘打上标签</title>
 
 	<para>为启动磁盘打上永久性标签， 系统应该能够正常启动，
 	  即使磁盘被移动到了另外一个控制器或者转移到了一个不同的系统上。
 	  此例中我们假设使用了一个 <acronym>ATA</acronym> 磁盘，
 	  当前这个设备被系统识别为 <filename>ad0</filename>。
 	  还假设使用了标准的 &os; 分区划分方案，
 	  <filename>/</filename>,
 	  <filename>/var</filename>,
 	  <filename>/usr</filename> 和
 	  <filename>/tmp</filename> 文件系统，
 	  还有一个 swap 分区。</para>
 
 	<para>重启系统，在 &man.loader.8; 提示符下键入
 	  <keycap>4</keycap> 启动到单用户模式。
 	  然后输入以下的命令：</para>
 
 	<screen>&prompt.root; <userinput>glabel label rootfs /dev/ad0s1a</userinput>
 GEOM_LABEL: Label for provider /dev/ad0s1a is label/rootfs
 &prompt.root; <userinput>glabel label var /dev/ad0s1d</userinput>
 GEOM_LABEL: Label for provider /dev/ad0s1d is label/var
 &prompt.root; <userinput>glabel label usr /dev/ad0s1f</userinput>
 GEOM_LABEL: Label for provider /dev/ad0s1f is label/usr
 &prompt.root; <userinput>glabel label tmp /dev/ad0s1e</userinput>
 GEOM_LABEL: Label for provider /dev/ad0s1e is label/tmp
 &prompt.root; <userinput>glabel label swap /dev/ad0s1b</userinput>
 GEOM_LABEL: Label for provider /dev/ad0s1b is label/swap
 &prompt.root; <userinput>exit</userinput></screen>
 
 	<para>系统加继续启动进入多用户模式。 在启动完毕后， 编辑
 	  <filename>/etc/fstab</filename> 用各自的标签替换下常规的设备名。
 	  最终 <filename>/etc/fstab</filename> 看起来差不多是这样的：</para>
 
 	<programlisting># Device                Mountpoint      FStype  Options         Dump    Pass#
 /dev/label/swap         none            swap    sw              0       0
 /dev/label/rootfs       /               ufs     rw              1       1
 /dev/label/tmp          /tmp            ufs     rw              2       2
 /dev/label/usr          /usr            ufs     rw              2       2
 /dev/label/var          /var            ufs     rw              2       2</programlisting>
 
 	<para>现在可以重启系统了。 如果一切顺利的话，
 	  系统可以正常启动并且 <command>mount</command> 命令显示：</para>
 
 	<screen>&prompt.root; <userinput>mount</userinput>
 /dev/label/rootfs on / (ufs, local)
 devfs on /dev (devfs, local)
 /dev/label/tmp on /tmp (ufs, local, soft-updates)
 /dev/label/usr on /usr (ufs, local, soft-updates)
 /dev/label/var on /var (ufs, local, soft-updates)</screen>
       </example>
 
       <para>从 &os;&nbsp;7.2 开始， &man.glabel.8; class
 	新增了一种用于 <acronym>UFS</acronym> 文件系统唯一标识符，
 	<literal>ufsid</literal> 的标签支持。
 	这些标签可以在 <filename>/dev/ufsid</filename>
 	目录中找到， 它们会在系统引导时自动创建。
 	在 <filename>/etc/fstab</filename> 机制中，
 	也可以使用 <literal>ufsid</literal> 标签。 您可以使用
 	<command>glabel status</command> 命令来获得与文件系统对应的
 	<literal>ufsid</literal> 标签列表：</para>
 
       <screen>&prompt.user; <userinput>glabel status</userinput>
                   Name  Status  Components
 ufsid/486b6fc38d330916     N/A  ad4s1d
 ufsid/486b6fc16926168e     N/A  ad4s1f</screen>
 
       <para>在上面的例子中 <filename>ad4s1d</filename>
 	代表了 <filename>/var</filename>
 	文件系统， 而 <filename>ad4s1f</filename> 则代表了
 	<filename>/usr</filename> 文件系统。 您可以使用这些
 	<literal>ufsid</literal> 值来挂载它们， 在
 	<filename>/etc/fstab</filename> 中配置类似这样：</para>
 
       <programlisting>/dev/ufsid/486b6fc38d330916        /var        ufs        rw        2      2
 /dev/ufsid/486b6fc16926168e        /usr        ufs        rw        2      2</programlisting>
 
       <para>所有包含了 <literal>ufsid</literal> 的标签都可以用这种方式挂载，
 	从而消除了需要手工创建永久性标签的麻烦，
 	而又能够提供提供与设备名无关的挂载方式的便利。</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="geom-gjournal">
     <title>通过 GEOM 实现 UFS 日志</title>
 
     <indexterm>
       <primary>GEOM</primary>
     </indexterm>
     <indexterm>
       <primary>日志</primary>
     </indexterm>
 
     <para>随着 &os;&nbsp;7.0 的发布，
       提供了长期为人们所期待的日志功能的实现。 这个实现采用了
       <acronym>GEOM</acronym> 子系统， 可以很容易地使用 &man.gjournal.8; 工具来进行配置。</para>
 
     <para>日志是什么？ 日志的作用是保存文件系统事务的记录， 换言之，
       完成一次完整的磁盘写入操作所需的变动， 这些记录会在元数据以及文件数据写盘之前，
       写入到磁盘中。 这种事务日志可以在随后用于重放并完成文件系统事务，
       以避免文件系统出现不一致的问题。</para>
 
     <para>这种方法是另一种阻止文件系统丢失数据并发生不一致的方法。 与 Soft Updates
       追踪并确保元数据更新顺序这种方法不同，
       它会实际地将日志保存到指定为此项任务保留的磁盘空间上，
       在某些情况下可全部存放到另外一块磁盘上。</para>
 
     <para>与其他文件系统的日志实现不同，
       <command>gjournal</command> 采用的是基于块， 而不是作为文件系统的一部分的方式 -
       它只是作为一种
       <acronym>GEOM</acronym> 扩展实现。</para>
 
     <para>如果希望启用 <command>gjournal</command>，
       &os; 内核需要下列选项 - 这是 &os; 7.0 以及更高版本系统上的默认配置：</para>
 
     <programlisting>options	UFS_GJOURNAL</programlisting>
 
     <para>如果使用日志的卷需要在启动的时候被挂载， 还需加载
       <filename>geom_journal.ko</filename> 内核模块，
       将以下这行加入 <filename>/boot/loader.conf</filename>：</para>
 
     <programlisting>geom_journal_load="YES"</programlisting>
 
     <para>这个功能也可被编译进一个定制的内核，
       需在内核配置文件中加入以下这行：</para>
 
     <programlisting>options	GEOM_JOURNAL</programlisting>
 
     <para>现在， 可以为空闲的文件系统创建日志了。 对于新增的 <acronym>SCSI</acronym> 磁盘
       <filename>da4</filename>， 具体的操作步骤为：</para>
 
     <screen>&prompt.root; <userinput>gjournal load</userinput>
 &prompt.root; <userinput>gjournal label /dev/da4</userinput></screen>
 
     <para>这样， 就会出现一个与
       <filename>/dev/da4</filename> 设备节点对应的
       <filename>/dev/da4.journal</filename> 设备节点。
       接下来， 可以在这个设备上建立文件系统：</para>
 
     <screen>&prompt.root; <userinput>newfs -O 2 -J /dev/da4.journal</userinput></screen>
 
     <para>这个命令将建立一个包含日志设备的
       <acronym>UFS</acronym>2 文件系统。</para>
 
     <para>然后就可以用 <command>mount</command> 命令来挂接设备了：</para>
 
     <screen>&prompt.root; <userinput>mount /dev/da4.journal /mnt</userinput></screen>
 
     <note>
       <para>当磁盘包含多个 slice 时， 每个 slice 上都会建立日志。
 	例如， 如果有 <filename>ad4s1</filename> 和
 	<filename>ad4s2</filename> 这两个 slice，
 	则 <command>gjournal</command> 会建立
 	<filename>ad4s1.journal</filename> 和
 	<filename>ad4s2.journal</filename>。</para>
     </note>
 
     <para>出于性能考虑， 可能会希望在其他磁盘上保存日志。 对于这类情形，
       应该在启用日志的设备后面，给出日志提供者或存储设备。 在暨存的文件系统上，
       可以用 <command>tunefs</command> 来启用日志； 不过，
       在尝试修改文件系统之前， 您应对其进行备份。 多数情况下，
       如果无法创建实际的日志， <command>gjournal</command> 就会失败， 
       并且不会防止由于不当使用 <command>tunefs</command> 而造成的数据丢失。</para>
 
     <para>对于 &os; 系统的启动磁盘使用日志也是可能的。
       请参阅 <link xlink:href="&url.articles.gjournal-desktop;">Implementing UFS Journaling on
 	a Desktop PC</link> 以获得更多详细信息。</para>
   </sect1>
 </chapter>
diff --git a/zh_CN.UTF-8/books/handbook/linuxemu/chapter.xml b/zh_CN.UTF-8/books/handbook/linuxemu/chapter.xml
index 337a3cee1b..55a1ea6b13 100644
--- a/zh_CN.UTF-8/books/handbook/linuxemu/chapter.xml
+++ b/zh_CN.UTF-8/books/handbook/linuxemu/chapter.xml
@@ -1,1107 +1,1107 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      The FreeBSD Documentation Project
 
-     Original Revision: r44899
+     Original Revision: 7cfcff7e6a (r44899)
      $FreeBSD$
 -->
 <chapter xmlns="http://docbook.org/ns/docbook"
          xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
          xml:id="linuxemu">
   <info>
     <title>&linux; 二进制兼容模式</title>
 
     <authorgroup>
       <author>
         <personname>
           <firstname>Jim</firstname>
           <surname>Mock</surname>
         </personname>
         <contrib>Restructured and parts updated by </contrib>
       </author>
       <!-- 22 Mar 2000 -->
     </authorgroup>
 
     <authorgroup>
       <author>
         <personname>
           <firstname>Brian N.</firstname>
           <surname>Handy</surname>
         </personname>
         <contrib>Originally contributed by </contrib>
       </author>
 
       <author>
         <personname>
           <firstname>Rich</firstname>
           <surname>Murphey</surname>
         </personname>
       </author>
     </authorgroup>
   </info>
 
   <sect1 xml:id="linuxemu-synopsis">
     <title>概述</title>
   
     <indexterm>
       <primary>Linux 二进制兼容模式</primary>
     </indexterm>
     <indexterm>
       <primary>二进制兼容模式</primary>
       <secondary>Linux</secondary>
     </indexterm>
 
     <para>&os; 提供了与 &linux; 32-bit 二进制兼容，
       允许用户在 &os; 系统上安装和运行大多数的 32-bit &linux;
       二进制程序而无需做任何修改。 据说在某些情况下， &os; 上运行的
       32-bit &linux; 二进制程序能有更好的表现。</para>
 
     <para>然而， 仍然有一些 &linux; 操作系统特有的功能在 &os;
       上并不被支持。 例如， 要是 &linux; 
       程序过度地使用了诸如启用虚拟 8086 模式 &i386; 特有的调用，
       则无法在 &os; 上运行。 另外， 目前还不支持 64-bit 的 &linux;
       二进制程序。</para>
 
     <para>读完这章，您将了解到：</para>
 
     <itemizedlist>
       <listitem>
          <para>如何在 &os; 系统中启用 &linux; 二进制兼容模式。</para>
       </listitem>
 
       <listitem>
 	    <para>如何安装额外的 &linux; 共享库。</para>
 	  </listitem>
 
       <listitem>
         <para>如何在 &os; 上安装 &linux; 应用程序。</para>
       </listitem>
 
       <listitem>
 	    <para>&os; 上 &linux; 兼容模式的实现细节。</para>
       </listitem>
     </itemizedlist>
 
     <para>在阅读这章之前，您应该知道：</para>
 
     <itemizedlist>
       <listitem>
 	    <para>知道如何安装 <link linkend="ports">
           额外的第三方软件</link>。</para>
       </listitem>
     </itemizedlist>
 
   </sect1>
 
   <sect1 xml:id="linuxemu-lbc-install">
     <title>配置 &linux; 二进制兼容模式</title>
 
     <indexterm><primary>Ports Collection</primary></indexterm>
 
     <para>默认情况下， &linux; 库并没有被安装而且 &linux;
       二进制兼容模式也没有被启动。  &linux; 
       库可以通过手动安装或者使用 &os; 的 Ports Collection。</para>
 
     <para>安装 <package>emulators/linux-base-f10</package> 包或者
       port 是最容易在 &os; 系统上获得一套基本的 &linux; 库的方法。
       使用如下方法安装 port：</para>
 
     <screen>&prompt.root; <userinput>cd /usr/ports/emulators/linux_base-f10</userinput>
 &prompt.root; <userinput>make install distclean</userinput></screen>
 
     <para>安装完成以后， 加载 <literal>linux</literal>
       模块启用 &linux; 二进制兼容模式：</para>
 
     <screen>&prompt.root; <userinput>kldload linux</userinput>userinput></screen>
 
     <para>查看模块是否已经被加载：</para>
 
     <screen>&prompt.user; <userinput>kldstat</userinput>
 Id Refs Address    Size     Name
  1    2 0xc0100000 16bdb8   kernel
  7    1 0xc24db000 d000     linux.ko</screen>
 
     <para>在 <filename>/etc/rc.conf</filename> 中加入以下这行后
       &linux; 兼容模式便会在系统启动时自动开启：</para>
 
     <programlisting>linux_enable="YES"</programlisting>
 
     <indexterm>
       <primary>kernel options</primary>
       <secondary>COMPAT_LINUX</secondary>
     </indexterm>
 
     <para>想要在自制内核中静态链接 &linux; 
       二进制兼容支持的用户可以在自定义的内核配置文件中加入
       <literal>options COMPAT_LINUX</literal>literal>。
       然后按照 <xref linkend="kernelconfig"/>
       中所描述的方法编译并安装新内核。</para>
 
     <sect2 xml:id="linuxemu-libs-manually">
       <title>手动安装额外的库</title>
 
       <indexterm>
         <primary>shared libraries</primary>
       </indexterm>
 
       <para>在配置了 &linux; 兼容模式之后，
         如果某个 &linux; 应用程序依然提示找不到共享库，
         需先找出此 &linux; 二进制程序需要的共享库再手动安装。</para>
 
       <para>在 &linux; 系统上使用 <command>ldd</command>
         找出应用程序所需的共享库文件。 比如，
         在安装有 <application>Doom</application> 的  &linux;
         系统上运行如下的命令列出 <command>linuxdoom</command>
         所需用到的共享库文件：</para>
 
       <screen>&prompt.user; <userinput>ldd linuxdoom</userinput>
 libXt.so.3 (DLL Jump 3.1) =&gt; /usr/X11/lib/libXt.so.3.1.0
 libX11.so.3 (DLL Jump 3.1) =&gt; /usr/X11/lib/libX11.so.3.1.0
 libc.so.4 (DLL Jump 4.5pl26) =&gt; /lib/libc.so.4.6.29</screen>
 
       <indexterm>
         <primary>symbolic links</primary>
       </indexterm>
 
       <para>然后把上面输出中最后一列中的所有文件从 &linux; 
         系统复制到 &os; 上的 <filename>/compat/linux</filename>。
         复制完成之后， 建立指向第一栏中文件名的符号链接。
         这样在 &os; 系统上将会有如下的文件：</para>
 
       <screen>/compat/linux/usr/X11/lib/libXt.so.3.1.0
 /compat/linux/usr/X11/lib/libXt.so.3 -&gt; libXt.so.3.1.0
 /compat/linux/usr/X11/lib/libX11.so.3.1.0
 /compat/linux/usr/X11/lib/libX11.so.3 -&gt; libX11.so.3.1.0
 /compat/linux/lib/libc.so.4.6.29
 /compat/linux/lib/libc.so.4 -&gt; libc.so.4.6.29</screen>
 
       <para>如果已经有了一个与 <command>ldd</command> 
         输出中第一列的主修订号相同的 &linux; 共享库文件，
 	    则不再需要复制最后那列文件， 现有的共享库应该可以正常使用。
         如果是更新版本的共享库通常建议复制。 
         只要有符号链接指向新的版本， 那么就可以删除旧版的了。</para>
 
       <para>比如， &os; 系统中现有这些共享库文件：</para>
 
 	  <screen>/compat/linux/lib/libc.so.4.6.27
 /compat/linux/lib/libc.so.4 -&gt; libc.so.4.6.27</screen>
 
       <para>并且 <command>ldd</command> 指出某个二进制程序需要之后版本：</para>
 
 	  <screen>libc.so.4 (DLL Jump 4.5pl26) -&gt; libc.so.4.6.29</screen>
 
       <para>既然现有文件最后的版本号只相差一到两个版本，
         程序应该可以正常使用稍旧些的版本。 不管怎样，
         使用新版本替换现有 <filename>libc.so</filename> 都是安全的。</para>
 
 	  <screen>/compat/linux/lib/libc.so.4.6.29
 /compat/linux/lib/libc.so.4 -&gt; libc.so.4.6.29</screen>
 
       <para>通常最初几次在 &os; 上安装 &linux; 程序时需要寻找 &linux;
         二进制程序所依赖的共享库文件。 在此之后， 系统里便会有足够多的 &linux;
         共享库文件来运行新安装的 &linux; 二进制程序而无需额外操作。</para>
     </sect2>
 
     <sect2>
       <title>安装 &linux; <acronym>ELF</acronym>
         二进制程序</title>
 
       <indexterm>
 	    <primary>Linux</primary>
 	    <secondary>ELF binaries</secondary>
       </indexterm>
 
       <para><acronym>ELF</acronym> 二进制程序有时需要额外的步骤。
         当未被标记的 <acronym>ELF</acronym> 二进制程序被执行的时候，
         会生成如下的错误信息：</para>
 
       <screen>&prompt.user; <userinput>./my-linux-elf-binary</userinput>
 ELF binary type not known
 Abort</screen>
 
       <para>为了帮助 &os; 内核分辨 &os; <acronym>ELF</acronym>
 	    二进制程序和 &linux; 二进制程序， 请使用 &man.brandelf.1;：</para>
 
       <screen>&prompt.user; <userinput>brandelf -t Linux my-linux-elf-binary</userinput></screen>
 
       <indexterm>
         <primary>GNU toolchain</primary>
       </indexterm>
 
       <para>由于现在的 GNU 工具链能自动把适当的标记信息写入 <acronym>ELF</acronym>
         二进制程序中，这个步骤通常不是必须做的。</para>
     </sect2>
 
     <sect2>
       <title>安装基于 &linux; <acronym>RPM</acronym> 的应用程序</title>
 
       <para>安装基于 &linux; <acronym>RPM</acronym> 的应用程序，
         首先需要安装 <package>archivers/rpm</package> 包或者 port。
         安装好之后 <systemitem class="username">root</systemitem>
         用户就能使用此命令安装 <filename>.rpm</filename> 了：</para>
 
       <screen>&prompt.root; <userinput>cd /compat/linux</userinput>
 &prompt.root; <userinput>rpm2cpio &lt; /path/to/linux.archive.rpm | cpio -id</userinput></screen>
 
       <para>如有必要的话使用 <command>brandelf</command> 标记安装好的
         <acronym>ELF</acronym> 二进制程序。 注意此项安装将无法干净卸载。</para>
     </sect2>
 
     <sect2>
       <title>配置主机名解析器</title>
 
       <para>如果 <acronym>DNS</acronym> 不能正常工作或是出现以下的错误信息：</para>
 
       <screen>resolv+: "bind" is an invalid keyword resolv+:
 "hosts" is an invalid keyword</screen>
 
       <para>请参照此方法配置 <filename>/compat/linux/etc/host.conf</filename>：</para>
 
       <programlisting>order hosts, bind
 multi on</programlisting>
 
       <para>这里指定了先查询 <filename>/etc/hosts</filename>
         再查询 <acronym>DNS</acronym>。 如果
         <filename>/compat/linux/etc/host.conf</filename> 不存在的话，
         &linux; 程序便会读取 	<filename>/etc/host.conf</filename>
         并提示与 &os; 的语法不兼容。 如果没有在
         <filename>/etc/resolv.conf</filename> 文件中配置域名服务器，
         可以删除 <literal>bind</literal>。</para>
     </sect2>
   </sect1>
 
   <?ignore
 
   While the installer works, the binaries do not.  As of Oct 2013,
   Linux emulation is 32-bit but the trial version of Mathematica is
   only available as 64-bit.  This section should be revisited if Linux
   emulation gets 64-bit binary support.
 
   <sect1 xml:id="linuxemu-mathematica">
     <info><title>安装&mathematica;</title>
       <authorgroup>
 	<author><personname><firstname>Boris</firstname><surname>Hollas</surname></personname><contrib>Updated for Mathematica 5.X by </contrib></author>
       </authorgroup>
     </info>
     
 
     <indexterm>
       <primary>applications</primary>
       <secondary><application>Mathematica</application></secondary>
     </indexterm>
 
     <para>这份文档介绍了如何在 FreeBSD 系统中安装 Linux
       版本的 <application>&mathematica; 5.X</application>。</para>
 
     <para>Linux 版本的 <application>&mathematica;</application>
       或 <application>&mathematica; for Students</application>
       可以直接从 Wolfram 的
       <uri xlink:href="http://www.wolfram.com/">http://www.wolfram.com/</uri> 订购。</para>
 
     <sect2>
       <title>运行 &mathematica; 安装程序</title>
 
       <para>首先您应告诉 &os;
 	<application>&mathematica;</application> 的 Linux
 	可执行文件需要使用 Linux ABI。 达到这一目的最简单的办法，
 	是将未加标志的可执行文件的默认 ELF 标记为 Linux，
 	输入下面的命令：</para>
 
       <screen>&prompt.root; <userinput>sysctl kern.fallback_elf_brand=3</userinput></screen>
 
       <para>这会让 &os; 假定所有未加标志的 ELF 可执行文件，
 	都应使用 Linux ABI， 这样就可以直接从 CDROM 执行安装程序了。</para>
 
       <para>接下来， 需要将 <filename>MathInstaller</filename>
 	复制到硬盘上：</para>
 
       <screen>&prompt.root; <userinput>mount /cdrom</userinput>
 &prompt.root; <userinput>cp /cdrom/Unix/Installers/Linux/MathInstaller /localdir/</userinput></screen>
 
       <para>在这个文件的第一行中， 将 <literal>/bin/sh</literal>
 	改为 <literal>/compat/linux/bin/sh</literal>。
 	这样就能确保安装程序是使用 Linux
 	版本的 &man.sh.1; 来运行的。 接下来， 使用文本编辑器或下面的脚本， 把所有的
 	<literal>Linux)</literal> 替换为 <literal>FreeBSD)</literal>。
 	由于 <application>&mathematica;</application>
 	安装程序会调用 <command>uname -s</command> 来检测操作系统，
 	这样做能够让它视 &os; 为一种 类-Linux 操作系统。
 	现在执行 <command>MathInstaller</command>
 	就能安装 <application>&mathematica;</application> 了。</para>
     </sect2>
 
     <sect2>
       <title>修改 &mathematica; 执行文件</title>
 
       <para>在安装
 	<application>&mathematica;</application> 的过程中所创建的脚本，
 	必须首先进行适当的修改才能使用。
 	如果您选择将 <filename>/usr/local/bin</filename>
 	作为
 	<application>&mathematica;</application> 可执行文件的安装路径，
 	则可以在这个目录中找到一些到名为
 	<filename>math</filename>、 <filename>mathematica</filename>、
 	<filename>Mathematica</filename>， 以及
 	<filename>MathKernel</filename> 的文件的符号连接。 您可以使用文本编辑器，
 	或者下面的 shell 脚本来将这些文件中的
 	<literal>Linux)</literal> 改为 <literal>FreeBSD)</literal>：</para>
 
       <programlisting>#!/bin/sh
 cd /usr/local/bin
 for i in math mathematica Mathematica MathKernel
   do sed 's/Linux)/FreeBSD)/g' $i &gt; $i.tmp
   sed 's/\/bin\/sh/\/compat\/linux\/bin\/sh/g' $i.tmp &gt; $i
   rm $i.tmp
   chmod a+x $i
 done</programlisting>
     </sect2>
 
     <sect2>
       <title>获得您的&mathematica; 密码</title>
 
       <indexterm>
 	<primary>以太网</primary>
 	<secondary>MAC地址</secondary>
       </indexterm>
 
       <para>在首次启动 <application>&mathematica;</application>
 	时， 您将被问及一个密码。 如果您还未从 Wolfram 获得密码， 则安装目录中的
 	<command>mathinfo</command> 可以帮助您获得 <quote>machine ID</quote> (计算机 ID)。
 	这个计算机 ID 取决于您第一块以太网卡的 MAC 地址，
 	以确保您不在多台机器上运行
 	<application>&mathematica;</application>。</para>
 
       <para>在通过电子邮件、 电话或传真向 Wolfram 注册时，
 	您需要向他们提供 <quote>machine ID</quote>，
 	探后它们会给您一个与之对应的由一组数字组成的密码。</para>
     </sect2>
 
     <sect2>
       <title>通过网络来运行&mathematica;</title>
 
       <para><application>&mathematica;</application> 使用一些特殊的字体来显示字符，
       与现在使用的标准字体不一样（integrals, sums, Greek letters,等等）。 X协议要求将这些字体安装在
       <emphasis>本地</emphasis>。
       这意味着您需要从<application>&mathematica;</application>的CDROM里面复制这些字体并安装到本地。
 	这些字体一般在CDROM的<filename>/cdrom/Unix/Files/SystemFiles/Fonts</filename>里面，
 	或本地硬盘的<filename>/usr/local/mathematica/SystemFiles/Fonts</filename>。
 	实际的字体在<filename>Type1</filename>和<filename>X</filename>子目录。有很多种方法来使用它们。
 	</para>
 
       <para>第一种方法是把字体复制到一个已存在的目录<filename>/usr/X11R6/lib/X11/fonts</filename>。
       这需要编辑<filename>fonts.dir</filename>文件。添加字体名字进去，并改变第一行的字体数目。
       另外，您也需要在复制字体的目录下执行&man.mkfontdir.1;。
       </para>
 
       <para>第二种方法是复制到 <filename>/usr/X11R6/lib/X11/fonts</filename> 目录：</para>
 
       <screen>&prompt.root; <userinput>cd /usr/X11R6/lib/X11/fonts</userinput>
 &prompt.root; <userinput>mkdir X</userinput>
 &prompt.root; <userinput>mkdir MathType1</userinput>
 &prompt.root; <userinput>cd /cdrom/Unix/Files/SystemFiles/Fonts</userinput>
 &prompt.root; <userinput>cp X/* /usr/X11R6/lib/X11/fonts/X</userinput>
 &prompt.root; <userinput>cp Type1/* /usr/X11R6/lib/X11/fonts/MathType1</userinput>
 &prompt.root; <userinput>cd /usr/X11R6/lib/X11/fonts/X</userinput>
 &prompt.root; <userinput>mkfontdir</userinput>
 &prompt.root; <userinput>cd ../MathType1</userinput>
 &prompt.root; <userinput>mkfontdir</userinput></screen>
 
       <para>现在，添加新的字体目录到您的字体目录：</para>
 
       <screen>&prompt.root; <userinput>xset fp+ /usr/X11R6/lib/X11/fonts/X</userinput>
 &prompt.root; <userinput>xset fp+ /usr/X11R6/lib/X11/fonts/MathType1</userinput>
 &prompt.root; <userinput>xset fp rehash</userinput></screen>
 
       <para>如果您正使用 <application>&xorg;</application> 服务器， 则可以通过修改
 	<filename>xorg.conf</filename> 文件来自动加载它们。</para>
 
       <indexterm><primary>fonts</primary></indexterm>
 
       <para>如果您<emphasis>没有</emphasis>一个叫<filename>/usr/X11R6/lib/X11/fonts/Type1</filename>的目录，
       您可以把<filename>MathType1</filename>改成<filename>Type1</filename>。</para>
     </sect2>
   </sect1>
   -->
 
   <!--
   As of October 2013, the trial version is only available in the
   Professional and Academic editions (not the Student or Personal
   editions) and requires a contact with a product specialist before
   the evaluation download link is made available.
   <sect1 xml:id="linuxemu-maple">
     <info><title>安装&maple;</title>
       <authorgroup>
 	<author><personname><firstname>Aaron</firstname><surname>Kaplan</surname></personname><contrib>Contributed by </contrib></author>
       </authorgroup>
       <authorgroup>
 	<author><personname><firstname>Robert</firstname><surname>Getschmann</surname></personname><contrib>Thanks to </contrib></author>
       </authorgroup>
     </info>
     
 
     <indexterm>
       <primary>应用程序</primary>
       <secondary><application>Maple</application></secondary>
     </indexterm>
 
     <para><application>&maple;</application>是一个类似于<application>&mathematica;</application>的商业数学软件。
     您可以从<uri xlink:href="http://www.maplesoft.com/">http://www.maplesoft.com/</uri>买到这个软件并注册得到一个使用许可。
      要在FreeBSD上安装这个软件，请按照下面的步骤：</para>
 
       <procedure>
 	<step><para>从软件的发行包执行<filename>INSTALL</filename> shell脚本。当进入安装程序的提示符时，
 	选择<quote>RedHat</quote> 选项。典型的安装目录是<filename>/usr/local/maple</filename>。</para></step>
 
         <step><para>如果您不这样做，可以从Maple Waterloo Software (<uri xlink:href="http://register.maplesoft.com/">http://register.maplesoft.com/</uri>)
 	为 <application>&maple;</application> 订购一个授权许可。
 	然后把它复制到 <filename>/usr/local/maple/license/license.dat</filename>。</para></step>
 
         <step><para>通过运行<application>&maple;</application>中的<filename>INSTALL_LIC</filename>安装shell脚本来
 	  安装<application>FLEXlm</application>许可管理器。  指定许可服务器为您的机器名。</para></step>
 
         <step><para>像下面这样Patch您的<filename>/usr/local/maple/bin/maple.system.type</filename>
           文件：</para>
 <programlisting>   ----- snip ------------------
 *** maple.system.type.orig      Sun Jul  8 16:35:33 2001
 --- maple.system.type   Sun Jul  8 16:35:51 2001
 ***************
 *** 72,77 ****
 --- 72,78 ----
           # the IBM RS/6000 AIX case
           MAPLE_BIN="bin.IBM_RISC_UNIX"
           ;;
 +     "FreeBSD"|\
       "Linux")
           # the Linux/x86 case
         # We have two Linux implementations, one for Red Hat and
    ----- snip end of patch -----</programlisting>
 
 	<para>请注意<literal>"FreeBSD"|\</literal>后面没有空格。</para>
 
 	<para>这个补丁指示<application>&maple;</application>把<quote>FreeBSD</quote>识别为一种Linux系统。
 	 <filename>bin/maple</filename> shell脚本调用<filename>bin/maple.system.type</filename>
 	 脚本执行<command>uname -a</command>来查找操作系统名，根据操作系统名，就知道该使用哪个程序。
 	 </para></step>
 
       <step><para>启动许可服务器。</para>
 
 	<para>下面的脚本，安装成<filename>/usr/local/etc/rc.d/lmgrd.sh</filename>，
 	是很方便的启动<command>lmgrd</command>的方法：</para>
 
 	<programlisting>   ----- snip ------------
 
 #! /bin/sh
 PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/usr/X11R6/bin
 PATH=${PATH}:/usr/local/maple/bin:/usr/local/maple/FLEXlm/UNIX/LINUX
 export PATH
 
 LICENSE_FILE=/usr/local/maple/license/license.dat
 LOG=/var/log/lmgrd.log
 
 case "$1" in
 start)
 	lmgrd -c ${LICENSE_FILE} 2&gt;&gt; ${LOG} 1&gt;&amp;2
 	echo -n " lmgrd"
 	;;
 stop)
 	lmgrd -c ${LICENSE_FILE} -x lmdown 2&gt;&gt; ${LOG} 1&gt;&amp;2
 	;;
 *)
 	echo "Usage: `basename $0` {start|stop}" 1&gt;&amp;2
 	exit 64
 	;;
 esac
 
 exit 0
    ----- snip ------------</programlisting></step>
 
 
       <step><para>开始测试<application>&maple;</application>：</para>
 	<screen>&prompt.user; <userinput>cd /usr/local/maple/bin</userinput>
 &prompt.user; <userinput>./xmaple</userinput></screen>
 
 <para>您应该成功启动起来了。记得写信告诉Maplesoft您想要一个本地FreeBSD版本！</para></step>
     </procedure>
 
     <sect2>
       <title>一些缺陷</title>
 
       <itemizedlist>
 	<listitem><para><application>FLEXlm</application>许可管理器可能是一个使用比较困难的工具。
 	关于它的额外的文档可以在<uri xlink:href="http://www.globetrotter.com/">http://www.globetrotter.com/</uri>找到。</para></listitem>
 
 	<listitem><para><command>lmgrd</command>对许可文件非常挑剔，有一点问题就会core dump。
 	正确的许可文件看起来像下面这样：
 	</para>
 
 <programlisting># =======================================================
 # License File for UNIX Installations ("Pointer File")
 # =======================================================
 SERVER chillig ANY
 #USE_SERVER
 VENDOR maplelmg
 
 FEATURE Maple maplelmg 2000.0831 permanent 1 XXXXXXXXXXXX \
          PLATFORMS=i86_r ISSUER="Waterloo Maple Inc." \
          ISSUED=11-may-2000 NOTICE=" Technische Universitat Wien" \
          SN=XXXXXXXXX</programlisting>
 
 	  <note><para>序列号被'X'代替了。 <systemitem>chillig</systemitem>是主机名。</para></note>
 
   	  <para>只要不修改<quote>FEATURE</quote>行，编辑后一般都能工作。</para></listitem>
       </itemizedlist>
     </sect2>
   </sect1>
   -->
 
   <!--
   As of October, 2013, the Linux version of Matlab is only available
   for 64-bit.
 
   <sect1 xml:id="linuxemu-matlab">
     <info><title>安装&matlab;</title>
       <authorgroup>
 	<author><personname><firstname>Dan</firstname><surname>Pelleg</surname></personname><contrib>Contributed by </contrib></author>
 	<!-- daniel+handbook@pelleg.org -->
       </authorgroup>
     </info>
     
 
     <indexterm>
       <primary>应用程序</primary>
       <secondary><application>MATLAB</application></secondary>
     </indexterm>
 
     <para>这一节描述在一个 &os; 上安装Linux版本的<application>&matlab; version 6.5</application>。
     它工作的很好，除了<application>&java.virtual.machine;</application>例外（参考
       <xref linkend="matlab-jre"/>）。</para>
 
     <para>Linux版本的<application>&matlab;</application>可以从MathWorks<uri xlink:href="http://www.mathworks.com">http://www.mathworks.com</uri>订购。请确定您也得到了许可文件或安装说明。
       等您成功后，让他们知道您想要一个本地&os;版本。</para>
 
     <sect2>
       <title>安装&matlab;</title>
 
       <para>请按照下面的步骤安装<application>&matlab;</application>：</para>
 
       <procedure>
 	<step>
 	  <para>以<systemitem class="username">root</systemitem>身份插入安装CD并挂载上。
 	  推荐使用安装脚本，为了启动安装脚本，键入：</para>
 
 	  <screen>&prompt.root; <userinput>/compat/linux/bin/sh /cdrom/install</userinput></screen>
 
 	  <tip>
 	    <para>安装程序是图形的。如果您得到不能打开显示的错误，可以键入
 	      <command>setenv HOME ~USER</command>，
 	      <replaceable>USER</replaceable>是您&man.su.1;成的用户。</para>
 	  </tip>
 	</step>
 
 	<step>
 	  <para>
 	    当问<application>&matlab;</application>的根目录时，键入：
 	    <userinput>/compat/linux/usr/local/matlab</userinput>。</para>
 
 	  <tip>
 	    <para>为了下面的安装过程更方便，在shell提示符下键入
 	    <command>set MATLAB=/compat/linux/usr/local/matlab</command></para>
 	  </tip>
 	</step>
 
 	<step>
 	  <para>根据获得<application>&matlab;</application>许可时的指示来编辑许可文件。</para>
 
 	  <tip>
 	    <para>您可以用您喜欢的编辑器提前准备这个文件，
 	    并在安装程序要您编辑它之前复制到
 	    <filename>$MATLAB/license.dat</filename>
 	    </para>
 	  </tip>
 	</step>
 
 	<step>
 	  <para>完成安装过程</para>
 	</step>
       </procedure>
 
       <para>到这里，您的<application>&matlab;</application>安装已经完成了。
       接下来的步骤是让它和您的&os; 系统<quote>胶合</quote>在一起。</para>
     </sect2>
 
     <sect2>
       <title>许可管理器的启动</title>
       <procedure>
 	<step>
 	  <para>为许可管理器建立符号链接的脚本：</para>
 
 	  <screen>&prompt.root; <userinput>ln -s $MATLAB/etc/lmboot /usr/local/etc/lmboot_TMW</userinput>
 &prompt.root; <userinput>ln -s $MATLAB/etc/lmdown /usr/local/etc/lmdown_TMW</userinput></screen>
 	</step>
 
 	<step>
 	  <para>建立启动文件<filename>/usr/local/etc/rc.d/flexlm.sh</filename>。
 	  下面的例子是一个<filename>$MATLAB/etc/rc.lm.glnx86</filename>的修改版本。
 	  变化的是文件的位置，和模拟Linux下许可管理器的启动。 </para>
 
 	  <programlisting>#!/bin/sh
 case "$1" in
   start)
         if [ -f /usr/local/etc/lmboot_TMW ]; then
               /compat/linux/bin/sh /usr/local/etc/lmboot_TMW -u <replaceable>username</replaceable> &amp;&amp; echo 'MATLAB_lmgrd'
         fi
         ;;
   stop)
 	if [ -f /usr/local/etc/lmdown_TMW ]; then
             /compat/linux/bin/sh /usr/local/etc/lmdown_TMW  &gt; /dev/null 2&gt;&amp;1
 	fi
         ;;
   *)
 	echo "Usage: $0 {start|stop}"
 	exit 1
 	;;
 esac
 
 exit 0</programlisting>
 
 	  <important>
 	    <para>必须使脚本文件可执行：</para>
 
 	    <screen>&prompt.root; <userinput>chmod +x /usr/local/etc/rc.d/flexlm.sh</userinput></screen>
 
 	    <para>您也必须替换<replaceable>username</replaceable>为机器上的一个用户（不要是<systemitem class="username">root</systemitem>）。
 	    </para>
 	  </important>
 	</step>
 
 	<step>
 	  <para>用命令启动许可管理器：</para>
 
 	  <screen>&prompt.root; <userinput>/usr/local/etc/rc.d/flexlm.sh start</userinput></screen>
 	</step>
       </procedure>
     </sect2>
 
     <sect2 xml:id="matlab-jre">
       <title>链接&java;运行时环境</title>
 
       <para>改变<application>&java;</application>运行时环境（JRE），链接到一个可以工作的版本：
       </para>
 
       <screen>&prompt.root; <userinput>cd $MATLAB/sys/java/jre/glnx86/</userinput>
 &prompt.root; <userinput>unlink jre; ln -s ./jre1.1.8 ./jre</userinput></screen>
     </sect2>
 
     <sect2>
       <title>创建&matlab;启动脚本</title>
 
       <procedure>
 	<step>
 	  <para>把下面的启动脚本放到<filename>/usr/local/bin/matlab</filename>：
 	  </para>
 
 	  <programlisting>#!/bin/sh
 /compat/linux/bin/sh /compat/linux/usr/local/matlab/bin/matlab "$@"</programlisting>
 	</step>
 
 	<step>
 	  <para>然后输入命令<command>chmod +x /usr/local/bin/matlab</command>。</para>
 	</step>
       </procedure>
 
       <tip>
 	<para>依赖于您的<package>emulators/linux_base</package>版本，
 	您在运行这个脚本时可能会出错，为了避免错误，编辑<filename>/compat/linux/usr/local/matlab/bin/matlab</filename>，
 	把这行：</para>
 
 	<programlisting>if [ `expr "$lscmd" : '.*-&gt;.*'` -ne 0 ]; then</programlisting>
 
 	<para>（在13.0.1版本是在第410行）改成：</para>
 
 	<programlisting>if test -L $newbase; then</programlisting>
       </tip>
     </sect2>
 
     <sect2>
       <title>Creating a &matlab; Shutdown Script</title>
 
       <para>The following is needed to solve a problem with &matlab;
 	not exiting correctly.</para>
 
       <procedure>
 	<step>
 	  <para>Create a file
 	    <filename>$MATLAB/toolbox/local/finish.m</filename>, and
 	    in it put the single line:</para>
 
 	  <programlisting>! $MATLAB/bin/finish.sh</programlisting>
 
 	  <note><para>The <literal>$MATLAB</literal> is
 	    literal.</para></note>
 
 	  <tip>
 	    <para>In the same directory, you will find the files
 	      <filename>finishsav.m</filename> and
 	      <filename>finishdlg.m</filename>, which let you save
 	      your workspace before quitting.  If you use either of
 	      them, insert the line above immediately after the
 	      <literal>save</literal> command.</para></tip>
 	</step>
 
 	<step>
 	  <para>Create a file
 	    <filename>$MATLAB/bin/finish.sh</filename>, which will
 	    contain the following:</para>
 
 	  <programlisting>#!/usr/compat/linux/bin/sh
 (sleep 5; killall -1 matlab_helper) &amp;
 exit 0</programlisting>
 	</step>
 
 	<step>
 	  <para>Make the file executable:</para>
 
 	  <screen>&prompt.root; <userinput>chmod +x $MATLAB/bin/finish.sh</userinput></screen>
 	</step>
       </procedure>
     </sect2>
 
     <sect2 xml:id="matlab-using">
       <title>使用&matlab;</title>
 
       <para>现在您已经可以键入
 	<command>matlab</command> 并开始使用它了。</para>
     </sect2>
   </sect1>
 
   <sect1 xml:id="linuxemu-oracle">
     <info><title>安装&oracle;</title>
       <authorgroup>
 	<author><personname><firstname>Marcel</firstname><surname>Moolenaar</surname></personname><contrib>Contributed by </contrib></author>
 	<!-- marcel@cup.hp.com -->
       </authorgroup>
     </info>
     
 
     <indexterm>
       <primary>应用程序</primary>
       <secondary><application>Oracle</application></secondary>
     </indexterm>
 
     <sect2>
       <title>前言</title>
       <para>这节描述在FreeBSD上安装Linux版的<application>&oracle; 8.0.5</application>和<application>&oracle; 8.0.5.1 Enterprise Edition</application>。
       </para>
     </sect2>
 
     <sect2>
       <title>安装Linux环境</title>
 
       <para>确信您已经从 Ports Collection 安装了 <package>emulators/linux_base</package> 和
 	<package>devel/linux_devtools</package>。 如果在使用这些 port
 	时遇到困难， 您可能就不得不从 package， 或使用较早版本的 Ports Collection
 	来安装。</para>
 
       <para>如果要运行智能代理， 您还需要安装 Red Hat Tcl 软件包：
 	<filename>tcl-8.0.3-20.i386.rpm</filename>。
 	用于安装官方的 <application>RPM</application>
 	(<package>archivers/rpm</package>) 软件包的命令是：</para>
 
       <screen>&prompt.root; <userinput>rpm -i --ignoreos --root /compat/linux --dbpath /var/lib/rpm package</userinput></screen>
 
       <para><replaceable>包</replaceable>的安装通常不会出错。 </para>
     </sect2>
 
     <sect2>
       <title>创建&oracle;环境</title>
 
       <para>安装<application>&oracle;</application>之前，您需要设置正确的环境。
       这节只描述了在FreeBSD下安装Linux版本<application>&oracle;</application>需要<emphasis>特别</emphasis>注意的地方。
       不像在<application>&oracle;</application>安装指南中所描述的那样。
    </para>
 
       <sect3 xml:id="linuxemu-kernel-tuning">
         <title>调整内核</title>
 	<indexterm><primary>调整内核</primary></indexterm>
 
 	<para>正如<application>&oracle;</application>安装指南描述的那样，您需要设置共享内存的最大值。
 	不要在FreeBSD下使用<literal>SHMMAX</literal>，<literal>SHMMAX</literal>
 	 只是用来计算<literal>SHMMAXPGS</literal>和<literal>PGSIZE</literal>的。
 	 因此要使用<literal>SHMMAXPGS</literal>。所有其他要使用的选项可以参考指南，例如：</para>
 
 	<programlisting>options SHMMAXPGS=10000
 options SHMMNI=100
 options SHMSEG=10
 options SEMMNS=200
 options SEMMNI=70
 options SEMMSL=61</programlisting>
 
 	<para>设置这些选项来适应 <application>&oracle;</application>的使用。</para>
 
 	<para>当然，确信您的内核配置文件中有下面这些选项：</para>
 
 <programlisting>options SYSVSHM #SysV shared memory
 options SYSVSEM #SysV semaphores
 options SYSVMSG #SysV interprocess communication</programlisting>
       </sect3>
 
       <sect3 xml:id="linuxemu-oracle-account">
 
         <title>&oracle;帐号</title>
 
 	<para>创建一个<systemitem class="username">oracle</systemitem>帐号，正如您创建其他帐号一样。
 	<systemitem class="username">oracle</systemitem> 帐号特殊的地方是您需要给它一个Linux shell。
 	添加<literal>/compat/linux/bin/bash</literal>到<filename>/etc/shells</filename>，
 	然后设置<systemitem class="username">oracle</systemitem>帐号的shell为<filename>/compat/linux/bin/bash</filename>。
 	</para>
       </sect3>
 
       <sect3 xml:id="linuxemu-environment">
         <title>环境</title>
 
 	<para>除了普通的<application>&oracle;</application>变量外，
 	比如<envar>ORACLE_HOME</envar>和<envar>ORACLE_SID</envar>，您还必须设置下面的环境变量：</para>
 
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="2">
           <colspec colwidth="1*"/>
           <colspec colwidth="2*"/>
 	    <thead>
 	      <row>
 		<entry>变量</entry>
 
 		<entry>值</entry>
 	      </row>
 	    </thead>
 	    <tbody>
 	      <row>
 		<entry><envar>LD_LIBRARY_PATH</envar></entry>
 
 		<entry><literal>$ORACLE_HOME/lib</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><envar>CLASSPATH</envar></entry>
 
 		<entry><literal>$ORACLE_HOME/jdbc/lib/classes111.zip</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><envar>PATH</envar></entry>
 
 		<entry><literal>/compat/linux/bin
 /compat/linux/sbin
 /compat/linux/usr/bin
 /compat/linux/usr/sbin
 /bin
 /sbin
 /usr/bin
 /usr/sbin
 /usr/local/bin
 $ORACLE_HOME/bin</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
 
         <para>建议在<filename>.profile</filename>里面设置所有的环境变量。一个完整的例子是：
 	</para>
 
 <programlisting>ORACLE_BASE=/oracle; export ORACLE_BASE
 ORACLE_HOME=/oracle; export ORACLE_HOME
 LD_LIBRARY_PATH=$ORACLE_HOME/lib
 export LD_LIBRARY_PATH
 ORACLE_SID=ORCL; export ORACLE_SID
 ORACLE_TERM=386x; export ORACLE_TERM
 CLASSPATH=$ORACLE_HOME/jdbc/lib/classes111.zip
 export CLASSPATH
 PATH=/compat/linux/bin:/compat/linux/sbin:/compat/linux/usr/bin
 PATH=$PATH:/compat/linux/usr/sbin:/bin:/sbin:/usr/bin:/usr/sbin
 PATH=$PATH:/usr/local/bin:$ORACLE_HOME/bin
 export PATH</programlisting>
       </sect3>
     </sect2>
 
     <sect2>
       <title>安装&oracle;</title>
 
       <para>由于 Linux 模拟器的一处小小的差异， 您必须在 <filename>/var/tmp</filename>
 	中创建一个名为 <filename>.oracle</filename> 的目录才能够启动安装程序。
 	需要把它设置为属于 <systemitem class="username">oracle</systemitem> 用户。 接下来，
 	您就可以毫无问题地安装 <application>&oracle;</application> 了。
 	如果您遇到问题， 请首先检查 <application>&oracle;</application>
 	软件包和/或配置文件！安装完 <application>&oracle;</application>
 	之后， 使用下面两节中所说的补丁。</para>
 
       <para>一个比较常见的问题是 TCP 协议适配器安装不正确。
 	其结果是将无法进行任何的 TCP 侦听。 下面的操作将帮助解决此问题：</para>
 
       <screen>&prompt.root; <userinput>cd $ORACLE_HOME/network/lib</userinput>
 &prompt.root; <userinput>make -f ins_network.mk ntcontab.o</userinput>
 &prompt.root; <userinput>cd $ORACLE_HOME/lib</userinput>
 &prompt.root; <userinput>ar r libnetwork.a ntcontab.o</userinput>
 &prompt.root; <userinput>cd $ORACLE_HOME/network/lib</userinput>
 &prompt.root; <userinput>make -f ins_network.mk install</userinput></screen>
 
       <para>不要忘记了再运行一下<filename>root.sh</filename>！</para>
 
     <sect3 xml:id="linuxemu-patch-root">
       <title>修补root.sh</title>
 
 	<para>从CD安装<application>&oracle;</application>时，一些工作需要在<systemitem class="username">root</systemitem>下执行，
 	这些工作都被记录在一个叫<filename>root.sh</filename>的脚本里面。这个脚本被写在<filename>orainst</filename>目录。
 	为了使用<filename>root.sh</filename>来正确定位<command>chown</command>或在Linux本地shell下执行脚本，
 	应该对它进行修补。</para>
 
 	<programlisting>*** orainst/root.sh.orig Tue Oct 6 21:57:33 1998
 --- orainst/root.sh Mon Dec 28 15:58:53 1998
 ***************
 *** 31,37 ****
 # This is the default value for CHOWN
 # It will redefined later in this script for those ports
 # which have it conditionally defined in ss_install.h
 ! CHOWN=/bin/chown
 #
 # Define variables to be used in this script
 --- 31,37 ----
 # This is the default value for CHOWN
 # It will redefined later in this script for those ports
 # which have it conditionally defined in ss_install.h
 ! CHOWN=/usr/sbin/chown
 #
 # Define variables to be used in this script</programlisting>
 
 	<para>当您不从CD安装<application>&oracle;</application>时，
 	您可以从源代码来修补<filename>root.sh</filename>。
 	它叫做<filename>rthd.sh</filename>，定位在源代码树的<filename>orainst</filename>目录。
 	</para>
       </sect3>
 
       <sect3 xml:id="linuxemu-patch-tcl">
 	<title>修补genclntsh</title>
 
 	<para><command>genclntsh</command>脚本用来创建一个简单的共享客户端库。在建立demos时被使用。
 	完成补丁后就注释掉了下面的<envar>PATH</envar>变量：</para>
 
 	<programlisting>*** bin/genclntsh.orig Wed Sep 30 07:37:19 1998
 --- bin/genclntsh Tue Dec 22 15:36:49 1998
 ***************
 *** 32,38 ****
 #
 # Explicit path to ensure that we're using the correct commands
 #PATH=/usr/bin:/usr/ccs/bin export PATH
 ! PATH=/usr/local/bin:/bin:/usr/bin:/usr/X11R6/bin export PATH
 #
 # each product MUST provide a $PRODUCT/admin/shrept.lst
 --- 32,38 ----
 #
 # Explicit path to ensure that we're using the correct commands
 #PATH=/usr/bin:/usr/ccs/bin export PATH
 ! #PATH=/usr/local/bin:/bin:/usr/bin:/usr/X11R6/bin export PATH
 #
 # each product MUST provide a $PRODUCT/admin/shrept.lst</programlisting>
       </sect3>
     </sect2>
 
     <sect2>
       <title>运行&oracle;</title>
 
       <para>如果您已经按上面的指示去操作，您应该可以像在Linux下运行<application>&oracle;</application>了。 </para>
     </sect2>
   </sect1>
   ?>
 
   <sect1 xml:id="linuxemu-advanced">
     <title>高级主题</title>
 
     <para>此章节将讲述是 &linux; 二进制兼容如何工作的，
       内容基于 Terry Lambert <email>tlambert@primenet.com</email> (Message ID:
       <literal>&lt;199906020108.SAA07001@usr09.primenet.com&gt;</literal>)
       发表在 &a.chat; 的邮件。</para>
 
     <indexterm><primary>execution class loader</primary></indexterm>
 
     <para>&os; 有一个叫 <quote>execution class loader</quote> 的抽象层。
       它被嵌入进了 &man.execve.2; 系统调用。</para>
 
     <para>历史上 &unix; 加载器会依靠查看魔数
       （通常是文件的开头 4 至 8 个字节）来确认是否是系统已知的的二进制程序，
       如果是的话， 就会调用二进制程序加载器。</para>
 
     <para>如果它不是二进制类型的程序， &man.execve.2; 调用会返回一个错误，
       shell 则会把它当作 shell 命令执行。
       <quote>不论当前是哪一种 shell</quote> 都会默认做出此种假设。</para>
 
     <para>随后， &man.sh.1; 会检查开头的两个字符，
       如果它们是 <literal>:\n</literal>， 那么就调用 &man.csh.1;。</para>
 
     <para>&os; 有一份加载器列表而不是一个单一的加载器， 并能回退到
       <literal>#!</literal> 加载器来运行 shell 解释器或者 shell 脚本。</para>
 
     <indexterm>
       <primary>ELF</primary>
     </indexterm>
 
     <indexterm>
       <primary>Solaris</primary>
     </indexterm>
 
     <para>为了支持 &linux; <acronym>ABI</acronym>， &os; 看到了二进制 ELF 程序的魔数。
       ELF 加载器会查找一个专用的 <emphasis>标记</emphasis>，
       那是在 ELF 镜像中的一个注释部分， 
       此区域在 SVR4/&solaris; ELF 二进制中并不存在。</para>
 
     <para>要运行 &linux; 二进制程序，
       必须先使用 &man.brandelf.1; 命令 <emphasis>标记</emphasis> 为
       <literal>Linux</literal> 类型：</para>
 
     <screen>&prompt.root; <userinput>brandelf -t Linux file</userinput></screen>
 
     <indexterm>
       <primary>ELF</primary>
       <secondary>标记</secondary>
     </indexterm>
 
     <para>当 ELF 加载器看到了 <literal>Linux</literal>
       标记，便会替换 <literal>proc</literal> 结构中的一个指针。
       所有的系统调用都通过此指针来索引。 除此以外，
       进程被标记以便对 signal trampoline 代码的陷阱向量做特殊处理，
       还有一些其他由 &linux; 内核模块来处理的（细微）修补。</para>
 
     <para>&linux; 系统调用向量包含一个 <literal>sysent[]</literal>
       记录的列表， 它的地址位于内核模块之中。</para>
 
     <para>当一个系统调用被 &linux; 二进制程序调用时，
       陷阱代码会把系统调用函数指针从 <literal>proc</literal> 
       解引用至 &linux; 而不是 &os; 的系统调用入口。</para>
 
     <para>&linux; 模式会动态地 <emphasis>reroots</emphasis> 查找。
       这与 <option>union</option> 文件系统选项是等效的。
       首先会试图在 <filename
     class="directory">/compat/linux/<replaceable>original-path</replaceable></filename>
       目录查找文件。 如果失败了， 就会在 <filename
     class="directory">/<replaceable>original-path</replaceable></filename>
       目录下查找。 这使得需要其它程序的程序得以运行。 例如，&linux;
       工具链都可以在 &linux; <acronym>ABI</acronym> 的支持下运行。
       也就是说 &linux; 二进制程序可以加载并执行 &os; 二进制程序，
       如果当前没有相应的 &linux; 二进制程序，
       可以在 <filename>/compat/linux</filename> 目录树中放置一个
       &man.uname.1; 命令， 使 &linux; 程序不易察觉它们并没有运行在 &linux;
       系统上。</para>
 
     <para>事实上， 在 &os; 内核中有一个 &linux; 内核。
       所有由内核提供的服务的各种底层功能在 &os; 系统调用表的记录和 &linux;
       系统调用表的记录是一样的： 文件系统操作， 虚拟内存操作，
       信号发送， 和 System V IPC。 唯一的不同是 &os; 会得到 &os; 的
       <emphasis>glue</emphasis> 功能， 而 &linux; 程序会得到 &linux; 
       的 <emphasis>glue</emphasis> 功能。 &os; 的 <emphasis>glue</emphasis>
       功能是静态链接入内核的， 而 &linux; 的 <emphasis>glue</emphasis> 
       功能可以静态链接， 或者通过内核模块访问。</para>
 
     <para>严格说来其实并没有真正的模拟， 这是一种 <acronym>ABI</acronym>
       的实现。 有时这被称为 <quote>&linux; 模拟</quote> 
       是因为在实现的时候还没有其他适合的词用来描述。
       要说 &os; 运行 &linux; 二进制程序并不确切，
       因为当时代码并还没有被编译进去。</para>
     </sect1>
 </chapter>
diff --git a/zh_CN.UTF-8/books/porters-handbook/book.xml b/zh_CN.UTF-8/books/porters-handbook/book.xml
index 00d16cd73b..fcdbbe9335 100644
--- a/zh_CN.UTF-8/books/porters-handbook/book.xml
+++ b/zh_CN.UTF-8/books/porters-handbook/book.xml
@@ -1,14227 +1,14227 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE book PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
 	"http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd">
 <!--
      The FreeBSD Documentation Project
      The FreeBSD Simplified Chinese Project
 
-     Original Revision: r37884
+     Original Revision: f9df228e18 (r37884)
      $FreeBSD$
 -->
 <book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="zh_cn">
   <info><title>FreeBSD Porter 手册</title>
     
 
     <authorgroup>
       <author><orgname>The FreeBSD Documentation Project</orgname></author>
     </authorgroup>
 
     <pubdate>2000 年 4 月</pubdate>
 
     <copyright>
       <year>2000</year>
       <year>2001</year>
       <year>2002</year>
       <year>2003</year>
       <year>2004</year>
       <year>2005</year>
       <year>2006</year>
       <year>2007</year>
       <year>2008</year>
       <year>2009</year>
       <year>2010</year>
       <year>2011</year>
       <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation
 	Project</holder>
     </copyright>
 
 
     <authorgroup>
       <author><orgname>&cnproj.freebsd.org;</orgname></author>
     </authorgroup>
 
     <pubdate>2005 年 11 月</pubdate>
 
     <copyright>
       <year>2005</year>
       <year>2006</year>
       <year>2007</year>
       <year>2008</year>
       <year>2009</year>
       <year>2010</year>
       <year>2011</year>
       <holder>&cnproj.freebsd.org;</holder>
     </copyright>
 
     &trademarks;
 
     &legalnotice;
 
     <releaseinfo>$FreeBSD$</releaseinfo>
   </info>
 
     <chapter xml:id="why-port">
       <title>介绍</title>
 
       <para>几乎每个人都是通过 FreeBSD Ports Collection
 	在 FreeBSD 上面装应用程序 (“ports”)的。
 	就像FreeBSD的其它部分一样， 它主要来自于志愿者的努力。
 	所以在阅读这份文档的时候请务必记住这些。</para>
 
       <para>在 FreeBSD 的世界里， 任何人都能提交新的 port，
 	或志愿地维护一个已有的 port， 如果那个 port 没人维护的话 &mdash;
 	不需要任何特殊的权限来做这件事情。</para>
 
     </chapter>
 
     <chapter xml:id="own-port">
       <title>自行制作新 port</title>
 
       <para>那么， 您有兴趣创建自己的 port 或升级现有的 port？
 	太好了。</para>
 
       <para>下面的内容将会提供一些创建FreeBSD port的指导。
 	如果想升级一个现有的 port， 那么您应该在看完这些内容并阅读
 	<xref linkend="port-upgrading"/>。</para>
 
       <para>因为这份文档不是十分详细， 您还应该再参考一下
 	<filename>/usr/ports/Mk/bsd.port.mk</filename>， 所有 port
 	的 Makefile 文件都会包含它。 即使不是每天都去摆弄 Makefile，
 	您也会从那个文件里面获得很多知识， 里面的注释非常详细。
 	还有要补充一下，如果您有其它的问题， 可以给&a.ports;
 	这个 mailing list 发信。</para>
 
       <note>
 	<para>在这份文档里提到的大部分的变量
 	  (<varname><replaceable>VAR</replaceable></varname>)
 	  是不能修改的。 大多 (但不是全部) 都在
 	  <filename>/usr/ports/Mk/bsd.port.mk</filename>
 	  的开始部分进行了介绍； 其它一些也应该可以在那里找到。
 	  注意这些文件使用了非标准的制表符：
 	  <application>Emacs</application> 和
 	  <application>Vim</application> 应该能在打开文件的时候自动识别它，
 	  而 &man.vi.1; 和 &man.ex.1; 则需要在打开文件的时候通过
 	  <command>:set tabstop=4</command> 来修正默认的设置。</para>
       </note>
 
       <para>
         想练练手吗？ 请参阅我们的
         <link xlink:href="http://wiki.freebsd.org/WantedPorts">希望移植的软件列表</link>
         来看看您是否有兴趣完成其中的任务。
       </para>
     </chapter>
 
     <chapter xml:id="quick-porting">
       <title>简单的 port</title>
 
       <para>这一章将介绍如何快速创建一个全新的 port。
 	很多时候， 这点内容是不够的，
 	您需要阅读这份文档中更深入的内容。</para>
 
       <para>首先， 需要取得包含源代码的 tar包， 并把它放到
 	<varname>DISTDIR</varname>变量所指的地方。 默认的情况下， 这应该是
 	<filename>/usr/ports/distfiles</filename>。</para>
 
       <note>
 	<para>下面的内容假定您不需要修改软件的源代码就能在 FreeBSD
 	  上编译通过。 如果需要修改代码， 就需要参考下一章的内容了。</para>
       </note>
 
       <sect1 xml:id="porting-makefile">
 	<title>编写 <filename>Makefile</filename></title>
 
 	<para>最简单的 <filename>Makefile</filename>
 	  应该是这个样子的：</para>
 
 	<programlisting># New ports collection makefile for:   oneko
 # Date created:        5 December 1994
 # Whom:                asami
 #
 # &dollar;FreeBSD&dollar;
 #
 
 PORTNAME=      oneko
 PORTVERSION=   1.1b
 CATEGORIES=    games
 MASTER_SITES=  ftp://ftp.cs.columbia.edu/archives/X11R5/contrib/
 
 MAINTAINER=    asami@FreeBSD.org
 COMMENT=       A cat chasing a mouse all over the screen
 
 MAN1=          oneko.1
 MANCOMPRESSED= yes
 USE_IMAKE=     yes
 
 .include &lt;bsd.port.mk&gt;</programlisting>
 
 	<para>看看您是否能够看懂。 不必担心
 	  <literal>&dollar;FreeBSD&dollar;</literal>
 	  那一行， 当这个 port 被导入到 ports 树里的时候，
 	  CVS 会自动填写它。 您可以在 <link linkend="porting-samplem">
 	    示范的 Makefile</link>那章找到更多的细节。</para>
       </sect1>
 
 
       <sect1 xml:id="porting-desc">
 	<title>创建描述文件</title>
 
 	<para>有 2 个描述文件对于任何一个 port 来说是必须的，
 	  不论它是不是打算成为 package。 它们是
 	  <filename>pkg-descr</filename> 和
 	  <filename>pkg-plist</filename>。 这两个文件使用 <filename>pkg-</filename>
 	  前缀以区别于其它文件。</para><!-- NOT GOOD -->
 
 	<sect2>
 	  <title><filename>pkg-descr</filename> (关于 port 的冗长描述文件)</title>
 
 	  <para>这是 port 里一个较长的描述文件。
 	    使用一段或几段文件文字来简明的描述这个 ports 是用来做什么的。</para>
 
 	  <note>
 	    <para>这 <emphasis> 不是</emphasis> 手册或者对如何
 	      深入使用/编译这个port的说明！ <emphasis>要是您从
 		<filename>README</filename> 或者联机手册里面中复制文字的话，
 		请务必小心</emphasis>； 通常， 它们不是对这个 port
 	      简明扼要的描述， 或者用了难以使用的格式 (比如，
 	      联机手册里有迫使两端对齐的空格)。
 	      如果要移植的软件有官方的WWW网页， 您应该在这里列出来。
 	      使用 <literal>WWW:</literal> 作为前缀来表示
 	      <emphasis>一个</emphasis>网站，
 	      这样其它的自动工具就能正常工作了。</para>
 	  </note>
 
 	  <para>下面是一个简单的
 	    <filename>pkg-descr</filename> 例子：</para>
 
 	  <programlisting>This is a port of oneko, in which a cat chases a poor mouse all over
 the screen.
  :
 (etc.)
 
 WWW: http://www.oneko.org/</programlisting>
 	</sect2>
 
 	<sect2>
 	  <title><filename>pkg-plist</filename> (port 的装箱单)</title>
 
 	  <para>这份文件列出了 port 所要安装的所有文件。 由于 package
 	    也是据此进行打包， 因此它也被称作 <quote>装箱单(packing list)</quote>.
 	    这个文件中， 路径是相对于安装的路径的 (通常是
 	    <filename>/usr/local</filename> 或
 	    <filename>/usr/X11R6</filename>)。 如果您使用
 	    <varname>MAN<replaceable>n</replaceable></varname>
 	    变量的话， 请不要在这里列出任何联机手册。 假如 port
 	    在安装过程中会创建一些目录， 请务必增加对应的
 	    <literal>@dirrm</literal> 行，
 	    以便在 package 被卸载时予以自动删除。</para>
 
 	  <para>下面是一个简单的例子：</para>
 
 	  <programlisting>bin/oneko
 lib/X11/app-defaults/Oneko
 lib/X11/oneko/cat1.xpm
 lib/X11/oneko/cat2.xpm
 lib/X11/oneko/mouse.xpm
 @dirrm lib/X11/oneko</programlisting>
 
 	  <para>参考 &man.pkg.create.1; 的联机手册以获得更多有关装箱单的细节</para>
 
 	  <note>
 	    <para>建议您将这个文件里的所有的文件名按字母排序。
 	      这样， 在升级这个port的时候就能够更方便地核实所做的修改。</para>
 	  </note>
 
 	  <note>
 	    <para>手工创建这样一份列表可能是一件非常枯燥的事情。
 	      如果您的 port 需要安装大量的文件， <link linkend="plist-autoplist">自动创建装箱单</link>
 	      会帮您省下不少时间。</para>
 	  </note>
 
 	  <para>只有一种情况可以不用 <filename>pkg-plist</filename>文件。
 	    如果这个 port 只安装很少量的一些文件或目录的话，
 	    这些文件和目录就可以分别列在 <filename>Makefile</filename> 的
 	    <varname>PLIST_FILES</varname>和<varname>PLIST_DIRS</varname>
 	    变量里。 举个例子来说， 我们可以在上面那个
 	    <filename>oneko</filename> port 里面不用
 	    <filename>pkg-plist</filename>， 而把下面的这几行加到
 	    <filename>Makefile</filename> 里面：</para>
 
 	  <programlisting>PLIST_FILES=    bin/oneko \
                 lib/X11/app-defaults/Oneko \
                 lib/X11/oneko/cat1.xpm \
                 lib/X11/oneko/cat2.xpm \
                 lib/X11/oneko/mouse.xpm
 PLIST_DIRS=     lib/X11/oneko</programlisting>
 
 	  <para>当然， 如果一个 port 不需要给它自己创建目录的话，
 	    就不用设置 <varname>PLIST_DIRS</varname> 变量了。</para>
 
 	  <para>不过， 如果用这种方式来列出 port 要安装的文件和目录的话，
 	    也就无法利用在 &man.pkg.create.1; 里介绍的命令来制作 package 了。
 	    因此， 这种方法只适用于那些简单的 port， 使它们更为简化。 同时，
 	    这种做法也有助于减少 ports collection 中的文件数量。
 	    在采用 <filename>pkg-plist</filename> 之前，
 	    请考虑一下使用这种方法。</para>
 
 	  <para>稍后我们将看到 <filename>pkg-plist</filename>
 	    以及 <varname>PLIST_FILES</varname> 如何处理
 	    <link linkend="plist">更复杂的任务</link>。</para>
 	</sect2>
       </sect1>
 
       <sect1 xml:id="porting-checksum">
 	<title>创建校验和文件</title>
 
 	<para>只要键入 <command>make makesum</command>，
 	  port 便会自动创建 <filename>distinfo</filename>文件。</para>
 
 	<para>如果下载的文件的校验和经常变化，
 	  而您又能确保它们的来源可靠 (比如， 来自于CD制造商，
 	  或每天联编生成的文档文件)， 就应该在 <varname>IGNOREFILES</varname>
 	  里面标明这些文件。 这样， 再运行
 	  <command>make makesum</command> 的时候便不会把这些标记
 	  <literal>IGNORE</literal> 的文件计算在内了。</para>
       </sect1>
 
       <sect1 xml:id="porting-testing">
 	<title>测试 port</title>
 
 	<para>应当确定您的 port 确实做了您希望它们做的事情，
 	  包括打包。下面是需要重点检查的一些重要的工作。</para>
 
 
 	<itemizedlist>
 	  <listitem>
 	    <para><filename>pkg-plist</filename> 中没有包括任何不想安装的文件</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><filename>pkg-plist</filename> 包含了所有应该安装的文件</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>您的 port 能够使用 <buildtarget>reinstall</buildtarget>
 	      多次安装。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>您的 port 能在卸载 (deinstall) 时，
 	      自动完成 <link linkend="plist-cleaning">清理</link></para>
 	  </listitem>
 	</itemizedlist>
 
 	<procedure>
 	  <title>推荐的测试顺序</title>
 	  <step>
 	    <para><command>make install</command></para>
 	  </step>
 
 	  <step>
 	    <para><command>make package</command></para>
 	  </step>
 
 	  <step>
 	    <para><command>make deinstall</command></para>
 	  </step>
 
 	  <step>
 	    <para><command>pkg_add package-name
 	      </command></para>
 	  </step>
 
 	  <step>
 	    <para><command>make deinstall</command></para>
 	  </step>
 
 	  <step>
 	    <para><command>make reinstall</command></para>
 	  </step>
 
 	  <step>
 	    <para><command>make package</command></para>
 	  </step>
 	</procedure>
 
 	<para>确信在 <buildtarget>package</buildtarget> 和
 	  <buildtarget>deinstall</buildtarget> 阶段没有任何警告。
 	  第三步以后， 检查是否所有新建的目录都被正确删除了。
 	  在第四步以后， 试着运行一下所装的软件，
 	  确保当它以 package 方式安装的时候也能正常工作。</para>
 
 	<para>自动化这些步骤最简单的方法是通过 <application>ports tinderbox</application>
 	  来进行测试。 它可以维护 <literal>jails</literal> 并在其中完成全部测试工作，
 	  而不会破坏正在运行的系统的状态。 请参见
 	  <filename>ports/ports-mgmt/tinderbox</filename>
 	  以了解更多的信息。</para>
       </sect1>
 
       <sect1 xml:id="porting-portlint">
 	<title>用 <command>portlint</command> 来检查 port</title>
 
 	<para>请使用 <command>portlint</command> 命令来检查您的 port
 	  是否符合我们的规范。 <package>ports-mgmt/portlint</package>
 	  程序是 ports 套件的一部分。
 	  这个程序的主要功能是帮助您检查
 	  <link linkend="porting-samplem">Makefile</link> 的样式是否符合规范，
 	  以及 <link linkend="porting-pkgname">package</link> 的命名是否得体。</para>
       </sect1>
 
       <sect1 xml:id="porting-submitting">
 	<title>提交新 port</title>
 
 	<para>在提交新 port 之前， 应先阅读 <link linkend="porting-dads"> 该做什么和不该做什么</link> 一节。</para>
 
 	<para>既然已经对所制作的 port 相当满意了， 剩下的工作，
 	  便是将它放进 &os; 的主 ports 树， 以便让更多的人从中受益。
 	  我们并不需要您的 <filename>work</filename>
 	  目录以及 <filename>pkgname.tgz</filename> 包， 因此现在可以删除它们了。
 	  假定您的 port 的名字是 oneko， 接下来要做的是
 	  <command>cd</command> 到
 	  <literal>oneko</literal> 所在的目录， 然后输入命令：
 	  <command>shar `find oneko` &gt; oneko.shar</command></para>
 
 	<para>将这个 <literal>oneko.shar</literal> 文件作为附件，
 	  使用 &man.send-pr.1; 程序提交 (请参阅
 	  <link xlink:href="&url.articles.contributing;/contrib-how.html#CONTRIB-GENERAL">Bug
 	    Reports and General Commentary</link> 以了解关于
 	    &man.send-pr.1; 的进一步详情) 将其送出。 请务必将您的 bug 报告分类 (category) 为
 	  <literal>ports</literal> 并把子分类 (class) 设置为
 	  <literal>change-request</literal>  (不要把报告表及为机密的， 即
 	  <literal>confidential</literal>！)。 此外， 在 PR
 	  的描述 (<quote>Description</quote>) 一栏中的内容应该是 port 的简要介绍
 	  (例如 <varname>COMMENT</varname> 内容的简化版本)，
 	  而 shar 文件则应填入修正 (<quote>Fix</quote>)
 	  栏中。</para>
 
 	<note>
 	  <para>在问题报告里面使用了一段好的描述，
 	    能使我们的工作变得更容易。 习惯上， 我们会使用类似：
 	    <quote>New port: &lt;category&gt;/&lt;portname&gt;
 	    &lt;short description of the port&gt;</quote>
 	    这样的标题来说明这是新的 port。 如果您也使用这样的习惯，
 	    那么我们将更容易更方便地阅读您的 PR，
 	    从而加快处理速度。</para>
 	</note>
 
 	<para>再次声明， <emphasis>不要包含原始的distfile，
 	    <filename>work</filename>目录， 或者您用
 	    <command>make package</command> 制作的包</emphasis>；
 	    此外， 对于新的 port 请务必使用 &man.shar.1;
 	    而不是 &man.diff.1;。</para>
 
 	<para>在您提交的您的 port 以后请耐心等待。
 	  有时在一个 port 正式加入 &os; 之前需要花费好几个月，
 	  尽管也有可能是几天。 您可以查看
 	  <link xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?category=ports">
 	  正等待被 commit 到 &os; 的 port PR</link>。</para>
 
 	<para>一旦我们看过了您的报告， 有必要的话我们会联系您，
 	  并把它放到 ports 树里。 您的名字也会出现在
 	  <link xlink:href="&url.articles.contributors;/contrib-additional.html">Additional FreeBSD Contributors</link>
 	  和其它的文件。 不是很棒吗!? <!-- smiley -->
 	  :-)</para>
       </sect1>
     </chapter>
 
     <chapter xml:id="slow">
       <title>复杂的 Porting</title>
 
       <para>好了， 也许工作没那么简单， port 需要做些修改才能够在
 	FreeBSD 上跑起来。 在这一章里，
 	我们将会一步步举例来介绍应该如何修改来使您的
 	port 能在 FreeBSD 上面运行。</para>
 
       <sect1 xml:id="slow-work">
 	<title>整个系统是如何运转的?</title>
 
 	<para>首先， 这一系列的动作是由用户在您的
 	  port 目录里敲入 <command>make</command> 后发生的。
 	  您也许会发现在另外的一个窗口里阅读一下
 	  <filename>bsd.port.mk</filename> 将会有助于您的理解。</para>
 
 	<para>要是您不是非常明白 <filename>bsd.port.mk</filename>
 	  是做什么的话， 也不用太担心， 很多人都不知道的...
 	  <!-- smiley --><emphasis>:-&gt;</emphasis></para>
 
 	<procedure>
 
 	  <step>
 	    <para><buildtarget>fetch</buildtarget> 会首先被执行。
 	      <buildtarget>fetch</buildtarget> 将检查在本地的
 	      <varname>DISTDIR</varname> 目录里是否存在
 	      tar 包。 如果 <buildtarget>fetch</buildtarget>
 	      没有找到就会查找 Makefile 中定义的
 	      <varname>MASTER_SITES</varname> URL， 还有我们的主
 	      FTP 站点 <uri xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/">ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/</uri>，
 	      在那里我们备份了所有被认可的 distfile。 假设那个
 	      <varname>MASTER_SITES</varname> 站点是直接连在 Internet 上的，
 	      就会试着用 <varname>FETCH</varname> 指定的程序取回
 	      distfile。 如果成功的话， 文件会被保存在<varname>DISTDIR</varname>
 	      所指定的目录以备稍后使用。</para>
 	  </step>
 
 	  <step>
 	    <para>接下来会执行 <buildtarget>extract</buildtarget>。
 	      它会在 <varname>DISTDIR</varname> 中寻找您的
 	      tar 包 (通常是用 gzip 压缩的 tar 包)，然后解压缩到由
 	      <varname>WRKDIR</varname> 所指定的临时目录里
 	      (默认为<filename>work</filename>目录)。</para>
 	  </step>
 
 	  <step>
 	    <para>下一步是执行 <buildtarget>patch</buildtarget>。
 	      首先任何在 <varname>PATCHFILES</varname> 中定义的补丁都会被打上。
 	      然后， 在由 <varname>PATCHDIR</varname> 指定的目录
 	      (默认为 <filename>files</filename>目录)
 	      中发现的<filename>patch-*</filename>，
 	      它们将会以文件名的字母顺序被先后打上。</para>
 	  </step>
 
 	  <step>
 	    <para><buildtarget>configure</buildtarget>会被执行。
 	      这一步骤可能会有以下几种情形。</para>
 
 	    <orderedlist>
 	      <listitem>
 		<para>如果存在 <filename>scripts/configure</filename>，
 		  就会执行它</para>
 	      </listitem>
 
 	      <listitem>
 		<para>如果定义了 <varname>HAS_CONFIGURE</varname>
 		  或者 <varname>GNU_CONFIGURE</varname>， 就会执行
 		  <filename>WRKSRC/configure</filename>。</para>
 	      </listitem>
 
 	      <listitem>
 		<para>如果定义了<varname>USE_IMAGE</varname>， 就会执行
 		  <varname>XMKMF</varname> (默认为: <command>xmkmf
 		    -a</command>)。</para>
 	      </listitem>
 	    </orderedlist>
 	  </step>
 
 	  <step>
 	    <para><buildtarget>build</buildtarget>会被执行。
 	      这一步将会进入ports的工作目录
 	      (<varname>WRKSRC</varname>)
 	      然后进行编译。如果定义了<varname>USE_GMAKE</varname>，
 	      就会使用 GNU <command>make</command>， 反之，
 	      则会使用系统默认的 <command>make</command>。</para>
 	  </step>
 	</procedure>
 
 	<para>以上都是系统默认的步骤。 您也可以定义
 	  <buildtarget>pre-<replaceable>something</replaceable></buildtarget> 或者
 	  <buildtarget>post-<replaceable>something</replaceable></buildtarget>，
 	  或者把以此命名的脚本放到
 	  <filename>scripts</filename> 目录，
 	  它们会在默认的动作之前或之后被执行。</para>
 
 	<para>举个例子， 如果您在您的 <filename>Makefile</filename>
 	  里定义了<buildtarget>post-extract</buildtarget>， 并在
 	  <filename>script</filename> 目录里放了一个
 	  <filename>pre-build</filename> 脚本，
 	  那么在 tar 包解开之后
 	  <buildtarget>post-extract</buildtarget> 将被调用，
 	  <filename>pre-build</filename> 脚本会在默认的编译之前被执行。
 	  我们推荐您在 <filename>Makefile</filename>
 	  定义所有的动作， 如果不是十分复杂的话，
 	  这样， 别人能更容易明白您的 port
 	  需要执行哪些非默认的动作。</para>
 
 	<para>默认的行为都是由 <filename>bsd.port.mk</filename> 定义的
 	  <buildtarget>do-<replaceable>something</replaceable></buildtarget>
 	  来表示的。 例如， port 中用来解压缩的命令是由
 	  <buildtarget>do-extract</buildtarget> 来定义的。
 	  如果您对默认的设置不满意， 可以通过在
 	  <filename>Makefile</filename> 重新定义
 	  <buildtarget>do-<replaceable>someting</replaceable></buildtarget>
 	  来做些改变。</para>
 
 	<note>
 	  <para><quote>主</quote> 动作 (例如
 	    <buildtarget>extract</buildtarget>、
 	    <buildtarget>configure</buildtarget>， 等等)
 	    仅仅是用来确定所有相应的阶段都完成了，
 	    以及调用真实的动作或脚本， 它们不应被修改。
 	    如果您想要修改解压缩这个动作，
 	    可以修改 <buildtarget>do-extract</buildtarget>，
 	    但永远都不要改变 <buildtarget>extract</buildtarget>
 	    的操作！</para>
 	</note>
 
 	<para>我们已经介绍了在用户敲入 <command>make</command>
 	  之后会发生哪些事情了。 接下来我们将进行进一步的学习，
 	  来看一看如何创建一个理想的 port。</para>
       </sect1>
 
       <sect1 xml:id="slow-sources">
 	<title>获取源代码</title>
 
 	<para>获取源代码的 tar 包 (通常是
 	  <filename>foo.tar.gz</filename> 或者
 	  <filename>foo.tar.Z</filename>) 并把它们放进
 	  <varname>DISTDIR</varname>。 最好使用 <emphasis>主流</emphasis> 的版本。</para>
 
 	<para>您需要设置变量 <varname>MASTER_SITES</varname>
 	  来指向原始 tar 包的获取位置。 您可以在
 	  <filename>bsd.sites.mk</filename>
 	  里找到一些速度较快的主流站点。 请使用这些站点 &mdash;
 	  和相关的定义 &mdash; 如果可能的话，
 	  应尽量避免在同一个源代码树里出现大量重复的信息。
 	  这些站点会随着时间而变化，
 	  如果每个人都随意加入的话会使维护变得非常困难。</para>
 
 	<para>如果您找不到一个有很好网络连接的
 	  FTP/HTTP 站点， 或者它们使用了非标准的格式，
 	  您也许就会想在您自己的 FTP 或 HTTP
 	  服务器上放上一份副本。</para>
 
 	<para>如果您找不到可靠的地方放置 distfiles，
 	  我们也可以提供给您一些空间来保存它。
 	  我们自己的 <systemitem>ftp.FreeBSD.org</systemitem>；
 	  然而这只是一个折衷的办法。 distfile 必须放进某人在
 	  <systemitem>freefall</systemitem> 上的
 	  <filename>~/public_distfiles/</filename>
 	  目录中。 可以要求帮助您 commit port 的人来放这个
 	  distfile， 而这个人也需要把 <varname>MASTER_SITES</varname>、
 	  <varname>MASTER_SITE_LOCAL</varname> 以及
 	  <varname>MASTER_SITE_SUBDIR</varname> 的设置，
 	  改为在 <systemitem>freefall</systemitem> 上的用户名。</para>
 
 	<para>如果您的 port 的 distfile 一直在变化，
 	  而作者拒绝改变其版本号， 您可以考虑把 distfiles
 	  放在自己的主页， 并在 <varname>MASTER_SITES</varname>
 	  里把原作者的列为首选位置。 如果可能， 试着与 port
 	  的作者沟通一下让他不要这么做， 这将有助于建立对源代码的控制。
 	  在您的主页上放置您自己的 distfile 会避免用户得到
 	  <errorname>checksum mismatch</errorname>
 	  的错误， 而且能减轻我们 FTP 站点维护人员的工作量。
 	  如果您的port只有一个主站点的话， 我们建议您在自己的网站上做一份备份，
 	  并他列为 <varname>MASTER_SITES</varname>的第2项。</para>
 
 	<para>如果您的 port 需要来自网络上的一些补丁， 请把它们放到
 	  <varname>DISTDIR</varname>里。 不用担心它们跟源代码不是来自同一站点。
 	  我们有办法处理 (参阅下面的
 	  <link linkend="porting-patchfiles">补丁文件</link>)。</para>
       </sect1>
 
       <sect1 xml:id="slow-modifying">
 	<title>修改 port</title>
 
 	<para>解开 tar 包， 对源代码做出合理的修改使得这个 port
 	  能在最新版本的 &os; 上面运行。
 	  一定要 <emphasis>仔细记录</emphasis> 您所做的每处改动，
 	  包括删除、添加、修改的文件等等， 这些修改以后会在您的 port
 	  中以脚本或补丁的方式出现， 并且能通过运行它们来自动完成您对
 	  port 的改动要求。</para>
 
 	<para>如果您的 port 要求用与用户交互/配置来完成编译或安装的话，
 	  您可以看一下 Larry Wall 的经典的 <application>Configure</application>
 	  脚本， 适当地模仿一下。 Port collection 的目的，
 	  就是使每个 port 占用最少的空间，
 	  并做到软件的 <quote>即插即用</quote>。</para>
 
 	<note>
 	  <para>除非明确地声明， 否则您提交给
 	    &os; ports collection 的补丁，
 	    脚本和其它的文件都将以标准的 BSD 版权发布。</para>
 	</note>
       </sect1>
 
       <sect1 xml:id="slow-patch">
 	<title>打补丁</title>
 
 	<para>在您准备制作 port 的过程中， 增加或修改的文件，
 	  都可以通过 &man.diff.1; 来做成补丁。 希望应用到源代码上的每个补丁，
 	  都应保存为单独的文件， 并命名为
 	  <filename>patch-*</filename>， 其中
 	  <replaceable>*</replaceable> 表示将要修改的文件的完整路径名，
 	  例如 <filename>patch-Imakefile</filename> 或
 	  <filename>patch-src-config.h</filename>。 这些文件，
 	  都应保存在 <varname>PATCHDIR</varname>
 	  (通常是 <filename>files/</filename>)， 这里的补丁都会自动应用到源代码上。
 	  所有的补丁必须是相对于
 	  <varname>WRKSRC</varname> 的 (一般而言， 您的 port 会将其
 	  tarball 解压缩在那里， 并完成余下的工作)。 为了让修正和升级更容易，
 	  您应避免使用多个 patch 去修改同一个文件 (例如，
 	  <filename>patch-file</filename> 以及
 	  <filename>patch-file2</filename> 都修改
 	  <filename>WRKSRC/foobar.c</filename>) 这种情况。
 	  需要注意的是， 如果修改的文件的路径中包含下划线
 	  (<literal>_</literal>) 字符， 则在补丁文件名中应使用两个下划线来代替。
 	  例如， 如果需要修改名为 <filename>src/freeglut_joystick.c</filename> 的文件，
 	  补丁文件的名字应为
 	  <filename>patch-src-freeglut__joystick.c</filename>。</para>
 
 	<para>只有 <literal>[-+._a-zA-Z0-9]</literal> 这些字符，
 	  可以出现在补丁的文件名中， 请务必不要使用除这些字符以外的其它字符。
 	  不要把您的补丁命名成 <filename>patch-aa</filename>
 	  或 <filename>patch-ab</filename> 等这样的名字，
 	  最好能在补丁名中提到路径和文件名。</para>
 
 	<para>不要把 RCS 字符串放进补丁。 我们把文件放进 ports
 	  树的时候， CVS 会损坏它们， 当我们再 check out 出来的时候，
 	  它们就会和原来的不一样， 从而导致打补丁失败。 RCS 字符串
 	  是由美元符号 (<literal>&dollar;</literal>) 围绕的，
 	  通常由 <literal>&dollar;Id</literal> 或
 	  <literal>&dollar;RCS</literal> 开头。</para>
 
 	<para>使用 &man.diff.1; 的递归选项(<option>-r</option>)
 	  很好， 但是请检查一下最后输出的 patch，
 	  确保没有任何的垃圾信息。 特别地， 有 2 种文件不需要 diff，
 	  并且应该删除： 一种是 <filename>Makefile</filename>，
 	  当您的port使用了<command>Imake</command>，
 	  或者 GNU <command>configure</command> 等等的话。
 	  如果您不得不编辑<filename>configure.in</filename>
 	  以使 <command>autoconf</command> 去生成
 	  <command>configure</command>， 不要使用
 	  <command>configure</command> 来做 diff
 	  (这常常会有好几千行长!)； 请定义
 	  <literal>USE_AUTOTOOLS=autoconf:261</literal> 并对应
 	  <filename>configure.in</filename> 来制作 diff。</para>
 
 	<para>另外， 您还应尽量减少补丁中非功能性的空格及空白变动。
 	  在开源世界中， 遵循不同的编码规范的项目共享大量代码是很常见的事情。
 	  如果您从某个项目中提取一部分功能用来修正另一个程序中的问题时，
 	  请务必小心： 补丁中很可能到处都是非功能性的变动行。 这不仅会导致 CVS
 	  库的膨胀， 而且也会让导致问题的故障点， 以及您到底修改了什么变得不甚清晰。</para>
 
 	<para>假如需要删除文件， 则应在
 	  <buildtarget>post-extract</buildtarget> target，
 	  而不是作为补丁的一部分来完成。</para>
 
 	<para>除此之外， port 的
 	  <filename>Makefile</filename> 还可以通过 in-place 模式的
 	  &man.sed.1; 来直接进行简单的替换操作。 如果补丁需要使用变量值，
 	  这就非常有用了。 例如：</para>
 
 	<programlisting>post-patch:
 	@${REINPLACE_CMD} -e 's|for Linux|for FreeBSD|g' ${WRKSRC}/README
 	@${REINPLACE_CMD} -e 's|-pthread|${PTHREAD_LIBS}|' ${WRKSRC}/configure</programlisting>
 
 	<para>往往在移植某些软件的时候会遇到这样一种情况，
 	  特别是这个软件是在 &windows; 上开发的时候，
 	  大多数的源代码都需要进行CR/LF的转换。
 	  这很可能会给以后打补丁带来问题， 还可能触发编译警告，
 	  并给脚本的执行带来麻烦 (<command>/bin/sh^M</command> not found)，
 	  等等。 要迅速将所有文件中的 CR/LF 改为只用 LF， 可以在 port 的
 	  <filename>Makefile</filename> 中加入
 	  <literal>USE_DOS2UNIX=yes</literal>。 除此之外，
 	  还可以指定一个需要执行这种转换操作的文件列表：</para>
 
 	<programlisting>USE_DOS2UNIX=    util.c util.h</programlisting>
 
 	<para>如果希望转换一系列目录中的一组文件， 也可以使用
 	  <varname>DOS2UNIX_REGEX</varname>。 它的参数是与
 	  <command>find</command> 兼容的正则表达式。
 	  关于这种格式的说明， 请参阅 &man.re.format.7;。
 	  这个选项对转换所有指定扩展名的文件， 例如只转换源代码文件这样的应用非常有用：</para>
 
 	<programlisting>USE_DOS2UNIX=    yes
 DOS2UNIX_REGEX=  .*\.(c|cpp|h)</programlisting>
 
 	<para>如果您希望基于现存的文件创建补丁， 可以把文件复制为带
 	  <filename>.orig</filename> 扩展名的名字， 然后修改原文件。
 	  然后使用 <buildtarget>makepatch</buildtarget>
 	  目标根据修改在 port 的 <filename>files</filename> 目录中生成补丁文件。</para>
       </sect1>
 
       <sect1 xml:id="slow-configure">
 	<title>配置</title>
 
 	<para>把任何附加的配置命令加进您的
 	  <filename>configure</filename> 脚本并把它保存到
 	  <filename>scripts</filename> 子目录。 如前面提到的那样，
 	  您也能在 <filename>Makefile</filename> 和/或
 	  使用 <filename>pre-configure</filename> 或
 	  <filename>post-configure</filename> 的脚本来做同样的事情。</para>
       </sect1>
 
       <sect1 xml:id="slow-user-input">
 	<title>处理用户输入</title>
 
 	<para>如果您的 port 要求用户的输入以便配置编译、 或安装配置过程，
 	  就必须在 <filename>Makefile</filename> 里设置
 	  <varname>IS_INTERACTIVE</varname> 变量。
 	  如果用户设置了 <envar>BATCH</envar> 的话，
 	  这将让用户能跳过您的 port 来完成
 	  <quote>通宵编译</quote> (如果用户设置了
 	  <envar>INTERACTIVE</envar>的话， 那么 <emphasis>只有</emphasis>
 	  那些要求互动的 port 才会被编译)
 	  这将给那些不停编译 ports 的机器省下很多时间。</para>
 
 	<para>通常我们还建议，
 	  如果对于那些问题能有合理的缺省答案的话， 应检查一下
 	  <varname>PACKAGE_BUILDING</varname> 变量，
 	  并根据其设置决定是否执行关闭交互脚本。
 	  这将允许我们为 CDROM 和 FTP 来编译 package。</para>
       </sect1>
     </chapter>
 
     <chapter xml:id="makefile">
       <title>配置 Makefile</title>
 
       <para>配置 <filename>Makefile</filename> 是相当简单的，
 	我们在此建议您在开始之前看一下现有的例子。
 	在这份手册里也有一个
 	<link linkend="porting-samplem">Makefile例子</link>，
 	照着里面变量的顺序来写能使得您的 port
 	更容易地被其它人看懂。</para>
 
       <para>现在， 当您开始编写您新的<filename>Makefile</filename>
 	的时候， 可以依次思考一下以下的问题：</para>
 
       <sect1 xml:id="makefile-source">
 	<title>作者发布的代码</title>
 
 	<para>放在 <varname>DISTDIR</varname> 中的是不是标准的用 gzip 压缩的
 	  tar 包， 例如 <filename>foozolix-1.2.tar.gz</filename>？
 	  如果是， 可以先略过这一节。 如果不是，
 	  您应当看看是不是要覆盖这些变量： <varname>DISTVERSION</varname>、
 	  <varname>DISTNAME</varname>、
 	  <varname>EXTRACT_CMD</varname>、
 	  <varname>EXTRACT_BEFORE_ARGS</varname>、
 	  <varname>EXTRACT_AFTER_ARGS</varname>、
 	  <varname>EXTRACT_SUFX</varname>，
 	  <varname>DISTFILES</varname>，取决于您 port 的 distfile
 	  格式有多么怪异。 (最常见的一个例子便是
 	  <literal>EXTRACT_SUFX=.tar.Z</literal>， 一般这是因为 tar
 	  包是用 <command>compress</command> 而不是
 	  <command>gzip</command> 压缩的时候。)</para>
 
 	<para>最糟的情况是， 您需要自己编写
 	  <buildtarget>do-extract</buildtarget>
 	  来覆盖默认的定义， 尽管这不常见，
 	  但如果遇到了， 还是需要这么做。</para>
       </sect1>
 
     <sect1 xml:id="makefile-naming">
       <title>命名</title>
 
       <para>Makefile 的第一部分便是 port
 	的名字、 版本号， 以及它所属的分类。</para>
 
       <sect2>
 	<title><varname>PORTNAME</varname> 和 <varname>PORTVERSION</varname></title>
 
 	<para>您应该把 <varname>PORTNAME</varname> 设置为您
 	  port 的名字， <varname>PORTVERSION</varname>
 	  则是 port 的版本号。</para>
       </sect2>
 
       <sect2 xml:id="makefile-naming-revepoch">
 	<title><varname>PORTREVISION</varname> 和
 	  <varname>PORTEPOCH</varname></title>
 
 	<sect3>
 	  <title><varname>PORTREVISION</varname> (port 的修订版本号)</title>
 
 	  <para><varname>PORTEREVISION</varname>
 	    变量是一个单调递增的值， 如果不为
 	    0， 就会被加到包名的后面，
 	    当 <varname>PORTVERSION</varname> 增加
 	    的时候应被置 0 (也就是当官方有新版本发布的时候)。
 	    <varname>PORTREVISION</varname>
 	    会被自动化工具 (比如 &man.pkg.version.1;)
 	    用来检测是否存在可用的新版本。</para>
 
 	  <para>每当 port 发生变化并对生成的
 	    package 的内容或结构有显著影响时，
 	    都应增加 <varname>PORTREVISION</varname>
 	    值。</para>
 
 	  <para>下面是一些应当修改 <varname>PORTREVISION</varname>
 	    的情况：</para>
 
 	  <itemizedlist>
 	    <listitem>
 	      <para>有新的补丁用来修正安全漏洞、
 		错误， 或给 port 添加了新的功能。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>修改了 <filename>Makefile</filename>
 		里编译时开启或禁用的选项。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>修改了要安装文件的列表或安装时的行为
 		(例如， 修改了一个用来给 package
 		初始化数据的脚本， 如 ssh host keys)。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>一个port依赖的共享库版本改变
 		(在这种情况下， 当安装了新版本的共享库，
 		后再去安装较早的软件就会出错，
 		因为它们要依赖老的 libfoo.x
 		而不是libfoo.(x+1))。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>原作者修改了 port distfile， 并且 distfile
 		的新老版本之间用
 		<command>diff -ru</command> 只能发现一些细微的变化，
 		这时我们只需要对
 		<filename>distinfo</filename> 做相应的修正，
 		而不需要修改
 		<varname>PORTVERSION</varname>。</para>
 	    </listitem>
 	  </itemizedlist>
 
 	  <para>不需要修改
 	    <varname>PORTREVISION</varname> 的例子：</para>
 
 	  <itemizedlist>
 	    <listitem>
 	      <para>port 结构风格的改变，
 		但对于打成的包没有功能的上的变化。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para><varname>MASTER_SITES</varname>
 		发生变化， 或进行了对 port 功能的修改，
 		但不致影响最后打成的包。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>对 distfiles 诸如修正拼写错误之类的补丁，
 		对用户而言没有升级上的麻烦。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>对一个原本编译失败的包的修改，
 		使其可编译， 而没有加入新功能。 因为
 		<varname>PORTREVISION</varname>
 		表示包的内容发生了变化，
 		如果先前没有可编译的包， 也就不需要修改
 		<varname>PORTREVISION</varname>
 		来表示变化。</para>
 	    </listitem>
 	  </itemizedlist>
 
 	  <para>一个修改并提交 port 的原则是：
 	    使得别人能从中受益 (改进、 修改已有错误，
 	    或使新的 package 能够运行)，
 	    您还要权衡一下这是否应让那些经常更新
 	    ports 树的人升级，
 	    如果回答是 <quote>是</quote> 的话，
 	    <varname>PORTREVISION</varname>
 	    就应该修改了。</para>
 	</sect3>
 
 	<sect3>
 	  <title><varname>PORTEPOCH</varname> (port 的加权版本号)</title>
 
 	  <para>有时软件商或 FreeBSD 的
 	    porter 会使用比旧版的版本号小的数字做为新版本号的情况。
 	    举例来说， 从
 	    foo-20000801 到 foo-1.0 (从形式上来说这是不对的，
 	    因为 20000801 在数值上比1大很多)。</para>
 
 	  <para>在这种情况下， <varname>PORTEPOCH</varname>
 	    应当增加。 如果
 	    <varname>PORTEPOCH</varname> 非 0，
 	    就应当加到包名字的后面。
 	    <varname>PORTEPOCH</varname>
 	    永远不能被减少或清零，
 	    因为那样会导致与前一时期的 package
 	    比较版本时产生不正确的结果。
 	    (就是说， 那个 package 就不会被检测到已经过时了。)
 	    新的版本号 (比如前面在前面那个例子中的
 	    <literal>1.0,1</literal>) 在数值上比前一个版本
 	    (20000801) 小， 但多数自动化的工具会认为
 	    <literal>,1</literal>
 	    后缀意味着比前一个包的后缀 <literal>,0</literal> 大。</para>
 
 	  <para>错误的去除或重置
 	    <varname>PORTEPOCH</varname>
 	    会导致很多不幸发生； 如果您还不明白前面的讨论，
 	    请多阅读几次直至明白为止，
 	    或到邮件列表上来提问。</para>
 
 	  <para>大多数 port 都不会用到
 	    <varname>PORTEPOCH</varname>，
 	    并且如果某个软件的下一个版本改变了版本号结构的话，
 	    用巧妙的方法来设定 <varname>PORTVERSION</varname>
 	    也能避免使用 <varname>PORTEPOCH</varname>。 然而，
 	    FreeBSD porter 也需要注意， 当有新版本的软件发布，
 	    但并非正式版本时 &mdash; 比如
 	    <quote>snapshot</quote> 版本，
 	    原作者可能会使用当时的日期来命名，
 	    这在新的 <quote>官方</quote> 版本发布的时候，
 	    就很容易引起前面提到的问题。</para>
 
 	  <para>举个例子， 如果 snapshot 版本的发布日期是
 	    20000917， 这个软件的上一个版本是1.2，
 	    那么这个版本的 <varname>PORTVERSIN</varname> 应该设为
 	    1.2.20000917 或类似的样子， 而不是20000917，
 	    这样在 1.3 发布以后，
 	    新版本就可以在数值上大于旧的版本了。</para>
 	</sect3>
 
 	<sect3>
 	  <title>关于 <varname>PORTREVISION</varname> 和
 	    <varname>PORTEPOCH</varname> 的用例</title>
 
 	  <para><literal>gtkmumble</literal> port，版本号
 	    <literal>0.10</literal>， 被提交到
 	    ports collection:</para>
 
 	  <programlisting>PORTNAME=       gtkmumble
 PORTVERSION=    0.10</programlisting>
 
 	  <para><varname>PKGNAME</varname> 变成
 	    <literal>gtkmumble-0.10</literal>。</para>
 
 	  <para>然后有人发现了一个安全漏洞，
 	    需要用一个FreeBSD的补丁。 <varname>PORTREVISION</varname>
 	    就要相应的增加。</para>
 
 	  <programlisting>PORTNAME=       gtkmumble
 PORTVERSION=    0.10
 PORTREVISION=   1</programlisting>
 
 	  <para><varname>PKGNAME</varname>变成了
 	    <literal>gtkmumble-0.10_1</literal></para>
 
 	  <para>软件的作者发布了新的版本， 版本为
 	    <literal>0.2</literal> (作者本来的意思是，
 	    用 <literal>0.10</literal> 表示
 	    <literal>0.1.0</literal>，<quote>而不是指
 	    0.9 之后的那个版本</quote> - 但是现在太迟了)。
 	    因为现在的次版本号 <literal>2</literal>
 	    在数值上比上一个版本 <literal>10</literal> 小，
 	    <varname>PORTEPOCH</varname> 必须增加，
 	    以使新的 package 被认为是 <quote>更新的</quote>。
 	    由于那是作者发布的一个新版本， 因此
 	    <varname>PORTREVISION</varname> 应被置0 (或者从
 	    <filename>Makefile</filename> 里面删除它)。</para>
 
 	  <programlisting>PORTNAME=       gtkmumble
 PORTVERSION=    0.2
 PORTEPOCH=      1</programlisting>
 
 	  <para><varname>PKGNAME</varname> 变成了
 	    <literal>gtkmumble-0.2,1</literal></para>
 
 	  <para>下一个版本将会是 0.3。
 	    由于 <varname>PORTEPOCH</varname> 从不减少，
 	    那么就无须改动：</para>
 
 	  <programlisting>PORTNAME=       gtkmumble
 PORTVERSION=    0.3
 PORTEPOCH=      1</programlisting>
 
 	  <para><varname>PKGNAME</varname> 变成
 	    <literal>gtkmumble-0.3,1</literal></para>
 
 	  <note>
 	    <para>如果在这次升级中 <varname>PORTEPOCH</varname>
 	      被置为了<literal>0</literal>， 那么在装了
 	      <literal>gtkmumble-0.10_1</literal> 包的机器上就无法检测到
 	      <literal>gtkmumble-0.3</literal> 包的更新，
 	      因为 <literal>3</literal> 在数值上比
 	      <literal>10</literal> 小。 记住， 这是
 	      <varname>PORTEPOCH</varname> 最重要的地方。</para>
 	  </note>
 	</sect3>
       </sect2>
 
       <sect2>
 	<title><varname>PKGNAMEPREFIX</varname> 和 <varname>PKGNAMESUFFIX</varname></title>
 
 	<para>2 个可选的变量， <varname>PKGNAMEPREFIX</varname> 和
 	  <varname>PKGNAMESUFFIX</varname> 可以和
 	  <varname>PORTNAME</varname> 还有
 	  <varname>PORTVERSION</varname> 配合使用，
 	  形成像这样的 <varname>PKGNAME</varname>：
 	  <literal>${PKGNAMEPREFIX}${PORTNAME}${PKGNAMESUFFIX}-${PORTVERSION}</literal>。
 	  请确定符合我们的
 	  <link linkend="porting-pkgname">包命名规则</link>。
 	  当然， <emphasis>不</emphasis> 允许在
 	  <varname>PORTVERSION</varname>
 	  中使用连字符 (<literal>-</literal>)。 如果包名有
 	  <replaceable>language-</replaceable> 或
 	  <replaceable>-compiled.specifics</replaceable> 部分 (见下文)，
 	  请分别用 <varname>PKGNAMEPREFIX</varname> 和
 	  <varname>PKGNAMESUFFIX</varname>， 不要直接加到
 	  <varname>PORTNAME</varname> 中。</para>
       </sect2>
 
       <sect2>
 	<title><varname>LATEST_LINK</varname></title>
 
 	<para><varname>LATEST_LINK</varname> 在编译包的过程中用于确定可以为
 	  <command>pkg_add -r</command> 使用的缩短的名字。 举例来说，
 	  在安装最新版本的 perl 的时候， 只需指定
 	  <command>pkg_add -r perl</command> 而无需知道具体的版本号。
 	  这个名字应该是独一无二的， 并且对用户而言应该是显而易见的名字。</para>
 
 	<para>有时， 在 ports 套件中可能会存在同一程序的多个版本。
 	  索引和预编译包的联编系统都需要能够将它们视为不同的软件包， 尽管其
 	  <varname>PORTNAME</varname>、 <varname>PKGNAMEPREFIX</varname>， 甚至
 	  <varname>PKGNAMESUFFIX</varname> 可能是一模一样的。 遇到这种情况时，
 	  就需要将除了 <quote>主</quote> port 之外的其他 port
 	  中的 <varname>LATEST_LINK</varname> 变量设为不同的值
 	  &mdash; 请参见 <filename>lang/gcc46</filename> 和
 	  <filename>lang/gcc</filename> port， 以及
 	  <filename>www/apache*</filename> 系列， 以了解它的用法。
 	  如果设置了 <varname>NO_LATEST_LINK</varname>，
 	  则系统便不会生成对应的连接， 对于非
 	  <quote>主</quote> port 来说是一个可行的选择。
 	  需要注意的是， 如何确定 <quote>主</quote> 版本 &mdash;
 	  <quote>最流行</quote>、 <quote>受支持最好</quote>，
 	  <quote>变动最少</quote>， 等等 &mdash; 已经超过了本书能够给出的建议范围；
 	  这里只是向您介绍在选定了一个
 	  <quote>主</quote> port 之后如何指定其他 port 的版本。</para>
       </sect2>
 
     <sect2 xml:id="porting-pkgname">
       <title>包命名规则</title>
 
       <para>以下是您在命名您的包时应当遵守的规则。
 	这将使得我们放包的目录更利于浏览，
 	因为我们已经有数以万计的包了，
 	如果用户觉得查看包名很困难的话，
 	他们会很快走开的。</para>
 
       <para>一个包的名字应该看起来像这样：
 	<filename>language_region-name-compiled.specifics-version.numbers</filename>。</para>
 
       <para>要像这样来定义包的名字：
 	<literal>${PKGNAMEPREFIX}${PORTNAME}${PKGNAMESUFFIX}-${PORTVERSION}</literal>。
 	确保所有的变量符合上面的格式。</para>
 
       <orderedlist>
 	<listitem>
 	  <para>FreeBSD 会尽力去支持用户当地的语言。
 	    如果这个 port 是某种语言专用的， 那么
 	    <replaceable>language-</replaceable> 部分应该是
 	    由 ISO-639 定义的自然语言的 2 个字母缩写。 比如，
 	    <literal>ja</literal>是表示日本， <literal>ru</literal>
 	    是表示俄罗斯， <literal>vi</literal> 表示越南，
 	    <literal>zh</literal> 表示中国， <literal>ko</literal>
 	    表示韩国， <literal>de</literal> 表示德国。</para>
 
 	  <para>如果是针对某种语言的某一地区的话，
 	    再要加上2个字母的国家代码。 例如，
 	    <literal>en_US</literal> 表示美国英语，
 	    <literal>fr_CH</literal> 表示瑞士法语。</para>
 
 	  <para><replaceable>language-</replaceable> 部分应该在
 	    <varname>PKGNAMEPREFIX</varname> 变量里设置。</para>
 	</listitem>
 
 	<listitem>
 	  <para><filename>name</filename> 部分的首字母应该
 	    小写。 (余下的部分可以包含大写字母， 所以当您
 	    要转换一个包含大写字母软件的名字时， 您需要
 	    自己做出判断。) 对于 <literal>Perl 5</literal>
 	    模块的命名， 有个传统的规则是， 在前面
 	    加上 <literal>p5-</literal>
 	    并把两个冒号的部分改为连字号， 如：
 	    <literal>Data::Dumper</literal> 模块对应的名字， 就应该是
 	    <literal>p5-Data-Dumper</literal>。</para>
 	</listitem>
 
 	<listitem>
 	  <para>确认 port 的名字和版本之间有清晰的分隔， 并放入 <varname>PORTNAME</varname> 和
 	    <varname>PORTVERSION</varname> 变量。 在
 	    <varname>PORTNAME</varname> 中包含版本部分的唯一理由是上游软件包真的采用这样的命名方式，
 	    类似 <filename>textproc/libxml2</filename> 或
 	    <filename>japanese/kinput2-freewnn</filename> port 这样。 否则，
 	    在 <varname>PORTNAME</varname> 中就不应包含任何版本信息。
 	    许多 port 采用同样的 <varname>PORTNAME</varname> 名字是很正常的，
 	    <filename>www/apache*</filename> port 便是如此； 在这种情况下，
 	    不同的版本 (以及不同的索引项) 是由 <varname>PKGNAMEPREFIX</varname>、
 	    <varname>PKGNAMESUFFIX</varname>， 以及
 	    <varname>LATEST_LINK</varname> 的值的不同而有所区别的。</para>
 	</listitem>
 
 	<listitem>
 	  <para>如果 port 可以使用不同的 <link linkend="makefile-masterdir">硬编码默认配置</link>
 	    进行联编 (通常是一系列 port 的一部分目录名)， 则
 	    <replaceable>-compiled.specifics</replaceable>
 	    部分就应该明示编译进去的默认值 (此处连字号是可选的)。
 	    通常的用例包括纸型和不同的字体尺寸。</para>
 
 	  <para><replaceable>-compiled.specifics</replaceable>
 	    部分应该通过 <varname>PKGNAMESUFFIX</varname>
 	    变量来设置。</para>
 	</listitem>
 
 	<listitem>
 	  <para>版本号应该紧随在连字号
 	    (<literal>-</literal>) 后面并由数字和字母组成。
 	    特别指出， 另外的连字号是不允许出现在版本号里的。
 	    唯一例外的是字符串 <literal>pl</literal>
 	    (表示 <quote>patchlevel</quote>)，
 	    <emphasis>只能</emphasis>
 	    用在软件没有主版本号和次版本号的情况下。
 	    如果软件的版本号里出现了像
 	    <quote>alpha</quote>， <quote>beta</quote>，
 	    <quote>rc</quote>， <quote>pre</quote>，
 	    取第一个字母把它放在小数点的后面。
 	    如果在版本号里一直出现那些名字，
 	    那么在数字和字母之间不应有多余的小数点。</para>
 
 	  <para>这个方法是为了更容易得凭版本号来排序 port。
 	    特别注意的是， 确保版本号之间的每部分都由小数点来分隔，
 	    如果日期也是版本号的一部分， 就用这样的格式，
 	    <literal>0.0.yyyy.mm.dd</literal>
 	    这样的格式， 而非
 	    <literal>dd.mm.yyyy</literal>
 	    甚至
 	    <literal>yy.mm.dd</literal>
 	    这种不适合表示千年的格式。 在版本号上使用
 	    <literal>0.0.</literal> 前缀十分重要， 因为当软件发行正式的版本时，
 	    其版本号数字很可能会小于表示年份的
 	    <literal>yyyy</literal> 数字。</para>
 	</listitem>
       </orderedlist>
 
       <para>这里是一些真实的例子，
 	我们藉此说明如何把软件作者对软件的命名，
 	转换为适合我们包的命名方式：</para>
 
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="6">
 	  <thead>
 	    <row>
 	      <entry>发行版的名字</entry>
 	      <entry><varname>PKGNAMEPREFIX</varname></entry>
 	      <entry><varname>PORTNAME</varname></entry>
 	      <entry><varname>PKGNAMESUFFIX</varname></entry>
 	      <entry><varname>PORTVERSION</varname></entry>
 	      <entry>说明</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry>mule-2.2.2</entry>
 	      <entry>(空)</entry>
 	      <entry>mule</entry>
 	      <entry>(空)</entry>
 	      <entry>2.2.2</entry>
 	      <entry>没什么需要修改的</entry>
 	    </row>
 
 	    <row>
 	      <entry>EmiClock-1.0.2</entry>
 	      <entry>(空)</entry>
 	      <entry>emiclock</entry>
 	      <entry>(空)</entry>
 	      <entry>1.0.2</entry>
 	      <entry>程序的名字不能使用大写字母</entry>
 	    </row>
 
 	    <row>
 	      <entry>rdist-1.3alpha</entry>
 	      <entry>(空)</entry>
 	      <entry>rdist</entry>
 	      <entry>(空)</entry>
 	      <entry>1.3.a</entry>
 	      <entry>像 <literal>alpha</literal>
 		这样的字符串是不允许出现的</entry>
 	    </row>
 
 	    <row>
 	      <entry>es-0.9-beta1</entry>
 	      <entry>(空)</entry>
 	      <entry>es</entry>
 	      <entry>(空)</entry>
 	      <entry>0.9.b1</entry>
 	      <entry>像 <literal>beta</literal>
 		这样的字符串是不允许出现的</entry>
 	    </row>
 
 	    <row>
 	      <entry>mailman-2.0rc3</entry>
 	      <entry>(空)</entry>
 	      <entry>mailman</entry>
 	      <entry>(空)</entry>
 	      <entry>2.0.r3</entry>
 	      <entry>像 <literal>rc</literal>
 		这样的字符串是不允许出现的</entry>
 	    </row>
 
 	    <row>
 	      <entry>v3.3beta021.src</entry>
 	      <entry>(空)</entry>
 	      <entry>tiff</entry>
 	      <entry>(空)</entry>
 	      <entry>3.3</entry>
 	      <entry>那个是啥鬼东西？</entry>
 	    </row>
 
 	    <row>
 	      <entry>tvtwm</entry>
 	      <entry>(空)</entry>
 	      <entry>tvtwm</entry>
 	      <entry>(空)</entry>
 	      <entry>pl11</entry>
 	      <entry>总需要有个版本号吧</entry>
 	    </row>
 
 	    <row>
 	      <entry>piewm</entry>
 	      <entry>(空)</entry>
 	      <entry>piewm</entry>
 	      <entry>(空)</entry>
 	      <entry>1.0</entry>
 	      <entry>总需要有个版本号吧</entry>
 	    </row>
 
 	    <row>
 	      <entry>xvgr-2.10pl1</entry>
 	      <entry>(空)</entry>
 	      <entry>xvgr</entry>
 	      <entry>(空)</entry>
 	      <entry>2.10.1</entry>
 	      <entry><literal>pl</literal> 只允许在没有
 		主/次 版本号的情况下才能出现</entry>
 	    </row>
 
 	    <row>
 	      <entry>gawk-2.15.6</entry>
 	      <entry>ja-</entry>
 	      <entry>gawk</entry>
 	      <entry>(空)</entry>
 	      <entry>2.15.6</entry>
 	      <entry>日文版</entry>
 	    </row>
 
 	    <row>
 	      <entry>psutils-1.13</entry>
 	      <entry>(空)</entry>
 	      <entry>psutils</entry>
 	      <entry>-letter</entry>
 	      <entry>1.13</entry>
 	      <entry>纸张大小已经在编译的时候被硬编码到程序里了</entry>
 	    </row>
 
 	    <row>
 	      <entry>pkfonts</entry>
 	      <entry>(空)</entry>
 	      <entry>pkfonts</entry>
 	      <entry>300</entry>
 	      <entry>1.0</entry>
 	      <entry>300dpi 字体的包</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable>
 
       <para>如果在原始的代码里没有版本号，
 	或者原作者并不打算开发另外的版本，
 	就应把版本号设成 <literal>1.0</literal> (就像前面
 	<literal>piewm</literal> 的例子那样)。 否则，
 	要求原始的作者加上版本号或使用日期
 	(<literal>0.0.yyyy.mm.dd</literal>)
 	来作为版本号。</para>
     </sect2>
     </sect1>
 
     <sect1 xml:id="makefile-categories">
       <title>分类</title>
 
       <sect2>
 	<title><varname>CATEGORIES</varname> (所属分类)</title>
 
 	<para>在包制作完成之后，
 	  它会被放在 <filename>/usr/ports/packages/All</filename>，
 	  并建立一系列来自
 	  <filename>/usr/ports/packages</filename>
 	  下子目录的符号连接。 这些子目录的名称是由
 	  <varname>CATEGORIES</varname>
 	  指定的。 这将方便于那些用户在 FTP 站点或 CDROM
 	  的一大堆包里面寻找自己想要的包。 请查看一下
 	  <link linkend="porting-categories">目前的分类表</link>，
 	  并找出一个适合您 port 的分类。</para>
 
 	<para>此列表也会决定您的 port 在 port
 	  目录中的位置。 如果您在这里设定了 1 个以上的分类，
 	  则认为您 port 文件应放到以第一个分类命名的子目录中。 请参阅
 	  <link linkend="choosing-categories">后面</link>
 	  关于如何选择正确分类的更多讨论。</para>
       </sect2>
 
       <sect2 xml:id="porting-categories">
 	<title>目前的分类表</title>
 
 	<para>这是目前 port 中的分类。 那些用星号
 	  (<literal>*</literal>) 标记的是
 	  <emphasis>虚拟</emphasis>分类 &mdash;
 	  它们在ports树里没有相应的子目录，
 	  因而只用来做为次要的分类， 用以方便搜索。</para>
 
 	<note>
 	  <para>对于非虚拟的分类来说，
 	    您会看到在相对应子目录中的 <filename>Makefile</filename>
 	    里有写在 <varname>COMMENT</varname> 里的单行描述。</para>
 	</note>
 
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>分类</entry>
 		<entry>描述</entry>
 		<entry>注意事项</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><filename>accessibility</filename></entry>
 		<entry>帮助残障人士的 port。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>afterstep*</filename></entry>
 		<entry>对于
 		  <link xlink:href="http://www.afterstep.org">AfterStep</link>
 		  窗口管理器的支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>arabic</filename></entry>
 		<entry>阿拉伯语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>archivers</filename></entry>
 		<entry>压缩与备份工具。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>astro</filename></entry>
 		<entry>有关天文学的 port。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>audio</filename></entry>
 		<entry>声音支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>benchmarks</filename></entry>
 		<entry>测评程序。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>biology</filename></entry>
 		<entry>生物学相关的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>cad</filename></entry>
 		<entry>计算机辅助设计工具。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>chinese</filename></entry>
 		<entry>中文语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>comms</filename></entry>
 		<entry>通讯软件。</entry>
 		<entry>大部分是用于串口通讯的。</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>converters</filename></entry>
 		<entry>字符编码转换。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>databases</filename></entry>
 		<entry>数据库。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>deskutils</filename></entry>
 		<entry>在发明计算机以前就已经在桌面上使用的东西。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>devel</filename></entry>
 		<entry>程序开发工具。</entry>
 		<entry>不要把开发库放在这里 &mdash;
 		  除非您再也找不到更合适的分类，
 		  否则就不该放在这个分类里。</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>dns</filename></entry>
 		<entry>DNS 相关的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>docs*</filename></entry>
 		<entry>有关 FreeBSD 文档的 Meta-ports。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>editors</filename></entry>
 		<entry>通用编辑器。</entry>
 		<entry>有特殊用途的编辑器应该被置于相应的分类中
 		  (比如， 数学-方程式
 		  编辑器应该放在 <filename>math</filename> 分类里。</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>elisp*</filename></entry>
 		<entry>Emacs-lisp相关的port。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>emulators</filename></entry>
 		<entry>其它操作系统的模拟器。</entry>
 		<entry>终端模拟器 <emphasis>不应该</emphasis>
 		  属于这个分类 &mdash; 基于 X 的应该放在
 		  <filename>x11</filename> 而基于文本模式的应该放到
 		  <filename>comms</filename> 或 <filename>misc</filename>
 		  中去， 取决于具体的功能。</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>finance</filename></entry>
 		<entry>货币、 金融以及相关的应用程序。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>french</filename></entry>
 		<entry>法语语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>ftp</filename></entry>
 		<entry>FTP 客户端和服务器端的程序。</entry>
 		<entry>如果您的 port 同时支持 FTP 和 HTTP 的话，
 		  把它放进 <filename>ftp</filename> 并把
 		  <filename>www</filename> 做为第二分类。</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>games</filename></entry>
 		<entry>游戏。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>geography*</filename></entry>
 		<entry>与地理学有关的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>german</filename></entry>
 		<entry>德语语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>gnome*</filename></entry>
 		<entry>关于
 		  <link xlink:href="http://www.gnome.org">GNOME</link>
 		  项目的支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>gnustep*</filename></entry>
 		<entry>与 GNUstep 桌面环境有关的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>graphics</filename></entry>
 		<entry>图形图象程序。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>hamradio*</filename></entry>
 		<entry>业余无线电爱好者使用的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>haskell*</filename></entry>
 		<entry>有关 Haskell 编程语言的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>hebrew</filename></entry>
 		<entry>希伯来语语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>hungarian</filename></entry>
 		<entry>匈牙利语语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>ipv6*</filename></entry>
 		<entry>IPv6 相关软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>irc</filename></entry>
 		<entry>IRC 相关程序</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>japanese</filename></entry>
 		<entry>日语语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>java</filename></entry>
 		<entry>与 Java&trade; 编程语言有关的软件。</entry>
 		<entry><filename>java</filename> 分类对 port 而言不应是其唯一的分类。
 		  除了直接与 Java 语言相关的 port 之外，
 		  开发人员应尽量避免使用 <filename>java</filename> 作为
 		  port 的主分类。</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>kde*</filename></entry>
 		<entry><link xlink:href="http://www.kde.org">K 桌面环境 (KDE)</link>
 		  相关的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>kld*</filename></entry>
 		<entry>可加载内核模块。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>korean</filename></entry>
 		<entry>韩语语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>lang</filename></entry>
 		<entry>编程语言。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>linux*</filename></entry>
 		<entry>Linux 相关的应用程序。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>lisp*</filename></entry>
 		<entry>和 Lisp 编程语言有关的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>mail</filename></entry>
 		<entry>电子邮件软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>math</filename></entry>
 		<entry>数值计算和其它数学相关的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>mbone*</filename></entry>
 		<entry>MBone 应用程序。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>misc</filename></entry>
 		<entry>各式各样的实用程序。</entry>
 		<entry>通常不属于其它的任何分类，
 		  如果可能的话， 尽量为您的 port 选择
 		  <literal>misc</literal>
 		  以外的分类， 因为在这里的
 		  port 比较容易被人忽略。</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>multimedia</filename></entry>
 		<entry>多媒体软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>net</filename></entry>
 		<entry>各种网络相关的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>net-im</filename></entry>
 		<entry>即时消息软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>net-mgmt</filename></entry>
 		<entry>网络管理软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>net-p2p</filename></entry>
 		<entry>对等网 (Peer to peer network) 应用程序。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>news</filename></entry>
 		<entry>USENET新闻组相关软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>palm</filename></entry>
 		<entry><link xlink:href="http://www.palm.com/">Palm&trade;</link> 系列相关软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>parallel*</filename></entry>
 		<entry>并行计算相关软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>pear*</filename></entry>
 		<entry>Pear PHP 架构相关软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>perl5*</filename></entry>
 		<entry><application>Perl</application>5 相关的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>plan9*</filename></entry>
 		<entry><link xlink:href="http://www.cs.bell-labs.com/plan9dist/">Plan9</link> 相关程序。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>polish</filename></entry>
 		<entry>波兰语语言语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>ports-mgmt</filename></entry>
 		<entry>用于管理、 安装和开发 FreeBSD ports 和预编译包的 port。</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>portuguese</filename></entry>
 		<entry>葡萄牙语语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>print</filename></entry>
 		<entry>打印相关的软件。</entry>
 		<entry>桌面出版工具 (打印预览工具等等)
 		  也可以放在此分类里。</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>python*</filename></entry>
 		<entry><link xlink:href="http://www.pythong.org/">Python</link> 编程语言相关的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>ruby*</filename></entry>
 		<entry><link xlink:href="http://www.ruby-lang.org/">Ruby</link> 编程语言相关的软件。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>rubygems*</filename></entry>
 		<entry>移植版本的 <link xlink:href="http://www.rubygems.org/">RubyGems</link> 软件包。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>russian</filename></entry>
 		<entry>俄语语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>scheme*</filename></entry>
 		<entry>与 Scheme 语言有关的 port。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>science</filename></entry>
 		<entry>科学相关但不适合放在
 		  <filename>astro</filename>、
 		  <filename>biology</filename>， 以及
 		  <filename>math</filename> 分类的 port。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>security</filename></entry>
 		<entry>安全相关的实用程序。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>shells</filename></entry>
 		<entry>命令行 shell。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>spanish*</filename></entry>
 		<entry>西班牙语支持</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>sysutils</filename></entry>
 		<entry>系统相关的实用程序。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>tcl*</filename></entry>
 		<entry>依赖于 Tcl 运行的 port。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>textproc</filename></entry>
 		<entry>文本处理的实用程序。</entry>
 		<entry>这个分类并不适合于那些应该放到
 		  <filename>print</filename> 的桌面出版工具。</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>tk*</filename></entry>
 		<entry>依赖于 Tk 运行的 port。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>ukrainian</filename></entry>
 		<entry>乌克兰语语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>vietnamese</filename></entry>
 		<entry>越南语语言支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>windowmaker*</filename></entry>
 		<entry>WindowMaker 窗口管理器的相关支持。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>www</filename></entry>
 		<entry>Word Wide Web的相关软件。</entry>
 		<entry>HTML语言相关的支持也可以放在这个分类里。</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>x11</filename></entry>
 		<entry>X Window System以及相关软件。</entry>
 		<entry>这个分类是给那些直接支持X Window System
 		  的软件的。 不要把常规的 X 应用程序也放进这里；
 		  它们中的大多数都应被归类到
 		  <filename>x11-*</filename> (参见下文)。
 		  如果您的 port <emphasis>是</emphasis>
 		  X 应用程序， 应定义 <varname>USE_XLIB</varname>
 		  (使用 <varname>USER_IMAKE</varname> 隐含包括它)，
 		  然后把它放到合适的分类里。</entry>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-clocks</filename></entry>
 		<entry>X11 下的时钟程序。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-drivers</filename></entry>
 		<entry>X11 驱动程序。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-fm</filename></entry>
 		<entry>X11 下的文件管理器。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-fonts</filename></entry>
 		<entry>X11 下的字体以及相关工具。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-servers</filename></entry>
 		<entry>X11 服务器。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-themes</filename></entry>
 		<entry>X11 主题。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-toolkits</filename></entry>
 		<entry>X11 工具包。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>x11-wm</filename></entry>
 		<entry>X11 窗口管理器。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>xfce*</filename></entry>
 		<entry>与
 		  <link xlink:href="http://www.xfce.org/">Xfce</link>
 		  桌面环境有关的 port。</entry>
 		<entry/>
 	      </row>
 
 	      <row>
 		<entry><filename>zope*</filename></entry>
 		<entry><link xlink:href="http://www.zope.org/">Zope</link> 相关的支持。</entry>
 		<entry/>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
       </sect2>
 
       <sect2 xml:id="choosing-categories">
 	<title>选择正确的分类</title>
 
 	<para>由于不少分类是重复的， 您通常在用哪个分类作为您
 	  port 的主分类上做出选择。 下面有几条规则能帮您解决这个问题。
 	  这是一个带优先级的表， 按优先级降序罗列：</para>
 
 	<itemizedlist>
 	  <listitem>
 	    <para>第一个分类必须是个物理的分类 (参阅
 	      <link linkend="porting-categories">前面</link>)。
 	      这对于制作包是必要的。
 	      虚拟分类和物理分类可能在包制作完成后混合在一起。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>对于特定语言的分类通常放在第一位。
 	      例如， 如果您的 port 会安装一些 X11 的日文字体，
 	      那么 <varname>CATEGORIES</varname>那行
 	      就应该是 <filename>japanese x11-fonts</filename>。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>有特定意义的分类应当被列在无特定意义的前面。
 	      例如， HTML 编辑器应该是这样的 <filename>www
 		 editors</filename>， 而不是其它的什么。 同样地，
 	      您不应该列出 <filename>net</filename>， 如果 port 属于
 	      <filename>irc</filename>、 <filename>mail</filename>、
 	      <filename>news</filename>、
 	      <filename>security</filename>， 或是 <filename>www</filename>，
 	      因为 <filename>net</filename> 可以表示它们的超集。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>只有当主要的分类是一门自然语言的时候，
 	      <filename>x11</filename> 能被做为第二分类。
 	      需要特别指出的是， 您不应把 X 的应用程序也归类为
 	      <filename>x11</filename>。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><application>Emacs</application>
 	      模式应当于相应的应用程序放在同一个分类里， 而不是
 	      <filename>editors</filename> 分类。 举例来说，
 	      一个用于编辑某种编程语言源代码的
 	      <application>Emacs</application>
 	      模式应该被归为
 	      <filename>lang</filename> 一类。
 	    </para>
 	  </listitem>
 
           <listitem>
 	    <para>需要安装可加载内核模块的 port 应在其 <varname>CATEGORIES</varname>
 	      中归入虚拟分类 <filename>kld</filename>。
 	    </para>
 	  </listitem>
 
 	  <listitem>
 	    <para><filename>misc</filename>
 	      分类的 port 不能有其它非虚拟的分类。
 	      如果您在您的 <varname>CATEGORIES</varname>
 	      里设了 <literal>misc</literal> 和另外的分类，
 	      那意味着可以安全地删除 <literal>misc</literal>
 	      并把 port 放到其它的子目录中了！</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>如果您的 port 确实不属于现有的分类，
 	      才把它放到 <filename>misc</filename>。</para>
 	  </listitem>
 	</itemizedlist>
 
 	<para>如果您不能确定使用哪个分类， 请在您提交的
 	  &man.send-pr.1; 里加上一行注释，
 	  这样我们就能在导入进 port 树之前讨论一下。
 	  如果您是 committer， 发一份备忘到 &a.ports;
 	  先讨论一下。 很多情况是新的 port 被加到错误的分类里，
 	  然后又立即被移走。这会造成源代码库不必要和不良的膨胀。</para>
       </sect2>
 
       <sect2 xml:id="proposing-categories">
 	<title>如何提议建立新的分类</title>
 
 	<para>由于 Ports Collection 在持续增长， 已经引入了许多新的分类。
 	  新的分类既可以是 <emphasis>虚拟的</emphasis> 分类 &mdash;
 	  这些分类在整个 ports 目录中没有属于自己的子目录 &mdash;
 	  或 <emphasis>物理的</emphasis> 分类 &mdash; 它们有自己的子目录。
 	  接下来我们将讨论与建立新的物理分类有关的事项，
 	  以便帮助您理解如何提议建立新的分类。</para>
 
 	<para>我们目前的做法是避免建立新的物理分类， 除非有非常多的 port
 	  应被归入这一分类， 或者 port 属于某一特定的小团体 (例如，
 	  与某种人类语言相关)， 或两者皆是。</para>
 
 	<para>这样做的原因是这类修改会让 committer 和用户都不得不进行 <link xlink:href="&url.articles.committers-guide;/#ports">许多工作</link>
 	  来在 Ports Collection 进行或追踪修改。 此外，
 	  提议新的分类通常都会引起争论。 (可能这是因为关于某个分类是否
 	  <quote>太大</quote> 一直没有非常一致的意见的缘故，
 	  另一方面， 分类是否能够能够有助于浏览 (以及多少个分类是合适的)，
 	  等等， 也都是问题。)</para>
 
 	<para>下面是具体的步骤：</para>
 
 	<procedure>
 	  <step>
 	    <para>在 &a.ports; 提议新的分类。 您应提供建立新分类的详细依据，
 	      包括为什么认为现有的分类不够， 以及希望移动位置的一系列 port
 	      的名字。 (如果有尚在
 	      <application>GNATS</application> 而未 commit 的 port，
 	      也应一一列出。)  如果您是相关 port 的监护人或提交者，
 	      说明这一情况可能有助于您的提议得到通过。</para>
 	  </step>
 
 	  <step>
 	    <para>参与讨论。</para>
 	  </step>
 
 	  <step>
 	    <para>如果有人支持您的建议， 应及时提交一个 PR，
 	      其中包括提议 PR 的理由， 以及需要移动的 port 的列表。
 	      理想情况下， 这个 PR 也应包含针对下列文件的补丁：</para>
 
 	    <itemizedlist>
 	      <listitem>
 		<para>进行 repocopy 之后对 <filename>Makefile</filename>
 		  进行的修改</para>
 	      </listitem>
 
 	      <listitem>
 		<para>新分类的 <filename>Makefile</filename></para>
 	      </listitem>
 
 	      <listitem>
 		<para>旧分类的 <filename>Makefile</filename></para>
 	      </listitem>
 
 	      <listitem>
 		<para>依赖于旧 port 的 port 的
 		  <filename>Makefile</filename></para>
 	      </listitem>
 
 	      <listitem>
 		<para>(此外， 作为一项加分因素，
 		  您还可以按照 Committer 指南所介绍的流程，
 		  提供一些其它需要修改的文件。)</para>
 	      </listitem>
 	    </itemizedlist>
 	  </step>
 
 	  <step>
 	    <para>由于这是一项影响 ports 基础设施的变动，
 	      它不仅涉及 repo-copy 的使用，
 	      而且也可能会影响联编集群的回归测试操作，
 	      因此这类 PR 应分派给 &a.portmgr;。</para>
 	  </step>
 
 	  <step>
 	    <para>如果这一 PR 得到批准， 某个 committer 将按照在
 	      <link xlink:href="&url.articles.committers-guide;/article.html#PORTS">
 	      Committer 指南</link> 中所介绍的步骤来完成余下的工作。</para>
 	  </step>
 	</procedure>
 
 	<para>提议新的虚拟分类和上述过程类似， 但会容易许多，
 	  因为不需要实际地移动任何 port。 这种情况下， PR 应附带的补丁，
 	  就只需要修改影响到的 port 的 Makefile， 以便在其中的
 	  <varname>CATEGORIES</varname> 中加入新的分类了。</para>
       </sect2>
 
       <sect2 xml:id="proposing-reorg">
 	<title>如何提议对分类进行重新组织</title>
 
 	<para>有些时候会有一些人提议重新将分类组织为 2-层 或某种基于关键字的结构。
 	  目前为止， 还没有进行任何相关的改变， 因为尽管这些修改比较容易完成，
 	  但修改整个 Ports Collection 所需要进行的工作， 至少也是令人生畏的。
 	  在发表您的观点之前， 请阅读在邮件列表存档中历史上所进行过的提议；
 	  此外， 您也会被要求提供一个可用的原形。</para>
       </sect2>
     </sect1>
 
     <sect1 xml:id="makefile-distfiles">
       <title>源码包文件</title>
 
       <para>在 <filename>Makefile</filename> 中的第二部分是描述用于联编 port
 	所必需下载的文件， 以及到什么地方去下载它们。</para>
 
       <sect2>
 	<title><varname>DISTVERSION/DISTNAME</varname> (源码包版本号/名称)</title>
 
 	<para><varname>DISTNAME</varname> 是作者称呼您所 port 软件的名字。
 	  <varname>DISTNAME</varname> 的默认值是
 	  <literal>${PORTNAME}-${PORTVERSION}</literal>，
 	  因此只有在需要时才应手工指定。
 	  <varname>DISTNAME</varname> 只在两个地方用到。 第一处是源码包文件列表
 	  (<varname>DISTFILES</varname>)， 其默认值是
 	  <varname>${DISTNAME}</varname><varname>${EXTRACT_SUFX}</varname>。
 	  第二处是源码包应被展开到的目录名，
 	  即 <varname>WRKSRC</varname> 所指定的目录，
 	  其默认值是 <filename>work/${DISTNAME}</filename>。</para>
 
         <para>某些软件作者发布源码包的时候并不采取
 	  <literal>${PORTNAME}-${PORTVERSION}</literal> 这样的模式，
 	  这可以通过设置 <varname>DISTVERSION</varname> 来自动处理。
 	  <varname>PORTVERSION</varname> 和 <varname>DISTNAME</varname>
 	  会自动地展开， 当然， 也可以改掉它。 下表给出了一些例子：</para>
 
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry><varname>DISTVERSION</varname></entry>
 		<entry><varname>PORTVERSION</varname></entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry>0.7.1d</entry>
 		<entry>0.7.1.d</entry>
 	      </row>
 
 	      <row>
 		<entry>10Alpha3</entry>
 		<entry>10.a3</entry>
 	      </row>
 
 	      <row>
 		<entry>3Beta7-pre2</entry>
 		<entry>3.b7.p2</entry>
 	      </row>
 
 	      <row>
 		<entry>8:f_17</entry>
 		<entry>8f.17</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
 
 	<note>
 	  <para><varname>PKGNAMEPREFIX</varname> 和
 	    <varname>PKGNAMESUFFIX</varname> 并不影响
 	    <varname>DISTNAME</varname>。 此外还应注意
 	    <varname>WRKSRC</varname> 等于
 	    <filename>work/${PORTNAME}-${PORTVERSION}</filename>，
 	    而源代码的压缩包则可能是
 	    <varname>${PORTNAME}-${PORTVERSION}${EXTRACT_SUFX}</varname>
 	    以外的其它名字。 一般情况下应该保持 <varname>DISTNAME</varname>
 	    不变 &mdash; 更好的方法是定义
 	    <varname>DISTFILES</varname> 而不是同时设置
 	    <varname>DISTNAME</varname> 和 <varname>WRKSRC</varname>
 	    (可能还有 <varname>EXTRACT_SUFX</varname>)。</para>
 	</note>
       </sect2>
 
       <sect2>
 	<title><varname>MASTER_SITES</varname> (主流下载站点)</title>
 
 	<para>记录 FTP/HTTP-URL 指向 <varname>MASTER_SITES</varname>
 	  中原始压缩档的目录部分。 不要忘了结尾的斜线
 	  (<filename>/</filename>)！</para>
 
 	<para><command>make</command> 宏将尝试使用
 	  <varname>FETCH</varname> 来抓取所指定的源码包文件，
 	  如果无法在本地系统中找到这些文件的话。</para>
 
 	<para>建议您指定多个镜像站点， 最好是在不同的大洲上的。
 	  这样将有效地防止由于大范围网络问题所导致无法下载的问题。
 	  我们甚至打算增加自动检测距离最近的站点并从那里下载的功能；
 	  使用多个站点是这样做的重要一步。</para>
 
 	<para>如果原始的源码包可以从比较流行的软件下载站点，
 	  例如 SourceForge、 GNU 或是 Perl CPAN 等等来获得，
 	  您可能会希望使用类似
 	  <varname>MASTER_SITE_<replaceable>*</replaceable></varname>
 	  这样的缩写来表示它们
 	  (例如 <varname>MASTER_SITE_SOURCEFORGE</varname>、
 	  <varname>MASTER_SITE_GNU</varname> 以及
 	  <varname>MASTER_SITE_PERL_CPAN</varname>)。 只需将
 	  <varname>MASTER_SITES</varname> 设为这些变量， 并使用
 	  <varname>MASTER_SITE_SUBDIR</varname> 来指定路径就可以了。
 	  下面是一个例子：</para>
 
 	<programlisting>MASTER_SITES=         ${MASTER_SITE_GNU}
 MASTER_SITE_SUBDIR=   make</programlisting>
 
 	<para>此外， 您还可以用更为简略的格式：</para>
 
 	<programlisting>MASTER_SITES=	GNU/make</programlisting>
 
 	<para>这些变量是在
 	  <filename>/usr/ports/Mk/bsd.sites.mk</filename> 中定义的。
 	  新项目会随时增加， 因此在您提交 port 之前，
 	  应先看一看这个文件的最新版本。</para>
 
 	<para>针对常用软件下载站的许多 <emphasis>暗黑魔法</emphasis> 宏，
 	  还能够自动判断目录的结构。 对于这些站点，
 	  只要使用与之对应的缩写， 系统便会自动为您生成相关的子目录配置。</para>
 
 	<programlisting>MASTER_SITES=	SF</programlisting>
 
 	<para>如果系统猜测的路径不对， 则可以使用下面这样的配置来替换。</para>
 
 	<programlisting>MASTER_SITES=	SF/stardict/WyabdcRealPeopleTTS/${PORTVERSION}</programlisting>
 
 	<table frame="none">
 	  <title>常用的魔术 <varname>MASTER_SITES</varname> 宏</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>宏</entry>
 
 		<entry>自动猜测的子目录</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><varname>APACHE_JAKARTA</varname></entry>
 
 		<entry><varname>/dist/jakarta/${PORTNAME:S,-,,/,}/source</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>BERLIOS</varname></entry>
 
 		<entry><varname>/${PORTNAME:L}</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>CHEESESHOP</varname></entry>
 
 		<entry><varname>/packages/source/source/${DISTNAME:C/(.).*/\1/}/${DISTNAME:C/(.*)-[0-9].*/\1/}</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>DEBIAN</varname></entry>
 
 		<entry><varname>/debian/pool/main/${PORTNAME:C/^((lib)?.).*$/\1/}/${PORTNAME}</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>GCC</varname></entry>
 
 		<entry><varname>/pub/gcc/releases/${DISTNAME}</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>GNOME</varname></entry>
 
 		<entry><varname>/pub/GNOME/sources/${PORTNAME}/${PORTVERSION:C/^([0-9]+\.[0-9]+).*/\1/}</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>GNU</varname></entry>
 
 		<entry><varname>/gnu/${PORTNAME}</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>MOZDEV</varname></entry>
 
 		<entry><varname>/pub/mozdev/${PORTNAME:L}</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>PERL_CPAN</varname></entry>
 
 		<entry><varname>/pub/CPAN/modules/by-module/${PORTNAME:C/-.*//}</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>PYTHON</varname></entry>
 
 		<entry><varname>/ftp/python/${PYTHON_PORTVERSION:C/rc[0-9]//}</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>RUBYFORGE</varname></entry>
 
 		<entry><varname>/${PORTNAME:L}</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>SAVANNAH</varname></entry>
 
 		<entry><varname>/${PORTNAME:L}</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>SF</varname></entry>
 
 		<entry><varname>/project/${PORTNAME:L}/${PORTNAME:L}/${PORTVERSION}</varname></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
       </sect2>
 
       <sect2>
 	<title><varname>EXTRACT_SUFX</varname> (压缩包所用的扩展名)</title>
 
 	<para>如果您有一个源码包文件，
 	  而它使用了某种怪异的扩展名来表达压缩方法， 应设置
 	  <varname>EXTRACT_SUFX</varname>。</para>
 
 	<para>例如， 如果源码包文件的名字是
 	  <filename>foo.tgz</filename> 而非更为一般的
 	  <filename>foo.tar.gz</filename>， 您应写上：</para>
 
 	<programlisting>DISTNAME=      foo
 EXTRACT_SUFX=  .tgz</programlisting>
 
 	<para><varname>USE_BZIP2</varname> 和 <varname>USE_ZIP</varname>
 	  变量会自动根据需要将 <varname>EXTRACT_SUFX</varname> 设置为
 	  <literal>.tar.bz2</literal> 或 <literal>.zip</literal>。
 	  如果这两个都没设置， 则 <varname>EXTRACT_SUFX</varname> 的
 	  默认值将是 <literal>.tar.gz</literal>。</para>
 
 	<note>
 	  <para>任何时候都不需要同时设置 <varname>EXTRACT_SUFX</varname> 和
 	    <varname>DISTFILES</varname>.</para>
 	</note>
       </sect2>
 
       <sect2>
 	<title><varname>DISTFILES</varname> (全部源代码包)</title>
 
 	<para>有些时候所下载的文件名字和 port 的名字没有任何联系。
 	  例如， 可能是 <filename>source.tar.gz</filename>，
 	  或者与此类似的其它名字。 也有一些其它的应用软件，
 	  它们的源代码可能被存放到了不同的压缩包中， 而且全都需要下载。</para>
 
 	<para>如果遇到这种情况， 可以将 <varname>DISTFILES</varname>
 	  设置为以空格分隔的一组需要下载的文件列表。</para>
 
 	<programlisting>DISTFILES=     source1.tar.gz source2.tar.gz</programlisting>
 
 	<para>如果没有予以明确的设置， <varname>DISTFILES</varname> 的默认值将是
 	  <literal>${DISTNAME}${EXTRACT_SUFX}</literal>。</para>
       </sect2>
 
       <sect2>
 	<title><varname>EXTRACT_ONLY</varname> (只解压缩部分源文件)</title>
 
 	<para>如果只有一部分 <varname>DISTFILES</varname> 需要解压缩
 	  &mdash; 例如， 其中的一个是源代码， 而其它则是未压缩的文档 &mdash;
 	  此时应把那些需要解压缩的文件加到
 	  <varname>EXTRACT_ONLY</varname> 中。</para>
 
 	<programlisting>DISTFILES=     source.tar.gz manual.html
 EXTRACT_ONLY=  source.tar.gz</programlisting>
 
 	<para>如果 <varname>DISTFILES</varname> 中 <emphasis>没有</emphasis>
 	  需要解压缩的文件， 则应将 <varname>EXTRACT_ONLY</varname> 设为空串。</para>
 
 	<programlisting>EXTRACT_ONLY=</programlisting>
       </sect2>
 
       <sect2 xml:id="porting-patchfiles">
 	<title><varname>PATCHFILES</varname> (通过下载得到的补丁文件)</title>
 
 	<para>如果您的 port 需要来自 FTP 或 HTTP 的一些额外的补丁，
 	  应将 <varname>PATCHFILES</varname> 设置为这些文件的名字，
 	  并将 <varname>PATCH_SITES</varname> 指向包含这些文件的目录的 URL
 	  (格式与 <varname>MASTER_SITES</varname> 相同)。</para>
 
 	<para>如果这些补丁， 由于包含了其它的目录名，
 	  而导致它们不是相对于源代码目录的顶级目录
 	  (也就是 <varname>WRKSRC</varname>) 的话，
 	  就需要相应地设置 <varname>PATCH_DIST_STRIP</varname> 了。
 	  例如， 如果补丁中所有的目录名前面都有一个多余的
 	  <literal>foozolix-1.0/</literal>， 就应设置
 	  <literal>PATCH_DIST_STRIP=-p1</literal>。</para>
 
 	<para>不需要担心补丁文件本身是否是压缩的； 如果文件名以
 	  <filename>.gz</filename> or <filename>.Z</filename>
 	  结尾， 系统会自动解压缩。</para>
 
 	<para>如果补丁是同某些其它文件， 例如文档， 一同以 gzip 压缩的 tar
 	  格式发布的， 就不能简单地使用
 	  <varname>PATCHFILES</varname> 了。 这种情况下，
 	  您应将这些补丁包的文件和位置加入到
 	  <varname>DISTFILES</varname> 和 <varname>MASTER_SITES</varname>
 	  中。 然后， 用 <varname>EXTRA_PATCHES</varname> 变量来指出这些文件，
 	  这样 <filename>bsd.port.mk</filename> 就会自动地为您应用这些补丁了。
 	  需要特别注意的是， <emphasis>不要</emphasis> 将补丁文件复制到
 	  <varname>PATCHDIR</varname> 目录中 &mdash; 这个目录可能是不可写的。</para>
 
 	<note>
 	  <para>压缩包会以同源代码一样的方式解压缩， 因此不需要自行完成解压缩操作，
 	    并复制补丁文件。 如果您一定要这样做， 就要注意，
 	    不要让解压缩出来的文件覆盖先前已经存在的文件。
 	    此外， 这么做还需要手工增加命令，
 	    以便在 <buildtarget>pre-clean</buildtarget> target
 	    中删除这些复制出来的文件。</para>
 	</note>
       </sect2>
 
       <sect2 xml:id="porting-master-sites-n">
 	<title>来自不同站点的多个源代码包或补丁文件
 	  (<literal>MASTER_SITES:n</literal>)</title>
 
 	<para>(这一节在某种程度上应被视作 <quote>进阶话题</quote>；
 	  刚开始阅读这份文档的读者可能会希望先跳过这一部分)。</para>
 
 	<para>这一节提供了被称作 <literal>MASTER_SITES:n</literal> 和
 	  <literal>MASTER_SITES_NN</literal> 的下载控制机制。
 	  这里我们把它们称为 <literal>MASTER_SITES:n</literal>。</para>
 
 	<para>首先给出一些背景。 OpenBSD 在其 <varname>DISTFILES</varname> 和
 	  <varname>PATCHFILES</varname> 变量中提供了一个很棒的功能，
 	  即， 允许这些文件和补丁拥有 <literal>:n</literal>
 	  后缀， 其中 <literal>n</literal> 可以使用
 	  <literal>[0-9]</literal>， 来表达组。 例如：</para>
 
 	<programlisting>DISTFILES=      alpha:0 beta:1</programlisting>
 
 	<para>在 OpenBSD 中， 源码包文件 <filename>alpha</filename>
 	  应被关联到变量
 	  <varname>MASTER_SITES0</varname> 而不是公共的
 	  <varname>MASTER_SITES</varname> 变量上； 而
 	  <filename>beta</filename> 则应关联到
 	  <varname>MASTER_SITES1</varname> 上。</para>
 
 	<para>这是一个很有意思的功能，
 	  它可以避免无休止地搜索正确的下载站点的过程。</para>
 
 	<para>想象 <varname>DISTFILES</varname> 中指定了 2 个文件，
 	  而 <varname>MASTER_SITES</varname> 包含了 20 个站点的情形，
 	  这其中许多站点慢如蜗牛， 而 <filename>beta</filename> 可以在
 	  <varname>MASTER_SITES</varname> 的所有站点找到， 而
 	  <filename>alpha</filename> 只能在第 20 个上面找到。
 	  如果监护人了解这一点， 那么检查所有的站点无疑是在浪费时间，
 	  不是吗？ 这显然不是开始一个愉快周末的好办法！</para>
 
 	<para>现在您有了一个感性的认识了， 想象一下
 	  <varname>DISTFILES</varname> 和更多的
 	  <varname>MASTER_SITES</varname>。 显然， 我们的
 	  <quote>distfiles 调查员先生</quote>
 	  会感谢您减少他浪费在等待下载上所耗费的时间。</para>
 
 	<para>下一节中， 将按照 FreeBSD 对上述想法的实现来加以阐释。
 	  我们对 OpenBSD 所提出的概念进行了一些改进。</para>
 
 	<sect3>
 	  <title>简化信息</title>
 
 	  <para>这一节将介绍如何迅速地对从不同的站点以及子目录下载多个源码包和补丁进行精确的控制。
 	    这里， 我们将描述 <literal>MASTER_SITES:n</literal> 的一种简化用法。
 	    对于多数情况而言这样做是足够的。 然而， 如果您需要更多信息，
 	    还需要参考下面的几节。</para>
 
 	  <para>一些应用程序需要从多个站点下载不同的源码包。 例如，
 	    <application>Ghostscript</application> 包括了程序核心本身，
 	    以及大量的驱动文件， 以及则取决于用户的打印机品牌和型号的驱动程序。
 	    某些驱动文件已经随程序核心附带， 但也有很多需要从其它站点下载。</para>
 
 	  <para>为了适应这种需要， 每一个
 	    <varname>DISTFILES</varname> 项应跟随一个冒号，
 	    以及一个 <quote>标签名</quote>。 在
 	    <varname>MASTER_SITES</varname> 的每个站点也应跟随冒号和标签名，
 	    以便指定从哪个网站下载源码包文件。</para>
 
 	  <para>例如， 考虑一个将源代码包分为两部分，
 	    即 <filename>source1.tar.gz</filename>
 	    和 <filename>source2.tar.gz</filename> 的软件，
 	    它必须从两个不同的站点下载。 port 的
 	    <filename>Makefile</filename> 应包括类似
 	    <xref linkend="ports-master-sites-n-example-simple-use-one-file-per-site"/>
 	    的配置。</para>
 
 	  <example xml:id="ports-master-sites-n-example-simple-use-one-file-per-site">
 	    <title>简化的 <literal>MASTER_SITES:n</literal>
 	      用法， 每个文件来自一个站点</title>
 
 	    <programlisting>MASTER_SITES=   ftp://ftp.example1.com/:source1 \
 		ftp://ftp.example2.com/:source2
 DISTFILES=      source1.tar.gz:source1 \
 		source2.tar.gz:source2</programlisting>
 	  </example>
 
 	  <para>多个源码包可以使用同一个标签。 继续前面的例子，
 	    假定增加了第三个源码包， <filename>source3.tar.gz</filename>，
 	    应从 <systemitem>ftp.example2.com</systemitem> 下载。
 	    <filename>Makefile</filename> 的这部分应写成
 	    <xref linkend="ports-master-sites-n-example-simple-use-more-than-one-file-per-site"/>
 	    的样子。</para>
 
 	  <example xml:id="ports-master-sites-n-example-simple-use-more-than-one-file-per-site">
 	    <title>简化的 <literal>MASTER_SITES:n</literal> 用法，
 	      其中同一个站点上提供了不止一个文件</title>
 
 	    <programlisting>MASTER_SITES=   ftp://ftp.example1.com/:source1 \
 		ftp://ftp.example2.com/:source2
 DISTFILES=      source1.tar.gz:source1 \
 		source2.tar.gz:source2 \
 		source3.tar.gz:source2</programlisting>
 	  </example>
 	</sect3>
 
 	<sect3>
 	  <title>深入介绍</title>
 
 	  <para>前面的例子无法满足您的需求？ 这一节，
 	    我们将详细介绍 <literal>MASTER_SITES:n</literal>
 	    的精细控制是如何工作的， 以及如何修改您的 port
 	    来使用它们。</para>
 
 	  <orderedlist>
 	    <listitem>
 	      <para>元素可以包含
 		<literal>:n</literal> 这样的后缀， 其中
 		<replaceable>n</replaceable> 是
 		<literal>[^:,]+</literal>， 概念上即
 		<replaceable>n</replaceable> 可以取任意数字或字母，
 		但我们目前将其限定为
 		<literal>[a-zA-Z_][0-9a-zA-Z_]+</literal>。</para>
 
 	      <para>此外， 字符串匹配时对大小写是敏感的；
 		换言之， <literal>n</literal> 与
 		<literal>N</literal> 不同。</para>
 
 	      <para>但是， 由于表达特殊的意义， 下列单词不能用于后缀：
 		<literal>default</literal>、 <literal>all</literal> 和
 		<literal>ALL</literal> (它们会在 <xref linkend="porting-master-sites-n-what-changes-in-port-targets"/>
 		中介绍的部分用到)。 此外， <literal>DEFAULT</literal>
 		是一个有特殊用途的词 (请参见 <xref linkend="porting-master-sites-n-DEFAULT-group"/>)。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>后缀为 <literal>:n</literal>
 		的项目属于 <literal>n</literal> 组， 而
 		<literal>:m</literal> 属于
 		<literal>m</literal> 组， 依此类推。</para>
 	    </listitem>
 
 	    <listitem xml:id="porting-master-sites-n-DEFAULT-group">
 	      <para>没有后缀的元素是无组的， 也就是它们都属于那个特殊的
 		<literal>DEFAULT</literal> 组。 给元素加入
 		<literal>DEFAULT</literal> 后缀通常是多余的，
 		除非您有同时属于 <literal>DEFAULT</literal> 和其它组的元素
 		(参见 <xref linkend="porting-master-sites-n-comma-operator"/>)。</para>
 
 	      <para>下面的例子是等价的， 但通常应适用第一个：</para>
 
 	      <programlisting>MASTER_SITES=   alpha
 
 MASTER_SITES=   alpha:DEFAULT</programlisting>
 	    </listitem>
 
 	    <listitem>
 	      <para>组之间不是互斥的， 同一元素可以同时隶属于多个组，
 		而组则可以为空或者有任意多个元素。 同一组中的重复元素，
 		并不会被自动消去。</para>
 	    </listitem>
 
 	    <listitem xml:id="porting-master-sites-n-comma-operator">
 	      <para>如果希望同一元素同时属于多个组， 可以用逗号
 		(<literal>,</literal>) 分开。</para>
 
 	      <para>这种办法可以避免仅为指定不同的组而多次重复同一元素。 例如
 		<literal>:m,n,o</literal> 表示这个元素同时属于
 		<literal>m</literal>、 <literal>n</literal> 和 <literal>o</literal>
 		这三组。</para>
 
 	      <para>下面这些写法都是等价的， 但只推荐使用最后一种：</para>
 
 	      <programlisting>MASTER_SITES=   alpha alpha:SOME_SITE
 
 MASTER_SITES=   alpha:DEFAULT alpha:SOME_SITE
 
 MASTER_SITES=   alpha:SOME_SITE,DEFAULT
 
 MASTER_SITES=   alpha:DEFAULT,SOME_SITE</programlisting>
 	    </listitem>
 
 	    <listitem>
 	      <para>同一组中的所有站点， 会根据
 		<varname>MASTER_SORT_AWK</varname> 排序。
 		在 <varname>MASTER_SITES</varname> 和
 		<varname>PATCH_SITES</varname> 中的组也会进行排序。</para>
 	    </listitem>
 
 	    <listitem xml:id="porting-master-sites-n-group-semantics">
 	      <para>在 <varname>MASTER_SITES</varname>、
 		<varname>PATCH_SITES</varname>、
 		<varname>MASTER_SITE_SUBDIR</varname>、
 		<varname>PATCH_SITE_SUBDIR</varname>、
 		<varname>DISTFILES</varname>， 以及
 		<varname>PATCHFILES</varname> 中， 都可以使用组，
 		其语法为：</para>
 
 	      <orderedlist>
 		<listitem>
 		  <para>所有 <varname>MASTER_SITES</varname>、
 		    <varname>PATCH_SITES</varname>、
 		    <varname>MASTER_SITE_SUBDIR</varname> 以及
 		    <varname>PATCH_SITE_SUBDIR</varname> 的元素， 都必须以
 		    <literal>/</literal> 字符结尾。 如果有元素属于某些组，
 		    则组后缀
 		    <literal>:n</literal>
 		    必须出现在终结符
 		    <literal>/</literal> 之后。
 		    <literal>MASTER_SITES:n</literal> 机制依赖于
 		    <literal>/</literal> 的存在， 以避免在 <literal>:n</literal>
 		    是元素一部分， 而 <literal>:n</literal> 同时又表示组
 		    <literal>n</literal> 时发生混淆。 为了兼容性的考虑，
 		    因为之前 <literal>/</literal> 终结符在
 		    <varname>MASTER_SITE_SUBDIR</varname> 和
 		    <varname>PATCH_SITE_SUBDIR</varname> 元素中都不是必需的，
 		    如果后缀所紧跟的字符不是 <literal>/</literal>，
 		    则 <literal>:n</literal> 将被认为是元素的一部分，
 		    而不被当作组后缀， 即使元素拥有 <literal>:n</literal>
 		    后缀。 请参见 <xref linkend="ports-master-sites-n-example-detailed-use-master-site-subdir"/>
 		    和 <xref linkend="ports-master-sites-n-example-detailed-use-complete-example-master-sites"/>
 		    以了解进一步的细节。</para>
 
 		  <example xml:id="ports-master-sites-n-example-detailed-use-master-site-subdir">
 		    <title>在 <varname>MASTER_SITE_SUBDIR</varname> 中
 		      <literal>MASTER_SITES:n</literal> 的详细用法</title>
 
 		    <programlisting>MASTER_SITE_SUBDIR=     old:n new/:NEW</programlisting>
 
 		    <itemizedlist>
 		      <listitem>
 			<para>组 <literal>DEFAULT</literal> 中的目录
 			  -&gt; old:n</para>
 		      </listitem>
 
 		      <listitem>
 			<para>组 <literal>NEW</literal> 中的目录
 			  -&gt; new</para>
 		      </listitem>
 		    </itemizedlist>
 		  </example>
 
 		  <example xml:id="ports-master-sites-n-example-detailed-use-complete-example-master-sites">
 		      <title>用到逗号分隔符、 多个文件， 多个站点和
 			不同子目录的 <literal>MASTER_SITES:n</literal>
 			详细用法</title>
 
 		    <programlisting>MASTER_SITES=   http://site1/%SUBDIR%/ http://site2/:DEFAULT \
 		http://site3/:group3 http://site4/:group4 \
 		http://site5/:group5 http://site6/:group6 \
 		http://site7/:DEFAULT,group6 \
 		http://site8/%SUBDIR%/:group6,group7 \
 		http://site9/:group8
 DISTFILES=      file1 file2:DEFAULT file3:group3 \
 		file4:group4,group5,group6 file5:grouping \
 		file6:group7
 MASTER_SITE_SUBDIR=     directory-trial:1 directory-n/:groupn \
 			directory-one/:group6,DEFAULT \
 			directory</programlisting>
 
 		    <para>前述的例子的结果是下述的对于下载行为的精细控制。
 		      站点的列表按照使用的顺序给出。</para>
 
 		    <itemizedlist>
 		      <listitem>
 			<para><filename>file1</filename> 将从</para>
 
 			<itemizedlist>
 			  <listitem>
 			    <para><varname>MASTER_SITE_OVERRIDE</varname></para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site1/directory-trial:1/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site1/directory-one/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site1/directory/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site2/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site7/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para><varname>MASTER_SITE_BACKUP</varname></para>
 			  </listitem>
 			</itemizedlist>
 
 			<para>下载。</para>
 		      </listitem>
 
 		      <listitem>
 			<para><filename>file2</filename> 将和
 			  <filename>file1</filename> 以同样的方式下载，
 			  因为它们属于同一组</para>
 
 			<itemizedlist>
 			  <listitem>
 			    <para><varname>MASTER_SITE_OVERRIDE</varname></para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site1/directory-trial:1/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site1/directory-one/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site1/directory/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site2/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site7/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para><varname>MASTER_SITE_BACKUP</varname></para>
 			  </listitem>
 			</itemizedlist>
 		      </listitem>
 
 		      <listitem>
 			<para><filename>file3</filename> 将从</para>
 
 			<itemizedlist>
 			  <listitem>
 			    <para><varname>MASTER_SITE_OVERRIDE</varname></para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site3/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para><varname>MASTER_SITE_BACKUP</varname></para>
 			  </listitem>
 			</itemizedlist>
 
 			<para>下载。</para>
 		      </listitem>
 
 		      <listitem>
 			<para><filename>file4</filename> 将从</para>
 
 			<itemizedlist>
 			  <listitem>
 			    <para><varname>MASTER_SITE_OVERRIDE</varname></para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site4/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site5/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site6/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site7/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site8/directory-one/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para><varname>MASTER_SITE_BACKUP</varname></para>
 			  </listitem>
 			</itemizedlist>
 
 			<para>下载。</para>
 		      </listitem>
 
 		      <listitem>
 			<para><filename>file5</filename> 将从</para>
 
 			<itemizedlist>
 			  <listitem>
 			    <para><varname>MASTER_SITE_OVERRIDE</varname></para>
 			  </listitem>
 
 			  <listitem>
 			    <para><varname>MASTER_SITE_BACKUP</varname></para>
 			  </listitem>
 			</itemizedlist>
 
 			<para>下载。</para>
 		      </listitem>
 
 		      <listitem>
 			<para><filename>file6</filename> 将从</para>
 
 			<itemizedlist>
 			  <listitem>
 			    <para><varname>MASTER_SITE_OVERRIDE</varname></para>
 			  </listitem>
 
 			  <listitem>
 			    <para>http://site8/</para>
 			  </listitem>
 
 			  <listitem>
 			    <para><varname>MASTER_SITE_BACKUP</varname></para>
 			  </listitem>
 			</itemizedlist>
 
 			<para>下载。</para>
 		      </listitem>
 		    </itemizedlist>
 		  </example>
 		</listitem>
 	      </orderedlist>
 	    </listitem>
 
 	    <listitem>
 	      <para>如何对来自
 		<filename>bsd.sites.mk</filename> 的特殊变量， 例如
 		<varname>MASTER_SITE_SOURCEFORGE</varname> 进行分组？</para>
 
 	      <para>参见 <xref linkend="ports-master-sites-n-example-detailed-use-master-site-sourceforge"/>。</para>
 
 	      <example xml:id="ports-master-sites-n-example-detailed-use-master-site-sourceforge">
 		<title><varname>MASTER_SITE_SOURCEFORGE</varname> 中
 		  <literal>MASTER_SITES:n</literal> 的详细用法</title>
 
 		<programlisting>MASTER_SITES=   http://site1/ ${MASTER_SITE_SOURCEFORGE:S/$/:sourceforge,TEST/}
 DISTFILES=      something.tar.gz:sourceforge</programlisting>
 	      </example>
 
 	      <para><filename>something.tar.gz</filename> 将从所有
 		<varname>MASTER_SITE_SOURCEFORGE</varname> 中的站点下载。</para>
 	    </listitem>
 
 	    <listitem>
 	      <para>如何与 <varname>PATCH*</varname> 变量连用？</para>
 
 	      <para>前面的例子介绍的都是
 		<varname>MASTER*</varname> 变量，
 		但对于 <varname>PATCH*</varname> 也是完全一样的，
 		它们在 <xref linkend="ports-master-sites-n-example-detailed-use-patch-sites"/>
 		有所介绍。</para>
 
 	      <example xml:id="ports-master-sites-n-example-detailed-use-patch-sites">
 		<title>简化的 <varname>PATCH_SITES</varname> 中的
 		  <literal>MASTER_SITES:n</literal> 用法。</title>
 
 		<programlisting>PATCH_SITES=    http://site1/ http://site2/:test
 PATCHFILES=     patch1:test</programlisting>
 	      </example>
 	    </listitem>
 	  </orderedlist>
 	</sect3>
 
 	<sect3>
 	  <title>会改变 ports 的哪些行为？ 哪些不会？</title>
 
 	  <orderedlist numeration="lowerroman">
 	    <listitem>
 	      <para>所有普通的 ports 的行为都会保持不变。
 		<literal>MASTER_SITES:n</literal> 功能的代码，
 		只有在某些元素包含了前述， 特别是 <xref linkend="porting-master-sites-n-group-semantics"/>
 		中所提及语法的
 		<literal>:n</literal> 后缀时，
 		才会启用。</para>
 	    </listitem>
 
 	    <listitem xml:id="porting-master-sites-n-what-changes-in-port-targets">
 	      <para>不受影响的 port target：
 		<buildtarget>checksum</buildtarget>、
 		<buildtarget>makesum</buildtarget>、
 		<buildtarget>patch</buildtarget>、
 		<buildtarget>configure</buildtarget>、
 		<buildtarget>build</buildtarget>， 等等。
 		显然， <buildtarget>do-fetch</buildtarget>、
 		<buildtarget>fetch-list</buildtarget>、
 		<buildtarget>master-sites</buildtarget> 和
 		<buildtarget>patch-sites</buildtarget> 的行为会发生变化。</para>
 
 	      <itemizedlist>
 		<listitem>
 		  <para><buildtarget>do-fetch</buildtarget>： 会按照新的、
 		    带有组后缀的
 		    <varname>DISTFILES</varname> 和
 		    <varname>PATCHFILES</varname> 在
 		    <varname>MASTER_SITES</varname> 和
 		    <varname>PATCH_SITES</varname> 所匹配的组元素， 以及
 		    <varname>MASTER_SITE_SUBDIR</varname> 和
 		    <varname>PATCH_SITE_SUBDIR</varname> 来进行。
 		    请参见 <xref linkend="ports-master-sites-n-example-detailed-use-complete-example-master-sites"/>。</para>
 		</listitem>
 
 		<listitem>
 		  <para><buildtarget>fetch-list</buildtarget>： 和旧式的
 		    <buildtarget>fetch-list</buildtarget> 类似， 但以同
 		    <buildtarget>do-fetch</buildtarget> 相似的方式处理组。</para>
 		</listitem>
 
 		<listitem>
 		  <para><buildtarget>master-sites</buildtarget> 和
 		    <buildtarget>patch-sites</buildtarget>：
 		    (与旧版本不兼容) 仅返回组 <literal>DEFAULT</literal>
 		    的元素； 事实上， 它们会执行
 		    <buildtarget>master-sites-default</buildtarget> 和
 		    <buildtarget>patch-sites-default</buildtarget>
 		    这两个 target。</para>
 
 		  <para>更进一步， 使用
 		    <buildtarget>master-sites-all</buildtarget> 或
 		    <buildtarget>patch-sites-all</buildtarget> 这两个
 		    target 之一， 要比直接检查
 		    <buildtarget>MASTER_SITES</buildtarget> 或
 		    <buildtarget>PATCH_SITES</buildtarget> 更好。
 		    此外， 未来版本可能不再保证直接检查能够正确工作。
 		    请参见 <xref linkend="porting-master-sites-n-new-port-targets-master-sites-all"/>
 		    以了解关于这些新 target 的更多技术细节。</para>
 		</listitem>
 
 	      </itemizedlist>
 	    </listitem>
 
 	    <listitem>
 	      <para>port 中的新 target</para>
 
 	      <orderedlist>
 		<listitem>
 		  <para>一系列
 		    <buildtarget>master-sites-<replaceable>n</replaceable></buildtarget>
 		    和
 		    <buildtarget>patch-sites-<replaceable>n</replaceable></buildtarget>
 		    target 可以分别用来列出 <varname>MASTER_SITES</varname> 和
 		    <varname>PATCH_SITES</varname> 中的 <replaceable>n</replaceable>
 		    组的内容。 例如，
 		    <buildtarget>master-sites-DEFAULT</buildtarget> 和
 		    <buildtarget>patch-sites-DEFAULT</buildtarget> 都会返回
 		    <literal>DEFAULT</literal> 组的内容， 而
 		    <buildtarget>master-sites-test</buildtarget> 和
 		    <buildtarget>patch-sites-test</buildtarget> 则返回
 		    <literal>test</literal> 组的内容， 等等。</para>
 		</listitem>
 
 		<listitem xml:id="porting-master-sites-n-new-port-targets-master-sites-all">
 		  <para>新增的
 		    <buildtarget>master-sites-all</buildtarget> 和
 		    <buildtarget>patch-sites-all</buildtarget> 这两个 target，
 		    会完成先前
 		    <buildtarget>master-sites</buildtarget> 和
 		    <buildtarget>patch-sites</buildtarget> 所做的工作。
 		    它们会返回所有组的元素， 就像这些元素都属于同一组一样，
 		    并且会列出与
 		    <varname>MASTER_SITE_BACKUP</varname> 或
 		    <varname>MASTER_SITE_OVERRIDE</varname> 中在
 		    <varname>DISTFILES</varname> 或
 		    <varname>PATCHFILES</varname> 中指定的同样多个； 分别对于
 		    <buildtarget>master-sites-all</buildtarget> 和
 		    <buildtarget>patch-sites-all</buildtarget>。</para>
 		</listitem>
 	      </orderedlist>
 	    </listitem>
 	  </orderedlist>
 	</sect3>
       </sect2>
 
       <sect2>
 	<title><varname>DIST_SUBDIR</varname> (独立的源码包子目录)</title>
 
 	<para>避免让您的 port 使
 	  <filename>/usr/ports/distfiles</filename> 陷入混乱。
 	  如果您的 port 需要下载很多文件， 或者需要下载可能与其它 port
 	  的源文件名冲突的文件 (例如，
 	  <filename>Makefile</filename>)， 则应将 <varname>DIST_SUBDIR</varname>
 	  设置为 port 的名字 (通常可以用 <literal>${PORTNAME}</literal> 或
 	  <literal>${PKGNAMEPREFIX}${PORTNAME}</literal>)。 这将把
 	  <varname>DISTDIR</varname> 从默认的
 	  <filename>/usr/ports/distfiles</filename> 改为
 	  <filename>/usr/ports/distfiles/DIST_SUBDIR</filename>，
 	  并将与您的 port 有关的文件放到那个目录中。</para>
 
 	<para>此外， 它也会在备份文件主服务器 <filename>ftp.FreeBSD.org</filename>
 	  上查找同一子目录下的文件 (直接在您的
 	  <varname>Makefile</varname> 中设置 <varname>DISTDIR</varname>
 	  则不会有这样的效果， 因此您应使用
 	  <varname>DIST_SUBDIR</varname>。)</para>
 
 	<note>
 	  <para>这一设置并不影响您在  <filename>Makefile</filename>
 	    中定义的 <varname>MASTER_SITES</varname>。</para>
 	</note>
       </sect2>
 
       <sect2>
 	<title><varname>ALWAYS_KEEP_DISTFILES</varname> (一直保存源码包)</title>
 
 	<para>如果您的 port 采用的是预编译的包，
 	  但却采用了某种要求源代码必须与预编译版本一同提供的授权，
 	  例如 GPL， 则应使用 <varname>ALWAYS_KEEP_DISTFILES</varname>
 	  来告诉 &os; 联编集群保留一份在 <varname>DISTFILES</varname>
 	  中文件的副本。 一般来说这些 port 的用户并不需要这些文件，
 	  因此， 只在定义了
 	  <varname>PACKAGE_BUILDING</varname> 符的时候，
 	  才将源代码包文件加入 <varname>DISTFILES</varname> 是个好主意。
 	</para>
 
 	<example xml:id="ports-master-sites-n-example-always-keep-distfiles">
 	  <title>如何使用 <varname>ALWAYS_KEEP_DISTFILES</varname>。</title>
 	    <programlisting>.if defined(PACKAGE_BUILDING)
 DISTFILES+=             <replaceable>foo.tar.gz</replaceable>
 ALWAYS_KEEP_DISTFILES=  yes
 .endif</programlisting>
 	</example>
 
 	<para>当您在 <varname>DISTFILES</varname> 加入其它文件时，
 	  请务必确保这些文件也出现在了 <filename>distinfo</filename> 中。
 	  此外， 这些额外的文件通常也会展开到
 	  <varname>WRKDIR</varname> 中， 对于某些 ports，
 	  这可能导致一些不希望的副作用， 因而需要进行特别的处理。</para>
       </sect2>
     </sect1>
 
       <sect1 xml:id="makefile-maintainer">
 	<title><varname>MAINTAINER</varname> (监护人)</title>
 
 	<para>请在此处写上您的电子邮件地址。  <!-- smiley
 	  --><emphasis>:-)</emphasis></para>
 
 	<para>需要注意一点， <varname>MAINTAINER</varname>
 	  变量的值只能是一个不包括注释部分的电子邮件地址，
 	  其格式应为 <literal>user@hostname.domain</literal>。
 	  请不要在此处写任何说明性的文字， 例如您的真实姓名 &mdash; 这会给
 	  <filename>bsd.port.mk</filename> 带来麻烦。</para>
 
 	<para>监护人有责任保持 port 随时更新， 并确保其能够正确地运行。
 	  详细的 port 监护人职责说明， 请参见 <link xlink:href="&url.articles.contributing-ports;/maintain-port.html">
 	  port 监护人面临的挑战</link> 一节。</para>
 
 	<para>对于 port 的修改， 应被发给 port 的监护人进行复审，
 	  且在 commit 之前需要获得其监护人的同意。
 	  假如某一 port 的监护人没有在两周之内 (不包括主要的公共假日)
 	  响应来自用户的更新请求， 则可视为监护人超时，
 	  在这种情况下可以在没有监护人明确同意的情形下进行更新。
 	  如果监护人在多达三个月的时间内没有进行任何响应，
 	  则可以认为该监护人不辞而别， 允许对出现此类问题的 port 进行监护人变更。
 	  尽管如此， 监护人为 &a.portmgr; 或者 &a.security-officer; 的 port
 	  不受此限。 对监护人为这些小组的 port 进行未经许可的 commit 是不允许的。</para>
 
 	<para>我们保留对监护人所提交修正案进行改动的权力， 以便使其更符合现行的 Ports
 	  Collection 规范， 而无需提交补丁的人明确批准。 此外， 大规模的基础性修改，
 	  也可能使 port 在没有得到监护人同意的情形下进行修改。
 	  但这类修改都不应影响 port 本身的功能。</para>
 
 	<para>&a.portmgr; 保留以任何原因收回或绕过任何人监护权的权力，
 	  而 &a.security-officer; 则保留以安全原因收回或绕过监护权的权力。</para>
       </sect1>
 
       <sect1 xml:id="makefile-comment">
 	<title><varname>COMMENT</varname> (一句话说明)</title>
 
 	<para>这一变量用于指定 port 的一句话说明。
 	  <emphasis>请</emphasis> 勿将 package 的名字 (或软件的版本)
 	  放在说明中。 这一说明的第一个字母应大写， 结尾不用句点。
 	  下面是一个例子：</para>
 
 	<programlisting>COMMENT=       A cat chasing a mouse all over the screen</programlisting>
 
 	<para><filename>Makefile</filename> 中的 COMMENT 变量应该紧接着 MAINTAINER
 	  变量出现。</para>
 
 	<para>请务必将 COMMENT 这行限制在不超过 70 个字符之内，
 	  因为这行内容会成为 &man.pkg.info.1;
 	  呈现给用户的 port 的一句话简介。</para>
       </sect1>
 
       <sect1 xml:id="makefile-depend">
 	<title>依赖关系</title>
 
 	<para>许多 ports 会依赖其它 port。 这是包括 &os;
 	  在内的多数 类-Unix 系统的很方便的功能。
 	  这项功能， 可以避免在每个 port 或预编译包中都带上重复的依赖的代码，
 	  而可以以依赖关系的方式去共享它们。
 	  有七个变量用于帮助您确保所需的文件都存在于用户的机器上。
 	  此外， 也提供了用于支持常见情形的依赖关系变量，
 	  以及对依赖关系行为的更多控制。</para>
 
 	<sect2>
 	  <title><varname>LIB_DEPENDS</varname> (依赖的函数库/共享库)</title>
 
 	  <para>这个变量用于指定 port 所依赖的共享库。 其内容是由一系列
 	    <replaceable>lib</replaceable>:<replaceable>dir</replaceable><optional>:target</optional>
 	    元组构成的表， 其中 <replaceable>lib</replaceable> 是共享库的名字，
 	    而 <replaceable>dir</replaceable> 则是在找不到时应该从哪里联编和安装，
 	    最后， <replaceable>target</replaceable> 用于指定在那个目录中调用的
 	    target。 例如，
 	    <programlisting>LIB_DEPENDS=   jpeg.9:${PORTSDIR}/graphics/jpeg</programlisting>
 	    会检测主版本号为 9 的 jpeg 共享库， 如果它不存在，
 	    则会进入到您的 ports 目录中的 <filename>graphics/jpeg</filename>
 	    子目录， 并联编和安装它。 如果您指定的 <replaceable>target</replaceable>
 	    就是 <varname>DEPENDS_TARGET</varname> (默认是
 	    <literal>install</literal>)， 则可以略去不写。</para>
 
 	  <note>
 	    <para><replaceable>lib</replaceable> 部分是一个正则表达式， 用于在
 	      <command>ldconfig -r</command> 的输出中进行查找。 可以使用类似
 	      <literal>intl.[5-7]</literal> 和 <literal>intl</literal> 这样的值。
 	      前一种模式， 即
 	      <literal>intl.[5-7]</literal>， 能够匹配
 	      <literal>intl.5</literal>、 <literal>intl.6</literal> 和
 	      <literal>intl.7</literal> 中的任意一个。 第二种模式， 即
 	      <literal>intl</literal> 则可以匹配任意版本的
 	      <literal>intl</literal> 库。</para>
 	  </note>
 
 	  <para>依赖关系会被检测两次， 一次是在
 	    <buildtarget>extract</buildtarget> target 中， 而另一次则是在
 	    <buildtarget>install</buildtarget> target。 另外，
 	    依赖关系的名字会放到 package 中， 以便让
 	    &man.pkg.add.1; 能够自动地在用户系统上安装所需的未安装的其它
 	    package。</para>
 	</sect2>
 
 	<sect2>
 	  <title><varname>RUN_DEPENDS</varname> (依赖的运行环境)</title>
 
 	  <para>这个变量可以用来指定 port 在运行时所需要的可执行文件，
 	    以及资源文件。 它是一系列
 	    <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional>:target</optional>
 	    元组的列表， 这里， <replaceable>path</replaceable> 时所需的可执行，
 	    或者资源文件的名字， <replaceable>dir</replaceable> 是在无法找到这些文件或目录时，
 	    去什么地方完成联编和安装以便获得这些文件； 而
 	    <replaceable>target</replaceable> 则用来指定在这个目录中所调用的
 	    target 的名字。 假如 <replaceable>path</replaceable> 以斜线
 	    (<literal>/</literal>) 开始， 则会当作普通文件，
 	    使用 <command>test -e</command> 来测试； 反之，
 	    则系统会假定这是一个可执行文件， 并且用 <command>which -s</command>
 	    来检测程序是否存在于搜索路径中。</para>
 
 	  <para>例如，</para>
 
 	    <programlisting>RUN_DEPENDS=   ${LOCALBASE}/etc/innd:${PORTSDIR}/news/inn \
 	       xmlcatmgr:${PORTSDIR}/textproc/xmlcatmgr</programlisting>
 
 	  <para>将检查文件， 或者目录
 	    <filename>/usr/local/etc/innd</filename> 是否存在，
 	    如果找不到， 则将从 port 目录的
 	    <filename>news/inn</filename> 子目录加以安装。
 	    系统也会检查是否能够在搜索路径中找到名为 <command>xmlcatmgr</command>
 	    的文件， 如果找不到的话， 则会进入 ports 目录中的
 	    <filename>textproc/xmlcatmgr</filename> 子目录，
 	    并进行联编和安装的操作。</para>
 
 	  <note>
 	    <para>这种情况下， <command>innd</command> 实际上是一个可执行文件；
 	      如果可执行文件不会出现在搜索路径中， 您就需要指定完整路径了。</para>
 	  </note>
 
 	  <note>
 	    <para>ports 联编集群上官方的搜索 <envar>PATH</envar> 是</para>
 
 	    <programlisting>/sbin:/bin:/usr/sbin:/usr/bin:/usr/local/sbin:/usr/local/bin:/usr/X11R6/bin</programlisting>
 	  </note>
 
 	  <para>这个依赖关系会在
 	    <buildtarget>install</buildtarget> target 的过程中进行检查。
 	    此外， 依赖关系的名字会被放到 package 中， 以便
 	    &man.pkg.add.1; 能够在用户的系统中尚未安装相关软件时自动地安装那些 package。
 	    如果您希望指定一个的 <replaceable>target</replaceable>
 	    和默认的 <varname>DEPENDS_TARGET</varname> 相同，
 	    则可以略去不写。</para>
 
 	  <para>一种比较常见的情形是
 	    <varname>RUN_DEPENDS</varname> 和
 	    <varname>BUILD_DEPENDS</varname> 完全一样，
 	    这种情况在移植的软件是采用脚本语言书写，
 	    或联编环境与运行环境需求相同时尤其普遍。
 	    这种情况可以用下面简单明了的方式直接将其中一个变量赋值给另一个变量：</para>
 
 	  <programlisting>RUN_DEPENDS= ${BUILD_DEPENDS}</programlisting>
 
 	  <para>不过， 这种赋值有可能会令运行环境被某些没有在
 	    port 原本的 <varname>BUILD_DEPENDS</varname> 明确定义的依赖关系污染。
 	    导致这种情况的原因是 &man.make.1; 计算变量赋值时默认采用的是延后计算 (lazy evaluation)。
 	    例如， 如果在 <filename>Makefile</filename> 中使用了
 	    <varname>USE_<replaceable>*</replaceable></varname> 变量，
 	    这些变量就会由 <filename>ports/Mk/bsd.*.mk</filename> 处理，
 	    并填写与之对应的联编依赖关系。 例如， <literal>USE_GMAKE=yes</literal>
 	    会把 <package>devel/gmake</package> 加入到
 	    <varname>BUILD_DEPENDS</varname>。
 	    如果希望避免这些附加的依赖关系污染 <varname>RUN_DEPENDS</varname>，
 	    在使用赋值的时候就需要小心考虑这类扩展的情况，
 	    例如， 可以在赋值展开之前复制变量的值：</para>
 
 	    <programlisting>RUN_DEPENDS:=  ${BUILD_DEPENDS}</programlisting>
 	</sect2>
 
 	<sect2>
 	  <title><varname>BUILD_DEPENDS</varname> (依赖的联编环境)</title>
 
 	  <para>此变量用于指定用来联编 port 的可执行文件或资源文件。
 	    与 <varname>RUN_DEPENDS</varname> 类似， 它是一个
 	    <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional>:target</optional>
 	    元组的列表。 例如， <programlisting> BUILD_DEPENDS=
 	      unzip:${PORTSDIR}/archivers/unzip</programlisting> 将检测名为
 	    <command>unzip</command> 的可执行文件是否存在， 如果不存在，
 	    则会进入到您的 ports 目录中的 <filename>archivers/unzip</filename>
 	    并完成联编和安装工作。</para>
 
 	  <note>
 	    <para>这里的 <quote>build</quote> 表示从解压缩到编译的全部过程。
 	      依赖关系是在 <buildtarget>extract</buildtarget> target 的过程中检测的。
 	      假如您要指定的  <replaceable>target</replaceable> 和
 	      <varname>DEPENDS_TARGET</varname> 相同， 则可以略去不写。</para>
 	  </note>
 	</sect2>
 
 	<sect2>
 	  <title><varname>FETCH_DEPENDS</varname> (依赖的下载环境)</title>
 
 	  <para>这一变量用于指定 port 在下载时所需的可执行文件或资源文件。
 	    和前两个类似， 它是一组
 	    <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional>:target</optional>
 	    元组。 例如， <programlisting> FETCH_DEPENDS=
 	      ncftp2:${PORTSDIR}/net/ncftp2</programlisting>
 	    将检测名为 <command>ncftp2</command> 的可执行文件是否存在，
 	    如果找不到， 则将进入到您 ports 目录中的
 	    <filename>net/ncftp2</filename> 子目录并加以联编和安装。</para>
 
 	  <para>这个依赖关系是在
 	    <buildtarget>fetch</buildtarget> target 过程中检查的。
 	    如果与 <varname>DEPENDS_TARGET</varname> 相同，
 	    则可以省略 <replaceable>target</replaceable> 部分。</para>
 	</sect2>
 
 	<sect2>
 	  <title><varname>EXTRACT_DEPENDS</varname> (依赖的解压缩环境)</title>
 
 	  <para>此变量用于指定 port 在解压缩时所需的可执行文件或其它资源文件。
 	    和前一个变量类似， 它是一系列
 	    <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional>:target</optional>
 	    元组的列表。 例如， <programlisting>EXTRACT_DEPENDS=
 	      unzip:${PORTSDIR}/archivers/unzip</programlisting> 将检查名为
 	    <command>unzip</command> 的可执行文件是否存在， 如果不存在，
 	    则会进入到您的 ports 目录中的 <filename>archivers/unzip</filename>
 	    子目录， 予以联编和安装。</para>
 
 	  <para>这个依赖关系是在
 	    <buildtarget>extract</buildtarget> target 的过程中检查的。 如果与
 	    <varname>DEPENDS_TARGET</varname> 相同，
 	    则可以略去 <replaceable>target</replaceable> 部分。</para>
 
 	  <note>
 	    <para>只有在其它方式都不可用 (默认是 <command>gzip</command>)
 	      而且无法通过 <xref linkend="use-vars"/> 所介绍的 <varname>USE_ZIP</varname> 或
 	      <varname>USE_BZIP2</varname> 都不能达到需要时，
 	      才应使用这个变量。</para>
 	  </note>
 	</sect2>
 
 	<sect2>
 	  <title><varname>PATCH_DEPENDS</varname> (依赖的打补丁环境)</title>
 
 	  <para>这个变量用于指定 port 在进行 patch
 	    操作时所需的可执行文件或其它资源文件。 和前一个变量类似， 它是一组
 	    <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional>:target</optional>
 	    元组的表。 例如， <programlisting> PATCH_DEPENDS=
 	      ${NONEXISTENT}:${PORTSDIR}/java/jfc:extract
 		</programlisting> 表示进入到您的 ports 目录中的
 	    <filename>java/jfc</filename> 子目录， 并将其解压缩。</para>
 
 	  <para>这个依赖关系是在
 	    <buildtarget>patch</buildtarget> target 的过程中检查的。
 	    <replaceable>target</replaceable> 部分如果和
 	    <varname>DEPENDS_TARGET</varname> 相同， 就可略去不写。</para>
 	</sect2>
 
 	<sect2 xml:id="use-vars">
 	<title><varname>USE_<replaceable>*</replaceable></varname></title>
 
 	<para>提供了一系列变量， 用以封装大量 port 都用到的依赖关系。
 	  虽然使用这些变量是可选的， 但它们能显著减少 port 的
 	  <filename>Makefile</filename> 复杂性。 这些变量的共同特征在于，
 	  它们的名字都是 <varname>USE_<replaceable>*</replaceable></varname>
 	  这样的形式。 这些变量的使用， 应严格限制于 port 的
 	  <filename>Makefile</filename> 以及
 	  <filename>ports/Mk/bsd.*.mk</filename>，
 	  而绝不应用于表达用户能够设置的选项 &mdash; 这种情况下应采用
 	  <varname>WITH_<replaceable>*</replaceable></varname> 和
 	  <varname>WITHOUT_<replaceable>*</replaceable></varname>
 	  这样的变量。</para>
 
 	<note>
 	  <para>在 <emphasis>任何</emphasis> 情况下，
 	    都不应在 <filename>/etc/make.conf</filename> 中配置任何
 	    <varname>USE_<replaceable>*</replaceable></varname>。
 	    例如， 设置 <programlisting>USE_GCC=3.4</programlisting>
 	    将导致每个 port 都依赖 gcc34， 甚至包括
 	    gcc34 本身！</para>
 	</note>
 
 	<table frame="none">
 	  <title>常用的 <varname>USE_<replaceable>*</replaceable></varname>
 	    变量</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>变量</entry>
 
 		<entry>含义</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><varname>USE_BZIP2</varname></entry>
 
 		<entry>此 port 的源码包是使用
 		  <command>bzip2</command> 压缩的。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>USE_ZIP</varname></entry>
 
 		<entry>此 port 的源码包是用
 		  <command>zip</command> 压缩的。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>USE_BISON</varname></entry>
 
 		<entry>此 port 在联编时使用 <command>bison</command>。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>USE_CDRTOOLS</varname></entry>
 
 		<entry>此 port 需要使用 <application>cdrecord</application>，
 		  根据用户的喜好， 可能是 <package>sysutils/cdrtools</package> 或 <package>sysutils/cdrtools-cjk</package>。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>USE_GCC</varname></entry>
 
 		<entry>此 port 需要使用某一特定版本的
 		  <command>gcc</command> 才能完成编译。
 		  可以使用类似 <literal>3.4</literal> 这样的值来精确指定版本。
 		  如果希望使用不低于某一版本的编译器， 则可以用
 		  <literal>3.4+</literal> 这样的形式。 如果与所希望的版本吻合，
 		  则将使用基本系统中所提供的 <command>gcc</command>， 反之，
 		  系统会从 ports 中安装所希望版本的 <command>gcc</command>，
 		  并调整 <varname>CC</varname> 以及
 		  <varname>CXX</varname> 变量的设置。</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	  <para>与 <application>gmake</application>
 	    和 <filename>configure</filename> 脚本有关的变量在
 	    <xref linkend="building"/> 中进行了介绍， 而
 	    <application>autoconf</application>、
 	    <application>automake</application> 以及
 	    <application>libtool</application> 的介绍则可以在
 	    <xref linkend="using-autotools"/> 找到。 <xref linkend="using-perl"/>
 	    介绍了与 <application>Perl</application> 有关的的变量。
 	    <xref linkend="using-x11"/> 中列出了关于 X11 的变量。 关于 GNOME 的变量在 <xref linkend="using-gnome"/>， 而关于 KDE 的则在 <xref linkend="using-kde"/>。 <xref linkend="using-java"/> 讲述了和 Java 有关的变量， 而 <xref linkend="using-php"/> 则包含了关于
 	    <application>Apache</application>、 <application>PHP</application>
 	    以及 PEAR 的介绍性信息。 关于 <application>Python</application>，
 	    在 <xref linkend="using-python"/> 进行了讨论， 而关于
 	    <application>Ruby</application> 的介绍，
 	    则可以在 <xref linkend="using-ruby"/> 中找到。
 	    <xref linkend="using-sdl"/> 提供了用于
 	    <application>SDL</application> 应用程序的变量介绍， 最后，
 	    <xref linkend="using-xfce"/> 包含了关于
 	    <application>Xfce</application> 的信息。</para>
 
 	</sect2>
 
 	<sect2>
 	  <title>在依赖关系中指定最低版本</title>
 
 	  <para>在依赖某个其他 port 时， 可以采用下面的句法， 通过除
 	    <varname>LIB_DEPENDS</varname> 之外的
 	    <varname>*_DEPENDS</varname> 变量来指定最低版本：</para>
 
 	  <programlisting>p5-Spiffy&gt;=0.26:${PORTSDIR}/devel/p5-Spiffy</programlisting>
 
 	  <para>第一个字段指明了所依赖 package 的名字，
 	    用以与 package 数据库中的某项匹配， 然后是比较算符，
 	    以及 package 的版本号。 前面的例子中，
 	    如果系统中安装了 p5-Spiffy-0.26 则认为满足了依赖条件。</para>
 	</sect2>
 
 	<sect2>
 	  <title>关于依赖关系的补充说明</title>
 
 	  <para>如前面所提到的那样， 在需要某一依赖的 port 时，
 	    将调用 <buildtarget>DEPENDS_TARGET</buildtarget> 所指定的 target。
 	    这一变量的默认值是 <literal>install</literal>。 这不是一个用户变量，
 	    它不应在 port 的
 	    <filename>Makefile</filename> 中予以定义。 如果您的 port 需要使用特殊的
 	    target 来处理依赖关系， 应使用 <varname>*_DEPENDS</varname> 的
 	    <literal>:target</literal> 部分， 而不是重定义
 	    <varname>DEPENDS_TARGET</varname> 来完成。</para>
 
 	  <para>当您输入 <command>make clean</command> 时， 其依赖的 port
 	    也会自动进行清理。 如果您不希望如此， 应定义环境变量
 	    <varname>NOCLEANDEPENDS</varname>。 如果 port
 	    依赖一些重新联编需要花费很长时间的 port 时， 例如 KDE， GNOME
 	    或 Mozilla 时， 这一方法会非常有用。</para>
 
 	  <para>要无条件地依赖某个 port， 可以使用 <varname>${NONEXISTENT}</varname>
 	    作为 <varname>BUILD_DEPENDS</varname> 或
 	    <varname>RUN_DEPENDS</varname> 的第一部分。 只有在您需要使用其它
 	    port 提供的源代码时才应这样做。 通常也可以通过这样指定来缩短编译所需的时间。
 	    例如
 
 	    <programlisting>BUILD_DEPENDS=   ${NONEXISTENT}:${PORTSDIR}/graphics/jpeg:extract</programlisting>
 
 	    表示依赖 <literal>jpeg</literal> port 并将其解压缩。</para>
 	</sect2>
 
       <sect2>
 	<title>循环的依赖关系是致命的</title>
 
 	<important>
 	  <para>不要在 ports tree 中引入任何循环依赖关系!</para>
 	</important>
 
 	<para>ports 联编技术不能够容忍循环依赖关系。 如果您引入了这样的关系，
 	  就一定会有人安装的 FreeBSD 会因此而损坏， 而且这种现象会越来越多。
 	  这些情形很难检测； 如果有疑虑， 在进行这样的修改之前， 务必执行：
 	  <command>cd /usr/ports; make index</command>。 这个过程在旧的机器上会很慢，
 	  但能够让大量的用户 &mdash; 也包括您自己 &mdash;
 	  拯救于由这种问题所造成的困惑之中。</para>
       </sect2>
 
       </sect1>
 
     <sect1 xml:id="makefile-masterdir">
       <title><varname>MASTERDIR</varname> (主 port 所在的目录)</title>
 
       <para>如果 port 需要依某些变量的设置 (举例来说， 分辨率或纸型)
 	来联编略有不同的预编译包， 则可以为每一个这样的包建立不同的目录，
 	这样可以让用户更容易地看到他们想要安装的版本， 但又能在这些 port
 	之间共用尽可能多的文件。 一般情况下， 如果运用得当， 除主目录之外都只需要很短的
 	<filename>Makefile</filename>。 这些 <filename>Makefile</filename> 中，
 	可以用 <varname>MASTERDIR</varname> 来指定其它文件所在的目录。
 	另外， 还应使用一个变量作为
 	<link linkend="porting-pkgname"><varname>PKGNAMESUFFIX</varname></link>
 	的一部分， 以便为不同的包给出不同的命名。</para>
 
       <para>用例子来阐述这些会更为明晰。 以下是
 	<filename>japanese/xdvi300/Makefile</filename> 的部分代码：</para>
 
       <programlisting>PORTNAME=       xdvi
 PORTVERSION=    17
 PKGNAMEPREFIX=  ja-
 PKGNAMESUFFIX=  ${RESOLUTION}
  :
 # default
 RESOLUTION?=   300
 .if ${RESOLUTION} != 118 &amp;&amp; ${RESOLUTION} != 240 &amp;&amp; \
        ${RESOLUTION} != 300 &amp;&amp; ${RESOLUTION} != 400
        @${ECHO_MSG} "Error: invalid value for RESOLUTION: \"${RESOLUTION}\""
        @${ECHO_MSG} "Possible values are: 118, 240, 300 (default) and 400."
        @${FALSE}
 .endif</programlisting>
 
       <para><package>japanese/xdvi300</package> 也提供了全部常规的补丁，
 	以及打包用到的文件等等内容。 如果您在那里输入 <command>make</command>，
 	它将使用默认的分辨率值 (300) 并正常地联编 port。</para>
 
       <para>对于其它分辨率而言， 以下是 <emphasis>完整的</emphasis>
 	<filename>xdvi118/Makefile</filename>：</para>
 
       <programlisting>RESOLUTION=     118
 MASTERDIR=      ${.CURDIR}/../xdvi300
 
 .include "${MASTERDIR}/Makefile"</programlisting>
 
       <para>(<filename>xdvi240/Makefile</filename> 和
 	<filename>xdvi400/Makefile</filename> 是相似的)。
 	<varname>MASTERDIR</varname> 定义会告诉
 	<filename>bsd.port.mk</filename> 常规的目录，
 	例如 <varname>FILESDIR</varname> 以及
 	<varname>SCRIPTDIR</varname> 应在
 	<filename>xdvi300</filename> 中查找。 <literal>RESOLUTION=118</literal>
 	这行将覆盖在 <filename>xdvi300/Makefile</filename> 中所作的
 	<literal>RESOLUTION=300</literal> 设置， 从而 port
 	将以分辨率为 118 的设置来联编。</para>
     </sect1>
 
     <sect1 xml:id="makefile-manpages">
       <title>联机手册</title>
 
       <para><varname>MAN[1-9LN]</varname> 这些变量，
 	会自动地将联机手册加到 <filename>pkg-plist</filename> (这也意味着
 	<emphasis>不能</emphasis> 在
 	<filename>pkg-plist</filename> 中列出联机手册 &mdash; 参见 <link linkend="plist-sub">PLIST 的生成</link> 来了解更多细节)。 此外，
 	这也会让安装阶段自动地根据在 <filename>/etc/make.conf</filename>
 	中所作的 <varname>NO_MANCOMPRESS</varname>
 	设置来自动对联机手册文件执行压缩或解压缩操作。</para>
 
       <para>如果 port 尝试通过使用符号连接或硬连接将联机手册安装为多个名字，
 	就必须使用 <varname>MLINKS</varname> 变量来予以明示。
 	由 port 创建的连接， 将由 <filename>bsd.port.mk</filename>
 	删除和重建， 以确认它们指向了正确的文件。 任何在 MLINKS 中列出的文件都不应在
 	<filename>pkg-plist</filename> 中再出现。</para>
 
       <para>要指定是否在安装时对联机手册进行压缩，
 	可以使用 <varname>MANCOMPRESSED</varname> 变量。
 	这一变量可以取三种值， <literal>yes</literal>、 <literal>no</literal> 和
 	<literal>maybe</literal> 之一。 <literal>yes</literal>
 	表示联机手册已经以压缩的形式安装， <literal>no</literal> 表示还没有，
 	而 <literal>maybe</literal> 则表示所安装的软件会尊重
 	<varname>NO_MANCOMPRESS</varname> 的设置值， 因此
 	<filename>bsd.port.mk</filename> 不需要特别做什么事情。</para>
 
       <para>如果设置了 <varname>USE_IMAKE</varname> 而未定义
 	<varname>NO_INSTALL_MANPAGES</varname>，
 	<varname>MANCOMPRESSED</varname> 会自动设为
 	<literal>yes</literal>， 反之则是
 	<literal>no</literal>。 除非默认值不合适，
 	否则就不需要在 port 中明确地加以改变。</para>
 
       <para>如果 port 将联机手册放到了
 	<varname>PREFIX</varname> 之外的其它目录， 则应使用
 	<varname>MANPREFIX</varname> 来加以设置。 此外，
 	如果只有某些部分的联机手册会安装到不标准的位置， 例如某些 <literal>perl</literal>
 	模块的 port， 还可以使用
 	<varname>MAN<replaceable>sect</replaceable>PREFIX</varname> (此处
 	<replaceable>sect</replaceable> 是 <literal>1-9</literal>、
 	<literal>L</literal> 或 <literal>N</literal> 之一) 来指定。</para>
 
       <para>如果您的联机手册需要装入专用于某一语言专用的子目录，
 	需要将 <varname>MANLANG</varname> 设为那种语言的名字。
 	此变量的默认值是 <literal>""</literal> (也就是只有英语)。</para>
 
       <para>下面是一个综合的例子。</para>
 
       <programlisting>MAN1=          foo.1
 MAN3=          bar.3
 MAN4=          baz.4
 MLINKS=        foo.1 alt-name.8
 MANLANG=       "" ja
 MAN3PREFIX=    ${PREFIX}/share/foobar
 MANCOMPRESSED= yes</programlisting>
 
       <para>这表示 port 会安装六个文件；</para>
 
 	  <programlisting>${MANPREFIX}/man/man1/foo.1.gz
 ${MANPREFIX}/man/ja/man1/foo.1.gz
 ${PREFIX}/share/foobar/man/man3/bar.3.gz
 ${PREFIX}/share/foobar/man/ja/man3/bar.3.gz
 ${MANPREFIX}/man/man4/baz.4.gz
 ${MANPREFIX}/man/ja/man4/baz.4.gz</programlisting>
 
       <para>此外， <filename>${MANPREFIX}/man/man8/alt-name.8.gz</filename>
 	可能会通过您的 port 安装， 也可能不会。 无论如何，
 	都会创建一个符号连接， 把 foo(1) 和
 	alt-name(8) 联机手册连起来。</para>
 
       <para>假如只有部分联机手册是翻译过的，
 	则可以使用一些根据 <varname>MANLANG</varname> 内容动态生成的变量：</para>
 
       <programlisting>MANLANG=       "" de ja
 MAN1=          foo.1
 MAN1_EN=       bar.1
 MAN3_DE=       baz.3</programlisting>
 
       <para>这相当于下列文件：</para>
 
       <programlisting>${MANPREFIX}/man/man1/foo.1.gz
 ${MANPREFIX}/man/de/man1/foo.1.gz
 ${MANPREFIX}/man/ja/man1/foo.1.gz
 ${MANPREFIX}/man/man1/bar.1.gz
 ${MANPREFIX}/man/de/man3/baz.3.gz</programlisting>
     </sect1>
 
     <sect1 xml:id="makefile-info">
       <title>Info 文件</title>
 
       <para>如果软件包需要安装 GNU info 文件，
 	则需要在 <varname>INFO</varname> 变量中一一列出 (不需要指定
 	<literal>.info</literal> 后缀)。 系统假定这些文件均会安装到
 	<filename>PREFIX/INFO_PATH</filename> 目录中。
 	如果软件包有需要， 也可以通过修改 <varname>INFO_PATH</varname> 来指定不同的位置。
 	不过， 并不推荐这样做。 所有列出的项目均是相对于
 	<filename>PREFIX/INFO_PATH</filename> 的文件路径。
 	例如， <package>lang/gcc34</package> 表示将
 	info 文件安装到
 	<filename>PREFIX/INFO_PATH/gcc34</filename>，
 	因此 <varname>INFO</varname> 应写成类似这样：
 	<programlisting>INFO= gcc34/cpp gcc34/cppinternals gcc34/g77 ...
 </programlisting>
 	 这样安装/卸载代码就会自动地在注册包之前将它们加入到临时的
 	<filename>pkg-plist</filename> 中了。</para>
     </sect1>
 
       <sect1 xml:id="makefile-options">
       <title>Makefile 选项</title>
 
       <para>某些大型应用程序可以在联编时使用一系列配置选项，
 	用以在系统中已经安装了某些库或应用程序时增加一些功能。
 	例如， 选择某种自然 (人类的) 语言， GUI 或命令行界面，
 	由于并不是所有的用户都希望使用这些库或者应用程序， port
 	系统提供了一组方便的机制， 来让 port 的作者控制联编时的配置。
 	支持这些特性可以让用户体验更好， 并达到事半功倍的效果。</para>
 
       <sect2>
           <title>开关 (Knobs)</title>
 
 	<sect3>
 	  <title><varname>WITH_<replaceable>*</replaceable></varname> 和
 	    <varname>WITHOUT_<replaceable>*</replaceable></varname></title>
 
 	  <para>这些变量是为系统管理员准备的。 许多这样的变量被标准化并置于
 	    <link xlink:href="http://www.freebsd.org/cgi/cvsweb.cgi/ports/KNOBS?rev=HEAD&amp;content-type=text/x-cvsweb-markup"><filename>ports/KNOBS</filename></link>
 	    文件。</para>
 
           <para>在创建一个 port 的时候，不要使用某个应用程序专有的 knob
             名称，比如对于 Avahi 这个 port，应该用
 	    <varname>WITHOUT_MDNS</varname> 而不是
 	    <varname>WITHOUT_AVAHI_MDNS</varname>。</para>
 
 	  <note>
 	    <para>您不应假定每一个
 	      <varname>WITH_<replaceable>*</replaceable></varname>
 	      都会有对应的
 	      <varname>WITHOUT_<replaceable>*</replaceable></varname>
 	      变量， 反之亦然。 一般而言， 会使用默认值。</para>
 	  </note>
 
 	  <note>
 	    <para>除非另有说明， 这些变量都是测试是否定义，
 	      而不是它们设置了 <literal>YES</literal> 或
 	      <literal>NO</literal>。</para>
 	  </note>
 
 	  <table frame="none">
 	    <title>常见的 <varname>WITH_<replaceable>*</replaceable></varname>
 	      和 <varname>WITHOUT_<replaceable>*</replaceable></varname>
 	      变量</title>
 
 	    <tgroup cols="2">
 	      <thead>
 	        <row>
 		  <entry>变量</entry>
 
 		  <entry>意义</entry>
 	        </row>
 	      </thead>
 
 	      <tbody>
 	        <row xml:id="knobs-without-nls">
 		  <entry><varname>WITHOUT_NLS</varname></entry>
 
 		  <entry>表示不需要国际化支持， 这可以节省编译所消耗的时间。
 		    默认情况下， 会启用国际化支持。</entry>
 	        </row>
 
 	        <row>
 		  <entry><varname>WITH_OPENSSL_BASE</varname></entry>
 
 		  <entry>使用基本系统中的 OpenSSL 版本。</entry>
 	        </row>
 
 	        <row>
 		  <entry><varname>WITH_OPENSSL_PORT</varname></entry>
 
                   <entry>从 <package>security/openssl</package>
                     安装 OpenSSL，即使基本系统中的版本是最新的。</entry>
 	        </row>
 
 	        <row>
 		  <entry><varname>WITHOUT_X11</varname></entry>
 
 		  <entry>如果 port 能够在是否包含
 		    X 支持的情况下分别联编， 则一般情况应该默认以包含
 		    X 支持的配置来联编。 如果定义了这一变量，
 		    则应联编不包含 X 支持的版本。</entry>
 	        </row>
 	      </tbody>
 	    </tgroup>
 	  </table>
 
 	</sect3>
 
 	<sect3>
 	  <title>开关 (knob) 的命名</title>
 	    <para>我们建议 port 的开发人员使用相似的开关， 以便最终用户使用，
 	      并减少开关名称的总数。 最为常用的开关名字可以在
 	      <link xlink:href="http://www.freebsd.org/cgi/cvsweb.cgi/ports/KNOBS?rev=HEAD&amp;content-type=text/x-cvsweb-markup">KNOBS</link>
 	      文件中找到。</para>
 
 	    <para>开关的名字应反映其功能。 如果 port 的 <varname>PORTNAME</varname>
 	      包括 lib- 前缀， 则开关名中应删去 lib- 前缀。</para>
 
 	</sect3>
       </sect2>
 
       <sect2>
 	<title><varname>OPTIONS</varname> (菜单式可选项)</title>
 
 	<sect3>
 	  <title>背景</title>
 	    <para><varname>OPTIONS</varname> 将为正在安装 port
 	      的用户提供一个包含可用选项的对话框，
 	      并将用户的选择保存到 <filename>/var/db/ports/portname/options</filename> 中。
 	      下次重新联编 port 时， 这些选项将被再次使用。
 	      这样一来， 就不需要劳神去记忆您之前联编 port 时的那几十个
 	      <varname>WITH_<replaceable>*</replaceable></varname> 和
 	      <varname>WITHOUT_<replaceable>*</replaceable></varname>选项了！</para>
 
 	    <para>当用户运行 <command>make config</command> (或首次运行
 	      <command>make build</command>) 时， 框架会首先检查
 	      <filename>/var/db/ports/portname/options</filename>。
 	      如果这个文件不存在， 则它会使用
 	      <varname>OPTIONS</varname> 的值来生成一个可以启用或禁用各个选项的对话框。
 	      随后， 用户的选择将保存到
 	      <filename>options</filename> 文件中，
 	      并被用于联编 port。</para>
 
 	    <para>如果新版本的 port 新增了
 	      <varname>OPTIONS</varname>， 则系统会再次给出对话框，
 	      并根据先前的 <varname>OPTIONS</varname>
 	      配置预设先前存在的配置。</para>
 
 	    <para>使用 <command>make showconfig</command> 可以查看保存的配置。
 	      此外， <command>make rmconfig</command> 可以删除已经保存的配置。</para>
 	</sect3>
 
 	<sect3>
 	  <title>语法</title>
 	    <para><varname>OPTIONS</varname> 变量的语法是：
 
 <programlisting>OPTIONS=	OPTION	"说明性文字" 默认值 ...
 </programlisting>
 
 	      默认值必须是 <literal>ON</literal> 和
 	      <literal>OFF</literal> 之一。 这种三元组可以使用多次。</para>
 
 	    <para>定义 <varname>OPTIONS</varname> 变量的值，
 	      必须在引入 <filename>bsd.port.options.mk</filename> 之前进行。
 	      而 <varname>WITH_*</varname> 和 <varname>WITHOUT_*</varname>
 	      变量则只能在引入了
 	      <filename>bsd.port.options.mk</filename> 之后才可以进行检测。 使用
 	      <filename>bsd.port.pre.mk</filename> 也可以达到同样的目的，
 	      在系统开始提供 <filename>bsd.port.options.mk</filename> 之前的许多
 	      port 都在使用这种用法。 不过， 请注意
 	      <filename>bsd.port.pre.mk</filename> 会要求某些变量已经进行过定义， 如
 	      <varname>USE_*</varname> 等。</para>
 
 	  <example xml:id="ports-options-simple-use">
 	    <title>简单的 <varname>OPTIONS</varname> 用法</title>
 	    <para><programlisting>OPTIONS=      FOO "启用 foo 选项" On \
               BAR "支持 bar 功能" Off
 
 .include &lt;bsd.port.options.mk&gt;
 
 .if defined(WITHOUT_FOO)
 CONFIGURE_ARGS+=	--without-foo
 .else
 CONFIGURE_ARGS+=	--with-foo
 .endif
 
 .if defined(WITH_BAR)
 RUN_DEPENDS+=	bar:${PORTSDIR}/bar/bar
 .endif
 
 .include &lt;bsd.port.mk&gt;</programlisting></para>
 	  </example>
 
 	  <example xml:id="ports-options-old-style-use">
 	    <title>Old style use of <varname>OPTIONS</varname></title>
 	    <para><programlisting>OPTIONS=      FOO "Enable option foo" On
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if defined(WITHOUT_FOO)
 CONFIGURE_ARGS+=	--without-foo
 .else
 CONFIGURE_ARGS+=	--with-foo
 .endif
 
 .include &lt;bsd.port.post.mk&gt;</programlisting></para>
 	  </example>
 	</sect3>
       </sect2>
 
       <sect2>
 	<title>自动激活的特性</title>
 
 	<para>在使用 GNU configure 脚本时， 一定要小心有些特性会由其自动检测而激活。
 	  您应通过明确地指定相应的
 	  <literal>--without-xxx</literal> 或 <literal>--disable-xxx</literal>
 	  参数到 <varname>CONFIGURE_ARGS</varname> 来禁用不希望的特性。</para>
 
 	<example>
 	  <title>处理选项时的错误做法</title>
 	  <programlisting>.if defined(WITH_FOO)
 LIB_DEPENDS+=		foo.0:${PORTSDIR}/devel/foo
 CONFIGURE_ARGS+=	--enable-foo
 .endif</programlisting>
 	</example>
 
 	<para>在前面的例子中， 假设系统中已经安装了 libfoo 库。 用户可能并不希望应用程序使用 libfoo，
 	  因此他在 <literal>make config</literal> 对话框中关掉了这个选项。
 	  但是， 应用程序的 configure 脚本检测到了系统中存在这个库，
 	  并将其加入到了最终可执行文件支持的功能中。 现在， 如果用户决定从系统中卸载 libfoo 时，
 	  ports 系统就无法保护这个应用程序免遭破坏了 (因为没有记录 libfoo 的依赖关系)。</para>
 
 	<example>
 	  <title>处理选项时的正确做法</title>
 	  <programlisting>.if defined(WITH_FOO)
 LIB_DEPENDS+=		foo.0:${PORTSDIR}/devel/foo
 CONFIGURE_ARGS+=	--enable-foo
 .else
 CONFIGURE_ARGS+=	--disable-foo
 .endif</programlisting>
 	</example>
 
 	<para>在第二个例子中， libfoo 库被明确禁用。 即使系统中已经安装了这个库，
 	  configure 脚本也不会启用相应的功能了。</para>
       </sect2>
 
     </sect1>
 
     <sect1 xml:id="makefile-wrkdir">
       <title>指定工作临时目录</title>
 
       <para>每个 port 都会被解压缩到一个工作临时目录中， 这个目录必须是可写的。
 	ports 系统默认情况下会将
 	<varname>DISTFILES</varname> 解压缩到一个叫做
 	<literal>${DISTNAME}</literal> 的目录中。 换言之， 如果设了：</para>
 
       <programlisting>PORTNAME=      foo
 PORTVERSION=   1.0</programlisting>
 
       <para>则 port 的源码包文件的顶级目录将是
 	<filename>foo-1.0</filename>。</para>
 
       <para>如果这不是所希望的情形， 您可以修改一系列变量的设置。</para>
 
       <sect2>
 	<title><varname>WRKSRC</varname> (开始联编操作的目录名)</title>
 
 	<para>这个变量给出了在应用程序的源代码包解压缩之后所生成的目录的名字。
 	  如果我们之前的例子解压缩生成一个叫做 <filename>foo</filename> (而不是
 	  <filename>foo-1.0</filename>) 的目录， 您应：</para>
 
 	<programlisting>WRKSRC=      ${WRKDIR}/foo</programlisting>
 
 	<para>或者， 也可能是</para>
 
 	<programlisting>WRKSRC=      ${WRKDIR}/${PORTNAME}</programlisting>
       </sect2>
 
       <sect2>
 	<title><varname>NO_WRKSUBDIR</varname> (不需要临时的联编目录)</title>
 
 	<para>如果 port 完全不需要写入到某个子目录中，
 	  您应设置 <varname>NO_WRKSUBDIR</varname> 以明示这一点。</para>
 
 	<programlisting>NO_WRKSUBDIR= yes</programlisting>
       </sect2>
     </sect1>
 
     <sect1 xml:id="conflicts">
       <title>处理冲突</title>
 
       <para>针对不同的 package 或 port 之间的冲突情形，
 	系统提供了不同的变量来协助开发人员进行表达： <varname>CONFLICTS</varname>、
 	<varname>CONFLICTS_INSTALL</varname> 和
 	<varname>CONFLICTS_BUILD</varname>。</para>
 
       <note>
 	<para>这些用于描述冲突的变量会自动地设置
 	  <varname>IGNORE</varname>， 后者的完整介绍，
 	  可以在 <xref linkend="dads-noinstall"/> 找到。</para>
       </note>
 
       <para>在删去相互冲突的 port 时， 建议将 <varname>CONFLICTS</varname>
 	保留几个月， 以便让那些不经常更新系统的用户能够看到。</para>
 
       <sect2>
 	<title><varname>CONFLICTS_INSTALL</varname></title>
 
 	<para>如果您的软件包不能与某些软件包同时安装
 	  (例如由于安装同样的文件到相同的位置、 运行时不兼容等等)，
 	  则应把其它软件包的名字列在
 	  <varname>CONFLICTS_INSTALL</varname> 变量中。 此处可以使用 shell
 	  通配符， 如 <literal>*</literal> 和 <literal>?</literal>。
 	  列出其它软件包的名字时需要遵循它们在
 	  <filename>/var/db/pkg</filename> 中出现的样子。 请确保
 	  <varname>CONFLICTS_INSTALL</varname> 不会匹配到您正制作的这个预编译包的名字，
 	  否则， 使用
 	  <varname>FORCE_PKG_REGISTER</varname> 来强制安装就没有办法进行了。
 	  对于 CONFLICTS_INSTALL 的检查是在联编过程之后、
 	  安装开始之前进行的。</para>
       </sect2>
 
       <sect2>
 	<title><varname>CONFLICTS_BUILD</varname></title>
 
 	<para>如果您的软件包在系统中存在某些其它软件包时不能完成联编，
 	  则应把其它软件包的名字列在
 	  <varname>CONFLICTS_BUILD</varname> 变量中。 此处可以使用 shell
 	  通配符， 如 <literal>*</literal> 和 <literal>?</literal>。
 	  列出其它软件包的名字时需要遵循它们在
 	  <filename>/var/db/pkg</filename> 中出现的样子。
 	  对于 CONFLICTS_BUILD 的检查是在联编过程开始之前进行的。
 	  联编时的冲突不会在编译好的包中予以记录。</para>
       </sect2>
 
       <sect2>
 	<title><varname>CONFLICTS</varname></title>
 
 	<para>如果您的 port 在某些其它 port 已经存在的情况下既不能联编，
 	  也不能安装， 则应把其它软件包的名字列在
 	  <varname>CONFLICTS</varname> 变量中。 此处可以使用 shell
 	  通配符， 如 <literal>*</literal> 和 <literal>?</literal>。
 	  列出其它软件包的名字时需要遵循它们在
 	  <filename>/var/db/pkg</filename> 中出现的样子。 请确保
 	  <varname>CONFLICTS</varname> 不会匹配到您正制作的这个预编译包的名字，
 	  否则， 使用
 	  <varname>FORCE_PKG_REGISTER</varname> 来强制安装就没有办法进行了。
 	  对于 CONFLICTS 的检查是在联编过程之后、
 	  安装开始之前进行的。</para>
       </sect2>
     </sect1>
 
     <sect1 xml:id="install">
       <title>安装文件</title>
 
       <sect2 xml:id="install-macros">
 	<title>INSTALL_* 宏</title>
 
 	<para>一定要使用由 <filename>bsd.port.mk</filename>
 	  提供的宏， 以确保在您自己的
 	  <buildtarget>*-install</buildtarget> target 中能够以正确的属主和权限模式安装文件。</para>
 
 	<itemizedlist>
 	  <listitem>
 	    <para><varname>INSTALL_PROGRAM</varname> 是安装可执行二进制文件的命令。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><varname>INSTALL_SCRIPT</varname> 是安装可执行脚本文件的命令。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><varname>INSTALL_LIB</varname> 是安装动态连接库的命令。</para>
           </listitem>
 
 	  <listitem>
 	    <para><varname>INSTALL_KLD</varname> 是用于安装可加载式内核模块的命令。
 	      在某些平台上， 当对内核模块进行 strip 之后会导致一些问题，
 	      因此您应使用这个宏而不是 <varname>INSTALL_PROGRAM</varname> 来安装内核模块。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><varname>INSTALL_DATA</varname> 是安装可共享数据的命令。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><varname>INSTALL_MAN</varname> 是安装联机手册和其他文档的命令
 	      (注意它并不会执行压缩操作)。</para>
 	  </listitem>
 	</itemizedlist>
 
 	<para>这些宏展开后基本上都是包含适当参数的 <command>install</command> 命令。</para>
       </sect2>
 
       <sect2 xml:id="install-strip">
 	<title>对可执行文件和动态连接库做脱模 (strip) 操作</title>
 
 	<para>除非不得不进行， 否则不要手工对可执行文件作脱模操作。
 	  所有文件在安装时都应脱模， 但 <varname>INSTALL_PROGRAM</varname>
 	  宏会在安装的同时对其进行脱模 (参见下一节的内容)。
 	  <varname>INSTALL_LIB</varname> 宏</para>
 
 	<para>如果您需要对某一文件进行脱模， 但不希望使用
 	  <varname>INSTALL_PROGRAM</varname> 及 <varname>INSTALL_LIB</varname> 宏，
 	  则应使用 <varname>${STRIP_CMD}</varname> 来处理程序。
 	  一般而言这应该在
 	  <buildtarget>post-install</buildtarget> target 中进行。 例如：</para>
 
 	<programlisting>post-install:
 	${STRIP_CMD} ${PREFIX}/bin/xdl</programlisting>
 
 	<para>可以使用 &man.file.1; 命令来检查所安装的可执行文件是否进行过脱模。
 	  如果它没有给出 <literal>not stripped</literal> 的提示，
 	  则表示已经做过脱模了。 另外，
 	  &man.strip.1; 不会对已经脱模过的文件重新脱模， 它会直接退出的。</para>
       </sect2>
 
       <sect2 xml:id="install-copytree">
 	<title>安装一个目录下的全部文件</title>
 
 	<para>有时， 会有需要安装大量的文件， 并保持其层次结构， 例如，
 	  将整个目录结构从 <varname>WRKSRC</varname> 复制到 <varname>PREFIX</varname> 的目标目录。</para>
 
 	<para>针对这种情况， 系统提供了两个宏。 使用这些宏，
 	  而不是直接使用 <command>cp</command> 的优势是它们能够确保目标文件的属主和权限正确。 第一个宏，
 	  <varname>COPYTREE_BIN</varname> 将所有安装的文件视为可执行文件， 因而适合安装文件到
 	  <filename>PREFIX/bin</filename>。
 	  第二个宏， <varname>COPYTREE_SHARE</varname>， 则不会设置可执行权限，
 	  因此适合于将文件安装到 <filename>PREFIX/share</filename>
 	  下。</para>
 
 	<programlisting>post-install:
 	${MKDIR} ${EXAMPLESDIR}
 	(cd ${WRKSRC}/examples/ &amp;&amp; ${COPYTREE_SHARE} \* ${EXAMPLESDIR})</programlisting>
 
 	<para>这个例子将原作者提供的整个
 	  <filename>examples</filename> 目录复制到您 port 指定的安装示范文件的位置。</para>
 
 	<programlisting>post-install:
 	${MKDIR} ${DATADIR}/summer
 	(cd ${WRKSRC}/temperatures/ &amp;&amp; ${COPYTREE_SHARE} "June July August" ${DATADIR}/summer/)</programlisting>
 
 	<para>这个例子将把夏季的三个月的数据， 复制到
 	  <filename>DATADIR</filename> 中的
 	  <filename>summer</filename> 子目录。</para>
 
 	<para>经由设置 <varname>COPYTREE_*</varname> 宏的第三个参数，
 	  您还可以为 <command>find</command> 指定额外的参数。
 	  例如， 如果希望安装除了 Makefile 之外的其他所有文件，
 	  可以使用下述命令。</para>
 
 	<programlisting>post-install:
 	${MKDIR} ${EXAMPLESDIR}
 	(cd ${WRKSRC}/examples/ &amp;&amp; \
 		${COPYTREE_SHARE} \* ${EXAMPLESDIR} "! -name Makefile")</programlisting>
 
 	<para>需要注意的是， 这些宏并不能自动将所安装的文件加到
 	  <filename>pkg-plist</filename> 中， 您还是需要自行列出它们。</para>
 
       </sect2>
 
       <sect2 xml:id="install-documentation">
 	<title>安装附加的文档</title>
 
 	<para>如果您的软件包含了标准的联机手册和 info 手册以外的文档，
 	  而且您认为它们对用户会有用， 请把这些文档安装到
 	  <filename>PREFIX/share/doc</filename> 下。
 	  和前面类似， 这也可以在
 	  <buildtarget>post-install</buildtarget> target 中完成。</para>
 
 	<para>为您的 port 建立一个新的目录。
 	  这个目录的名字应该反映它是属于哪个 port 的。 通常建议使用
 	  <varname>PORTNAME</varname>。 不过， 如果您认为不同版本的 port
 	  可能会同时安装， 也可以用完整的
 	  <varname>PKGNAME</varname>。</para>
 
 	<para>另外， 应该让是否安装取决于变量
 	  <varname>NOPORTDOCS</varname> 的设置， 这样用户就能够在
 	  <filename>/etc/make.conf</filename> 中禁止安装它。 例如：</para>
 
 	<programlisting>post-install:
 .if !defined(NOPORTDOCS)
 	${MKDIR} ${DOCSDIR}
 	${INSTALL_MAN} ${WRKSRC}/docs/xvdocs.ps ${DOCSDIR}
 .endif</programlisting>
 
 	<para>这里是一些便于使用的变量， 以及它们在
 	  <filename>Makefile</filename> 中默认的展开方式：</para>
 
 	<itemizedlist>
 	  <listitem>
 	    <para><varname>DATADIR</varname> 会展开成
 	      <filename>PREFIX/share/PORTNAME</filename>。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><varname>DATADIR_REL</varname> 会展开成
 	      <filename>share/PORTNAME</filename>。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><varname>DOCSDIR</varname> 会展开成
 	      <filename>PREFIX/share/doc/PORTNAME</filename>。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><varname>DOCSDIR_REL</varname> 会展开成
 	      <filename>share/doc/PORTNAME</filename>。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><varname>EXAMPLESDIR</varname> 会展开成
 	      <filename>PREFIX/share/examples/PORTNAME</filename>。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><varname>EXAMPLESDIR_REL</varname> 会展开成
 	      <filename>share/examples/PORTNAME</filename>。</para>
 	  </listitem>
 	</itemizedlist>
 
 	<note>
 	  <para><varname>NOPORTDOCS</varname> 只控制将要安装到 <varname>DOCSDIR</varname>
 	    的那些文档， 而不应影响标准的联机手册以及 info 手册的安装。 安装到
 	    <varname>DATADIR</varname> 和 <varname>EXAMPLESDIR</varname>
 	    的文件则相应地受 <varname>NOPORTDATA</varname> 和
 	    <varname>NOPORTEXAMPLES</varname> 控制。</para>
 	</note>
 
 	<para>这些变量也会被导出到 <varname>PLIST_SUB</varname> 中。
 	  只要可能， 它们的值就将在那里以相对于
 	  <filename>PREFIX</filename> 的路径形式出现。
 	  也就是说， <filename>share/doc/PORTNAME</filename>
 	  在装箱单中默认情况下会替换掉 <literal>%%DOCSDIR%%</literal>， 等等。
 	  (更多的 <filename>pkg-plist</filename> 代换可以在
 	  <link linkend="plist-sub">这里</link> 找到。)</para>
 
 	<para>所有非无条件安装的文档文件和目录，
 	  都应在 <filename>pkg-plist</filename> 出现， 并且使用
 	  <literal>%%PORTDOCS%%</literal> 前缀， 例如：</para>
 
 	<programlisting>%%PORTDOCS%%%%DOCSDIR%%/AUTHORS
 %%PORTDOCS%%%%DOCSDIR%%/CONTACT
 %%PORTDOCS%%@dirrm %%DOCSDIR%%</programlisting>
 
 	<para>如果不希望在 <filename>pkg-plist</filename> 中逐个列举文档文件， port
 	  也可以将 <varname>PORTDOCS</varname> 设置为一组文件及其 shell glob
 	  模式， 通过这种方式来加入到最终的装箱单中。
 	  这些名字应是相对于 <varname>DOCSDIR</varname> 的。
 	  因此， 使用了 <varname>PORTDOCS</varname>，
 	  并将文档安装到非标准位置的 port， 应相应地设置
 	  <varname>DOCSDIR</varname>。
 	  如果有在 <varname>PORTDOCS</varname> 中列出目录，
 	  或者这一变量中的 glob 模式匹配到了目录， 则整个子树中的文件和目录，
 	  都将被注册到最终的装箱单中。 如果定义了 <varname>NOPORTDOCS</varname>， 则
 	  <varname>PORTDOCS</varname> 中定义的文件和目录将不被安装或加入装箱单。
 	  是否安装文档到前面所说的 <varname>PORTDOCS</varname> 仍取决于 port 本身。
 	  下面是一个典型的使用 <varname>PORTDOCS</varname> 的例子：</para>
 
         <programlisting>PORTDOCS=       README.* ChangeLog docs/*</programlisting>
 
 	<note>
 	  <para>与 <varname>PORTDOCS</varname> 类似，
 	  对应于 <varname>DATADIR</varname> 和
 	  <varname>EXAMPLESDIR</varname> 的变量分别是 <varname>PORTDATA</varname>
 	  和 <varname>PORTEXAMPLES</varname>。</para>
 
 	  <para>您也可以使用 <filename>pkg-message</filename> 这个文件，
 	    来在安装时显示一些信息。 参见 <link linkend="porting-message">关于使用
 	    <filename>pkg-message</filename> 的这一节</link> 以了解进一步的详情。
 	    需要说明的是， 并不需要把 <filename>pkg-message</filename> 加到
 	    <filename>pkg-plist</filename> 中。</para>
 	</note>
       </sect2>
 
       <sect2 xml:id="install-subdirs">
 	<title>子目录</title>
 
 	<para>尽可能让 port 将它创建的文件， 放置到
 	  <varname>PREFIX</varname> 中正确的位置。 一些 port
 	  会把各式各样的东西混在一起， 并放到一个同名的目录中， 这是不对的。
 	  另外， 许多 port 会把除了可执行文件、 头文件和联机手册之外的所有文件，
 	  全都一股脑地放到 <filename>lib</filename> 中， 这在和 BSD
 	  配合使用时会有问题。 多数文件，
 	  应被放到下列位置之一： <filename>etc</filename>
 	  (安装/配置文件)、 <filename>libexec</filename>
 	  (由系统内部调用的可执行文件)、 <filename>sbin</filename>
 	  (为超级用户/管理员提供的可执行文件)、 <filename>info</filename>
 	  (用于 info 浏览器的文档) 或  <filename>share</filename>
 	  (平台无关的其它文件)。 请参见 &man.hier.7; 以了解进一步的详情； 针对
 	  <filename>/usr</filename> 的那些规则， 同样也适用于
 	  <filename>/usr/local</filename>。 例外情况是那些需要和 USENET
 	  <quote>news</quote> 打交道的 port， 它们可以选择采用
 	  <filename>PREFIX/news</filename>
 	  作为文件的目的地。</para>
       </sect2>
 
     </sect1>
 
     </chapter>
 
     <chapter xml:id="special">
       <title>特殊情况</title>
 
       <para>有一些您在创建port时的特殊情况，我们在这里提一下。</para>
 
       <sect1 xml:id="porting-shlibs">
 	<title>共享库</title>
 
 	<para>如果您的port安装了一个或多个共享库,那么请定义一个
 	  <varname>USE_LDCONFIG</varname> make 变量，
 	  在<buildtarget>post-install</buildtarget>标记把它注册进共享库
 	  缓冲时会调用<filename>bsd.port.mk</filename>去运行
 	  <literal>&dollar;{LDCONFIG} -m</literal>来指向新库的安装目录。
 	  (通常是 <filename>PREFIX/lib</filename>)
 	  同样，您也可以适当的在您的
 	  <filename>pke-plist</filename>文件
 	  中定义一组<literal>@exec /sbin/ldconfig -m</literal>
 	  和<literal>@unexec /sbin/ldconfig -R，</literal>
 	  那么用户可以在安装后马上
 	  就能使用，并且在卸载软件包后系统也不会认为这些共享库仍然存在。</para>
 
 	<programlisting>USE_LDCONFIG= yes</programlisting>
 
 	<para>如果您需要把共享库安装在缺省的位置之外，
 	  可以通过定义 make 变量 <varname>USE_LDCONFIG</varname>
 	  来改变默认的安装路径， 它包含安装共享库的目录列表
 	  例如： 如果您的共享库安装到
 	  <filename>PREFIX/lib/foo</filename> 和
 	  <filename>PREFIX/lib/bar</filename>
 	  directories目录，您可以在您的
 	  <filename>Makefile</filename>中这样设置:</para>
 
 	<programlisting>USE_LDCONFIG= ${PREFIX}/lib/foo ${PREFIX}/lib/bar</programlisting>
 
 	<para>请务必仔细检查， 通常这是完全不必要的，
 	  或者可以通过 <literal>-rpath</literal> 或在连接时设置 <envar>LD_RUN_PATH</envar>
 	  来避免 (参见 <package>lang/moscow_ml</package>
 	  给出的例子)， 或者用一个 shell 封装程序来在执行可执行文件之前设置
 	  <varname>LD_LIBRARY_PATH</varname>， 类似
 	  <package>www/seamonkey</package> 那样。</para>
 
 	<para>当在 64-位系统上安装 32-位 的函数库时， 请使用
 	  <varname>USE_LDCONFIG32</varname>。</para>
 
 	<para>尽量将共享库版本号保持为
 	  <filename>libfoo.so.0</filename> 这样的格式。
 	  我们的运行环境连接器只会检查主 (第一个) 版本数字。</para>
 
 	<para>如果在更新 port 时升级了其库的主版本号，
 	  则其它所有连接了受影响的库的 port 的 <varname>PORTREVISION</varname> 都应递增，
 	  以强制它们采用新版本的库重新编译。</para>
 
       </sect1>
 
       <sect1 xml:id="porting-restrictions">
 	<title>Ports 的发行限制</title>
 
 	<para>众多协议，并且其中的一些致力于
 	  限制怎样的应用程序能被打包，
 	  是否能用于销售赢利等等。</para>
 
 	<important>
 	  <para>
 	    做为一名porter您有义务去阅读软件的协议
 	    并且确保FreeBSD 项目不必为通过FTP/HTTP
 	    或CD-ROM重新发布源码或编译的二进制而解释
 	    什么。如果有任何疑问，
 	    请联系 &a.ports;。</para>
 	</important>
 
 	<para>处于这种情况，就可以设置以下描述
 	  的变量。</para>
 
 	<sect2>
 	  <title><varname>NO_PACKAGE</varname> (禁止编译结果打包)</title>
 
 	  <para>这个变量表示我们可能不能生成这个应用
 	    程序的二进制文件。例如，他的协议不允许
 	    二进制文件的再次发行，或者他可能禁止从
 	    补丁过的源代码打包的发行。</para>
 
 	  <para>不管怎么样，port的 <varname>DISTFILES</varname> 可以
 	    随意的镜像到FTP/HTTP。除非<varname>NO_CDROM</varname>
 	    变量也被设置，软件包也可以发行在一张CD-ROM
 	    （或类似的媒介上）。</para>
 
 	  <para><varname>NO_PACKAGE</varname>也能用在当二进制包
 	    不是非常有用，并且这个应用软件经常要
 	    从源代码编译。例如：当这个应用软件在
 	    编译的时候要在配置信息中指定特定的硬件
 	    代码时，可以设置<varname>NO_PACKAGE</varname>。</para>
 
 	  <para><varname>NO_PACKAGE</varname>应该设置成字符串
 	    来描述为什么这个软件
 	    不能打包。</para>
 	</sect2>
 
 	<sect2>
 	  <title><varname>NO_CDROM</varname> (禁止以 CDROM 发行预编译包)</title>
 
 	  <para>这个变量仅仅指出虽然我们允许
 	    生成二进制包，但也许我们既不能把这个
 	    软件包也不能把port的<varname>DISTFILES</varname>
 	    放在光盘（或类似的媒介）上销售。但不管怎么样，
 	    二进制包和port的<varname>DISTFILES</varname>
 	    可以从FTP/HTTP上获得。</para>
 
 
 	  <para>如果这个变量和
 	    <varname>NO_PACKAGE</varname>一起被设置，
 	    那么这个port的<varname>DISTFIELS</varname>
 	    将只能从FTP/HTTP上获得。</para>
 
 	  <para><varname>NO_CDROM</varname> 应该被设置成一个字符串
 	    来描述为什么这个port不能重新发布在CD-ROM上。
 	    例如：如果这个port的协议仅仅是用于<quote>非商业活动</quote>
 	    ,那么这个变量就能设置了。</para>
 	</sect2>
 
       <sect2>
 	<title><varname>NOFETCHFILES</varname> (不自动抓取指定的文件)</title>
 
 	<para>在 <varname>NOFETCHFILES</varname> 变量中定义的文件，
 	  不会自动从
 	  <varname>MASTER_SITES</varname> 抓取。 一种典型的用例是，
 	  使用来自某个软件供应商提供的 CD-ROM 上的文件。</para>
 
 	<para>用于检查在 <varname>MASTER_SITES</varname> 上是否包含了所需文件的工具，
 	  应忽略这些文件， 而不是报告它们不存在。</para>
       </sect2>
 
       <sect2>
 	<title><varname>RESTRICTED</varname> (禁止任何形式的再分发)</title>
 
 	<para>如果应用程序既不允许镜像其 <varname>DISTFILES</varname>，
 	  也不允许发布其预编译版本的包， 设置它就可以了。</para>
 
 	<para><varname>NO_CDROM</varname> 或 <varname>NO_PACKAGE</varname>
 	  不应与 <varname>RESTRICTED</varname> 同时设置，
 	  因为它包含了这些情形。</para>
 
 	<para><varname>RESTRICTED</varname> 应设置为一个说明 port 为何不能发布的串。
 	  典型情况可能是由于 port 包含了专有的软件， 因而用户需要自行下载
 	  <varname>DISTFILES</varname>， 可能是注册或者同意某一
 	  <acronym>EULA</acronym> 的条款。</para>
       </sect2>
 
       <sect2>
 	<title><varname>RESTRICTED_FILES</varname> (禁止某些文件的再分发)</title>
 
 	<para>当设置了 <varname>RESTRICTED</varname> 或 <varname>NO_CDROM</varname>
 	  时， 这个变量会默认设置为 <literal>${DISTFILES}
 	  ${PATCHFILES}</literal>， 否则它会为空。 如果只有某些源码包文件是受限的，
 	  则可以用这个变量来指明它们。</para>
 
 	<para>注意， port committer 应该在
 	  <filename>/usr/ports/LEGAL</filename> 中为每一个源码包文件撰写对应的项目，
 	  并介绍这些限制的原因。</para>
       </sect2>
     </sect1>
 
     <sect1 xml:id="building">
       <title>联编机制</title>
 
       <sect2 xml:id="parallel-builds">
 	<title>Ports 的并行联编</title>
 
 	<para>&os; ports 框架支持使用多个 <command>make</command> 子进程来进行并行编译，
 	  在 <acronym>SMP</acronym> 上这可以全面地利用系统的
 	  <acronym>CPU</acronym> 计算能力， 令 port 的联编过程更快、 更有效率。</para>
 
 	<para>目前这是通过向原作者的代码传递
 	  &man.make.1; 参数 <varname>-jX</varname> 来实现的。
 	  遗憾的是， 并不是所有的 port 都能够很好地处理这个选项。
 	  因此， 必须通过明确地在 <filename>Makefile</filename> 中指定
 	  <literal>MAKE_JOBS_SAFE=yes</literal> 来启用这一功能。</para>
 
 	<para>从 port 监护人的角度还有一个控制的方法是设置
 	  <varname>MAKE_JOBS_UNSAFE=yes</varname> 变量。
 	  这个变量主要是用于已知不能与 <varname>-jX</varname>
 	  配合使用的 port， 即使用户在 <filename>/etc/make.conf</filename> 中定义了
 	  <literal>FORCE_MAKE_JOBS=yes</literal> 变量， 系统也不会使用并行编译。</para>
       </sect2>
 
       <sect2 xml:id="using-make">
 	<title><command>make</command>、 <command>gmake</command>， 以及
 	  <command>imake</command></title>
 
 	<para>如果 port 用到了 <application>GNU make</application>， 应设置
 	  <literal>USE_GMAKE=yes</literal>。</para>
 
 	  <table frame="none">
 	    <title>与 <application>gmake</application> 有关的 port 变量</title>
 
 	    <tgroup cols="2">
 	      <thead>
 		<row>
 		  <entry>变量</entry>
 
 		  <entry>意义</entry>
 		</row>
 	      </thead>
 
 	      <tbody>
 		<row>
 		  <entry><varname>USE_GMAKE</varname></entry>
 
 		  <entry>此 port 需要使用 <command>gmake</command>
 		    来完成联编过程。</entry>
 		</row>
 
 		<row>
 		  <entry><varname>GMAKE</varname></entry>
 
 		  <entry>不在 <envar>PATH</envar> 中时， <command>gmake</command>
 		    的完整路径。</entry>
 		</row>
 	      </tbody>
 	    </tgroup>
 	  </table>
 
 	  <para>对于 X 应用程序的 port， 如果它使用
 	    <application>imake</application> 根据
 	    <filename>Imakefile</filename> 文件来生成
 	    <filename>Makefile</filename>， 则应设置
 	    <literal>USE_IMAKE=yes</literal>。 这会使联编过程中的配置
 	    (configure) 阶段自动执行 <command>xmkmf -a</command>。
 	    如果 <option>-a</option> 标志会给您的 port 带来麻烦， 则需设置
 	    <literal>XMKMF=xmkmf</literal>。 如果 port 用到了
 	    <application>imake</application> 但并不使用
 	    <buildtarget>install.man</buildtarget> target， 则应设置
 	    <literal>NO_INSTALL_MANPAGES=yes</literal>。</para>
 
 	  <para>如果 port 源文件的 <filename>Makefile</filename> 的主联编
 	    target 是 <buildtarget>all</buildtarget> 以外的名字，
 	    应对应地设置 <varname>ALL_TARGET</varname>。
 	    对于 <buildtarget>install</buildtarget> 而言， 对应的变量是
 	    <varname>INSTALL_TARGET</varname>。</para>
 
 	</sect2>
 
 	<sect2 xml:id="using-configure">
 	  <title><command>configure</command> 脚本</title>
 
 	<para>假如 port 使用 <command>configure</command> 脚本来从
 	  <filename>Makefile.in</filename>
 	  生成 <filename>Makefile</filename> 文件， 需要设置
 	  <literal>GNU_CONFIGURE=yes</literal>。
 	  如果希望传额外的参数给 <command>configure</command> 脚本
 	  (默认参数为 <literal>--prefix=&dollar;{PREFIX}
 	  --infodir=&dollar;{PREFIX}/&dollar;{INFO_PATH}
 	  --mandir=&dollar;{MANPREFIX}/man
 	  --build=&dollar;{CONFIGURE_TARGET}</literal>)，
 	  应通过 <varname>CONFIGURE_ARGS</varname> 来指定这些参数。
 	  类似地， 可以通过
 	  <varname>CONFIGURE_ENV</varname> 变量来传递一些环境变量。</para>
 
 	<para>如果您的软件包使用 GNU <command>configure</command>，
 	  而生成的可执行文件命名方式 <quote>怪异</quote> 如
 	  <filename>i386-portbld-freebsd4.7-</filename><replaceable>应用程序名</replaceable>，
 	  则需要更进一步地通过改变
 	  <varname>CONFIGURE_TARGET</varname> 变量来按照较新版本的
 	  <command>autoconf</command> 生成的脚本所希望的方式指定 target。
 	  其方法是， 紧随 <filename>Makefile</filename>
 	  中 <literal>GNU_CONFIGURE=yes</literal> 一行之后加入：</para>
 
 	<para>
 	  <literal>CONFIGURE_TARGET=--build=${MACHINE_ARCH}-portbld-freebsd${OSREL}</literal>
 	  </para>
 
 	  <table frame="none">
 	    <title>用于用到了 <command>configure</command> 脚本的 port 的变量</title>
 
 	    <tgroup cols="2">
 	      <thead>
 		<row>
 		  <entry>变量</entry>
 
 		  <entry>意义</entry>
 		</row>
 	      </thead>
 
 	      <tbody>
 		<row>
 		  <entry><varname>GNU_CONFIGURE</varname></entry>
 
 		  <entry>此 port 需要用 <command>configure</command> 脚本来准备联编。</entry>
 		</row>
 
 		<row>
 		  <entry><varname>HAS_CONFIGURE</varname></entry>
 
 		  <entry>与 <varname>GNU_CONFIGURE</varname> 类似，
 		    但默认的 configure target 并不加入
 		    <varname>CONFIGURE_ARGS</varname>。</entry>
 		</row>
 
 		<row>
 		  <entry><varname>CONFIGURE_ARGS</varname></entry>
 
 		  <entry>希望传给
 		    <command>configure</command> 脚本的额外参数。</entry>
 		</row>
 
 		<row>
 		  <entry><varname>CONFIGURE_ENV</varname></entry>
 
 		  <entry>希望在执行 <command>configure</command>
 		    脚本时设置的环境变量。</entry>
 		</row>
 
 		<row>
 		  <entry><varname>CONFIGURE_TARGET</varname></entry>
 
 		  <entry>替换默认的 configure target。 其默认值是
 		    <literal>&dollar;{MACHINE_ARCH}-portbld-freebsd&dollar;{OSREL}</literal>。</entry>
 		</row>
 	      </tbody>
 	    </tgroup>
 	  </table>
 	</sect2>
 
 	<sect2 xml:id="using-scons">
 	  <title>使用 <command>scons</command></title>
 
 	  <para>如果您的 port 使用 <application>SCons</application>， 就需要定义
 	    <literal>USE_SCONS=yes</literal> 了。</para>
 
 	  <table frame="none">
 	    <title>使用 <command>scons</command> 的 port 会用到的变量</title>
 
 	    <tgroup cols="2">
 	      <thead>
 		<row>
 		  <entry>变量</entry>
 
 		  <entry>含义</entry>
 		</row>
 	      </thead>
 
 	      <tbody>
 		<row>
 		  <entry><varname>SCONS_ARGS</varname></entry>
 
 		  <entry>当前 port 希望传给 SCons
 		    环境的参数。</entry>
 		</row>
 
 		<row>
 		  <entry><varname>SCONS_BUILDENV</varname></entry>
 
 		  <entry>希望在系统环境中设置的变量。</entry>
 		</row>
 
 		<row>
 		  <entry><varname>SCONS_ENV</varname></entry>
 
 		  <entry>希望在 SCons 环境中设置的变量。</entry>
 		</row>
 
 		<row>
 		  <entry><varname>SCONS_TARGET</varname></entry>
 
 		  <entry>传递给 SCons 的最后一个参数， 类似于
 		    <varname>MAKE_TARGET</varname>。</entry>
 		</row>
 	      </tbody>
 	    </tgroup>
 	  </table>
 
 	  <para>如果希望让第三方的 <filename>SConstruct</filename> 尊重通过 <varname>SCONS_ENV</varname>
 	    (其中最重要的是
 	    <varname>CC/CXX/CFLAGS/CXXFLAGS</varname> 配置) 传给 Scons 的配置， 则需要对
 	    <filename>SConstruct</filename> 进行修改， 使联编的
 	    <literal>Environment</literal> 按下列方式建立：</para>
 
 	  <programlisting>env = Environment(**ARGUMENTS)</programlisting>
 
 	  <para>其后， 可以通过 <literal>env.Append</literal> 和
 	    <literal>env.Replace</literal> 来对它进行修改。</para>
 	</sect2>
     </sect1>
 
     <sect1 xml:id="using-autotools">
       <title>利用 GNU autotools</title>
 
 	<sect2 xml:id="using-autotools-introduction">
 	  <title>入门</title>
 
 	  <para>众多 GNU autotools 提供了一种在多重操作系统和机器架构之上联编软件的抽象机制。
 	    在 Ports Collection 中， port 可以通过简单的方法来使用这些工具：</para>
 
 	  <programlisting>USE_AUTOTOOLS= <replaceable>工具</replaceable>:<replaceable>版本</replaceable>[:<replaceable>操作</replaceable>] ...</programlisting>
 
 	  <para>撰写本书时， <replaceable>工具</replaceable> 可以设置为
 	    <literal>libtool</literal>、 <literal>libltdl</literal>、
 	    <literal>autoconf</literal>、 <literal>autoheader</literal>、
 	    <literal>automake</literal> 或 <literal>aclocal</literal> 之一。</para>
 
 	  <para><replaceable>版本</replaceable> 用来指定希望使用的工具的特定版本 (参见
 	    <literal>devel/{automake,autoconf,libtool}[0-9]+</literal>
 	    以了解有效的版本号)。</para>
 
 	  <para><replaceable>操作</replaceable> 是一个可选的扩展选项，
 	    用于修改如何使用工具。</para>
 
 	  <para>可以同时指定多个不同的工具， 可以在一行中指定， 也可以用
 	    Makefile 的 <literal>+=</literal> 结构。</para>
 
           <para>最后， 可以使用一个特殊的名为
 	    <literal>autotools</literal> 的工具，
 	    它会安装全部可用的 autotools 版本，
 	    以适应跨平台开发的需要。 您可以通过安装 <literal>devel/autotools</literal> port 来达到这一目的。</para>
 
 	</sect2>
 
 	<sect2 xml:id="using-libtool">
 	  <title><command>libtool</command></title>
 
 	  <para>使用 GNU 联编框架的共享库通常会使用
 	    <command>libtool</command> 来调整共享库的编译和安装，
 	    以便与所运行的操作系统相匹配。 通常的做法是使用应用程序所附带的
 	    <command>libtool</command> 副本。
 	    如果需要使用外部的 <command>libtool</command>，
 	    则可以使用 Ports 套件提供的版本：</para>
 
 	  <programlisting>USE_AUTOTOOLS= libtool:<replaceable>版本</replaceable>[:env]</programlisting>
 
 	  <para>如果不使用额外的操作符，
 	    <literal>libtool:版本</literal>
 	    表示希望联编框架使用 configure 脚本来对系统所安装的 <command>libtool</command>
 	    进行修补。 这会暗含地定义 <varname>GNU_CONFIGURE</varname>。
 	    更进一步， 联编框架还会设置一系列 make 和 shell
 	    变量用于 port 后续的操作。 请参见
 	    <filename>bsd.autotools.mk</filename> 了解进一步的详情。</para>
 
 	  <para>如果指定了 <literal>:env</literal> 操作符， 则表示只设置环境，
 	    而跳过其他的操作。</para>
 
 	  <para>最后， <varname>LIBTOOLFLAGS</varname> 和
 	    <varname>LIBTOOLFILES</varname> 可以用来替换最常修改的参数， 以及将被
 	    <command>libtool</command> 修补的文件。 多数 port 不需要这样做。
 	    请参见 <filename>bsd.autotools.mk</filename> 以了解进一步的细节。</para>
 
 	</sect2>
 
 	<sect2 xml:id="using-libltdl">
 	  <title><command>libltdl</command></title>
 
 	  <para>一些 ports 会使用 <command>libltdl</command> 库，
 	    后者是 <command>libtool</command> 软件包的一部分。
 	    使用这个库并不意味着必须使用
 	    <command>libtool</command> 本身， 因此提供了另一组结构。</para>
 
 	  <programlisting>USE_AUTOTOOLS= libltdl:<replaceable>版本</replaceable></programlisting>
 
 	  <para>目前， 这一设置所做的全部工作是将
 	    <varname>LIB_DEPENDS</varname> 设置为适当的
 	    <command>libltdl</command> port， 并作为一项方便的功能，
 	    协助开发人员消除在 <varname>USE_AUTOTOOLS</varname> 框架以外的，
 	    对于 autotools port 的依赖。 这个工具并不提供其它的操作符。</para>
 
 	</sect2>
 
 	<sect2 xml:id="using-autoconf">
 	  <title><command>autoconf</command> 和
 	    <command>autoheader</command></title>
 
 	  <para>某些 port 并没有直接提供 configure 脚本， 但包含了作为
 	    autoconf 模板的 <filename>configure.ac</filename> 文件。
 	    可以用下列设置来要求
 	    <command>autoconf</command> 创建 configure 脚本，
 	    并使用 <command>autoheader</command> 来为 configure
 	    脚本创建模板头文件。</para>
 
 	  <programlisting>USE_AUTOTOOLS=	autoconf:<replaceable>版本</replaceable>[:env]</programlisting>
 
 	  <para>以及</para>
 
 	  <programlisting>USE_AUTOTOOLS=	autoheader:<replaceable>版本</replaceable></programlisting>
 
 	  <para>上述设置会暗含使用
 	    <literal>autoconf:版本</literal>。</para>
 
 	  <para>对于 <command>libtool</command>， 设置与前面类似。
 	    如果指定可选的 <literal>:env</literal> 操作符，
 	    则表示只设置用于后续工作的环境。 如果不指定，
 	    则会对 port 进行相应的修补和重新配置。</para>
 
 	  <para>其它的可选变量， 如
 	    <varname>AUTOCONF_ARGS</varname> 和
 	    <varname>AUTOHEADER_ARGS</varname> 可以通过 port 的
 	    <filename>Makefile</filename> 来显式地指定替换。
 	    类似 <command>libtool</command>， 多数 port 并不需要这样做。</para>
 
 	</sect2>
 
 	<sect2 xml:id="using-automake">
 	  <title><command>automake</command> 和
 	    <command>aclocal</command></title>
 
 	  <para>某些软件包只提供了 <filename>Makefile.am</filename>
 	    文件。 这些文件必须首先用
 	    <command>automake</command> 转换为
 	    <filename>Makefile.in</filename> 并使用
 	    <command>configure</command> 来生成实际的
 	    <filename>Makefile</filename>。</para>
 
 	  <para>类似地， 偶尔会有一些软件包不提供联编所需的
 	    <filename>aclocal.m4</filename> 文件。
 	    这些文件可以通过使用 <command>aclocal</command>
 	    来扫描 <filename>configure.ac</filename> 或
 	    <filename>configure.in</filename> 自动生成。</para>
 
 	  <para><command>aclocal</command> 与
 	    <command>automake</command> 有和 <command>autoheader</command>
 	    与 <command>autoconf</command> 在前面一节中所介绍的相类似的关系。
 	    <command>aclocal</command> 会暗含使用
 	    <command>automake</command>， 因此：</para>
 
 	  <programlisting>USE_AUTOTOOLS=	automake:<replaceable>版本</replaceable>[:<replaceable>env</replaceable>]</programlisting>
 
 	  <para>和</para>
 
 	  <programlisting>USE_AUTOTOOLS=	aclocal:<replaceable>版本</replaceable></programlisting>
 
 	  <para>也自动暗含使用
 	    <literal>automake:版本</literal>。</para>
 
 	  <para>与 <command>libtool</command> 类似，
 	    <command>autoconf</command> 如果使用了可选的
 	    <literal>:env</literal> 操作符表示仅仅设置用于后续使用的环境，
 	    如果不设置， 则会对 port 进行重新配置。</para>
 
 	  <para>对于
 	    <command>autoconf</command> 和 <command>autoheader</command> 而言，
 	    <command>automake</command> 和 <command>aclocal</command>
 	    提供了对应的可选参数变量 <varname>AUTOMAKE_ARGS</varname> 和
 	    <varname>ACLOCAL_ARGS</varname>， 如果需要的话，
 	    可以在 port 的 <filename>Makefile</filename> 中指定。</para>
 
 	</sect2>
     </sect1>
 
     <sect1 xml:id="using-gettext">
       <title>使用 GNU <literal>gettext</literal></title>
 
       <sect2>
 	<title>基本用法</title>
 
 	<para>如果您的 port 需要使用 <literal>gettext</literal>，
 	  只要将 <varname>USE_GETTEXT</varname> 设置为 <literal>yes</literal>，
 	  您的 port 就会增加对 <package>devel/gettext</package> 的依赖。
 	  <varname>USE_GETTEXT</varname> 也可以指定为所需的
 	  <literal>libintl</literal> 库的版本，
 	  它是 <literal>gettext</literal> 的基本组成部分，
 	  尽管如此， <emphasis>强烈建议您不要</emphasis> 使用这个功能：
 	  您的 port 应能与目前版本的
 	  <package>devel/gettext</package> 配合工作。</para>
 
 	<para>在 port 中相当常见的情况下， 会需要同时使用
 	  <literal>gettext</literal> 和 <command>configure</command>。
 	  一般而言， GNU <command>configure</command> 能够自动定位到 <literal>gettext</literal>。
 	  如果它没有成功地完成这项工作， 则可以通过类似下面这样的
 	  <envar>CPPFLAGS</envar> 和 <envar>LDFLAGS</envar> 将
 	  <literal>gettext</literal> 的位置告诉它：</para>
 
 	<programlisting>USE_GETTEXT=    yes
 CPPFLAGS+=      -I${LOCALBASE}/include
 LDFLAGS+=       -L${LOCALBASE}/lib
 
 GNU_CONFIGURE=  yes
 CONFIGURE_ENV=  CPPFLAGS="${CPPFLAGS}" \
                 LDFLAGS="${LDFLAGS}"</programlisting>
 
 	<para>当然， 不需要传参数给 <command>configure</command> 时， 代码可以更为简练：</para>
 
 	<programlisting>USE_GETTEXT=    yes
 GNU_CONFIGURE=  yes
 CONFIGURE_ENV=  CPPFLAGS="-I${LOCALBASE}/include" \
                 LDFLAGS="-L${LOCALBASE}/lib"</programlisting>
       </sect2>
 
       <sect2>
 	<title>可选用法</title>
 
 	<para>一些软件产品提供了禁用 NLS 的能力，
 	  例如， 在 <command>configure</command> 时， 指定
 	  <option>--disable-nls</option> 参数。 如果您 port
 	  的软件支持这种配置， 则应根据 <link linkend="knobs-without-nls"><varname>WITHOUT_NLS</varname></link>
 	  的设置来有条件地使用 <literal>gettext</literal>。
 	  对于比较简单和不太复杂的 port， 您可以使用下列结构：</para>
 
 	<programlisting>GNU_CONFIGURE=          yes
 
 .if !defined(WITHOUT_NLS)
 USE_GETTEXT=            yes
 PLIST_SUB+=             NLS=""
 .else
 CONFIGURE_ARGS+=        --disable-nls
 PLIST_SUB+=             NLS="@comment "
 .endif</programlisting>
 
 	<para>您要做的下一件事是合理地安排装箱单文件，
 	  使其根据用户配置来决定是否将消息编录 (message catalog)
 	  文件放入最终的装箱单。 前面已经介绍了在 <filename>Makefile</filename>
 	  中所需的写法， 这种做法在 <link linkend="plist-sub">高级
 	  <filename>pkg-plist</filename> 用法</link> 这节中进行了介绍。
 	  简单地说， 在 <filename>pkg-plist</filename>
 	  中出现的 <literal>%%NLS%%</literal> 均会在禁用 NLS 时自动替换为
 	  <quote><literal>@comment&nbsp;</literal></quote>，
 	  反之则替换为空串。 这样， 在最终的装箱单中带 <literal>%%NLS%%</literal> 的行，
 	  在 NLS 关闭的情况下就会变为注释， 反之， 这些前缀就会自动删掉。
 	  现在需要做的事情就是把 <literal>%%NLS%%</literal> 插到 <filename>pkg-plist</filename>
 	  中的消息编录文件的那些行开头， 例如：</para>
 
 	<programlisting>%%NLS%%share/locale/fr/LC_MESSAGES/foobar.mo
 %%NLS%%share/locale/no/LC_MESSAGES/foobar.mo</programlisting>
 
 	<para>在比较复杂的情形中， 您可能需要使用更高级的技术， 例如 <link linkend="plist-dynamic">动态生成装箱单</link> 等。</para>
       </sect2>
 
       <sect2>
 	<title>处理消息编录目录</title>
 
 	<para>在安装消息编录文件时还有一个需要注意的地方。 这些文件会放到
 	  <filename>LOCALBASE/share/locale</filename>
 	  下与语言对应的目录中， 这些目录一般您的 port 不需要创建和删除。
 	  最常用的语言的目录已经在 <filename>/etc/mtree/BSD.local.dist</filename>
 	  中列出； 也就是说， 它们是基本系统的一部分。 其他一些语言的目录， 则由 <package>devel/gettext</package> 控制。
 	  您最好查看一下 <filename>pkg-plist</filename>，
 	  以确定是否正在安装某种不常用语言的文件。</para>
       </sect2>
     </sect1>
 
     <sect1 xml:id="using-perl">
       <title>使用 <literal>perl</literal></title>
 
       <para>如果 <varname>MASTER_SITES</varname> 设为
 	<varname>MASTER_SITE_PERL_CPAN</varname>， 则应尽量把
 	<varname>MASTER_SITE_SUBDIR</varname> 设置为顶级目录的名字。
 	例如， 对 <literal>p5-Module-Name</literal>
 	而言推荐的名字是 <literal>Module</literal>。
 	您可以在 <link xlink:href="http://cpan.org/modules/by-module/">cpan.org</link>
 	找到顶级目录的名字。 这可以确保在模块的作者发生变化时，
 	保持 port 继续可用。</para>
 
       <para>以上规则有一个例外， 即对应目录不存在或源码包不在那个目录中时， 允许使用作者的 id 作为
 	<varname>MASTER_SITE_SUBDIR</varname>。</para>
 
       <para>所有这些选项均同时接受 <literal>YES</literal>
 	和版本串， 类似 <literal>5.8.0+</literal> 这样的写法。 使用
 	<literal>YES</literal> 表示 port 能够配合所有受支持的 <application>Perl</application> 版本来使用。
 	如果 port 只能配合特定版本的 <application>Perl</application> 来使用，
 	则可以用版本串来表示， 例如最低版本
 	(如 <literal>5.7.3+</literal>)、 最高版本 (如
 	<literal>5.8.0-</literal>) 或某个具体的版本 (如
 	<literal>5.8.3</literal>)。</para>
 
       <table frame="none">
 	<title>用于用到 <literal>perl</literal> 的 port 的变量</title>
 
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>变量</entry>
 
 	      <entry>意义</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry><varname>USE_PERL5</varname></entry>
 
 	      <entry>表示 port 将 <literal>perl 5</literal> 用于联编和运行。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_PERL5_BUILD</varname></entry>
 
 	      <entry>表示 port 将 <literal>perl 5</literal> 用于联编。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_PERL5_RUN</varname></entry>
 
 	      <entry>表示 port 将 <literal>perl 5</literal> 用于运行。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PERL</varname></entry>
 
 	      <entry><literal>perl 5</literal> 的完整路径， 可能是系统自带的，
 		或者从 port 安装， 但没有版本号。 如果您需要在脚本中替换
 		<quote><literal>#!</literal></quote> 行， 则应使用这个变量。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PERL_CONFIGURE</varname></entry>
 
 	      <entry>采用 Perl 的 MakeMaker 进行配置。 这一变量隐含设置
 		<varname>USE_PERL5</varname>。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PERL_MODBUILD</varname></entry>
 
 	      <entry>使用 Module::Build 进行配置、 联编并安装。
 		这一变量隐含设置 <varname>PERL_CONFIGURE</varname>。</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
 
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>只读变量</entry>
 
 	      <entry>意义</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry><varname>PERL_VERSION</varname></entry>
 
 	      <entry>系统中安装的 <literal>perl</literal> 的完整版本 (例如，
 		<literal>5.8.9</literal>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PERL_LEVEL</varname></entry>
 
 	      <entry>系统中安装的 <literal>perl</literal> 的版本整数值，
 		其形式为 <literal>MNNNPP</literal>
 		(例如， <literal>500809</literal>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PERL_ARCH</varname></entry>
 
 	      <entry><literal>perl</literal> 保存某平台专用的库的位置。
 		默认值为 <literal>${ARCH}-freebsd</literal>。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PERL_PORT</varname></entry>
 
 	      <entry>系统中所安装的 <literal>perl</literal> port 的名字
 		(例如， <literal>perl5</literal>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>SITE_PERL</varname></entry>
 
 	      <entry>站点专用的
 		<literal>perl</literal> package 安装路径。
 		其值会自动加入到 PLIST_SUB 中。</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <note>
 	<para>Perl 模块通常并没有官方网站， 这些 port
 	  应将 <systemitem>cpan.org</systemitem> 作为其
 	  <filename>pkg-descr</filename> WWW 行的内容。 推荐的 URL 格式为
 	  <literal>http://search.cpan.org/dist/Module-Name/</literal>
 	  (保留最后的斜线)。</para>
       </note>
 
     </sect1>
 
     <sect1 xml:id="using-x11">
       <title>使用 X11</title>
 
       <sect2 xml:id="x11-variables">
 	<title>X.Org 组件</title>
 
 	<para>在 Ports 套件中提供的 X11 实现是 X.Org。
 	  如果您的应用程序用到了 X 组件， 则应将
 	  <varname>USE_XORG</varname> 设为所需要的那些组件。
 	  目前可用的组件包括：</para>
 
 	<para><literal>bigreqsproto compositeproto damageproto dmx dmxproto
 	  evieproto fixesproto fontcacheproto fontenc fontsproto fontutil
 	  glproto ice inputproto kbproto libfs oldx printproto randrproto
 	  recordproto renderproto resourceproto scrnsaverproto sm trapproto
 	  videoproto x11 xau xaw xaw6 xaw7 xaw8 xbitmaps xcmiscproto xcomposite
 	  xcursor xdamage xdmcp xevie xext xextproto xf86bigfontproto
 	  xf86dgaproto xf86driproto xf86miscproto xf86rushproto
 	  xf86vidmodeproto xfixes xfont xfontcache xft xi xinerama
 	  xineramaproto xkbfile xkbui xmu xmuu xorg-server xp xpm xprintapputil
 	  xprintutil xpr oto xproxymngproto xrandr xrender xres xscrnsaver xt
 	  xtrans xtrap xtst xv xvmc xxf86dga xxf86misc xxf86vm</literal>.</para>
 
 	<para>最新的列表， 可以在
 	  <filename>/usr/ports/Mk/bsd.xorg.mk</filename> 中找到。</para>
 
 	<para>The Mesa Project 是一个致力于自由的 OpenGL
 	  实现的计划。 您可以使用 <varname>USE_GL</varname> 变量来让 port 依赖其不同的组件。
 	  可用的选项包括： <literal>glut, glu, glw, glew, gl</literal> 和
 	  <literal>linux</literal>。 为了实现向前兼容，
 	  当使用 <literal>yes</literal> 时系统会自动将其映射为 <literal>glu</literal>。</para>
 
 	<example xml:id="use-xorg-example">
 	  <title>使用 USE_XORG 的例子</title>
 	  <programlisting>USE_XORG=   xrender xft xkbfile xt xaw
 USE_GL=     glu</programlisting>
 	</example>
 
 	<para>许多 ports 会定义 <varname>USE_XLIB</varname>，
 	  这会导致 port 依赖 50 多个动态连接库。 由于它出现于 X.org
 	  模块化之前， 因此这个变量仅为向前兼容的原因提供，
 	  新的 port 不应再使用它。</para>
 
       <table frame="none">
 	<title>用到 X 的 port 可以使用的变量</title>
 
 	<tgroup cols="2">
 	  <tbody>
 	    <row>
 	      <entry><varname>USE_XLIB</varname></entry>
 
 	      <entry>此 port 用到了 X 库。 已过时 - 您应使用 <varname>USE_XORG</varname> 变量列出用到的
 		X.Org 组件， 而不是使用这个变量。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_IMAKE</varname></entry>
 
 	      <entry>此 port 用到了 <command>imake</command>。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_X_PREFIX</varname></entry>
 
 	      <entry>已过时。 目前其作用与
 		<varname>USE_XLIB</varname> 相同， 并可以直接用后者替换。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>XMKMF</varname></entry>
 
 	      <entry>设置为 <command>xmkmf</command> 的完整路径名， 如果它不在
 		<envar>PATH</envar> 中的话。 默认值是 <literal>xmkmf
 		  -a</literal>。</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <table frame="none">
 	<title>用于表示对 X11 某些组件的依赖关系的变量</title>
 
 	<tgroup cols="2">
 	  <tbody>
 	    <row>
 	      <entry><varname>X_IMAKE_PORT</varname></entry>
 
 	      <entry>用以提供 <command>imake</command> 以及许多其它用于联编
 		X11 的工具的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_LIBRARIES_PORT</varname></entry>
 
 	      <entry>用以提供 X11 库的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_CLIENTS_PORT</varname></entry>
 
 	      <entry>用以提供 X 客户的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_SERVER_PORT</varname></entry>
 
 	      <entry>用以提供 X 服务的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_FONTSERVER_PORT</varname></entry>
 
 	      <entry>用以提供字体服务的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_PRINTSERVER_PORT</varname></entry>
 
 	      <entry>用以提供打印服务的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_VFBSERVER_PORT</varname></entry>
 
 	      <entry>用以提供在虚拟帧缓存服务(virtual framebuffer server) 的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_NESTSERVER_PORT</varname></entry>
 
 	      <entry>用以提供嵌套 X 服务的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_FONTS_ENCODINGS_PORT</varname></entry>
 
 	      <entry>用以为字体提供编码的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_FONTS_MISC_PORT</varname></entry>
 
 	      <entry>用以提供多种位图字体的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_FONTS_100DPI_PORT</varname></entry>
 
 	      <entry>用以提供 100dpi 位图字体的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_FONTS_75DPI_PORT</varname></entry>
 
 	      <entry>用以提供 75dpi 位图字体的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_FONTS_CYRILLIC_PORT</varname></entry>
 
 	      <entry>用以提供西里尔位图字体的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_FONTS_TTF_PORT</varname></entry>
 
 	      <entry>用以提供 &truetype; 字体的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_FONTS_TYPE1_PORT</varname></entry>
 
 	      <entry>用以提供 Type1 字体的 port。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>X_MANUALS_PORT</varname></entry>
 
 	      <entry>用以提供面向开发人员的联机手册的 port。</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <example xml:id="using-x11-vars">
 	<title>在变量中使用与 X11 有关的变量</title>
 	<programlisting># 使用某些 X11 库并依赖字体服务和西里尔字体。
 RUN_DEPENDS=   ${LOCALBASE}/bin/xfs:${X_FONTSERVER_PORT} \
                ${LOCALASE}/lib/X11/fonts/cyrillic/crox1c.pcf.gz:${X_FONTS_CYRILLIC_PORT}
 
 USE_XORG=      x11 xpm</programlisting>
       </example>
 
       </sect2>
 
       <sect2 xml:id="x11-motif">
 	<title>需要使用 Motif 的 port</title>
 
 	<para>如果您的 port 需要 Motif 库， 则应在
 	  <filename>Makefile</filename> 中定义 <varname>USE_MOTIF</varname>。
 	  默认的 Motif 实现是
 	  <package>x11-toolkits/open-motif</package>。
 	  用户可以通过设置 <varname>WANT_LESSTIF</varname> 变量来选择
 	  <package>x11-toolkits/lesstif</package> 代替它。</para>
 
 	<para><filename>bsd.port.mk</filename> 会将 <varname>MOTIFLIB</varname>
 	  变量设置为到合适的 Motif 库的引用。 请使用补丁将您 port 中
 	  <filename>Makefile</filename> 或
 	  <filename>Imakefile</filename> 提到 Motif
 	  库的地方改为 <literal>&dollar;{MOTIFLIB}</literal>。</para>
 
 	<para>有两种比较常见的情况：</para>
 
 	<itemizedlist>
 	  <listitem>
 	    <para>如果 port 中将 Motif 在其 <filename>Makefile</filename> 或
 	      <filename>Imakefile</filename> 表达为
 	      <literal>-lXm</literal>， 则简单地将其替换为
 	      <literal>&dollar;{MOTIFLIB}</literal>。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>如果 port 在其 <filename>Imakefile</filename>
 	      中使用 <literal>XmClientLibs</literal>， 则将其改为
 	      <literal>&dollar;{MOTIFLIB} &dollar;{XTOOLLIB}
 		&dollar;{XLIB}</literal>.</para>
 	  </listitem>
 
 	</itemizedlist>
 
 	<para>注意 <varname>MOTIFLIB</varname> (通常) 会展开为
 	  <literal>-L/usr/X11R6/lib -lXm</literal> 或
 	  <literal>/usr/X11R6/lib/libXm.a</literal>， 所以不需要在其前加入
 	  <literal>-L</literal> 或 <literal>-l</literal>。</para>
 
       </sect2>
 
       <sect2>
 	<title>X11 字体</title>
 
 	<para>如果 port 将为 X Window 系统安装字体， 将这些字体放到
 	  <filename>LOCALBASE/lib/X11/fonts/local</filename>。</para>
 
       </sect2>
 
       <sect2>
 	<title>通过 Xvfb 来获得虚拟的 <envar>DISPLAY</envar></title>
 
 	<para>某些应用程序必须在有可用的 X11 显示的时候才能成功编译。
 	  当编译的机器没有控制台时， 这会带来问题。 为了解决这个问题，
 	  如果定义了适当的变量， 联编基础设施会启动采用虚拟帧缓存的
 	  X server。 此时， 编译过程中将会传出可用的 <envar>DISPLAY</envar>。</para>
 
 	<programlisting>USE_DISPLAY=  yes</programlisting>
 
       </sect2>
 
       <sect2 xml:id="desktop-entries">
 	<title>桌面项</title>
 
 	<para>通过利用
 	  <varname>DESKTOP_ENTRIES</varname> 变量，
 	  可以很容易地在您的 port 中创建桌面项 (<link xlink:href="http://standards.freedesktop.org/desktop-entry-spec/latest/">Freedesktop
 	  标准</link>)。 这些项会在类似 GNOME 或 KDE
 	  这样的符合这一标准的桌面环境中显示在应用程序菜单中。
 	  这样做会自动创建、 安装 <filename>.desktop</filename> 文件， 并将其加入
 	  <filename>pkg-plist</filename>。 其语法为：</para>
 
 	<programlisting>DESKTOP_ENTRIES=  "NAME" "COMMENT" "ICON" "COMMAND" "CATEGORY" StartupNotify</programlisting>
 
 	<para>您可以在 <link xlink:href="http://standards.freedesktop.org/menu-spec/latest/apa.html">
 	  Freedesktop 网站上</link> 找到可用的分类名称。 <varname>StartupNotify</varname>
 	  表示应用程序在支持启动通知的环境中清除状态信息。</para>
 
 	<para>例子：</para>
 
 	<programlisting>DESKTOP_ENTRIES=  "ToME" "Roguelike game based on JRR Tolkien's work" \
                   "${DATADIR}/xtra/graf/tome-128.png" \
                   "tome -v -g" "Application;Game;RolePlaying;" \
                   false</programlisting>
 
       </sect2>
 
     </sect1>
 
     <sect1 xml:id="using-gnome">
       <title>使用 GNOME</title>
 
       <para>FreeBSD/GNOME 项目组使用一组自己的变量来定义 port
 	所使用的 GNOME 组件。
 	<link xlink:href="http://www.FreeBSD.org/gnome/docs/porting.html">这些变量的详细列表</link>
 	 可以在 FreeBSD/GNOME 项目的主页找到。</para>
 
     </sect1>
 
     <sect1 xml:id="using-qt">
       <title>使用 Qt</title>
 
       <sect2 xml:id="qt-common">
 	<title>在 port 中使用 Qt</title>
 
 	<table frame="none">
 	  <title>用于使用 Qt 的 port 的变量</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 	      <row>
 		<entry><varname>USE_QT_VER</varname></entry>
 
 		<entry>表示 port 用到了 Qt 工具套件。
 		  可用的值包括 <literal>3</literal> 和 <literal>4</literal>；
 		  用于指定使用的 Qt 的主版本。 此外， 系统会自动为 <command>configure</command>
 		  脚本和 <command>make</command> 命令提供必要的参数。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>QT_PREFIX</varname></entry>
 
 		<entry>这个变量会自动设为 Qt 的安装路径 (只读变量)。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>MOC</varname></entry>
 
 		<entry>这个变量会自动设为 <command>moc</command> 的路径
 		  (只读变量)。 默认值与
 		  <varname>USE_QT_VER</varname> 变量的值有关。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>QTCPPFLAGS</varname></entry>
 
 		<entry>通过
 		  <varname>CONFIGURE_ENV</varname> 传给 Qt 工具套件的编译参数。
 		  默认配置与
 		  <varname>USE_QT_VER</varname> 有关。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>QTCFGLIBS</varname></entry>
 
 		<entry>通过
 		  <varname>CONFIGURE_ENV</varname> 传给 Qt 工具套件的连接库。
 		  默认配置与
 		  <varname>USE_QT_VER</varname> 有关。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>QTNONSTANDARD</varname></entry>
 
 		<entry>禁止系统自动修改
 		  <varname>CONFIGURE_ENV</varname>、
 		  <varname>CONFIGURE_ARGS</varname> 和
 		  <varname>MAKE_ENV</varname>。</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<table frame="none">
 	  <title>其他用于使用 Qt 4.x 的变量</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 	      <row>
 		<entry><varname>QT_COMPONENTS</varname></entry>
 
 		<entry>用于指定 Qt4 工具和函数库的依赖。
 		  详情见后。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>UIC</varname></entry>
 
 		<entry>这个变量会自动设为 <command>uic</command> 的路径 (只读变量)。
 		  默认值与
 		  <varname>USE_QT_VER</varname> 有关。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>QMAKE</varname></entry>
 
 		<entry>这个变量会自动设为 <command>qmake</command> 的路径
 		  (只读变量)。 其默认值与
 		  <varname>USE_QT_VER</varname> 有关。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>QMAKESPEC</varname></entry>
 
 		<entry>这个变量会自动设为
 		  <command>qmake</command> 配置文件的路径 (只读变量)。
 		  其默认值与 <varname>USE_QT_VER</varname>
 		  有关。</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>当设置了 <varname>USE_QT_VER</varname> 时，
 	  系统自动会给 <command>configure</command> 脚本传一系列有用的参数：</para>
 
 	<programlisting>CONFIGURE_ARGS+= --with-qt-includes=${QT_PREFIX}/include \
                  --with-qt-libraries=${QT_PREFIX}/lib \
                  --with-extra-libs=${LOCALBASE}/lib \
                  --with-extra-includes=${LOCALBASE}/include
 CONFIGURE_ENV+=  MOC="${MOC}" CPPFLAGS="${CPPFLAGS} ${QTCPPFLAGS}" LIBS="${QTCFGLIBS}" \
                  QTDIR="${QT_PREFIX}" KDEDIR="${KDE_PREFIX}"</programlisting>
 
 	<para>如果将 <varname>USE_QT_VER</varname> 设为 <literal>4</literal>，
 	  则还会进行下列配置：</para>
 
 	<programlisting>CONFIGURE_ENV+= UIC="${UIC}" QMAKE="${QMAKE}" QMAKESPEC="${QMAKESPEC}"
 MAKE_ENV+=      QMAKESPEC="${QMAKESPEC}"</programlisting>
 
       </sect2>
 
       <sect2 xml:id="qt4-components">
 	<title>组件的选择 (仅限 Qt 4.x)</title>
 
 	<para>当把 <varname>USE_QT_VER</varname> 设为 4 时， 就可以通过
 	  <varname>QT_COMPONENTS</varname> 变量来指定对
 	  Qt4 工具和函数库的依赖了。 通过在组件的名称后面添加 <literal>_build</literal> 或 <literal>_run</literal>
 	  这样的后缀， 则可相应地将这依赖关系限于联编或运行时刻。
 	  在没有指定后缀时， 系统默认在联编和运行时刻均依赖该组件。
 	  通常情况下在指明函数库一类的组件时应不使用后缀，
 	  联编工具类组件应使用 <literal>_build</literal> 后缀，
 	  而插件类组件， 则应使用 <literal>_run</literal> 后缀。
 	  下表中列出了一些最常用的组件 (全部可用的组件， 则在
 	  <filename>/usr/ports/Mk/bsd.qt.mk</filename>
 	  中的 <varname>_QT_COMPONENTS_ALL</varname> 列出)：</para>
 
 	<table frame="none">
 	  <title>可用的 Qt4 函数库组件</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>名字</entry>
 		<entry>描述</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>corelib</literal></entry>
 		<entry>核心库 (在 port 只使用 <literal>corelib</literal> 而没有用到其他库时可以省略)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>gui</literal></entry>
 		<entry>图形用户界面库</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>network</literal></entry>
 		<entry>网络函数库</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>opengl</literal></entry>
 		<entry>OpenGL 函数库</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>qt3support</literal></entry>
 		<entry>Qt3 兼容支持函数库</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>qtestlib</literal></entry>
 		<entry>单元测试函数库</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>script</literal></entry>
 		<entry>脚本函数库</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>sql</literal></entry>
 		<entry>SQL 函数库</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>xml</literal></entry>
 		<entry>XML 函数库</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>您可以通过在成功编译之后， 通过在主可执行文件上运行
 	  <command>ldd</command> 来确定所需的库。</para>
 
 	<table frame="none">
 	  <title>可用的 Qt4 工具组件</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>名字</entry>
 		<entry>描述</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>moc</literal></entry>
 		<entry>元对象编译器 (几乎所有的 Qt 应用程序在联编过程中都需要它)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>qmake</literal></entry>
 		<entry>Makefile 生成器 / 联编工具</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>rcc</literal></entry>
 		<entry>资源编译器 (如果应用程序中包含
 		  <filename>*.rc</filename> 或 <filename>*.qrc</filename>
 		  文件， 就需要它)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>uic</literal></entry>
 		<entry>用户界面编译器 (如果应用程序中包含使用 Qt Designer
 		  创建的 <filename>*.ui</filename> 文件时就需要它
 		  - 一般说来 Qt 应用程序都会使用 GUI 的)</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<table frame="none">
 	  <title>可用的 Qt4 插件组件</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>名字</entry>
 		<entry>描述</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>iconengines</literal></entry>
 		<entry>SVG 图标引擎插件 (如果应用程序使用 SVG 图标)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>imageformats</literal></entry>
 		<entry>用于 GIF、 JPEG、 MNG 和
 		  SVG 的 imageformat 插件 (如果应用程序使用图片文件)</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<example xml:id="qt4-components-example">
 	  <title>选择 Qt4 组件</title>
 
 	  <para>在这个例子中， 我们将要移植的应用程序用到了
 	    Qt4 图形用户界面函数库、 Qt4 核心 (core) 函数库、
 	    所有 Qt4 代码生成工具以及 Qt4 的
 	    Makefile 生成器。 由于 gui 函数库会自动附带对核心函数库的依赖，
 	    因此并不需要明确指出需要 corelib 的依赖关系。 Qt4 代码生成工具 moc、
 	    uic 和 rcc 以及 Makefile 生成器
 	    qmake 只在联编过程中才会用到，
 	    因此可以指定 <literal>_build</literal> 后缀：</para>
 
 	  <programlisting>USE_QT_VER=    4
 QT_COMPONENTS= gui moc_build qmake_build rcc_build uic_build</programlisting>
 	</example>
       </sect2>
 
       <sect2 xml:id="qt-additional">
 	<title>其他考虑</title>
 
 	<para>如果应用程序没有提供
 	  <filename>configure</filename> 文件， 而是给了一个 <filename>.pro</filename>
 	  文件， 则应这样：</para>
 
 	<programlisting>HAS_CONFIGURE=	yes
 
 do-configure:
         @cd ${WRKSRC} &amp;&amp; ${SETENV} ${CONFIGURE_ENV} \
                 ${QMAKE} -unix PREFIX=${PREFIX} texmaker.pro</programlisting>
 
 	<para>请注意， 这与系统提供的 <filename>BUILD.sh</filename>
 	  中的 <command>qmake</command> 类似。 传递
 	  <varname>CONFIGURE_ENV</varname> 能够确保 <command>qmake</command>
 	  可以看到 <varname>QMAKESPEC</varname> 变量，
 	  否则它可能无法正常工作。 <command>qmake</command> 会生成标准的
 	  Makefile， 因此无需自行编写
 	  <buildtarget>build</buildtarget> target。</para>
 
 	<para>Qt 应用程序通常会编写为能够跨平台使用， 通常 X11/Unix 并不是开发它的平台，
 	  有时这会导致一些边边角角的问题， 例如：</para>
 
 	<itemizedlist>
 	  <listitem>
 	    <para><emphasis>缺少必要的 includepaths。</emphasis>
 	      许多应用程序会使用托盘图标支持， 但忽略了这些头或库文件需要在 X11
 	      目录中查找。 您可以通过命令行告诉 <command>qmake</command>
 	      将这些头文件和函数库加入到搜索路径中， 例如：</para>
 
 	    <programlisting>${QMAKE} -unix PREFIX=${PREFIX} INCLUDEPATH+=${LOCALBASE}/include \
 	LIBS+=-L${LOCALBASE}/lib sillyapp.pro</programlisting>
 	  </listitem>
 
 	  <listitem>
 	    <para><emphasis>有问题的安装路径。</emphasis>
 	      有时， 类似图标或 .desktop 文件这样的一些数据， 默认情况下没有安装到
 	      XDG-兼容的程序会扫描的路径中。 <package>editors/texmaker</package>
 	      就是一个这样的例子 - 请参考这个 port 的 <filename>files</filename>
 	      目录中的 <filename>patch-texmaker.pro</filename>，
 	      以了解如何在 Qmake 工程文件中修正这个问题。</para>
 	  </listitem>
 	</itemizedlist>
 
       </sect2>
 
     </sect1>
 
     <sect1 xml:id="using-kde">
       <title>使用 KDE</title>
 
       <sect2 xml:id="kde-variables">
 	<title>变量定义 (只用于 KDE 3.x)</title>
 
 	<table frame="none">
 	  <title>用于使用 KDE 3.x 的 port 的变量</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 	      <row>
 		<entry><varname>USE_KDELIBS_VER</varname></entry>
 
 		<entry>表示 port 用到了 KDE 库。
 		  这个变量可以指定希望使用的 KDE 主版本号，
 		  如果设置了这个变量， 则系统也会将
 		  <varname>USE_QT_VER</varname> 设为适当的版本。
 		  该变量目前唯一有效的值是
 		  <literal>3</literal>。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>USE_KDEBASE_VER</varname></entry>
 
 		<entry>表示 port 用到了 KDE 的基本系统。
 		  这个变量可以指定希望使用的 KDE 主版本号，
 		  如果设置了这个变量， 则系统也会将
 		  <varname>USE_QT_VER</varname> 设为适当的版本。
 		  该变量目前唯一有效的值是 <literal>3</literal>。</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
       </sect2>
 
       <sect2 xml:id="kde4-variables">
 	<title>用于 KDE 4 的变量定义</title>
 
 	<para>如果您的应用程序需要使用 KDE 4.x， 则应将 <varname>USE_KDE4</varname>
 	  设为所需组件的列表。 下面列出一些最常用到的组件
 	  (最新的组件列表位于 <filename>/usr/ports/Mk/bsd.kde4.mk</filename>
 	  中的 <varname>_USE_KDE4_ALL</varname>)：</para>
 
 	<table frame="none">
 	  <title>可用的 KDE4 组件</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>名称</entry>
 		<entry>说明</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>akonadi</literal></entry>
 		<entry>个人信息管理 (PIM)存储服务</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>automoc4</literal></entry>
 		<entry>令 port 使用 automoc4 联编工具集</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>kdebase</literal></entry>
 		<entry>基本的 KDE 应用程序 (Konqueror、 Dolphin、 Konsole)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>kdeexp</literal></entry>
 		<entry>试验性的 KDE 库 (包含尚未完全确定不变的 API)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>kdehier</literal></entry>
 		<entry>常用的 KDE 目录层次结构</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>kdelibs</literal></entry>
 		<entry>基本 KDE 库</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>kdeprefix</literal></entry>
 		<entry>如果设置了这个选项， 则 port 将安装到
 		  <literal>&dollar;{KDE4_PREFIX}</literal>
 		  而不是 <literal>&dollar;{LOCALBASE}</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>pimlibs</literal></entry>
 		<entry>PIM 函数库</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>workspace</literal></entry>
 		<entry>用于组成桌面的应用程序和函数库 (Plasma、 KWin)</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>KDE 4.x port 会安装到 <literal>&dollar;{KDE4_PREFIX}</literal>，
 	  目前是 <filename>/usr/local/kde4</filename>，
 	  以避免与 KDE 3.x ports 冲突。 这是通过指定 <literal>kdeprefix</literal>
 	  组件来实现的， 它表示替换默认的 <varname>PREFIX</varname>。 不过，
 	  port 仍会遵循通过 <envar>MAKEFLAGS</envar> 环境变量设置的
 	  <varname>PREFIX</varname> 以及其它 <application>make</application> 参数。</para>
 
 	<para>KDE 4.x ports 有可能和 KDE 3.x ports 冲突， 因此如果启用了
 	  <literal>kdeprefix</literal> 组件， 它们会安装到
 	  <literal>&dollar;{KDE4_PREFIX}</literal>。 目前
 	  <literal>KDE4_PREFIX</literal> 的默认值是
 	  <filename>/usr/local/kde4</filename>。 也可以将 KDE 4.x ports
 	  安装到自定义的 <literal>PREFIX</literal>。 当
 	  <literal>PREFIX</literal> 是通过 <envar>MAKEFLAGS</envar>
 	  环境变量， 或直接在 <application>make</application> 命令行指定时，
 	  它会替换 <literal>kdeprefix</literal> 提供的配置。</para>
 
 	<example xml:id="kde4-components-example">
 	  <title><varname>USE_KDE4</varname>  示例</title>
 
 	  <para>下面是一个简单的 KDE 4 port。 <varname>USE_CMAKE</varname>
 	  指定 port 使用 <application>CMake</application> &mdash;
 	  许多 KDE 4 项目所使用的配置工具。
 	  <varname>USE_KDE4</varname> 则引入 KDE 函数库， 并令 port 在联编阶段使用
 	  <application>automoc4</application>。 需要的 KDE 组件，
 	  以及其他依赖的组件可以从 configure 的日志中获知。
 	  <varname>USE_KDE4</varname> 并不会自动设置 <varname>USE_QT_VER</varname>。
 	  如果 port 需要使用某些 Qt4 组件， 则需要设置 <varname>USE_QT_VER</varname>
 	  并指定所需要的组件。 </para>
 
 	  <programlisting>USE_CMAKE=     yes
 USE_KDE4=      automoc4 kdelibs kdeprefix
 USE_QT_VER=    4
 QT_COMPONENTS= qmake_build moc_build rcc_build uic_build</programlisting>
 	</example>
       </sect2>
 
     </sect1>
 
     <sect1 xml:id="using-java">
       <title>使用 Java</title>
 
       <sect2 xml:id="java-variables">
 	<title>变量定义</title>
 
       <para>如果您的 port 需要 Java&trade; 开发包 (JDK&trade;) 来完成联编、
 	支持运行， 甚至完成解开源代码包这样的工作，
 	就应该定义 <varname>USE_JAVA</varname>。</para>
 
       <para>在 Ports Collection 中有许多不同的 JDK， 它们的版本各不相同，
 	或是来自不同的供应商。 如果您的 port 必须使用其中的某个特定的版本，
 	也可以予以定义。 最新的稳定版本是
 	<package>java/jdk16</package>。</para>
 
       <table frame="none">
 	<title>用到 Java 的 port 可以使用的变量</title>
 
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>变量</entry>
 	      <entry>意义</entry>
 	    </row>
 	  </thead>
 	  <tbody>
 	    <row>
 	      <entry><varname>USE_JAVA</varname></entry>
 	      <entry>只有定义它才能使其它变量生效。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_VERSION</varname></entry>
 	      <entry>用空格分开的适合 port 使用的 Java 版本。
 		可选的 <literal>"+"</literal> 可以用于指定某个范围的版本 (可以用：
 		<literal>1.5[+] 1.6[+] 1.7[+]
 		</literal>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_OS</varname></entry>
 	      <entry>用空格分开的适应 port 的 JDK port 操作系统类型 (可以用： <literal>native
 		linux</literal>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_VENDOR</varname></entry>
 	      <entry>用空格分开的适应 port 的 JDK port 供应商
 		(可以用： <literal>freebsd bsdjava sun
 		openjdk</literal>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_BUILD</varname></entry>
 	      <entry>设置这个变量表示所选的 JDK port 应被列入 port 的联编依赖关系。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_RUN</varname></entry>
 	      <entry>设置这个变量表示所选的 JDK port 应被列入 port 的运行环境依赖关系。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_EXTRACT</varname></entry>
 	      <entry>设置这个变量表示所选的 JDK port 应被列入 port 的解压缩支持依赖关系。</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <para>下面是在设置了 <varname>USE_JAVA</varname> 之后，
 	port 能够从系统中获得的配置：</para>
 
       <table frame="none">
 	<title>向使用了 Java 的 port 提供的变量</title>
 
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>变量</entry>
 	      <entry>值</entry>
 	    </row>
 	  </thead>
 	  <tbody>
 	    <row>
 	      <entry><varname>JAVA_PORT</varname></entry>
 	      <entry>JDK port 的名字 (例如
 		<literal>'java/diablo-jdk16'</literal>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_PORT_VERSION</varname></entry>
 	      <entry>JDK port 的完整版本 (例如
 		<literal>'1.6.0'</literal>)。 如果您只需要版本号的前两位， 则可用
 		<varname>${JAVA_PORT_VERSION:C/^([0-9])\.([0-9])(.*)$/\1.\2/}</varname>。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_PORT_OS</varname></entry>
 	      <entry>所用 JDK port 的操作系统 (例如
 		<literal>'native'</literal>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_PORT_VENDOR</varname></entry>
 	      <entry>所用 JDK port 的供应商 (例如
 		<literal>'freebsd'</literal>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_PORT_OS_DESCRIPTION</varname></entry>
 	      <entry>所用 JDK port 操作系统的描述
 		(例如 <literal>'Native'</literal>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_PORT_VENDOR_DESCRIPTION</varname></entry>
 	      <entry>所用 JDK port 供应商的描述 (例如
 		<literal>'FreeBSD Foundation'</literal>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_HOME</varname></entry>
 	      <entry>JDK 的安装目录 (例如
 		<filename>'/usr/local/diablo-jdk1.6.0'</filename>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVAC</varname></entry>
 	      <entry>所用 Java 编译器的完整路径 (例如
 		<filename>'/usr/local/diablo-jdk1.6.0/bin/javac'</filename>)。
 		</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAR</varname></entry>
 	      <entry>所用 <command>jar</command> 工具的完整路径 (例如
 		<filename>'/usr/local/diablo-jdk1.6.0/bin/jar'</filename> 或
 		<filename>'/usr/local/bin/fastjar'</filename>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>APPLETVIEWER</varname></entry>
 	      <entry>所用 <command>appletviewer</command> 工具的完整路径 (例如
 		<filename>'/usr/local/diablo-jdk1.6.0/bin/appletviewer'</filename>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA</varname></entry>
 	      <entry>所用 <command>java</command> 执行文件的完整路径。
 		您应使用它来执行 Java 程序 (例如
 		<filename>'/usr/local/diablo-jdk1.6.0/bin/java'</filename>)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVADOC</varname></entry>
 	      <entry>所用 <command>javadoc</command> 工具的完整路径。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVAH</varname></entry>
 	      <entry>所用 <command>javah</command> 程序的完整路径。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVAP</varname></entry>
 	      <entry>所用 <command>javap</command> 程序的完整路径。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_KEYTOOL</varname></entry>
 	      <entry>所用 <command>keytool</command> 工具的完整路径。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_N2A</varname></entry>
 	      <entry>所用 <command>native2ascii</command> 工具的完整路径。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_POLICYTOOL</varname></entry>
 	      <entry>所用 <command>policytool</command> 程序的完整路径。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_SERIALVER</varname></entry>
 	      <entry>所用 <command>serialver</command> 程序的完整路径。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>RMIC</varname></entry>
 	      <entry>所用 RMI 桩/架 生成器，
 		<command>rmic</command> 的完整路径。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>RMIREGISTRY</varname></entry>
 	      <entry>所用 RMI 注册表程序，
 		<command>rmiregistry</command> 的完整路径。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>RMID</varname></entry>
 	      <entry>所用 RMI 服务程序 <command>rmid</command> 的完整路径。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVA_CLASSES</varname></entry>
 	      <entry>所用 JDK 类文件目录的完整路径。
 		<filename>${JAVA_HOME}/jre/lib/rt.jar</filename>。</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <para>您可以使用 <literal>java-debug</literal> make target
 	以获取用于调试 port 的信息。 大多数前述变量的值皆会予以呈现。</para>
 
       <para>此外， 还会定义下述常量， 以确保所有的
 	Java port 均以一致之方式安装：</para>
 
       <table frame="none">
 	<title>为使用 Java 的 port 定义的常量</title>
 
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>常量</entry>
 	      <entry>值</entry>
 	    </row>
 	  </thead>
 	  <tbody>
 	    <row>
 	      <entry><varname>JAVASHAREDIR</varname></entry>
 	      <entry>所有 Java 相关资料的安装根目录。
 		默认值： <filename>${PREFIX}/share/java</filename>.
 	      </entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVAJARDIR</varname></entry>
 	      <entry>用以安装 JAR 文件的目录。 默认值：
 		<filename>${JAVASHAREDIR}/classes</filename>。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>JAVALIBDIR</varname></entry>
 	      <entry>其它 port 安装的 JAR 文件所在的目录。 默认值：
 		<filename>${LOCALBASE}/share/java/classes</filename>。</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <para>相关的项也会定义在
 	<varname>PLIST_SUB</varname> (在
 	<xref linkend="plist-sub"/> 中进行介绍) 和
 	<varname>SUB_LIST</varname> 中。</para>
 
       </sect2>
 
       <sect2 xml:id="java-building-with-ant">
 	<title>采用 Ant 进行联编</title>
 
 	<para>如果 port 采用 Apache Ant 进行联编，
 	  则需要定义 <varname>USE_ANT</varname>。 如是， 则 Ant
 	  将作为 子-make 命令来使用。 如果 port 未定义 <literal>do-build</literal>
 	  target， 则将默认依 <varname>MAKE_ENV</varname>、
 	  <varname>MAKE_ARGS</varname> 和 <varname>ALL_TARGET</varname>。
 	  的设置执行 Ant。 这类似于 <xref linkend="building"/> 中介绍的关于
 	  <varname>USE_GMAKE</varname> 的机制。</para>
 
       </sect2>
 
       <sect2 xml:id="java-best-practices">
 	<title>最佳实践</title>
 
 	<para>如果您正移植某个 Java 库， 您的 port 应把
 	  JAR 文件安装到 <filename>${JAVAJARDIR}</filename>， 而其它文件则应放在
 	  <filename>${JAVASHAREDIR}/${PORTNAME}</filename> 下
 	  (除了文档， 参见下文)。 要减少打包文件的尺寸，
 	  您可以直接在 <filename>Makefile</filename> 中引用这些 JAR 文件，
 	  具体做法是使用下面的语句 (此处的 <filename>myport.jar</filename>
 	  是作为 port 一部分安装的 JAR 文件的名字)：</para>
 
 	<programlisting>PLIST_FILES+= %%JAVAJARDIR%%/myport.jar</programlisting>
 
 	<para>移植 Java 应用程序时， port 通常会希望将所有文件安装到同一目录
 	  (包括其依赖的 JAR)。 这时强烈建议使用
 	  <filename>${JAVASHAREDIR}/${PORTNAME}</filename>。
 	  移植软件的开发人员， 可以自行决定是否将所依赖的其它 JAR 安装到此目录，
 	  或直接使用已经装好的那些
 	  (来自 <filename>${JAVAJARDIR}</filename>)。</para>
 
 	<para>无论您正制作哪一类的 port (库或者应用程序)，
 	  附加的文档都应安装到和其它 port
 	  <link linkend="install-documentation">同样的位置</link>。
 	  已经知道， JavaDoc 会根据 JDK 版本的不同而产生不同的文件。
 	  对于那些不打算强制使用某一特定版本 JDK 的 port 而言，
 	  这无疑提高了制作装箱单
 	  (<filename>pkg-plist</filename>) 的难度。 这是为什么强烈建议使用
 	  <varname>PORTDOCS</varname> 宏的原因。 更进一步， 即使您能够预测
 	  <command>javadoc</command> 将要生成的文件， 所需的
 	  <filename>pkg-plist</filename> 的尺寸， 也是鼓吹使用
 	  <varname>PORTDOCS</varname> 的一大理由。</para>
 
 	<para><varname>DATADIR</varname> 的默认值是
 	  <filename>${PREFIX}/share/${PORTNAME}</filename>。
 	  对 Java port 而言将 <varname>DATADIR</varname> 改为
 	  <filename>${JAVASHAREDIR}/${PORTNAME}</filename> 是一个好主意。
 	  当然， <varname>DATADIR</varname> 会自动加到
 	  <varname>PLIST_SUB</varname> 中 (在 <xref linkend="plist-sub"/> 有所介绍) 因此您可以在
 	  <filename>pkg-plist</filename> 中直接使用
 	  <literal>%%DATADIR%%</literal>。</para>
 
 	<para>撰写本文时， 对是应该从源代码联编， 还是直接安装预编译的
 	  Java ports 安装包并没有明确的规定。 尽管如此， <link xlink:href="http://www.freebsd.org/java/">&os; Java Project</link>
 	  的开发人员仍鼓励移植软件的开发者在不麻烦的情况下尽可能从源代码完成联编。</para>
 
 	<para>本节中所介绍的全部特性， 均是在 <filename>bsd.java.mk</filename>
 	  中实现的。 如果您感觉自己的 port 需要更为复杂的 Java 支持，
 	  请首先参阅 <link xlink:href="http://www.freebsd.org/cgi/cvsweb.cgi/ports/Mk/bsd.java.mk">
 	  bsd.java.mk CVS 日志</link>， 因为通常撰文介绍最新特性需要一些时间。
 	  此外， 如果您认为所缺少的支持对许多其它 Java port 亦属有益，
 	  请在 &a.java; 对其进行讨论。</para>
 
 	<para>在 PR 中的 <literal>java</literal> 类别，
 	  主要是用于 &os; Java project 移植 JDK 本身之用。
 	  因而， 提交您的 Java port 时， 应归入
 	  <literal>ports</literal> 类别， 除非您正尝试解决的问题是 JDK
 	  实现本身或 <filename>bsd.java.mk</filename> 的。</para>
 
 	<para>类似地， 您应参考 <xref linkend="makefile-categories"/> 中所详述的关于
 	  <varname>CATEGORIES</varname> 在 Java port 中的使用规则。</para>
 
       </sect2>
 
     </sect1>
 
     <sect1 xml:id="using-php">
       <title>Web 应用， Apache 和 PHP</title>
 
       <sect2 xml:id="using-apache">
 	<title>Apache</title>
 
 	<table frame="none">
 	  <title>用到 Apache 的 port 可以使用的变量</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 
 	      <row>
 		<entry><varname>USE_APACHE</varname></entry>
 
 		<entry>此 port 需要 Apache。 可用的值：
 		  <literal>yes</literal> (任意可用版本)、
 		  <literal>1.3</literal>、 <literal>2.0</literal>、
 		  <literal>2.2</literal>、 <literal>2.0+</literal>、
 		  等等。 默认依赖的版本是
 		  <literal>1.3</literal>。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WITH_APACHE2</varname></entry>
 
 		<entry>此 port 需要 Apache 2.0。 如果没有这个变量，
 		  则 port 将依赖 Apache 1.3。 这一变量目前已经过时，
 		  因而不应继续使用。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>APXS</varname></entry>
 
 		<entry>到 <command>apxs</command> 可执行文件的完整路径。
 		  您可以在 port 中替代该值。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>HTTPD</varname></entry>
 
 		<entry>到 <command>httpd</command> 可执行文件的完整路径。
 		  您可以在 port 中替代该值。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>APACHE_VERSION</varname></entry>
 
 		<entry>目前系统中安装的 Apache 版本 (只读变量)。
 		  这一变量只有在引用了 <filename>bsd.port.pre.mk</filename>
 		  之后才能使用， 其可能的值为：
 		  <literal>13</literal>、 <literal>20</literal>、
 		  <literal>22</literal>。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>APACHEMODDIR</varname></entry>
 
 		<entry>Apache 模块所在的文件夹。 在 pkg-plist 中，
 		  这一变量会自动展开。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>APACHEINCLUDEDIR</varname></entry>
 
 		<entry>Apache 头文件所在的文件夹。 在 pkg-plist 中，
 		  这一变量会自动展开。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>APACHEETCDIR</varname></entry>
 
 		<entry>Apache 配置文件所在的文件夹。 在 pkg-plist 中，
 		  这一变量会自动展开。</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<table frame="none">
 	  <title>在移植 Apache 模块时比较有用的变量</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 
 	      <row>
 		<entry><varname>MODULENAME</varname></entry>
 
 		<entry>模块的名称。 默认值为
 		  <varname>PORTNAME</varname>。 例如：
 		  <literal>mod_hello</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>SHORTMODNAME</varname></entry>
 
 		<entry>模块的简略名字。 默认情况下会自动根据
 		  <varname>MODULENAME</varname> 计算， 但您也可以自行设置值来替代它。
 		  例如： <literal>hello</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>AP_FAST_BUILD</varname></entry>
 
 		<entry>使用 <command>apxs</command> 来编译和安装模块。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>AP_GENPLIST</varname></entry>
 
 		<entry>同时自动创建
 		  <filename>pkg-plist</filename>。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>AP_INC</varname></entry>
 
 		<entry>在编译过程中， 将指定的目录加入到搜索头文件的目录中。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>AP_LIB</varname></entry>
 
 		<entry>在编译过程中， 将指定的目录加入到搜索函数库的目录中。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>AP_EXTRAS</varname></entry>
 
 		<entry>传递给
 		  <command>apxs</command> 的额外参数。</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
       </sect2>
 
       <sect2 xml:id="web-apps">
 	<title>Web 应用</title>
 
 	<para>Web 应用程序应安装到
 	  <filename>PREFIX/www/应用程序的名字</filename>。
 	  为方便起见， 这个路径在
 	  <filename>Makefile</filename> 和 <filename>pkg-plist</filename>
 	  均以 <varname>WWWDIR</varname> 变量的形式提供。 在
 	  <filename>Makefile</filename> 中可以使用
 	  <varname>WWWDIR_REL</varname> 来表示包含了
 	  <varname>PREFIX</varname> 的该变量值。</para>
 
 	<para>web 服务器进程所用的用户和用户组， 分别以
 	  <varname>WWWOWN</varname> 和 <varname>WWWGRP</varname> 变量的形式提供，
 	  如果您需要修改某些文件的属主的话。 这两个变量的默认值均为 <literal>www</literal>。
 	  如果您的 port 希望使用其他值， 请使用 <literal>WWWOWN?= myuser</literal> 这种写法，
 	  以便让用户能够更容易地修改它。</para>
 
 	<para>除非您的 port 必需使用 Apache， 否则不要将其写入依赖关系。
 	  请尊重运行您的应用程序的用户选择 Apache 以外的其他 web 服务器的需求。</para>
 
       </sect2>
 
       <sect2 xml:id="php-variables">
 	<title>PHP</title>
 
 	<table frame="none">
 	  <title>用到 PHP 的 port 中可以使用的变量</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 	      <row>
 		<entry><varname>USE_PHP</varname></entry>
 
 		<entry>此 port 需要 PHP。 取值为 <literal>yes</literal>
 		  将把 PHP 加入依赖关系。 此外， 还可以在此指定将所需要的 PHP
 		  扩展模块。 例如： <literal>pcre xml
 		  gettext</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>DEFAULT_PHP_VER</varname></entry>
 
 		<entry>选择在没有安装 PHP 时自动安装的 PHP 主版本。 默认是
 		  <literal>4</literal>。 可选 <literal>4</literal>、
 		  <literal>5</literal> 之一。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>IGNORE_WITH_PHP</varname></entry>
 
 		<entry>此 port 无法与给定版本的 PHP 一同工作。
 		  可选值为 <literal>4</literal>、
 		  <literal>5</literal> 之一。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>USE_PHPIZE</varname></entry>
 
 		<entry>此 port 将作为 PHP 扩展模块进行联编。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>USE_PHPEXT</varname></entry>
 
 		<entry>此 port 将作为 PHP 扩展，
 		  且需要作为扩展模块注册。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>USE_PHP_BUILD</varname></entry>
 
 		<entry>联编依赖于 PHP。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WANT_PHP_CLI</varname></entry>
 
 		<entry>希望使用 CLI (命令行) 版本的 PHP。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WANT_PHP_CGI</varname></entry>
 
 		<entry>希望使用 CGI 版本的 PHP。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WANT_PHP_MOD</varname></entry>
 
 		<entry>希望使用 Apache 模块版本的 PHP。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WANT_PHP_SCR</varname></entry>
 
 		<entry>希望使用 CLI 或 CGI 版本的 PHP。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WANT_PHP_WEB</varname></entry>
 
 		<entry>希望使用 Apache 模块或 CGI 版本的 PHP。</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
       </sect2>
 
       <sect2>
 	<title>PEAR 模块</title>
 
 	<para>移植 PEAR 模块的过程非常简单。</para>
 
 	<para>使用 <varname>FILES</varname>、
 	  <varname>TESTS</varname>、 <varname>DATA</varname>、
 	  <varname>SQLS</varname>、 <varname>SCRIPTFILES</varname>、
 	  <varname>DOCS</varname> 以及 <varname>EXAMPLES</varname>
 	  这些变量来指明您希望安装的文件。
 	  所有这里列出的文件都会自动安装到合适的位置， 并加入
 	  <filename>pkg-plist</filename>。</para>
 
 	<para>在 <filename>Makefile</filename> 文件的最后一行引入
 	  <filename>&dollar;{PORTSDIR}/devel/pear/bsd.pear.mk</filename>。</para>
 
 	<example xml:id="pear-makefile">
 	  <title>用于 PEAR 类的 Makefile 例子</title>
 	  <programlisting>PORTNAME=       Date
 PORTVERSION=    1.4.3
 CATEGORIES=     devel www pear
 
 MAINTAINER=     example@domain.com
 COMMENT=        PEAR Date and Time Zone Classes
 
 BUILD_DEPENDS=  ${PEARDIR}/PEAR.php:${PORTSDIR}/devel/pear-PEAR
 RUN_DEPENDS=    ${BUILD_DEPENDS}
 
 FILES=          Date.php Date/Calc.php Date/Human.php Date/Span.php     \
                 Date/TimeZone.php
 TESTS=          test_calc.php test_date_methods_span.php testunit.php   \
                 testunit_date.php testunit_date_span.php wknotest.txt   \
                 bug674.php bug727_1.php bug727_2.php bug727_3.php       \
                 bug727_4.php bug967.php weeksinmonth_4_monday.txt       \
                 weeksinmonth_4_sunday.txt weeksinmonth_rdm_monday.txt   \
                 weeksinmonth_rdm_sunday.txt
 DOCS=           TODO
 _DOCSDIR=       .
 
 .include &lt;bsd.port.pre.mk&gt;
 .include "&dollar;{PORTSDIR}/devel/pear/bsd.pear.mk"
 .include &lt;bsd.port.post.mk&gt;</programlisting>
 
 	</example>
 
       </sect2>
 
     </sect1>
 
     <sect1 xml:id="using-python">
       <title>使用 Python</title>
 
       <para>Ports 套件支持同时并行安装多个不同的
 	Python 版本。 Ports 应确保能够根据用户配置的
 	<varname>PYTHON_VERSION</varname> 变量使用正确的
 	<command>python</command> 解释器。 一般说来，
 	这是通过将脚本中的 <command>python</command> 路径名替换为
 	<varname>PYTHON_CMD</varname> 变量的值来实现的。</para>
 
       <para>在 <varname>PYTHON_SITELIBDIR</varname>
 	下安装文件的 ports 应在包名上使用 <literal>pyXY-</literal> 前缀，
 	以便明示它们将会配合哪个 Python 版本使用。</para>
 
       <programlisting>PKGNAMEPREFIX= ${PYTHON_PKGNAMEPREFIX}</programlisting>
 
       <table frame="none">
 	<title>对用到 Python 的 port 最有用的一些变量</title>
 
 	<tgroup cols="2">
 	  <tbody>
 	    <row>
 	      <entry><varname>USE_PYTHON</varname></entry>
 
 	      <entry>此 port 需要 Python。 可以用
 		<literal>2.3+</literal> 这样的形式来指定所希望的版本。
 		除此之外， 也可以用横线来分隔两个版本号，
 		以表示某个范围的版本， 例如： <literal>2.1-2.3</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_PYDISTUTILS</varname></entry>
 
 	      <entry>使用 Python distutils 来完成配置、 编译和安装。 对包含
 		<filename>setup.py</filename> 的 port 而言这是必需的。
 		它会自动覆盖默认的
 		<buildtarget>do-build</buildtarget> 以及
 		<buildtarget>do-install</buildtarget> 这两个 target。 如未定义
 		<varname>GNU_CONFIGURE</varname>，
 		它还会改变 <buildtarget>do-configure</buildtarget>。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PYTHON_PKGNAMEPREFIX</varname></entry>
 
 	      <entry>作为 <varname>PKGNAMEPREFIX</varname> 来区分不同 Python
 		版本的 package。 例如： <literal>py24-</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PYTHON_SITELIBDIR</varname></entry>
 
 	      <entry>全站 package 所在的目录， 它包括了 Python
 		的安装目录 (通常是 <varname>LOCALBASE</varname>)。
 		在安装 Python 模块时， <varname>PYTHON_SITELIBDIR</varname>
 		变量会非常有用。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PYTHONPREFIX_SITELIBDIR</varname></entry>
 
 	      <entry>去掉了 PREFIX 部分的 PYTHON_SITELIBDIR。 应尽可能在
 		<filename>pkg-plist</filename> 中使用
 		<literal>%%PYTHON_SITELIBDIR%%</literal>。
 		<literal>%%PYTHON_SITELIBDIR%%</literal> 的默认值是
 		<literal>lib/python%%PYTHON_VERSION%%/site-packages</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PYTHON_CMD</varname></entry>
 
 	      <entry>Python 解释器的命令行， 包括版本号。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PYNUMERIC</varname></entry>
 
 	      <entry>将数值处理扩展模块加入依赖关系。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PYNUMPY</varname></entry>
 	      <entry>对新增的数值计算扩展, numpy的依赖。
 	      (PYNUMERIC 目前已被作者淘汰)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>PYXML</varname></entry>
 
 	      <entry>将 XML 扩展模块加入依赖关系。 (对于
 	      Python 2.0 和更高版本不再需要， 因为它已经成为了标准组件)。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_TWISTED</varname></entry>
 
 	      <entry>将 twistedCore 加入依赖关系。
 		也可以用这个变量指定所需的组件，
 		例如： <literal>web lore pair
 		flow</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_ZOPE</varname></entry>
 
 	      <entry>加入对 Zope， 一种 web 应用平台的依赖。
 		这会把 Python 依赖改为 Python 2.3。 此外
 		<varname>ZOPEBASEDIR</varname> 也会自动设为
 		Zope 安装目录的位置。</entry>
 	    </row>
 
 	  </tbody>
 	</tgroup>
       </table>
 
       <para>完整的可用变量列表， 可以在
 	<filename>/usr/ports/Mk/bsd.python.mk</filename>
 	中找到。</para>
 
     </sect1>
 
     <sect1 xml:id="using-tcl">
       <title>使用 <application>Tcl/Tk</application></title>
 
       <para>Ports 套件支持同时安装多个 <application>Tcl/Tk</application> 版本。 Ports
 	应至少支持默认的
 	<application>Tcl/Tk</application> 版本， 以及通过
 	<varname>USE_TCL</varname> 和 <varname>USE_TK</varname>
 	变量指定的更高版本。 希望使用的
 	<command>tcl</command> 版本， 则可以通过 <varname>WITH_TCL_VER</varname>
 	变量来使用。</para>
 
       <table frame="none">
 	<title>用到
 	  <application>Tcl/Tk</application> 的 port 可以使用的变量</title>
 
 	<tgroup cols="2">
 	  <tbody>
 	    <row>
 	      <entry><varname>USE_TCL</varname></entry>
 
 	      <entry>表示 port 依赖于
 		<application>Tcl</application> 函数库 (不是 shell)。
 		可以指定需要的最低版本， 例如 84+。 不支持的版本，
 		可以在 <varname>INVALID_TCL_VER</varname>
 		变量中逐个指定。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_TCL_BUILD</varname></entry>
 
 	      <entry>表示 port 在联编过程中需要使用 <application>Tcl</application>。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_TCL_WRAPPER</varname></entry>
 
 	      <entry>需要使用
 		<application>Tcl</application> shell 而不需要特定版本的
 		<literal>tclsh</literal> 的 port 可以使用这个新变量。
 		系统中会安装 <literal>tclsh</literal> wrapper，
 		用户则可以指定所希望的 <command>tcl</command> shell。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>WITH_TCL_VER</varname></entry>
 
 	      <entry>由用户定义的、 希望使用的
 		<application>Tcl</application> 版本。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname><replaceable>UNIQUENAME</replaceable>_WITH_TCL_VER</varname></entry>
 
 	      <entry>和 <varname>WITH_TCL_VER</varname> 类似，
 		但是针对 port 指定的。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_TCL_THREADS</varname></entry>
 
 	      <entry>需要包含线程支持的
 		<application>Tcl/Tk</application>。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_TK</varname></entry>
 
 	      <entry>表示 port 依赖于
 		<application>Tk</application> 库 (不是 wish
 		shell)。 它同时会隐含将 <varname>USE_TCL</varname> 设置为相同的值。
 		更多的描述， 请参考
 		<varname>USE_TCL</varname> 变量。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_TK_BUILD</varname></entry>
 
 	      <entry>与 <varname>USE_TCL_BUILD</varname>
 		变量表达类似的含义。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_TK_WRAPPER</varname></entry>
 
 	      <entry>与 <varname>USE_TCL_WRAPPER</varname>
 		变量表达类似的含义。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>WITH_TK_VER</varname></entry>
 
 	      <entry>表达与 <varname>WITH_TCL_VER</varname>
 		变量类似的含义， 它同时会隐含将 <varname>WITH_TCL_VER</varname>
 		设置为相同的值。</entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </table>
 
       <para>可用的变量的完整列表， 可以在
 	<filename>/usr/ports/Mk/bsd.tcl.mk</filename> 中找到。</para>
     </sect1>
 
     <sect1 xml:id="using-emacs">
       <title>使用 Emacs</title>
 
       <para>本节尚有待撰写。</para>
     </sect1>
 
     <sect1 xml:id="using-ruby">
       <title>使用 Ruby</title>
 
       <table frame="none">
 	<title>使用 Ruby 的 port 可以使用的变量</title>
 
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>变量</entry>
 	      <entry>说明</entry>
 	    </row>
 	  </thead>
 	  <tbody>
 	    <row>
 	      <entry><varname>USE_RUBY</varname></entry>
 
 	      <entry>此 port 需要 Ruby。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_RUBY_EXTCONF</varname></entry>
 
 	      <entry>此 port 使用 <filename>extconf.rb</filename>
 		来完成配置。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>USE_RUBY_SETUP</varname></entry>
 
 	      <entry>此 port 使用 <filename>setup.rb</filename>
 		来完成配置。</entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>RUBY_SETUP</varname></entry>
 
 	      <entry>将此变量名设置为所用的
 		<filename>setup.rb</filename> 的文件名。 通常会是
 		<filename>install.rb</filename>。</entry>
 	    </row>
 
 	  </tbody>
 	</tgroup>
       </table>
 
       <para>下表展示了 ports 系统提供给 port 作者的一些变量。
 	您应使用这些变量， 以便把文件装到合适的位置。 请尽可能多地在
 	<filename>pkg-plist</filename> 中使用它们。 这些变量不应在 port
 	中重新定义。</para>
 
       <table frame="none">
 	<title>使用 Ruby 的 port 中的一些可用的只读变量</title>
 
 	<tgroup cols="3">
 	  <thead>
 	    <row>
 	      <entry>变量</entry>
 	      <entry>说明</entry>
 	      <entry>示范值</entry>
 	    </row>
 	  </thead>
 	  <tbody>
 
 	    <row>
 	      <entry><varname>RUBY_PKGNAMEPREFIX</varname></entry>
 
 	      <entry>作为 <varname>PKGNAMEPREFIX</varname> 以区分用于不同
 		Ruby 版本的 package。</entry>
 
 	      <entry><literal>ruby18-</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>RUBY_VERSION</varname></entry>
 
 	      <entry><literal>x.y.z</literal> 形式的完整 ruby 版本。</entry>
 
 	      <entry><literal>1.8.2</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>RUBY_SITELIBDIR</varname></entry>
 
 	      <entry>平台无关库的安装路径。</entry>
 
 	      <entry><literal>/usr/local/lib/ruby/site_ruby/1.8</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>RUBY_SITEARCHLIBDIR</varname></entry>
 
 	      <entry>平台相关的库的安装路径。</entry>
 
 	      <entry><literal>/usr/local/lib/ruby/site_ruby/1.8/amd64-freebsd6</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>RUBY_MODDOCDIR</varname></entry>
 
 	      <entry>模块文档的安装路径。</entry>
 
 	      <entry><literal>/usr/local/share/doc/ruby18/patsy</literal></entry>
 	    </row>
 
 	    <row>
 	      <entry><varname>RUBY_MODEXAMPLESDIR</varname></entry>
 
 	      <entry>模块用例的安装路径。</entry>
 
 	      <entry><literal>/usr/local/share/examples/ruby18/patsy</literal></entry>
 	    </row>
 
 	  </tbody>
 	</tgroup>
       </table>
 
       <para>可用变量的完整列表， 可以在
 	<filename>/usr/ports/Mk/bsd.ruby.mk</filename> 中找到。</para>
 
     </sect1>
 
     <sect1 xml:id="using-sdl">
       <title>使用 SDL</title>
 
       <para>变量 <varname>USE_SDL</varname> 可以用于自动配置 port
 	的依赖关系， 以适应使用类似
 	<package>devel/sdl12</package> 和
 	<package>x11-toolkits/sdl_gui</package>
 	这些依赖 SDL 的库的情形。</para>
 
       <para>目前系统能够识别下列 SDL 库：</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>sdl: <package>devel/sdl12</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>gfx: <package>graphics/sdl_gfx</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>gui: <package>x11-toolkits/sdl_gui</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>image: <package>graphics/sdl_image</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>ldbad: <package>devel/sdl_ldbad</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>mixer: <package>audio/sdl_mixer</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>mm: <package>devel/sdlmm</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>net: <package>net/sdl_net</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>sound: <package>audio/sdl_sound</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>ttf: <package>graphics/sdl_ttf</package></para>
 	</listitem>
       </itemizedlist>
 
       <para>因此， 如果 port 需要依赖
 	<package>net/sdl_net</package> 和
 	<package>audio/sdl_mixer</package>，
 	则对应的写法将是：</para>
 
       <programlisting>USE_SDL=        net mixer</programlisting>
 
       <para>同时， <package>net/sdl_net</package> 和
 	<package>audio/sdl_mixer</package> 所依赖的
 	<package>devel/sdl12</package> 也会被自动地加入。</para>
 
       <para>加入您使用 <varname>USE_SDL</varname>， 它将自动地：</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>将对于 <application>sdl12-config</application> 的依赖关系加入到
 	    <varname>BUILD_DEPENDS</varname></para>
 	</listitem>
 
 	<listitem>
 	  <para>将变量 <varname>SDL_CONFIG</varname> 加入到
 	    <varname>CONFIGURE_ENV</varname></para>
 	</listitem>
 
 	<listitem>
 	  <para>将对所选的库的依赖， 加入到
 	    <varname>LIB_DEPENDS</varname></para>
 	</listitem>
       </itemizedlist>
 
       <para>要检查某个特定的 SDL 库是否可用，
 	可以通过 <varname>WANT_SDL</varname> 变量来达到目的：</para>
 
       <programlisting>WANT_SDL=yes
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if ${HAVE_SDL:Mmixer}!=""
 USE_SDL+=   mixer
 .endif
 
 .include &lt;bsd.port.post.mk&gt;</programlisting>
 
     </sect1>
 
     <sect1 xml:id="using-wx">
       <title>使用 <application>wxWidgets</application></title>
 
       <para>这一节介绍了在 ports tree 中的
 	<application>wxWidgets</application> 库的现状，
 	以及它与 ports 系统的集成。</para>
 
       <sect2 xml:id="wx-introduction">
 	<title>介绍</title>
 
 	<para>许多不同版本的
 	  <application>wxWidgets</application> 库之间是存在相互冲突的 (它们会安装同名的文件)
 	  在 ports 系统中， 这一问题是通过将不同的版本以包含版本号后缀的名字安装来解决的。</para>
 
 	<para>这样做的一个最明显的缺点是， 应用程序必须进行修改， 才能找到所希望的版本。
 	  幸运的是， 多数应用程序会调用 <command>wx-config</command> 脚本来确定需要的编译器和连接器选项。
 	  这个脚本会随可用的版本不同而有不同的名字。 主要的应用程序都会尊重环境变量的配置，
 	  或提供一个 configure 参数， 用以指定调用哪个 <command>wx-config</command>。
 	  如果不是这样的话， 就需要对应用程序打补丁了。</para>
       </sect2>
 
       <sect2 xml:id="wx-version">
 	<title>版本的选择</title>
 
 	<para>为了让您的 port 使用指定版本的
 	  <application>wxWidgets</application>， 可以定义两个变量 (如果只定义了一个，
 	  则另一个会取默认值)：</para>
 
 	<table xml:id="wx-ver-sel-table" frame="none">
 	  <title>用于选择 <application>wxWidgets</application>
 	    版本的变量</title>
 
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>变量</entry>
 
 		<entry>说明</entry>
 
 		<entry>默认值</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><varname>USE_WX</varname></entry>
 
 		<entry>列出这个 port 能使用的版本</entry>
 
 		<entry>全部版本</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>USE_WX_NOT</varname></entry>
 
 		<entry>列出这个 port 不能使用的版本</entry>
 
 		<entry>无</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>下面是可用的
 	  <application>wxWidgets</application> 版本， 以及对应的
 	  ports：</para>
 
 	<table frame="none">
 	  <title>可用的 <application>wxWidgets</application>
 	    versions</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>版本</entry>
 
 		<entry>Port</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>2.4</literal></entry>
 
 		<entry><package>x11-toolkits/wxgtk24</package></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>2.6</literal></entry>
 
 		<entry><package>x11-toolkits/wxgtk26</package></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>2.8</literal></entry>
 
 		<entry><package>x11-toolkits/wxgtk28</package></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<note>
 	  <para>从 <literal>2.5</literal> 版开始， 也提供了对应的
 	    Unicode 版本， 这种版本可以通过 slave port 安装，
 	    与普通版本相比， 它会多一个 <literal>-unicode</literal> 后缀，
 	    不过这可以通过使用变量来处理 (请参见 <xref linkend="wx-unicode"/>)。</para>
 	</note>
 
 	<para>在 <xref linkend="wx-ver-sel-table"/> 中的变量，
 	  可以设为下列值或由空格分隔的组合：</para>
 
 	<table frame="none">
 	  <title><application>wxWidgets</application> 版本</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>说明</entry>
 
 		<entry>例子</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry>单个版本</entry>
 
 		<entry><literal>2.4</literal></entry>
 	      </row>
 
 	      <row>
 		<entry>某版本以上版本</entry>
 
 		<entry><literal>2.4+</literal></entry>
 	      </row>
 
 	      <row>
 		<entry>某版本以下版本</entry>
 
 		<entry><literal>2.6-</literal></entry>
 	      </row>
 
 	      <row>
 		<entry>某段版本 (版本号较小的必须在前)</entry>
 
 		<entry><literal>2.4-2.6</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>除此之外， 还有一些用以从可用的本那本中选择所希望的版本的变量。
 	  这种变量也可以设为一组版本， 而靠前的版本的优先级更高。</para>
 
 	<table frame="none">
 	  <title>用于选择希望的版本的
 	    <application>wxWidgets</application> versions</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>变量名</entry>
 
 		<entry>用于</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><varname>WANT_WX_VER</varname></entry>
 
 		<entry>port</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WITH_WX_VER</varname></entry>
 
 		<entry>用户</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
       </sect2>
 
       <sect2 xml:id="wx-components">
 	<title>选择组件</title>
 
 	<para>也有一些其他应用， 尽管它们本身并不是
 	  <application>wxWidgets</application> 库， 但却与之相关。
 	  这些应用程序可以在
 	  <varname>WX_COMPS</varname> 变量中使用， 以下是可用的组件：</para>
 
 	<table frame="none">
 	  <title>可用的 <application>wxWidgets</application>
 	    组件</title>
 
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>名称</entry>
 
 		<entry>说明</entry>
 
 		<entry>版本限制</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>wx</literal></entry>
 
 		<entry>主库</entry>
 
 		<entry>无</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>contrib</literal></entry>
 
 		<entry>第三方库</entry>
 
 		<entry><literal>无</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>python</literal></entry>
 
 		<entry><application>wxPython</application>
 		  (<application>Python</application> 绑定)</entry>
 
 		<entry><literal>2.4-2.6</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>mozilla</literal></entry>
 
 		<entry><application>wxMozilla</application></entry>
 
 		<entry><literal>2.4</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>svg</literal></entry>
 
 		<entry><application>wxSVG</application></entry>
 
 		<entry><literal>2.6</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>您可以为每个依赖的组件， 通过冒号分隔的后缀指定其类型。
 	  如果没有指定， 则会使用默认的依赖类型 (参见 <xref linkend="wx-def-dep-types"/>)。
 	  下面是可用的类型：</para>
 
 	<table frame="none">
 	  <title>可用的 <application>wxWidgets</application> 依赖类型</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>名称</entry>
 
 		<entry>说明</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>build</literal></entry>
 
 		<entry>联编时需要该组件， 相当于
 		  <varname>BUILD_DEPENDS</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>run</literal></entry>
 
 		<entry>运行时需要该组件， 相当于
 		  <varname>RUN_DEPENDS</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>lib</literal></entry>
 
 		<entry>联编和运行时均需要该组件，
 		  相当于 <varname>LIB_DEPENDS</varname></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>组件的默认依赖关系类型， 如下表所示：</para>
 
 	<table xml:id="wx-def-dep-types" frame="none">
 	  <title>默认的 <application>wxWidgets</application> 依赖关系类型</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>组件</entry>
 
 		<entry>依赖关系类型</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>wx</literal></entry>
 
 		<entry><literal>lib</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>contrib</literal></entry>
 
 		<entry><literal>lib</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>python</literal></entry>
 
 		<entry><literal>run</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>mozilla</literal></entry>
 
 		<entry><literal>lib</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>svg</literal></entry>
 
 		<entry><literal>lib</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<example xml:id="wx-components-example">
 	  <title>选择 <application>wxWidgets</application>
 	    组件</title>
 
 	  <para>下面的片段展示了使用
 	    <application>wxWidgets</application> 版本
 	    <literal>2.4</literal> 及第三方库的方法。</para>
 
 	  <programlisting>USE_WX=       2.4
 WX_COMPS=     wx contrib</programlisting>
 	</example>
       </sect2>
       <sect2 xml:id="wx-unicode">
 	<title>Unicode</title>
 
 	<para><application>wxWidgets</application> 库从其 <literal>2.5</literal>
 	  版开始支持 Unicode 了。 在 ports 系统中， 这两种版本均有提供，
 	  并可以通过下列变量来选择：</para>
 
 	<table xml:id="wx-unicode-var-table" frame="none">
 	  <title>用以在 Unicode 版本的
 	    <application>wxWidgets</application>
 	    的变量</title>
 
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>变量</entry>
 
 		<entry>说明</entry>
 
 		<entry>作用</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><varname>WX_UNICODE</varname></entry>
 
 		<entry>该 port <emphasis>只能</emphasis> 配合
 		  Unicode 版本使用</entry>
 
 		<entry>port</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WANT_UNICODE</varname></entry>
 
 		<entry>port 能够与两种版本配合使用， 但希望使用
 		  Unicode 版本</entry>
 
 		<entry>port</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WITH_UNICODE</varname></entry>
 
 		<entry>令 port 使用 Unicode 版本</entry>
 
 		<entry>用户</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WITHOUT_UNICODE</varname></entry>
 
 		<entry>令 port 使用普通版本，
 		  如果支持的话 (即未定义 <varname>WX_UNICODE</varname>)</entry>
 
 		<entry>用户</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<warning>
 	  <para>如果 port 同时支持 Unicode 和普通版本，
 	    请不要使用 <varname>WX_UNICODE</varname>。 如果希望默认启用
 	    Unicode， 应定义 <varname>WANT_UNICODE</varname>。</para>
 	</warning>
       </sect2>
 
       <sect2 xml:id="wx-version-detection">
 	<title>检测已安装的版本</title>
 
 	<para>要检测系统中安装的版本， 就需要定义
 	  <varname>WANT_WX</varname>。 如果没有将其设置为特定的版本，
 	  则组件将包含版本后缀。
 	  <varname>HAVE_WX</varname> 变量在检测完成后会自动填入内容。</para>
 
 	<example xml:id="wx-ver-det-example">
 	  <title>检测已安装的 <application>wxWidgets</application>
 	    版本和组件</title>
 
 	  <para>下面的片段可以在安装
 	    <application>wxWidgets</application> 的系统中令 port 使用它，
 	    反之则作为一项选项提供。</para>
 
 	  <programlisting>WANT_WX=        yes
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if defined(WITH_WX) || ${HAVE_WX:Mwx-2.4} != ""
 USE_WX=         2.4
 CONFIGURE_ARGS+=--enable-wx
 .endif</programlisting>
 
 	  <para>下面的片段在系统中有安装过时启用
 	    <application>wxPython</application> 支持，
 	    或在没有安装时作为选项提供； 对
 	    <application>wxWidgets</application> 也是如此办理， 版本皆为
 	    <literal>2.6</literal>。</para>
 
 	  <programlisting>USE_WX=         2.6
 WX_COMPS=       wx
 WANT_WX=        2.6
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if defined(WITH_WXPYTHON) || ${HAVE_WX:Mpython} != ""
 WX_COMPS+=      python
 CONFIGURE_ARGS+=--enable-wxpython
 .endif</programlisting>
 	</example>
       </sect2>
 
       <sect2 xml:id="wx-defined-variables">
 	<title>定义的变量</title>
 
 	<para>以下是一些可以在 port 中使用的变量
 	  (这之前需要定义 <xref linkend="wx-ver-sel-table"/> 中的至少一个变量)。</para>
 
 	<table frame="none">
 	  <title>为使用
 	    <application>wxWidgets</application> 的 port 定义的变量</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>变量名</entry>
 
 		<entry>说明</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><varname>WX_CONFIG</varname></entry>
 
 		<entry>到 <application>wxWidgets</application>
 		  <command>wx-config</command> 脚本的路径 (名字会随版本不同而不同)</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WXRC_CMD</varname></entry>
 
 		<entry>到 <application>wxWidgets</application>
 		  <command>wxrc</command> 程序的路径 (名字会随版本不同而不同)</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WX_VERSION</varname></entry>
 
 		<entry>将要用到的 <application>wxWidgets</application> 版本
 		  (例如， <literal>2.6</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WX_UNICODE</varname></entry>
 
 		<entry>如果没有定义， 而将会使用 Unicode 时， 系统将自动定义此变量。</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
       </sect2>
 
       <sect2 xml:id="wx-premk">
 	<title>在 <filename>bsd.port.pre.mk</filename> 中进行处理</title>
 
 	<para>如果您需要在引用了 <filename>bsd.port.pre.mk</filename> 之后立即对一些变量进行处理，
 	  则需要定义 <varname>WX_PREMK</varname>。</para>
 
 	<important>
 	  <para>如果定义了 <varname>WX_PREMK</varname>， 则在此
 	    <emphasis>之后</emphasis> 定义的依赖关系、 组件和变量将不会生效，
 	    您在引用 <filename>bsd.port.pre.mk</filename>
 	    之前的 <application>wxWidgets</application> port 变量将直接起作用。</para>
 	</important>
 
 	<example xml:id="wx-premk-example">
 	  <title>在命令中使用 <application>wxWidgets</application> 变量</title>
 
 	  <para>下面的片段以执行
 	    <command>wx-config</command> 脚本来得到完整的版本号，
 	    将其赋值到变量中， 并传递给一个程序举例说明了
 	    <varname>WX_PREMK</varname> 的用法。</para>
 
 	  <programlisting>USE_WX=         2.4
 WX_PREMK=       yes
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if exists(${WX_CONFIG})
 VER_STR!=       ${WX_CONFIG} --release
 
 PLIST_SUB+=     VERSION="${VER_STR}"
 .endif</programlisting>
 	</example>
 
 	<note>
 	  <para>在 target 中的 <application>wxWidgets</application> 变量可以直接使用，
 	    而无需 <varname>WX_PREMK</varname> 的参与。</para>
 	</note>
       </sect2>
 
       <sect2 xml:id="wx-additional-config-args">
 	<title>额外的 <command>configure</command> 参数</title>
 
 	<para>某些 GNU <command>configure</command> 脚本在只设置了
 	  <literal>WX_CONFIG</literal> 环境变量时， 无法自动找到
 	  <application>wxWidgets</application>， 而需要使用额外的参数来加以指定。
 	  您可以使用 <varname>WX_CONF_ARGS</varname> 变量来给出这些参数。</para>
 
 	<table frame="none">
 	  <title>可用于 <varname>WX_CONF_ARGS</varname> 的值</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>可用值</entry>
 
 		<entry>结果</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>absolute</literal></entry>
 
 		<entry><literal>--with-wx-config=${WX_CONFIG}</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>relative</literal></entry>
 
 		<entry><literal>--with-wx=${LOCALBASE}
 		    --with-wx-config=${WX_CONFIG:T}</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
       </sect2>
     </sect1>
 
     <sect1 xml:id="using-lua">
       <title>使用 <application>Lua</application></title>
 
       <para>这一节描述了在 ports 系统中的
 	<application>Lua</application> 库的现状， 以及它与 ports 系统的集成。</para>
 
       <sect2 xml:id="lua-introduction">
 	<title>介绍</title>
 
 	<para>许多不同版本的 <application>Lua</application>
 	  库和相关的解释器之间是相互冲突的 (它们会安装同名的文件)。
 	  在 ports 系统中， 这一问题是通过将不同版本的文件以不同的版本号作为后缀名解决的。</para>
 
 	<para>这样做最大的一个问题是， 每个程序都需要进行修改才能找到它所需要的版本。
 	  不过， 通过将适当的参数传给编译器和连接器很容易解决这个问题。</para>
       </sect2>
 
       <sect2 xml:id="lua-version">
 	<title>选择版本</title>
 
 	<para>要让您的 port 使用指定版本的
 	  <application>Lua</application>，
 	  可以定义两个变量的值 (如果只定义了其中的一个， 则另一个会使用默认值)：</para>
 
 	<table xml:id="lua-ver-sel-table" frame="none">
 	  <title>用于选择 <application>Lua</application>
 	    版本的变量</title>
 
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>变量</entry>
 
 		<entry>说明</entry>
 
 		<entry>默认值</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><varname>USE_LUA</varname></entry>
 
 		<entry>port 能够使用的 Lua 版本列表</entry>
 
 		<entry>全部可用版本</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>USE_LUA_NOT</varname></entry>
 
 		<entry>与 port 不兼容的版本列表</entry>
 
 		<entry>无</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>下面是目前 ports 系统提供的可用
 	  <application>Lua</application> 版本和对应的目录：</para>
 
 	<table frame="none">
 	  <title>可用的 <application>Lua</application> 版本</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>版本</entry>
 
 		<entry>Port</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>4.0</literal></entry>
 
 		<entry><package>lang/lua4</package></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>5.0</literal></entry>
 
 		<entry><package>lang/lua50</package></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>5.1</literal></entry>
 
 		<entry><package>lang/lua</package></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>在 <xref linkend="lua-ver-sel-table"/> 中的变量，
 	  可以设置为下面的版本之一， 或用空格分隔的若干版本：</para>
 
 	<table frame="none">
 	  <title>指定 <application>Lua</application> 版本</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>说明</entry>
 
 		<entry>例子</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry>一个版本</entry>
 
 		<entry><literal>4.0</literal></entry>
 	      </row>
 
 	      <row>
 		<entry>某个版本或更高版本</entry>
 
 		<entry><literal>5.0+</literal></entry>
 	      </row>
 
 	      <row>
 		<entry>不高于某个版本</entry>
 
 		<entry><literal>5.0-</literal></entry>
 	      </row>
 
 	      <row>
 		<entry>版本范围 (低版本必须在前)</entry>
 
 		<entry><literal>5.0-5.1</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>除此之外， 也有一些用来从可用版本中选择推荐版本的其它变量。 这些变量也可以设置为一组版本，
 	  而前面的版本优先级较高。</para>
 
 	<table frame="none">
 	  <title>用于选择推荐 <application>Lua</application>
 	    版本的变量</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>变量名</entry>
 
 		<entry>用于</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><varname>WANT_LUA_VER</varname></entry>
 
 		<entry>port</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>WITH_LUA_VER</varname></entry>
 
 		<entry>用户</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<example xml:id="lua-version-example">
 	  <title>选择 <application>Lua</application> 版本</title>
 
 	  <para>下面是一个用到
 	    <application>Lua</application> 版本 <literal>5.0</literal> 或
 	    <literal>5.1</literal>， 并默认使用 <literal>5.0</literal>
 	    的 port 的片段。 这个默认值可以通过
 	    <varname>WITH_LUA_VER</varname> 来另外指定。</para>
 
 	  <programlisting>USE_LUA=      5.0-5.1
 WANT_LUA_VER= 5.0</programlisting>
 	</example>
       </sect2>
 
       <sect2 xml:id="lua-components">
 	<title>组件的选择</title>
 
 	<para>也有一些其它的应用， 尽管本身并不是
 	  <application>Lua</application> 库， 但却与它们相关。
 	  这些应用可以通过 <varname>LUA_COMPS</varname>
 	  变量来指定。 可用的组件如下：</para>
 
 	<table frame="none">
 	  <title>可用的 <application>Lua</application> 组件</title>
 
 	  <tgroup cols="3">
 	    <thead>
 	      <row>
 		<entry>名字</entry>
 
 		<entry>说明</entry>
 
 		<entry>版本限制</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>lua</literal></entry>
 
 		<entry>主库</entry>
 
 		<entry>无</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>tolua</literal></entry>
 
 		<entry>用于访问 C/C++ 代码的库</entry>
 
 		<entry><literal>4.0-5.0</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>ruby</literal></entry>
 
 		<entry>Ruby 绑定</entry>
 
 		<entry><literal>4.0-5.0</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<note>
 	  <para>还有一些其它的组件， 但这些组件是由解释器，
 	    而不是由应用程序使用的 (也就是不被其它模块使用)。</para>
 	</note>
 
 	<para>每个组件的依赖关系类型可以通过手工添加分隔符为冒号的后缀来指定。
 	  如果不指定， 则会采用默认类型 (请参见 <xref linkend="lua-def-dep-types"/>)。
 	  以下是可用的依赖关系类型：</para>
 
 	<table frame="none">
 	  <title>可用的 <application>Lua</application> 依赖关系类型</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>名字</entry>
 
 		<entry>说明</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>build</literal></entry>
 
 		<entry>这个组件是联编过程所必需的， 相当于
 		  <varname>BUILD_DEPENDS</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>run</literal></entry>
 
 		<entry>在运行时需要这个组件， 相当于
 		  <varname>RUN_DEPENDS</varname></entry>
 	      </row>
 
 	      <row>
 		<entry><literal>lib</literal></entry>
 
 		<entry>这个组件在联编和运行时都需要，
 		  相当于 <varname>LIB_DEPENDS</varname></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>组件的默认依赖关系类型如下：</para>
 
 	<table xml:id="lua-def-dep-types" frame="none">
 	  <title>默认的 <application>Lua</application> 依赖关系类型</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>组件</entry>
 
 		<entry>依赖关系类型</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><literal>lua</literal></entry>
 
 		<entry>对于 <literal>4.0-5.0</literal> 是 <literal>lib</literal>
 		  (动态连接) 而对于 <literal>5.1</literal> 则是
 		  <literal>build</literal> (静态连接)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>tolua</literal></entry>
 
 		<entry><literal>build</literal> (静态连接)</entry>
 	      </row>
 
 	      <row>
 		<entry><literal>ruby</literal></entry>
 
 		<entry><literal>lib</literal> (动态连接)</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<example xml:id="lua-components-example">
 	  <title>选择 <application>Lua</application> 组件</title>
 
 	  <para>下面是一个使用了
 	    <application>Lua</application> 版本 <literal>4.0</literal>
 	    及其 <application>Ruby</application> 绑定的 port 片段。</para>
 
 	  <programlisting>USE_LUA=      4.0
 LUA_COMPS=    lua ruby</programlisting>
 	</example>
       </sect2>
 
       <sect2 xml:id="lua-version-detection">
 	<title>检测系统中已安装的版本</title>
 
 	<para>要检测系统中已安装的版本， 您必须定义
 	  <varname>WANT_LUA</varname>。 如果没有将其设定为具体的版本，
 	  则组件会包含版本后缀。 在检测之后，
 	  <varname>HAVE_LUA</varname> 变量将设为检测到的版本。</para>
 
 	<example xml:id="lua-ver-det-example">
 	  <title>检测已安装的 <application>Lua</application> 版本和组件</title>
 
 	  <para>下面是一个如果系统中有安装
 	    <application>Lua</application> 或选择了选项时使用它的 port 片段。</para>
 
 	  <programlisting>WANT_LUA=       yes
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if defined(WITH_LUA5) || ${HAVE_LUA:Mlua-5.[01]} != ""
 USE_LUA=        5.0-5.1
 CONFIGURE_ARGS+=--enable-lua5
 .endif</programlisting>
 
 	  <para>下面的这段 port 在系统中已经有安装， 或用户选择了
 	    <application>tolua</application> 和
 	    <application>Lua</application> 支持时加以安装， 版本均选择
 	    <literal>4.0</literal>。</para>
 
 	  <programlisting>USE_LUA=        4.0
 LUA_COMPS=      lua
 WANT_LUA=       4.0
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if defined(WITH_TOLUA) || ${HAVE_LUA:Mtolua} != ""
 LUA_COMPS+=     tolua
 CONFIGURE_ARGS+=--enable-tolua
 .endif</programlisting>
 	</example>
       </sect2>
 
       <sect2 xml:id="lua-defined-variables">
 	<title>定义的变量</title>
 
 	<para>在 port 中可以使用下列变量 (在定义了
 	  <xref linkend="lua-ver-sel-table"/> 中至少一个变量之后)。</para>
 
 	<table frame="none">
 	  <title>为用到
 	    <application>Lua</application> 的 port 定义的变量</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>变量名</entry>
 
 		<entry>说明</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><varname>LUA_VER</varname></entry>
 
 		<entry>将要使用的 <application>Lua</application> 版本。
 		  (例如， <literal>5.1</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>LUA_VER_SH</varname></entry>
 		<entry><application>Lua</application> 动态连接库的主版本
 		  (例如， <literal>1</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>LUA_VER_STR</varname></entry>
 
 		<entry>不带点的 <application>Lua</application> 版本
 		  (例如， <literal>51</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>LUA_PREFIX</varname></entry>
 
 		<entry>安装 <application>Lua</application> (及其组件) 使用的后缀</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>LUA_SUBDIR</varname></entry>
 
 		<entry>在 <filename>${PREFIX}/bin</filename>、
 		  <filename>${PREFIX}/share</filename> 和
 		  <filename>${PREFIX}/lib</filename> 中用于安装
 		  <application>Lua</application> 的子目录</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>LUA_INCDIR</varname></entry>
 
 		<entry>用以安装 <application>Lua</application> 和
 		  <application>tolua</application> 头文件的目录</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>LUA_LIBDIR</varname></entry>
 
 		<entry>用以安装 <application>Lua</application> 和
 		  <application>tolua</application> 库文件的目录</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>LUA_MODLIBDIR</varname></entry>
 
 		<entry>用以安装 <application>Lua</application>
 		  模块动态连接库 (<filename>.so</filename>) 的目录</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>LUA_MODSHAREDIR</varname></entry>
 
 		<entry>用以安装 <application>Lua</application>
 		  模块 (<filename>.lua</filename>) 的目录</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>LUA_PKGNAMEPREFIX</varname></entry>
 
 		<entry><application>Lua</application> 模块包的后缀名</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>LUA_CMD</varname></entry>
 
 		<entry>到 <application>Lua</application>
 		  解释器的路径</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>LUAC_CMD</varname></entry>
 
 		<entry>到 <application>Lua</application>
 		  编译器的路径</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>TOLUA_CMD</varname></entry>
 
 		<entry>到 <application>tolua</application>
 		  程序的路径</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<example xml:id="lua-variables-example">
 	  <title>告诉 port 到什么地方去找
 	    <application>Lua</application></title>
 
 	  <para>下面的 port 片段展示了如何告诉使用的
 	    configure 脚本去什么地方查找 <application>Lua</application>
 	    的头文件和库文件。</para>
 
 	  <programlisting>
 USE_LUA=        4.0
 GNU_CONFIGURE=  yes
 CONFIGURE_ENV=  CPPFLAGS="-I${LUA_INCDIR}" LDFLAGS="-L${LUA_LIBDIR}"</programlisting>
 	</example>
       </sect2>
 
       <sect2 xml:id="lua-premk">
 	<title>在 <filename>bsd.port.pre.mk</filename> 时进行处理</title>
 
 	<para>如果您需要在使用引用 <filename>bsd.port.pre.mk</filename> 之后就得到变量，
 	  以便将其用于执行一些命令， 需要定义 <varname>LUA_PREMK</varname>。</para>
 
 	<important>
 	  <para>如果您定义了 <varname>LUA_PREMK</varname>， 则在您引用
 	    <filename>bsd.port.pre.mk</filename> <emphasis>之后</emphasis>，
 	    即使修改了 <application>Lua</application> port 变量，
 	    版本和依赖关系也都不会随之发生变化了。</para>
 	</important>
 
 	<example xml:id="lua-premk-example">
 	  <title>在命令中使用 <application>Lua</application> 变量</title>
 
 	  <para>下面的片段展示了如何利用
 	    <varname>LUA_PREMK</varname>， 并运行
 	    <application>Lua</application> 解释器得到完整的版本串，
 	    将其赋值给一个变量， 并传递给程序。</para>
 
 	  <programlisting>USE_LUA=        5.0
 LUA_PREMK=      yes
 
 .include &lt;bsd.port.pre.mk&gt;
 
 .if exists(${LUA_CMD})
 VER_STR!=       ${LUA_CMD} -v
 
 CFLAGS+=        -DLUA_VERSION_STRING="${VER_STR}"
 .endif</programlisting>
 	</example>
 
 	<note>
 	  <para>在 target 中的 <application>Lua</application> 变量可以在命令中安全的使用，
 	    而无需使用
 	    <varname>LUA_PREMK</varname>。</para>
 	</note>
       </sect2>
     </sect1>
 
     <sect1 xml:id="using-xfce">
       <title>使用 Xfce</title>
 
       <para><varname>USE_XFCE</varname> 变量可以用来自动配置使用基于 Xfce 库或应用程序， 如
 	<package>x11-toolkits/libxfce4gui</package> 和
 	<package>x11-wm/xfce4-panel</package> 的 port 的依赖关系。</para>
 
       <para>目前， 系统能够识别下列 Xfce 库和应用程序：</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>libexo：<package>x11/libexo</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>libgui：<package>x11-toolkits/libxfce4gui</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>libutil：<package>x11/libxfce4util</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>libmcs：<package>x11/libxfce4mcs</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>mcsmanager：<package>sysutils/xfce4-mcs-manager</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>panel：<package>x11-wm/xfce4-panel</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>thunar：<package>x11-fm/thunar</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>wm：<package>x11-wm/xfce4-wm</package></para>
 	</listitem>
 
 	<listitem>
 	  <para>xfdev：<package>dev/xfce4-dev-tools</package></para>
 	</listitem>
 
       </itemizedlist>
 
       <para>除此之外， 还能够使用下列参数：</para>
 
       <itemizedlist>
 	<listitem>
 	  <para>configenv： 如果您的 port 需要使用特殊的
 	    <varname>CONFIGURE_ENV</varname> 来查找所需的库。
 	    <programlisting>-I&dollar;{LOCALBASE}/include -L&dollar;{LOCALBASE}/lib</programlisting>
 	    会加到 <varname>CONFIGURE_ENV</varname> 的 CPPFLAGS。</para>
 	</listitem>
 
       </itemizedlist>
 
       <para>因此， 如果 port 有到
 	<package>sysutils/xfce4-mcs-manager</package> 的依赖关系，
 	并需要在 configure 的环境中指定特殊的饿 CPPFLAGS， 则所用的语法为：</para>
 
       <programlisting>USE_XFCE=        mcsmanager configenv</programlisting>
     </sect1>
 
     <sect1 xml:id="using-mozilla">
       <title>使用 Mozilla</title>
 
 	<table frame="none">
 	  <title>用到 Mozilla 的 port 使用的变量</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 
 	      <row>
 		<entry><varname>USE_GECKO</varname></entry>
 
 		<entry>port 支持的 Gecko 后端。 可选值：
 		  <literal>libxul</literal> (<filename>libxul.so</filename>)、
 		  <literal>seamonkey</literal> (<filename>libgtkembedmoz.so</filename>，
 		  过时， 新 port 应避免使用)。</entry>
 	      </row>
 	      <row>
 		<entry><varname>USE_FIREFOX</varname></entry>
 
 		<entry>port 需要使用 Firefox 作为运行环境依赖。
 		  可选值：
 		  <literal>yes</literal> (使用默认版本)、
 		  <literal>40</literal>、 <literal>36</literal>、
 		  <literal>35</literal>。
 		  默认的依赖采用的是版本
 		  <literal>40</literal>。</entry>
 	      </row>
 	      <row>
 		<entry><varname>USE_FIREFOX_BUILD</varname></entry>
 
 		<entry>port 需要使用 Firefox 作为联编环境依赖。
 		  可选值： 参见 USE_FIREFOX。
 		  这个变量会自动设置 USE_FIREFOX 使用相同的值。</entry>
 	      </row>
 	      <row>
 		<entry><varname>USE_SEAMONKEY</varname></entry>
 
 		<entry>port 需要使用 SeaMonkey 作为运行环境依赖。
 		  可选值：
 		  <literal>yes</literal> (使用默认版本)、
 		  <literal>20</literal>、 <literal>11</literal>
 		  (过时， 新 port 应避免使用)。
 		  默认的依赖采用的是版本
 		  <literal>20</literal>。</entry>
 	      </row>
 	      <row>
 		<entry><varname>USE_SEAMONKEY_BUILD</varname></entry>
 
 		<entry>port 需要使用 SeaMonkey 作为联编环境依赖。
 		  可选值： 参见 USE_SEAMONKEY。
 		  这个变量会自动设置 USE_SEAMONKEY 使用相同的值。</entry>
 	      </row>
 	      <row>
 		<entry><varname>USE_THUNDERBIRD</varname></entry>
 
 		<entry>port 需要使用 Thunderbird 作为运行环境依赖。
 		  可选值：
 		  <literal>yes</literal> (使用默认版本)、
 		  <literal>31</literal>、 <literal>30</literal>
 		  (过时， 新 port 应避免使用)。
 		  默认的依赖采用的是版本
 		  <literal>31</literal>。</entry>
 	      </row>
 	      <row>
 		<entry><varname>USE_THUNDERBIRD_BUILD</varname></entry>
 
 		<entry>port 需要使用 Thunderbird 作为联编环境依赖。
 		  可选值： 参见 USE_THUNDERBIRD。
 		  这个变量会自动设置 USE_THUNDERBIRD 使用相同的值。</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
       <para>可用变量的完整列表， 请参阅
 	<filename>/usr/ports/Mk/bsd.gecko.mk</filename>。</para>
     </sect1>
 
 
     <sect1 xml:id="using-databases">
       <title>使用数据库</title>
 
 	<table frame="none">
           <title>ports 中有关数据库的变量</title>
 
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>Variable</entry>
 
 		<entry>Means</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><varname>USE_BDB</varname></entry>
 
                 <entry>如果这个变量为 <literal>yes</literal>，
                   则把 <package>databases/db41</package>
                   列为依赖关系。 这个变量还可以被设置成的值有： 40，41，
 		  42、 43、 44、 46、 47、 48 或 51。 您可以声明可接受值的范围，
                   <varname>USE_BDB</varname>=42+ 将寻找已安装的最高版本，
                   如果没有找到则退回到 42。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>USE_MYSQL</varname></entry>
 
                 <entry>如果这个变量为 <literal>yes</literal>，
                   则把 <package>databases/mysql55-server</package>
                   列为依赖关系。还有一个相关的变量，<varname>WANT_MYSQL_VER</varname>,
                   可以设置的值有 323，40，41，50，51， 52， 55 或者 60。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>USE_PGSQL</varname></entry>
 
                 <entry>如果设置成 <literal>yes</literal>，则把
                   <package>databases/postgresql82</package>
                   列为依赖关系。还有一个相关的变量，<varname>WANT_PGSQL_VER</varname>，
                   可以设置的值有 73，74，80，81，82， 83 或 90。</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
 
       <para>更多详情请参阅
 	<link xlink:href="http://www.freebsd.org/cgi/cvsweb.cgi/ports/Mk/bsd.database.mk">
 	bsd.database.mk</link>。</para>
 
     </sect1>
 
     <sect1 xml:id="rc-scripts">
       <title>启动和停止服务 (rc 脚本)</title>
 
       <para><filename>rc.d</filename> 脚本在系统启动时用于启动服务，
 	并为管理员提供停止、 启动和重新启动某个服务的标准方法。 Ports
 	安装的脚本会集成到系统的 <filename>rc.d</filename> 框架中。
 	关于如何使用它的说明， 可以在
 	<link xlink:href="&url.books.handbook;/configtuning-rcd.html">使用手册的 rc.d
 	章节</link> 找到。 关于可用命令的详细解释， 则可以在
 	&man.rc.8; 和 &man.rc.subr.8; 找到。 最后， 您可以参阅
 	<link xlink:href="&url.articles.rc-scripting;">这篇文章</link>
 	了解撰写 <filename>rc.d</filename> 脚本的最佳实践。</para>
 
       <para>可以安装一或多个 <filename>rc.d</filename> 脚本：</para>
 
       <programlisting>USE_RC_SUBR=	doormand</programlisting>
 
       <para>这些脚本必须放到 <filename>files</filename>
 	目录， 并附加 <literal>.in</literal>。
 	这个文件中可以使用标准的
 	<varname>SUB_LIST</varname> 替换展开。 除此之外，
 	我们还强烈推荐使用 <literal>%%PREFIX%%</literal> 和
 	<literal>%%LOCALBASE%%</literal> 替换展开。 关于
 	<varname>SUB_LIST</varname> 的介绍可以在 <link linkend="using-sub-files">本书的相关章节</link> 找到。</para>
 
       <para>在 &os;&nbsp;6.1-RELEASE 之前， 与 &man.rcorder.8; 的集成是通过
 	<varname>USE_RCORDER</varname> 而不是
 	<varname>USE_RC_SUBR</varname> 来完成的。 不过，
 	除非 port 需要提供安装进基本系统这样的选项，
 	或者服务需要在 <filename>rc.d</filename> 脚本
 	<filename>FILESYSTEMS</filename> 之前运行这类特殊情况，
 	一般来说是不需要使用这个功能的。</para>
 
       <para>从 &os;&nbsp;6.1-RELEASE 开始， 本地安装的 <filename>rc.d</filename>
 	脚本 (包括由 port 安装的脚本) 会纳入基本系统的 &man.rcorder.8;。</para>
 
       <para>以下是一个简单的 <filename>rc.d</filename> 脚本：</para>
 
       <programlisting>#!/bin/sh
 
 # &dollar;FreeBSD&dollar;
 #
 # PROVIDE: doormand
 # REQUIRE: LOGIN
 # KEYWORD: shutdown
 #
 # 在 /etc/rc.conf.local 或 /etc/rc.conf 中增加下述设置可以启用这一服务：
 #
 # doormand_enable (bool):	默认设为 NO。
 #				设为 YES 可以启用 doormand。
 # doormand_config (path):	默认设为 %%PREFIX%%/etc/doormand/doormand.cf。
 #
 
 . /etc/rc.subr
 
 name="doormand"
 rcvar=${name}_enable
 
 command=%%PREFIX%%/sbin/${name}
 pidfile=/var/run/${name}.pid
 
 load_rc_config $name
 
 : ${doormand_enable="NO"}
 : ${doormand_config="%%PREFIX%%/etc/doormand/doormand.cf"}
 
 command_args="-p $pidfile -f $doormand_config"
 
 run_rc_command "$1"</programlisting>
 
       <para>除非有很站得住脚的理由提前启动服务，所有的 ports 脚本应使用
 	<programlisting>REQUIRE: LOGIN</programlisting>。
 	如果服务需要以特定用户 (除 root 之外) 身份启动， 则必须这样做。
 	在前面的例子中， 我们还使用了
 	<programlisting>KEYWORD: shutdown</programlisting>
 	以便让 mythical port 在系统停机的过程中以正常的方式终止，
 	因为它需要在系统引导过程中启动服务。 如果脚本没有启动任何服务，
 	则并不需要这样做。</para>
 
       <para>这里， 对变量的默认赋值方法应采用 &quot;=&quot;，
 	而非 &quot;:=&quot; 这样的形式。 这是因为，
 	前一种赋值方法只有在变量未被设置时才设置默认值，
 	而后一种方法则会在变量没有设置，
 	<emphasis>或者</emphasis> 其值为空时都设置默认值。
 	用户非常可能在其
 	<filename>rc.conf.local</filename> 中使用类似
 	<programlisting>doormand_flags=""</programlisting> 这样的设置，
 	而采用 &quot;:=&quot; 来进行赋值，
 	则会在不经意间覆盖用户所希望的设置。</para>
 
       <note>
 	<para>新增的脚本均不应使用 <filename>.sh</filename>
 	  后缀。 未来， 仍然包含这一后缀的脚本将被批量改名。</para>
       </note>
 
       <sect2>
 	<title>卸载时停止服务</title>
 
 	<para>可以在卸载的过程中自动地停止服务。 我们建议只有在绝对必要，
 	  例如必须在删除文件之前停止服务这类的情况下才使用这一功能。
 	  通常来说， 决定是否在卸载时停止服务是系统管理员需要考虑的事情。
 	  另外要注意， 这个功能也会影响升级过程。</para>
 
 	<para>需要时可以在 <filename>pkg-plist</filename> 中加入：</para>
 
 	<programlisting>@stopdaemon doormand</programlisting>
 
 	<para>这里的参数必须与
 	  <varname>USE_RC_SUBR</varname> 变量的内容匹配。</para>
       </sect2>
     </sect1>
 
     <sect1 xml:id="users-and-groups">
       <title>添加用户和用户组</title>
 
       <para>一些 port 需要在安装的系统中创建特定的用户或用户组。
 	如果有这种情况， 请从 50 到 999 之间选择一个尚未使用的 UID， 并在
 	<filename>ports/UIDs</filename> (针对用户) 或
 	<filename>ports/GIDs</filename> (针对组) 中予以记录。
 	请务必确保您没有使用系统中已经在其他 ports 中使用的 UID。</para>
 
       <para>如果您的 port 需要创建新用户或用户组，
 	请在提交补丁的时候一并提交这两个文件的补丁。</para>
 
       <para>接下来， 可以在您的 <filename>Makefile</filename> 中使用
 	<varname>USERS</varname> 和 <varname>GROUPS</varname>
 	这两个变量， 系统会在安装时自动创建用户或组。</para>
 
       <programlisting>USERS=	pulse
 GROUPS=	pulse pulse-access pulse-rt</programlisting>
 
       <para>现有的保留 UID 和 GID 列表，
 	可以在 <filename>ports/UIDs</filename> 和
 	<filename>ports/GIDs</filename> 找到。</para>
 
     </sect1>
 
     <sect1>
       <title>依赖内核源代码的 Ports</title>
 
       <para>某些 ports (例如可加载式内核模块) 需要内核的源文件才能编译。
 	下面是检测用户是否安装了源代码的例子：</para>
 
       <programlisting>.if !exists(${SRC_BASE}/sys/Makefile)
 IGNORE=         requires kernel sources to be installed
 .endif</programlisting>
     </sect1>
 
   </chapter>
 
     <chapter xml:id="plist">
       <title>高级 <filename>pkg-plist</filename> 用法</title>
 
       <sect1 xml:id="plist-sub">
 	<title>根据 make 变量对 <filename>pkg-plist</filename> 进行修改</title>
 
 	<para>某些 port， 特别是 <literal>p5-</literal> port，
 	  会需要根据配置选项 (或对于 <literal>p5-</literal> port 而言，
 	  <literal>perl</literal> 的版本) 来修改它们的 <filename>pkg-plist</filename>。
 	  为简化这一工作， 在
 	  <filename>pkg-plist</filename> 中的 <literal>%%OSREL%%</literal>、
 	  <literal>%%PERL_VER%%</literal>， 以及
 	  <literal>%%PERL_VERSION%%</literal> 将自动进行相应的替换。
 	  其中， <literal>%%OSREL%%</literal> 的值是操作系统以数值表示的版本 (例如
 	  <literal>4.9</literal>)。 <literal>%%PERL_VERSION%%</literal> 和
 	  <literal>%%PERL_VER%%</literal> 是 <command>perl</command> 的完整版本号 (例如
 	  <literal>5.8.9</literal>)。许多其它与 port 文档文件有关的
 	  <literal>%%变量%%</literal> 在 <link linkend="install-documentation">相应章节</link> 中进行了介绍。</para>
 
 	<para>如果您还需要进行其它的替换， 可以通过将
 	  <varname>PLIST_SUB</varname> 变量设置为一组
 	  <literal>变量=值</literal>
 	  对来实现。 其中， <literal>%%VAR%%</literal>
 	  表示在 <filename>pkg-plist</filename> 中将被
 	  <replaceable>值</replaceable> 替换的那些文字。</para>
 
 	<para>举例来说， 如果 port 需要把很多文件放到和版本有关的目录中，
 	  可以在 <filename>Makefile</filename> 中按照类似下面的例子：</para>
 
 	<programlisting>OCTAVE_VERSION= 2.0.13
 PLIST_SUB=      OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
 
 	<para>并在 <filename>pkg-plist</filename> 中将具体的版本替换为
 	  <literal>%%OCTAVE_VERSION%%</literal>。 这样， 在升级 port 时，
 	  就不需要再到 <filename>pkg-plist</filename> 中修改那几十 (或者，
 	  有时甚至是上百) 行的内容了。</para>
 
 	<para>如果您的 port 需要根据一定的配置来有条件地安装一些文件，
 	  通常的做法是在 <filename>pkg-plist</filename> 中列出这些文件时，
 	  在对应行的开头加上 <literal>%%TAG%%</literal>，
 	  并将 <literal>TAG</literal> 写到 <filename>Makefile</filename>
 	  中的 <varname>PLIST_SUB</varname> 变量中， 根据需要替换掉， 或替换为
 	  <literal>@comment</literal>， 后者表示让打包工具忽略这行：</para>
 
 	<programlisting>.if defined(WITH_X11)
 PLIST_SUB+=	X11=""
 .else
 PLIST_SUB+=	X11="@comment "
 .endif</programlisting>
 
 	<para>与之对应， 在 <filename>pkg-plist</filename> 中：</para>
 
 	<programlisting>%%X11%%bin/foo-gui</programlisting>
 
 	<para>这一替换过程 (以及加入 <link linkend="makefile-manpages">联机手册</link> 的过程)，
 	  会在 <buildtarget>pre-install</buildtarget> 和
 	  <buildtarget>do-install</buildtarget> 两个 target 之间， 通过读取
 	  <filename>PLIST</filename> 并写入
 	  <filename>TMPPLIST</filename>
 	  (默认情况下， 是：
 	  <filename>WRKDIR/.PLIST.mktmp</filename>) 来完成。
 	  因此， 如果您的 port 动态生成 <filename>PLIST</filename>，
 	  就需要在 <buildtarget>pre-install</buildtarget> 之前完成。
 	  另外， 如果您的 port 需要编辑所生成的文件， 则需要在
 	  <buildtarget>post-install</buildtarget> 中操作名为
 	  <filename>TMPPLIST</filename> 的那个文件。</para>
 
 	<para>另一种可行的修改装箱单的方法，
 	  则是根据 <varname>PLIST_FILES</varname> 和
 	  <varname>PLIST_DIRS</varname> 这两个变量的设置来进行。
 	  它们的值会作为目录名连同 <filename>PLIST</filename>
 	  的内容一起写入 <filename>TMPPLIST</filename>。
 	  在 <varname>PLIST_FILES</varname>
 	  和 <varname>PLIST_DIRS</varname> 中列出的名字， 会经历前面所介绍的
 	  <literal>%%变量%%</literal>
 	  替换过程。 除此之外， 在 <varname>PLIST_FILES</varname>
 	  中列出的文件， 会不加任何修改第出现在最终的装箱单中，
 	  而 <literal>@dirrm</literal> 将作为前缀加到 <varname>PLIST_DIRS</varname>
 	  所列的名字之前。 为了达到目的， <varname>PLIST_FILES</varname> 和
 	  <varname>PLIST_DIRS</varname> 必须在写
 	  <filename>TMPPLIST</filename> 之前，
 	  也就是在 <buildtarget>pre-install</buildtarget> 或更早的阶段进行设置。</para>
       </sect1>
 
       <sect1 xml:id="plist-cleaning">
 	<title>空目录</title>
 
 	<sect2 xml:id="plist-dir-cleaning">
 	  <title>清理空目录</title>
 
 	<para>一定要让 port 在卸载时进行清理空目录。
 	  通常， 可以通过为所有由 port 创建的目录增加对应的
 	  <literal>@dirrm</literal> 行来实现。 在删除父目录之前，
 	  需要首先删除它的子目录。</para>
 
 	<programlisting> :
 lib/X11/oneko/pixmaps/cat.xpm
 lib/X11/oneko/sounds/cat.au
  :
 @dirrm lib/X11/oneko/pixmaps
 @dirrm lib/X11/oneko/sounds
 @dirrm lib/X11/oneko</programlisting>
 
 	<para>然而， 有时 <literal>@dirrm</literal> 会由于其它 port
 	  使用了同一个目录而发生错误。
 	  利用 <literal>@dirrmtry</literal> 可以只删除那些空目录，
 	  而避免给出警告。</para>
 
 	<programlisting>@dirrmtry share/doc/gimp</programlisting>
 
 	<para>按照上面的写法， 将不会显示任何错误信息， 而且，即使在
 	  <filename>${PREFIX}/share/doc/gimp</filename>
 	  由于其它 port 在其中安装了一些别的文件的时候， 也不会导致
 	  &man.pkg.delete.1; 异常退出。</para>
 	</sect2>
 
 	<sect2 xml:id="plist-dir-empty">
 	  <title>如何建立空目录</title>
 
 	  <para>在 port 安装过程中创建的空目录需要特别留意。 安装 package
 	    时并不会自动创建这些目录， 这是因为 package 只保存文件。
 	    要确保安装 package 时会自动创建这些空目录， 需要在
 	    <filename>pkg-plist</filename> 中加入与
 	    <literal>@dirrm</literal> 对应的行：</para>
 
 	  <programlisting>@exec mkdir -p %D/share/foo/templates</programlisting>
 	</sect2>
 
       </sect1>
 
       <sect1 xml:id="plist-config">
 	<title>配置文件</title>
 
 	<para>如果 port 需要把一些文件放到
 	  <filename>PREFIX/etc</filename>，
 	  <emphasis>不要</emphasis> 简单地安装它们， 并将其列入
 	  <filename>pkg-plist</filename>， 因为这样会导致
 	  &man.pkg.delete.1; 删除用户精心编辑的文件，
 	  而新安装时则又会把这些文件覆盖。</para>
 
 	<para>因此， 您应把配置文件的例子按其它的后缀来安装
 	  (例如 <filename>filename.sample</filename>
 	  就是一个不错的选择) 并显示一条 <link linkend="porting-message">消息</link>
 	    告诉用户如何复制并编辑这个配置文件， 以便让软件能够正确工作。</para>
 	<para>因此， 应按其它的后缀来安装配置文件的例子
 	  (<filename>filename.sample</filename>
 	  就是一个不错的选择)。 如果实际的配置文件不存在，
 	  则将其复制为实际文件的名字。 卸载时， 如果发现用户没有修改配置文件，
 	  则将其删除。 您需要在 port 的 <filename>Makefile</filename>，
 	  以及 <filename>pkg-plist</filename> (对于从 package
 	  安装的情形) 进行处理。</para>
 
 	<para>示例的 <filename>Makefile</filename> 部分：</para>
 
 	<programlisting>post-install:
 	@if [ ! -f ${PREFIX}/etc/orbit.conf ]; then \
 		${CP} -p ${PREFIX}/etc/orbit.conf.sample ${PREFIX}/etc/orbit.conf ; \
 	fi</programlisting>
 
 	<para>示例的 <filename>pkg-plist</filename> 部分：</para>
 
 	<programlisting>@unexec if cmp -s %D/etc/orbit.conf.sample %D/etc/orbit.conf; then rm -f %D/etc/orbit.conf; fi
 etc/orbit.conf.sample
 @exec if [ ! -f %D/etc/orbit.conf ] ; then cp -p %D/%F %B/orbit.conf; fi</programlisting>
 
 	<para>另外， 还应显示一条 <link linkend="porting-message">消息</link> 指出用户应在何处复制并编辑这个文件，
 	  以便让软件能开始正常工作。</para>
       </sect1>
 
       <sect1 xml:id="plist-dynamic">
 	<title>动态装箱单与静态装箱单的对比</title>
 
 	<para><emphasis>静态装箱单</emphasis> 是指在 Ports Collection 中以
 	  <filename>pkg-plist</filename> 文件 (可能包含变量替换)，
 	  或以 <varname>PLIST_FILES</varname> 和 <varname>PLIST_DIRS</varname>
 	  的形式嵌入到 <filename>Makefile</filename> 出现的装箱单。
 	  即使它是由工具或 Makefile 中的某个 target 在经由 committer 加入到
 	  Ports Collection <emphasis>之前</emphasis> 自动生成的也是如此，
 	  因为可以在不下载或编译源代码包的前提下对其进行检视。</para>
 
 	<para><emphasis>动态装箱单</emphasis> 是指在 port
 	  编译并安装时生成的装箱单。 在下载并编译您所移植的应用程序的源代码之前，
 	  或在执行了 <literal>make
 	  clean</literal> 之后， 就无法查看其内容了。</para>
 
 	<para>尽管使用动态装箱单并不被禁止， 但监护人应尽可能使用静态装箱单，
 	  因为它能够让用户使用 &man.grep.1;来发现所需的 ports，
 	  例如， 它是否会安装某个特定文件。 动态列表主要应用于复杂的，
 	  其装箱单随所选功能会发生巨变 (因而使得维护静态装箱单不再可行)，
 	  或那些随版本而改变装箱单内容的 port (例如， 使用
 	  <application>Javadoc</application> 来生成文档的那些 ports)。</para>
 
 	<para>我们鼓励那些选择使用动态装箱单的监护人提供一个能够生成
 	  <filename>pkg-plist</filename> 的 target， 以便于用户检视其内容。</para>
 
       </sect1>
 
     <sect1 xml:id="plist-autoplist">
       <title>装箱单 (package list) 的自动化制作</title>
 
       <para>首先， 请确认已经基本上完成了 port 的工作， 仅缺
 	<filename>pkg-plist</filename>。</para>
 
       <para>接下来， 建立一个用于安装您的 port 的临时目录，
 	并在其中安装它所依赖的所有其他软件包：</para>
 
       <screen>&prompt.root; <userinput>mkdir /var/tmp/`make -V PORTNAME`</userinput>
 &prompt.root; <userinput>mtree -U -f `make -V MTREE_FILE` -d -e -p /var/tmp/`make -V PORTNAME`</userinput>
 &prompt.root; <userinput>make depends PREFIX=/var/tmp/`make -V PORTNAME`</userinput></screen>
 
       <para>将目录结构保存到一新文件中。</para>
 
       <screen>&prompt.root; <userinput>(cd /var/tmp/`make -V PORTNAME` &amp;&amp; find -d * -type d) | sort &gt; OLD-DIRS</userinput></screen>
 
       <para>建立一空白 <filename>pkg-plist</filename> 文件：</para>
 
       <screen>&prompt.root; <userinput>:&gt;pkg-plist</userinput></screen>
 
       <para>如果您的 port 遵循 <varname>PREFIX</varname> (应该如此)
 	则接下来应安装该 port 并创建装箱单。</para>
 
       <screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/`make -V PORTNAME`</userinput>
 &prompt.root; <userinput>(cd /var/tmp/`make -V PORTNAME` &amp;&amp; find -d * \! -type d) | sort &gt; pkg-plist</userinput></screen>
 
       <para>此外还应把新建立的目录加入装箱单。</para>
 
       <screen>&prompt.root; <userinput>(cd /var/tmp/`make -V PORTNAME` &amp;&amp; find -d * -type d) | sort | comm -13 OLD-DIRS - | sort -r | sed -e 's#^#@dirrm #' &gt;&gt; pkg-plist</userinput></screen>
 
       <para>最后需要手工整理 packing list； 这一过程不是
 	<emphasis>完全</emphasis> 自动的。 联机手册应列入 port
 	的 <filename>Makefile</filename> 中的
 	<varname>MAN<replaceable>n</replaceable></varname>， 而不是装箱单。
 	用户配置文件应被删除， 或以
 	<filename>filename.sample</filename>
 	这样的名字来安装。 <filename>info/dir</filename> 文件，
 	也不应列入， 同时应按照 <link linkend="makefile-info">info
 	文件</link> 的说明来增加一些 <filename>install-info</filename> 行。
 	所有由 port 安装的库， 应按照
 	<link linkend="porting-shlibs">动态连接库</link>
 	小节中介绍的方法处理。</para>
 
       <para>另外， 也可以使用
 	<filename>/usr/ports/Tools/scripts/</filename> 中的
 	<command>plist</command> 脚本来自动创建
 	package list。 <filename>plist</filename>
 	脚本是一个 <application>Ruby</application> 脚本，
 	它能够将前面介绍的手工操作自动化。</para>
 
       <para>开始的步骤和上面的前三行一样， 也就是
 	<command>mkdir</command>， <command>mtree</command> 并
 	<command>make depends</command>。 然后联编和安装
 	port：</para>
 
       <screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/`make -V PORTNAME`</userinput></screen>
 
       <para>然后让 <command>plist</command> 生成
 	<filename>pkg-plist</filename> 文件：</para>
 
       <screen>&prompt.root; <userinput>/usr/ports/Tools/scripts/plist -Md -m `make -V MTREE_FILE` /var/tmp/`make -V PORTNAME` &gt; pkg-plist</userinput></screen>
 
       <para>与前面类似， 如此生成的装箱单也需要手工进行一些清理工作。</para>
 
       <para>另一个可以用来创建最初的
 	<filename>pkg-plist</filename> 的工具是 <package>ports-mgmt/genplist</package>。
 	和其他自动化工具类似， 您应对它生成的 <filename>pkg-plist</filename>
 	应手工检查并根据需要进行修改。</para>
     </sect1>
 
     </chapter>
 
     <chapter xml:id="pkg-files">
       <title><filename>pkg-*</filename> 文件</title>
 
       <para>前面有一些没有提及的关于
 	<filename>pkg-*</filename> 文件的技巧，
 	它们可以方便地完成许多任务。</para>
 
       <sect1 xml:id="porting-message">
 	<title><filename>pkg-message</filename> (安装预编译包时显示的消息文件)</title>
 
 	<para>如果您需要在安装时显示一条消息给用户，
 	  可以把这消息放在 <filename>pkg-message</filename> 中。
 	  这一特性通常可以用于在 &man.pkg.add.1; 之后显示一些附加的安装步骤，
 	  或显示关于授权的信息。</para>
 
 	<para>当需要显示一些编译开关或警告时，
 	  请使用 <varname>ECHO_MSG</varname>。
 	  <filename>pkg-message</filename> 文件只是为显示安装后的执行操作指导使用的。
 	  类似地， 还需要留意
 	  <varname>ECHO_MSG</varname> 和 <varname>ECHO_CMD</varname>
 	  之间的区别。 前一个是在屏幕上显示消息性的文字， 而后一个则用于在执行命令时使用管道。</para>
 
 	<para>下面是用到了这两个宏的例子
 	  <filename>shells/bash2/Makefile</filename>：</para>
 
 	<programlisting>update-etc-shells:
 	@${ECHO_MSG} "updating /etc/shells"
 	@${CP} /etc/shells /etc/shells.bak
 	@( ${GREP} -v ${PREFIX}/bin/bash /etc/shells.bak; \
 		${ECHO_CMD} ${PREFIX}/bin/bash) &gt;/etc/shells
 	@${RM} /etc/shells.bak</programlisting>
 
 	<note>
 	  <para><filename>pkg-message</filename> 文件，
 	    并不需要明确地加到 <filename>pkg-plist</filename> 中。
 	    此外， 在用户使用 port 而不是 package 来安装软件时，
 	    它并不会被显示出来。 因此如果需要的话， 您应该在
 	    <buildtarget>post-install</buildtarget> target 中指定显示它。</para>
 	</note>
       </sect1>
 
       <sect1 xml:id="pkg-install">
 	<title><filename>pkg-install</filename> (安装预编译包时执行的脚本文件)</title>
 
 	<para>如果您的 port 需要在预编译的安装包通过 &man.pkg.add.1;
 	  安装时执行一些命令， 则应通过
 	  <filename>pkg-install</filename> 脚本来完成。
 	  这个脚本会自动地加入 package， 并被
 	  &man.pkg.add.1; 执行两次： 第一次是
 	  <literal>&dollar;{SH} pkg-install &dollar;{PKGNAME}
 	  PRE-INSTALL</literal> 而第二次是
 	  <literal>&dollar;{SH} pkg-install &dollar;{PKGNAME} POST-INSTALL</literal>。
 	  <literal>&dollar;2</literal> 可被用来检测脚本运行的模式。
 	  环境变量 <envar>PKG_PREFIX</envar> 将设置为 package 的安装目录。
 	  请参见 &man.pkg.add.1; 以了解更进一步的细节。</para>
 
 	<note>
 	  <para>在使用 <command>make install</command> 时这个脚本不会被自动运行。
 	    如果需要运行它， 则必须在您的 port 中的
 	    <filename>Makefile</filename> 里明确地予以调用， 其方法是加入类似
 	    <literal>PKG_PREFIX=&dollar;{PREFIX} &dollar;{SH} &dollar;{PKGINSTALL}
 	    &dollar;{PKGNAME} PRE-INSTALL</literal> 这样的命令。</para>
 	</note>
       </sect1>
 
       <sect1 xml:id="pkg-deinstall">
 	<title><filename>pkg-deinstall</filename> (卸载时执行的脚本文件)</title>
 
 	<para>这一脚本将在 package 被卸载时执行。</para>
 
 	<para>此脚本会被 &man.pkg.delete.1; 执行两次。
 	  第一次是 <literal>&dollar;{SH} pkg-deinstall &dollar;{PKGNAME}
 	  DEINSTALL</literal> 而第二次则是
 	  <literal>&dollar;{SH} pkg-deinstall &dollar;{PKGNAME} POST-DEINSTALL</literal>。
 	</para>
       </sect1>
 
       <sect1 xml:id="pkg-req">
 	<title><filename>pkg-req</filename> (安装预编译包时检测是否应执行操作的脚本文件)</title>
 
 	<para>如果您的 port 需要确定它是否应被安装，
 	  可以创建 <filename>pkg-req</filename> <quote>requirements</quote>
 	  脚本。 它会在安装/卸载时自动运行， 以决定操作是否应被实施。</para>
 
 	<para>这个脚本会在使用 &man.pkg.add.1; 安装时以
 	  <literal>pkg-req &dollar;{PKGNAME} INSTALL</literal> 的命令行执行。
 	  卸载时， 它将由 &man.pkg.delete.1; 以
 	  <literal>pkg-req &dollar;{PKGNAME} DEINSTALL</literal> 的命令行执行。</para>
       </sect1>
 
       <sect1 xml:id="pkg-names">
 	<title xml:id="porting-pkgfiles">改变
 	  <filename>pkg-*</filename> 文件的名字</title>
 
 	<para>所有 <filename>pkg-*</filename> 文件的名字，
 	  皆系采用变量予以定义， 因此在需要时可以在您的
 	  <filename>Makefile</filename> 中加以改变。 当您需要在多个 port
 	  之间共享某些 <filename>pkg-*</filename> 文件，
 	  或需要写入某些文件时就非常有用了。 (参见 在
 	  <link linkend="porting-wrkdir">
 	  <varname>WRKDIR</varname></link> 以外的地方写文件，
 	  以了解为什么直接将变更写入 <filename>pkg-*</filename>
 	  子目录是个糟糕的主意)</para>
 
 	<para>下面是一组变量以及它们的默认值 (<varname>PKGDIR</varname> 默认情况下是
 	  <varname>${MASTERDIR}</varname>。)</para>
 
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>变量</entry>
 		<entry>默认值</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><varname>DESCR</varname></entry>
 		<entry><literal>${PKGDIR}/pkg-descr</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>PLIST</varname></entry>
 		<entry><literal>${PKGDIR}/pkg-plist</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>PKGINSTALL</varname></entry>
 		<entry><literal>${PKGDIR}/pkg-install</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>PKGDEINSTALL</varname></entry>
 		<entry><literal>${PKGDIR}/pkg-deinstall</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>PKGREQ</varname></entry>
 		<entry><literal>${PKGDIR}/pkg-req</literal></entry>
 	      </row>
 
 	      <row>
 		<entry><varname>PKGMESSAGE</varname></entry>
 		<entry><literal>${PKGDIR}/pkg-message</literal></entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
 
 	<para>请修改这些变量， 而不是直接覆盖
 	  <varname>PKG_ARGS</varname> 的值。 如果您改变了
 	  <varname>PKG_ARGS</varname>， 这些文件将无法在安装 port
 	  时正确地复制到 <filename>/var/db/pkg</filename> 目录。</para>
       </sect1>
 
       <sect1 xml:id="using-sub-files">
 	<title>使用 <varname>SUB_FILES</varname> 和
 	  <varname>SUB_LIST</varname></title>
 
 	<para><varname>SUB_FILES</varname> 和 <varname>SUB_LIST</varname>
 	  这两个变量可以用来在 port 文件中使用某些动态的值， 例如
 	  <filename>pkg-message</filename> 中的
 	  installation <varname>PREFIX</varname>。</para>
 
 	<para>用 <varname>SUB_FILES</varname> 变量，
 	  可以指定需要自动进行修改的文件列表。 在
 	  <varname>SUB_FILES</varname> 中的每一个
 	  <replaceable>文件</replaceable>，
 	  在 <varname>FILESDIR</varname> 目录中都必须有一个对应的
 	  <filename>文件.in</filename>。
 	  修改后的版本将保存在 <varname>WRKDIR</varname>。
 	  在 <varname>USE_RC_SUBR</varname> (或已经过时的
 	  <varname>USE_RCORDER</varname>) 中定义的文件会自动加入到
 	  <varname>SUB_FILES</varname> 中。 对于
 	  <filename>pkg-message</filename>、
 	  <filename>pkg-install</filename>、 <filename>pkg-deinstall</filename>
 	  and <filename>pkg-req</filename>， 对应的 Makefile 变量会被自动设置，
 	  以指向处理过的版本。</para>
 
 	<para><varname>SUB_LIST</varname> 这个变量的内容是一系列
 	  <literal>VAR=VALUE</literal> 对。 <varname>SUB_FILES</varname>
 	  所列出的文件中所有的
 	  <literal>%%VAR%%</literal> 都将被替换为
 	  <literal>VALUE</literal>。 系统自动定义了一些常用的替换对，
 	  包括： <varname>PREFIX</varname>、
 	  <varname>LOCALBASE</varname>、
 	  <varname>DATADIR</varname>、 <varname>DOCSDIR</varname>， 以及
 	  <varname>EXAMPLESDIR</varname>。 替换结果中所有以
 	  <literal>@comment</literal> 开头的行，
 	  都将在变量替换之后被删去。</para>
 
 	<para>下面的例子中， 将把 <filename>pkg-message</filename>
 	  中的 <literal>%%ARCH%%</literal> 替换为系统所运行的架构名称：</para>
 
 	<programlisting>SUB_FILES=     pkg-message
 SUB_LIST=      ARCH=${ARCH}</programlisting>
 
 	<para>注意， 在上述例子中， <varname>FILESDIR</varname>
 	  里必须有 <filename>pkg-message.in</filename> 这个文件。</para>
 
 	<para>下面是一个正确的 <filename>pkg-message.in</filename> 例子：</para>
 
 	<programlisting>Now it is time to configure this package.
 Copy %%PREFIX%%/share/examples/putsy/%%ARCH%%.conf into your home directory
 as .putsy.conf and edit it.</programlisting>
 
       </sect1>
     </chapter>
 
   <chapter xml:id="testing">
     <title>测试您的 port</title>
 
       <sect1 xml:id="make-describe">
 	<title>运行 <command>make describe</command></title>
 
 	<para>许多 &os; port 维护工具， 例如
 	  &man.portupgrade.1;， 会依赖于一个名为
 	  <filename>/usr/ports/INDEX</filename> 的数据库的正确性，
 	  它提供了关于 port 的相关信息， 例如依赖关系等等。
 	  <filename>INDEX</filename> 是由顶级的
 	  <filename>ports/Makefile</filename> 通过
 	  <command>make index</command> 来建立的， 这个命令会进入每一个 port
 	  的子目录， 并在那里执行 <command>make describe</command>。
 	  因此， 如果某个 port 的 <command>make describe</command> 失败，
 	  就没有人能生成 <filename>INDEX</filename>，
 	  人们很快会变得不高兴。</para>
 
 	<note>
 	  <para>无论在 <filename>make.conf</filename> 中设置了什么选项，
 	  这个文件都应能够正确地生成。 因此，
 	  应避免在 (例如) 某个依赖关系无法满足时使用 <literal>.error</literal>。
 	  (参见 <xref linkend="dads-dot-error"/>。)</para>
 	</note>
 
 	<para>如果 <command>make describe</command> 只是产生一个字符串，
 	  而不是错误信息， 可能就没什么问题。 请参见
 	  <filename>bsd.port.mk</filename> 以了解所生成的串的意义。</para>
 
 	<para>最后要说明的是， 新版本的
 	  <command>portlint</command> (在下一节中将进行介绍)
 	  将会自动地运行 <command>make describe</command>。</para>
       </sect1>
 
       <sect1 xml:id="testing-portlint">
 	<title>Portlint</title>
 
 	<para>在提交或 commit 之前， 应使用 <link linkend="porting-portlint"><command>portlint</command></link>
 	  来进行检查。 <command>portlint</command> 会对常见的、
 	  包括功能上的和格式上的错误给出警告。 对于新的 (或在 repocopy 代码库中复制的)
 	  port， <command>portlint -A</command> 可以完成全面检查；
 	  对于暨存的 port， <command>portlint -C</command> 一般就足够了。</para>
 
 	<para>由于 <command>portlint</command> 采用启发式方法来检查错误，
 	  有时它会产生误警。 另外， 有时由于 port
 	  框架的限制可能没有办法修正它指出的问题。 如果您有疑虑，
 	  请写信询问 &a.ports;。</para>
       </sect1>
 
       <sect1 xml:id="testing-porttools">
 	<title>使用 Port Tools 来完成测试</title>
 
 	<para>在 Ports 套件中， 提供了一个 <package>ports-mgmt/porttools</package>
           程序。</para>
 
 	<para><command>port</command> 是一个能够帮助您简化测试工具的前端脚本。
 	  如果希望对新增的 port 或更新 port 时进行测试， 可以用
 	  <command>port test</command> 来完成这些测试工作， 这也包含了
 	  <link linkend="testing-portlint"><command>portlint</command></link>
 	  检查。 这个命令会检测并列出没有在 <filename>pkg-plist</filename> 中列出的文件。
 	  具体用法请参见下面的例子：</para>
 
 	<screen>&prompt.root; <userinput>port test /usr/ports/net/csup</userinput></screen>
       </sect1>
 
       <sect1 xml:id="porting-prefix">
 	<title><varname>PREFIX</varname> (安装时的顶级目录名) 和 <varname>DESTDIR</varname></title>
 
 	<para><varname>PREFIX</varname> 能够决定 port 安装时的目的位置。
 	  一般情况下这个位置是 <filename>/usr/local</filename>
 	  或 <filename>/opt</filename>， 但也可以设为其它的任意值。
 	  您的 port 则必须遵循这个变量。</para>
 
 	<para>除此之外， 如果用户配置了 <varname>DESTDIR</varname>，
 	  则表示希望将 port 安装到另一个环境， 通常是 jail
 	  或在 <filename>/</filename> 以外的其他位置挂接的系统中。
 	  实际上， port 会安装到
 	  <varname>DESTDIR</varname>/<varname>PREFIX</varname>，
 	  并注册到位于 <varname>DESTDIR</varname>/var/db/pkg
 	  的预编译包数据库中。 由于 <varname>DESTDIR</varname> 是由
 	  ports 框架藉由 &man.chroot.8; 来实现的， 您在撰写符合
 	  <varname>DESTDIR</varname> 规范的 ports 时并不需要什么额外的工作。</para>
 
 	<para>一般而言 <varname>PREFIX</varname> 会设为
 	  <varname>LOCALBASE_REL</varname> (默认是
 	  <filename>/usr/local</filename>)。 如果设置了
 	  <varname>USE_LINUX_PREFIX</varname>， 则 <varname>PREFIX</varname>
 	  会设为 <varname>LINUXBASE_REL</varname> (默认是
 	  <filename>/compat/linux</filename>)。</para>
 
 	<para>避免将 <filename>/usr/local</filename> 或
 	  <filename>/usr/X11R6</filename> 硬编码到源代码中，
 	  能够大大提高 port 的灵活性， 并适应不同环境的需要。
 	  对于使用 <command>imake</command> 的 X port，
 	  这一工作是自动完成的； 其他情况下， 通常可以简单地将 port
 	  所用到的 <filename>Makefile</filename> 脚本中出现的
 	  <filename>/usr/local</filename> (或对于没有使用 imake 的 X port 而言，
 	  <filename>/usr/X11R6</filename>) 替换为读取
 	  <varname>${PREFIX}</varname> 变量就能达到目的了，
 	  因为这个变量在联编和安装的过程中， 会自动向下传递。</para>
 
 	<para>一定要避免让您的 port 在
 	<filename>/usr/local</filename> 而不是正确的 <varname>PREFIX</varname>
 	中安装文件。 简单的测试方法是：</para>
 
 	<screen>&prompt.root; <userinput>make clean; make package PREFIX=/var/tmp/`make -V PORTNAME`</userinput></screen>
 
 	<para>如果有文件安装到了 <varname>PREFIX</varname> 以外的地方，
 	打包过程将抱怨找不到这些文件。</para>
 
 	<!-- XXX This paragraph is confusing and poorly indented. -->
 	<para>这一步骤并不能帮助发现内部引用， 或纠正在引用其它 port
 	中的文件时使用的 <varname>LOCALBASE</varname>。 您需要在
 	<filename>/var/tmp/`make -V PORTNAME`</filename>
 	中测试安装好的软件， 才能够达到这样的目的。</para>
 
 	<para>您可以在自己的 <filename>Makefile</filename> 中改变
 	  <varname>PREFIX</varname> 变量的值， 也可以通过用户环境变量来影响它。
 	  然而， 一般情况下决不应该在 <filename>Makefile</filename>
 	  中明确设置它的值。</para>
 
 	<para>此外， 引用其它 port 中的文件时， 应使用前面介绍的变量，
 	  而不要直接指定它们的路径名。 例如， 如果您的 port
 	  需要使用 <literal>PAGER</literal> 这个宏来指明
 	  <command>less</command> 的完整路径， 应使用下面的编译选项：
 
 	  <programlisting>-DPAGER=\"&dollar;{LOCALBASE}/bin/less\"</programlisting>
 
 	  而非
 	  <literal>-DPAGER=\"/usr/local/bin/less\"</literal>。
 	  这种方法能够增加在系统管理员把整个 <filename>/usr/local</filename>
 	  目录挪到其它位置时安装成功的机会。</para>
       </sect1>
 
       <sect1 xml:id="testing-tinderbox">
         <title>Tinderbox</title>
 
         <para>如果您是非常热心的 ports 参与者， 则可以看看 <application>Tinderbox</application>。
           这是一个强大的用于联编和测试 ports 的系统， 它基于
           <link linkend="build-cluster">Pointyhat</link> 的脚本。 您可以使用
           <package>ports-mgmt/tinderbox</package> port 来安装
           <application>Tinderbox</application>。 请一定仔细阅读随它安装的文档，
           因为配置并不简单。</para>
 
         <para>请访问 <link xlink:href="http://tinderbox.marcuscom.com/">Tinderbox 网站</link>
           以了解进一步的细节。</para>
 
       </sect1>
   </chapter>
 
     <chapter xml:id="port-upgrading">
       <title>升级一个 port</title>
 
       <para>如果您发现某个 port 相对原作者所发布的版本已经过时，
 	则首先需要确认的是您的 port 是最新的。 您可以在 &os; FTP 镜像的
 	<filename>ports/ports-current</filename> 目录中找到它们。
 	但是， 如果您正在使用较多的 port， 则可能使用
 	<application>CVSup</application> 来保持 Ports Collection 最新更为简单， 这在
 	<link xlink:href="&url.books.handbook;/synching.html#CVSUP-CONFIG">使用手册</link>
 	中进行了介绍。 此外， 这样做也有助于保持 port 依赖关系的正确性。</para>
 
       <para>下一步是检查是否已经有在等待的更新。 要完成这项工作，
 	可以采用下列两种方法之一。 有一个用于搜索
 	<link xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">
 	FreeBSD 问题报告 (PR) 数据库</link> (也被称作
 	<literal>GNATS</literal>)。 在下拉框中选择 <literal>ports</literal>，
 	然后输入 port 的名字。</para>
 
       <para>但是， 有些时候人们会忘记将避免混淆的 port 的名字放到 Synopsis 字段中。
 	这种时候， 您可以试试看 <link linkend="portsmon">
 	FreeBSD Ports 监视系统</link> (也被叫做
 	<literal>portsmon</literal>)。 这个系统会尝试按照 port 的名字来进行分类。
 	要搜索和某个特定 port 有关的 PR， 可以使用 <link xlink:href="http://portsmon.FreeBSD.org/portoverview.py">
 	port概览</link>。</para>
 
       <para>如果没有候审的 PR， 下一步是给 port 的维护者写信， 这可以通过执行
 	<command>make maintainer</command> 看到。 这个人可能正在进行升级工作，
 	或者由于某种理由暂时没有升级 (例如， 新版本有稳定性问题)；
 	一般您不希望重复他们的工作。 注意没有维护者的 port 的维护者会显示为
 	<literal>ports@FreeBSD.org</literal>， 这是一般性 port 问题的邮件列表，
 	因此发邮件给它一般没什么意义。</para>
 
       <para>如果维护者要求您去完成升级， 或者没有维护者，
 	您就有机会通过自行完成升级来帮助 &os; 了！ 请使用基本系统提供的
 	&man.diff.1; 命令来完成相关的工作。</para>
 
       <para>如果只修改一个文件， 可以直接使用 <command>diff</command>
 	来生成补丁， 将需要修改的文件复制成 <replaceable>something.orig</replaceable>，
 	并将改动放进 <replaceable>something</replaceable>，
 	接着生成补丁：</para>
 
       <informalexample>
 	<screen>&prompt.user; <userinput>/usr/bin/diff something.orig something &gt; something.diff</userinput></screen>
       </informalexample>
 
       <para>如果不是这样的话， 则您应使用 <command>cvs diff</command>
 	的方法 (<xref linkend="cvs-diff"/>)， 或将目录整个复制到另一个目录，
 	并使用 &man.diff.1; 比较两个目录时在目录中递归产生的输出结果
 	(例如， 如果您修改后的 port 目录的名字是
 	<filename>superedit</filename> 而原始文件的目录是
 	<filename>superedit.bak</filename>， 则应保存
 	<command>diff -ruN superedit.bak superedit</command> 的结果)。
 	一致式 (unified) 或 上下文式 (context) diff 都是可以的，
 	但一般来说 port committer 会更喜欢一致式 diff。
 	请注意这里使用的选项 <literal>-N</literal>， 它的目的是强制 diff
 	正确地处理出现新文件， 或老文件被删除的情形。 在把 diff 发给我们之前，
 	请再次检查输出， 以便确认每一个修改都是有意义的。 (特别注意，
 	在对比目录之前要用 <command>make clean</command> 清理一下)。</para>
 
      <para>为了简化常用的补丁文件操作， 您可以使用
 	<filename>/usr/ports/Tools/scripts/patchtool.py</filename>。
 	使用之前， 请首先阅读
 	<filename>/usr/ports/Tools/scripts/README.patchtool</filename>。</para>
 
       <para>如果 port 目前还无人维护， 而且您自己经常使用它，
 	请考虑自荐为它的维护者。 &os; 有超过 4000 个没有维护者的 port，
 	而这正是最需要志愿人员的领域。
 	(要了解关于维护者的任务描述， 请参见
 	<link xlink:href="&url.books.developers-handbook;/policies.html#POLICIES-MAINTAINER">
 	开发手册中的相关部分</link>。)</para>
 
       <para>将 diff 发送给我们的最佳方式是通过 &man.send-pr.1; (category 一栏写
 	<literal>ports</literal>)。 如果您正维护那个 port，
 	请务必在 synopsis 的开头写上 <literal>[maintainer update]</literal>，
 	并将您的 PR 的 <quote>Class</quote> 设置为 <literal>maintainer-update</literal>。
 	反之， 您的 PR 的 <quote>Class</quote> 就应该是
 	<literal>change-request</literal>。 请在信中逐个提及每一个删除或增加的文件，
 	因为这些都必须明确地在使用 &man.cvs.1; 进行 commit 时明确地指定。
 	如果 diff 超过了 20K， 请考虑压缩并对其进行 uuencode；
 	否则， 简单地将其原样加入 PR 即可。</para>
 
       <para>在您 &man.send-pr.1; 之前， 请再次阅读 Problem
 	Reports 一文中的
 	<link xlink:href="&url.articles.problem-reports;/pr-writing.html">
 	如何撰写问题报告</link> 小节；
 	它给出了丰富的关于如何撰写更好的问题报告的介绍。</para>
 
       <important>
 	<para>如果您的更新是由于安全考虑， 或修复已经 commit 的 port
 	  中的严重问题， 请通知 &a.portmgr; 来申请立即重建和分发您的 port
 	  的 package。 否则， 不愿怀疑的使用 &man.pkg.add.1; 的用户，
 	  可能会在未来数周之内继续通过使用 <command>pkg_add -r</command>
 	  安装旧版本。</para>
       </important>
 
       <note>
 	<para>再次强调， 请使用 &man.diff.1; 而非 &man.shar.1; 来发送现有
 	  port 的更新！ 这可以帮助 ports committer 理解需要修改的内容。</para>
       </note>
 
       <para>现在您已经了解了所需的所有操作， 您可能会像要阅读在
 	<xref linkend="keeping-up"/> 中关于如何保持最新的描述。</para>
 
       <sect1 xml:id="cvs-diff">
 	<title>使用 CVS 制作补丁</title>
 
 	<para>如果可能的话， 请提交&man.cvs.1; diff；
 	  这种情形要比直接比较 <quote>新、旧</quote> 目录要容易处理。
 	  此外， 这种方法也让您更容易看出到底改了什么，
 	  并在其他人更新了 Ports Collection 时容易合并这些改动，
 	  在提交之前， 这可以减少维护补丁所需的工作。</para>
 
 	<screen>&prompt.user; <userinput>cd ~/my_wrkdir</userinput> <co xml:id="my-wrkdir"/>
 &prompt.user; <userinput>cvs -d R_CVSROOT co pdnsd</userinput> <co xml:id="R-CVSROOT"/> <co xml:id="module-name"/>
 &prompt.user; <userinput>cd ~/my_wrkdir/pdnsd</userinput></screen>
 
 	<calloutlist>
 	  <callout arearefs="my-wrkdir">
 	    <para>当然， 这可以是您指定的任意目录；
 	      联编 port 并不局限于
 	      <filename>/usr/ports/</filename>
 	      的子目录。</para>
 	  </callout>
 
 	  <callout arearefs="R-CVSROOT">
 	    <para>R_CVSROOT 是任何一个公共的 cvs 镜像服务器， 您可以在 <link xlink:href="&url.books.handbook;/cvsup.html">&os; 使用手册</link>
 	      中挑选一个。</para>
 	  </callout>
 
 	  <callout arearefs="module-name">
 	    <para>pdnsd 是 port 的模块名字； 通常说来它和 port 的名字一样，
 	      不过也有些例外， 特别是那些本地化类别 (<package>german/selfhtml</package>
 	      对应的模块名字是 de-selfhtml)； 您可以通过 <link xlink:href="&url.base;/cgi/cvsweb.cgi/ports">cvsweb 界面</link>
 	      查询， 或者也可以指定完整路径， 例如在我们这个例子中是
 	      <filename>ports/dns/pdnsd</filename>。</para>
 	  </callout>
 	</calloutlist>
 
 	<para>在工作目录中， 您可以像往常一样进行任何更改。
 	  如果您添加或删除了文件， 则需要告诉
 	  <command>cvs</command> 来追踪这些改动：</para>
 
 	<screen>&prompt.user; <userinput>cvs add new_file</userinput>
 &prompt.user; <userinput>cvs remove deleted_file</userinput></screen>
 
 	<para>请反复检查 <xref linkend="porting-testing"/> 列出的事项并使用
 	  <xref linkend="porting-portlint"/> 进行检查。</para>
 
 	<screen>&prompt.user; <userinput>cvs status</userinput>
 &prompt.user; <userinput>cvs update</userinput> <co xml:id="cvs-update"/></screen>
 
 	<calloutlist>
 	  <callout arearefs="cvs-update">
 	    <para>这会合并 CVS 中其他人做的改动和您的补丁；
 	      在这个过程中， 您需要仔细观察输出。
 	      文件名前面的那个字母会显示做了什么， 请参阅
 	      <xref linkend="table-cvs-up"/> 中给出的说明。</para>
 	  </callout>
 	</calloutlist>
 
 	<table pgwide="1" frame="none" xml:id="table-cvs-up">
 	  <title>cvs update 文件名前字母前缀的含义</title>
 
 	  <tgroup cols="2">
 	    <tbody>
 	      <row>
 		<entry>U</entry>
 
 		<entry>文件更新无误。</entry>
 	      </row>
 
 	      <row>
 		<entry>P</entry>
 
 		<entry>文件更新无误 (通常只有在使用远程代码库时才会看到)。</entry>
 	      </row>
 
 	      <row>
 		<entry>M</entry>
 
 		<entry>文件有本地修改， 并合并成功而未产生任何冲突。</entry>
 	      </row>
 
 	      <row>
 		<entry>C</entry>
 
 		<entry>文件有本地修改， 进行了合并并产生了冲突。</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</table>
 
 	<para>如果您在执行
 	  <literal>cvs update</literal> 时某些文件出现了 <literal>C</literal>，
 	  则说明有其他人在 CVS 中做了修改， 而 &man.cvs.1; 无法将这些改动与您本地的改动进行合并。
 	  不过， 无论如何， 最好都检查一下合并的结果，
 	  因为 <command>cvs</command> 并不知道 port 应该是什么样子，
 	  因此它所做的合并无论是否产生了冲突，
 	  都有可能 (并且并不罕见) 产生没有意义的结果。</para>
 
 	<para>最后一步是以 CVS 中的文件为基础生成 unified &man.diff.1;：</para>
 
 	<screen>&prompt.user; <userinput>cvs diff -uN &gt; ../`basename ${PWD}`.diff</userinput></screen>
 
 	<note>
 	  <para>指定 <option>-N</option> 十分重要，
 	    因为它确保了添加或删除的文件也出现在补丁中。
 	    补丁将包含删除的文件， 在打上补丁时，
 	    这些文件会被清空， 所以最好在 PR 中提醒 committer
 	    删除它们。</para>
 	</note>
 
 	<para>根据 <xref linkend="port-upgrading"/> 的指导提交您的补丁。</para>
       </sect1>
 
       <sect1 xml:id="moved-and-updating-files">
 	<title>UPDATING 和 MOVED 文件</title>
 
 	<para>如果在升级 port 时需要类似修改配置文件或运行特定的程序这样的特别步骤，
 	  则应在
 	  <filename>/usr/ports/UPDATING</filename> 文件中予以说明。
 	  这个文件中的项目格式如下：</para>
 
 	<programlisting>YYYYMMDD:
   AFFECTS: users of port类别/port名字
   AUTHOR: 您的名字 &lt;您的电子邮件地址&gt;
 
   所需执行的特别步骤</programlisting>
 
 	<para>如果您需要在内文中加入具体的 portmaster 或 portupgrade
 	  的说明， 请确保所用的 shell 命令使用了正确的转义字符。</para>
 
 	<para>如果 port 被删除或改名，则应在
 	  <filename>/usr/ports/MOVED</filename> 中添加相应的说明项目。
 	  这个文件中的项目格式如下：</para>
 
 	<programlisting>原来的名字|新名字 (如果删除则应留空)|删除或改名的日期|原因</programlisting>
       </sect1>
     </chapter>
 
     <chapter xml:id="security">
       <title>Ports 的安全</title>
 
       <sect1 xml:id="security-intro">
 	<title>安全为何如此重要</title>
 
 	<para>软件中偶尔会引入 bug。 毋庸置疑， 安全漏洞是最为危险的。
 	  从技术角度看， 这些漏洞可以通过消除导致它们的 bug 来修复。
 	  然而， 处理一般的 bug 和安全漏洞的策略是截然不同的。</para>
 
 	<para>典型的小 bug 通常只影响那些启用了某些能够触发它的选项组合的用户。
 	  开发人员最终会在发布没有那个问题的新版之后给出一个补丁来修正它，
 	  而用户中的主体并不会立即升级， 因为他们并没有因存在问题而感到苦恼。
 	  严重的 bug 可能会导致数据丢失和其它问题， 无论如何，
 	  谨慎的用户知道， 除了软件 bug 之外还有很多其它事故可能会导致数据丢失，
 	  因此他们会备份重要数据； 此外， 严重的 bug 通常会被很快发现。</para>
 
 	<para>安全漏洞则完全不同。 第一， 它们可能存在数年而不被发现，
 	  因为它们可能并不导致软件无法正常工作。 第二， 通过利用漏洞，
 	  恶意的一方可能会得到未获授权的访问权限，
 	  并利用这些权限毁掉或修改敏感数据；
 	  而更糟糕的情况则是用户可能根本注意不到损害已经发生。 第三，
 	  暴露出安全漏洞的系统， 往往能够帮助攻击者闯入其它之前不可能进入的系统。
 	  因此， 只是修正安全漏洞是不够的： 必须以清晰和全面的方式通知公众，
 	  这样他们就能够评估风险， 并采取适当的措施。</para>
       </sect1>
 
       <sect1 xml:id="security-fix">
 	<title>修复安全漏洞</title>
 
 	<para>当说起 port 或 package 时， 安全漏洞往往是出现在原作者的发行包，
 	  或移植过程中加入的文件里。 对于前一种情况，
 	  软件的原作者通常会立刻发布一个补丁甚至新版，
 	  您只需要按照原作者的修正去更新 port 就可以了。
 	  如果由于某种原因修正被延误， 则要么 <link linkend="dads-noinstall">将
 	  port 标记为 <varname>FORBIDDEN</varname></link>， 要么在 port
 	  中加入一个自己的补丁。 如果有存在漏洞的 port， 尽可能尽快修复其漏洞就是。
 	  无论是哪种情况， 您还是需要按照 <link linkend="port-upgrading">标准的提交流程</link> 提交，
 	  除非您有直接在 ports tree 上 commit 的权限。</para>
 
 	<important>
 	  <para>作为 ports committer 并不能够随便 commit 所有 port。
 	    请注意通常 port 都有维护者， 而他们应得到您的尊重。</para>
 	</important>
 
 	<para>在漏洞被修正之后， 一定要同时增加 port 的修订版本号。
 	  这样， 规律性地升级安装的 package 的用户就能够看到他们需要进行升级。
 	  另外， 还应联编预编译的安装包， 并通过 FTP 和 WWW 镜像发布，
 	  以取代有漏洞的版本。 注意要增加
 	  <varname>PORTREVISION</varname> 数字， 除非在修正问题时
 	  <varname>PORTVERSION</varname> 发生了变化。 一般来说，
 	  如果在 port 中增加了补丁文件， 就应该增加 <varname>PORTREVISION</varname>，
 	  但例外的例子是您已经将软件升级到了最新版，
 	  因为这时已经改掉 <varname>PORTVERSION</varname> 了。 请参见
 	  <link linkend="makefile-naming-revepoch">相关小节</link>
 	  以了解进一步的信息。</para>
       </sect1>
 
       <sect1 xml:id="security-notify">
 	<title>通知整个用户群体</title>
 
 	<sect2 xml:id="security-notify-vuxml-db">
 	  <title>VuXML 数据库</title>
 
 	  <para>当发现了安全漏洞时的一项重要而紧迫的步骤，
 	    就是让使用 port 的用户群了解其危险。 这类通知有两重目的。
 	    首先， 如果危害真的很严重， 可能理性的办法就是立即应用一项缓解措施，
 	    例如， 停止受到影响的服务， 甚至完全删除 port， 直到问题被修正为止。
 	    其次， 许多用户只是偶尔升级所安装的软件包， 通过通知，
 	    他们能够知道已经到了 <emphasis>必须</emphasis> 更新软件的时候，
 	    因为已经有了修正这些问题的版本了。</para>
 
 	  <para>由于现有的 port 数量极其庞大， 为每一个问题都发布安全公告，
 	    毫无疑问地会发表和狼来了一样多的安全公告，
 	    并增大受众在真的发生严重的问题时忽略问题的可能。
 	    因此， 在 port 中发现的安全漏洞， 会在 <link xlink:href="http://vuxml.freebsd.org/">FreeBSD VuXML
 	    数据库</link> 中记录。 安全官团队成员会持续地追踪这个数据库的修改，
 	    以了解需要他们注意的内容。</para>
 
 	  <para>如果您是 committer， 则可以自行更新 VuXML 数据库。
 	    这样， 您就能够同时帮助安全官团队，
 	    并尽早将至关重要的信息传达给用户群体。 然而， 如果您不是 committer，
 	    或者您相信自己发现了一个异常严重的漏洞，
 	    请不要犹豫， 按照 <link xlink:href="http://www.freebsd.org/zh_CN/security/#how">FreeBSD
 	    安全信息</link> 页面上的方法联系安全官团队。</para>
 
 	  <para>正如其名称所暗示的那样， VuXML
 	    数据库是一个 XML 文档。 其源文件 <filename>vuln.xml</filename>
 	    被保存在 <package>security/vuxml</package> port 的目录中。
 	    所以， 它的全名是
 	    <filename>PORTSDIR/security/vuxml/vuln.xml</filename>。
 	    每当您发现 port 中的安全漏洞时， 请把新的纪录加入到那个文件中。
 	    在熟悉 VuXML 之前， 您最好先看看是否有类似的您发现的问题的其它记录，
 	    并复制它作为模板。</para>
 	</sect2>
 
 	<sect2 xml:id="security-notify-vuxml-intro">
 	  <title>VuXML 简介</title>
 
 	  <para>XML 是一个复杂的语言， 它远远超越了这本书的范围。
 	    不过， 只需了解标记的命名规则， 就能 VuXML 记录的结构有一个大体的了解了。
 	    XML 标记的名字应出现在一对尖括号之间。 每一个
 	    &lt;tag&gt; 必须有一个对应的 &lt;/tag&gt;。 标记可以嵌套，
 	    如果嵌套的话， 内层的标记必须在外层标记之前结束。
 	    这就形成了一个标记的层次结构， 也就是关于它们之间如何嵌套的规则。
 	    听起来很像 HTML， 是不是？ 最主要的区别在于， XML
 	    是可扩展的 (e<emphasis>X</emphasis>tensible)，
 	    例如通过定义新的标记等等。 由于其结构的内在性质，
 	    XML 能够赋予无组织的数据新的形态。 VuXML 是专门为描述安全漏洞设计的语言。</para>
 
 	  <para>现在让我们来观察一个实际的 VuXML 记录：</para>
 
 	  <programlisting>&lt;vuln vid="f4bc80f4-da62-11d8-90ea-0004ac98a7b9"&gt; <co xml:id="co-vx-vid"/>
   &lt;topic&gt;Several vulnerabilities found in Foo&lt;/topic&gt; <co xml:id="co-vx-top"/>
   &lt;affects&gt;
     &lt;package&gt;
       &lt;name&gt;foo&lt;/name&gt; <co xml:id="co-vx-nam"/>
       &lt;name&gt;foo-devel&lt;/name&gt;
       &lt;name&gt;ja-foo&lt;/name&gt;
       &lt;range&gt;&lt;ge&gt;1.6&lt;/ge&gt;&lt;lt&gt;1.9&lt;/lt&gt;&lt;/range&gt; <co xml:id="co-vx-rng"/>
       &lt;range&gt;&lt;ge&gt;2.*&lt;/ge&gt;&lt;lt&gt;2.4_1&lt;/lt&gt;&lt;/range&gt;
       &lt;range&gt;&lt;eq&gt;3.0b1&lt;/eq&gt;&lt;/range&gt;
     &lt;/package&gt;
     &lt;package&gt;
       &lt;name&gt;openfoo&lt;/name&gt; <co xml:id="co-vx-nm2"/>
       &lt;range&gt;&lt;lt&gt;1.10_7&lt;/lt&gt;&lt;/range&gt; <co xml:id="co-vx-epo"/>
       &lt;range&gt;&lt;ge&gt;1.2,1&lt;/ge&gt;&lt;lt&gt;1.3_1,1&lt;/lt&gt;&lt;/range&gt;
     &lt;/package&gt;
   &lt;/affects&gt;
   &lt;description&gt;
     &lt;body xmlns="http://www.w3.org/1999/xhtml"&gt;
       &lt;p&gt;J. Random Hacker reports:&lt;/p&gt; <co xml:id="co-vx-bdy"/>
       &lt;blockquote
         cite="http://j.r.hacker.com/advisories/1"&gt;
         &lt;p&gt;Several issues in the Foo software may be exploited
           via carefully crafted QUUX requests.  These requests will
           permit the injection of Bar code, mumble theft, and the
           readability of the Foo administrator account.&lt;/p&gt;
       &lt;/blockquote&gt;
     &lt;/body&gt;
   &lt;/description&gt;
   &lt;references&gt; <co xml:id="co-vx-ref"/>
     &lt;freebsdsa&gt;SA-10:75.foo&lt;/freebsdsa&gt; <co xml:id="co-vx-fsa"/>
     &lt;freebsdpr&gt;ports/987654&lt;/freebsdpr&gt; <co xml:id="co-vx-fpr"/>
     &lt;cvename&gt;CAN-2010-0201&lt;/cvename&gt; <co xml:id="co-vx-cve"/>
     &lt;cvename&gt;CAN-2010-0466&lt;/cvename&gt;
     &lt;bid&gt;96298&lt;/bid&gt; <co xml:id="co-vx-bid"/>
     &lt;certsa&gt;CA-2010-99&lt;/certsa&gt; <co xml:id="co-vx-cts"/>
     &lt;certvu&gt;740169&lt;/certvu&gt; <co xml:id="co-vx-ctv"/>
     &lt;uscertsa&gt;SA10-99A&lt;/uscertsa&gt; <co xml:id="co-vx-ucs"/>
     &lt;uscertta&gt;SA10-99A&lt;/uscertta&gt; <co xml:id="co-vx-uct"/>
     &lt;mlist msgid="201075606@hacker.com"&gt;http://marc.theaimsgroup.com/?l=bugtraq&amp;amp;m=203886607825605&lt;/mlist&gt; <co xml:id="co-vx-mls"/>
     &lt;url&gt;http://j.r.hacker.com/advisories/1&lt;/url&gt; <co xml:id="co-vx-url"/>
   &lt;/references&gt;
   &lt;dates&gt;
     &lt;discovery&gt;2010-05-25&lt;/discovery&gt; <co xml:id="co-vx-dsc"/>
     &lt;entry&gt;2010-07-13&lt;/entry&gt; <co xml:id="co-vx-ent"/>
     &lt;modified&gt;2010-09-17&lt;/modified&gt; <co xml:id="co-vx-mod"/>
   &lt;/dates&gt;
 &lt;/vuln&gt;</programlisting>
 
 	  <para>标记的名字都是简单明了的， 下面我们来介绍一下需要由您填写的字段：</para>
 
 	  <calloutlist>
 	    <callout arearefs="co-vx-vid">
 	      <para>这是 VuXML 记录的顶级 tag。
 		它有一个强制性的字段， <literal>vid</literal>，
 		用于为此记录 (它包含的部分) 指定一个全局唯一标识符 (UUID)。
 		您应为每一个新的 vuXML 生成新的 UUID (而且别忘了要把模板中的
 		UUID 换成新的， 如果您不是从头开始的话)。 您可以使用 &man.uuidgen.1;
 		来生成 VuXML UUID。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-top">
 	      <para>关于问题的一句话描述。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-nam">
 	      <para>此处给出受到影响的 package 的名字。 可以给出多个名字，
 		因为可能有多个软件包基于同一个 master port 或软件产品。
 		这可能包括稳定和开发分支、 本地化版本，
 		以及提供了不同的编译时选项的 slave port。</para>
 
 	      <important>
 		<para>撰写 VuXML 记录时， 您有责任找到所有相关的包。 很多时候
 		  <literal>make search name=foo</literal> 是您的朋友。
 		  需要留意的通常包括：</para>
 
 		<itemizedlist>
 		  <listitem>
 		    <para><filename>foo</filename> port 的
 		      <filename>foo-devel</filename> 变体；</para>
 		  </listitem>
 
 		  <listitem>
 		    <para>包含不同后缀的其它变体， 例如
 		      <literal>-a4</literal> (对于和打印有关的软件包)，
 		      <literal>-without-gui</literal> (提供但禁用了 X
 		      支持的软件包)， 以及类似的其它情况；</para>
 		  </listitem>
 
 		  <listitem>
 		    <para><literal>jp-</literal>， <literal>ru-</literal>、
 		      <literal>zh-</literal>， 以及其它可能的本地化变体，
 		      它们通常可以在 Ports Collection 中相应的国家分类中找到。</para>
 		  </listitem>
 		</itemizedlist>
 	      </important>
 	    </callout>
 
 	    <callout arearefs="co-vx-rng">
 	      <para>受影响的 package 版本， 可以使用
 		<literal>&lt;lt&gt;</literal>, <literal>&lt;le&gt;</literal>,
 		<literal>&lt;eq&gt;</literal>, <literal>&lt;ge&gt;</literal>,
 		和 <literal>&lt;gt&gt;</literal> 表达成一个或多个版本及其范围。
 		注意给出的版本范围不应存在重叠。</para>
 
 	      <para>在描述范围的时候， <literal>*</literal> (星号)
 		表达最小的版本。 更具体地说，
 		<literal>2.*</literal> 小于 <literal>2.a</literal>。
 		因此， 星号可以用来匹配所有可能的
 		<literal>alpha</literal>、 <literal>beta</literal>，
 		以及 <literal>RC</literal> 版本。 例如，
 		<literal>&lt;ge&gt;2.*&lt;/ge&gt;&lt;lt&gt;3.*&lt;/lt&gt;</literal>
 		可以选择性地匹配每一个 <literal>2.x</literal> 的版本， 而
 		<literal>&lt;ge&gt;2.0&lt;/ge&gt;&lt;lt&gt;3.0&lt;/lt&gt;</literal>
 		显然不能， 因为它会漏掉
 		<literal>2.r3</literal> 而匹配
 		<literal>3.b</literal>。</para>
 
 	      <para>上面的例子指定了受影响的版本， 是包括 <literal>1.6</literal>
 		到 <literal>1.9</literal> 上下界的所有版本， 以及
 		<literal>2.x</literal> 在 <literal>2.4_1</literal> 之前的版本，
 		和 <literal>3.0b1</literal> 版。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-nm2">
 	      <para>受到影响的一组 package (本质上是 ports)
 		可以列在 <literal>&lt;affected&gt;</literal> 小节中。
 		如果多个软件产品都采用了同样的基础代码，
 		(比如说 FooBar、 FreeBar 和 OpenBar) 而且包含同样的 bug
 		或漏洞。 请注意列出多个名字时， 应该在一个
 		&lt;package&gt; 小节中完成。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-epo">
 	      <para>如果可能， 版本的范围应包括
 		<varname>PORTEPOCH</varname> 和
 		<varname>PORTREVISION</varname>。
 		务必注意， 根据加权规则， 带有非零 <varname>PORTEPOCH</varname>
 		的版本， 系统会认为比没有
 		<varname>PORTEPOCH</varname> 的版本高， 例如 <literal>3.0,1</literal>
 		高于 <literal>3.1</literal> 甚至
 		<literal>8.9</literal>。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-bdy">
 	      <para>关于问题的摘要性信息。 此处使用
 		XHTML。 务必要成对使用
 		<literal>&lt;p&gt;</literal> 和 <literal>&lt;/p&gt;</literal>。
 		可以使用较为复杂的标记， 但仅限于有助于让信息更准确和明了的修饰：
 		请不要过分地美化。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-ref">
 	      <para>这部分包含了相关的可供参考的文档。
 		请尽可能多提供参考文献。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-fsa">
 	      <para>指定
 		<link xlink:href="http://www.freebsd.org/security/#adv">FreeBSD
 		安全公告</link>。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-fpr">
 	      <para>指定
 		<link xlink:href="http://www.freebsd.org/support.html#gnats">FreeBSD
 		问题报告</link>。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-cve">
 	      <para>指定 <link xlink:href="http://www.cve.mitre.org/">Mitre
 		CVE</link> ID。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-bid">
 	      <para>指定
 		<link xlink:href="http://www.securityfocus.com/bid">SecurityFocus
 		Bug ID</link>。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-cts">
 	      <para>指定
 		<link xlink:href="http://www.cert.org/">US-CERT</link>
 		安全公告。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-ctv">
 	      <para>指定
 		<link xlink:href="http://www.cert.org/">US-CERT</link>
 		漏洞说明。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-ucs">
 	      <para>指定
 		<link xlink:href="http://www.cert.org/">US-CERT</link>
 		计算机安全警报。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-uct">
 	      <para>指定
 		<link xlink:href="http://www.cert.org/">US-CERT</link>
 		技术性计算机安全警报。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-mls">
 	      <para>指向邮件列表存档的 URL。
 		属性 <literal>msgid</literal> 是可选项，
 		用以指定某一封信的 message ID。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-url">
 	      <para>一般的 URL。 只有在没有其它更适合的参考文献时，
 		才应使用它。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-dsc">
 	      <para>问题被全面披露的日期
 		(<replaceable>YYYY-MM-DD</replaceable>)。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-ent">
 	      <para>记录加入到数据库中的日期
 		(<replaceable>YYYY-MM-DD</replaceable>)。</para>
 	    </callout>
 
 	    <callout arearefs="co-vx-mod">
 	      <para>记录最后一次被修改的日期
 		(<replaceable>YYYY-MM-DD</replaceable>)。 新记录不应包括这个字段。
 		只有在修改记录时才应加入它。</para>
 	    </callout>
 	  </calloutlist>
 	</sect2>
 
 	<sect2 xml:id="security-notify-vuxml-testing">
 	  <title>测试您对 VuXML 数据库所作的修改</title>
 
 	  <para>假定您打算撰写， 或已经写好了一个关于
 	    package <literal>clamav</literal> 的问题描述， 并且，
 	    已经知道 <literal>0.65_7</literal> 版本修正了这个问题。</para>
 
 	  <para>您需要做的准备工作， 是 <emphasis>安装</emphasis> 一个新版本的
 	    ports <package>ports-mgmt/portaudit</package> 程序、
 	    <package>ports-mgmt/portaudit-db</package>， 以及
 	    <package>security/vuxml</package>。</para>
 
 	  <note>
 	    <para>要运行 <command>packaudit</command>，
 	      您必须拥有其
 	      <filename>DATABASEDIR</filename>，
 	      通常是 <filename>/var/db/portaudit</filename>
 	      的写入权限。</para>
 
 	    <para>您可以通过
 	      <filename>DATABASEDIR</filename>
 	      环境变量来指定一个不同的位置。</para>
 
 	    <para>如果您的工作目录是
 	      <filename>${PORTSDIR}/security/vuxml</filename>
 	      以外的其它地方， 则应使用环境变量
 	      <filename>VUXMLDIR</filename>
 	      来指明
 	      <filename>vuln.xml</filename> 的位置。</para>
 	  </note>
 
 	  <para>首先， 检查一下是否已经有了关于这个漏洞的描述。
 	    如果已经有过这样的记录， 那么它将匹配较早版本的 package，
 	    <literal>0.65_6</literal>：</para>
 
 	  <screen>&prompt.user; <userinput>packaudit</userinput>
 &prompt.user; <userinput>portaudit clamav-0.65_6</userinput></screen>
 
 	  <para>如果什么都没有发现， 您就可以考虑写一个新的记录来描述这个漏洞了。
 	    现在可以生成一个新的 UUID (假设它是
 	    <literal>74a9541d-5d6c-11d8-80e3-0020ed76ef5a</literal>)，
 	    然后将您的新记录加入到 VuXML 数据库中。 接下来，
 	    用下面的命令来检查它是否符合语法：</para>
 
 	  <screen>&prompt.user; <userinput>cd ${PORTSDIR}/security/vuxml &amp;&amp; make validate</userinput></screen>
 
 	  <note>
 	    <para>您需要安装下列 package 中的至少一个：
 	      <package>textproc/libxml2</package>、
 	      <package>textproc/jade</package>。</para>
 	  </note>
 
 	  <para>接下来从 VuXML 文件重构 <command>portaudit</command> 数据库：</para>
 
 	  <screen>&prompt.user; <userinput>packaudit</userinput></screen>
 
 	  <para>要验证您新加入的项的 <literal>&lt;affected&gt;</literal>
 	    小节能够正确地匹配希望的 package， 可以使用下面的命令：</para>
 
 	  <screen>&prompt.user; <userinput>portaudit -f /usr/ports/INDEX -r 74a9541d-5d6c-11d8-80e3-0020ed76ef5a</userinput></screen>
 
 	  <note>
 	    <para>请参见 &man.portaudit.1; 以了解关于这个命令语法的更多细节。</para>
 	  </note>
 
 	  <para>请确信新添加的记录不会在输出中匹配不应匹配的项。</para>
 
 	  <para>现在检查您添加的记录所匹配的版本是否正确：</para>
 
 	  <screen>&prompt.user; <userinput>portaudit clamav-0.65_6 clamav-0.65_7</userinput>
 Affected package: clamav-0.65_6 (matched by clamav&lt;0.65_7)
 Type of problem: clamav remote denial-of-service.
 Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-0020ed76ef5a.html&gt;
 
 1 problem(s) found.</screen>
 
 	  <para>显然， 前一个版本会匹配， 而后一个不会。</para>
 
 	  <para>最后， 验证您从
 	    VuXML 数据库中能够正确地得到预期的网页效果：</para>
 
 	  <screen>&prompt.user; <userinput>mkdir -p ~/public_html/portaudit</userinput>
 &prompt.user; <userinput>packaudit</userinput>
 &prompt.user; <userinput>lynx ~/public_html/portaudit/74a9541d-5d6c-11d8-80e3-0020ed76ef5a.html</userinput></screen>
 	</sect2>
       </sect1>
     </chapter>
 
     <chapter xml:id="porting-dads">
       <title>该做什么和不该做什么</title>
 
       <sect1 xml:id="dads-intro">
 	<title>介绍</title>
 
       <para>这里是一些在移植软件时可能会遇到的常见问题。
 	您应按照这个列表检查自己的 port， 同样地，
 	您也可以帮助检查 <link xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">PR 数据库</link>
 	中由其它人提交的 port。 请按照在
 	<link xlink:href="&url.articles.contributing;/contrib-how.html#CONTRIB-GENERAL">问题报告和一般性注释</link> 中介绍的方法提交您的看法。
 	帮助检查 PR 数据库中的 ports 即能够帮助我们更快地 commit 它们，
 	也能证明您清楚地了解如何完成这些工作。</para>
       </sect1>
 
       <sect1 xml:id="porting-wrkdir">
 	<title><varname>WRKDIR</varname> (联编时使用的临时目录)</title>
 
 	<para>任何时候都不要在
 	  <varname>WRKDIR</varname> 以外的位置写文件。 <varname>WRKDIR</varname>
 	  是在 port 联编过程中唯一的一处一定可写的地方 (参见
 	  <link xlink:href="&url.books.handbook;/ports-using.html#PORTS-CD">如何从
 	  CDROM 安装 port</link> 以了解从只读的目录中联编和安装 port 的例子)。
 	  如果您需要改变 <filename>pkg-*</filename>
 	  文件， 请按照 <link linkend="porting-pkgfiles">重新定义某个变量</link> 介绍的方法，
 	  而不是覆盖它们来实现。</para>
       </sect1>
 
       <sect1 xml:id="porting-wrkdirprefix">
 	<title><varname>WRKDIRPREFIX</varname> (用于联编的临时目录的父目录名)</title>
 
 	<para>一定要确保您的 port 尊重 <varname>WRKDIRPREFIX</varname> 的设置。
 	  绝大多数 port 并不需要担心这个。 具体说来，
 	  当引用其它 port 的 <varname>WRKDIR</varname> 时，
 	  需要注意正确的位置应该是
 	  <filename>WRKDIRPREFIXPORTSDIR/subdir/name/work</filename>
 	  而不是 <filename>PORTSDIR/subdir/name/work</filename> 或 <filename>.CURDIR/../../subdir/name/work</filename>，
 	  或别的什么。</para>
 
 	<para>另外， 如果您自行定义了 <varname>WRKDIR</varname>， 也要把
 	  <literal>&dollar;{WRKDIRPREFIX}&dollar;{.CURDIR}</literal> 放到前面。</para>
       </sect1>
 
       <sect1 xml:id="porting-versions">
 	<title>区分不同的操作系统， 以及 OS 的版本</title>
 
 	<para>在不同版本的 Unix 下可能需要对代码进行一些修改或增加少许编译选项，
 	  才能够正确地编译和运行。 如果您需要根据一些条件来对代码进行修改，
 	  请尽可能让这些修改通用， 这样， 我们就能够将这些代码移植回更早的 FreeBSD
 	  系统， 并交叉移植到其它 BSD 系统， 例如来自 CSRG 的 4.4BSD，
 	  BSD/386， 386BSD， NetBSD 和 OpenBSD。</para>
 
 	<para>推荐的获得 4.3BSD/Reno (1990) 以及更新版本 BSD 代码版本号的方式， 是使用
 	  <link xlink:href="http://cvsweb.freebsd.org/src/sys/sys/param.h">sys/param.h</link>
 	  中所定义的 <literal>BSD</literal> 宏的值。 一般来说这个文件已经被引用了；
 	  如果没有的话， 增加下述代码：</para>
 
 	<programlisting>#if (defined(__unix__) || defined(unix)) &amp;&amp; !defined(USG)
 #include &lt;sys/param.h&gt;
 #endif</programlisting>
 
 	<para>到 <filename>.c</filename> 文件中合适的地方。
 	  我们相信所有定义了这两个符号的系统中， 都提供了
 	  <filename>sys/param.h</filename>。 如果您发现有不这样做的系统，
 	  请通过致信 &a.ports; 让我们了解这一情况。</para>
 
 	<para>另一种方法是使用 GNU Autoconf 风格的方式：</para>
 
 	<programlisting>#ifdef HAVE_SYS_PARAM_H
 #include &lt;sys/param.h&gt;
 #endif</programlisting>
 
 	<para>采用这种方法时， 不要忘了把 <literal>-DHAVE_SYS_PARAM_H</literal> 加到
 	  <filename>Makefile</filename> 中的 <varname>CFLAGS</varname> 里。</para>
 
 	<para>一旦引用了 <filename>sys/param.h</filename>， 您就可以使用：</para>
 
 	<programlisting>#if (defined(BSD) &amp;&amp; (BSD &gt;= 199103))</programlisting>
 
 	<para>来检测代码是否正在 4.3 Net2 代码基础，
 	  或更新的系统上编译 (例如 FreeBSD 1.x， 4.3/Reno， NetBSD 0.9， 386BSD，
 	  BSD/386 1.1 以及更高版本)。</para>
 
 	<para>使用：</para>
 
 	<programlisting>#if (defined(BSD) &amp;&amp; (BSD &gt;= 199306))</programlisting>
 
 	<para>来检测代码是否正在 4.4 或更新的系统 (例如 FreeBSD 2.x， 4.4，
 	  NetBSD 1.0、 BSD/386 2.0 或更高版本)。</para>
 
 	<para>对于 4.4BSD-Lite2 代码系来说， <literal>BSD</literal> 宏的值应该是
 	  <literal>199506</literal>。 这里只是作为信息提供，
 	  您不应使用它来区分基于 4.4-Lite 的 FreeBSD 和基于 4.4-Lite2 的版本。
 	  这些情况下， 您应使用
 	  <literal>__FreeBSD__</literal> 宏。</para>
 
 	<para>保守地使用：</para>
 
 	<itemizedlist>
 	  <listitem>
 	    <para><literal>__FreeBSD__</literal> 在所有版本的
 	      FreeBSD 中皆有定义。 如果您正进行的修改
 	      <emphasis>只</emphasis> 影响 FreeBSD， 则应使用这个宏。
 	      类似 <literal>sys_errlist[]</literal> 之于
 	      <function>strerror()</function> 这样的移植问题是伯克利代码系公用的，
 	      而并非 FreeBSD 所专有。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>在 FreeBSD 2.x 中， <literal>__FreeBSD__</literal>
 	      定义为 <literal>2</literal>。 更早版本中， 它曾经是
 	      <literal>1</literal>。 新的版本都会在主要的版本号变化时变更它。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>如果您需要区分 FreeBSD 1.x 系统和 FreeBSD 2.x 及更高版本的区别，
 	      通常应使用前述的 <literal>BSD</literal> 宏来进行。
 	      如果事实上需要一个 FreeBSD 专有的修改 (例如，
 	      在使用 <command>ld</command> 时需要特殊的共享库选项)，
 	      则可以用 <literal>__FreeBSD__</literal> 和 <literal>#if
 		__FreeBSD__ &gt; 1</literal> 来检测 FreeBSD 2.x 和新系统上的变化。
 	      如果需要更细粒度地检测 FreeBSD 2.0-RELEASE 之后版本的变化，
 	      则可以使用：</para>
 
 	    <programlisting>#if __FreeBSD__ &gt;= 2
 #include &lt;osreldate.h&gt;
 #    if __FreeBSD_version &gt;= 199504
 	 /* 适用于 2.0.5+ 版本的代码 */
 #    endif
 #endif</programlisting>
 	  </listitem>
 	</itemizedlist>
 
 	<para>在已有的数百个 port 中， 只有一两个应该使用 <literal>__FreeBSD__</literal>。
 	  早期的 port 在不适当的地方使用了它并引发问题，
 	  并不意味着您也必定如此。</para>
       </sect1>
 
       <sect1 xml:id="freebsd-versions">
 	<title>__FreeBSD_version 值</title>
 
 	  <para>下面是在 <link xlink:href="http://cvsweb.freebsd.org/src/sys/sys/param.h">sys/param.h</link>
 	    <literal>__FreeBSD_version</literal> 中定义的值及其意义的列表，
 	    这里给出以方便您查阅：</para>
 
 		<table frame="none">
 		  <title>__FreeBSD_version 值</title>
 		<tgroup cols="3">
 		<thead>
 		  <row>
                     <entry>值</entry>
                     <entry>日期</entry>
 		    <entry>版本</entry>
 		  </row>
 		</thead>
 
 		<tbody>
 		  <row>
 		    <entry>119411</entry>
 		    <entry/>
 		    <entry>2.0-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>199501, 199503</entry>
 		    <entry>March 19, 1995</entry>
 		    <entry>2.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>199504</entry>
 		    <entry>April 9, 1995</entry>
 		    <entry>2.0.5-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>199508</entry>
 		    <entry>August 26, 1995</entry>
 		    <entry>2.1 之前的 2.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>199511</entry>
 		    <entry>November 10, 1995</entry>
 		    <entry>2.1.0-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>199512</entry>
 		    <entry>November 10, 1995</entry>
 		    <entry>2.1.5 之前的 2.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>199607</entry>
 		    <entry>July 10, 1996</entry>
 		    <entry>2.1.5-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>199608</entry>
 		    <entry>July 12, 1996</entry>
 		    <entry>2.1.6 之前的 2.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>199612</entry>
 		    <entry>November 15, 1996</entry>
 		    <entry>2.1.6-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>199612</entry>
 		    <entry/>
 		    <entry>2.1.7-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>220000</entry>
 		    <entry>February 19, 1997</entry>
 		    <entry>2.2-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>(not changed)</entry>
 		    <entry/>
 		    <entry>2.2.1-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>(无变化)</entry>
 		    <entry/>
 		    <entry>在 2.2.1-RELEASE 之后的 2.2-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>221001</entry>
 		    <entry>April 15, 1997</entry>
 		    <entry>texinfo-3.9 之后的 2.2-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>221002</entry>
 		    <entry>April 30, 1997</entry>
 		    <entry>top 之后的 2.2-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>222000</entry>
 		    <entry>May 16, 1997</entry>
 		    <entry>2.2.2-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>222001</entry>
 		    <entry>May 19, 1997</entry>
 		    <entry>2.2.2-RELEASE 之后的 2.2-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>225000</entry>
 		    <entry>October 2, 1997</entry>
 		    <entry>2.2.5-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>225001</entry>
 		    <entry>November 20, 1997</entry>
 		    <entry>2.2.5-RELEASE 之后的 2.2-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>225002</entry>
 		    <entry>December 27, 1997</entry>
 		    <entry>合并 ldconfig -R 之后的 2.2-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>226000</entry>
 		    <entry>March 24, 1998</entry>
 		    <entry>2.2.6-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>227000</entry>
 		    <entry>July 21, 1998</entry>
 		    <entry>2.2.7-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>227001</entry>
 		    <entry>July 21, 1998</entry>
 		    <entry>2.2.7-RELEASE 之后的 2.2-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>227002</entry>
 		    <entry>September 19, 1998</entry>
 		    <entry>&man.semctl.2; 修改之后的 2.2-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>228000</entry>
 		    <entry>November 29, 1998</entry>
 		    <entry>2.2.8-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>228001</entry>
 		    <entry>November 29, 1998</entry>
 		    <entry>2.2.8-RELEASE 之后的 2.2-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>300000</entry>
 		    <entry>February 19, 1996</entry>
 		    <entry>&man.mount.2; 修改之前的 3.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>300001</entry>
 		    <entry>September 24, 1997</entry>
 		    <entry>&man.mount.2; 修改之后的 3.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>300002</entry>
 		    <entry>June 2, 1998</entry>
 		    <entry>&man.semctl.2; 修改之后的 3.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>300003</entry>
 		    <entry>June 7, 1998</entry>
 		    <entry>ioctl 参数变化之后的 3.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>300004</entry>
 		    <entry>September 3, 1998</entry>
 		    <entry>ELF 变换之后的 3.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>300005</entry>
 		    <entry>October 16, 1998</entry>
 		    <entry>3.0-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>300006</entry>
 		    <entry>October 16, 1998</entry>
 		    <entry>3.0-RELEASE 之后的 3.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>300007</entry>
 		    <entry>January 22, 1999</entry>
 		    <entry>3/4切分之后的 3.0-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>310000</entry>
 		    <entry>February 9, 1999</entry>
 		    <entry>3.1-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>310001</entry>
 		    <entry>March 27, 1999</entry>
 		    <entry>3.1-RELEASE 之后的 3.1-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>310002</entry>
 		    <entry>April 14, 1999</entry>
 		    <entry>C++ 构建/析构函数顺序变化之后的 3.1-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>320000</entry>
 		    <entry/>
 		    <entry>3.2-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>320001</entry>
 		    <entry>May 8, 1999</entry>
 		    <entry>3.2-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>320002</entry>
 		    <entry>August 29, 1999</entry>
 		    <entry>二进制不兼容的 IPFW 和 socket 变化之后的 3.2-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>330000</entry>
 		    <entry>September 2, 1999</entry>
 		    <entry>3.3-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>330001</entry>
 		    <entry>September 16, 1999</entry>
 		    <entry>3.3-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>330002</entry>
 		    <entry>November 24, 1999</entry>
 		    <entry>libc 中加入 &man.mkstemp.3; 之后的 3.3-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>340000</entry>
 		    <entry>December 5, 1999</entry>
 		    <entry>3.4-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>340001</entry>
 		    <entry>December 17, 1999</entry>
 		    <entry>3.4-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>350000</entry>
 		    <entry>June 20, 2000</entry>
 		    <entry>3.5-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>350001</entry>
 		    <entry>July 12, 2000</entry>
 		    <entry>3.5-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>400000</entry>
 		    <entry>January 22, 1999</entry>
 		    <entry>3/4切分之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400001</entry>
 		    <entry>February 20, 1999</entry>
 		    <entry>修改动态连接器处理方式之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400002</entry>
 		    <entry>March 13, 1999</entry>
 		    <entry>C++ 构建/析构函数顺序变化之后的</entry>
 		  </row>
 
 		  <row>
 		    <entry>400003</entry>
 		    <entry>March 27, 1999</entry>
 		    <entry>提供 &man.dladdr.3; 之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400004</entry>
 		    <entry>April 5, 1999</entry>
 		    <entry>修正了 __deregister_frame_info 的 4.0-CURRENT
 		      (也表示在 EGCS 1.1.2
 		      集成之后的 4.0-CURRENT)
 		    </entry>
 		  </row>
 
 		  <row>
 		    <entry>400005</entry>
 		    <entry>April 27, 1999</entry>
 		    <entry>&man.suser.9; API 变化之后的 4.0-CURRENT
 		      (也表示 newbus 之后的 4.0-CURRENT)</entry>
 		  </row>
 
 		  <row>
 		    <entry>400006</entry>
 		    <entry>May 31, 1999</entry>
 		    <entry>cdevsw 注册机制改变之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400007</entry>
 		    <entry>June 17, 1999</entry>
 		    <entry>加入了 socket 级凭据的 so_cred 之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400008</entry>
 		    <entry>June 20, 1999</entry>
 		    <entry>在 libc_r 中加入 poll 系统调用接口之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400009</entry>
 		    <entry>July 20, 1999</entry>
 		    <entry>将内核中
 		      <literal>dev_t</literal> 类型改为 <literal>struct
 		      specinfo</literal> 指针之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400010</entry>
 		    <entry>September 25, 1999</entry>
 		    <entry>修正了一处 &man.jail.2; 漏洞之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400011</entry>
 		    <entry>September 29, 1999</entry>
 		    <entry><literal>sigset_t</literal> 数据类型改变之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400012</entry>
 		    <entry>November 15, 1999</entry>
 		    <entry>切换到 GCC 2.95.2 编译器之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400013</entry>
 		    <entry>December 4, 1999</entry>
 		    <entry>加入了可插的 linux模式 ioctl 处理程序后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400014</entry>
 		    <entry>January 18, 2000</entry>
 		    <entry>引入 OpenSSL 之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400015</entry>
 		    <entry>January 27, 2000</entry>
 		    <entry>GCC 2.95.2 中 ABI 默认值从 -fvtable-thunks 改为
 		      -fno-vtable-thunks 之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400016</entry>
 		    <entry>February 27, 2000</entry>
 		    <entry>引入 OpenSSH 之后的 4.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>400017</entry>
 		    <entry>March 13, 2000</entry>
 		    <entry>4.0-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>400018</entry>
 		    <entry>March 17, 2000</entry>
 		    <entry>4.0-RELEASE 之后的 4.0-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>400019</entry>
 		    <entry>May 5, 2000</entry>
 		    <entry>引入延迟校验和之后的 4.0-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>400020</entry>
 		    <entry>June 4, 2000</entry>
 		    <entry>将 libxpg4 的代码并入 libc 之后的 4.0-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>400021</entry>
 		    <entry>July 8, 2000</entry>
 		    <entry>Binutils 升级到 2.10.0 之后的 4.0-STABLE， ELF
 		      标志变化， 以及将 tcsh 引入基本系统</entry>
 		  </row>
 
 		  <row>
 		    <entry>410000</entry>
 		    <entry>July 14, 2000</entry>
 		    <entry>4.1-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>410001</entry>
 		    <entry>July 29, 2000</entry>
 		    <entry>4.1-RELEASE 之后的 4.1-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>410002</entry>
 		    <entry>September 16, 2000</entry>
 		    <entry>&man.setproctitle.3; 从 libutil 移入 libc
 		      之后的 4.1-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>411000</entry>
 		    <entry>September 25, 2000</entry>
 		    <entry>4.1.1-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>411001</entry>
 		    <entry/>
 		    <entry>4.1.1-RELEASE 之后的 4.1.1-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>420000</entry>
 		    <entry>October 31, 2000</entry>
 		    <entry>4.2-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>420001</entry>
 		    <entry>January 10, 2001</entry>
 		    <entry>合并 libgcc.a 和 libgcc_r.a，
 		      并修改了相关的 GCC 连接方式之后的 4.2-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>430000</entry>
 		    <entry>March 6, 2001</entry>
 		    <entry>4.3-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>430001</entry>
 		    <entry>May 18, 2001</entry>
 		    <entry>引入 wint_t 之后的 4.3-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>430002</entry>
 		    <entry>July 22, 2001</entry>
 		    <entry>PCI 电源状态 API 合并之后的 4.3-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>440000</entry>
 		    <entry>August 1, 2001</entry>
 		    <entry>4.4-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>440001</entry>
 		    <entry>October 23, 2001</entry>
 		    <entry>引入 d_thread_t 之后的 4.4-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>440002</entry>
 		    <entry>November 4, 2001</entry>
 		    <entry>mount 结构改变之后的 4.4-STABLE (影响文件系统 kld)</entry>
 		  </row>
 
 		  <row>
 		    <entry>440003</entry>
 		    <entry>December 18, 2001</entry>
 		    <entry>用户态部分的 smbfs 被引入之后的 4.4-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>450000</entry>
 		    <entry>December 20, 2001</entry>
 		    <entry>4.5-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>450001</entry>
 		    <entry>February 24, 2002</entry>
 		    <entry>usb 结构元素改名之后的 4.5-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>450004</entry>
 		    <entry>April 16, 2002</entry>
 		    <entry>在 &man.rc.conf.5; 变量
 		      <literal>sendmail_enable</literal> 默认值改为
 		      <literal>NONE</literal> 之后的 4.5-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>450005</entry>
 		    <entry>April 27, 2002</entry>
 		    <entry>默认将 XFree86 4 用于预编译包联编之后的 4.5-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>450006</entry>
 		    <entry>May 1, 2002</entry>
 		    <entry>accept 过滤器修正了安全问题并且不再会轻易被 DoS
 		      之后的 4.5-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>460000</entry>
 		    <entry>June 21, 2002</entry>
 		    <entry>4.6-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>460001</entry>
 		    <entry>June 21, 2002</entry>
 		    <entry>修正了 &man.sendfile.2; 以吻合文档，
 		      而不再根据发出的头计算发出数据量之后的 4.6-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>460002</entry>
 		    <entry>July 19, 2002</entry>
 		    <entry>4.6.2-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>460100</entry>
 		    <entry>June 26, 2002</entry>
 		    <entry>4.6-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>460101</entry>
 		    <entry>June 26, 2002</entry>
 		    <entry>MFC `sed -i' 之后的 4.6-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>460102</entry>
 		    <entry>September 1, 2002</entry>
 		    <entry>MFC 许多 pkg_install 新特性之后的 4.6-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>470000</entry>
 		    <entry>October 8, 2002</entry>
 		    <entry>4.7-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>470100</entry>
 		    <entry>October 9, 2002</entry>
 		    <entry>4.7-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>470101</entry>
 		    <entry>November 10, 2002</entry>
 		    <entry>开始生成 __std{in,out,err}p 引用， 而不是 __sF。
 		      这将 std{in,out,err} 从编译时表达式变成了运行时值。</entry>
 		  </row>
 
 		  <row>
 		    <entry>470102</entry>
 		    <entry>January 23, 2003</entry>
 		    <entry>MFC mbuf 相关的将 m_aux mbuf 改为 m_tag
 		       的修改之后的 4.7-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>470103</entry>
 		    <entry>February 14, 2003</entry>
 		    <entry>OpenSSL 升级到 0.9.7 之后的 4.7-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>480000</entry>
 		    <entry>March 30, 2003</entry>
 		    <entry>4.8-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>480100</entry>
 		    <entry>April 5, 2003</entry>
 		    <entry>4.8-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>480101</entry>
 		    <entry>May 22, 2003</entry>
 		    <entry>&man.realpath.3; 变为线程安全的之后的 4.8-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>480102</entry>
 		    <entry>August 10, 2003</entry>
 		    <entry>对 twe 的 3ware API 修改之后的 4.8-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>490000</entry>
 		    <entry>October 27, 2003</entry>
 		    <entry>4.9-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>490100</entry>
 		    <entry>October 27, 2003</entry>
 		    <entry>4.9-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>490101</entry>
 		    <entry>January 8, 2004</entry>
 		    <entry>kinfo_eproc 中加入 e_sid 之后的 4.9-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>490102</entry>
 		    <entry>February 4, 2004</entry>
 		    <entry>MFC rtld 的 libmap 功能之后的 4.9-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>491000</entry>
 		    <entry>May 25, 2004</entry>
 		    <entry>4.10-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>491100</entry>
 		    <entry>June 1, 2004</entry>
 		    <entry>4.10-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>491101</entry>
 		    <entry>August 11, 2004</entry>
 		    <entry>MFC 20040629 版本的包维护工具之后的 4.10-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>491102</entry>
 		    <entry>November 16, 2004</entry>
 		    <entry>修正了 VM 当解除 wire 不存在页面时的问题之后的
 		      4.10-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>492000</entry>
 		    <entry>December 17, 2004</entry>
 		    <entry>4.11-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>492100</entry>
 		    <entry>December 17, 2004</entry>
 		    <entry>4.11-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>492101</entry>
 		    <entry>April 18, 2006</entry>
 		    <entry>将 libdata/ldconfig 目录加入 mtree 文件之后的
 		      4.11-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>500000</entry>
 		    <entry>March 13, 2000</entry>
 		    <entry>5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500001</entry>
 		    <entry>April 18, 2000</entry>
 		    <entry>加入 ELF 头字段， 并改变我们的 ELF 执行文件标记方式之后的
 		      5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500002</entry>
 		    <entry>May 2, 2000</entry>
 		    <entry>kld 元数据修改之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500003</entry>
 		    <entry>May 18, 2000</entry>
 		    <entry>buf/bio 修改之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500004</entry>
 		    <entry>May 26, 2000</entry>
 		    <entry>binutils 升级后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500005</entry>
 		    <entry>June 3, 2000</entry>
 		    <entry>将 libxpg4 并入 libc，
 		      以及引入 TASKQ 之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500006</entry>
 		    <entry>June 10, 2000</entry>
 		    <entry>加入 AGP 接口之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500007</entry>
 		    <entry>June 29, 2000</entry>
 		    <entry>Perl 升级到 5.6.0 之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500008</entry>
 		    <entry>July 7, 2000</entry>
 		    <entry>KAME 代码升级到 2000/07 之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500009</entry>
 		    <entry>July 14, 2000</entry>
 		    <entry>ether_ifattach() 和 ether_detach()
 		      修改之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500010</entry>
 		    <entry>July 16, 2000</entry>
 		    <entry>将 mtree 改为原先的默认值，
 		      并使用 -L 来跟随符号连接之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500011</entry>
 		    <entry>July 18, 2000</entry>
 		    <entry>kqueue API 修改之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500012</entry>
 		    <entry>September 2, 2000</entry>
 		    <entry>&man.setproctitle.3; 从 libutil 挪到 libc 之后的
 		      5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500013</entry>
 		    <entry>September 10, 2000</entry>
 		    <entry>首个 SMPng commit 之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500014</entry>
 		    <entry>January 4, 2001</entry>
 		    <entry>&lt;sys/select.h&gt; 改为 &lt;sys/selinfo.h&gt;
 		      之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500015</entry>
 		    <entry>January 10, 2001</entry>
 		    <entry>libgcc.a 和 libgcc_r.a 以及 GCC
 		      连接方式变动之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500016</entry>
 		    <entry>January 24, 2001</entry>
 		    <entry>修改以允许 libc 和 libc_r 连接到一起，
 		      不再鼓励使用 -pthread 之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500017</entry>
 		    <entry>February 18, 2001</entry>
 		    <entry>从 struct ucred 切换到 struct xucred
 		      以便使内核为 mountd 等程序导出的 API 稳定下来之后的
 		      5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500018</entry>
 		    <entry>February 24, 2001</entry>
 		    <entry>加入 CPUTYPE 用于 CPU 专用的优化的
 		      make 变量之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500019</entry>
 		    <entry>June 9, 2001</entry>
 		    <entry>machine/ioctl_fd.h 改为 sys/fdcio.h 之后的
 		      5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500020</entry>
 		    <entry>June 15, 2001</entry>
 		    <entry>locale 名称改变之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500021</entry>
 		    <entry>June 22, 2001</entry>
 		    <entry>引入 bzip2 之后的 5.0-CURRENT，
 		    同时也代表删去了 S/Key</entry>
 		  </row>
 
 		  <row>
 		    <entry>500022</entry>
 		    <entry>July 12, 2001</entry>
 		    <entry>加入 SSE 支持之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500023</entry>
 		    <entry>September 14, 2001</entry>
 		    <entry>KSE 第2个里程碑之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500024</entry>
 		    <entry>October 1, 2001</entry>
 		    <entry>d_thread_t 之后的 5.0-CURRENT，
 		      同时 UUCP 被移入 ports</entry>
 		  </row>
 
 		  <row>
 		    <entry>500025</entry>
 		    <entry>October 4, 2001</entry>
 		    <entry>64-位平台上的描述符和 creds API 变化之后的
 		      5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500026</entry>
 		    <entry>October 9, 2001</entry>
 		    <entry>采用 XFree86 4 作为默认的预编译包，
 		      以及加入 strnstr() libc 函数之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500027</entry>
 		    <entry>October 10, 2001</entry>
 		    <entry>加入 strcasestr() libc 函数之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500028</entry>
 		    <entry>December 14, 2001</entry>
 		    <entry>引入了用户态的 smbfs 组件之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>(未予增加)</entry>
 		    <entry/>
 		    <entry>加入了新的 C99 指定位宽整形变量之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500029</entry>
 		    <entry>January 29, 2002</entry>
 		    <entry>修改了 &man.sendfile.2; 的返回值之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500030</entry>
 		    <entry>February 15, 2002</entry>
 		    <entry>引入适合表达文件标志的 <literal>fflags_t</literal>
 		      类型之后的 5.0-</entry>
 		  </row>
 
 		  <row>
 		    <entry>500031</entry>
 		    <entry>February 24, 2002</entry>
 		    <entry>usb 结构元素改名之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500032</entry>
 		    <entry>March 16, 2002</entry>
 		    <entry>引入 Perl 5.6.1 之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500033</entry>
 		    <entry>April 3, 2002</entry>
 		    <entry>&man.rc.conf.5; 变量
 		      <literal>sendmail_enable</literal> 默认值改为
 		      <literal>NONE</literal> 之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500034</entry>
 		    <entry>April 30, 2002</entry>
 		    <entry>mtx_init() 增加了第三个参数之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500035</entry>
 		    <entry>May 13, 2002</entry>
 		    <entry>包含 Gcc 3.1 的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500036</entry>
 		    <entry>May 17, 2002</entry>
 		    <entry>在 /usr/src 中删去了 Perl 的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500037</entry>
 		    <entry>May 29, 2002</entry>
 		    <entry>加入 &man.dlfunc.3; 之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500038</entry>
 		    <entry>July 24, 2002</entry>
 		    <entry>一些 struct sockbuf 的成员变为结构，
 		      并重新排列顺序之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500039</entry>
 		    <entry>September 1, 2002</entry>
 		    <entry>引入 GCC 3.2.1 之后的 5.0-CURRENT。 头文件也不再使用
 		      _BSD_FOO_T_ 而开始使用 _FOO_T_DECLARED。
 		      这个值还可以用于作为一个包含使用 &man.bzip2.1;
 		      的预编译包支持的预期点。</entry>
 		  </row>
 
 		  <row>
 		    <entry>500040</entry>
 		    <entry>September 20, 2002</entry>
 		    <entry>以去掉对 disklabel 结构内容的依赖的名义，
 		      对磁盘相关的函数进行了许多修改之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500041</entry>
 		    <entry>October 1, 2002</entry>
 		    <entry>libc 中加入 &man.getopt.long.3; 之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500042</entry>
 		    <entry>October 15, 2002</entry>
 		    <entry>Binutils 2.13 升级， 包含了新的 FreeBSD 模拟，
 		      vec 以及输出格式之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500043</entry>
 		    <entry>November 1, 2002</entry>
 		    <entry>libc 中加入了弱 pthread_XXX 符号之后的 5.0-CURRENT，
 		      从而淘汰了 libXThrStub.so。 5.0-RELEASE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>500100</entry>
 		    <entry>January 17, 2003</entry>
 		    <entry>创建 RELENG_5_0 分支之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500101</entry>
 		    <entry>February 19, 2003</entry>
 		    <entry>&lt;sys/dkstat.h&gt; 变成了一个空文件， 不应再被引用</entry>
 		  </row>
 
 		  <row>
 		    <entry>500102</entry>
 		    <entry>February 25, 2003</entry>
 		    <entry>修改 d_mmap_t 接口之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500103</entry>
 		    <entry>February 26, 2003</entry>
 		    <entry>taskqueue_swi 以无全局锁的方式运行之后的 5.0-CURRENT，
 		      同时还加入了使用全局锁的 taskqueue_swi_giant</entry>
 		  </row>
 
 		  <row>
 		    <entry>500104</entry>
 		    <entry>February 27, 2003</entry>
 		    <entry>去掉了 cdevsw_add() 和 cdevsw_remove()
 		      出现 MAJOR_AUTO 分配机制</entry>
 		  </row>
 
 		  <row>
 		    <entry>500105</entry>
 		    <entry>March 4, 2003</entry>
 		    <entry>采用新的 cdevsw 初始化方法之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500106</entry>
 		    <entry>March 8, 2003</entry>
 		    <entry>devstat_add_entry() 被
 		      devstat_new_entry() 取代</entry>
 		  </row>
 
 		  <row>
 		    <entry>500107</entry>
 		    <entry>March 15, 2003</entry>
 		    <entry>修改 devstat 接口； 请参见 sys/sys/param.h 1.149</entry>
 		  </row>
 
 		  <row>
 		    <entry>500108</entry>
 		    <entry>March 15, 2003</entry>
 		    <entry>改变了 Token-Ring 接口</entry>
 		  </row>
 
 		  <row>
 		    <entry>500109</entry>
 		    <entry>March 25, 2003</entry>
 		    <entry>加入 vm_paddr_t</entry>
 		  </row>
 
 		  <row>
 		    <entry>500110</entry>
 		    <entry>March 28, 2003</entry>
 		    <entry>将 &man.realpath.3; 改为线程安全之后的
 		      5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500111</entry>
 		    <entry>April 9, 2003</entry>
 		    <entry>&man.usbhid.3; 与 NetBSD 同步之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500112</entry>
 		    <entry>April 17, 2003</entry>
 		    <entry>加入新的 NSS 实现， 以及 POSIX.1 getpw*_r, getgr*_r
 		      函数之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>500113</entry>
 		    <entry>May 2, 2003</entry>
 		    <entry>删去旧式 rc 系统之后的 5.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501000</entry>
 		    <entry>June 4, 2003</entry>
 		    <entry>5.1-RELEASE.</entry>
 		  </row>
 
 		  <row>
 		    <entry>501100</entry>
 		    <entry>June 2, 2003</entry>
 		    <entry>创建 RELENG_5_1 分支之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501101</entry>
 		    <entry>June 29, 2003</entry>
 		    <entry>改正 sigtimedwait(2) 和 sigwaitinfo(2)
 		      语义之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501102</entry>
 		    <entry>July 3, 2003</entry>
 		    <entry>在 &man.bus.dma.tag.create.9; 中加入了 lockfunc
 		      和 lockfuncarg 字段之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501103</entry>
 		    <entry>July 31, 2003</entry>
 		    <entry>集成了 GCC 3.3.1-pre 20030711 之后的
 		      5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501104</entry>
 		    <entry>August 5, 2003</entry>
 		    <entry>twe 中 3ware API 变化之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501105</entry>
 		    <entry>August 17, 2003</entry>
 		    <entry>允许动态连接 /bin 和 /sbin，
 		      以及将某些库移动到 /lib 之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501106</entry>
 		    <entry>September 8, 2003</entry>
 		    <entry>增加内核级 Coda 6.x 支持之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501107</entry>
 		    <entry>September 17, 2003</entry>
 		    <entry>将 16550 UART 常量从
 		      <filename>&lt;dev/sio/sioreg.h&gt;</filename> 挪到
 		      <filename>&lt;dev/ic/ns16550.h&gt;</filename> 之后的
 		      5.1-CURRENT。 此外， rtld 也从此无条件支持 libmap 功能</entry>
 		  </row>
 
 		  <row>
 		    <entry>501108</entry>
 		    <entry>September 23, 2003</entry>
 		    <entry>更新 PFIL_HOOKS API 之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501109</entry>
 		    <entry>September 27, 2003</entry>
 		    <entry>增加 kiconv(3) 之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501110</entry>
 		    <entry>September 28, 2003</entry>
 		    <entry>默认的 cdevsw open 和 close 操作变化之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501111</entry>
 		    <entry>October 16, 2003</entry>
 		    <entry>cdevsw 的布局变化之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501112</entry>
 		    <entry>October 16, 2003</entry>
 		    <entry>增加 kobj 多继承之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501113</entry>
 		    <entry>October 31, 2003</entry>
 		    <entry>修改 struct ifnet 中的 if_xname 之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>501114</entry>
 		    <entry>November 16, 2003</entry>
 		    <entry>将 /bin 和 /sbin 改为动态连接之后的 5.1-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502000</entry>
 		    <entry>December 7, 2003</entry>
 		    <entry>5.2-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>502010</entry>
 		    <entry>February 23, 2004</entry>
 		    <entry>5.2.1-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>502100</entry>
 		    <entry>December 7, 2003</entry>
 		    <entry>创建 RELENG_5_2 分支之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502101</entry>
 		    <entry>December 19, 2003</entry>
 		    <entry>libc 中加入了 __cxa_atexit/__cxa_finalize
 			两个函数之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502102</entry>
 		    <entry>January 30, 2004</entry>
 		    <entry>默认线程库从 libc_r 改为 libpthread 之后的
 			5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502103</entry>
 		    <entry>February 21, 2004</entry>
 		    <entry>设备驱动 API 大规模翻修之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502104</entry>
 		    <entry>February 25, 2004</entry>
 		    <entry>增加 getopt_long_only() 之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502105</entry>
 		    <entry>March 5, 2004</entry>
 		    <entry>C 的 NULL 定义改为 ((void *)0) 之后的 5.2-CURRENT，
 			这会产生更多的编译警告</entry>
 		  </row>
 
 		  <row>
 		    <entry>502106</entry>
 		    <entry>March 8, 2004</entry>
 		    <entry>pf 连入联编和安装过程之后的 5.2-CURRENT
 		    </entry>
 		  </row>
 
 		  <row>
 		    <entry>502107</entry>
 		    <entry>March 10, 2004</entry>
 		    <entry>在 sparc64 上将 time_t 改为 64-位 值之后的 5.2-CURRENT
 		    </entry>
 		  </row>
 
 		  <row>
 		    <entry>502108</entry>
 		    <entry>March 12, 2004</entry>
 		    <entry>在一些头文件修改以支持 Intel C/C++ 编译器，
 			以及让 execve(2) 更严格地符合 POSIX 之后的
 			5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502109</entry>
 		    <entry>March 22, 2004</entry>
 		    <entry>引入 bus_alloc_resource_any API 之后的 5.2-CURRENT
 		    </entry>
 		  </row>
 
 		  <row>
 		    <entry>502110</entry>
 		    <entry>March 27, 2004</entry>
 		    <entry>加入 UTF-8 locale 之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502111</entry>
 		    <entry>April 11, 2004</entry>
 		    <entry>删去 getvfsent(3) API 之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502112</entry>
 		    <entry>April 13, 2004</entry>
 		    <entry>为 make(1) 增加 .warning 语句之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502113</entry>
 		    <entry>June 4, 2004</entry>
 		    <entry>所有串口设备都强制使用 ttyioctl() 之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502114</entry>
 		    <entry>June 13, 2004</entry>
 		    <entry>引入 ALTQ 框架之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502115</entry>
 		    <entry>June 14, 2004</entry>
 		    <entry>修改 sema_timedwait(9) 使其成功时返回 0，
 		      失败时返回非 0 的错误代码之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502116</entry>
 		    <entry>June 16, 2004</entry>
 		    <entry>将内核 dev_t 改为指向 struct cdev * 的指针之后的
 		      5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502117</entry>
 		    <entry>June 17, 2004</entry>
 		    <entry>将内核 udev_t 改为 dev_t 之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502118</entry>
 		    <entry>June 17, 2004</entry>
 		    <entry>为 clock_gettime(2) 和 clock_getres(2) 增加
 		      CLOCK_VIRTUAL 和 CLOCK_PROF 支持之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502119</entry>
 		    <entry>June 22, 2004</entry>
 		    <entry>对网络接口复制进行全面修改之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502120</entry>
 		    <entry>July 2, 2004</entry>
 		    <entry>package 工具升级为 20040629 之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502121</entry>
 		    <entry>July 9, 2004</entry>
 		    <entry>不再将蓝牙代码标记为 i386 专用之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502122</entry>
 		    <entry>July 11, 2004</entry>
 		    <entry>引入 KDB 调试器框架之后的 5.2-CURRENT。
 		      同时还引入了 DDB 作为后台， 以及 GDB 后台。</entry>
 		  </row>
 
 		  <row>
 		    <entry>502123</entry>
 		    <entry>July 12, 2004</entry>
 		    <entry>修改 VFS_ROOT 和 vflush 使其使用一个 struct
 		      thread 参数之后的 5.2-CURRENT。 struct kinfo_proc
 		      增加了一个用户数据指针。 同时， 默认的 X 实现切换为
 		      <literal>xorg</literal></entry>
 		  </row>
 
 		  <row>
 		    <entry>502124</entry>
 		    <entry>July 24, 2004</entry>
 		    <entry>将使用 rc.d 和传统脚本的 port 分别启动之后的
 		      5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502125</entry>
 		    <entry>July 28, 2004</entry>
 		    <entry>取消前一修改之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502126</entry>
 		    <entry>July 31, 2004</entry>
 		    <entry>删除 kmem_alloc_pageable() 并引入 gcc 3.4.2 的
 		      5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502127</entry>
 		    <entry>August 2, 2004</entry>
 		    <entry>修改 UMA 内核 API 允许构建函数和初始化失败之后的
 		      5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>502128</entry>
 		    <entry>August 8, 2004</entry>
 		    <entry>vfs_mount 签名和全局替换 suser(9) API 的
 		      PRISON_ROOT 为 SUSER_ALLOWJAIL 之后的 5.2-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>503000</entry>
 		    <entry>August 23, 2004</entry>
 		    <entry>pfil API 修改之前的 5.3-BETA/RC</entry>
 		  </row>
 
 		  <row>
 		    <entry>503001</entry>
 		    <entry>September 22, 2004</entry>
 		    <entry>5.3-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>503100</entry>
 		    <entry>October 16, 2004</entry>
 		    <entry>创建 RELENG_5_3 分支之后的 5.3-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>503101</entry>
 		    <entry>December 3, 2004</entry>
 		    <entry>加入了 glibc 风格的
 		      &man.strftime.3; 填充选项的 5.3-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>503102</entry>
 		    <entry>February 13, 2005</entry>
 		    <entry>MFC OpenBSD 的 nc(1) 之后的 5.3-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>503103</entry>
 		    <entry>February 27, 2005</entry>
 		    <entry>在 MFC 了
 			<filename>&lt;src/include/stdbool.h&gt;</filename> 和
 			<filename>&lt;src/sys/i386/include/_types.h&gt;</filename>
 			用于兼容 GCC 和 Intel C/C++ 编译器的修正之后的 5.4-PRERELEASE</entry>
  		  </row>
 
 		  <row>
 		    <entry>503104</entry>
 		    <entry>February 28, 2005</entry>
 		    <entry>MFC 了将 ifi_epoch 由 wall 时钟时间改为 uptime
 		       之后的 5.4-PRERELEASE</entry>
  		  </row>
 
 		  <row>
 		    <entry>503105</entry>
 		    <entry>March 2, 2005</entry>
 		    <entry>MFC 了 vswprintf(3) 中的 EOVERFLOW 检查的 5.4-PRERELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>504000</entry>
 		    <entry>April 3, 2005</entry>
 		    <entry>5.4-RELEASE.</entry>
 		  </row>
 
 		  <row>
 		    <entry>504100</entry>
 		    <entry>April 3, 2005</entry>
 		    <entry>创建 RELENG_5_4 分支之后的 5.4-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>504101</entry>
 		    <entry>May 11, 2005</entry>
 		    <entry>加大默认线程堆栈尺寸之后的 5.4-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>504102</entry>
 		    <entry>June 24, 2005</entry>
 		    <entry>加入 sha256 之后的 5.4-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>504103</entry>
 		    <entry>October 3, 2005</entry>
 		    <entry>MFC if_bridge 之后的 5.4-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>504104</entry>
 		    <entry>November 13, 2005</entry>
 		    <entry>bsdiff 和 portsnap MFC 之后的 5.4-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>504105</entry>
 		    <entry>January 17, 2006</entry>
 		    <entry>在 MFC 了 ldconfig_local_dirs
 		      修改之后的 5.4-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>505000</entry>
 		    <entry>May 12, 2006</entry>
 		    <entry>5.5-RELEASE.</entry>
 		  </row>
 
 		  <row>
 		    <entry>505100</entry>
 		    <entry>May 12, 2006</entry>
 		    <entry>在创建 RELENG_5_5 分支之后的 5.5-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>600000</entry>
 		    <entry>August 18, 2004</entry>
 		    <entry>6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600001</entry>
 		    <entry>August 27, 2004</entry>
 		    <entry>内核中永久性启用 PFIL_HOOKS 之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600002</entry>
 		    <entry>August 30, 2004</entry>
 		    <entry>最初将 ifi_epoch 加入 if_data 结构之后的 6.0-CURRENT。
 		      此后不久即被撤销。 请不要使用这个值。</entry>
 		  </row>
 
 		  <row>
 		    <entry>600003</entry>
 		    <entry>September 8, 2004</entry>
 		    <entry>if_data 中再次加入 ifi_epoch 成员之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600004</entry>
 		    <entry>September 29, 2004</entry>
 		    <entry>将 struct inpcb 参数加入 pfil API 之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600005</entry>
 		    <entry>October 5, 2004</entry>
 		    <entry>newsyslog 加入了 "-d
 		      DESTDIR" 参数之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600006</entry>
 		    <entry>November 4, 2004</entry>
 		    <entry>加入了 glibc 风格的
 		      &man.strftime.3; 填充选项之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600007</entry>
 		    <entry>December 12, 2004</entry>
 		    <entry>加入了 802.11 框架更新之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600008</entry>
 		    <entry>January 25, 2005</entry>
 		    <entry>修改 VOP_*VOBJECT() 并为无全局锁的文件系统引入
 		      MNTK_MPSAFE 标志之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600009</entry>
 		    <entry>February 4, 2005</entry>
 		    <entry>加入 cpufreq 框架和驱动之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600010</entry>
 		    <entry>February 6, 2005</entry>
 		    <entry>引入 OpenBSD 的 nc(1) 之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600011</entry>
 		    <entry>February 12, 2005</entry>
 		    <entry>删去并不存在的 SVID2
 			<literal>matherr()</literal> 支持之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600012</entry>
 		    <entry>February 15, 2005</entry>
 		    <entry>增大默认线程堆栈尺寸之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600013</entry>
 		    <entry>February 19, 2005</entry>
 		    <entry>增加了针对
 			<filename>&lt;src/include/stdbool.h&gt;</filename> 和
 			<filename>&lt;src/sys/i386/include/_types.h&gt;</filename>
 			的用于 Intel C/C++ 编译器的 GCC-兼容性修正。</entry>
 		  </row>
 
 		  <row>
 		    <entry>600014</entry>
 		    <entry>February 21, 2005</entry>
 		    <entry>修正了 vswprintf(3) 的 EOVERFLOW 检查之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600015</entry>
 		    <entry>February 25, 2005</entry>
 		    <entry>将 struct if_data 成员 ifi_epoch 从 wall 时钟时间改为 uptime
 		       之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600016</entry>
 		    <entry>February 26, 2005</entry>
 		    <entry>修改 LC_CTYPE 磁盘格式之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600017</entry>
 		    <entry>February 27, 2005</entry>
 		    <entry>修改 NLS 编录磁盘格式之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600018</entry>
 		    <entry>February 27, 2005</entry>
 		    <entry>修改 LC_COLLATE 磁盘格式之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600019</entry>
 		    <entry>February 28, 2005</entry>
 		    <entry>将 acpica 头文件安装到 /usr/include</entry>
 		  </row>
 
 		  <row>
 		    <entry>600020</entry>
 		    <entry>March 9, 2005</entry>
 		    <entry>为 send(2) API 加入了 MSG_NOSIGNAL</entry>
 		  </row>
 
 		  <row>
 		    <entry>600021</entry>
 		    <entry>March 17, 2005</entry>
 		    <entry>在 cdevsw 上增加了一些字段</entry>
 		  </row>
 
 		  <row>
 		    <entry>600022</entry>
 		    <entry>March 21, 2005</entry>
 		    <entry>基本系统中删去了 gtar</entry>
 		  </row>
 
 		  <row>
 		    <entry>600023</entry>
 		    <entry>April 13, 2005</entry>
 		    <entry>unix(4) 中加入了 LOCAL_CREDS, LOCAL_CONNWAIT 两个 socket 选项</entry>
 		  </row>
 
 		  <row>
 		    <entry>600024</entry>
 		    <entry>April 19, 2005</entry>
 		    <entry>加入了 &man.hwpmc.4; 及其相关工具之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600025</entry>
 		    <entry>April 26, 2005</entry>
 		    <entry>加入 struct icmphdr 之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600026</entry>
 		    <entry>May 3, 2005</entry>
 		    <entry>pf 更新到了 3.7</entry>
 		  </row>
 
 		  <row>
 		    <entry>600027</entry>
 		    <entry>May 6, 2005</entry>
 		    <entry>引入了内核 libalias 和 ng_nat</entry>
 		  </row>
 
 		  <row>
 		    <entry>600028</entry>
 		    <entry>May 13, 2005</entry>
 		    <entry>将 ttyname_r(3) 接口改为符合 POSIX 标准，
 			并通过 unistd.h 和 libc</entry>
 		  </row>
 
 		  <row>
 		    <entry>600029</entry>
 		    <entry>May 29, 2005</entry>
 		    <entry>将 libpcap 升级为 v0.9.1 alpha 096 之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600030</entry>
 		    <entry>June 5, 2005</entry>
 		    <entry>引入 NetBSD 的 if_bridge(4) 之后的 6.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>600031</entry>
 		    <entry>June 10, 2005</entry>
 		    <entry>将 struct ifnet 从驱动的 softc 中拆出之后的 6.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>600032</entry>
 		    <entry>July 11, 2005</entry>
 		    <entry>引入了 libpcap v0.9.1 之后的 6.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>600033</entry>
 		    <entry>July 25, 2005</entry>
 		    <entry>所有自 RELENG_5 以来没有修改过的共享库的版本递增之后的
 		      6.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>600034</entry>
 		    <entry>August 13, 2005</entry>
 		    <entry>为 dev_clone 事件处理函数增加身份信息参数之后的
 		      6.0-STABLE。 6.0-RELEASE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>600100</entry>
 		    <entry>November 1, 2005</entry>
 		    <entry>6.0-RELEASE 之后的 6.0-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>600101</entry>
 		    <entry>December 21, 2005</entry>
 		    <entry>将 local_startup 目录中的脚本集成到基本系统的 &man.rcorder.8;
 		      之后的 6.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>600102</entry>
 		    <entry>December 30, 2005</entry>
 		    <entry>更新 ELF 类型和常量之后的 6.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>600103</entry>
 		    <entry>January 15, 2006</entry>
 		    <entry>MFC 了 pidfile(3) API 之后的 6.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>600104</entry>
 		    <entry>January 17, 2006</entry>
 		    <entry>在 MFC 了 ldconfig_local_dirs
 		      修改之后的 6.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>600105</entry>
 		    <entry>February 26, 2006</entry>
 		    <entry>在 csh(1) 中加入了 NLS 目录支持之后的 6.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>601000</entry>
 		    <entry>May 6, 2006</entry>
 		    <entry>6.1-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>601100</entry>
 		    <entry>May 6, 2006</entry>
 		    <entry>6.1-RELEASE 之后的 6.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>601101</entry>
 		    <entry>June 22, 2006</entry>
 		    <entry>引入 csup 之后的 6.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>601102</entry>
 		    <entry>July 11, 2006</entry>
 		    <entry>更新了 iwi(4) 之后的 6.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>601103</entry>
 		    <entry>July 17, 2006</entry>
 		    <entry>将域名解析函数更新至
 		      BIND9， 并导出了可重入版本的
 		      netdb 函数之后的 6.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>601104</entry>
 		    <entry>August 8, 2006</entry>
 		    <entry>在 OpenSSL 中启用了 DSO (动态共享库)
 		      支持之后的 6.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>601105</entry>
 		    <entry>September 2, 2006</entry>
 		    <entry>由于 802.11 修正变动了 IEEE80211_IOC_STA_INFO ioctl API
 		      之后的 6.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602000</entry>
 		    <entry>November 15, 2006</entry>
 		    <entry>6.2-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>602100</entry>
 		    <entry>September 15, 2006</entry>
 		    <entry>6.2-RELEASE 之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602101</entry>
 		    <entry>December 12, 2006</entry>
 		    <entry>加入 Wi-Spy
 		      quirk 之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602102</entry>
 		    <entry>December 28, 2006</entry>
 		    <entry>增加 pci_find_extcap() 之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602103</entry>
 		    <entry>January 16, 2007</entry>
 		    <entry>MFC 了对 dlsym 进行修改， 使其在指定 dso 及其暗指的依赖中查找符号之后的
 		      6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602104</entry>
 		    <entry>January 28, 2007</entry>
 		    <entry>MFC 了 netgraph 节点 ng_deflate(4) 和
 		      ng_pred1(4) 以及用于 ng_ppp(4)
 		      节点的新压缩及加密模式之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602105</entry>
 		    <entry>February 20, 2007</entry>
 		    <entry>MFC 了从 NetBSD 移植的 BSD 授权的 &man.gzip.1; 之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602106</entry>
 		    <entry>March 31, 2007</entry>
 		    <entry>MFC 了 PCI MSI 和 MSI-X 支持之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602107</entry>
 		    <entry>April 6, 2007</entry>
 		    <entry>MFC 了包含宽字符支持的 ncurses 5.6 之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602108</entry>
 		    <entry>April 11, 2007</entry>
 		    <entry>MFC 了实现 Linux SCSI SG 直通设备 API 子集的 CAM 'SG'
 			设备之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602109</entry>
 		    <entry>April 17, 2007</entry>
 		    <entry>MFC 了 readline 5.2 patchset 002 之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602110</entry>
 		    <entry>May 2, 2007</entry>
 		    <entry>MFC 了用于 amd64 和 i386 的 pmap_invalidate_cache()、
 		      pmap_change_attr()、 pmap_mapbios()、 pmap_mapdev_attr()、
 		      and pmap_unmapbios() 之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602111</entry>
 		    <entry>June 11, 2007</entry>
 		    <entry>由于 MFC 了 BOP_BDFLUSH 导致文件系统模块 KBI
 		      变化之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602112</entry>
 		    <entry>September 21, 2007</entry>
 		    <entry>一系列 libutil(3) MFC 之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602113</entry>
 		    <entry>October 25, 2007</entry>
 		    <entry>MFC 了宽字符和单字节 ctype 函数分拆之后的 6.2-STABLE。
 		      新编译的引用了 ctype.h 的可执行文件，
 		      可能会需要一个在旧系统上不存在的新增符号 __mb_sb_limit。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602114</entry>
 		    <entry>October 30, 2007</entry>
 		    <entry>恢复了 ctype ABI 向前兼容性之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>602115</entry>
 		    <entry>November 21, 2007</entry>
 		    <entry>回退了宽字符和单字节 ctype 分拆之后的 6.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>603000</entry>
 		    <entry>November 25, 2007</entry>
 		    <entry>6.3-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>603100</entry>
 		    <entry>November 25, 2007</entry>
 		    <entry>在 6.3-RELEASE 之后的 6.3-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>603101</entry>
 		    <entry>December 7, 2007</entry>
 		    <entry>修正了 bit macro 的多字节支持之后的 6.3-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>603102</entry>
 		    <entry>April 24, 2008</entry>
 		    <entry>为 flock 结构加入 l_sysid 之后的
 		      6.3-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>603103</entry>
 		    <entry>May 27, 2008</entry>
 		    <entry>MFC 了
 		      <function>memrchr</function> 函数之后的 6.3-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>603104</entry>
 		    <entry>June 15, 2008</entry>
                     <entry>为 make(1) MFC <literal>:u</literal>
                       变量修饰符之后的 6.3-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>604000</entry>
 		    <entry>October 4, 2008</entry>
 		    <entry>6.4-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>604100</entry>
 		    <entry>October 4, 2008</entry>
 		    <entry>6.4-RELEASE 之后的 6.4-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700000</entry>
 		    <entry>July 11, 2005</entry>
 		    <entry>7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700001</entry>
 		    <entry>July 23, 2005</entry>
 		    <entry>所有自 RELENG_5 以来没有修改过的共享库的版本递增之后的
 		      7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700002</entry>
 		    <entry>August 13, 2005</entry>
 		    <entry>为 dev_clone 事件处理函数中增加身份信息参数之后的
 		      7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700003</entry>
 		    <entry>August 25, 2005</entry>
 		    <entry>将 memmem(3) 加入 libc 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700004</entry>
 		    <entry>October 30, 2005</entry>
 		    <entry>将 solisten(9) 改为接受一 backlog 参数之后的
 		      7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700005</entry>
 		    <entry>November 11, 2005</entry>
 		    <entry>将 IFP2ENADDR() 改为返回一 IF_LLADDR() 指针之后的
 		      7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700006</entry>
 		    <entry>November 11, 2005</entry>
 		    <entry>在 <literal>struct ifnet</literal> 中增加 <literal>if_addr</literal>
 		      成员， 并删除 IFP2ENADDR() 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700007</entry>
 		    <entry>December 2, 2005</entry>
 		    <entry>将 local_startup 目录中的脚本集成到基本系统的 &man.rcorder.8;
 		      之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700008</entry>
 		    <entry>December 5, 2005</entry>
 		    <entry>去掉 MNT_NODEV 挂接选项之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700009</entry>
 		    <entry>December 19, 2005</entry>
 		    <entry>对 ELF-64 类型和符号版本进行变更之后的
 		      7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700010</entry>
 		    <entry>December 20, 2005</entry>
 		    <entry>增加 hostb 和 vgapci 驱动、 pci_find_extcap()，
 		      并将 AGP 驱动改为不再影射 aperature
 		      之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700011</entry>
 		    <entry>December 31, 2005</entry>
 		    <entry>除 Alpha 之外的所有平台上 tv_sec 改为 time_t
 		      之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700012</entry>
 		    <entry>January 8, 2006</entry>
 		    <entry>修改 ldconfig_local_dirs 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700013</entry>
 		    <entry>January 12, 2006</entry>
 		    <entry>在修改了
 		      <filename>/etc/rc.d/abi</filename> 以支持
 		      <filename>/compat/linux/etc/ld.so.cache</filename>
 		      以某只读文件系统上的符号连接形式存在之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700014</entry>
 		    <entry>January 26, 2006</entry>
 		    <entry>引入 pts 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700015</entry>
 		    <entry>March 26, 2006</entry>
 		    <entry>在引入 &man.hwpmc.4; 的第 2 版 ABI
 		      之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700016</entry>
 		    <entry>April 22, 2006</entry>
 		    <entry>在 libc 中加入了 &man.fcloseall.3; 之后的
 		      7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700017</entry>
 		    <entry>May 13, 2006</entry>
 		    <entry>删去 ip6fw 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700018</entry>
 		    <entry>July 15, 2006</entry>
 		    <entry>引入了 snd_emu10kx 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700019</entry>
 		    <entry>July 29, 2006</entry>
 		    <entry>引入了 OpenSSL 0.9.8b 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700020</entry>
 		    <entry>September 3, 2006</entry>
 		    <entry>增加了 bus_dma_get_tag 函数之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
                     <entry>700021</entry>
 		    <entry>September 4, 2006</entry>
 		    <entry>在引入了 libpcap 0.9.4 和
                       tcpdump 3.9.4 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
                     <entry>700022</entry>
 		    <entry>September 9, 2006</entry>
 		    <entry>在对 dlsym 进行修改， 使其在指定 dso 及其暗指的依赖中查找符号之后的
                       7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700023</entry>
 		    <entry>September 23, 2006</entry>
 		    <entry>为 OSSv4 混音器 API 加入新的声音
                       IOCTL 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700024</entry>
 		    <entry>September 28, 2006</entry>
 		    <entry>汇入 OpenSSL 0.9.8d 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700025</entry>
 		    <entry>November 11, 2006</entry>
 		    <entry>加入了 libelf 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700026</entry>
 		    <entry>November 26, 2006</entry>
 		    <entry>对音效相关的 sysctl 进行大幅调整之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700027</entry>
 		    <entry>November 30, 2006</entry>
 		    <entry>加入 Wi-Spy
 		      quirk 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700028</entry>
 		    <entry>December 15, 2006</entry>
 		    <entry>在 libc 中加入 sctp 调用之后的 7.0-CURRENT。
 		    </entry>
 		  </row>
 
 		  <row>
 		    <entry>700029</entry>
 		    <entry>January 26, 2007</entry>
 		    <entry>将 GNU &man.gzip.1; 实现替换为从 NetBSD 移植的采用 BSD 授权版本之后的
 		      7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700030</entry>
 		    <entry>February 7, 2007</entry>
 		    <entry>在 IPv4 多播转发代码中删去了 IPIP 隧道封装 (VIFF_TUNNEL) 之后的
 		      7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700031</entry>
 		    <entry>February 23, 2007</entry>
 		    <entry>修改了 bus_setup_intr() (newbus) 之后的 7.0-CURRENT。
 		    </entry>
 		  </row>
 
 		  <row>
 		    <entry>700032</entry>
 		    <entry>March 2, 2007</entry>
 		    <entry>引入了 ipw(4) 和 iwi(4) 固件之后的 7.0-CURRENT。
 		    </entry>
 		  </row>
 
 		  <row>
 		    <entry>700033</entry>
 		    <entry>March 9, 2007</entry>
 		    <entry>在 ncurses 中引入了宽字符支持之后的 7.0-CURRENT。
 		    </entry>
 		  </row>
 
 		  <row>
 		    <entry>700034</entry>
 		    <entry>March 19, 2007</entry>
 		    <entry>修改了 insmntque()、
 		      getnewvnode() 以及 vfs_hash_insert() 工作方式之后的 7.0-CURRENT。
 		    </entry>
 		  </row>
 
 		  <row>
 		    <entry>700035</entry>
 		    <entry>March 26, 2007</entry>
 		    <entry>增加 CPU 频率变动通知机制之后的 7.0-CURRENT。
 		    </entry>
 		  </row>
 
 		  <row>
 		    <entry>700036</entry>
 		    <entry>April 6, 2007</entry>
 		    <entry>引入了 ZFS 文件系统之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700037</entry>
 		    <entry>April 8, 2007</entry>
 		    <entry>新增了实现 Linux SCSI SG 直通设备 API 子集的 CAM 'SG'
 		      设备之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700038</entry>
 		    <entry>April 30, 2007</entry>
 		    <entry>将 &man.getenv.3;、 &man.putenv.3;、
 		      &man.setenv.3; 和 &man.unsetenv.3; 改为符合 POSIX
 		      之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700039</entry>
 		    <entry>May 1, 2007</entry>
 		    <entry>回退了 700038 中的变动之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700040</entry>
 		    <entry>May 10, 2007</entry>
 		    <entry>在 libutil 中增加了 &man.flopen.3; 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700041</entry>
 		    <entry>May 13, 2007</entry>
 		    <entry>启用了符号版本， 并将 libthr 改为默认线程库之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700042</entry>
 		    <entry>May 19, 2007</entry>
 		    <entry>引入了 gcc 4.2.0 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700043</entry>
 		    <entry>May 21, 2007</entry>
 		    <entry>将 RELENG_6 之后未修改过版本的共享库版本增加之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700044</entry>
 		    <entry>June 7, 2007</entry>
 		    <entry>将 vn_open()/VOP_OPEN() 的参数由文件描述符数组下标改为
 		      struct file * 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700045</entry>
 		    <entry>June 10, 2007</entry>
 		    <entry>修改 &man.pam.nologin.8; 使其向 PAM
 		      框架提供帐号管理功能而非身份验证功能之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700046</entry>
 		    <entry>June 11, 2007</entry>
 		    <entry>更新 802.11 无线支持之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700047</entry>
 		    <entry>June 11, 2007</entry>
 		    <entry>增加 TCP LRO 网络接口能力之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700048</entry>
 		    <entry>June 12, 2007</entry>
 		    <entry>在 IPv4 协议栈中加入了 RFC 3678 API 支持之后的 7.0-CURRENT。
 		      先前 IP_MULTICAST_IF ioctl 的 RFC 1724 行为被删去；
 		      0.0.0.0/8 不再能够用于指定接口索引下标， 而应使用
 		      struct ipmreqn 代替。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700049</entry>
 		    <entry>July 3, 2007</entry>
 		    <entry>引入 OpenBSD
 		      4.1 的 pf 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>(not changed)</entry>
 		    <entry/>
 		    <entry>为
 		      FAST_IPSEC 增加 IPv6 支持， 删去 KAME IPSEC， 并将
 		      FAST_IPSEC 更名为 IPSEC 之后的 7.0-CURRENT。
 		      (未变动)</entry>
 		  </row>
 
 		  <row>
 		    <entry>700050</entry>
 		    <entry>July 4, 2007</entry>
 		    <entry>将 setenv/putenv/等等调用，
 		      从传统 BSD 改为 POSIX 标准之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700051</entry>
 		    <entry>July 4, 2007</entry>
 		    <entry>增加新的 mmap/lseek/等等这些系统调用之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700052</entry>
 		    <entry>July 6, 2007</entry>
 		    <entry>将 I4B 头文件移动到
 		      include/i4b 之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700053</entry>
 		    <entry>September 30, 2007</entry>
 		    <entry>增加了 PCI domain 支持之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700054</entry>
 		    <entry>October 25, 2007</entry>
 		    <entry>MFC 了宽字符和单字节字符 ctype 分拆之后的 7.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700055</entry>
 		    <entry>October 28, 2007</entry>
 		    <entry>7.0-RELEASE， 以及 MFC 了恢复对 FreeBSD 4/5/6 版本的 PCIOCGETCONF、
 		      PCIOCREAD 和 PCIOCWRITE IOCTL ABI 向下兼容之后的 7.0-CURRENT，
 		      这一变动导致 PCIOCGETCONF IOCTL 的 ABI 再次发生变化。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700100</entry>
 		    <entry>December 22, 2007</entry>
 		    <entry>7.0-RELEASE 之后的 7.0-STABLE</entry>
 		  </row>
 
 		  <row>
 		    <entry>700101</entry>
 		    <entry>February 8, 2008</entry>
                     <entry>MFC m_collapse() 之后的 7.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700102</entry>
 		    <entry>March 30, 2008</entry>
 		    <entry>MFC kdb_enter_why() 之后的 7.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700103</entry>
 		    <entry>April 10, 2008</entry>
 		    <entry>为 flock 结构加入 l_sysid 之后的 7.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700104</entry>
 		    <entry>April 11, 2008</entry>
 		    <entry>在 procstat(1) MFC 之后的 7.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700105</entry>
 		    <entry>April 11, 2008</entry>
 		    <entry>在 MFC umtx 特性之后的 7.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700106</entry>
 		    <entry>April 15, 2008</entry>
 		    <entry>为 &man.psm.4; MFC &man.write.2; 支持之后的
 		      7.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700107</entry>
 		    <entry>April 20, 2008</entry>
 		    <entry>为 &man.fcntl.2; MFC F_DUP2FD 之后的
 		      7.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700108</entry>
 		    <entry>May 5, 2008</entry>
                     <entry>对 &man.lockmgr.9; 做了一些修改之后的 7.0-STABLE，
                       在使用 &man.lockmgr.9; 时必需包含
                       <filename>sys/lock.h</filename>。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700109</entry>
 		    <entry>May 27, 2008</entry>
 		    <entry>MFC 了
 		      <function>memrchr</function> 函数之后的 7.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700110</entry>
 		    <entry>August 5, 2008</entry>
                     <entry>MFC 了内核 NFS locked 客户端之后的
                       7.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700111</entry>
 		    <entry>August 20, 2008</entry>
                     <entry>加入了对物理连续巨帧支持之后的 7.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>700112</entry>
 		    <entry>August 27, 2008</entry>
                     <entry>在 MFC 内核 DTrace 支持之后的 7.0-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>701000</entry>
 		    <entry>November 25, 2008</entry>
 		    <entry>7.1-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>701100</entry>
 		    <entry>November 25, 2008</entry>
 		    <entry>7.1-RELEASE 之后的 7.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>701101</entry>
 		    <entry>January 10, 2009</entry>
 		    <entry>合并了 <function>strndup</function>
 			之后的 7.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>701102</entry>
 		    <entry>January 17, 2009</entry>
 		    <entry>加入了 cpuctl(4) 支持之后的 7.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>701103</entry>
 		    <entry>February 7, 2009</entry>
 		    <entry>合并了 多/无-IPv4/v6 jail 之后的 7.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>701104</entry>
 		    <entry>February 14, 2009</entry>
 		    <entry>在 struct mount 中保存了挂起属主， 以及在 struct vfsops
 		      中引入了 vfs_susp_clean
 		      方法之后的 7.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>701105</entry>
 		    <entry>March 12, 2009</entry>
                     <entry>对 kern.ipc.shmsegs sysctl 变量不兼容的修改，
                       以允许在 64bit 构架上分配更多的 SysV 共享内存段之后的
                       7.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>701106</entry>
 		    <entry>March 14, 2009</entry>
                     <entry>合并了一个对 POSIX semaphore 等待操作修正之后的
                       7.1-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>702000</entry>
 		    <entry>April 15, 2009</entry>
 		    <entry>7.2-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>702100</entry>
 		    <entry>April 15, 2009</entry>
 		    <entry>7.2-RELEASE 之后的 7.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>702101</entry>
 		    <entry>May 15, 2009</entry>
 		    <entry>ichsmb(4) 改为使用左邻接辅编址来保持与其它
 		      SMBus 控制器驱动一致性之后的 7.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>702102</entry>
 		    <entry>May 28, 2009</entry>
 		    <entry>MFC 了
 		      <function>fdopendir</function> 函数之后的 7.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>702103</entry>
 		    <entry>June 06, 2009</entry>
 		    <entry>MFC 了 PmcTools 之后的 7.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>702104</entry>
 		    <entry>July 14, 2009</entry>
 		    <entry>MFC 了
 		      <function>closefrom</function> 系统调用之后的 7.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>702105</entry>
 		    <entry>July 31, 2009</entry>
 		    <entry>MFC 了 SYSVIPC ABI
 		      改动之后的 7.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>702106</entry>
 		    <entry>September 14, 2009</entry>
 		    <entry>MFC 了 x86 PAT
 		      增强， 并新增了 d_mmap_single() 以及
 		      scatter/gather 型 VM 对象类型之后的 7.2-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>703000</entry>
 		    <entry>February 9, 2010</entry>
 		    <entry>7.3-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>703100</entry>
 		    <entry>February 9, 2010</entry>
 		    <entry>7.3-RELEASE 之后的 7.3-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>704000</entry>
 		    <entry>December 22, 2010</entry>
 		    <entry>7.4-RELEASE</entry>
 		  </row>
 
 		  <row>
 		    <entry>704100</entry>
 		    <entry>December 22, 2010</entry>
 		    <entry>7.4-RELEASE 之后的 7.4-STABLE。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800000</entry>
 		    <entry>October 11, 2007</entry>
 		    <entry>8.0-CURRENT。 分拆了宽字符和单字节字符
 		      ctype。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800001</entry>
 		    <entry>October 16, 2007</entry>
 		    <entry>引入了 libpcap 0.9.8 和 tcpdump 3.9.8 之后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800002</entry>
 		    <entry>October 21, 2007</entry>
 		    <entry>将 kthread_create() 系列函数改名为 kproc_create() 之后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800003</entry>
 		    <entry>October 24, 2007</entry>
 		    <entry>恢复了对 FreeBSD 4/5/6 版本的 PCIOCGETCONF、
 		      PCIOCREAD 和 PCIOCWRITE IOCTL ABI 向下兼容之后的 8.0-CURRENT，
 		      这一变动导致 PCIOCGETCONF IOCTL 的 ABI 再次发生变化。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800004</entry>
 		    <entry>November 12, 2007</entry>
 		    <entry>将 agp(4) 驱动从
 		      src/sys/pci 挪到 src/sys/dev/agp 之后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800005</entry>
 		    <entry>December 4, 2007</entry>
 		    <entry><link xlink:href="http://www.freebsd.org/cgi/cvsweb.cgi/src/sys/kern/kern_mbuf.c#rev1.35">修改了
 		      jumbo frame 分配器之后的</link> 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800006</entry>
 		    <entry>December 7, 2007</entry>
 		    <entry>在给 &man.hwpmc.4; 加入了 callgraph 捕捉功能后的
 		      8.0-CURRENT</entry>
 		  </row>
 
 		  <row>
 		    <entry>800007</entry>
 		    <entry>December 25, 2007</entry>
 		    <entry>kdb_enter() 增加 "why" 参数之后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800008</entry>
 		    <entry>December 28, 2007</entry>
 		    <entry>在去除 LK_EXCLUPGRADE 选项后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800009</entry>
 		    <entry>January 9, 2008</entry>
 		    <entry>引入
 		      &man.lockmgr.disown.9; 之后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800010</entry>
 		    <entry>January 10, 2008</entry>
 		    <entry>修改 &man.vn.lock.9; 原型之后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800011</entry>
 		    <entry>January 13, 2008</entry>
 		    <entry>修改 &man.VOP.LOCK.9; 和
 		      &man.VOP.UNLOCK.9; 原型之后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800012</entry>
 		    <entry>January 19, 2008</entry>
 		    <entry>引入
 		      &man.lockmgr.recursed.9;、 &man.BUF.RECURSED.9; 和
 		      &man.BUF.ISLOCKED.9; 并删除了
 		      <function>BUF_REFCNT()</function> 之后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800013</entry>
 		    <entry>January 23, 2008</entry>
 		    <entry>引入
 		      <quote>ASCII</quote> 编码之后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800014</entry>
 		    <entry>January 24, 2008</entry>
 		    <entry>修改 &man.lockmgr.9; 并删除了
 		      <function>lockcount()</function> 和
 		      <function>LOCKMGR_ASSERT()</function> 之后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800015</entry>
 		    <entry>January 26, 2008</entry>
 		    <entry>扩展了 &man.fts.3; 数据结构之后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800016</entry>
 		    <entry>February 1, 2008</entry>
 		    <entry>为 MEXTADD(9) 增加了一个参数之后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800017</entry>
 		    <entry>February 6, 2008</entry>
 		    <entry>为 &man.lockmgr.9; 引入 LK_NODUP 和
 		      LK_NOWITNESS 选项后的 8.0-CURRENT。</entry>
 		  </row>
 
 		  <row>
 		    <entry>800018</entry>
 		    <entry>February 8, 2008</entry>
 		    <entry>引入 m_collapse 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800019</entry>
 		    <entry>February 9, 2008</entry>
 		    <entry>为 sysctl 变量 kern.proc.filedesc 加入
 		      当前工作目录，root 目录和 jail 目录支持之后的
 		      8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800020</entry>
 		    <entry>February 13, 2008</entry>
 		    <entry>引入 &man.lockmgr.assert.9; 之后的
 		      8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800021</entry>
 		    <entry>February 15, 2008</entry>
 		    <entry>引入 &man.lockmgr.args.9; 和移除
 		      LK_INTERNAL 标志之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800022</entry>
 		    <entry>(backed out)</entry>
 		    <entry>把 BSD &man.ar.1; 作为系统默认的 ar 之后的
 		      8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800023</entry>
 		    <entry>February 25, 2008</entry>
 		    <entry>修改了 &man.lockstatus.9; 和 &man.VOP.ISLOCKED.9;
 		      原型，特别时去掉 <literal>struct thread</literal>
 		      参数之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800024</entry>
 		    <entry>March 1, 2008</entry>
 		    <entry>砍掉了 <function>lockwaiters</function> 和
 		      <function>BUF_LOCKWAITERS</function> 函数，
 		      <function>brelvp</function> 的返回值从 void
 		      修改成 int，并引入 &man.lockinit.9; 新标志之后的
 		      8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800025</entry>
 		    <entry>March 8, 2008</entry>
 		    <entry>为 &man.fcntl.2; 引入 F_DUP2FD 之后的
 		      8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800026</entry>
 		    <entry>March 12, 2008</entry>
 		    <entry>修改了 cv_broadcastpri 优先权参数之后的
 		      8.0-CURRENT，比如 0 表示无优先权。</entry>
 		  </row>
 		  <row>
 		    <entry>800027</entry>
 		    <entry>March 24, 2008</entry>
 		    <entry>修改了 bpf 监测 ABI, 加入了 zerocopy bpf buffer
 		      之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800028</entry>
 		    <entry>March 26, 2008</entry>
 		    <entry>为 flock 结构增加了 l_sysid 之后的
 		      8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800029</entry>
 		    <entry>March 28, 2008</entry>
 		    <entry>重新整合了 <function>BUF_LOCKWAITERS</function>
 		      函数并加入 &man.lockmgr.waiters.9; 之后的
 		      8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800030</entry>
 		    <entry>April 1, 2008</entry>
 		    <entry>引入 &man.rw.try.rlock.9; 和 &man.rw.try.wlock.9;
 		      之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800031</entry>
 		    <entry>April 6, 2008</entry>
 		    <entry>引入 <function>lockmgr_rw</function> 和
 		      <function>lockmgr_args_rw</function>
 		      函数之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800032</entry>
 		    <entry>April 8, 2008</entry>
 		    <entry>实现了 openat 和相关的系统调用，为 &man.open.2;
 		      引入了 O_EXEC 标志，和提供了相应的 linux
 		      兼容的系统调用之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800033</entry>
 		    <entry>April 8, 2008</entry>
 		    <entry>为 &man.psm.4; 增加了原生的 &man.write.2;
 		      支持之后的 8.0-CURRENT。 现在任意命令可写入
 		      <filename>/dev/psm%d</filename>
 		      并读出状态。</entry>
 		  </row>
 		  <row>
 		    <entry>800034</entry>
 		    <entry>April 10, 2008</entry>
 		    <entry>引入 <function>memrchr</function>
 		      函数之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800035</entry>
 		    <entry>April 16, 2008</entry>
 		    <entry>引入 <function>fdopendir</function>
 		      函数之后的 8.0-CURRENT</entry>
 		  </row>
 		  <row>
 		    <entry>800036</entry>
 		    <entry>April 20, 2008</entry>
                     <entry>无线部分转向 multi-bss (也叫做 vaps)
                       支持之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800037</entry>
 		    <entry>May 9, 2008</entry>
 		    <entry>加入多路由表支持 (也就是 setfib(1)、 stfib(2)） 后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800038</entry>
 		    <entry>May 26, 2008</entry>
 		    <entry>删去了 netatm 和
 		      ISDN4BSD 后的 8.0-CURRENT。 这个版本也表示增加了
 		      Compact C Type (CTF) 工具。</entry>
 		  </row>
 		  <row>
 		    <entry>800039</entry>
 		    <entry>June 14, 2008</entry>
                     <entry>移除 sgtty 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800040</entry>
 		    <entry>June 26, 2008</entry>
 		    <entry>增加了内核级 NFS lockd 客户端的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800041</entry>
 		    <entry>July 22, 2008</entry>
                     <entry>增加了 arc4random_buf(3) 和 arc4random_uniform(3)
                       之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800042</entry>
 		    <entry>August 8, 2008</entry>
                     <entry>增加了 cpuctl(4) 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800043</entry>
 		    <entry>August 13, 2008</entry>
                     <entry>修改 bpf(4) 使用单一的设备节点而不是克隆之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800044</entry>
 		    <entry>August 17, 2008</entry>
                     <entry>在提交了 vimage 项目第一步之后的
                       8.0-CURRENT。把全局变量重命名为虚拟化带
                       V_ 前缀并用宏映射到原来的全局名称。</entry>
 		  </row>
 		  <row>
 		    <entry>800045</entry>
 		    <entry>August 20, 2008</entry>
                     <entry>引入 MPSAFE TTY 层之后的 8.0-CURRENT，
                       包括对相关驱动和工具的修改。</entry>
 		  </row>
 		  <row>
 		    <entry>800046</entry>
 		    <entry>September 8, 2008</entry>
 		    <entry>将 amd64 架构上 GDT 拆分到不同 CPU 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800047</entry>
 		    <entry>September 10, 2008</entry>
 		    <entry>删去了 VSVTX、 VSGID 和 VSUID 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800048</entry>
 		    <entry>September 16, 2008</entry>
 		    <entry>将内核中 NFS 挂接部分的代码改为能够通过
 	                   nmount() iovec， 而不再是大的
 	                   nfs_args 结构体作为参数之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800049</entry>
 		    <entry>September 17, 2008</entry>
                     <entry>删去了 &man.suser.9; 和 &man.suser.cred.9;
                       之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800050</entry>
 		    <entry>October 20, 2008</entry>
                     <entry>修改了缓冲存储器 API 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800051</entry>
 		    <entry>October 23, 2008</entry>
                     <entry>删去了 &man.MALLOC.9; 和 &man.FREE.9;
                       宏之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800052</entry>
 		    <entry>October 28, 2008</entry>
                     <entry>引入了 accmode_t 和重新命名
                       VOP_ACCES 'a_mode' 为 a_accmode
                       之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800053</entry>
 		    <entry>November 2, 2008</entry>
                     <entry>修改了 &man.vfs.busy.9; 原型并引入了
                       MBF_NOWAIT 和 MBF_MNTLSTLOCK 标志之后的
                       8.0-CURRENT。</entry>
 	          </row>
 		  <row>
 		    <entry>800054</entry>
 		    <entry>November 22, 2008</entry>
 		    <entry>增加了 buf_ring、
 		      内存栅以及 ifnet 函数， 以方便撰写支持多硬件传输队列的驱动，
 		      以及无锁环形缓冲实现的驱动程序， 并更高效地管理包队列功能之后的
 		      8.0-CURRENT。</entry>
 	          </row>
 		  <row>
 		    <entry>800055</entry>
 		    <entry>November 27, 2008</entry>
                     <entry>引入了 &man.hwpmc.4; 对于 Intel&trade;
                       Core，Core2 和 Atom 的支持之后的 8.0-CURRENT。</entry>
 	          </row>
 		  <row>
 		    <entry>800056</entry>
 		    <entry>November 29, 2008</entry>
                     <entry>引入了 multi-/no-IPv4/v6 jail
                       之后的 8.0-CURRENT。</entry>
 	          </row>
 		  <row>
 		    <entry>800057</entry>
 		    <entry>December 1, 2008</entry>
 		    <entry>将 ath hal 改为使用源代码之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800058</entry>
 		    <entry>December 12, 2008</entry>
 		    <entry>引入了 VOP_VPTOCNP 操作之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800059</entry>
 		    <entry>December 15, 2008</entry>
 		    <entry>引入了新的 arp-v2 重写之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800060</entry>
 		    <entry>December 19, 2008</entry>
 		    <entry>引入了 makefs 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800061</entry>
 		    <entry>January 15, 2009</entry>
 		    <entry>引入了 TCP Appropriate Byte Counting 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800062</entry>
 		    <entry>January 28, 2009</entry>
 		    <entry>删去了 minor()、 minor2unit()、 unit2minor() 等之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800063</entry>
 		    <entry>February 18, 2009</entry>
 		    <entry>在 GENERIC 配置中改为使用 USB2 栈之后的 8.0-CURRENT； 这个数值同时也标志新增了 fdevname(3)。</entry>
 		  </row>
 		  <row>
 		    <entry>800064</entry>
 		    <entry>February 23, 2009</entry>
 		    <entry>将 USB2 栈移动并替换 dev/usb 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800065</entry>
 		    <entry>February 26, 2009</entry>
                     <entry>在对 libmp(3) 中所有函数更名之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800066</entry>
 		    <entry>February 27, 2009</entry>
                     <entry>更改了 USB devfs 管理和布局之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800067</entry>
 		    <entry>February 28, 2009</entry>
                     <entry>加入了 getdelim()， getline()， stpncpy()， strnlen()，
                       wcsnlen()， wcscasecmp()， 和 wcsncasecmp() 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800068</entry>
 		    <entry>March 2, 2009</entry>
                     <entry>在 usbhub devclass 更名为 uhub 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800069</entry>
 		    <entry>March 9, 2009</entry>
                     <entry>重命名 libusb20.so.1 为 libusb.so.1 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800070</entry>
 		    <entry>March 9, 2009</entry>
                     <entry>合并 IGMPv3 和 Source-Specific Multicast (SSM) 入 IPv4 栈之后的
                       8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800071</entry>
 		    <entry>March 14, 2009</entry>
                     <entry>为 gcc 打上了在 c99 和 gnu99 模式中使用 C99 inline 语义补丁之后的
                       8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800072</entry>
 		    <entry>March 15, 2009</entry>
                     <entry>移除了 IFF_NEEDSGIANT 标志; 不再支持非线程安全的网络设备驱动之后的
                       8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800073</entry>
 		    <entry>March 18, 2009</entry>
                     <entry>实现了 rpath 动态字符替换之后的 8.0-CURRENT.</entry>
 		  </row>
 		  <row>
 		    <entry>800074</entry>
 		    <entry>March 24, 2009</entry>
 		    <entry>引入了 tcpdump 4.0.0 和
 		      libpcap 1.0.0 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800075</entry>
 		    <entry>April 6, 2009</entry>
 		    <entry>修改了 structs vnet_net、
 		      vnet_inet 和 vnet_ipfw 结构布局之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800076</entry>
 		    <entry>April 9, 2009</entry>
 		    <entry>为 dummynet 新增了延迟评估工具之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800077</entry>
 		    <entry>April 14, 2009</entry>
 		    <entry>删去了 VOP_LEASE() 和
 		      vop_vector.vop_lease 之后的 8.0-CURRENT</entry>
 		  </row>
 		  <row>
 		    <entry>800078</entry>
 		    <entry>April 15, 2009</entry>
 		    <entry>在 struct rt_metrics 和 struct
 		      rt_metrics_lite 中添加了 rt_weight 字段，
 		      导致其结构发生变化之后的 8.0-CURRENT。
 		      此后 RTM_VERSION 增加， 但又回退了。</entry>
 		  </row>
 		  <row>
 		    <entry>800079</entry>
 		    <entry>April 15, 2009</entry>
 		     <entry>在 struct route 和 struct_in6 中添加了
 		       struct llentry 指针之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800080</entry>
 		    <entry>April 15, 2009</entry>
 		    <entry>改变了 struct inpcb 布局之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800081</entry>
 		    <entry>April 19, 2009</entry>
 		    <entry>改变了 malloc_type 布局之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800082</entry>
 		    <entry>April 21, 2009</entry>
 		    <entry>改变了 struct ifnet 布局， 并增加了 if_ref()
 		      和 if_rele() 引用计数维护功能之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800083</entry>
 		    <entry>April 22, 2009</entry>
 		    <entry>实现了底层蓝牙 HCI API 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800084</entry>
 		    <entry>April 29, 2009</entry>
 		    <entry>修改了 IPv6 SSM 和 MLDv2
 		      之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800085</entry>
 		    <entry>April 30, 2009</entry>
 		    <entry>启用了包括一个活跃映像的 VIMAGE 内核支持之后的
 		      8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800086</entry>
 		    <entry>May 8, 2009</entry>
 		    <entry>为 patch(1) 增加任意长输入行支持之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800087</entry>
 		    <entry>May 11, 2009</entry>
 		    <entry>修改了一些 VFS KPI 之后的 8.0-CURRENT。
 		      VFS 的 FSD 部分中删去了线程参数。
 		      <function>VFS_*</function> 函数并不需要这些上下文信息，
 		      因为它总是与
 		      <varname>curthread</varname> 相关。
 		      在某些特殊情况中， 则保留了原先的行为。</entry>
 		  </row>
 		  <row>
 		    <entry>800088</entry>
 		    <entry>May 20, 2009</entry>
 		    <entry>对 net80211 监视模式进行调整之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800089</entry>
 		    <entry>May 23, 2009</entry>
 		    <entry>增加了 UDP 控制块支持之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800090</entry>
 		    <entry>May 23, 2009</entry>
 		    <entry>将网络接口克隆虚拟化之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800091</entry>
 		    <entry>May 27, 2009</entry>
 		    <entry>增加了层次式 jail 并取消全局 securelevel
 		      之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800092</entry>
 		    <entry>May 29, 2009</entry>
 		    <entry>修改了
 		      <function>sx_init_flags()</function> KPI 之后的 8.0-CURRENT。
 		      <constant>SX_ADAPTIVESPIN</constant> 退役，
 		      而新增的 <constant>SX_NOADAPTIVE</constant> 标志则表达相反语义。</entry>
 		  </row>
 		  <row>
 		    <entry>800093</entry>
 		    <entry>May 29, 2009</entry>
 		    <entry>为 struct mount 增加 mnt_xflag 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800094</entry>
 		    <entry>May 30, 2009</entry>
 		    <entry>新增了
 		      &man.VOP.ACCESSX.9; 之后的 8.0-CURRENT。</entry>
 		  </row>
                   <row>
 		    <entry>800095</entry>
 		    <entry>May 30, 2009</entry>
 		    <entry>调整轮询 KPI (polling KPI) 之后的 8.0-CURRENT。
 		      轮询处理程序会返回处理过的包的数量。 新增的
 		      <constant>IFCAP_POLLING_NOCOUNT</constant>
 		      则表示返回值不重要， 并跳过计数。</entry>
 		  </row>
 		  <row>
 		    <entry>800096</entry>
 		    <entry>June 1, 2009</entry>
 		    <entry>对新的 netisr 进行了改进， 并调整了保存和存取 FIB
 		      方式之后的 8.0-CURRENT。</entry>
 		    <!--
 			Had been 96 and 97 but were folded because we are
 			running out of numbers.
 		    -->
 		  </row>
 		  <row>
 		    <entry>800097</entry>
 		    <entry>June 8, 2009</entry>
 		    <entry>引入了 vnet 析构挂钩和相关基础设施之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800097</entry>
 		    <entry>June 11, 2009</entry>
 		    <entry>引入了 netgraph 输出到输入路径调用检测和排队机制，
 		      并调整了 struct thread 布局之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800098</entry>
 		    <entry>June 14, 2009</entry>
 		    <entry>引入了 OpenSSL 0.9.8k 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800099</entry>
 		    <entry>June 22, 2009</entry>
 		    <entry>更新了 NGROUPS 并将路由虚拟化挪到它自己的
 		      VImage 模块之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800100</entry>
 		    <entry>June 24, 2009</entry>
 		    <entry>修改了 SYSVIPC ABI 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800101</entry>
 		    <entry>June 29, 2009</entry>
 		    <entry>删去了与网络接口一一对应的
 		      /dev/net/* 字符设备之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800102</entry>
 		    <entry>July 12, 2009</entry>
 		    <entry>在 struct sackhint、 struct tcpcb 以及 struct
 		      tcpstat 上增加占位元素之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800103</entry>
 		    <entry>July 13, 2009</entry>
 		    <entry>将 TOE 驱动接口中的 struct tcpopt
 		      替换为 TCP syncache 中的 struct toeopt 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800104</entry>
 		    <entry>July 14, 2009</entry>
 		    <entry>新增了基于 linker-set 的 per-vnet
 		      分配器之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800105</entry>
 		    <entry>July 19, 2009</entry>
 		    <entry>递增了所有未使用符号版本的动态连接库版本之后的
 		      8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800106</entry>
 		    <entry>July 24, 2009</entry>
 		    <entry>引入 VM 对象类型 OBJT_SG 之后的 8.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>800107</entry>
 		    <entry>August 2, 2009</entry>
 		    <entry>通过加入 newbus sxlock 使 newbus 子系统不再使用
 		      Giant， 以及 8.0-RELEASE。</entry>
 		  </row>
 		  <row>
 		    <entry>800108</entry>
 		    <entry>November 21, 2009</entry>
 		    <entry>实现了 EVFILT_USER kevent 过滤器之后的 8.0-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>800500</entry>
 		    <entry>January 7, 2010</entry>
 		    <entry>令 <command>pkg_add -r</command>
 			使用 packages-8-stable 的 <literal>__FreeBSD_version</literal>
 			版本变化的 8.0-STABLE。</entry>
                   </row>
 		  <row>
 		    <entry>800501</entry>
 		    <entry>January 24, 2010</entry>
 		    <entry>调整了
 		      <function>scandir(3)</function> 和
 			<function>alphasort(3)</function> 函数原型，
 			使其符合 SUSv4 之后的 8.0-STABLE。</entry>
                   </row>
 		  <row>
 		    <entry>800502</entry>
 		    <entry>January 31, 2010</entry>
 		    <entry>新增了
 		      <function>sigpause(3)</function> 之后的 8.0-STABLE。</entry>
                   </row>
 		  <row>
 		    <entry>800503</entry>
 		    <entry>February 25, 2010</entry>
 		    <entry>新增了用于管理网络接口说明的 SIOCGIFDESCR
 		      和 SIOCSIFDESCR ioctl 之后的 8.0-STABLE。
 		      这组接口受到了 OpenBSD 的启发。</entry>
 		  </row>
 		  <row>
 		    <entry>800504</entry>
 		    <entry>March 1, 2010</entry>
 		    <entry>MFC 了 x86emu， 来自 OpenBSD 的 x86 CPU
 		      实模式模拟器之后的 8.0-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>800505</entry>
 		    <entry>May 18, 2010</entry>
 		    <entry>MFC 了添加 liblzma, xz, xzdec
 		      以及 lzmainfo 之后的 8.0-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>801000</entry>
 		    <entry>June 14, 2010</entry>
 		    <entry>8.1-RELEASE</entry>
 		  </row>
 		  <row>
 		    <entry>801500</entry>
 		    <entry>June 14, 2010</entry>
 		    <entry>8.1-RELEASE 之后的 8.1-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>801501</entry>
 		    <entry>November 3, 2010</entry>
 		    <entry>用于 PL_FLAG_SCE/SCX/EXEC/SI 的 struct sysentvec 的 KBI 以及
 		      用于 ptrace(PT_LWPINFO) 的 pl_siginfo 的 KBI
 		      改变之后的 8.1-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>802000</entry>
 		    <entry>December 22, 2010</entry>
 		    <entry>8.2-RELEASE</entry>
 		  </row>
 		  <row>
 		    <entry>802500</entry>
 		    <entry>December 22, 2010</entry>
 		    <entry>8.2-RELEASE 之后的 8.2-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>802501</entry>
 		    <entry>February 28, 2011</entry>
 		    <entry>合并了 DTrace 变动， 包含用户态跟踪支持之后的 8.2-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>802502</entry>
 		    <entry>March 6, 2011</entry>
 		    <entry>在 libm 中合并了 log2 和 log2f 之后的 8.2-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>802503</entry>
 		    <entry>May 1, 2011</entry>
 		    <entry>将 gcc 升级至 FSF gcc-4_2-branch 最后一个
 		      GPLv2 版本之后的 8.2-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>802504</entry>
 		    <entry>May 28, 2011</entry>
 		    <entry>引入模块化拥塞控制支持基础设施和 KPI 之后的 8.2-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>802505</entry>
 		    <entry>May 28, 2011</entry>
 		    <entry>引入了 Hhook 和 Khelp KPI 之后的 8.2-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>802506</entry>
 		    <entry>May 28, 2011</entry>
 		    <entry>在 tcpcb 结构中增加 OSD 之后的 8.2-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>802507</entry>
 		    <entry>June 6, 2011</entry>
 		    <entry>引入 ZFS v28 之后的 8.2-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>802508</entry>
 		    <entry>June 8, 2011</entry>
 		    <entry>删去了 sv_schedtail struct sysvec 方法之后的 8.2-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>802509</entry>
 		    <entry>July 14, 2011</entry>
 		    <entry>在 binutils 中合并了 SSE3 支持之后的 8.2-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>802510</entry>
 		    <entry>July 19, 2011</entry>
 		    <entry>为 <function>rfork(2)</function> 添加了 RFTSIGZMB 标志之后的 8.2-STABLE。</entry>
 		  </row>
 		  <row>
 		    <entry>900000</entry>
 		    <entry>August 22, 2009</entry>
 		    <entry>9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900001</entry>
 		    <entry>September 8, 2009</entry>
 		    <entry>引入了 x86emu， 来自 OpenBSD 的 x86 CPU
 		      实模式模拟器之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900002</entry>
 		    <entry>September 23, 2009</entry>
 		    <entry>实现了 EVFILT_USER kevent 过滤器之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900003</entry>
 		    <entry>December 2, 2009</entry>
 		    <entry>新增了
 		      <function>sigpause(3)</function> 以及 csu 的 PIE
 		      支持之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900004</entry>
 		    <entry>December 6, 2009</entry>
 		    <entry>新增了 libulog 及其 libutempter 兼容接口之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900005</entry>
 		    <entry>December 12, 2009</entry>
 		    <entry>新增了用于查询指定休眠队列上等待者数量的
 		      <function>sleepq_sleepcnt()</function> 函数之后的 9.0-CURRENT。</entry>
                   </row>
 		  <row>
 		    <entry>900006</entry>
 		    <entry>January 4, 2010</entry>
 		    <entry>调整了
 		      <function>scandir(3)</function> 和
 			<function>alphasort(3)</function> 函数原型，
 			使其符合 SUSv4 之后的 9.0-CURRENT。</entry>
                   </row>
 		  <row>
 		    <entry>900007</entry>
 		    <entry>January 13, 2010</entry>
 		    <entry>删去了 utmp(5) 并增加了 utmpx (参阅
 		      <function>getutxent(3)</function>)
 		      以改善用户登录日志和系统事件支持之后的 9.0-CURRENT。</entry>
                   </row>
 		  <row>
 		    <entry>900008</entry>
 		    <entry>January 20, 2010</entry>
 		    <entry>9.0-CURRENT 引入了 BSD 授权的 bc/dc
 		      并将 GNU bc/dc 标注为过时之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900009</entry>
 		    <entry>January 26, 2010</entry>
 		    <entry>新增了用于管理网络接口说明的 SIOCGIFDESCR
 		      和 SIOCSIFDESCR ioctl 之后的 9.0-CURRENT。
 		      这组接口受到了 OpenBSD 的启发。</entry>
 		  </row>
 		  <row>
 		    <entry>900010</entry>
 		    <entry>March 22, 2010</entry>
 		    <entry>引入了 zlib 1.2.4 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900011</entry>
 		    <entry>April 24, 2010</entry>
 		    <entry>添加了 soft-updates 日志功能之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900012</entry>
 		    <entry>May 10, 2010</entry>
 		    <entry>添加了 liblzma, xz, xzdec 以及 lzmainfo 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900013</entry>
 		    <entry>May 24, 2010</entry>
 		    <entry>添加了针对 linux(4) 的 USB 修正之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900014</entry>
 		    <entry>Jun 10, 2010</entry>
 		    <entry>添加了 Clang 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900015</entry>
 		    <entry>July 22, 2010</entry>
 		    <entry>引入了 BSD grep 之后的 9.0-CURRENT。</entry>
 		  </row>
  		  <row>
 		    <entry>900016</entry>
 		    <entry>July 28, 2010</entry>
 		    <entry>在 struct malloc_type_internal 中加入了 mti_zone
 		       之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900017</entry>
 		    <entry>August 23, 2010</entry>
 		    <entry>默认 grep 改回使用
 		      GNU grep 并增加 WITH_BSD_GREP 开关之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900018</entry>
 		    <entry>August 24, 2010</entry>
 		    <entry>将 <function>pthread_kill(3)</function>
 		      产生的信号在 si_code 中改为使用 SI_LWP 标记之后的
 		      9.0-CURRENT。 之前， si_code 对应的标志为 SI_USER。</entry>
 		  </row>
 		  <row>
 		    <entry>900019</entry>
 		    <entry>August 28, 2010</entry>
 		    <entry>为 <function>mmap(2)</function> 新增了
 		      MAP_PREFAULT_READ 标志之后的 9.0-CURRENT。</entry>
 		  </row>
  		  <row>
 		    <entry>900020</entry>
 		    <entry>September 9, 2010</entry>
 		    <entry>为 sbuf 增加了 drain 功能并改变了
 		      struct sbuf 布局之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900021</entry>
 		    <entry>September 13, 2010</entry>
 		    <entry>DTrace 增加用户态跟踪支持之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900022</entry>
 		    <entry>October 2, 2010</entry>
 		    <entry>新增了 BSDL man 工具， 并淘汰 GNU/GPL man 工具之后的
 		      9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900023</entry>
 		    <entry>October 11, 2010</entry>
 		    <entry>引入 20101010 git 快照版本 xz 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900024</entry>
 		    <entry>November 11, 2010</entry>
 		    <entry>将 libgcc.a 替换为 libcompiler_rt.a 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900025</entry>
 		    <entry>November 12, 2010</entry>
 		    <entry>引入了模块化拥塞控制之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900026</entry>
 		    <entry>November 30, 2010</entry>
 		    <entry>引入串行管理协议 (SMP) 直通， 以及与之对应的 CAM CCB
 		      XPT_SMP_IO 和 XPT_GDEV_ADVINFO 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900027</entry>
 		    <entry>December 5, 2010</entry>
 		    <entry>在 libm 中增加 log2 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900028</entry>
 		    <entry>December 21, 2010</entry>
 		    <entry>添加了 Hhook (Helper
 		      Hook)、 Khelp (Kernel Helpers) 和 Object Specific Data
 		      (OSD) KPI 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900029</entry>
 		    <entry>December 28, 2010</entry>
 		    <entry>修改 TCP 协议栈使其允许 Khelp 模块通过 helper hook 指针，
 		      与 TCP 控制块交互并保存连接数据之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900030</entry>
 		    <entry>January 12, 2011</entry>
 		    <entry>将 libdialog 更新至版本 20100428 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900031</entry>
 		    <entry>February 7, 2011</entry>
 		    <entry>添加了 <function>pthread_getthreadid_np(3)</function> 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900032</entry>
 		    <entry>February 8, 2011</entry>
 		    <entry>删除了 uio_yield 函数原型和符号之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900033</entry>
 		    <entry>February 18, 2011</entry>
 		    <entry>将 binutils 更新至 2.17.50 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900034</entry>
 		    <entry>March 8, 2011</entry>
 		    <entry>修改了 struct sysvec (sv_schedtail) 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900035</entry>
 		    <entry>March 29, 2011</entry>
 		    <entry>将基本系统中 gcc 和
 		      libstdc++ 升级至最后的 GPLv2 授权版本之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900036</entry>
 		    <entry>April 18, 2011</entry>
 		    <entry>在基本系统中删去了 libobjc 和 Objective-C 支持之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900037</entry>
 		    <entry>May 13, 2011</entry>
 		    <entry>在基本系统中引入了 libprocstat(3)
 		      函数库以及 fuser(1) 工具之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900038</entry>
 		    <entry>May 22, 2011</entry>
 		    <entry>为 VFS_FHTOVP(9) 添加锁标志参数之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900039</entry>
 		    <entry>June 28, 2011</entry>
 		    <entry>引入了来自 OpenBSD 4.5 的 pf 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900040</entry>
 		    <entry>July 19, 2011</entry>
 		    <entry>将 amd64 和 ia64 平台上的 MAXCPU 提高到 64，
 		      并把 XLP (mips) 上的值提高到 128 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900041</entry>
 		    <entry>August 13, 2011</entry>
 		    <entry>实现了 Capsicum
 		      capabilities 之后的 9.0-CURRENT。 fget(9) 新增了权限参数。</entry>
 		  </row>
 		  <row>
 		    <entry>900042</entry>
 		    <entry>August 28, 2011</entry>
 		    <entry>提高修改过 ABI 的动态连接库版本号之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900043</entry>
 		    <entry>September 2, 2011</entry>
 		    <entry>增加了对不支持 SCSI 快取缓存同步功能的 USB
 		      大容量存储设备自动检测功能之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900044</entry>
 		    <entry>September 10, 2011</entry>
 		    <entry>重构了 auto-quirk 之后的 9.0-CURRENT。</entry>
 		  </row>
 		  <row>
 		    <entry>900045</entry>
 		    <entry>Oct 13, 2011</entry>
 		    <entry>将非兼容性系统调用入口点全部增加 sys_ 前缀之后的 9.0-CURRENT。</entry>
 		  </row>
 		</tbody>
 	      </tgroup>
 	    </table>
 
 	<note>
 	  <para>请注意， 2.2.5-RELEASE 之后有一段时间的 2.2-STABLE 会声称自己是
 	    <quote>2.2.5-STABLE</quote>。 这种模式的版本号表示的是年月。
 	    但随后， 我们决定， 从 2.2 开始， 将它改为更为简洁的 主/次
 	    版本号的形式来命名版本。 这是因为并行地在多个分支上进行开发，
 	    使得通过实际的发布日期来区分不同的版本变得不再现实。
 	    如果您正在做新的 port， 应该不需要担心较早的 -CURRENT；
 	    在此列出仅供参考。</para>
 	</note>
       </sect1>
 
       <sect1 xml:id="dads-after-port-mk">
 	<title>在 <filename>bsd.port.mk</filename> 之后写一些内容</title>
 
 	<para>不要在 <literal>.include
 	    &lt;bsd.port.mk&gt;</literal> 这行之后增加任何内容。
 	  这通常可以通过在您的 <filename>Makefile</filename>
 	  中间的某处引用 <filename>bsd.port.pre.mk</filename>，
 	  并在结尾的地方引用
 	  <filename>bsd.port.post.mk</filename> 来避免。</para>
 
 	<note>
 	  <para>只能够采用
 	    <filename>bsd.port.pre.mk</filename>/<filename>bsd.port.post.mk</filename> 或
 	    <filename>bsd.port.mk</filename> 两种写法之一；
 	    任何时候都不要同时使用两种写法。</para>
 	</note>
 
 	<para><filename>bsd.port.pre.mk</filename> 只定义了很少的变量，
 	  它们可以在 <filename>Makefile</filename>
 	  中用于进行一些测试， 而 <filename>bsd.port.post.mk</filename>
 	  则定义了所有其它的变量。</para>
 
 	<para>下面是一些由 <filename>bsd.port.pre.mk</filename>
 	  定义的比较重要的变量 (这并不是一份完整的列表，
 	  您可以阅读 <filename>bsd.port.mk</filename> 以获得全部变量的名字)。</para>
 
 	<informaltable frame="none" pgwide="1">
 	  <tgroup cols="2">
 	    <thead>
 	      <row>
 		<entry>变量</entry>
 		<entry>描述</entry>
 	      </row>
 	    </thead>
 
 	    <tbody>
 	      <row>
 		<entry><varname>ARCH</varname></entry>
 		<entry>由 <command>uname
 		    -m</command> 输出得到的硬件架构的名字
 		  (例如， <literal>i386</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>OPSYS</varname></entry>
 		<entry>由 <command>uname -s</command> 返回的操作系统类型 (例如，
 		  <literal>FreeBSD</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>OSREL</varname></entry>
 		<entry>操作系统的版本号 (例如
 		  <literal>2.1.5</literal> 或
 		  <literal>2.2.7</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>OSVERSION</varname></entry>
 		<entry>操作系统的版本号的数值形式； 它等于
 		  <link linkend="freebsd-versions"><literal>__FreeBSD_version</literal></link>。</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>PORTOBJFORMAT</varname></entry>
 		<entry>系统默认的执行文件格式
 		  (<literal>elf</literal> 或 <literal>aout</literal>；
 		  请注意， <quote>现代的</quote> FreeBSD 版本中，
 		  <literal>aout</literal> 已在淘汰之列。)</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>LOCALBASE</varname></entry>
 		<entry><quote>local</quote> 目录的根 (例如，
 		  <literal>/usr/local/</literal>)</entry>
 	      </row>
 
 	      <row>
 		<entry><varname>PREFIX</varname></entry>
 		<entry>port 应被安装到哪里 (参见 <link linkend="porting-prefix">关于
 		    <varname>PREFIX</varname> 的更多说明</link>)。</entry>
 	      </row>
 	    </tbody>
 	  </tgroup>
 	</informaltable>
 
 	<note>
 	  <para>如果您需要定义
 	    <varname>USE_IMAKE</varname>， <varname>USE_X_PREFIX</varname>， 或
 	    <varname>MASTERDIR</varname> 这些变量， 则应在引用
 	    <filename>bsd.port.pre.mk</filename> 之前完成。</para>
 	</note>
 
 	<para>下面是一些在引用
 	  <filename>bsd.port.pre.mk</filename> 之后可以进行的判断：</para>
 
 	<programlisting># 如果 perl5 已经在系统中提供， 则不必编译 lang/perl5
 .if ${OSVERSION} &gt; 300003
 BROKEN= perl is in system
 .endif
 
 # ELF 只使用一个 shlib 版本
 .if ${PORTOBJFORMAT} == "elf"
 TCL_LIB_FILE=  ${TCL_LIB}.${SHLIB_MAJOR}
 .else
 TCL_LIB_FILE=  ${TCL_LIB}.${SHLIB_MAJOR}.${SHLIB_MINOR}
 .endif
 
 # 软件会自动为 ELF 创建符号链接， 但 a.out 则需要另行创建
 post-install:
 .if ${PORTOBJFORMAT} == "aout"
        ${LN} -sf liblinpack.so.1.0 ${PREFIX}/lib/liblinpack.so
 .endif</programlisting>
 
 	<para>您还记得应该在
 	  <literal>BROKEN=</literal> 和
 	  <literal>TCL_LIB_FILE=</literal> 后面使用制表符，
 	  而不是空格， 对吧？ <!-- smiley -->:-)</para>
       </sect1>
 
       <sect1 xml:id="dads-sh-exec">
 	<title>在 wrapper 脚本中使用 <function>exec</function> 语句</title>
 
 	<para>如果 port 安装了用以启动其他程序的脚本，
 	  并且运行其他程序是这些脚本的最后一项操作，
 	  请务必使用 <function>exec</function> 语句来运行这些程序， 例如：</para>
 
 	<programlisting>#!/bin/sh
 exec %%LOCALBASE%%/bin/java -jar %%DATADIR%%/foo.jar "$@"</programlisting>
 
 	<para>使用 <function>exec</function> 语句表示执行指定的程序来取代 shell
 	  进程。 如果省略了 <function>exec</function>，
 	  则 shell 进程会一直在内存中， 从而不必要地消耗了额外的系统资源。</para>
 
       </sect1>
 
       <sect1 xml:id="dads-rational">
 	<title>理性行事</title>
 
 	<para>任何 <filename>Makefile</filename> 都应该简单并理性地行事。
 	  如果您能让其中的条目更为简单和易读， 一定要这样做。
 	  例如， 使用 make 提供的
 	  <literal>.if</literal> 结构， 而不要使用 shell 的
 	  <literal>if</literal>， 只要能重定义
 	  <varname>EXTRACT*</varname> 就不要重载
 	  <buildtarget>do-extract</buildtarget>， 尽量使用
 	  <varname>GNU_CONFIGURE</varname> 而不是 <literal>CONFIGURE_ARGS
 	    += --prefix=&dollar;{PREFIX}</literal>。</para>
 
 	<para>如果您在尝试做什么事情的时候发现不得不写大量的代码，
 	  请回过头来复审一下
 	  <filename>bsd.port.mk</filename>， 看看是否有您正打算做的事情的现成实现。
 	  尽管读起来可能很费劲， 但有很多貌似很难的问题，
 	  在 <filename>bsd.port.mk</filename> 中都给出了十分简便的解决方案。</para>
       </sect1>
 
       <sect1 xml:id="dads-cc">
 	<title>遵循 <varname>CC</varname> 和
 	  <varname>CXX</varname> 设置</title>
 
 	<para>port 应遵循 <varname>CC</varname>
 	  和 <varname>CXX</varname> 变量的设置。
 	  这也就是说， port 不应使用绝对的方式来设置这个变量的值，
 	  而罔顾已经存在的设置； 与此相反， 它应该在其值后加入需要的其它值。
 	  这样， 就可以设置全局的联编选项， 令其影响所有的 port 联编过程了。</para>
 
 	<para>如果实在无法这样做， 请在 <filename>Makefile</filename>
 	  中加入 <literal>NO_PACKAGE=ignores
 	    cflags</literal>。</para>
 
 	<para>下面的 <filename>Makefile</filename>
 	  实例给出了如何遵循 <varname>CC</varname> 和 <varname>CXX</varname>
 	  变量的设置。 注意这里用到的 <varname>?=</varname>：</para>
 
 	<programlisting>CC?= gcc</programlisting>
 	<programlisting>CXX?= g++</programlisting>
 
 	<para>下面则是没有遵循
 	  <varname>CC</varname> 和 <varname>CXX</varname>
 	  的例子：</para>
 
 	<programlisting>CC= gcc</programlisting>
 	<programlisting>CXX= g++</programlisting>
 
 	<para>在 FreeBSD 系统中，
 	  <varname>CC</varname> 和 <varname>CXX</varname>
 	  这两个变量都可以在
 	  <filename>/etc/make.conf</filename> 中自行定义。
 	  第一个例子只有在
 	  <filename>/etc/make.conf</filename> 中没有定义时才对这两个变量进行定义，
 	  从而保持了系统范围的配置。 而第二个例子则会覆盖任何现有的配置。</para>
       </sect1>
 
       <sect1 xml:id="dads-cflags">
 	<title>遵循 <varname>CFLAGS</varname></title>
 
 	<para>您的 port 应遵循 <varname>CFLAGS</varname> 变量的设置。
 	  这也就是说， port 不应使用绝对的方式来设置这个变量的值，
 	  而罔顾已经存在的设置； 与此相反， 它应该在其值后加入需要的其它值，
 	  这样， 就可以设置全局的联编选项， 令其影响所有的 port 联编过程了。</para>
 
 	<para>如果实在无法这样做， 请在 <filename>Makefile</filename>
 	  中加入 <literal>NO_PACKAGE=ignores
 	    cflags</literal>。</para>
 
 	<para>下面的 <filename>Makefile</filename> 例子，
 	  可以帮助我们理解如何遵循 <varname>CFLAGS</varname> 的设置。 注意所用的
 	  <varname>+=</varname>：</para>
 
 	<programlisting>CFLAGS+= -Wall -Werror</programlisting>
 
 	<para>下面是一个未能遵循
 	  <varname>CFLAGS</varname> 设置的例子：</para>
 
 	<programlisting>CFLAGS= -Wall -Werror</programlisting>
 
 	<para>一般来说， <varname>CFLAGS</varname> 在
 	  FreeBSD 系统中是在 <filename>/etc/make.conf</filename> 里配置的。
 	  第一个例子在
 	  <varname>CFLAGS</varname> 变量中增加了一些参数，
 	  并保持了所有系统预定义的标志。 而第二个例子，
 	  则会覆盖掉任何先前定义的参数。</para>
 
 	<para>您应从第三方软件的
 	  <filename>Makefile</filename> 中去掉特殊的优化设置。
 	  系统的 <varname>CFLAGS</varname> 给出了全系统范围内的优化设置参数。
 	  下面是一个未经修改的 <filename>Makefile</filename>
 	  实例：</para>
 
 	<programlisting>CFLAGS= -O3 -funroll-loops -DHAVE_SOUND</programlisting>
 
 	<para>如果使用系统的优化参数， 则
 	  <filename>Makefile</filename> 中的设置应该类似下面这样：</para>
 
 	<programlisting>CFLAGS+= -DHAVE_SOUND</programlisting>
 
       </sect1>
 
       <sect1 xml:id="dads-pthread">
 	<title>线程库</title>
 
 	<para>在 &os; 上， 线程库必须通过特殊的连接器参数
 	  <literal>-pthread</literal> 连接到可执行文件。 如果 port 一定要直接连接
 	  <literal>-lpthread</literal> 或 <literal>-lc_r</literal>，
 	  则应将其改为使用由 ports 框架提供的 <varname>PTHREAD_LIBS</varname>。
 	  这个变量的值通常是 <literal>-pthread</literal>，
 	  但在某些特定平台上的 &os; 版本中， 它可能是其它值， 因此， 不要将
 	  <literal>-pthread</literal> 硬编码到您的补丁中， 而应使用
 	  <varname>PTHREAD_LIBS</varname> 变量。</para>
 
 	<note>
 	  <para>如果设置了 <varname>PTHREAD_LIBS</varname>，
 	    而在联编时出现 <literal>unrecognized
 	    option '-pthread'</literal> 这样的错误， 可能需要通过将
 	    <varname>CONFIGURE_ENV</varname> 设为 <literal>LD=${CC}</literal>
 	    来使用
 	    <command>gcc</command> 作为连接器。
 	    <literal>-pthread</literal> 这一选项并不为
 	    <command>ld</command> 所直接支持。</para>
 	  </note>
 
       </sect1>
 
       <sect1 xml:id="dads-freedback">
 	<title>反馈</title>
 
 	<para>如果进行了一些很好的修改和补丁， 一定要把它们发回给原作者，
 	  或维护者， 以便在下一版本的代码中包含它们。
 	  这会让您在软件发布新版本的时候变得轻松一些。</para>
       </sect1>
 
       <sect1 xml:id="dads-readme">
 	<title><filename>README.html</filename></title>
 
 	<para>不要包含 <filename>README.html</filename> 文件。
 	  这个文件并非 CVS 代码库中的一部分， 它是由
 	  <command>make readme</command> 命令生成的。
 	</para>
       </sect1>
 
       <sect1 xml:id="dads-noinstall">
 	<title>使用 <varname>BROKEN</varname>、
 	  <varname>FORBIDDEN</varname> 或 <varname>IGNORE</varname>
 	  阻止用户安装 port</title>
 
 	<para>某些时候会需要阻止用户安装某个 port。
 	  想要告诉用户某个 port 不应被安装， 有许多可以在 port 的
 	  <filename>Makefile</filename> 中使用的
 	  <command>make</command> 变量。 下列
 	  <command>make</command> 的值， 将是在用户试图安装时得到的提示信息。
 	  务请使用正确的 <command>make</command> 变量，
 	  因为每一个都表达了截然不同的意义， 而且许多自动化系统， 例如
 	<link linkend="build-cluster">port 联编集群</link>、
 	<link linkend="freshports">FreshPorts</link>， 以及
 	<link linkend="portsmon">portsmon</link>， 都依赖于
 	  <filename>Makefile</filename> 的正确性。</para>
 
 	<sect2 xml:id="dads-noinstall-variables">
 	  <title>变量</title>
 
 	<itemizedlist>
 	  <listitem>
 	    <para><varname>BROKEN</varname> 专门用于表达目前无法正确编译、
 	      安装或卸载这类问题。 如果是临时性的问题， 则可以使用它。</para>
 
 	    <para>如果进行了相关的配置， 则联编集群仍将尝试联编它，
 	      以确认导致问题的深层问题是否已被解决。 (不过， 一般情况下，
 	      联编集群并不会这样做。)</para>
 
 	    <para>举例来说， 当 port 发生下述情况时， 应使用
 	      <varname>BROKEN</varname>：</para>
 
 	    <itemizedlist>
 	      <listitem>
 		<para>无法编译 (does not compile)</para>
 	      </listitem>
 
 	      <listitem>
 		<para>无法正确进行配置或安装操作</para>
 	      </listitem>
 
 	      <listitem>
 		<para>在
 		  <filename>${LOCALBASE}</filename> 以外的地方安装文件</para>
 	      </listitem>
 
 	      <listitem>
 		<para>卸载时无法删除所安装的全部文件 (不过，
 		  留下用户改过的文件可接受的， 因为可能希望这样作)</para>
 	      </listitem>
 	    </itemizedlist>
 
 	  </listitem>
 
 	  <listitem>
 	    <para><varname>FORBIDDEN</varname> 用于表示 ports 中包含安全漏洞，
 	      或者可能会给安装了这个 port 的 FreeBSD
 	      系统带来严重的安全隐患 (例如： 一个很不安全的程序，
 	      或包含了能够被轻易攻陷的服务的软件)。 如果发现了安全漏洞，
 	      而其作者没有发布升级版本， 则应立即把那个
 	      port 标记为 <varname>FORBIDDEN</varname>。
 	      理想情况下， 包含安全漏洞的 port 应被尽快升级，
 	      以便减少包含漏洞的 FreeBSD 主机的数量
 	      (我们希望保持良好的安全记录)， 然而，
 	      有时在安全漏洞的披露和软件更新之间可能会有一个间隔，
 	      此时应予以说明。 除了安全之外， 请不要以任何其它理由将 port 标记为
 	      <varname>FORBIDDEN</varname>。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para><varname>IGNORE</varname> 用来表示 port
 	      由于某些其它原因不应予以联编。 如果认为发生了结构性的问题，
 	      则应使用它。 任何情况下，
 	      联编集群都不会联编标记为
 	      <varname>IGNORE</varname> 的 port。 以下是使用
 	      <varname>IGNORE</varname> 的一些例子：</para>
 
 	    <itemizedlist>
 	      <listitem>
 		<para>能够编译但无法正常运行</para>
 	      </listitem>
 
 	      <listitem>
 		<para>无法与运行的 &os; 版本一同工作</para>
 	      </listitem>
 
 	      <listitem>
 		<para>联编时需要 &os; 内核的源代码，
 		  但用户没有安装它们</para>
 	      </listitem>
 
 	      <listitem>
 		<para>由于授权原因， 必须手工下载 distfile</para>
 	      </listitem>
 
 	      <listitem>
 		<para>无法与的某个已安装的 port 一同工作 (例如， port 依赖于
 		  <package>www/apache21</package> 而安装的则是
 		  <package>www/apache13</package>)</para>
 	      </listitem>
 	    </itemizedlist>
 
 	    <note>
 	      <para>如果 port 与某个已经安装的
 		port 冲突 (例如， 它们在同一位置安装同名但功能不同的文件)，
 		则应 <link linkend="conflicts">使用
 		<varname>CONFLICTS</varname> 来标记它</link>。
 		<varname>CONFLICTS</varname> 将自动地设置
 		<varname>IGNORE</varname>。</para>
 	    </note>
 	  </listitem>
 
 	  <listitem>
 	    <para>如果 port 只应在某些平台上标记为 <varname>IGNORE</varname>，
 	      还有另外两个方便使用的
 	      <varname>IGNORE</varname> 变量可供选择：
 	      <varname>ONLY_FOR_ARCHS</varname> 和
 	      <varname>NOT_FOR_ARCHS</varname>。 例如：</para>
 
 	    <programlisting>ONLY_FOR_ARCHS= i386 amd64</programlisting>
 
 	    <programlisting>NOT_FOR_ARCHS= alpha ia64 sparc64</programlisting>
 
 	    <para>可以使用 <varname>ONLY_FOR_ARCHS_REASON</varname> 和
 	      <varname>NOT_FOR_ARCHS_REASON</varname> 来配置定制的
 	      <varname>IGNORE</varname> 消息。 此外， 还可以使用
 	      <varname>ONLY_FOR_ARCHS_REASON_<replaceable>ARCH</replaceable></varname>
 	      和
 	      <varname>NOT_FOR_ARCHS_REASON_<replaceable>ARCH</replaceable></varname>
 	      来分别指定与具体平台有关的信息。</para>
 	  </listitem>
 
 	  <listitem>
 	    <para>如果 port 会下载并安装用于 i386 的预编译二进制文件， 则应设置
 	      <varname>IA32_BINARY_PORT</varname>。 如果设置了这个变量，
 	      则系统会检查是否已经在
 	      <filename>/usr/lib32</filename> 目录中安装了
 	      IA32 版本的函数库， 以及内核是否提供了 IA32 兼容支持。
 	      如果这些依赖条件不满足， 则会自动设置
 	      <varname>IGNORE</varname>。</para>
 	  </listitem>
 
 	</itemizedlist>
 
 	</sect2>
 	<sect2 xml:id="dads-noinstall-notes">
 	  <title>实现说明</title>
 
 	  <para>这些字串不应使用引号括起来。 此外， 由于显示给用户的方式不同，
 	    这些字串的措辞也应有所不同。 例如：</para>
 
 	  <programlisting>BROKEN= this port is unsupported on FreeBSD 5.x</programlisting>
 
 	  <programlisting>IGNORE= is unsupported on FreeBSD 5.x</programlisting>
 
 	  <para>它们分别会在
 	    <command>make describe</command> 时产生下面的输出：</para>
 
 	  <programlisting>===&gt;  foobar-0.1 is marked as broken: this port is unsupported on FreeBSD 5.x.</programlisting>
 
 	  <programlisting>===&gt;  foobar-0.1 is unsupported on FreeBSD 5.x.</programlisting>
 	</sect2>
       </sect1>
 
       <sect1 xml:id="dads-deprecated">
 	<title>使用 <varname>DEPRECATED</varname>
 	  或 <varname>EXPIRATION_DATE</varname> 表示某个 port 将被删除</title>
 
 	<para>一定要记得 <varname>BROKEN</varname> 和
 	  <varname>FORBIDDEN</varname> 只应作为当某个 port
 	  无法正常工作时的临时解决方案。 永久性地坏掉了的 port 应被从 ports tree
 	  中完全删除。</para>
 
 	<para>需要时还可以使用 <varname>DEPRECATED</varname>
 	  和 <varname>EXPIRATION_DATE</varname> 来通知用户某个 port
 	  不应被使用， 并即将被删除。 前一个变量用来表达为什么计划删除 port；
 	  而后一个是则是一个 ISO 8601 格式的日期 (YYYY-MM-DD)。
 	  两者都会向用户呈现。</para>
 
 	<para>也可以设置 <varname>DEPRECATED</varname>
 	  而不给出 <varname>EXPIRATION_DATE</varname> (例如，
 	  建议使用某个新版本的 port)， 但反之则没有意义。</para>
 
 	<para>目前还没有确切的关于需要给出多少通知的政策。
 	  当前的实践是， 对于与安全有关的问题为一个月，
 	  而与联编有关的问题则为两个月。 这也让有兴趣的 committer
 	  能够有一点时间来修正问题。</para>
       </sect1>
 
       <sect1 xml:id="dads-dot-error">
 	<title>避免使用 <literal>.error</literal> 结构</title>
 
 	<para>在 <filename>Makefile</filename> 中给出信号，
 	  表示由于某种外界因素 (例如， 用户指定了无效的联编选项)
 	  而无法安装的方法是将变量
 	  <varname>IGNORE</varname> 设为一非空值。 这个值将被格式化，
 	  并在用户执行 <command>make install</command> 是给出提示。</para>
 
 	<para>用 <literal>.error</literal> 实现这一目的是一种常见的误用。
 	  这样做的问题是， 许多在 ports 树上运行的自动化工具会因此而失败。
 	  最常见的情况见于联编 <filename>/usr/ports/INDEX</filename> 的过程
 	  (参见 <xref linkend="make-describe"/>)。 然而， 即使十分普通的命令，
 	  例如 <command>make maintainer</command>，
 	  在这种情况下也会失败。 这是不可接受的。</para>
 
 	<example xml:id="dot-error-breaks-index">
 	  <title>怎样避免使用 <literal>.error</literal></title>
 	  <para>考虑有人在 <filename>make.conf</filename> 中设置了
 	    <programlisting>USE_POINTYHAT=yes</programlisting>
 	    的情形。 接下来的例子中， 第一个 <filename>Makefile</filename>
 	    中的问题将导致 <command>make index</command> 失败，
 	    而第二个则不会：</para>
 	    <programlisting>.if USE_POINTYHAT
 .error "POINTYHAT is not supported"
 .endif</programlisting>
 	    <programlisting>.if USE_POINTYHAT
 IGNORE=POINTYHAT is not supported
 .endif</programlisting>
 	</example>
 
       </sect1>
 
       <sect1 xml:id="dads-sysctl">
 	<title>对于 <filename>sysctl</filename> 的使用</title>
 
 	<para>除了在 target 中之外， 是不鼓励使用 <filename>sysctl</filename>
 	  的。 这是因为计算
 	  <literal>makevar</literal>， 例如在
 	  <command>make index</command> 中所进行的那种，
 	  都不得不运行一条命令， 这会使这一操作变得更慢。</para>
 
 	<para>在使用 &man.sysctl.8; 时，
 	  务必通过 <varname>SYSCTL</varname> 变量来进行，
 	  因为此变量将展开成命令的完整路径， 并且用户可以根据需要另行指定。</para>
       </sect1>
 
       <sect1 xml:id="dads-rerolling-distfiles">
 	<title>重新发布的 distfiles</title>
 
 	<para>有时， 一些软件的作者会修改业已发布的 distfile 的内容，
 	  而并不修改文件名。 这种情况下， 您需要验证这些变动是来自软件作者的官方改动。
 	  在过去， 曾经发生过下载服务器上的 distfile 被悄悄换成注入过恶意代码的版本，
 	  并给用户安全造成威胁或损害的事情。</para>
 
 	<para>您应保留一份旧的 distfile， 并下载一份新的， 分别展开，
 	  用 &man.diff.1; 来对比其内容。 如果没有发现可疑的变动，
 	  就可以更新 <filename>distinfo</filename> 了。
 	  请务必在您的 PR 或 commit log 中对这些差异进行描述，
 	  以便让别人了解您已经仔细对比过差异， 并确认没有问题了。</para>
 
 	<para>除此之外， 也可以联系软件的作者， 以确认这些修改是否是他们做的。</para>
       </sect1>
 
       <sect1 xml:id="dads-misc">
 	<title>杂记</title>
 
 	<para>需要仔细地反复检查
 	  <filename>pkg-descr</filename> 和 <filename>pkg-plist</filename>
 	  这两个文件。 如果您正在复审一个 port，
 	  并认为这两个文件应该改进， 请一定要这样做。</para>
 
 	<para>请不要在系统中复制多份 GNU General Public License。</para>
 
 	<para>一定要非常小心地处理法律问题！
 	  不要让我们发布没有得到合法授权的软件！</para>
       </sect1>
 
     </chapter>
 
     <chapter xml:id="porting-samplem">
       <title>示范的 <filename>Makefile</filename></title>
 
       <para>这里是一个您可以在建立新 port 时参考的
 	<filename>Makefile</filename>。 请务必删除不需要的那些注释
 	(方括号中间的文字)！</para>
 
       <para>建议您按照下面这样的格式 (变量顺序， 小节之间的空行等) 来编写。
 	这个格式的作用是便于查找重要的信息。 我们建议您使用 <link linkend="porting-portlint">portlint</link> 来检查
 	<filename>Makefile</filename>。</para>
 
       <programlisting>[头部... 主要是让我们更容易地分辨不同的 port。]
 # New ports collection makefile for:   xdvi
 [版本这行， 只有在 PORTVERSION 变量不足以描述 port 时才需要]
 # Date created:                26 May 1995
 [这是最初将软件移植到 FreeBSD 上的日期， 一般来说是建立这份 Makefile 的日期。
 请注意不要在之后再次修改这个日期。]
 # Whom:                        Satoshi Asami &lt;asami@FreeBSD.org&gt;
 #
 # &dollar;FreeBSD&dollar;
 [ ^^^^^^^^^ 这是 CVS 在文件 commit 到我们的代码库时， 自动进行替换的 RCS ID。
 如果您正在升级 port， 不要把它改回 "&dollar;FreeBSD&dollar;"。
 CVS 会自动进行处理。]
 #
 
 [这个小节描述 port 本身以及主要下载站点 - PORTNAME 和 PORTVERSION
  应放在最前面， 随后是 CATEGORIES， 然后是 MASTER_SITES， 接下来是
  MASTER_SITE_SUBDIR。 如果需要的话， 接下来应指定
  PKGNAMEPREFIX 和 PKGNAMESUFFIX。 随后是 DISTNAME， EXTRACT_SUFX，
  以及 DISTFILES， EXTRACT_ONLY， 如果需要的话。]
 PORTNAME=      xdvi
 PORTVERSION=   18.2
 CATEGORIES=    print
 [如果不想使用 MASTER_SITE_* 宏， 一定不要忘记结尾的斜线 ("/")！]
 MASTER_SITES=  ${MASTER_SITE_XCONTRIB}
 MASTER_SITE_SUBDIR= applications
 PKGNAMEPREFIX= ja-
 DISTNAME=      xdvi-pl18
 [如果源代码包不是标准的 ".tar.gz" 形式， 就需要设置这个]
 EXTRACT_SUFX=  .tar.Z
 
 [分散的补丁 -- 可以为空]
 PATCH_SITES=   ftp://ftp.sra.co.jp/pub/X11/japanese/
 PATCHFILES=    xdvi-18.patch1.gz xdvi-18.patch2.gz
 
 [监护人(maintainer); *必须有*!  这是某个资源处理 port 更新、 联编失败，
  以及回答用户直接提问或汇报 bug 的人。 为了保证 Ports Collection
  有尽可能高的品质， 我们不再接受指定给 "ports@FreeBSD.org" 的新 port。]
 MAINTAINER=    asami@FreeBSD.org
 COMMENT=       A DVI Previewer for the X Window System
 
 [依赖的其它软件包 -- 可以为空]
 RUN_DEPENDS=   gs:${PORTSDIR}/print/ghostscript
 LIB_DEPENDS=   Xpm.5:${PORTSDIR}/graphics/xpm
 
 [这节是其它不适合上几节的标准 bsd.port.mk 变量]
 [如果需要在 configure、 build 或 install 过程中提问...]
 IS_INTERACTIVE=        yes
 [如果解压缩到 ${DISTNAME} 以外的目录...]
 WRKSRC=                ${WRKDIR}/xdvi-new
 [如果作者发布的补丁不是相对于 ${WRKSRC} 的， 可能需要调整这个]
 PATCH_DIST_STRIP=      -p1
 [如果需要运行由 GNU autoconf 生成的 "configure" 脚本]
 GNU_CONFIGURE= yes
 [如果需要使用 GNU make， 而不是 /usr/bin/make 来完成联编...]
 USE_GMAKE=     yes
 [如果是一个 X 应用程序， 并使用 "xmkmf -a" 来运行...]
 USE_IMAKE=     yes
 [et cetera.]
 
 [将在接下来的部分使用的非标准的变量]
 MY_FAVORITE_RESPONSE=  "yeah, right"
 
 [接下来是特殊规则， 按调用顺序排列]
 pre-fetch:
 	i go fetch something, yeah
 
 post-patch:
 	i need to do something after patch, great
 
 pre-install:
 	and then some more stuff before installing, wow
 
 [结语]
 .include &lt;bsd.port.mk&gt;</programlisting>
     </chapter>
 
     <chapter xml:id="keeping-up">
       <title>保持同步</title>
 
       <para>&os; 的 Ports Collection 在持续地进行修改。
 	这里提供了一些关于如何保持同步的信息。</para>
 
       <sect1 xml:id="freshports">
 	<title>FreshPorts</title>
 
 	<para>最简单的了解已经被 commit 到 ports 中的更新的方法， 是订阅
 	  <link xlink:href="http://www.FreshPorts.org/">FreshPorts</link>。
 	  您可以选择多个 ports 并对其进行监视。 强烈建议维护人员订阅它，
 	  这样就不仅能接收到他们自己所做的修改， 而且能看到其它 &os;
 	  committer 所做的改动。 (保持与所依赖的
 	  ports 框架同步是必要的&mdash;虽然一般来说您会在这样的 commit
 	  之前收到一个礼貌性的通知， 但有时可能会有人没有注意到需要这样做，
 	  或者这样做很困难。 另外， 有些时候通知的修改也可能是微不足道的。
 	  我们希望每一个人能够正确地进行判断。)</para>
 
 	<para>如果想使用 FreshPorts， 之需要建立一个账号。 如果您注册的邮件地址是
 	  <literal>@FreeBSD.org</literal>， 您会看到 web 页面右侧的 opt-in
 	  连接。 如果您已经注册了 FreshPorts 账号，
 	  但没有使用 <literal>@FreeBSD.org</literal> 邮件地址，
 	  则只需把邮件地址改为 <literal>@FreeBSD.org</literal>， 重新订阅，
 	  并将其改回。</para>
 
 	<para>FreshPorts 也会对每一个 FreeBSD ports tree 上的 commit
 	  进行自动的合法性检查。 如果您订阅了这项服务， 则如果发现了错误，
 	  就会收到来自 FreshPorts 的检测报告。</para>
       </sect1>
 
       <sect1 xml:id="cvsweb">
 	<title>代码库的 Web 访问界面</title>
 
 	<para>可以通过 web 界面来浏览源代码库中的文件。
 	  影响整个 ports 系统的修改， 现在都会在
 	  <link xlink:href="http://cvsweb.FreeBSD.org/ports/CHANGES">
 	  CHANGES</link> 文件中说明。 影响某一个 port 的变动， 则在
 	  <link xlink:href="http://cvsweb.FreeBSD.org/ports/UPDATING">
 	  UPDATING</link> 文件中说明。 尽管如此， 所有问题最为权威的答案，
 	  毫无疑问应该是 <link xlink:href="http://cvsweb.FreeBSD.org/ports/Mk/bsd.port.mk">
 	  bsd.port.mk</link> 的源代码， 以及相关的文件。</para>
 
       </sect1>
 
       <sect1 xml:id="ports-mailling-list">
 	<title>&os; Ports 邮件列表</title>
 
 	<para>如果您维护了某个或某一些 ports， 则应该考虑订阅
 	  &a.ports;。 对于 ports 工作方式的重要修改都会在此宣示，
 	  并提交到 <filename>CHANGES</filename>。</para>
 
       </sect1>
 
       <sect1 xml:id="build-cluster">
 	<title>位于 <systemitem class="fqdomainname">pointyhat.FreeBSD.org</systemitem>
 	   的 &os; Port 联编集群</title>
 
 	  <para>&os; 的一个最不为人所知的强项是，
 	    它拥有一个专用于持续联编 Ports Collection 的集群，
 	    这个集群会联编所有主要的 OS 版本在每一个 Tier-1 架构上的 package。
 	    您可以在
 	    <link xlink:href="http://pointyhat.FreeBSD.org/">package
 	    联编和错误日志</link> 找到其结果。</para>
 
 	  <para>每一个 port 都会被联编，
 	    除非标记为 <varname>IGNORE</varname>。
 	    标记了 <varname>BROKEN</varname> 的 port 仍然会被继续尝试，
 	    以了解是否某些依赖关系的变动解决了其问题
 	    (这是通过给 port 的 <filename>Makefile</filename> 传
 	    <varname>TRYBROKEN</varname> 参数来完成的)。</para>
 
       </sect1>
 
       <sect1 xml:id="distfile-survey">
 	<title>&os; 的 Ports Distfile 扫描器</title>
 
 	  <para>联编集群是一组专门用于联编所有 port 最新版本的机器，
 	    其上已经下载了所有的 distfiles。 然而， 由于 Internet 在持续地发生变化，
 	    distfile 可能很快就消失了。 <link xlink:href="https://portscout.freebsd.org">FreeBSD
 	    Ports distfile 扫描器</link> 试图查询每一个 port 的所有下载站点，
 	    以期找出这些文件是否依然存在。 维护者应规律性地检查这些报告，
 	    这不仅会提高用户联编的速度， 同时也避免了浪费那些镜像了全部
 	    distfile 的志愿者的带宽。</para>
 
       </sect1>
 
       <sect1 xml:id="portsmon">
 
 	<title>&os; 的 Ports 追踪系统</title>
 
 	<para>另一个非常方便的资源， 就是
 	  <link xlink:href="http://portsmon.FreeBSD.org">
 	  FreeBSD Ports 追踪系统</link> (也被称作
 	  <literal>portsmon</literal>)。
 	  这个系统包含了一个处理若干信息来源的数据库，
 	  并提供了一个可以通过 web 方式浏览的界面。 目前，
 	  它利用到了和 ports 有关的问题报告 (PR)、 来自联编集群的错误日志，
 	  以及来自 Ports Collection 的文件所提供的信息。
 	  未来， 还会对它进行进一步的扩展， 从而提供包括 distfile 普查，
 	  以及其它来源在内的更多信息。</para>
 
 	<para>要使用这个工具， 可以从查看关于某一个 port 的全部资料的
 	  <link xlink:href="http://portsmon.FreeBSD.org/portoverview.py">
 	  Port 的纵览</link> 开始。</para>
 
 	<para>本文撰写时, 这是唯一一个能够将 GNATS PR 项，
 	  同对应的 port 名字映射起来的资源。 (提交 PR 的用户，
 	  有时并不在 Synopsis (概要) 中指明 port 的名字，
 	  尽管我们希望他们这样做)。 因此， <literal>portsmon</literal>
 	  在您想要查找是否有人提交某个现存的 port 的 PR，
 	  以及它的联编是否出现了错误； 或在您创建新的 port
 	  之前想要查找一下是否已经有人提交过时， 就非常有用了。</para>
       </sect1>
 
     </chapter>
 </book>
diff --git a/zh_CN.UTF-8/htdocs/about.xml b/zh_CN.UTF-8/htdocs/about.xml
index f76dc5a412..3d1664b2d5 100644
--- a/zh_CN.UTF-8/htdocs/about.xml
+++ b/zh_CN.UTF-8/htdocs/about.xml
@@ -1,106 +1,106 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
 "http://www.FreeBSD.org/XML/doc/share/xml/xhtml10-freebsd.dtd" [
 <!ENTITY title "关于 FreeBSD">
 ]>
 
 <!-- The FreeBSD Simplified Chinese Documentation Project -->
-<!-- Original Revision: r53599 -->
+<!-- Original Revision: 075f173f8e (r53599) -->
 
 <html xmlns="http://www.w3.org/1999/xhtml">
     <head>
       <title>&title;</title>
 
       <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
     </head>
 
     <body class="navinclude.about">
 
 		<h2>FreeBSD 是什么?</h2>
 
 		      <p>FreeBSD 是一个注重功能、速度和稳定性的操作系统，支持 <a
 		        href="&base;/platforms/">许多平台</a>。
 		      它源于 BSD ── 美国加州大学伯克利分校开发的 &unix; 版本。
 		      它由 <a
 		        href="&enbase;/doc/en_US.ISO8859-1/articles/contributors/staff-committers.html">一个很大的志愿者社区</a>
 		      开发和维护。</p>
 
 		      <h2>先进特性</h2>
 
 		      <p>FreeBSD 提供了网络、性能、安全以及兼容性等多方面的
 		      <a href="&base;/features.html">特性</a>，
 			这些特性即使是在当今最优秀的商业操作系统中亦有所欠缺。</p>
 
 		      <h2>强大的互联网解决方案</h2>
 
 		      <p>FreeBSD 是理想的 Internet 或 Intranet
 		      服务器。即使是在超重负载下，它仍然能够有效地使用内存，
 		      为同时运行的数以千计的用户进程提供良好的响应时间。</p>
 
 		      <h2>嵌入式平台支持</h2>
 
 		      <p>FreeBSD 为嵌入式平台和设备带来了先进的网络操作系统特性，
 		      无论是高端的基于 Intel 的设备，还是 ARM、PowerPC
 		      或 MIPS 硬件平台。从邮件和网络设备到路由器、
 		      校时服务器和无线接入点，世界各地的供应商依赖 FreeBSD
 		      的整合编译和交叉编译环境以及其它先进特性，
 		      以此作为他们嵌入式产品的基础。
 		      而伯克利开放源代码许可证让他们得以自主决定要贡献哪些改动。
 		      </p>
 
 		      <h2>能够运行大量可供选择的应用</h2>
 
 		      <p>经由 ports 中超过 33,000 个库和 <a
 		        href="&base;/applications.html">应用程序</a>，
 		      FreeBSD 支持桌面系统、服务器和嵌入式平台的各种应用。
 		      </p>
 
 		      <h2>易于安装</h2>
 
 		      <p>FreeBSD 能通过多种介质进行安装，包括普通光盘、
 		      DVD 光盘，或直接通过 FTP 或 NFS 服务器安装。
 			您只需按照 <a
                     href="&enbase;/doc/zh_CN.UTF-8/books/handbook/install.html">安装指导</a>
 		      操作。</p>
 
 		      <h2>FreeBSD 是 <i>free</i> 的</h2>
 
 		      <a href="&base;/copyright/daemon.html"><img src="&enbase;/gifs/dae_up3.gif"
 								  alt="BSD 守护精灵"
 								  height="81" width="72"
 								  align="right"
 								  border="0"/></a>
 
 		      <p>您或许认为如此优秀的操作系统需要花费大笔金钱来购买，
 		      而 FreeBSD 是<a
 		        href="&base;/copyright/index.html">免费</a> 提供的，
 		      并且包含了源代码。
 		      如果您愿意购买或下载一份来体验 FreeBSD，
 		      可以从 <a
 		        href="&enbase;/doc/zh_CN.UTF-8/books/handbook/mirrors.html">这里</a>
 		      了解更多信息。</p>
 
 		      <h2>帮助 FreeBSD</h2>
 
 		      <p>帮助 FreeBSD 并不困难。您需要做的，
 		      就是找出 FreeBSD 需要改进的地方，并将您
 		      (经过精心编写和整理过) 的改进通过提交问题报告的方式发回
 		      FreeBSD 项目，者直接转交给您认识的
 		      FreeBSD committer。我们欢迎包括从文档到艺术作品，
 		      乃至源代码在内的任何改进。此外，您还可以通过 <a
                     href="&enbase;/doc/zh_CN.UTF-8/articles/contributing/index.html">帮助 FreeBSD</a>
 		      这篇文章了解更多信息。</p>
 
 		      <p>即使您不是开发人员，也仍然可以通过其他途径帮助 FreeBSD。
 		      <a
 		        href="https://www.freebsdfoundation.org">FreeBSD 基金会</a>
 		      是一个非营利性组织，对其捐款是完全免税的。
 		      要了解更多有关 FreeBSD 基金会的信息，
 		      请和 <a
 			  href="mailto:info&#64;FreeBSDFoundation.org">info&#64;FreeBSDFoundation.org</a>
 		      联系，或致信：
 		      The FreeBSD Foundation, 
 		      2222 14th Street, Boulder, CO 80302 USA.</p>
 
   </body>
 </html>
diff --git a/zh_CN.UTF-8/htdocs/community.xsl b/zh_CN.UTF-8/htdocs/community.xsl
index 5d3c0e3dcb..5ea8595148 100644
--- a/zh_CN.UTF-8/htdocs/community.xsl
+++ b/zh_CN.UTF-8/htdocs/community.xsl
@@ -1,147 +1,147 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE xsl:stylesheet PUBLIC "-//FreeBSD//DTD FreeBSD XSLT 1.0 DTD//EN"
 				"http://www.FreeBSD.org/XML/share/xml/xslt10-freebsd.dtd" [
 <!ENTITY title "FreeBSD 社区">
 ]>
 
 <!-- $FreeBSD$ -->
 <!-- The FreeBSD Simplified Chinese Documentation Project -->
-<!-- Original Revision: r52000 -->
+<!-- Original Revision: 2bc0aef911 (r52000) -->
 
 <xsl:stylesheet version="1.0"
   xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
   xmlns:date="http://exslt.org/dates-and-times"
   xmlns="http://www.w3.org/1999/xhtml"
   extension-element-prefixes="date">
 
   <xsl:import href="http://www.FreeBSD.org/XML/lang/share/xml/libcommon.xsl"/>
   <xsl:import href="http://www.FreeBSD.org/XML/share/xml/xhtml.xsl"/>
 
   <xsl:variable name="title">&title;</xsl:variable>
 
   <xsl:key name="last-year-event-by-country" match="event[number(enddate/year) = (number(date:year()) - 1)]"
     use="location/country" />
 
   <xsl:key name="event-by-year" match="event" use="enddate/year" />
 
   <xsl:template name="process.sidewrap">
     &nav.community;
   </xsl:template>
 
   <xsl:template name="process.contentwrap">
 	      <p>有超过一百个 <a href="&enbase;/community/mailinglists.html">邮件列表</a>，
 		许多网页 <a href="https://forums.FreeBSD.org/">论坛</a>，
 		以及几个 <a
     href="&enbase;/doc/en_US.ISO8859-1/books/handbook/eresources-news.html">新闻组</a>
 		可供您查看。 在世界上 <xsl:value-of
 		select="count(document($usergroups.xml)//country)" />
 		个不同的国家有超过 <xsl:value-of
 		select="count(document($usergroups.xml)//entry)"/><xsl:text>
 		</xsl:text> 个 <a href="&enbase;/usergroups.html">用户群组</a>，
 		和一个活跃的 <a href="&enbase;/community/irc.html">IRC</a> 社区。
 		很多开发者维护了各种 <a href="https://planet.freebsd.org">博客</a>
 		来展示他们为 &os; 所做的工作。 开发者和关键的贡献者也维护了一个 <a
 		href="https://wiki.FreeBSD.org/">wiki</a>， 其中包括了 &os;
 		开发进度和相关项目的信息。</p>
 
 	      <p>过去的一年， 在世界上 <xsl:value-of
 		select="count(/events/event[(number(enddate/year) =
 		(number($curdate.year) -1)) and (generate-id() =
 		generate-id(key('last-year-event-by-country',
 		location/country)[1]))])" /> 个不同的国家举办了 <xsl:value-of
 	        select="count(/events/event[number(enddate/year) =
 	        (number($curdate.year) -1)])" /> 场 &os; 活动。
 		若要了解未来与 &os; 有关的活动， 请查阅
 		<a href="&enbase;/events/events.html">活动页面</a> 上维护的
 		<a href="&enbase;/events/events.ics">日历</a> 和
 		<a href="&enbase;/events/rss.xml">RSS 源</a>。 在 YouTube 上的
 		<a href="https://www.youtube.com/bsdconferences">BSD 会议</a>
 		频道里有许多过去活动的视频。</p>
 
 <!-- The Latest Videos section is placed inside an invisible block, which
      is only made visible if the browser supports Javascript. -->
 
               <div id="latest-videos" style="display:none;">
 	      <h3>最新视频</h3>
 
 <!-- See http://www.google.com/uds/solutions/wizards/videobar.html -->
   <div id="videoBar-bar">
     <span style="color:#676767;font-size:11px;margin:10px;padding:4px;">Loading...</span>
   </div>
 
   <script src="//www.google.com/uds/api?file=uds.js&amp;v=1.0&amp;source=uds-vbw"
     type="text/javascript"></script>
   <style type="text/css">
     @import url("//www.google.com/uds/css/gsearch.css");
   </style>
   <!-- Video Bar Code and Stylesheet -->
   <script type="text/javascript">
     window._uds_vbw_donotrepair = true;
   </script>
   <script src="//www.google.com/uds/solutions/videobar/gsvideobar.js?mode=new"
     type="text/javascript"></script>
   <style type="text/css">
     @import url("//www.google.com/uds/solutions/videobar/gsvideobar.css");
   </style>
 
   <style type="text/css">
     .playerInnerBox_gsvb .player_gsvb {
       width : 320px;
       height : 260px;
     }
   </style>
   <script type="text/javascript">
     document.getElementById('latest-videos').style.display = 'block';
 
     function LoadVideoBar() {
 
     var videoBar;
     var options = {
         largeResultSet : !true,
         horizontal : true,
         autoExecuteList : {
           cycleTime : GSvideoBar.CYCLE_TIME_MEDIUM,
           cycleMode : GSvideoBar.CYCLE_MODE_LINEAR,
           executeList : ["ytchannel:bsdconferences"]
         }
       }
 
     videoBar = new GSvideoBar(document.getElementById("videoBar-bar"),
                               GSvideoBar.PLAYER_ROOT_FLOATING,
                               options);
     }
     // arrange for this function to be called during body.onload
     // event processing
     GSearch.setOnLoadCallback(LoadVideoBar);
   </script>
               </div> <!-- Latest Videos -->
 	      <h2>社交网络</h2>
 	      <p>&os; 出现在许多不同的社交网络上。</p>
 
 	      <ul>
 
 		<li>在 <a href="https://www.flickr.com">flickr</a> 上，
 		有上千张来自用户群组， 会议和黑客马拉松的照片被加上了 '<a
 		href="https://flickr.com/search/?z=t&amp;ss=2&amp;w=all&amp;q=freebsd&amp;m=text">freebsd</a>'
 		标签。</li>
 
 		<li>在 <a href="https://www.youtube.com">YouTube</a> 上有上百段会议视频，
 		屏幕录像， 以及关于 <a
 		href="https://www.youtube.com/results?search_query=freebsd">FreeBSD</a>
 		的演示。 特别要提到的是， 有一个新的
 		<a href="https://www.youtube.com/bsdconferences">BSD 会议</a>
 		频道， 其中包含了来自 FreeBSD 技术会议的各种一小时 FreeBSD 录制演讲。</li>
 
 		<li>在 <a href="https://www.facebook.com">Facebook</a> 上有一个
 		<a href="https://www.facebook.com/groups/FreeSBD/">FreeBSD
 		用户群组</a>， 在<a href="https://www.linkedin.com">LinkedIn</a> 上有一个
 		<a href="https://www.linkedin.com/groups?gid=47628">FreeBSD 群组</a>。</li>
 
 		<li>您可以在 <a href="https://twitter.com">Twitter</a> 上关注
 		<a href="https://twitter.com/freebsd">@freebsd</a>，
 		<a href="https://twitter.com/freebsdhelp">@freebsdhelp</a>，
 		<a href="https://twitter.com/freebsdblogs">@freebsdblogs</a>， 以及
 		<a href="https://twitter.com/freebsdcore">@freebsdcore</a>。</li>
 	      </ul>
   </xsl:template>
 </xsl:stylesheet>
diff --git a/zh_CN.UTF-8/htdocs/copyright/trademarks.xml b/zh_CN.UTF-8/htdocs/copyright/trademarks.xml
index 7e455e8b20..afa4a29284 100644
--- a/zh_CN.UTF-8/htdocs/copyright/trademarks.xml
+++ b/zh_CN.UTF-8/htdocs/copyright/trademarks.xml
@@ -1,68 +1,68 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
 "http://www.FreeBSD.org/XML/doc/share/xml/xhtml10-freebsd.dtd" [
 <!ENTITY title "商标说明">
 ]>
 
-<!-- Original Revision: r51230 -->
+<!-- Original Revision: 09fa751193 (r51230) -->
 <html xmlns="http://www.w3.org/1999/xhtml">
 <head>
       <title>&title;</title>
 
       <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
     </head>
 
     <body class="navinclude.about">
 
 <p>FreeBSD 是 FreeBSD 基金会的注册商标。</p>
 
 <p>FreeBSD 标志是 FreeBSD 基金会的注册商标。</p>
 
 <p>请参见 <a href="http://www.freebsdfoundation.org/">FreeBSD
   基金会</a> <a
     href="https://www.freebsdfoundation.org/legal/trademark-usage-terms-and-conditions/">商标使用许可条件</a>
   网页了解关于使用 FreeBSD 标志的详情。</p>
 
 <p>Adobe, Acrobat, Acrobat Reader, 以及 PostScript 是 Adobe Systems Incorporated 在
   美国和/或其他国家的注册商标或商标。</p>
 
 <p>AMD, Am486, Am5X86, AMD Athlon, AMD Duron, AMD Opteron, AMD-K6,
   Athlon, &Eacute;lan, Opteron, 以及 PCnet 是 Advanced Micro Devices,
   Inc. 的商标。</p>
 
 <p>Apple, FireWire, Mac, Macintosh, Mac OS, Quicktime, 以及 TrueType
   是 Apple Computer, Inc., 在美国和/或其他国家的注册商标或商标。</p>
 
 <p>CVSup 是 John D. Polstra 的注册商标。</p>
 
 <p>IBM 以及 PowerPC 是国际商用机器公司在美国和/或其他国家的注册商标。</p>
 
 <p>IEEE, POSIX, 和 802 是 The Institute of
   Electrical and Electronics Engineers, Inc. 的注册商标。</p>
 
 <p>Intel, Celeron, EtherExpress, i386, i486, Itanium, Pentium, 以及
   Xeon 是 Intel Corporation 或其分支机构在美国和/或其他国家的注册商标。</p>
 
 <p>Linux 是 Linus Torvalds 在美国的注册商标。</p>
 
 <p>Motif, OSF/1, 和 UNIX 是 The Open Group 在美国和其他国家的注册商标，
   IT DialTone 和 The Open Group 是其商标。</p>
 
 <p>MySQL 是 MySQL AB 在美国和欧盟以及其他国家的注册商标。</p>
 
 <p>Silicon Graphics, SGI, 和 OpenGL 是
   Silicon Graphics, Inc., 在美国和/或其他国家的注册商标。</p>
 
 <p>Sparc, Sparc64, SPARCEngine, 以及 UltraSPARC 是 SPARC
   International, Inc 在美国和/或其他国家的商标。
   采用 SPARC 商标的系统基于 Sun Microsystems, Inc. 开发的架构。</p>
 
 <p>Sun, Sun Microsystems, SunOS, Solaris, 以及 Java 是 Sun Microsystems, Inc.
   在美国和/或其他国家的商标或注册商标。</p>
 
 <p>许多制造商和经销商使用一些成为商标的图案或文字设计来彰显自己的产品。
   本网站中出现的， 为 FreeBSD Project 所承认的商标后面将以
   '&trade;' 或 '&reg;' 符号来标注。</p>
 
 </body>
 </html>
diff --git a/zh_CN.UTF-8/htdocs/docs.xml b/zh_CN.UTF-8/htdocs/docs.xml
index c8ab8003ae..c545dc36c2 100644
--- a/zh_CN.UTF-8/htdocs/docs.xml
+++ b/zh_CN.UTF-8/htdocs/docs.xml
@@ -1,27 +1,27 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
 "http://www.FreeBSD.org/XML/doc/share/xml/xhtml10-freebsd.dtd" [
 <!ENTITY title "FreeBSD 文档">
 ]>
 
 <!-- The FreeBSD Simplified Chinese Documentation Project -->
-<!-- Original Revision: r49032 -->
+<!-- Original Revision: a8d2790f87 (r49032) -->
 
 <html xmlns="http://www.w3.org/1999/xhtml">
     <head>
       <title>&title;</title>
 
       <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
     </head>
 
     <body class="navinclude.docs">
 
     <img src="&enbase;/gifs/doc.jpg" alt="正在阅读文档的 BSD Daemon"
       align="right" border="0" width="274" height="163"/>
 
     <p>FreeBSD 有种类广泛的 <a
       href="&base;/doc/zh_CN.UTF-8/books/handbook/index.html">
       各种文档</a>，在这个网站和其他网站都可以找到，数不胜数。</p>
 
   </body>
 </html>
diff --git a/zh_CN.UTF-8/htdocs/index.xsl b/zh_CN.UTF-8/htdocs/index.xsl
index 4271dfe775..e736898240 100644
--- a/zh_CN.UTF-8/htdocs/index.xsl
+++ b/zh_CN.UTF-8/htdocs/index.xsl
@@ -1,323 +1,323 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <!DOCTYPE xsl:stylesheet PUBLIC "-//FreeBSD//DTD FreeBSD XSLT 1.0 DTD//EN"
 				"http://www.FreeBSD.org/XML/share/xml/xslt10-freebsd.dtd" [
 <!ENTITY title "The FreeBSD Project">
 ]>
 
 <!-- $FreeBSD$ -->
 <!-- The FreeBSD Simplified Chinese Documentation Project -->
-<!-- Original revision: r54642 -->
+<!-- Original Revision: bfea49dccc (r54642) -->
 
 <xsl:stylesheet version="1.0"
   xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
   xmlns="http://www.w3.org/1999/xhtml">
 
   <xsl:import href="http://www.FreeBSD.org/XML/lang/share/xml/libcommon.xsl"/>
   <xsl:import href="http://www.FreeBSD.org/XML/share/xml/xhtml.xsl"/>
 
   <!-- these params should be externally bound. The values
        here are not used actually -->
   <xsl:param name="advisories.xml" select="'none'"/>
   <xsl:param name="notices.xml" select="'none'"/>
   <xsl:param name="mirrors.xml" select="'none'"/>
   <xsl:param name="news.press.xml-master" select="'none'"/>
   <xsl:param name="news.press.xml" select="'none'"/>
   <xsl:param name="news.project.xml-master" select="'none'"/>
   <xsl:param name="news.project.xml" select="'none'"/>
   <xsl:param name="events.xml-master" select="'none'"/>
   <xsl:param name="events.xml" select="'none'"/>
   <xsl:param name="html.header.script.google" select="'IGNORE'"/>
 
   <xsl:variable name="title">&title;</xsl:variable>
 
   <xsl:template name="process.content">
         <div id="frontcontainer">
           <div id="frontmain">
             <div id="frontfeaturecontainer">
 
 		<div id="frontfeatureleft">
 			<div id="frontfeaturecontent">
 				<h1>&os; 项目</h1>
 
 				<p>&os; 是一个适用于现代服务器，桌面与嵌入式 <a href="&base;/platforms/">平台</a> 的操作系统。
 				  由一个庞大的
 				  <a
 				  href="&enbase;/doc/en_US.ISO8859-1/articles/contributors/staff-committers.html">开发人员团队</a>
 				持续开发超过三十年。
 				&os; 先进的网络、安全性和存储方面的特色使得它成为许多
 				  <a href="&enbase;/doc/zh_CN.UTF-8/books/handbook/nutshell.html#introduction-nutshell-users">大型网站</a>
 			以及最普遍的嵌入式网络与存储设备的平台选择。 </p>
 
                                   <div
 				  id="txtfrontfeaturelink"> &#187;<a
 				  href="&base;/about.html"
 				  title="Learn More">了解更多</a>
 				  </div> <!-- TXTFRONTFEATURELINK -->
 
 				  <div id="txtfrontjournalblock">
 				    <br/>&#187;
 				    <span
 				     id="txtfrontjournallink">
 				      立即获取 <a
 				       href="http://www.freebsdjournal.com/"
 				       title="&os;&nbsp;Journal">&os;&nbsp;Journal</a>
 				    </span> <!-- TXTFRONTJOURNALLINK -->
 				  </div> <!-- TXTFRONTJOURNALBLOCK -->
 
 				  <!-- IMPORTANT NOTICES -->
 				  <!--
 				  <div
 				    style="width:640px; margin: 16px 16px 16px 32px; auto">
 
 				    <h2>ANNOUNCEMENT: [header]</h2>
 
 				    <p align="justify">[text]</p>
 				  </div>
 				  -->
 				  <!-- END IMPORTANT NOTICES -->
 
 			  </div> <!-- FRONTFEATURECONTENT -->
 		  </div> <!-- FRONTFEATURELEFT -->
 
 		<div id="frontfeaturemiddle">
 			<div class="frontgetroundbox">
 			  <div class="frontgettop"><div><b style="display: none">.</b></div></div>
 				<div class="frontgetcontent">
 				  <a href="&base;/where.html">获取 &os;</a>
 				</div> <!-- frontgetcontent -->
 			  <div class="frontgetbot"><div><b style="display: none">.</b></div></div>
 			</div> <!-- frontgetroundbox -->
 
 			<div id="frontreleases">
 			  <div id="frontreleasescontent" class="txtshortcuts">
 				  <h2><a href="&base;/releases/">支持的版本</a></h2>
 				  <ul id="frontreleaseslist">
 					<li>生产环境适用:&nbsp;<a
 				href="&u.rel122.announce;">&rel122.current;</a>,
 				<a
 				href="&u.rel121.announce;">&rel121.current;</a>,
 				<a
 				href="&u.rel114.announce;">&rel114.current;</a></li>
 				<xsl:if test="'&beta.upcoming;' != 'IGNORE'">
 					<li>即将发布: <a
 				href="&u.betarel.schedule;">&betarel.current;</a></li>
 			    </xsl:if>
 			    <xsl:if test="'&beta2.upcoming;' != 'IGNORE'">
 					<li>即将发布: <a
 				href="&u.betarel2.schedule;">&betarel2.current;</a></li>
 			    </xsl:if>
 					<li><a href="&base;/security/security.html#sup">支持生命周期</a></li>
 				  </ul>
 			  </div> <!-- FRONTRELEASESCONTENT -->
 			</div> <!-- FRONTRELEASES -->
 		</div> <!-- FRONTFEATUREMIDDLE -->
 
 		<div id="frontfeatureright">
 			<h2 class="blockhide">语言</h2>
 			<div id="languagenav">
 				<ul id="languagenavlist">
 				  <li>
 					<a href="&enbase;/de/" title="德语">de</a>
 				  </li>
 				  <li>
 					<a href="&enbase;/" title="英语">en</a>
 				  </li>
 				  <li>
 					<a href="&enbase;/ja/" title="日语">ja</a>
 				  </li>
 				  <li>
 					<a href="&enbase;/zh_CN/" title="中文 (简体)">zh_CN</a>
 				  </li>
 				  <li class="last-child">
 					<a href="&enbase;/zh_TW/" title="中文 (繁体)">zh_TW</a>
 				  </li>
 				</ul>
 			</div> <!-- LANGUAGENAV -->
 
 			<div id="frontshortcuts">
 			  <div id="frontshortcutscontent" class="txtshortcuts">
 				  <h2>常用链接</h2>
 				  <ul id="frontshortcutslist">
 					<li>
 					  <a href="&enbase;/community/mailinglists.html" title="邮件列表">邮件列表</a>
 					</li>
 					<li>
 					  <a href="&enbase;/support/bugreports.html" title="问题报告">问题报告</a>
 					</li>
 					<li>
 					  <a href="&enbase;/doc/en_US.ISO8859-1/books/faq/index.html" title="常见问题解答">常见问题解答</a>
 					</li>
 					<li>
 					  <a href="&enbase;/doc/zh_CN.UTF-8/books/handbook/index.html" title="使用手册">使用手册</a>
 					</li>
 					<li>
 					  <a href="&enbase;/ports/index.html" title="Ports">Ports</a>
 					</li>
 
 				  </ul>
 			  </div> <!-- FRONTSHORTCUTSCONTENT -->
 			</div> <!-- FRONTSHORTCUTS -->
 
 			<div class="frontnewroundbox">
 			  <div class="frontnewtop"><div><b style="display: none">.</b></div></div>
 			    <div class="frontnewcontent">
 			      <a href="&enbase;/projects/newbies.html">不熟悉 FreeBSD?</a>
 			    </div> <!-- frontnewcontent -->
 			  <div class="frontnewbot"><div><b style="display: none">.</b></div></div>
 			</div> <!-- frontnewroundbox -->
 			<!-- 25th anniversary logo -->
 			<div class="frontfeaturecontent">
 			  <!-- XXX: target page not yet ready
 			  <a href="XXX TBD"
 			    title="&os; 25th Anniversary">
 			  -->
 			  <img
 			    src="&enbase;/layout/images/25thanniversary.png"
 			    style="margin-top: 5px;"
 			    width="167" height="88"
 			    alt="25th Anniversary Logo" />
 			  <!--
 			  </a>
 			  -->
 			</div>
 			<!-- end 25th anniversary logo -->
 		</div> <!-- FEATURERIGHT -->
 
             </div> <!-- FRONTFEATURECONTAINER -->
 
 	    <br class="clearboth" />
             <div id="frontnemscontainer">
             	<div id="frontnews">
             	   <div id="frontnewscontent" class="txtnewsevent">
 			<h2>最新动态</h2>
 			<div class="newseventswrap">
 
 			<xsl:call-template name="html-index-news-project-items">
 				<xsl:with-param name="news.project.xml-master" select="$news.project.xml-master" />
 				<xsl:with-param name="news.project.xml" select="$news.project.xml" />
 			</xsl:call-template>
 
 			  <div>
 				<ul class="newseventslist">
 				  <li class="first-child">
 					<a href="&base;/news/newsflash.html" title="更多新闻">更多新闻</a>
 				  </li>
 				  <li class="last-child">
 					<a href="&enbase;/news/rss.xml" title="新闻 RSS Feed"><img class="rssimage" src="&enbase;/layout/images/ico_rss.png" width="27" height="12" alt="新闻 RSS Feed" /></a>
 				  </li>
 				</ul>
 			  </div> <!-- unnamed -->
 			</div> <!-- newseventswrap -->
 
             	   </div> <!-- FRONTNEWSCONTENT -->
             	</div> <!-- FRONTNEWS -->
             	<div class="frontseparator"><b style="display: none">.</b></div>
             	<div id="frontevents">
 		   <div id="fronteventscontent" class="txtnewsevent">
 
 			<h2>近期活动</h2>
 			<div class="newseventswrap">
 
 			<xsl:call-template name="html-index-events-items">
 				<xsl:with-param name="events.xml-master" select="$events.xml-master" />
 				<xsl:with-param name="events.xml" select="$events.xml" />
 			</xsl:call-template>
 
 			  <div>
 				<ul class="newseventslist">
 				  <li class="only-child">
 					<a href="&enbase;/events/" title="更多活动">更多活动</a>
 				  </li>
 				</ul>
 			  </div> <!-- unnamed -->
 			</div> <!-- newseventswrap -->
 
 		   </div> <!-- FRONTEVENTSCONTENT -->
             	</div> <!-- FRONTEVENTS -->
             	<div class="frontseparator"><b style="display: none">.</b></div>
             	<div id="frontmedia">
 		   <div id="frontmediacontent" class="txtnewsevent">
 
 			<h2>媒体报道</h2>
 			<div class="newseventswrap">
 
 			<xsl:call-template name="html-index-news-press-items">
 				<xsl:with-param name="news.press.xml-master" select="$news.press.xml-master" />
 				<xsl:with-param name="news.press.xml" select="$news.press.xml" />
 			</xsl:call-template>
 
 			  <div>
 				<ul class="newseventslist">
 				  <li class="only-child">
 					<a href="&enbase;/news/press.html" title="更多媒体报道">更多媒体报道</a>
 				  </li>
 				</ul>
 			  </div> <!-- unnamed -->
 			</div> <!-- newseventswrap -->
 
 		   </div> <!-- FRONTMEDIACONTENT -->
             	</div> <!-- FRONTMEDIA -->
 		<div class="frontseparator"><b style="display: none">.</b></div>
 		<div id="frontsecurity">
 		   <div id="frontsecuritycontent" class="txtnewsevent">
 
 			<h2>安全公告</h2>
 			<div class="newseventswrap">
 
 			<xsl:call-template name="html-index-advisories-items">
 				<xsl:with-param name="advisories.xml" select="$advisories.xml" />
 				<xsl:with-param name="type" select="'advisory'" />
 			</xsl:call-template>
 
 			  <div>
 				<ul class="newseventslist">
 				  <li class="first-child">
 					<a href="&enbase;/security/advisories.html" title="更多安全公告">更多安全公告</a>
 				  </li>
 				  <li class="last-child">
 					<a href="&enbase;/security/rss.xml" title="安全公告 RSS Feed"><img class="rssimage" src="&enbase;/layout/images/ico_rss.png" width="27" height="12" alt="安全公告 RSS Feed" /></a>
 				  </li>
 				</ul>
 			  </div> <!-- unnamed -->
 			</div> <!-- newseventswrap -->
 
 			<br />
 			<h2>勘误公告</h2>
 			<div class="newseventswrap">
 
 			<xsl:call-template name="html-index-advisories-items">
 				<xsl:with-param name="advisories.xml" select="$notices.xml" />
 				<xsl:with-param name="type" select="'notice'" />
 			</xsl:call-template>
 
 			  <div>
 				<ul class="newseventslist">
 				  <li class="first-child">
 				    <a href="&enbase;/security/notices.html" title="更多勘误公告">更多勘误公告</a>
 				  </li>
 				  <li class="last-child">
 				    <a href="&enbase;/security/errata.xml" title="勘误公告 RSS Feed"><img class="rssimage" src="&enbase;/layout/images/ico_rss.png" width="27" height="12" alt="勘误公告 RSS Feed" /></a>
 				  </li>
 				</ul>
 			  </div> <!-- unnamed -->
 			</div> <!-- newseventswrap -->
 
 		   </div> <!-- FRONTSECURITYCONTENT -->
             	</div> <!-- FRONTSECURITY -->
 
 		<br class="clearboth" />
 
             </div> <!-- FRONTNEMSCONTAINER -->
           </div> <!-- FRONTMAIN -->
         </div> <!-- FRONTCONTAINER -->
   </xsl:template>
 
   <xsl:template name="process.footer">
 	&copyright;
 
 	FreeBSD 标志是 FreeBSD 基金会的注册商标
 	由 <a
 	  href="https://www.freebsdfoundation.org/documents/Guidelines.shtml">FreeBSD 基金会</a> 授权 FreeBSD 项目使用。
 	<a href="&enbase;/mailto.html" title="&header2.word.contact;">&header2.word.contact;</a>
   </xsl:template>
 </xsl:stylesheet>
diff --git a/zh_CN.UTF-8/htdocs/mailto.xml b/zh_CN.UTF-8/htdocs/mailto.xml
index 7b7658293a..901099272f 100644
--- a/zh_CN.UTF-8/htdocs/mailto.xml
+++ b/zh_CN.UTF-8/htdocs/mailto.xml
@@ -1,48 +1,48 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
 "http://www.FreeBSD.org/XML/doc/share/xml/xhtml10-freebsd.dtd" [
 <!ENTITY title "联系 FreeBSD">
 ]>
 
 <!-- The FreeBSD Simplified Chinese Documentation Project -->
-<!-- Original revision: r49745 -->
+<!-- Original Revision: 3f5b720b0c (r49745) -->
 
 <html xmlns="http://www.w3.org/1999/xhtml">
     <head>
       <title>&title;</title>
 
       <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
     </head>
 
     <body class="navinclude.about">
 
     <h2>关于 FreeBSD 的问题...</h2>
 
     <p>关于 FreeBSD 的问题应该发送到 FreeBSD Questions
       邮件列表， <a
 	href="mailto:freebsd-questions@FreeBSD.org">freebsd-questions@FreeBSD.org</a>。</p>
     <p><a href="&base;/community/mailinglists.html">邮件列表</a> 是提供给 FreeBSD
       用户的主要支持渠道， 包含了众多不同主题的邮件列表。
       同时，也有许多非英语的邮件列表。</p>
 
 
     <h2>关于此 WWW 服务器的内容...</h2>
 
     <p>关于我们的文档 (<a
 	href="&enbase;/doc/zh_CN.UTF-8/books/handbook/index.html">手册</a>, <a href="&enbase;/doc/zh_CN.UTF-8/books/faq/index.html">FAQ</a>, <a
 	href="&base;/docs.html">书籍和文章</a>) 的问题应当发给
         FreeBSD Documentation Project 邮件列表， <a
 	href="mailto:freebsd-doc@FreeBSD.org">freebsd-doc@FreeBSD.org</a>。</p>
 
     <h2>平信， 电话和传真</h2>
 
     <p>订购 CDROM： <a href="http://www.freebsdmall.com/">FreeBSD 商城</a></p>
 
     <p>商业支持： <a href="http://www.freebsdmall.com/">FreeBSD 商城</a></p>
 
     <h2><a href="&base;/administration.html">负责人名录</a></h2>
 
     <p>公共关系和企业联络员， 安全官， 邮件服务器管理员， Web服务器管理员等。</p>
 
   </body>
 </html>
diff --git a/zh_CN.UTF-8/htdocs/releases/index.xml b/zh_CN.UTF-8/htdocs/releases/index.xml
index 34e23353da..7eef2f171a 100644
--- a/zh_CN.UTF-8/htdocs/releases/index.xml
+++ b/zh_CN.UTF-8/htdocs/releases/index.xml
@@ -1,742 +1,742 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
 "http://www.FreeBSD.org/XML/doc/share/xml/xhtml10-freebsd.dtd" [
 <!ENTITY title "发行版本信息">
 ]>
 <!-- $FreeBSD$ -->
 <!-- The FreeBSD Simplified Chinese Documentation Project -->
-<!-- Original Revision: r51914 -->
+<!-- Original Revision: 4f4f4d9a83 (r51914) -->
 
 <html xmlns="http://www.w3.org/1999/xhtml">
 <head>
       <title>&title;</title>
 
       <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
     </head>
 
     <body class="navinclude.download">
       <img alt="FreeBSD 发行版本" src="&enbase;/gifs/releases.jpg" height="200" width="300" align="right" border="0"/>
 
   <p>FreeBSD 发行版本分为 “生产版本” (Production Releases) 和
     “旧式版本” (Legacy Releases)。 前者适用于希望使用最新特性的用户，
     后者适合于希望采取更保守的升级策略的用户。</p>
 
   <p>每个发行版本的 HTML 格式的相关文档文件，
     都可以在 <a href="&base;/relnotes.html">发行文档</a>
     页面找到。</p>
 
   <a name="supported-releases"></a>
   <h2>目前支持的版本</h2>
 
   <p>关于发布日期， 以及预计的生命期终止 (EoL) 时间，
     可以在 <a href="&base;/security/security.html">FreeBSD
     安全信息</a> 页面中的 <a
       href="&base;/security/security.html#sup">支持的发布版本</a>
     部分找到。</p>
 
   <a name="current"></a>
   <h2>最新版本</h2>
 
     <h3>生产适用版本</h3>
       <p><b>版本 &rel.current;</b> (&rel.current.date;)
 	<em>
 	<a href="&enbase;/releases/&u.rel.announce;">公告</a> :
 	<a href="&enbase;/releases/&u.rel.notes;">发行说明</a> :
 	<a href="&enbase;/releases/&u.rel.installation;">安装说明</a> :
 	<a href="&enbase;/releases/&u.rel.hardware;">硬件说明</a> :
 	<a href="&enbase;/releases/&u.rel.readme;">自述文件</a> :
 	<a href="&enbase;/releases/&u.rel.errata;">勘误</a> :
 	<a href="&enbase;/releases/&u.rel.signatures;">校验和</a>
       </em></p>
 
       <p><b>版本 &rel1.current;</b> (&rel1.current.date;)
 	<em>
 	<a href="&enbase;/releases/&u.rel1.announce;">公告</a> :
 	<a href="&enbase;/releases/&u.rel1.notes;">发行说明</a> :
 	<a href="&enbase;/releases/&u.rel1.installation;">安装说明</a> :
 	<a href="&enbase;/releases/&u.rel1.hardware;">硬件说明</a> :
 	<a href="&enbase;/releases/&u.rel1.readme;">自述文件</a> :
 	<a href="&enbase;/releases/&u.rel1.errata;">勘误</a> :
 	<a href="&enbase;/releases/&u.rel1.signatures;">校验和</a>
       </em></p>
 
     <h3>旧式版本</h3>
       <p><b>版本 &rel2.current;</b> (&rel2.current.date;)
 	<em>
 	<a href="&enbase;/releases/&u.rel2.announce;">公告</a> :
 	<a href="&enbase;/releases/&u.rel2.notes;">发行说明</a> :
 	<a href="&enbase;/releases/&u.rel2.installation;">安装说明</a> :
 	<a href="&enbase;/releases/&u.rel2.hardware;">硬件说明</a> :
 	<a href="&enbase;/releases/&u.rel2.readme;">自述文件</a> :
 	<a href="&enbase;/releases/&u.rel2.errata;">勘误</a> :
 	<a href="&enbase;/releases/&u.rel2.signatures;">校验和</a>
   </em></p>
 
   <a name="future"></a>
   <h2>未来的发行版本</h2>
 
     <p>关于未来版本的发行日程， 以及关于发布工程过程的信息，
       请参阅 <a
 	href="&base;/releng/index.html">发布工程</a>
       页面。</p>
 
     <p>此外， 您还可以获取 <a
 	href="&enbase;/doc/en_US.ISO8859-1/books/handbook/makeworld.html#STABLE">FreeBSD-STABLE</a>
       和 <a
 	href="&enbase;/doc/en_US.ISO8859-1/books/handbook/current-stable.html#CURRENT">FreeBSD-CURRENT</a>
       的快照版本。 请参阅 <a
 	href="../where.html">获取 FreeBSD</a> 了解详情。</p>
 
   <!-- temporary disable entry: RL 20150303
   <a name="prior-supported"></a>
   <h2>Prior Releases Still Being Supported</h2>
 
   <ul>
   </ul>
   -->
 
   <a name="prior-unsupported"></a>
   <h2>目前已经停止支持的更早版本</h2>
 
     <p>关于更早版本的发布日期、 支持时间分类， 以及实际的生命周期结束时间，
       可以在 <a href="&base;/security/security.html">FreeBSD
       安全信息</a> 页面中的 <a
 	href="&enbase;/security/unsupported.html">不再支持的版本</a>
       部分找到。</p>
 
     <ul>
       <li><b>11.0</b> (2016 年 10 月)
 	<em>
 	  <a href="&enbase;/releases/11.0R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/11.0R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/11.0R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/11.0R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/11.0R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/11.0R/errata.html">勘误</a>:
 	  <a href="&enbase;/releases/11.0R/signatures.html">校验和</a>
 	</em>
       </li>
 
       <li><b>10.3</b> (2016 年 4 月)
 	<em>
 	  <a href="&enbase;/releases/10.3R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/10.3R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/10.3R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/10.3R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/10.3R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/10.3R/errata.html">勘误</a>:
 	  <a href="&enbase;/releases/10.3R/signatures.html">校验和</a>
 	</em>
       </li>
 
       <li><b>10.2</b> (2015 年 8 月)
 	<em>
 	  <a href="&enbase;/releases/10.2R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/10.2R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/10.2R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/10.2R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/10.2R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/10.2R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>10.1</b> (2014 年 11 月)
 	<em>
 	  <a href="&enbase;/releases/10.1R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/10.1R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/10.1R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/10.1R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/10.1R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/10.1R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>10.0</b> (2014 年 1 月)
 	<em>
 	  <a href="&enbase;/releases/10.0R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/10.0R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/10.0R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/10.0R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/10.0R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/10.0R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>9.3</b> (2014 年 7 月)
 	<em>
 	  <a href="&enbase;/releases/9.3R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/9.3R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/9.3R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/9.3R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/9.3R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/9.3R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>9.2</b> (2013 年 9 月)
 	<em>
 	  <a href="&enbase;/releases/9.2R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/9.2R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/9.2R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/9.2R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/9.2R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/9.2R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>9.1</b> (2012 年 12 月)
 	<em>
 	  <a href="&enbase;/releases/9.1R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/9.1R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/9.1R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/9.1R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/9.1R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/9.1R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>9.0</b> (2012 年 1 月)
 	<em>
 	  <a href="&enbase;/releases/9.0R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/9.0R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/9.0R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/9.0R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/9.0R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/9.0R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>8.4</b> (2013 年 6 月)
 	<em>
 	  <a href="&enbase;/releases/8.4R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/8.4R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/8.4R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/8.4R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/8.4R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/8.4R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>8.3</b> (2012 年 4 月)
 	<em>
 	  <a href="&enbase;/releases/8.3R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/8.3R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/8.3R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/8.3R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/8.3R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/8.3R/errata.html">Errata</a>
 	</em>
       </li>
 
       <li><b>8.2</b> (2011 年 2 月)
 	<em>
 	  <a href="&enbase;/releases/8.2R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/8.2R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/8.2R/hardware.html">硬件兼容说明</a>:
 	  <a href="&enbase;/releases/8.2R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/8.2R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>8.1</b> (2010 年 7 月)
 	<em>
 	  <a href="&enbase;/releases/8.1R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/8.1R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/8.1R/hardware.html">硬件兼容说明</a>:
 	  <a href="&enbase;/releases/8.1R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/8.1R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>8.0</b> (2009 年 11 月)
 	<em>
 	  <a href="&enbase;/releases/8.0R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/8.0R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/8.0R/hardware.html">硬件兼容说明</a>:
 	  <a href="&enbase;/releases/8.0R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/8.0R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>7.4</b> (2011 年 2 月)
 	<em>
 	  <a href="&enbase;/releases/7.4R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/7.4R/relnotes.html">Release Notes</a>:
 	  <a href="&enbase;/releases/7.4R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/7.4R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/7.4R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>7.3</b> (2010 年 3 月)
 	<em>
 	  <a href="&enbase;/releases/7.3R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/7.3R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/7.3R/hardware.html">硬件兼容说明</a>:
 	  <a href="&enbase;/releases/7.3R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/7.3R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>7.2</b> (2009 年 5 月)
 	<em>
 	  <a href="&enbase;/releases/7.2R/announce.html">公告</a>:
 	  <a href="7.2R/relnotes.html">发行说明</a>:
 	  <a href="7.2R/hardware.html">硬件兼容说明</a>:
 	  <a href="7.2R/readme.html">自述文件</a>:
 	  <a href="7.2R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>7.1</b> (2009 年 1 月)
 	<em>
 	  <a href="&enbase;/releases/7.1R/announce.html">公告</a>:
 	  <a href="7.1R/relnotes.html">发行说明</a>:
 	  <a href="7.1R/hardware.html">硬件兼容说明</a>:
 	  <a href="7.1R/readme.html">自述文件</a>:
 	  <a href="7.1R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>7.0</b> (2008 年 2 月)
 	<em>
 	  <a href="&enbase;/releases/7.0R/announce.html">公告</a>:
 	  <a href="7.0R/relnotes.html">发行说明</a>:
 	  <a href="7.0R/hardware.html">硬件兼容说明</a>:
 	  <a href="7.0R/readme.html">自述文件</a>:
 	  <a href="7.0R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>6.4</b> (2008 年 11 月)
 	<em>
 	  <a href="&enbase;/releases/6.4R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/6.4R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/6.4R/hardware.html">硬件兼容说明</a>:
 	  <a href="&enbase;/releases/6.4R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/6.4R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/6.4R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>6.3</b> (2008 年 1 月)
 	<em>
 	  <a href="&enbase;/releases/6.3R/announce.html">公告</a>:
 	  <a href="6.3R/relnotes.html">发行说明</a>:
 	  <a href="6.3R/hardware.html">硬件兼容说明</a>:
 	  <a href="6.3R/installation.html">安装说明</a>:
 	  <a href="6.3R/readme.html">自述文件</a>:
 	  <a href="6.3R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>6.2</b> (2007 年 1 月)
 	<em>
 	  <a href="&enbase;/releases/6.2R/announce.html">公告</a>:
 	  <a href="6.2R/relnotes.html">发行说明</a>:
 	  <a href="6.2R/hardware.html">硬件兼容说明</a>:
 	  <a href="6.2R/installation.html">安装说明</a>:
 	  <a href="6.2R/readme.html">自述文件</a>:
 	  <a href="6.2R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>6.1</b> (2006 年 5 月)
 	<em>
 	  <a href="&enbase;/releases/6.1R/announce.html">公告</a>：
 	  <a href="6.1R/relnotes.html">发行说明</a>：
 	  <a href="6.1R/hardware.html">硬件兼容说明</a>：
 	  <a href="6.1R/installation.html">安装说明</a>：
 	  <a href="6.1R/readme.html">自述文件</a>：
 	  <a href="6.1R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>6.0</b> (2005 年 11 月)
 	<em>
 	  <a href="&enbase;/releases/6.0R/announce.html">公告</a>：
 	  <a href="6.0R/relnotes.html">发行说明</a>：
 	  <a href="6.0R/hardware.html">硬件说明</a>：
 	  <a href="6.0R/installation.html">安装说明</a>：
 	  <a href="6.0R/readme.html">自述文件</a>：
 	  <a href="6.0R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>5.5</b> (2006 年 5 月)
 	<em>
 	  <a href="&enbase;/releases/5.5R/announce.html">公告</a>:
 	  <a href="5.5R/relnotes.html">发行说明</a>:
 	  <a href="5.5R/hardware.html">硬件说明</a>:
 	  <a href="5.5R/installation.html">安装说明</a>:
 	  <a href="5.5R/readme.html">自述文件</a>:
 	  <a href="5.5R/errata.html">勘误</a>:
 	</em>
       </li>
 
       <li><b>5.4</b> (2005 年 5 月)
 	<em>
 	  <a href="&enbase;/releases/5.4R/announce.html">公告</a>：
 	  <a href="5.4R/relnotes.html">发行说明</a>：
 	  <a href="5.4R/hardware.html">硬件说明</a>：
 	  <a href="5.4R/installation.html">安装说明</a>：
 	  <a href="5.4R/readme.html">自述文件</a>：
 	  <a href="5.4R/errata.html">勘误</a>：
 	  <a href="5.4R/migration-guide.html">迁移指南</a>
 	</em>
       </li>
 
       <li><b>5.3</b> (2004 年 11 月)
 	<em>
 	  <a href="&enbase;/releases/5.3R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/5.3R/relnotes.html">发行说明</a>：
 	  <a href="&enbase;/releases/5.3R/hardware.html">硬件说明</a>：
 	  <a href="&enbase;/releases/5.3R/installation.html">I安装说明</a>：
 	  <a href="&enbase;/releases/5.3R/readme.html">自述文件</a>：
 	  <a href="&enbase;/releases/5.3R/errata.html">勘误</a>：
 	  <a href="&enbase;/releases/5.3R/migration-guide.html">迁移指南</a>
 	</em>
       </li>
 
       <li><b>5.2.1</b> (2004 年 2 月)
 	<em>
 	  <a href="&enbase;/releases/5.2.1R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/5.2.1R/relnotes.html">发行说明</a>：
 	  <a href="&enbase;/releases/5.2.1R/hardware.html">硬件说明</a>：
 	  <a href="&enbase;/releases/5.2.1R/installation.html">安装说明</a>：
 	  <a href="&enbase;/releases/5.2.1R/readme.html">自述文件</a>：
 	  <a href="&enbase;/releases/5.2.1R/errata.html">勘误</a>：
 	  <a href="&enbase;/releases/5.2.1R/early-adopter.html">早期部署指南</a>
 	</em>
       </li>
 
       <li><b>5.2</b> (2004 年 1 月)
 	<em>
 	  <a href="&enbase;/releases/5.2R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/5.2R/relnotes.html">发行说明</a>：
 	  <a href="&enbase;/releases/5.2R/hardware.html">硬件说明</a>：
 	  <a href="&enbase;/releases/5.2R/installation.html">安装说明</a>：
 	  <a href="&enbase;/releases/5.2R/readme.html">自述文件</a>：
 	  <a href="&enbase;/releases/5.2R/errata.html">勘误</a>：
 	  <a href="&enbase;/releases/5.2R/early-adopter.html">早期部署指南</a>
 	</em>
       </li>
 
       <li><b>5.1</b> (2003 年 6 月)
 	<em>
 	  <a href="&enbase;/releases/5.1R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/5.1R/relnotes.html">发行说明</a>：
 	  <a href="&enbase;/releases/5.1R/hardware.html">硬件说明</a>：
 	  <a href="&enbase;/releases/5.1R/installation.html">安装说明</a>：
 	  <a href="&enbase;/releases/5.1R/readme.html">自述文件</a>：
 	  <a href="&enbase;/releases/5.1R/errata.html">勘误</a>：
 	  <a href="&enbase;/releases/5.1R/early-adopter.html">早期部署指南</a>
 	</em>
       </li>
 
       <li><b>5.0</b> (2003 年 1 月)
 	<em>
 	  <a href="&enbase;/releases/5.0R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/5.0R/relnotes.html">发行说明</a>：
 	  <a href="&enbase;/releases/5.0R/hardware.html">硬件说明</a>：
 	  <a href="&enbase;/releases/5.0R/installation.html">安装说明</a>：
 	  <a href="&enbase;/releases/5.0R/readme.html">自述文件</a>：
 	  <a href="&enbase;/releases/5.0R/errata.html">勘误</a>：
 	  <a href="&enbase;/releases/5.0R/early-adopter.html">早期部署指南</a>
 	</em>
       </li>
 
       <li><b>4.11</b> (2005 年 1 月)
 	<em>
 	  <a href="&enbase;/releases/4.11R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/4.11R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/4.11R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/4.11R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/4.11R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/4.11R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.10</b> (2004 年 5 月)
 	<em>
 	  <a href="&enbase;/releases/4.10R/announce.html">公告</a>:
 	  <a href="&enbase;/releases/4.10R/relnotes.html">发行说明</a>:
 	  <a href="&enbase;/releases/4.10R/hardware.html">硬件说明</a>:
 	  <a href="&enbase;/releases/4.10R/installation.html">安装说明</a>:
 	  <a href="&enbase;/releases/4.10R/readme.html">自述文件</a>:
 	  <a href="&enbase;/releases/4.10R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.9</b> (2003 年 10 月)
 	<em>
 	  <a href="&enbase;/releases/4.9R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/4.9R/relnotes.html">发行说明</a>：
 	  <a href="&enbase;/releases/4.9R/hardware.html">硬件说明</a>：
 	  <a href="&enbase;/releases/4.9R/installation.html">安装说明</a>：
 	  <a href="&enbase;/releases/4.9R/readme.html">自述文件</a>：
 	  <a href="&enbase;/releases/4.9R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.8</b> (2003 年 4 月)
 	<em>
 	  <a href="&enbase;/releases/4.8R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/4.8R/relnotes.html">发行说明</a>：
 	  <a href="&enbase;/releases/4.8R/hardware.html">硬件说明</a>：
 	  <a href="&enbase;/releases/4.8R/installation.html">安装说明</a>：
 	  <a href="&enbase;/releases/4.8R/readme.html">自述文件</a>：
 	  <a href="&enbase;/releases/4.8R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.7</b> (2002 年 10 月)
 	<em>
 	  <a href="&enbase;/releases/4.7R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/4.7R/relnotes.html">发行说明</a>：
 	  <a href="&enbase;/releases/4.7R/hardware.html">硬件说明</a>：
 	  <a href="&enbase;/releases/4.7R/installation.html">安装说明</a>：
 	  <a href="&enbase;/releases/4.7R/readme.html">自述文件</a>：
 	  <a href="&enbase;/releases/4.7R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.6.2</b> (2002 年 8 月)
 	<em>
 	  <a href="&enbase;/releases/4.6.2R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/4.6.2R/relnotes.html">发行说明</a>：
 	  <a href="&enbase;/releases/4.6.2R/hardware.html">硬件说明</a>：
 	  <a href="&enbase;/releases/4.6.2R/readme.html">自述文件</a>：
 	  <a href="&enbase;/releases/4.6.2R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.6</b> (2002 年 6 月)
 	<em>
 	  <a href="&enbase;/releases/4.6R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/4.6R/relnotes.html">发行说明</a>：
 	  <a href="&enbase;/releases/4.6R/hardware.html">硬件说明</a>：
 	  <a href="&enbase;/releases/4.6R/installation.html">安装说明</a>：
 	  <a href="&enbase;/releases/4.6R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.5</b> (2002 年 1 月)
 	<em>
 	  <a href="&enbase;/releases/4.5R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/4.5R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/4.5R/hardware.html">硬件说明</a>：
 	  <a href="&enbase;/releases/4.5R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.4</b> (2001 年 9 月)
 	<em>
 	  <a href="&enbase;/releases/4.4R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/4.4R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/4.4R/hardware.html">硬件说明</a>：
 	  <a href="&enbase;/releases/4.4R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.3</b> (2001 年 4 月)
 	<em>
 	  <a href="&enbase;/releases/4.3R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/4.3R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/4.3R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.2</b> (2000 年 11 月)
 	<em>
 	  <a href="&enbase;/releases/4.2R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/4.2R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/4.2R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.1.1</b> (2000 年 9 月)
 	<em>
 	<a href="&enbase;/releases/4.1.1R/announce.html">公告</a>：
 	<a href="&enbase;/releases/4.1.1R/notes.html">发行说明</a>：
 	<a href="&enbase;/releases/4.1.1R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.1</b> (2000 年 7 月)
 	<em>
 	  <a href="&enbase;/releases/4.1R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/4.1R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/4.1R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>4.0</b> (2000 年 3 月)
 	<em>
 	  <a href="&enbase;/releases/4.0R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/4.0R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/4.0R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>3.5</b> (2000 年 6 月)
 	<em>
 	  <a href="&enbase;/releases/3.5R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/3.5R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/3.5R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>3.4</b> (1999 年 12 月)
 	<em>
 	  <a href="&enbase;/releases/3.4R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/3.4R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/3.4R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>3.3</b> (1999 年 9 月)
 	<em>
 	  <a href="&enbase;/releases/3.3R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/3.3R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/3.3R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>3.2</b> (1999 年 5 月)
 	<em>
 	  <a href="&enbase;/releases/3.2R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/3.2R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/3.2R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>3.1</b> (1999 年 2 月)
 	<em>
 	  <a href="&enbase;/releases/3.1R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/3.1R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/3.1R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>3.0</b> (1998 年 10 月)
 	<em>
 	  <a href="&enbase;/releases/3.0R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/3.0R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/3.0R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>2.2.8</b> (1998 年 12 月)
 	<em>
 	  <a href="&enbase;/releases/2.2.8R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/2.2.8R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/2.2.8R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>2.2.7</b> (1998 年 7 月)
 	<em>
 	  <a href="&enbase;/releases/2.2.7R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/2.2.7R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/2.2.7R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>2.2.6</b> (1998 年 3 月)
 	<em>
 	  <a href="&enbase;/releases/2.2.6R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/2.2.6R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/2.2.6R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>2.2.5</b> (1997 年 10 月)
 	<em>
 	  <a href="&enbase;/releases/2.2.5R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/2.2.5R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/2.2.5R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>2.2.2</b> (1997 年 5 月)
 	<em>
 	  <a href="&enbase;/releases/2.2.2R/notes.html">发行说明</a>：
 	  <a href="&enbase;/releases/2.2.2R/errata.html">勘误</a>
 	</em>
       </li>
 
       <li><b>2.2.1</b> (1997 年 4 月)
         <em>
 	  <a href="&enbase;/releases/2.2.1R/notes.html">发行说明</a>
         </em>
       </li>
 
       <li><b>2.2</b> (1997 年 3 月)
 	<em>
 	  <a href="&enbase;/releases/2.2R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/2.2R/notes.html">发行说明</a>
 	</em>
       </li>
 
       <li><b>2.1.7</b> (1997 年 2 月)
 	<em>
 	  <a href="&enbase;/releases/2.1.7R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/2.1.7R/notes.html">发行说明</a>
 	</em>
       </li>
 
       <li><b>2.1.6</b> (1996 年 12 月)
 	<em>
 	  <a href="&enbase;/releases/2.1.6R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/2.1.6R/notes.html">发行说明</a>
 	</em>
       </li>
 
       <li><b>2.1.5</b> (1996 年 7 月)
 	<em>
 	  <a href="&enbase;/releases/2.1.5R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/2.1.5R/notes.html">发行说明</a>
 	</em>
       </li>
 
       <li><b>2.1</b> (1995 年 11 月)
 	<em>
 	  <a href="&enbase;/releases/2.1R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/2.1R/notes.html">发行说明</a>
 	</em>
       </li>
 
       <li><b>2.0.5</b> (1995 年 6 月)
 	<em>
 	  <a href="&enbase;/releases/2.0.5R/announce.html">公告</a>：
 	  <a href="&enbase;/releases/2.0.5R/notes.html">发行说明</a>
 	</em>
       </li>
 
       <li><b>2.0</b> (1994 年 11 月)
 	<em>
 	  <a href="&enbase;/releases/2.0/announce.html">公告</a>：
 	  <a href="&enbase;/releases/2.0/notes.html">发行说明</a>
 	</em>
       </li>
 
       <li><b>1.1.5.1</b> (1994 年 7 月)</li>
 
       <li><b>1.1.5</b>
 	<em>
 	  <a href="&enbase;/releases/1.1.5/RELNOTES.FreeBSD">发行说明</a>
 	</em>
       </li>
 
       <li><b>1.1</b> (1994 年 5 月)
 	<em>
 	  <a href="&enbase;/releases/1.1/RELNOTES.FreeBSD">发行说明</a>
 	</em>
       </li>
 
       <li><b>1.0</b> (1993 年 11 月)</li>
     </ul>
 
   </body>
 </html>
diff --git a/zh_CN.UTF-8/htdocs/relnotes.xml b/zh_CN.UTF-8/htdocs/relnotes.xml
index bebd936a1d..060ac93361 100644
--- a/zh_CN.UTF-8/htdocs/relnotes.xml
+++ b/zh_CN.UTF-8/htdocs/relnotes.xml
@@ -1,106 +1,106 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
 "http://www.FreeBSD.org/XML/doc/share/xml/xhtml10-freebsd.dtd" [
 <!ENTITY title "发行文档">
 <!ENTITY current "12.0R">
 ]>
 
 <!-- The FreeBSD Simplified Chinese Documentation Project -->
-<!-- Original Revision: r51090 -->
+<!-- Original Revision: c2ebbbf2e1 (r51090) -->
 
 <html xmlns="http://www.w3.org/1999/xhtml">
   <head>
     <title>&title;</title>
 
     <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
   </head>
 
   <body class="navinclude.about">
 
     <img src="&enbase;/gifs/doc.jpg" alt="BSD daemon reading documentation"
       align="right" border="0" width="274" height="163"/>
 
     <p>FreeBSD 的每个发行版本都包含了一些文档， 提供了当前的版本 (RELEASE,
       快照等) 的一些信息。 这些文档通常包括:</p>
 
     <ul>
       <li>README:  一般的介绍。</li>
 
       <li>发行公告:  自上一个发行版本以来的改进信息。</li>
 
       <li>硬件兼容性列表:  一份已知能正常运行 FreeBSD 的硬件列表。</li>
 
       <li>安装说明：一份安装 FreeBSD 的简明教程。</li>
 
       <li>勘误： 最新的消息， 包括更正、 安全公告， 以及发行后发现的潜在问题。</li>
     </ul>
 
     <p>发行公告、 硬件兼容性列表和安装说明是针对 FreeBSD 支持的每个架构定制的。</p>
 
     <h2>FreeBSD 发行版本</h2>
 
     <p>FreeBSD 的 -RELEASE 版本 (例如 &rel.current;-RELEASE) 可以在
       <a href="releases/index.html">发行版信息</a> 页面和镜像页面中找到。</p>
 
     <p>这些文档在每个发行版本的根目录下。 通常会提供 HTML 和纯文本格式的文档。</p>
 
     <h2>FreeBSD 快照版本</h2>
 
     <p>快照版本的文档通常在每个快照版本的根目录下。</p>
 
     <h2>-CURRENT 和 -STABLE 版本的文档</h2>
 
     <p>FreeBSD -CURRENT 和 -STABLE 文档的 HTML 版本可以在 FreeBSD 网站上找到。
       这些文档在持续地更新并自动生成中。 当网站的其它部分更新时，
       这些版本也会同时更新。</p>
 
     <h3>FreeBSD -CURRENT 的文档</h3>
 
     <ul>
       <li><a
 	  href="&enbase;/releases/&current;/readme.html">README</a></li>
 
       <li><a href="&enbase;/releases/&current;/relnotes.html">发行公告</a></li>
 
       <li><a href="&enbase;/releases/&current;/hardware.html">硬件兼容性列表</a></li>
 
       <?ignore
       <li><a
 	  href="&enbase;/releases/&current;/errata.html">勘误</a></li>
       ?>
 
     </ul>
 
     <h3>FreeBSD 11-STABLE 发行文档</h3>
 
     <ul>
       <li><a
 	  href="&enbase;/relnotes/11-STABLE/readme/index.html">README</a></li>
 
       <li><a
 	  href="&enbase;/relnotes/11-STABLE/relnotes/index.html">发行公告</a></li>
 
       <li><a
 	  href="&enbase;/relnotes/11-STABLE/hardware/index.html">硬件兼容性列表</a></li>
 
       <li><a
 	  href="&enbase;/relnotes/11-STABLE/errata/index.html">勘误</a></li>
     </ul>
 
     <h3>FreeBSD 10-STABLE 发行文档</h3>
 
     <ul>
       <li><a
 	  href="&enbase;/relnotes/10-STABLE/readme/index.html">README</a></li>
 
       <li><a
 	  href="&enbase;/relnotes/10-STABLE/relnotes/index.html">发行公告</a></li>
 
       <li><a
 	  href="&enbase;/relnotes/10-STABLE/hardware/index.html">硬件兼容性列表</a></li>
 
       <li><a
 	  href="&enbase;/relnotes/10-STABLE/errata/index.html">勘误</a></li>
     </ul>
   </body>
 </html>
diff --git a/zh_CN.UTF-8/htdocs/where.xml b/zh_CN.UTF-8/htdocs/where.xml
index 1a5adb01ce..5fde8d2bf4 100644
--- a/zh_CN.UTF-8/htdocs/where.xml
+++ b/zh_CN.UTF-8/htdocs/where.xml
@@ -1,487 +1,487 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
 "http://www.FreeBSD.org/XML/doc/share/xml/xhtml10-freebsd.dtd" [
 <!ENTITY title "获取 FreeBSD">
 <!ENTITY url.rel "https://download.FreeBSD.org/ftp/releases">
 <!ENTITY url.snapshot "https://download.FreeBSD.org/ftp/snapshots">
 ]>
 
 <!-- The FreeBSD Simplified Chinese Documentation Project -->
-<!-- Original Revision: r52076 -->
+<!-- Original Revision: fb302d9326 (r52076) -->
 
 <html xmlns="http://www.w3.org/1999/xhtml">
   <head>
       <title>&title;</title>
 
       <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
     </head>
 
     <body class="navinclude.download">
 
     <a name="choose-version"></a>
 
     <a name="choose-arch"></a>
 
     <h2>选择一种架构</h2>
 
     <p>大多数 &os; 用户使用 amd64， i386 或 armv6 架构的硬件。</p>
 
     <p>现代个人电脑使用 amd64 架构， 包括那些使用 Intel&reg; 品牌处理器的电脑。
       超过 3&nbsp;GB 内存的电脑应该使用 amd64。 如果电脑是更旧的32位型号，
       使用 i386。 嵌入式设备和单片机， 例如 Raspberry Pi， Beagle Bone Black，
       Panda Board 和 Zen Board， 使用支持 ARMv6 和 ARMv7 处理器的 armv6 SD 卡映像。</p>
 
     <p>其他用户请参阅 &os; 支持的平台的
       <a href="&base;/platform/index.html">完整列表</a> 。</p>
 
     <a name="choose-image"></a>
 
     <h2>选择一个映像</h2>
 
     <p>安装 FreeBSD 有许多种选择， 包括从 CD (disc1)、 DVD (dvd1)、
       网络安装映像 (仅引导) 和 USB 映像中启动 &os; 安装程序。
       对于最近的 &os; 版本， 虚拟机映像，
       以及用于嵌入式平台的 SD 卡映像也可供下载。</p>
 
     <a name="help-statistics"></a>
 
     <h2>&os;&nbsp;部署数据</h2>
 
     <p>尽管 &os; 并不收集部署数据， 获取统计信息是十分重要的。 请考虑安装
       <a href="https://www.freshports.org/sysutils/bsdstats/">sysutils/bsdstats</a>
       包， 这将收集硬件和软件的统计数据， 以帮助开发者理解如何更好地进行开发。
       收集的信息可在 <a href="http://bsdstats.org">bsdstats.org</a> 网站查阅。</p>
 
     <a name="download"></a>
 
     <a name="download-rel"></a>
 
     <h1>&os; &rel.current;-RELEASE</h1>
 
     <table class="tblbasic tblwide tbldownload">
       <tbody>
 	<tr>
 	  <th>安装程序映像</th>
 	  <th>虚拟机映像</th>
 	  <th>SD 卡映像</th>
 	  <th>文档</th>
 	</tr>
 	<tr>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.rel;/amd64/amd64/ISO-IMAGES/&rel.current;/">amd64</a></li>
 	      <li><a href="&url.rel;/i386/i386/ISO-IMAGES/&rel.current;/">i386</a></li>
 	      <li><a href="&url.rel;/powerpc/powerpc/ISO-IMAGES/&rel.current;/">powerpc</a></li>
 	      <li><a href="&url.rel;/powerpc/powerpc64/ISO-IMAGES/&rel.current;/">powerpc64</a></li>
 	      <li><a href="&url.rel;/sparc64/sparc64/ISO-IMAGES/&rel.current;/">sparc64</a></li>
 	      <li><a href="&url.rel;/arm64/aarch64/ISO-IMAGES/&rel.current;/">aarch64</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.rel;/VM-IMAGES/README.txt">README</a></li>
 	      <li><a href="&url.rel;/VM-IMAGES/&rel.current;-RELEASE/amd64/Latest/">amd64</a></li>
 	      <li><a href="&url.rel;/VM-IMAGES/&rel.current;-RELEASE/i386/Latest/">i386</a></li>
 	      <li><a href="&url.rel;/VM-IMAGES/&rel.current;-RELEASE/aarch64/Latest/">aarch64</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 			  <li><a href="&url.rel;/arm/arm/ISO-IMAGES/&rel.current;/&os;-&rel.current;-RELEASE-arm-GUMSTIX.img.xz">GUMSTIX</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel.current;/&os;-&rel.current;-RELEASE-arm-armv6-BANANAPI.img.xz">BANANAPI</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel.current;/&os;-&rel.current;-RELEASE-arm-armv6-BEAGLEBONE.img.xz">BEAGLEBONE</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel.current;/&os;-&rel.current;-RELEASE-arm-armv6-CUBIEBOARD.img.xz">CUBIEBOARD</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel.current;/&os;-&rel.current;-RELEASE-arm-armv6-CUBIEBOARD2.img.xz">CUBIEBOARD2</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel.current;/&os;-&rel.current;-RELEASE-arm-armv6-CUBOX-HUMMINGBOARD.img.xz">CUBOX-HUMMINGBOARD</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel.current;/&os;-&rel.current;-RELEASE-arm-armv6-RPI-B.img.xz">RPI-B</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel.current;/&os;-&rel.current;-RELEASE-arm-armv6-RPI2.img.xz">RPI2</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel.current;/&os;-&rel.current;-RELEASE-arm-armv6-PANDABOARD.img.xz">PANDABOARD</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel.current;/&os;-&rel.current;-RELEASE-arm-armv6-WANDBOARD.img.xz">WANDBOARD</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdocslist">
 	      <li><a href="&enbase;/releases/index.html#current">发行于</a>: &rel.current.date;</li>
 	      <li><a href="&u.rel.notes;">发行公告</a></li>
 	      <li><a href="&u.rel.readme;">自述文件</a></li>
 	      <li><a href="&u.rel.hardware;">硬件兼容性列表</a></li>
 	      <li><a href="&u.rel.installation;">安装说明</a></li>
 	      <li><a href="&u.rel.errata;">勘误</a></li>
 	      <li><a href="&u.rel.signatures;">已签名校验和</a></li>
 	    </ul>
 	  </td>
 	</tr>
       </tbody>
     </table>
     <br />
 
     <a name="download-rel1"></a>
 
     <h1>&os; &rel1.current;-RELEASE</h1>
 
     <table class="tblbasic tblwide tbldownload">
       <tbody>
 	<tr>
 	  <th>安装程序映像</th>
 	  <th>虚拟机映像</th>
 	  <th>SD 卡映像</th>
 	  <th>文档</th>
 	</tr>
 	<tr>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.rel;/amd64/amd64/ISO-IMAGES/&rel1.current;/">amd64</a></li>
 	      <li><a href="&url.rel;/i386/i386/ISO-IMAGES/&rel1.current;/">i386</a></li>
 	      <li><a href="&url.rel;/powerpc/powerpc/ISO-IMAGES/&rel1.current;/">powerpc</a></li>
 	      <li><a href="&url.rel;/powerpc/powerpc64/ISO-IMAGES/&rel1.current;/">powerpc64</a></li>
 	      <li><a href="&url.rel;/sparc64/sparc64/ISO-IMAGES/&rel1.current;/">sparc64</a></li>
 	      <li><a href="&url.rel;/arm64/aarch64/ISO-IMAGES/&rel1.current;/">aarch64</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.rel;/VM-IMAGES/README.txt">README</a></li>
 	      <li><a href="&url.rel;/VM-IMAGES/&rel1.current;-RELEASE/amd64/Latest/">amd64</a></li>
 	      <li><a href="&url.rel;/VM-IMAGES/&rel1.current;-RELEASE/i386/Latest/">i386</a></li>
 	      <li><a href="&url.rel;/VM-IMAGES/&rel1.current;-RELEASE/aarch64/Latest/">aarch64</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel1.current;/&os;-&rel1.current;-RELEASE-arm-armv6-BANANAPI.img.xz">BANANAPI</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel1.current;/&os;-&rel1.current;-RELEASE-arm-armv6-BEAGLEBONE.img.xz">BEAGLEBONE</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel1.current;/&os;-&rel1.current;-RELEASE-arm-armv6-CUBIEBOARD.img.xz">CUBIEBOARD</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel1.current;/&os;-&rel1.current;-RELEASE-arm-armv6-CUBIEBOARD2.img.xz">CUBIEBOARD2</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel1.current;/&os;-&rel1.current;-RELEASE-arm-armv6-CUBOX-HUMMINGBOARD.img.xz">CUBOX-HUMMINGBOARD</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel1.current;/&os;-&rel1.current;-RELEASE-arm-armv6-GUMSTIX.img.xz">GUMSTIX</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel1.current;/&os;-&rel1.current;-RELEASE-arm-armv6-RPI-B.img.xz">RPI-B</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel1.current;/&os;-&rel1.current;-RELEASE-arm-armv6-RPI2.img.xz">RPI2</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel1.current;/&os;-&rel1.current;-RELEASE-arm-armv6-PANDABOARD.img.xz">PANDABOARD</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel1.current;/&os;-&rel1.current;-RELEASE-arm-armv6-WANDBOARD.img.xz">WANDBOARD</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdocslist">
 	      <li><a href="&enbase;/releases/index.html#current">发行于</a>: &rel1.current.date;</li>
 	      <li><a href="&u.rel1.notes;">发行公告</a></li>
 	      <li><a href="&u.rel1.hardware;">硬件兼容性列表</a></li>
 	      <li><a href="&u.rel1.installation;">安装说明</a></li>
 	      <li><a href="&u.rel1.errata;">勘误</a></li>
 	      <li><a href="&u.rel1.signatures;">已签名校验和</a></li>
 	    </ul>
 	  </td>
 	</tr>
       </tbody>
     </table>
     <br />
 
     <a name="download-rel2"></a>
 
     <h1>&os; &rel2.current;-RELEASE</h1>
 
     <table class="tblbasic tblwide tbldownload">
       <tbody>
 	<tr>
 	  <th>安装程序映像</th>
 	  <th>虚拟机映像</th>
 	  <th>SD 卡映像</th>
 	  <th>文档</th>
 	</tr>
 	<tr>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.rel;/amd64/amd64/ISO-IMAGES/&rel2.current;/">amd64</a></li>
 	      <li><a href="&url.rel;/i386/i386/ISO-IMAGES/&rel2.current;/">i386</a></li>
 	      <li><a href="&url.rel;/ia64/ia64/ISO-IMAGES/&rel2.current;/">ia64</a></li>
 	      <li><a href="&url.rel;/powerpc/powerpc/ISO-IMAGES/&rel2.current;/">powerpc</a></li>
 	      <li><a href="&url.rel;/powerpc/powerpc64/ISO-IMAGES/&rel2.current;/">powerpc64</a></li>
 	      <li><a href="&url.rel;/sparc64/sparc64/ISO-IMAGES/&rel2.current;/">sparc64</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.rel;/VM-IMAGES/README.txt">README</a></li>
 	      <li><a href="&url.rel;/VM-IMAGES/&rel2.current;-RELEASE/amd64/Latest/">amd64</a></li>
 	      <li><a href="&url.rel;/VM-IMAGES/&rel2.current;-RELEASE/i386/Latest/">i386</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel2.current;/&os;-&rel2.current;-RELEASE-arm-armv6-BEAGLEBONE.img.xz">BEAGLEBONE</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel2.current;/&os;-&rel2.current;-RELEASE-arm-armv6-CUBOX-HUMMINGBOARD.img.xz">CUBOX-HUMMINGBOARD</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel2.current;/&os;-&rel2.current;-RELEASE-arm-armv6-GUMSTIX.img.xz">GUMSTIX</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel2.current;/&os;-&rel2.current;-RELEASE-arm-armv6-RPI-B.img.xz">RPI-B</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel2.current;/&os;-&rel2.current;-RELEASE-arm-armv6-PANDABOARD.img.xz">PANDABOARD</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&rel2.current;/&os;-&rel2.current;-RELEASE-arm-armv6-WANDBOARD.img.xz">WANDBOARD</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdocslist">
 	      <li><a href="&enbase;/releases/index.html#current">发行于</a>: &rel2.current.date;</li>
 	      <li><a href="&u.rel2.notes;">发行公告</a></li>
 	      <li><a href="&u.rel2.hardware;">硬件兼容性列表</a></li>
 	      <li><a href="&u.rel2.installation;">安装说明</a></li>
 	      <li><a href="&u.rel2.errata;">勘误</a></li>
 	      <li><a href="&u.rel2.signatures;">已签名校验和</a></li>
 	    </ul>
 	  </td>
 	</tr>
       </tbody>
     </table>
     <br />
 
     &beta.desc;
     &beta.second;
 
     <a name="download-snapshots"></a>
 
     <h1>开发快照</h1>
 
     <p>如果您对一个完全实验性的 &os;-CURRENT (&rel.head;-CURRENT) 发行版
       <strong>快照</strong> 感兴趣， 请参阅
       <a href="&enbase;/snapshots/">&os; 发行版快照</a> 页。
       快照仅供开发者和前沿测试者使用。
       欲了解关于过去、 现在和未来发行版的更多信息， 请参阅
       <a href="&base;/releases/index.html">发行版信息</a> 页。</p>
 
     <h1>&os; &rel.head;-CURRENT</h1>
 
     <table class="tblbasic tblwide tbldownload">
       <tbody>
 	<tr>
 	  <th>安装程序映像</th>
 	  <th>虚拟机映像</th>
 	  <th>SD 卡映像</th>
 	  <th>文档</th>
 	</tr>
 	<tr>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.snapshot;/amd64/amd64/ISO-IMAGES/&rel.head;/">amd64</a></li>
 	      <li><a href="&url.snapshot;/i386/i386/ISO-IMAGES/&rel.head;/">i386</a></li>
 	      <li><a href="&url.snapshot;/powerpc/powerpc/ISO-IMAGES/&rel.head;/">powerpc</a></li>
 	      <li><a href="&url.snapshot;/powerpc/powerpc64/ISO-IMAGES/&rel.head;/">powerpc64</a></li>
 	      <li><a href="&url.snapshot;/sparc64/sparc64/ISO-IMAGES/&rel.head;/">sparc64</a></li>
 	      <li><a href="&url.snapshot;/arm/arm/ISO-IMAGES/&rel.head;/">arm</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel.head;/">armv6</a></li>
 	      <li><a href="&url.snapshot;/arm/armv7/ISO-IMAGES/&rel.head;/">armv7</a></li>
 	      <li><a href="&url.snapshot;/arm64/aarch64/ISO-IMAGES/&rel.head;/">aarch64</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.snapshot;/VM-IMAGES/&rel.head;-CURRENT/amd64/Latest/">amd64</a></li>
 	      <li><a href="&url.snapshot;/VM-IMAGES/&rel.head;-CURRENT/i386/Latest/">i386</a></li>
 	      <li><a href="&url.snapshot;/VM-IMAGES/&rel.head;-CURRENT/aarch64/Latest/">aarch64</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.snapshot;/arm/armv7/ISO-IMAGES/&rel.head;/">BANANAPI</a></li>
 	      <li><a href="&url.snapshot;/arm/armv7/ISO-IMAGES/&rel.head;/">BEAGLEBONE</a></li>
 	      <li><a href="&url.snapshot;/arm/armv7/ISO-IMAGES/&rel.head;/">CUBIEBOARD</a></li>
 	      <li><a href="&url.snapshot;/arm/armv7/ISO-IMAGES/&rel.head;/">CUBIEBOARD2</a></li>
 	      <li><a href="&url.snapshot;/arm/armv7/ISO-IMAGES/&rel.head;/">CUBOX/HUMMINGBOARD</a></li>
 	      <li><a href="&url.snapshot;/arm/arm/ISO-IMAGES/&rel.head;/">GUMSTIX</a></li>
 	      <li><a href="&url.snapshot;/arm/armv7/ISO-IMAGES/&rel.head;/">PANDABOARD</a></li>
 	      <li><a href="&url.snapshot;/arm64/aarch64/ISO-IMAGES/&rel.head;/">PINE64</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel.head;/">RPI-B</a></li>
 	      <li><a href="&url.snapshot;/arm/armv7/ISO-IMAGES/&rel.head;/">RPI2</a></li>
 	      <li><a href="&url.snapshot;/arm64/aarch64/ISO-IMAGES/&rel.head;/">RPI3</a></li>
 	      <li><a href="&url.snapshot;/arm/armv7/ISO-IMAGES/&rel.head;/">WANDBOARD</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdocslist">
 	      <li><a href="&enbase;/relnotes/12.0R/relnotes.html">发行公告</a></li>
 	    </ul>
 	  </td>
 	</tr>
       </tbody>
     </table>
 
     <p>&nbsp;</p>
 
     <h1>&os; &rel.current;-STABLE</h1>
 
     <table class="tblbasic tblwide tbldownload">
       <tbody>
 	<tr>
 	  <th>安装程序映像</th>
 	  <th>虚拟机映像</th>
 	  <th>SD 卡映像</th>
 	  <th>文档</th>
 	</tr>
 	<tr>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.snapshot;/amd64/amd64/ISO-IMAGES/&rel.current;/">amd64</a></li>
 	      <li><a href="&url.snapshot;/i386/i386/ISO-IMAGES/&rel.current;/">i386</a></li>
 	      <li><a href="&url.snapshot;/powerpc/powerpc/ISO-IMAGES/&rel.current;/">powerpc</a></li>
 	      <li><a href="&url.snapshot;/powerpc/powerpc64/ISO-IMAGES/&rel.current;/">powerpc64</a></li>
 	      <li><a href="&url.snapshot;/sparc64/sparc64/ISO-IMAGES/&rel.current;/">sparc64</a></li>
 	      <li><a href="&url.snapshot;/arm/arm/ISO-IMAGES/&rel.current;/">arm</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel.current;/">armv6</a></li>
 	      <li><a href="&url.snapshot;/arm64/aarch64/ISO-IMAGES/&rel.current;/">aarch64</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.snapshot;/VM-IMAGES/&rel.current;-STABLE/amd64/Latest/">amd64</a></li>
 	      <li><a href="&url.snapshot;/VM-IMAGES/&rel.current;-STABLE/i386/Latest/">i386</a></li>
 	      <li><a href="&url.snapshot;/VM-IMAGES/&rel.current;-STABLE/aarch64/Latest/">aarch64</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel.current;/">BANANAPI</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel.current;/">BEAGLEBONE</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel.current;/">CUBIEBOARD</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel.current;/">CUBIEBOARD2</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel.current;/">CUBOX/HUMMINGBOARD</a></li>
 	      <li><a href="&url.snapshot;/arm/arm/ISO-IMAGES/&rel.current;/">GUMSTIX</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel.current;/">PANDABOARD</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel.current;/">RPI2</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel.current;/">RPI-B</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel.current;/">WANDBOARD</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdocslist">
 	      <li><a href="&enbase;/relnotes/&rel.current.major;-STABLE/relnotes/article.html">Release Notes</a></li>
 	    </ul>
 	  </td>
 	</tr>
       </tbody>
     </table>
 
     <p>&nbsp;</p>
 
     <h1>&os; &rel2.current;-STABLE</h1>
 
     <table class="tblbasic tblwide tbldownload">
       <tbody>
 	<tr>
 	  <th>安装程序映像</th>
 	  <th>虚拟机映像</th>
 	  <th>SD 卡映像</th>
 	  <th>文档</th>
 	</tr>
 	<tr>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.snapshot;/amd64/amd64/ISO-IMAGES/&rel2.current;/">amd64</a></li>
 	      <li><a href="&url.snapshot;/i386/i386/ISO-IMAGES/&rel2.current;/">i386</a></li>
 	      <li><a href="&url.snapshot;/ia64/ia64/ISO-IMAGES/&rel2.current;/">ia64</a></li>
 	      <li><a href="&url.snapshot;/powerpc/powerpc/ISO-IMAGES/&rel2.current;/">powerpc</a></li>
 	      <li><a href="&url.snapshot;/powerpc/powerpc64/ISO-IMAGES/&rel2.current;/">powerpc64</a></li>
 	      <li><a href="&url.snapshot;/sparc64/sparc64/ISO-IMAGES/&rel2.current;/">sparc64</a></li>
 	      <li><a href="&url.snapshot;/arm/arm/ISO-IMAGES/&rel2.current;/">arm</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel2.current;/">armv6</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.snapshot;/VM-IMAGES/&rel2.current;-STABLE/amd64/Latest/">amd64</a></li>
 	      <li><a href="&url.snapshot;/VM-IMAGES/&rel2.current;-STABLE/i386/Latest/">i386</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel2.current;/">BEAGLEBONE</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel2.current;/">CUBOX/HUMMINGBOARD</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel2.current;/">GUMSTIX</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel2.current;/">PANDABOARD</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel2.current;/">RPI-B</a></li>
 	      <li><a href="&url.snapshot;/arm/armv6/ISO-IMAGES/&rel2.current;/">WANDBOARD</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdocslist">
 	      <li><a href="&enbase;/relnotes/&rel2.current.major;-STABLE/relnotes/article.html">发行公告</a></li>
 	    </ul>
 	  </td>
 	</tr>
       </tbody>
     </table>
 
     <p>如果您打算通过 HTTP 或 FTP 下载 &os;， 请参阅使用手册中的
       <a href="&enbase;/doc/en_US.ISO8859-1/books/handbook/mirrors-ftp.html"><strong>镜像站点</strong></a>
       列表， 查找离您最近的站点。</p>
 
     <a name="install"></a>
 
     <h2>安装 &os;</h2>
 
     <p>安装 &os; 有许多种选择，
       包括从 CD-ROM、 DVD、 USB 磁盘、 匿名 FTP、 HTTP 以及 NFS 安装。
       请在下载完整的 &os; 发行版之前通读
       <a href="&enbase;/doc/en_US.ISO8859-1/books/handbook/bsdinstall.html">&os;安装说明</a> 。</p>
 
     <a name="distribution"></a>
 
     <h2>购买 &os;</h2>
 
     <p>&os; 可以在 <a href="http://www.freebsdmall.com/">FreeBSD Mall</a>
       或其它的
       <a href="&enbase;/doc/en_US.ISO8859-1/books/handbook/mirrors.html">CD-ROM
       和 DVD 发行商</a> 处取得 CD-ROM 或 DVD。</p>
 
     <a name="past"></a>
 
     <h2>过去的发行版</h2>
 
     <p>若要下载过去的发行版， 请到
 	<a href="http://ftp-archive.FreeBSD.org/pub/FreeBSD-Archive/old-releases/">
 	FTP 存档</a> 下载。</p>
 
     <a name="derived"></a>
 
     <h2>&os; 衍生的操作系统发行版</h2>
 
     <p>&os; 被广泛用于其它商业和开源操作系统的组成部分。
      以下的项目被广泛使用并尤其使 &os; 用户感兴趣。</p>
 
     <ul class="txtdownloadlist">
 	<li><p><a href="http://www.freenas.org">FreeNAS</a> 是一个基于 &os;
 	的开源存储平台， 它支持在 Windows、 Apple 和类 UNIX 系统之间分享文件。</p></li>
 
       <li><p><a href="https://www.trueos.org">TrueOS</a>
         （前身为 <a href="https://pcbsd.org">PC-BSD</a>）
 	是一个具有图形化安装程序的 &os; 衍生操作系统，
 	其桌面选项安装 <a href="https://lumina-desktop.org">Lumina 桌面环境</a>，
 	一个完全采用 BSD 协议的桌面环境。
 	它令人印象深刻的桌面工具旨在方便一般电脑用户使用。</p></li>
 
       <li><p><a href="http://www.pfsense.org">pfSense</a> 是一个基于 &os; 的定制发行版，
         为防火墙和路由器使用专门定制。</p></li>
     </ul>
 
     <a name="apps"></a>
 
     <h2>应用和实用程序</h2>
 
     <h3>Ports 套件库</h3>
 
     <p>&os; Ports 套件库是各种已被移植到 &os; 的软件和实用程序集合。</p>
 
     <p>请参阅使用手册中的 <a href="&enbase;/doc/zh_CN.UTF-8/books/handbook/ports.html">
       <strong>安装应用程序: Packages 和 Ports</strong></a> 章节。</p>
 
     <ul class="txtdownloadlist">
       <li><a href="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/">下载 &os; 套件库框架</a></li>
 
       <li><a href="&enbase;/ports/index.html">Ports 套件库的网页界面</a></li>
 
       <li><a href="http://www.freshports.org/">FreshPorts - 一个更高级的
 	  Ports 套件库网页界面</a></li>
     </ul>
 
     <p>想知道 <em>您</em> 如何将 <em>您</em> 喜爱的软件加入 Ports 套件库，
 	  请参阅 <em><a href="&enbase;/doc/zh_CN.UTF-8/books/porters-handbook/index.html">The
 	  Porter's Handbook</a></em> 和
 	  <em><a href="&enbase;/doc/zh_CN.UTF-8/articles/contributing/index.html">为 &os; 做贡献</a></em>
           这篇文章。</p>
 
   </body>
 </html>
diff --git a/zh_CN.UTF-8/share/xml/header.l10n.ent b/zh_CN.UTF-8/share/xml/header.l10n.ent
index abec2fc11f..039dd2285e 100644
--- a/zh_CN.UTF-8/share/xml/header.l10n.ent
+++ b/zh_CN.UTF-8/share/xml/header.l10n.ent
@@ -1,121 +1,121 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $FreeBSD$ -->
 
 <!-- The FreeBSD Simplified Chinese Documentation Project -->
-<!-- Original revision: r51995 -->
+<!-- Original Revision: 444f5b3051 (r51995) -->
 
 
 <!ENTITY copyright '<span xmlns="http://www.w3.org/1999/xhtml"><a href="&base;/search/index-site.html">站点地图</a> |
   <a href="&base;/copyright/">法律信息</a> | &copy; 1995&ndash;2020 FreeBSD 项目。
   保留所有权利。</span>'>
 <!ENTITY email 'freebsd-questions'>
 <!ENTITY author '<a href="&base;/index.html">主页</a> &nbsp; | &nbsp; <a href="&base;/mailto.html">联系</a> &nbsp; | &nbsp; <a href="&base;/copyright/index.html">版权</a> &nbsp; | &nbsp; &copyright;'>
 <!ENTITY home '<a href="&base;/index.html"><img src="&enbase;/gifs/home.gif"
   alt="FreeBSD 主页" border="0" align="right" width="101" height="33"></a>'>
 
 <!ENTITY header2.word.search '搜索'>
 <!ENTITY header2.word.donate '捐赠'>
 <!ENTITY header2.word.contact '联系'>
 
 <!ENTITY header2.donatebutton '
   <div xmlns="http://www.w3.org/1999/xhtml" class="frontdonateroundbox">
     <div class="frontdonatetop"><div><b style="display: none;">.</b></div></div>
       <div class="frontdonatecontent">
         <a
           href="https://www.FreeBSDFoundation.org/donate/">捐赠 FreeBSD</a>
       </div>
     <div class="frontdonatebot"><div><b style="display: none;">.</b></div></div>
   </div>
 '>
 
 
 
 <!ENTITY stylesheet '&enbase;/layout/css/fixed.css'>
 <!ENTITY stylesheetlarge '&enbase;/layout/css/fixed_large.css'>
 <!ENTITY nav ''>
 
 <!ENTITY header2.topnav '
   <div xmlns="http://www.w3.org/1999/xhtml" id="menu">
     <ul class="first">
       <li><a href="&base;/">首页</a></li>
     </ul>
     <ul>
       <li><a href="&base;/about.html">关于</a>
   <ul>
     <li><a href="&enbase;/projects/newbies.html">简介</a></li>
     <li><a href="&enbase;/features.html">特性</a></li>
     <li><a href="&enbase;/advocacy/">宣传</a></li>
     <li><a href="&enbase;/marketing/">营销</a></li>
     <li><a href="&enbase;/privacy.html">隐私政策</a></li>
   </ul>
       </li>
     </ul>
     <ul>
       <li><a href="&base;/where.html">获取 FreeBSD</a>
   <ul>
     <li><a href="&base;/releases/">发行版本</a></li>
     <li><a href="&enbase;/releng/">发布工程</a></li>
   </ul>
       </li>
     </ul>
     <ul>
       <li><a href="&base;/docs.html">文档</a>
   <ul>
     <li><a href="&enbase;/doc/en_US.ISO8859-1/books/faq/">常见问题合集</a></li>
     <li><a href="&enbase;/doc/zh_CN/books/handbook/">使用手册</a></li>
     <li><a href="&enbase;/doc/zh_CN/books/porters-handbook">Porter&#39; 手册</a></li>
     <li><a href="&enbase;/doc/zh_TW/books/developers-handbook">Developer&#39; 手册</a></li>
     <li><a href="&cgibase;/man.cgi">Manual Pages</a></li>
     <li><a href="&enbase;/doc/zh_TW/books/fdp-primer">文档计划入门书</a></li>
     <li><a href="&enbase;/docs/books.html">所有书籍和文档</a></li>
   </ul>
       </li>
     </ul>
     <ul>
       <li><a href="&base;/community.html">社区</a>
   <ul>
     <li><a href="&enbase;/community/mailinglists.html">邮件列表</a></li>
     <li><a href="https://forums.FreeBSD.org">论坛</a></li>
     <li><a href="&enbase;/usergroups.html">用户群体</a></li>
     <li><a href="&enbase;/events/events.html">活动</a></li>
     <li><a href="http://serverfault.com/questions/tagged/freebsd">Q&amp;A (external)</a></li>
   </ul>
       </li>
     </ul>
     <ul>
       <li><a href="&enbase;/projects/index.html">开发</a>
   <ul>
     <li><a href="https://wiki.FreeBSD.org/IdeasPage">项目新点子</a></li>
     <li><a href="https://svnweb.FreeBSD.org">Subversion 仓库</a></li>
     <li><a href="https://github.com/freebsd">Git 镜像</a></li>
     <li><a href="https://reviews.FreeBSD.org">代码审查 (Phabricator)</a></li>
     <li><a href="https://wiki.FreeBSD.org">Wiki</a></li>
     <li><a href="https://ci.FreeBSD.org">持续集成服务</a></li>
   </ul>
       </li>
     </ul>
     <ul>
       <li><a href="&base;/support.html">支持</a>
   <ul>
     <li><a href="&enbase;/commercial/commercial.html">供应商</a></li>
     <li><a href="&enbase;/security/">安全公告</a></li>
     <li><a href="https://bugs.FreeBSD.org/search/">问题报告</a></li>
     <li><a href="https://www.FreeBSD.org/support.html">提交问题报告</a></li>
   </ul>
       </li>
     </ul>
     <ul>
       <li><a href="https://www.freebsdfoundation.org/">基金会</a>
   <ul>
     <li><a href="https://www.freebsdfoundation.org/donate/">资金捐赠</a></li>
     <li><a href="&enbase;/donations/index.html#systems">硬件捐赠</a></li>
   </ul>
       </li>
     </ul>
   </div> <!-- MENU -->
   '>
 
 <!-- macro for webbuild paper -->
 <!ENTITY webbuild '
 <p xmlns="http://www.w3.org/1999/xhtml">介绍如何手动通过 SVN repository 更新，
 以及编译 FreeBSD 网页。</p>'>
diff --git a/zh_CN.UTF-8/share/xml/l10n.ent b/zh_CN.UTF-8/share/xml/l10n.ent
index ad3cda7740..60fe4fd6a6 100644
--- a/zh_CN.UTF-8/share/xml/l10n.ent
+++ b/zh_CN.UTF-8/share/xml/l10n.ent
@@ -1,224 +1,224 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <!-- -*- sgml -*-
      DocBook Language Specific Entities for Localization (Simplified Chinese).
 
      $FreeBSD$
 -->
 
 <!-- docformat navi -->
 <!ENTITY docnavi.single-html "完整模式">
 <!ENTITY docnavi.split-html  "章节模式">
 
 <!-- charset for HTML output -->
 <!ENTITY doc.html.charset "utf-8">
 
 <!ENTITY mdash "──">
 
 <!ENTITY cnproj.freebsd.org "FreeBSD 中文计划">
 
 <!ENTITY cnproj.url.base "http://www.FreeBSD.org.cn">
 
 <!ENTITY cnsnap.url.base "http://cnsnap.cn.FreeBSD.org">
 
 <!ENTITY cnproj.contributing.to.freebsd.doc "<para xmlns='http://docbook.org/ns/docbook'>欢迎您阅读《&os;系统结构手册》。
          这本手册还在不断由许多人<emphasis>继续书写</emphasis>。
          许多章节还是空白，有的章节亟待更新。
          如果您对这个项目感兴趣并愿意有所贡献，请发信给 &a.doc;。</para>
 ">
 
 <!ENTITY cnproj.getting.freebsd.doc "<para xmlns='http://docbook.org/ns/docbook'>
          本文档的最新英文原始版本可从
          <link xlink:href='&url.base;/index.html'>FreeBSD Web 站点</link> 获得，
          由 <link xlink:href='&cnproj.url.base;/'>&cnproj.freebsd.org;</link>
          维护的最新译本可以在 <link xlink:href='&cnsnap.url.base;/zh_CN/'>&cnproj.freebsd.org; 快照 Web 站点</link>
          和 <link xlink:href='&cnsnap.url.base;/doc/zh_CN.UTF-8/'>&cnproj.freebsd.org; 文档快照</link>
          处获得， 这一译本会不断向主站同步。 此外， 您也可以从
          <link xlink:href='ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/'>FreeBSD FTP 服务器</link>
          或众多的 <link xlink:href='&url.books.handbook;/mirrors-ftp.html'>镜像站点</link>
          得到这份文档的各种其他格式以及压缩形式的版本。</para>
 ">
 
 
 <!ENTITY cnproj.contributed.by "供稿：">
 
 <!ENTITY cnproj.modified.for.handbook.by "改编为手册：">
 
 <!ENTITY cnproj.translated.by "翻译：">
 
 <!ENTITY cnproj.written.by "写作：">
 
 <!ENTITY url.doc.langcode    'zh_CN.UTF-8'>
 <!ENTITY xml.encoding        'utf-8'>
 
 
 <!-- From FreeBSD: www/share/xml/release.ent -->
-<!-- Original Revision: r52666 -->
+<!-- Original Revision: 03c522ecab (r52666) -->
 
 <!-- Do not set this to 'INCLUDE' in this file. -->
 <!ENTITY % beta.local.where "IGNORE">
 <!ENTITY % beta2.local.where "IGNORE">
 
 <!ENTITY rel.head.major '13'>
 <!ENTITY rel.head '&rel.head.major;.0'>
 
 <!-- If there is no release currently in the release cycle (i.e. we
       don't have something in BETAn or RCn), then change %beta.testing
       below to "IGNORE".  If we do, use "INCLUDE". -->
 
 <!-- Set to 'INCLUDE' when the schedule is available. -->
 <!ENTITY beta.upcoming "IGNORE">
 <!ENTITY % beta.upcoming "IGNORE">
 
 <!-- Set to 'INCLUDE' when the installation images are available. -->
 <!ENTITY beta.testing "IGNORE">
 <!ENTITY % beta.testing "IGNORE">
 <!ENTITY betarel.current '12.0'>
 <!ENTITY betarel.vers 'RELEASE'>
 <!ENTITY u.betarel.schedule '&enbase;/releases/&betarel.current;R/schedule.html'>
 
 <!-- If we have a second release in the release cycle (e.g. 5.x and 6.y
       are having release candidates at the same time), do the same here.  -->
 
 <!-- Set to 'INCLUDE' when the schedule is available. -->
 <!ENTITY beta2.upcoming "IGNORE">
 <!ENTITY % beta2.upcoming "IGNORE">
 
 <!-- Set to 'INCLUDE' when the installation images are available. -->
 <!ENTITY beta2.testing "IGNORE">
 <!ENTITY % beta2.testing "IGNORE">
 <!ENTITY betarel2.current '12.0'>
 <!ENTITY betarel2.vers 'RELEASE'>
 <!ENTITY u.betarel2.schedule '&enbase;/releases/&betarel2.current;R/schedule.html'>
 
 <!ENTITY u.betarel.schedule '&enbase;/releases/&betarel.current;R/schedule.html'>
 <!ENTITY u.betarel2.schedule '&enbase;/releases/&betarel2.current;R/schedule.html'>
 
 <!ENTITY rel.current.major '12'>
 <!ENTITY rel.current '12.0'>
 <!ENTITY rel.current.date '2018 年 12 月'>
 <!ENTITY rel122.current.date '2020 年  10 月'>
 <!ENTITY rel121.current.date '2019 年  11 月'>
 <!ENTITY rel120.current.date '2018 年  12 月'>
 <!ENTITY rel114.current.date '2020 年  6 月'>
 <!ENTITY rel113.current.date '2019 年  7 月'>
 <!ENTITY rel112.current.date '2018 年  6 月'>
 
 <!-- URLs to information on the latest release -->
 <!ENTITY u.rel122.notes '&enbase;/releases/&rel122.current;R/relnotes.html'>
 <!ENTITY u.rel122.announce '&enbase;/releases/&rel122.current;R/announce.html'>
 <!ENTITY u.rel122.errata '&enbase;/releases/&rel122.current;R/errata.html'>
 <!ENTITY u.rel122.hardware '&enbase;/releases/&rel122.current;R/hardware.html'>
 <!ENTITY u.rel122.installation '&enbase;/releases/&rel122.current;R/installation.html'>
 <!ENTITY u.rel122.readme '&enbase;/releases/&rel122.current;R/readme.html'>
 <!ENTITY u.rel122.signatures '&enbase;/releases/&rel122.current;R/signatures.html'>
 
 <!ENTITY u.rel121.notes '&enbase;/releases/&rel121.current;R/relnotes.html'>
 <!ENTITY u.rel121.announce '&enbase;/releases/&rel121.current;R/announce.html'>
 <!ENTITY u.rel121.errata '&enbase;/releases/&rel121.current;R/errata.html'>
 <!ENTITY u.rel121.hardware '&enbase;/releases/&rel121.current;R/hardware.html'>
 <!ENTITY u.rel121.installation '&enbase;/releases/&rel121.current;R/installation.html'>
 <!ENTITY u.rel121.readme '&enbase;/releases/&rel121.current;R/readme.html'>
 <!ENTITY u.rel121.signatures '&enbase;/releases/&rel121.current;R/signatures.html'>
 
 <!ENTITY u.rel120.notes '&enbase;/releases/&rel120.current;R/relnotes.html'>
 <!ENTITY u.rel120.announce '&enbase;/releases/&rel120.current;R/announce.html'>
 <!ENTITY u.rel120.errata '&enbase;/releases/&rel120.current;R/errata.html'>
 <!ENTITY u.rel120.hardware '&enbase;/releases/&rel120.current;R/hardware.html'>
 <!ENTITY u.rel120.installation '&enbase;/releases/&rel120.current;R/installation.html'>
 <!ENTITY u.rel120.readme '&enbase;/releases/&rel120.current;R/readme.html'>
 <!ENTITY u.rel120.signatures '&enbase;/releases/&rel120.current;R/signatures.html'>
 
 <!ENTITY u.rel114.notes '&enbase;/releases/&rel114.current;R/relnotes.html'>
 <!ENTITY u.rel114.announce '&enbase;/releases/&rel114.current;R/announce.html'>
 <!ENTITY u.rel114.errata '&enbase;/releases/&rel114.current;R/errata.html'>
 <!ENTITY u.rel114.hardware '&enbase;/releases/&rel114.current;R/hardware.html'>
 <!ENTITY u.rel114.installation '&enbase;/releases/&rel114.current;R/installation.html'>
 <!ENTITY u.rel114.readme '&enbase;/releases/&rel114.current;R/readme.html'>
 <!ENTITY u.rel114.signatures '&enbase;/releases/&rel114.current;R/signatures.html'>
 
 <!ENTITY u.rel113.notes '&enbase;/releases/&rel113.current;R/relnotes.html'>
 <!ENTITY u.rel113.announce '&enbase;/releases/&rel113.current;R/announce.html'>
 <!ENTITY u.rel113.errata '&enbase;/releases/&rel113.current;R/errata.html'>
 <!ENTITY u.rel113.hardware '&enbase;/releases/&rel113.current;R/hardware.html'>
 <!ENTITY u.rel113.installation '&enbase;/releases/&rel113.current;R/installation.html'>
 <!ENTITY u.rel113.readme '&enbase;/releases/&rel113.current;R/readme.html'>
 <!ENTITY u.rel113.signatures '&enbase;/releases/&rel113.current;R/signatures.html'>
 
 <!-- URLs to information on the latest release -->
 <!ENTITY u.rel.notes '&enbase;/releases/&rel.current;R/relnotes.html'>
 <!ENTITY u.rel.announce '&enbase;/releases/&rel.current;R/announce.html'>
 <!ENTITY u.rel.errata '&enbase;/releases/&rel.current;R/errata.html'>
 <!ENTITY u.rel.hardware '&enbase;/releases/&rel.current;R/hardware.html'>
 <!ENTITY u.rel.installation '&enbase;/releases/&rel.current;R/installation.html'>
 <!ENTITY u.rel.readme '&enbase;/releases/&rel.current;R/readme.html'>
 <!ENTITY u.rel.signatures '&enbase;/releases/&rel.current;R/signatures.html'>
 
 <!ENTITY rel1.current.major '11'>
 <!ENTITY rel1.current '11.2'>
 <!ENTITY rel1.current.date '2018 年 6 月'>
 
 <!-- URLs to information on the latest release -->
 <!ENTITY u.rel1.notes '&enbase;/releases/&rel1.current;R/relnotes.html'>
 <!ENTITY u.rel1.announce '&enbase;/releases/&rel1.current;R/announce.html'>
 <!ENTITY u.rel1.errata '&enbase;/releases/&rel1.current;R/errata.html'>
 <!ENTITY u.rel1.hardware '&enbase;/releases/&rel1.current;R/hardware.html'>
 <!ENTITY u.rel1.installation '&enbase;/releases/&rel1.current;R/installation.html'>
 <!ENTITY u.rel1.readme '&enbase;/releases/&rel1.current;R/readme.html'>
 <!ENTITY u.rel1.signatures '&enbase;/releases/&rel1.current;R/signatures.html'>
 
 <!-- Tertiary "current release" entities -->
 <!ENTITY rel3.current.major '10'>
 <!ENTITY rel3.current '&rel3.current.major;.2'>
 <!ENTITY rel3.current.date '2015 年 8 月'>
 
 <!-- URLs to information on the latest release -->
 <!ENTITY u.rel3.notes '&enbase;/releases/&rel3.current;R/relnotes.html'>
 <!ENTITY u.rel3.announce '&enbase;/releases/&rel3.current;R/announce.html'>
 <!ENTITY u.rel3.errata '&enbase;/releases/&rel3.current;R/errata.html'>
 <!ENTITY u.rel3.hardware '&enbase;/releases/&rel3.current;R/hardware.html'>
 <!ENTITY u.rel3.installation '&enbase;/releases/&rel3.current;R/installation.html'>
 <!ENTITY u.rel3.readme '&enbase;/releases/&rel3.current;R/readme.html'>
 <!ENTITY u.rel3.signatures '&enbase;/releases/&rel3.current;R/signatures.html'>
 
 <!-- URLs to old releases, kept so the build succeeds -->
 <!ENTITY rel0.current.major '11'>
 <!ENTITY rel0.current '11.0'>
 <!ENTITY rel0.current.date '2016 年 10 月'>
 
 <!ENTITY u.rel0.notes '&enbase;/releases/&rel0.current;R/relnotes.html'>
 <!ENTITY u.rel0.announce '&enbase;/releases/&rel0.current;R/announce.html'>
 <!ENTITY u.rel0.errata '&enbase;/releases/&rel0.current;R/errata.html'>
 <!ENTITY u.rel0.hardware '&enbase;/releases/&rel0.current;R/hardware.html'>
 <!ENTITY u.rel0.installation '&enbase;/releases/&rel0.current;R/installation.html'>
 <!ENTITY u.rel0.readme '&enbase;/releases/&rel0.current;R/readme.html'>
 <!ENTITY u.rel0.signatures '&enbase;/releases/&rel0.current;R/signatures.html'>
 
 <!ENTITY rel2.current.major '10'>
 <!ENTITY rel2.current '10.4'>
 <!ENTITY rel2.current.date '2017 年 10 月'>
 
 <!-- URLs to information on the latest release -->
 <!ENTITY u.rel2.notes '&enbase;/releases/&rel2.current;R/relnotes.html'>
 <!ENTITY u.rel2.announce '&enbase;/releases/&rel2.current;R/announce.html'>
 <!ENTITY u.rel2.errata '&enbase;/releases/&rel2.current;R/errata.html'>
 <!ENTITY u.rel2.hardware '&enbase;/releases/&rel2.current;R/hardware.html'>
 <!ENTITY u.rel2.installation '&enbase;/releases/&rel2.current;R/installation.html'>
 <!ENTITY u.rel2.readme '&enbase;/releases/&rel2.current;R/readme.html'>
 <!ENTITY u.rel2.signatures '&enbase;/releases/&rel2.current;R/signatures.html'>
 
 <!-- Quaternary "current release" entities -->
 <!ENTITY rel4.current.major '10'>
 <!ENTITY rel4.current '&rel4.current.major;.1'>
 <!ENTITY rel4.current.date '2014 年 11 月'>
 
 <!-- URLs to information on the latest release -->
 <!ENTITY u.rel4.notes '&enbase;/releases/&rel4.current;R/relnotes.html'>
 <!ENTITY u.rel4.announce '&enbase;/releases/&rel4.current;R/announce.html'>
 <!ENTITY u.rel4.errata '&enbase;/releases/&rel4.current;R/errata.html'>
 <!ENTITY u.rel4.hardware '&enbase;/releases/&rel4.current;R/hardware.html'>
 <!ENTITY u.rel4.installation '&enbase;/releases/&rel4.current;R/installation.html'>
 <!ENTITY u.rel4.readme '&enbase;/releases/&rel4.current;R/readme.html'>
 
 <!ENTITY gnomeoldver '2.30'>
 <!ENTITY gnomever '2.32'>
 <!ENTITY gnomedevelver '3.6'>
diff --git a/zh_CN.UTF-8/share/xml/mailing-lists.ent b/zh_CN.UTF-8/share/xml/mailing-lists.ent
index 56fcde6b97..ae7631ae1e 100644
--- a/zh_CN.UTF-8/share/xml/mailing-lists.ent
+++ b/zh_CN.UTF-8/share/xml/mailing-lists.ent
@@ -1,637 +1,637 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      Names of FreeBSD mailing lists and related software.
      The FreeBSD Chinese Documentation Project
 
-     Original Revision: r43258
+     Original Revision: e1d14b4b56 (r43258)
      $FreeBSD$
 -->
 
 <!ENTITY a.mailman.listinfo "http://lists.FreeBSD.org/mailman/listinfo">
 <!ENTITY a.mailman.lists "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.mailman.listinfo;'>FreeBSD 邮件列表服务器</link>">
 <!ENTITY a.mailman.lists.link "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.mailman.listinfo;'>&a.mailman.listinfo;</link>">
 
 <!ENTITY a.acpi.url "&a.mailman.listinfo;/freebsd-acpi">
 <!ENTITY a.acpi "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.acpi.url;'>FreeBSD ACPI 邮件列表</link>">
 <!ENTITY a.acpi.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.acpi.url;'>freebsd-acpi</link>">
 
 <!ENTITY a.advocacy.url "&a.mailman.listinfo;/freebsd-advocacy">
 <!ENTITY a.advocacy "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.advocacy.url;'>FreeBSD advocacy 邮件列表</link>">
 <!ENTITY a.advocacy.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.advocacy.url;'>freebsd-advocacy</link>">
 
 <!ENTITY a.afs.url "&a.mailman.listinfo;/freebsd-afs">
 <!ENTITY a.afs "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.afs.url;'>FreeBSD AFS 移植邮件列表</link>">
 <!ENTITY a.afs.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.afs.url;'>freebsd-afs</link>">
 
 <!ENTITY a.aic7xxx.url "&a.mailman.listinfo;/aic7xxx">
 <!ENTITY a.aic7xxx "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.aic7xxx.url;'>FreeBSD Adaptec AIC7xxx 相关讨论邮件列表</link>">
 <!ENTITY a.aic7xxx.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.aic7xxx.url;'>freebsd-aic7xxx</link>">
 
 <!ENTITY a.amd64.url "&a.mailman.listinfo;/freebsd-amd64">
 <!ENTITY a.amd64 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.amd64.url;'>将 FreeBSD 移植到 AMD64 系统上</link>">
 <!ENTITY a.amd64.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.amd64.url;'>freebsd-amd64</link>">
 
 <!ENTITY a.announce.url "&a.mailman.listinfo;/freebsd-announce">
 <!ENTITY a.announce "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.announce.url;'>FreeBSD 公告邮件列表</link>">
 <!ENTITY a.announce.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.announce.url;'>freebsd-announce</link>">
 
 <!ENTITY a.apache.url "&a.mailman.listinfo;/freebsd-apache">
 <!ENTITY a.apache "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.apache.url;'>FreeBSD Apache 邮件列表</link>">
 <!ENTITY a.apache.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.apache.url;'>freebsd-apache</link>">
 
 <!ENTITY a.arch.url "&a.mailman.listinfo;/freebsd-arch">
 <!ENTITY a.arch "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.arch.url;'>FreeBSD 架构与设计邮件列表</link>">
 <!ENTITY a.arch.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.arch.url;'>freebsd-arch</link>">
 
 <!ENTITY a.arm.url "&a.mailman.listinfo;/freebsd-arm">
 <!ENTITY a.arm "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.arm.url;'>FreeBSD ARM 移植邮件列表</link>">
 <!ENTITY a.arm.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.arm.url;'>freebsd-arm</link>">
 
 <!ENTITY a.atm.url "&a.mailman.listinfo;/freebsd-atm">
 <!ENTITY a.atm "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.atm.url;'>FreeBSD ATM 网络邮件列表</link>">
 <!ENTITY a.atm.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.atm.url;'>freebsd-atm</link>">
 
 <!ENTITY a.bluetooth.url "&a.mailman.listinfo;/freebsd-bluetooth">
 <!ENTITY a.bluetooth "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.bluetooth.url;'>FreeBSD Bluetooth 邮件列表</link>">
 <!ENTITY a.bluetooth.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.bluetooth.url;'>freebsd-bluetooth</link>">
 
 <!ENTITY a.bugbusters.url "&a.mailman.listinfo;/freebsd-bugbusters">
 <!ENTITY a.bugbusters "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.bugbusters.url;'>FreeBSD bugbusters 邮件列表</link>">
 <!ENTITY a.bugbusters.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.bugbusters.url;'>freebsd-bugbusters</link>">
 
 <!ENTITY a.bugs.url "&a.mailman.listinfo;/freebsd-bugs">
 <!ENTITY a.bugs "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.bugs.url;'>FreeBSD 问题报告邮件列表</link>">
 <!ENTITY a.bugs.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.bugs.url;'>freebsd-bugs</link>">
 
 <!ENTITY a.chat.url "&a.mailman.listinfo;/freebsd-chat">
 <!ENTITY a.chat "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.chat.url;'>FreeBSD 闲聊邮件列表</link>">
 <!ENTITY a.chat.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.chat.url;'>freebsd-chat</link>">
 
 <!ENTITY a.chromium.url "&a.mailman.listinfo;/freebsd-chromium">
 <!ENTITY a.chromium "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.chromium.url;'>FreeBSD Chromium 邮件列表</link>">
 <!ENTITY a.chromium.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.chromium.url;'>freebsd-chromium</link>">
 
 <!ENTITY a.cluster.url "&a.mailman.listinfo;/freebsd-cluster">
 <!ENTITY a.cluster "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cluster.url;'>FreeBSD 集群邮件列表</link>">
 <!ENTITY a.cluster.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cluster.url;'>freebsd-cluster</link>">
 
 <!ENTITY a.committers "FreeBSD committer 的邮件列表">
 <!ENTITY a.committers.name "cvs-committers">
 
 <!ENTITY a.core "FreeBSD 核心团队">
 <!ENTITY a.core.name "freebsd-core">
 
 <!ENTITY a.current.url "&a.mailman.listinfo;/freebsd-current">
 <!ENTITY a.current "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.current.url;'>&os.current; 邮件列表</link>">
 <!ENTITY a.current.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.current.url;'>freebsd-current</link>">
 
 <!ENTITY a.ctm-announce.url "&a.mailman.listinfo;/ctm-announce">
 <!ENTITY a.ctm-announce "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-announce.url;'>CTM 公告</link>">
 <!ENTITY a.ctm-announce.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-announce.url;'>ctm-announce</link>">
 
 <!ENTITY a.ctm-src-4.url "&a.mailman.listinfo;/ctm-src-4">
 <!ENTITY a.ctm-src-4 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-4.url;'>CTM 4-STABLE src branch distribution 邮件列表</link>">
 <!ENTITY a.ctm-src-4.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-4.url;'>ctm-src-4</link>">
 
 <!ENTITY a.ctm-src-5.url "&a.mailman.listinfo;/ctm-src-5">
 <!ENTITY a.ctm-src-5 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-5.url;'>CTM 5-STABLE src branch distribution 邮件列表</link>">
 <!ENTITY a.ctm-src-5.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-5.url;'>ctm-src-5</link>">
 
 <!ENTITY a.ctm-src-6.url "&a.mailman.listinfo;/ctm-src-6">
 <!ENTITY a.ctm-src-6 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-6.url;'>CTM 6-STABLE src branch distribution 邮件列表</link>">
 <!ENTITY a.ctm-src-6.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-6.url;'>ctm-src-6</link>">
 
 <!ENTITY a.ctm-src-7.url "&a.mailman.listinfo;/ctm-src-7">
 <!ENTITY a.ctm-src-7 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-7.url;'>CTM 7-STABLE src branch distribution 邮件列表</link>">
 <!ENTITY a.ctm-src-7.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-7.url;'>ctm-src-7</link>">
 
 <!ENTITY a.ctm-src-8.url "&a.mailman.listinfo;/ctm-src-8">
 <!ENTITY a.ctm-src-8 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-8.url;'>CTM 8-STABLE src branch distribution 邮件列表</link>">
 <!ENTITY a.ctm-src-8.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-8.url;'>ctm-src-8</link>">
 
 <!ENTITY a.ctm-src-9.url "&a.mailman.listinfo;/ctm-src-9">
 <!ENTITY a.ctm-src-9 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-9.url;'>CTM 9-STABLE src branch distribution 邮件列表</link>">
 <!ENTITY a.ctm-src-9.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-9.url;'>ctm-src-9</link>">
 
 <!ENTITY a.ctm-src-10.url "&a.mailman.listinfo;/ctm-src-10">
 <!ENTITY a.ctm-src-10 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-10.url;'>CTM 10-STABLE src branch distribution mailing list</link>">
 <!ENTITY a.ctm-src-10.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-10.url;'>ctm-src-10</link>">
 
 <!ENTITY a.ctm-src-cur.url "&a.mailman.listinfo;/ctm-src-cur">
 <!ENTITY a.ctm-src-cur "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-cur.url;'>CTM -CURRENT src branch distribution 邮件列表</link>">
 <!ENTITY a.ctm-src-cur.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-src-cur.url;'>ctm-src-cur</link>">
 
 <!ENTITY a.ctm-users.url "&a.mailman.listinfo;/ctm-users">
 <!ENTITY a.ctm-users "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-users.url;'>CTM user discussion 邮件列表</link>">
 <!ENTITY a.ctm-users.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ctm-users.url;'>ctm-users</link>">
 
 <!ENTITY a.cvsall.url "&a.mailman.listinfo;/cvs-all">
 <!ENTITY a.cvsall "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cvsall.url;'>FreeBSD CVS 全部修订记录邮件列表</link>">
 <!ENTITY a.cvsall.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cvsall.url;'>cvs-all</link>">
 
 <!ENTITY a.cvs-doc.url "&a.mailman.listinfo;/cvs-doc">
 <!ENTITY a.cvs-doc "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cvs-doc.url;'>FreeBSD CVS 文档修订记录邮件列表</link>">
 <!ENTITY a.cvs-doc.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cvs-doc.url;'>cvs-doc</link>">
 
 <!ENTITY a.cvs-ports.url "&a.mailman.listinfo;/cvs-ports">
 <!ENTITY a.cvs-ports "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cvs-ports.url;'>FreeBSD CVS ports 修订记录邮件列表</link>">
 <!ENTITY a.cvs-ports.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cvs-ports.url;'>cvs-ports</link>">
 
 <!ENTITY a.cvs-projects.url "&a.mailman.listinfo;/cvs-projects">
 <!ENTITY a.cvs-projects "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cvs-projects.url;'>FreeBSD CVS 附属项目修订记录邮件列表</link>">
 <!ENTITY a.cvs-projects.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cvs-projects.url;'>cvs-projects</link>">
 
 <!ENTITY a.cvs-src.url "&a.mailman.listinfo;/cvs-src">
 <!ENTITY a.cvs-src "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cvs-src.url;'>FreeBSD CVS 源代码修订记录邮件列表</link>">
 <!ENTITY a.cvs-src.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cvs-src.url;'>cvs-src</link>">
 
 <!ENTITY a.cvsweb.url "&a.mailman.listinfo;/freebsd-cvsweb">
 <!ENTITY a.cvsweb "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cvsweb.url;'>FreeBSD CVSweb 维护邮件列表</link>">
 <!ENTITY a.cvsweb.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.cvsweb.url;'>freebsd-cvsweb</link>">
 
 <!ENTITY a.database.url "&a.mailman.listinfo;/freebsd-database">
 <!ENTITY a.database "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.database.url;'>在 FreeBSD 上运行的数据库邮件列表</link>">
 <!ENTITY a.database.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.database.url;'>freebsd-database</link>">
 
 <!ENTITY a.desktop.url "&a.mailman.listinfo;/freebsd-desktop">
 <!ENTITY a.desktop "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.desktop.url;'>&os; 桌面方面的使用与改进的邮件列表</link>">
 <!ENTITY a.desktop.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.desktop.url;'>freebsd-desktop</link>">
 
 <!ENTITY a.developers "FreeBSD 开发人员邮件列表">
 <!ENTITY a.developers.name "freebsd-developers">
 
 <!ENTITY a.doc.url "&a.mailman.listinfo;/freebsd-doc">
 <!ENTITY a.doc "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.doc.url;'>FreeBSD 文档计划邮件列表</link>">
 <!ENTITY a.doc.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.doc.url;'>freebsd-doc</link>">
 
 <!ENTITY a.doc-committers "FreeBSD doc/ committer 的邮件列表">
 <!ENTITY a.doc-committers.name "doc-committers">
 
 <!ENTITY a.doc-developers "FreeBSD doc/ 的开发人员邮件列表">
 <!ENTITY a.doc-developers.name "doc-developers">
 
 <!ENTITY a.drivers.url "&a.mailman.listinfo;/freebsd-drivers">
 <!ENTITY a.drivers "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.drivers.url;'>为 FreeBSD 编写设备驱动程序</link>">
 <!ENTITY a.drivers.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.drivers.url;'>freebsd-drivers</link>">
 
 <!ENTITY a.dtrace.url "&a.mailman.listinfo;/freebsd-dtrace">
 <!ENTITY a.dtrace "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dtrace.url;'>Using and working on DTrace in &os;.</link>">
 <!ENTITY a.dtrace.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.dtrace.url;'>freebsd-dtrace</link>">
 
 <!ENTITY a.eclipse.url "&a.mailman.listinfo;/freebsd-eclipse">
 <!ENTITY a.eclipse "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.eclipse.url;'>FreeBSD 上的 Eclipse IDE、 工具、 富客户应用程序和 port 的用户</link>">
 <!ENTITY a.eclipse.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.eclipse.url;'>freebsd-eclipse</link>">
 
 <!ENTITY a.embedded.url "&a.mailman.listinfo;/freebsd-embedded">
 <!ENTITY a.embedded "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.embedded.url;'>FreeBSD-embedded 邮件列表</link>">
 <!ENTITY a.embedded.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.embedded.url;'>freebsd-embedded</link>">
 
 <!ENTITY a.emulation.url "&a.mailman.listinfo;/freebsd-emulation">
 <!ENTITY a.emulation "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.emulation.url;'>FreeBSD-emulation 邮件列表</link>">
 <!ENTITY a.emulation.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.emulation.url;'>freebsd-emulation</link>">
 
 <!ENTITY a.eol.url "&a.mailman.listinfo;/freebsd-eol">
 <!ENTITY a.eol "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.eol.url;'>FreeBSD-eol 邮件列表</link>">
 <!ENTITY a.eol.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.eol.url;'>freebsd-eol</link>">
 
 <!ENTITY a.firewire.url "&a.mailman.listinfo;/freebsd-firewire">
 <!ENTITY a.firewire "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.firewire.url;'>FreeBSD 火线技术 (IEEE 1394) 讨论邮件列表</link>">
 <!ENTITY a.firewire.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.firewire.url;'>freebsd-firewire</link>">
 
 <!ENTITY a.fortran.url "&a.mailman.listinfo;/freebsd-fortran">
 <!ENTITY a.fortran "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.fortran.url;'>Fortran on FreeBSD 邮件列表</link>">
 <!ENTITY a.fortran.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.fortran.url;'>freebsd-fortran</link>">
 
 <!ENTITY a.fs.url "&a.mailman.listinfo;/freebsd-fs">
 <!ENTITY a.fs "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.fs.url;'>FreeBSD 文件系统项目邮件列表</link>">
 <!ENTITY a.fs.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.fs.url;'>freebsd-fs</link>">
 
 <!ENTITY a.gecko.url "&a.mailman.listinfo;/freebsd-gecko">
 <!ENTITY a.gecko "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.gecko.url;'>FreeBSD gecko 邮件列表</link>">
 <!ENTITY a.gecko.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.gecko.url;'>freebsd-gecko</link>">
 
 <!ENTITY a.geom.url "&a.mailman.listinfo;/freebsd-geom">
 <!ENTITY a.geom "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.geom.url;'>FreeBSD GEOM 邮件列表</link>">
 <!ENTITY a.geom.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.geom.url;'>freebsd-geom</link>">
 
 <!ENTITY a.gnome.url "&a.mailman.listinfo;/freebsd-gnome">
 <!ENTITY a.gnome "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.gnome.url;'>FreeBSD GNOME 和 GNOME 应用程序邮件列表</link>">
 <!ENTITY a.gnome.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.gnome.url;'>freebsd-gnome</link>">
 
 <!ENTITY a.hackers.url "&a.mailman.listinfo;/freebsd-hackers">
 <!ENTITY a.hackers "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.hackers.url;'>FreeBSD 技术讨论邮件列表</link>">
 <!ENTITY a.hackers.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.hackers.url;'>freebsd-hackers</link>">
 
 <!ENTITY a.hardware.url "&a.mailman.listinfo;/freebsd-hardware">
 <!ENTITY a.hardware "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.hardware.url;'>FreeBSD 硬件和设备邮件列表</link>">
 <!ENTITY a.hardware.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.hardware.url;'>freebsd-hardware</link>">
 
 <!ENTITY a.hubs.url "&a.mailman.listinfo;/freebsd-hubs">
 <!ENTITY a.hubs "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.hubs.url;'>FreeBSD 镜像站点邮件列表s</link>">
 <!ENTITY a.hubs.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.hubs.url;'>freebsd-hubs</link>">
 
 <!ENTITY a.i18n.url "&a.mailman.listinfo;/freebsd-i18n">
 <!ENTITY a.i18n "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.i18n.url;'>FreeBSD 国际化邮件列表</link>">
 <!ENTITY a.i18n.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.i18n.url;'>freebsd-i18n</link>">
 
 <!ENTITY a.i386.url "&a.mailman.listinfo;/freebsd-i386">
 <!ENTITY a.i386 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.i386.url;'>FreeBSD i386 专有问题邮件列表</link>">
 <!ENTITY a.i386.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.i386.url;'>freebsd-i386</link>">
 
 <!ENTITY a.ia32.url "&a.mailman.listinfo;/freebsd-ia32">
 <!ENTITY a.ia32 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ia32.url;'>FreeBSD IA32 移植邮件列表</link>">
 <!ENTITY a.ia32.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ia32.url;'>freebsd-ia32</link>">
 
 <!ENTITY a.ia64.url "&a.mailman.listinfo;/freebsd-ia64">
 <!ENTITY a.ia64 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ia64.url;'>FreeBSD IA64 移植邮件列表</link>">
 <!ENTITY a.ia64.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ia64.url;'>freebsd-ia64</link>">
 
 <!ENTITY a.infiniband.url "&a.mailman.listinfo;/freebsd-infiniband">
 <!ENTITY a.infiniband "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.infiniband.url;'>Infiniband on FreeBSD</link>">
 <!ENTITY a.infiniband.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.infiniband.url;'>freebsd-infiniband</link>">
 
 <!ENTITY a.ipfw.url "&a.mailman.listinfo;/freebsd-ipfw">
 <!ENTITY a.ipfw "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ipfw.url;'>FreeBSD IPFW 代码邮件列表</link>">
 <!ENTITY a.ipfw.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ipfw.url;'>freebsd-ipfw</link>">
 
 <!ENTITY a.isdn.url "&a.mailman.listinfo;/freebsd-isdn">
 <!ENTITY a.isdn "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.isdn.url;'>FreeBSD ISDN 邮件列表</link>">
 <!ENTITY a.isdn.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.isdn.url;'>freebsd-isdn</link>">
 
 <!ENTITY a.isp.url "&a.mailman.listinfo;/freebsd-isp">
 <!ENTITY a.isp "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.isp.url;'>FreeBSD Internet 服务提供商的邮件列表</link>">
 <!ENTITY a.isp.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.isp.url;'>freebsd-isp</link>">
 
 <!ENTITY a.jail.url "&a.mailman.listinfo;/freebsd-jail">
 <!ENTITY a.jail "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.jail.url;'>FreeBSD jails 邮件列表</link>">
 <!ENTITY a.jail.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.jail.url;'>freebsd-jail</link>">
 
 <!ENTITY a.java.url "&a.mailman.listinfo;/freebsd-java">
 <!ENTITY a.java "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.java.url;'>FreeBSD Java 语言邮件列表</link>">
 <!ENTITY a.java.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.java.url;'>freebsd-java</link>">
 
 <!ENTITY a.jobs.url "&a.mailman.listinfo;/freebsd-jobs">
 <!ENTITY a.jobs "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.jobs.url;'>FreeBSD 相关的工作机会邮件列表</link>">
 <!ENTITY a.jobs.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.jobs.url;'>freebsd-jobs</link>">
 
 <!ENTITY a.kde.url "https://mail.kde.org/mailman/listinfo/kde-freebsd">
 <!ENTITY a.kde "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.kde.url;'>FreeBSD KDE/Qt 和 KDE 应用程序邮件列表</link>">
 <!ENTITY a.kde.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.kde.url;'>freebsd-kde</link>">
 
 <!ENTITY a.lfs.url "&a.mailman.listinfo;/freebsd-lfs">
 <!ENTITY a.lfs "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.lfs.url;'>FreeBSD LFS 移植邮件列表</link>">
 <!ENTITY a.lfs.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.lfs.url;'>freebsd-lfs</link>">
 
 <!ENTITY a.mips.url "&a.mailman.listinfo;/freebsd-mips">
 <!ENTITY a.mips "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.mips.url;'>FreeBSD MIPS 移植邮件列表</link>">
 <!ENTITY a.mips.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.mips.url;'>freebsd-mips</link>">
 
 <!ENTITY a.mirror-announce.url "&a.mailman.listinfo;/mirror-announce">
 <!ENTITY a.mirror-announce "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.mirror-announce.url;'>FreeBSD 镜像站点管理员</link>">
 <!ENTITY a.mirror-announce.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.mirror-announce.url;'>mirror-announce</link>">
 
 <!ENTITY a.mobile.url "&a.mailman.listinfo;/freebsd-mobile">
 <!ENTITY a.mobile "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.mobile.url;'>FreeBSD 笔记本电脑邮件列表</link>">
 <!ENTITY a.mobile.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.mobile.url;'>freebsd-mobile</link>">
 
 <!ENTITY a.mono.url "&a.mailman.listinfo;/freebsd-mono">
 <!ENTITY a.mono "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.mono.url;'>FreeBSD 上的 Mono 和 C# 应用</link>">
 <!ENTITY a.mono.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.mono.url;'>freebsd-mono</link>">
 
 <!ENTITY a.multimedia.url "&a.mailman.listinfo;/freebsd-multimedia">
 <!ENTITY a.multimedia "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.multimedia.url;'>FreeBSD 多媒体应用邮件列表</link>">
 <!ENTITY a.multimedia.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.multimedia.url;'>freebsd-multimedia</link>">
 
 <!ENTITY a.net.url "&a.mailman.listinfo;/freebsd-net">
 <!ENTITY a.net "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.net.url;'>FreeBSD 网络邮件列表</link>">
 <!ENTITY a.net.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.net.url;'>freebsd-net</link>">
 
 <!ENTITY a.newbies.url "&a.mailman.listinfo;/freebsd-newbies">
 <!ENTITY a.newbies "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.newbies.url;'>FreeBSD 新手上路邮件列表</link>">
 <!ENTITY a.newbies.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.newbies.url;'>freebsd-newbies</link>">
 
 <!ENTITY a.newbus.url "&a.mailman.listinfo;/freebsd-new-bus">
 <!ENTITY a.newbus "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.newbus.url;'>FreeBSD new-bus 邮件列表</link>">
 <!ENTITY a.newbus.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.newbus.url;'>freebsd-new-bus</link>">
 
 <!ENTITY a.numerics.url "&a.mailman.listinfo;/freebsd-numerics">
 <!ENTITY a.numerics "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.numerics.url;'>Discussions of high quality implementation of libm functions</link>">
 <!ENTITY a.numerics.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.numerics.url;'>freebsd-numerics</link>">
 
 <!ENTITY a.office.url "&a.mailman.listinfo;/freebsd-office">
 <!ENTITY a.office "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.office.url;'>FreeBSD 办公套件应用 邮件列表</link>">
 <!ENTITY a.office.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.office.url;'>freebsd-office</link>">
 
 <!ENTITY a.ops-announce.url "&a.mailman.listinfo;/freebsd-ops-announce">
 <!ENTITY a.ops-announce "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ops-announce.url;'>Project Infrastructure Announcements</link>">
 <!ENTITY a.ops-announce.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ops-announce.url;'>freebsd-ops-announce</link>">
 
 <!ENTITY a.performance.url "&a.mailman.listinfo;/freebsd-performance">
 <!ENTITY a.performance "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.performance.url;'>FreeBSD 性能邮件列表</link>">
 <!ENTITY a.performance.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.performance.url;'>freebsd-performance</link>">
 
 <!ENTITY a.perl.url "&a.mailman.listinfo;/freebsd-perl">
 <!ENTITY a.perl "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.perl.url;'>FreeBSD Perl 邮件列表</link>">
 <!ENTITY a.perl.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.perl.url;'>freebsd-perl</link>">
 
 <!ENTITY a.pf.url "&a.mailman.listinfo;/freebsd-pf">
 <!ENTITY a.pf "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.pf.url;'>FreeBSD packet filter 邮件列表</link>">
 <!ENTITY a.pf.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.pf.url;'>freebsd-pf</link>">
 
 <!ENTITY a.pkg.url "&a.mailman.listinfo;/freebsd-pkg">
 <!ENTITY a.pkg "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.pkg.url;'>二进制包管理和打包工具的邮件列表</link>">
 <!ENTITY a.pkg.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.pkg.url;'>freebsd-pkg</link>">
 
 <!ENTITY a.pkg-fallout.url "&a.mailman.listinfo;/freebsd-pkg-fallout">
 <!ENTITY a.pkg-fallout "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.pkg-fallout.url;'>Fallout logs from package building</link>">
 <!ENTITY a.pkg-fallout.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.pkg-fallout.url;'>freebsd-pkg-fallout</link>">
 
 <!ENTITY a.platforms.url "&a.mailman.listinfo;/freebsd-platforms">
 <!ENTITY a.platforms "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.platforms.url;'>FreeBSD 非 Intel 平台移植邮件列表</link>">
 <!ENTITY a.platforms.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.platforms.url;'>freebsd-platforms</link>">
 
 <!ENTITY a.ports.url "&a.mailman.listinfo;/freebsd-ports">
 <!ENTITY a.ports "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ports.url;'>FreeBSD ports 邮件列表</link>">
 <!ENTITY a.ports.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ports.url;'>freebsd-ports</link>">
 
 <!ENTITY a.ports-announce.url "&a.mailman.listinfo;/freebsd-ports-announce">
 <!ENTITY a.ports-announce "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ports-announce.url;'>FreeBSD ports 公告的邮件列表</link>">
 <!ENTITY a.ports-announce.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ports-announce.url;'>freebsd-ports-announce</link>">
 
 <!ENTITY a.ports-bugs.url "&a.mailman.listinfo;/freebsd-ports-bugs">
 <!ENTITY a.ports-bugs "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ports-bugs.url;'>FreeBSD ports bugs 邮件列表</link>">
 <!ENTITY a.ports-bugs.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ports-bugs.url;'>freebsd-ports-bugs</link>">
 
 <!ENTITY a.ports-committers "FreeBSD ports/ committer 的邮件列表">
 <!ENTITY a.ports-committers.name "ports-committers">
 
 <!ENTITY a.ports-developers "FreeBSD ports/ 开发人员邮件列表">
 <!ENTITY a.ports-developers.name "ports-developers">
 
 <!ENTITY a.ppc.url "&a.mailman.listinfo;/freebsd-ppc">
 <!ENTITY a.ppc "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ppc.url;'>FreeBSD PowerPC 移植邮件列表</link>">
 <!ENTITY a.ppc.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ppc.url;'>freebsd-ppc</link>">
 
 <!ENTITY a.proliant.url "&a.mailman.listinfo;/freebsd-proliant">
 <!ENTITY a.proliant "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.proliant.url;'>在 HP ProLiant 服务器平台上的 FreeBSD 技术讨论</link>">
 <!ENTITY a.proliant.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.proliant.url;'>freebsd-proliant</link>">
 
 <!ENTITY a.python.url "&a.mailman.listinfo;/freebsd-python">
 <!ENTITY a.python "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.python.url;'>FreeBSD Python 邮件列表</link>">
 <!ENTITY a.python.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.python.url;'>freebsd-python</link>">
 
 <!ENTITY a.questions.url "&a.mailman.listinfo;/freebsd-questions">
 <!ENTITY a.questions "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.questions.url;'>FreeBSD 一般问题邮件列表</link>">
 <!ENTITY a.questions.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.questions.url;'>freebsd-questions</link>">
 
 <!ENTITY a.rc.url "&a.mailman.listinfo;/freebsd-rc">
 <!ENTITY a.rc "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.rc.url;'>FreeBSD 启动脚本系统邮件列表</link>">
 <!ENTITY a.rc.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.rc.url;'>freebsd-rc</link>">
 
 <!ENTITY a.realtime.url "&a.mailman.listinfo;/freebsd-realtime">
 <!ENTITY a.realtime "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.realtime.url;'>FreeBSD 实时扩展邮件列表</link>">
 <!ENTITY a.realtime.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.realtime.url;'>freebsd-realtime</link>">
 
 <!ENTITY a.ruby.url "&a.mailman.listinfo;/freebsd-ruby">
 <!ENTITY a.ruby "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ruby.url;'>FreeBSD Ruby 邮件列表</link>">
 <!ENTITY a.ruby.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.ruby.url;'>freebsd-ruby</link>">
 
 <!ENTITY a.scsi.url "&a.mailman.listinfo;/freebsd-scsi">
 <!ENTITY a.scsi "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.scsi.url;'>FreeBSD SCSI 子系统邮件列表</link>">
 <!ENTITY a.scsi.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.scsi.url;'>freebsd-scsi</link>">
 
 <!ENTITY a.security.url "&a.mailman.listinfo;/freebsd-security">
 <!ENTITY a.security "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.security.url;'>FreeBSD 安全问题邮件列表</link>">
 <!ENTITY a.security.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.security.url;'>freebsd-security</link>">
 
 <!ENTITY a.security-notifications.url "&a.mailman.listinfo;/freebsd-security-notifications">
 <!ENTITY a.security-notifications "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.security-notifications.url;'>FreeBSD 安全问题通知邮件列表</link>">
 <!ENTITY a.security-notifications.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.security-notifications.url;'>freebsd-security-notifications</link>">
 
 <!ENTITY a.small.url "&a.mailman.listinfo;/freebsd-small">
 <!ENTITY a.small "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.small.url;'>FreeBSD-small 邮件列表</link>">
 <!ENTITY a.small.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.small.url;'>freebsd-small</link>">
 
 <!ENTITY a.snapshots.url "&a.mailman.listinfo;/freebsd-snapshots">
 <!ENTITY a.snapshots "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.snapshots.url;'>FreeBSD 的开发快照公告</link>">
 <!ENTITY a.snapshots.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.snapshots.url;'>freebsd-snapshots</link>">
 
 <!ENTITY a.sparc.url "&a.mailman.listinfo;/freebsd-sparc64">
 <!ENTITY a.sparc "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.sparc.url;'>FreeBSD SPARC 移植邮件列表</link>">
 <!ENTITY a.sparc.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.sparc.url;'>freebsd-sparc64</link>">
 
 <!ENTITY a.src-committers "FreeBSD src/ committer 的邮件列表">
 <!ENTITY a.src-committers.name "freebsd-src-committers">
 
 <!ENTITY a.src-developers "FreeBSD src/ 开发人员邮件列表">
 <!ENTITY a.src-developers.name "freebsd-src-developers">
 
 <!ENTITY a.stable.url "&a.mailman.listinfo;/freebsd-stable">
 <!ENTITY a.stable "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.stable.url;'>&os.stable; 邮件列表</link>">
 <!ENTITY a.stable.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.stable.url;'>freebsd-stable</link>">
 
 <!ENTITY a.standards.url "&a.mailman.listinfo;/freebsd-standards">
 <!ENTITY a.standards "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.standards.url;'>FreeBSD C99 和 POSIX 标准相容性邮件列表</link>">
 <!ENTITY a.standards.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.standards.url;'>freebsd-standards</link>">
 
 <!ENTITY a.sun4v.url "&a.mailman.listinfo;/freebsd-sun4v">
 <!ENTITY a.sun4v "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.sun4v.url;'>FreeBSD sun4v 移植邮件列表</link>">
 <!ENTITY a.sun4v.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.sun4v.url;'>freebsd-sun4v</link>">
 
 
 
 <!ENTITY a.svn-doc-all.url "&a.mailman.listinfo;/svn-doc-all">
 <!ENTITY a.svn-doc-all "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-doc-all.url;'>SVN commit messages for the entire doc tree (except for <quote>    user</quote>, <quote>projects</quote> and <quote>translations</quote>)</link>">
 <!ENTITY a.svn-doc-all.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-doc-all.url;'>svn-doc-all</link>">
 
 <!ENTITY a.svn-doc-head.url "&a.mailman.listinfo;/svn-doc-head">
 <!ENTITY a.svn-doc-head "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-doc-head.url;'>SVN commit messages for the doc tree for head/</link>">
 <!ENTITY a.svn-doc-head.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-doc-head.url;'>svn-doc-head</link>">
 
 <!ENTITY a.svn-doc-projects.url "&a.mailman.listinfo;/svn-doc-projects">
 <!ENTITY a.svn-doc-projects "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-doc-projects.url;'>SVN commit messages for the doc <quote>projects</quote> tree</link>">
 <!ENTITY a.svn-doc-projects.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-doc-projects.url;'>svn-doc-projects</link>">
 
 <!ENTITY a.svn-doc-svnadmin.url "&a.mailman.listinfo;/svn-doc-svnadmin">
 <!ENTITY a.svn-doc-svnadmin "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-doc-svnadmin.url;'>SVN commit messages for the doc admin&nbsp;/ configuration tree</link>">
 <!ENTITY a.svn-doc-svnadmin.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-doc-svnadmin.url;'>svn-doc-svnadmin</link>">
 
 <!ENTITY a.svn-ports-all.url "&a.mailman.listinfo;/svn-ports-all">
 <!ENTITY a.svn-ports-all "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-ports-all.url;'>SVN commit messages for the entire ports tree</link>">
 <!ENTITY a.svn-ports-all.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-ports-all.url;'>svn-ports-all</link>">
 
 <!ENTITY a.svn-ports-head.url "&a.mailman.listinfo;/svn-ports-head">
 <!ENTITY a.svn-ports-head "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-ports-head.url;'>SVN commit messages for the ports tree for head/</link>">
 <!ENTITY a.svn-ports-head.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-ports-head.url;'>svn-ports-head</link>">
 
 <!ENTITY a.svn-ports-svnadmin.url "&a.mailman.listinfo;/svn-ports-svnadmin">
 <!ENTITY a.svn-ports-svnadmin "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-ports-svnadmin.url;'>SVN commit messages for the ports admin&nbsp;/ configuration tree</link>">
 <!ENTITY a.svn-ports-svnadmin.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-ports-svnadmin.url;'>svn-ports-svnadmin</link>">
 
 <!ENTITY a.svn-src-all.url "&a.mailman.listinfo;/svn-src-all">
 <!ENTITY a.svn-src-all "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-all.url;'>SVN 整个 src 树的修订讯息 (除了 <quote>user</quote> 与 <quote>projects</quote>)</link>">
 <!ENTITY a.svn-src-all.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-all.url;'>svn-src-all</link>">
 
 <!ENTITY a.svn-src-head.url "&a.mailman.listinfo;/svn-src-head">
 <!ENTITY a.svn-src-head "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-head.url;'>SVN src 树 head/-current 分支的修订讯息</link>">
 <!ENTITY a.svn-src-head.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-head.url;'>svn-src-head</link>">
 
 <!ENTITY a.svn-src-projects.url "&a.mailman.listinfo;/svn-src-projects">
 <!ENTITY a.svn-src-projects "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-projects.url;'>SVN src 树 <quote>projects</quote> 分支的修订讯息</link>">
 <!ENTITY a.svn-src-projects.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-projects.url;'>svn-src-projects</link>">
 
 <!ENTITY a.svn-src-release.url "&a.mailman.listinfo;/svn-src-release">
 <!ENTITY a.svn-src-release "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-release.url;'>SVN src 树各种 releases 分支的修订讯息</link>">
 <!ENTITY a.svn-src-release.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-release.url;'>svn-src-release</link>">
 
 <!ENTITY a.svn-src-releng.url "&a.mailman.listinfo;/svn-src-releng">
 <!ENTITY a.svn-src-releng "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-releng.url;'>SVN src 树 release 工程&nbsp;/ 安全有关的修订讯息</link>">
 <!ENTITY a.svn-src-releng.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-releng.url;'>svn-src-releng</link>">
 
 <!ENTITY a.svn-src-stable.url "&a.mailman.listinfo;/svn-src-stable">
 <!ENTITY a.svn-src-stable "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable.url;'>SVN src 树所有 -stable 分支的修订讯息</link>">
 <!ENTITY a.svn-src-stable.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable.url;'>svn-src-stable</link>">
 
 <!ENTITY a.svn-src-stable-6.url "&a.mailman.listinfo;/svn-src-stable-6">
 <!ENTITY a.svn-src-stable-6 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable-6.url;'>SVN src 树 6-stable 分支的修订讯息</link>">
 <!ENTITY a.svn-src-stable-6.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable-6.url;'>svn-src-stable-6</link>">
 
 <!ENTITY a.svn-src-stable-7.url "&a.mailman.listinfo;/svn-src-stable-7">
 <!ENTITY a.svn-src-stable-7 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable-7.url;'>SVN src 树 7-stable 分支的修订讯息</link>">
 <!ENTITY a.svn-src-stable-7.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable-7.url;'>svn-src-stable-7</link>">
 
 <!ENTITY a.svn-src-stable-8.url "&a.mailman.listinfo;/svn-src-stable-8">
 <!ENTITY a.svn-src-stable-8 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable-8.url;'>SVN src 树 8-stable 分支的修订讯息</link>">
 <!ENTITY a.svn-src-stable-8.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable-8.url;'>svn-src-stable-8</link>">
 
 <!ENTITY a.svn-src-stable-9.url "&a.mailman.listinfo;/svn-src-stable-9">
 <!ENTITY a.svn-src-stable-9 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable-9.url;'>SVN commit messages for only the 9-stable src tree</link>">
 <!ENTITY a.svn-src-stable-9.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable-9.url;'>svn-src-stable-9</link>">
 
 <!ENTITY a.svn-src-stable-10.url "&a.mailman.listinfo;/svn-src-stable-10">
 <!ENTITY a.svn-src-stable-10 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable-10.url;'>SVN commit messages for only the 10-stable src tree</link>">
 <!ENTITY a.svn-src-stable-10.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable-10.url;'>svn-src-stable-10</link>">
 
 <!ENTITY a.svn-src-stable-other.url "&a.mailman.listinfo;/svn-src-stable-other">
 <!ENTITY a.svn-src-stable-other "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable-other.url;'>SVN src 树以往 stable 分支的修订讯息</link>">
 <!ENTITY a.svn-src-stable-other.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-stable-other.url;'>svn-src-stable-other</link>">
 
 <!ENTITY a.svn-src-svnadmin.url "&a.mailman.listinfo;/svn-src-svnadmin">
 <!ENTITY a.svn-src-svnadmin "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-svnadmin.url;'>SVN 有关管理&nbsp;/ 配置的修订讯息</link>">
 <!ENTITY a.svn-src-svnadmin.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-svnadmin.url;'>svn-src-svnadmin</link>">
 
 <!ENTITY a.svn-src-user.url "&a.mailman.listinfo;/svn-src-user">
 <!ENTITY a.svn-src-user "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-user.url;'>SVN src 树 <quote>user</quote> 试验性分支的修订讯息</link>">
 <!ENTITY a.svn-src-user.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-user.url;'>svn-src-user</link>">
 
 <!ENTITY a.svn-src-vendor.url "&a.mailman.listinfo;/svn-src-vendor">
 <!ENTITY a.svn-src-vendor "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-vendor.url;'>SVN vendor 类相关工作树的修订讯息</link>">
 <!ENTITY a.svn-src-vendor.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.svn-src-vendor.url;'>svn-src-vendor</link>">
 
 <!ENTITY a.sysinstall.url "&a.mailman.listinfo;/freebsd-sysinstall">
 <!ENTITY a.sysinstall "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.sysinstall.url;'>Sysinstall 开发邮件列表</link>">
 <!ENTITY a.sysinstall.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.sysinstall.url;'>freebsd-sysinstall</link>">
 
 <!ENTITY a.tcltk.url "&a.mailman.listinfo;/freebsd-tcltk">
 <!ENTITY a.tcltk "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.tcltk.url;'>FreeBSD-specific Tcl/Tk discussions</link>">
 <!ENTITY a.tcltk.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.tcltk.url;'>freebsd-tcltk</link>">
 
 <!ENTITY a.test.url "&a.mailman.listinfo;/freebsd-test">
 <!ENTITY a.test "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.test.url;'>FreeBSD 测试邮件列表</link>">
 <!ENTITY a.test.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.test.url;'>freebsd-test</link>">
 
 <!ENTITY a.testing.url "&a.mailman.listinfo;/freebsd-testing">
 <!ENTITY a.testing "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.testing.url;'>FreeBSD 性能和稳定性测试邮件列表</link>">
 <!ENTITY a.testing.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.testing.url;'>freebsd-testing</link>">
 
 <!ENTITY a.tex.url "&a.mailman.listinfo;/freebsd-tex">
 <!ENTITY a.tex "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.tex.url;'>Porting TeX and its applications to &os;</link>">
 <!ENTITY a.tex.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.tex.url;'>freebsd-tex</link>">
 
 <!ENTITY a.threads.url "&a.mailman.listinfo;/freebsd-threads">
 <!ENTITY a.threads "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.threads.url;'>FreeBSD 线程邮件列表</link>">
 <!ENTITY a.threads.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.threads.url;'>freebsd-threads</link>">
 
 <!ENTITY a.tilera.url "&a.mailman.listinfo;/freebsd-tilera">
 <!ENTITY a.tilera "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.tilera.url;'>FreeBSD Tilera CPU 移植邮件列表</link>">
 <!ENTITY a.tilera.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.tilera.url;'>freebsd-tilera</link>">
 
 <!ENTITY a.tokenring.url "&a.mailman.listinfo;/freebsd-tokenring">
 <!ENTITY a.tokenring "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.tokenring.url;'>FreeBSD 令牌环邮件列表</link>">
 <!ENTITY a.tokenring.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.tokenring.url;'>freebsd-tokenring</link>">
 
 <!ENTITY a.toolchain.url "&a.mailman.listinfo;/freebsd-toolchain">
 <!ENTITY a.toolchain "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.toolchain.url;'>FreeBSD 集成的联编工具集邮件列表</link>">
 <!ENTITY a.toolchain.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.toolchain.url;'>freebsd-toolchain</link>">
 
 <!ENTITY a.usb.url "&a.mailman.listinfo;/freebsd-usb">
 <!ENTITY a.usb "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.usb.url;'>FreeBSD USB 邮件列表</link>">
 <!ENTITY a.usb.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.usb.url;'>freebsd-usb</link>">
 
 <!ENTITY a.usergroups.url "&a.mailman.listinfo;/freebsd-user-groups">
 <!ENTITY a.usergroups "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.usergroups.url;'>FreeBSD 用户组召集邮件列表</link>">
 <!ENTITY a.usergroups.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.usergroups.url;'>freebsd-user-groups</link>">
 
 <!ENTITY a.vendors.url "&a.mailman.listinfo;/freebsd-vendors">
 <!ENTITY a.vendors "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.vendors.url;'>FreeBSD 发布前供应商召集邮件列表</link>">
 <!ENTITY a.vendors.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.vendors.url;'>freebsd-vendors</link>">
 
 <!ENTITY a.virtualization.url "&a.mailman.listinfo;/freebsd-virtualization">
 <!ENTITY a.virtualization "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.virtualization.url;'>关于 FreeBSD 所支持的各种虚拟化技术的讨论</link>">
 <!ENTITY a.virtualization.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.virtualization.url;'>freebsd-virtualization</link>">
 
 <!ENTITY a.vuxml.url "&a.mailman.listinfo;/freebsd-vuxml">
 <!ENTITY a.vuxml "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.vuxml.url;'>关于 VuXML 的讨论</link>">
 <!ENTITY a.vuxml.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.vuxml.url;'>freebsd-vuxml</link>">
 
 <!ENTITY a.wip-status.url "&a.mailman.listinfo;/freebsd-wip-status">
 <!ENTITY a.wip-status "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.wip-status.url;'>FreeBSD 项目进展状态</link>">
 <!ENTITY a.wip-status.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.wip-status.url;'>freebsd-wip-status</link>">
 
 <!ENTITY a.wireless.url "&a.mailman.listinfo;/freebsd-wireless">
 <!ENTITY a.wireless "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.wireless.url;'>关于 802.11 栈， 工具、 驱动开发的讨论</link>">
 <!ENTITY a.wireless.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.wireless.url;'>freebsd-wireless</link>">
 
 <!ENTITY a.www.url "&a.mailman.listinfo;/freebsd-www">
 <!ENTITY a.www "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.www.url;'>FreeBSD Webmaster 邮件列表</link>">
 <!ENTITY a.www.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.www.url;'>freebsd-www</link>">
 
 <!ENTITY a.x11.url "&a.mailman.listinfo;/freebsd-x11">
 <!ENTITY a.x11 "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.x11.url;'>FreeBSD X11 邮件列表</link>">
 <!ENTITY a.x11.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.x11.url;'>freebsd-x11</link>">
 
 <!ENTITY a.xen.url "&a.mailman.listinfo;/freebsd-xen">
 <!ENTITY a.xen "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.xen.url;'>FreeBSD 有关 Xen 移植的邮件列表</link>">
 <!ENTITY a.xen.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.xen.url;'>freebsd-xen</link>">
 
 <!ENTITY a.xfce.url "&a.mailman.listinfo;/freebsd-xfce">
 <!ENTITY a.xfce "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.xfce.url;'>FreeBSD 有关 XFCE 的邮件列表</link>">
 <!ENTITY a.xfce.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.xfce.url;'>freebsd-xfce</link>">
 
 <!ENTITY a.zope.url "&a.mailman.listinfo;/freebsd-zope">
 <!ENTITY a.zope "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.zope.url;'>Zope for FreeBSD mailing list</link>">
 <!ENTITY a.zope.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.zope.url;'>freebsd-zope</link>">
 
 <!-- Not really proper mailing lists -->
 
 <!ENTITY a.bugfollowup "<email xmlns='http://docbook.org/ns/docbook'>bug-followup@FreeBSD.org</email>">
 <!ENTITY a.bugsubmit "&a.bugfollowup;">
 
 <!ENTITY a.majordomo "<email xmlns='http://docbook.org/ns/docbook'>majordomo@FreeBSD.org</email>">
 
 <!--
      The following mailinglists are deactivated.  Keep them until all references
      in the documentation are gone.
 -->
 
 <!ENTITY a.alpha.url "&a.mailman.listinfo;/freebsd-alpha">
 <!ENTITY a.alpha "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.alpha.url;'>FreeBSD Alpha 移植邮件列表</link>">
 <!ENTITY a.alpha.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.alpha.url;'>freebsd-alpha</link>">
 
 <!ENTITY a.qa.url "&a.mailman.listinfo;/freebsd-qa">
 <!ENTITY a.qa "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.qa.url;'>FreeBSD 质量保障邮件列表</link>">
 <!ENTITY a.qa.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.qa.url;'>freebsd-qa</link>">
 
 <!ENTITY a.smp.url "&a.mailman.listinfo;/freebsd-smp">
 <!ENTITY a.smp "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.smp.url;'>FreeBSD 对称多处理 (SMP) 邮件列表</link>">
 <!ENTITY a.smp.name "<link xmlns='http://docbook.org/ns/docbook' xlink:href='&a.smp.url;'>freebsd-smp</link>">
diff --git a/zh_CN.UTF-8/share/xml/mirrors-local.xsl b/zh_CN.UTF-8/share/xml/mirrors-local.xsl
index 5240fc20bd..796182eae1 100644
--- a/zh_CN.UTF-8/share/xml/mirrors-local.xsl
+++ b/zh_CN.UTF-8/share/xml/mirrors-local.xsl
@@ -1,29 +1,29 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- Original Revision: r41645 -->
+<!-- Original Revision: 48c0df24d2 (r41645) -->
 <!-- $FreeBSD$ -->
 
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
 
   <!-- must point to master copy, doc/share/xml/mirrors-master.xsl -->
   <xsl:import href="../../../share/xml/mirrors-master.xsl" />
 
   <xsl:output type="xml" encoding="utf-8"
 	      indent="yes"/>
 
   <!-- template: "mirrors-docbook-contact" -->
 
   <xsl:template name="mirrors-docbook-contact">
     <xsl:param name="email" value="'someone@somewhere'"/>
 
     <para>如有问题， 请和负责相关子域服务器的管理员
         <email><xsl:value-of select="$email" /></email> 联系。</para>
   </xsl:template>
 
   <!-- template: "mirrors-lastmodified" -->
 
   <xsl:template name="mirrors-lastmodified">
     <xsl:call-template name="mirrors-lastmodified-utc" />
     <xsl:text> 更新</xsl:text>
   </xsl:template>
 
 </xsl:stylesheet>
diff --git a/zh_CN.UTF-8/share/xml/navibar.l10n.ent b/zh_CN.UTF-8/share/xml/navibar.l10n.ent
index b135662aff..d68a31fe2b 100644
--- a/zh_CN.UTF-8/share/xml/navibar.l10n.ent
+++ b/zh_CN.UTF-8/share/xml/navibar.l10n.ent
@@ -1,232 +1,232 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $FreeBSD$ -->
 
 <!-- The FreeBSD Simplified Chinese Documentation Project -->
-<!-- Original Revision: r54642 -->
+<!-- Original Revision: bfea49dccc (r54642) -->
 
 <!ENTITY nav.about '
 <div xmlns="http://www.w3.org/1999/xhtml" id="sidenav">
   <h2 class="blockhide">Section Navigation</h2>
 
   <ul>
     <li><a href="&base;/about.html">关于</a></li>
     <li><a href="&base;/features.html">特性</a></li>
     <li><a href="&base;/applications.html">应用程序</a></li>
     <li><a href="&base;/advocacy/">促进项目</a></li>
     <li><a href="&enbase;/marketing/">市场</a></li>
     <li><a href="&enbase;/administration.html">管理团队</a></li>
     <li><a href="&base;/news/newsflash.html">新闻</a></li>
     <li><a href="&enbase;/events/events.html">近期活动</a></li>
     <li><a href="&base;/news/press.html">媒体报道</a></li>
     <li><a href="&enbase;/multimedia/multimedia.html">多媒体</a></li>
     <li><a href="&base;/art.html">插图</a></li>
     <li><a href="&base;/logo.html">标志</a></li>
     <li><a href="&enbase;/donations/">捐赠</a></li>
     <li><a href="&base;/copyright/">法律须知</a></li>
     <li><a href="&enbase;/privacy.html">隐私政策</a></li>
   </ul>
 </div> <!-- SIDENAV -->'>
 
 <!ENTITY nav.community '
 <div xmlns="http://www.w3.org/1999/xhtml" id="sidenav">
   <h2 class="blockhide">Section Navigation</h2>
 
   <ul>
     <li><a href="&base;/community.html">社区</a></li>
     <li><a href="&enbase;/community/mailinglists.html">邮件列表</a></li>
     <li><a href="https://forums.FreeBSD.org/">论坛</a></li>
     <li><a href="&enbase;/community/irc.html">IRC</a></li>
     <li><a href="&enbase;/doc/en_US.ISO8859-1/books/handbook/eresources-news.html">新闻组</a></li>
     <li><a href="&enbase;/usergroups.html">用户组</a></li>
     <li><a href="&enbase;/events/events.html">近期活动</a></li>
     <li><a href="&enbase;/community/webresources.html">Web 资源</a></li>
     <li><a href="http://serverfault.com/questions/tagged/freebsd">常见问题解答（外部链接）</a></li>
   </ul>
 </div> <!-- SIDENAV -->'>
 
 <!ENTITY nav.developers '
 <div xmlns="http://www.w3.org/1999/xhtml" id="sidenav">
   <h2 class="blockhide">Section Navigation</h2>
 
   <ul>
     <li><a href="&base;/projects/index.html">开发者</a></li>
     <li><a href="&base;/doc/en_US.ISO8859-1/books/developers-handbook">开发者手册</a></li>
     <li><a href="&base;/doc/en_US.ISO8859-1/books/porters-handbook">Porter 手册</a></li>
     <li><a href="&base;/developers/cvs.html">Source code repositories</a></li>
     <li><a href="&base;/releng/index.html">发布工程</a></li>
     <li><a href="&base;/platforms/">平台</a></li>
     <li><a href="https://wiki.FreeBSD.org/IdeasPage">项目新点子</a></li>
     <li><a href="&base;/doc/en_US.ISO8859-1/articles/contributing/index.html">贡献</a></li>
   </ul>
 </div> <!-- SIDENAV -->'>
 
 <!ENTITY nav.docs '
 <div xmlns="http://www.w3.org/1999/xhtml" id="sidenav">
   <h2 class="blockhide">Section Navigation</h2>
 
   <ul>
     <li><a href="&base;/docs.html">文档</a></li>
     <li><a href="&enbase;/doc/en_US.ISO8859-1/books/faq/">常见问题解答</a></li>
     <li><a href="&enbase;/doc/en_US.ISO8859-1/books/handbook/">使用手册</a></li>
     <li><a href="&cgibase;/man.cgi">Man 手册</a></li>
     <li><a href="https://papers.FreeBSD.org">演示和论文</a></li>
     <li><a href="&enbase;/docs/books.html">在线图书和文章</a></li>
     <li><a href="&enbase;/publish.html">出版物</a></li>
     <li><a href="&enbase;/docs/webresources.html">Web 资源</a></li>
     <li><a href="&enbase;/projects/newbies.html">新手上路</a></li>
     <li><a href="&enbase;/docproj/">文档计划</a></li>
     <li><a href="https://docs.freebsd.org/doc/">已归档的文档</a></li>
   </ul>
 </div> <!-- SIDENAV -->'>
 
 <![ %beta.upcoming; [
 <!ENTITY beta.listitem '
   <li xmlns="http://www.w3.org/1999/xhtml">即将发布:<br /><a href="&u.betarel.schedule;">&betarel.current;</a></li>
 '>
 ]]>
 <!ENTITY beta.listitem ''>
 
 <![ %beta2.upcoming; [
 <!ENTITY beta2.listitem '
   <li xmlns="http://www.w3.org/1999/xhtml">即将发布:<br /><a href="&u.betarel2.schedule;">&betarel2.current;</a></li>
 '>
 ]]>
 <!ENTITY beta2.listitem ''>
 
 <!ENTITY nav.download '
 <div xmlns="http://www.w3.org/1999/xhtml" id="sidenav">
   <h2 class="blockhide">Section Navigation</h2>
   <ul>
     <li><a href="&base;/where.html">获取 FreeBSD</a></li>
     <li><a href="&base;/releases/">发行版信息</a>
       <ul>
 	<li>生产适用版本: <br />
 	  <a href="&u.rel122.announce;">&rel122.current;</a></li>
 	<li>生产适用版本: <br />
 	  <a href="&u.rel121.announce;">&rel121.current;</a></li>
 	<li>生产适用版本: <br />
 	  <a href="&u.rel114.announce;">&rel114.current;</a></li>
       </ul>
     </li>
     <li><a href="&enbase;/snapshots/">快照版本</a>
       <ul>
 	&beta.listitem;
 	&beta2.listitem;
       </ul>
     </li>
     <li><a href="&enbase;/ports/">移植的应用程序 (ports)</a></li>
   </ul>
 </div> <!-- SIDENAV -->'>
 
 <!ENTITY nav.gnome '
 <div xmlns="http://www.w3.org/1999/xhtml" id="sidenav">
   <h2 class="blockhide">Section Navigation</h2>
 
   <ul>
     <li><a href="&enbase;/gnome/index.html">GNOME</a>
       <ul>
         <li><a href="&enbase;/gnome/docs/faq2.html#q1">安装说明</a></li>
         <li><a href="&enbase;/gnome/docs/faq232.html#q2">升级说明</a></li>
         <li><a href="&enbase;/gnome/../ports/gnome.html">可用的程序</a></li>
         <li><a href="&enbase;/gnome/docs/volunteer.html">如何参与贡献</a></li>
         <li><a href="&enbase;/gnome/docs/bugging.html">Bug 报告</a></li>
         <li><a href="&enbase;/gnome/screenshots.html">截图</a></li>
         <li><a href="&enbase;/gnome/contact.html">联系我们</a></li>
       </ul></li>
     <li><a href="&enbase;/gnome/index.html">文档</a>
       <ul>
         <li><a href="&enbase;/gnome/docs/faq2.html">常见问题解答</a></li>
 	<li><a href="&enbase;/gnome/docs/halfaq.html">HAL 常见问题解答</a></li>
         <li><a href="&enbase;/gnome/docs/faq232.html">从 2.30 升级到 2.32 的常见问题解答</a></li>
         <li><a href="&enbase;/gnome/docs/develfaq.html">开发分支的常见问题解答</a></li>
         <li><a href="&enbase;/gnome/docs/porting.html">创建 ports</a></li>
         <li><a href="&enbase;/gnome/docs/faq232.html#q4">已知问题</a></li>
       </ul></li>
     </ul>
 </div> <!-- SIDENAV -->'>
 
 <!ENTITY nav.ports '
 <div xmlns="http://www.w3.org/1999/xhtml" id="sidenav">
   <h2 class="blockhide">Section Navigation</h2>
   <ul>
     <li><a href="&enbase;/ports/index.html">关于 ports</a></li>
     <li><a href="&enbase;/ports/installing.html">安装</a></li>
     <li><a href="&enbase;/ports/updating.html">更新</a></li>
     <li><a href="&enbase;/ports/searching.html">搜索</a></li>
     <li>&nbsp;&nbsp;&nbsp;目录
       <ul>
         <li><a href="&enbase;/ports/categories-alpha.html"></a>按字母序</li>
         <li><a href="&enbase;/ports/categories-grouped.html">按逻辑分类序</a></li>
       </ul></li>
     <li><a href="&enbase;/ports/master-index.html">所有 ports 列表</a></li>
     <li><a href="&enbase;/ports/references.html">更多信息</a></li>
   </ul>
 </div> <!-- SIDENAV -->'>
 
 <!ENTITY nav.support '
 <div xmlns="http://www.w3.org/1999/xhtml" id="sidenav">
   <h2 class="blockhide">Section Navigation</h2>
 
   <ul>
     <li><a href="&base;/support.html">支持</a></li>
     <li><a href="&enbase;/commercial/">商业产品</a>
     <ul>
       <li><a href="&enbase;/commercial/software_bycat.html">软件</a></li>
       <li><a href="&enbase;/commercial/hardware.html">硬件</a></li>
       <li><a href="&enbase;/commercial/consult_bycat.html">咨询</a></li>
       <li><a href="&enbase;/commercial/isp.html">网络服务提供商</a></li>
       <li><a href="&enbase;/commercial/misc.html">其它</a></li>
     </ul></li>
     <li><a href="&base;/security/index.html">安全信息</a>
     <ul>
       <li><a href="&enbase;/security/advisories.html">安全公告</a></li>
       <li><a href="&enbase;/security/notices.html">勘误</a></li>
       <li><a href="&base;/security/index.html#sup">支持的发行版本</a></li>
       <li><a href="&enbase;/security/unsupported.html">不再支持的发行版本</a></li>
       <li><a href="&base;/doc/en_US.ISO8859-1/books/handbook/security-advisories.html">
 	如何阅读 FreeBSD 安全公告</a></li>
       <li><a href="&base;/security/charter.html">安全长官与安全团队宪章</a></li>
     </ul></li>
     <li><a href="&enbase;/support/bugreports.html">Bug 报告</a>
       <ul>
 	<li><a href="https://bugs.FreeBSD.org/submit/">提交问题报告</a></li>
       </ul></li>
     <li><a href="&enbase;/support/webresources.html">Web 资源</a></li>
   </ul>
 </div> <!-- SIDENAV -->'>
 
 <!--
 <!ENTITY % navinclude.about "IGNORE">
 <![%navinclude.about;[
 <!ENTITY nav '&nav.about;'>
 ]]>
 <!ENTITY % navinclude.community "IGNORE">
 <![%navinclude.community;[
 <!ENTITY nav '&nav.community;'>
 ]]>
 <!ENTITY % navinclude.developers "IGNORE">
 <![%navinclude.developers;[
 <!ENTITY nav '&nav.developers;'>
 ]]>
 <!ENTITY % navinclude.docs "IGNORE">
 <![%navinclude.docs;[
 <!ENTITY nav '&nav.docs;'>
 ]]>
 <!ENTITY % navinclude.download "IGNORE">
 <![%navinclude.download;[
 <!ENTITY nav '&nav.download;'>
 ]>
 <!ENTITY % navinclude.gnome "IGNORE">
 <![%navinclude.gnome;[
 <!ENTITY nav '&nav.gnome;'>
 ]]>
 <!ENTITY % navinclude.ports "IGNORE">
 <![%navinclude.ports;[
 <!ENTITY nav '&nav.ports;'>
 ]]>
 <!ENTITY % navinclude.support "IGNORE">
 <![%navinclude.support;[
 <!ENTITY nav '&nav.support;'>
 ]]>
 -->
 <!ENTITY nav ''>
diff --git a/zh_CN.UTF-8/share/xml/news.xml b/zh_CN.UTF-8/share/xml/news.xml
index 67a9f13648..0d746ee994 100644
--- a/zh_CN.UTF-8/share/xml/news.xml
+++ b/zh_CN.UTF-8/share/xml/news.xml
@@ -1,2128 +1,2128 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <!DOCTYPE news PUBLIC "-//FreeBSD//DTD FreeBSD XML Database for News//EN"
                       "http://www.FreeBSD.org/XML/share/xml/news.dtd">
 
 <!-- Simple schema for FreeBSD Project news.
 
      Divide time in to <year>, <month>, and <day> elements, each of which
      has a <name>.
 
      each <day> element contains one or more <event> elements.
 
      Each <event> contains an optional <title>, and then a <p>.  <p> elements
      can contain <a> anchors.  Within the "href" attribute of the anchor
      &base; or &enbase; will be replaced with the base URI necessary to reach
      the FreeBSD document root, and should always be used to start URLs at
      www.FreeBSD.org or one of the mirrors.
 
      Use the <title> element if the <p> content is lengthy.  When generating
      synopses of this information (e.g., for syndication using RDF files),
      the contents of <title> will be preferred over <p>.
 
      The FreeBSD Simplified Chinese Documentation Project
-     Original Revision: r52668
+     Original Revision: 5ab14bb7de (r52668)
      From: www/share/xml/news.xml
 -->
 
 <news>
     <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">
       $FreeBSD$
     </cvs:keyword>
 
    <year>
     <name>2018</name>
 
     <month>
       <name>12</name>
 
       <day>
 	<name>11</name>
 
 	<event>
 	  <title>&os;&nbsp;12.0-RELEASE 发布了</title>
 
 	  <p><a href="&enbase;/releases/12.0R/announce.html">FreeBSD
 	      12.0-RELEASE</a> 现已发布。 在安装前， 请查看 <a
 	      href="&enbase;/releases/12.0R/relnotes.html">发行公告</a> 和 <a
 	      href="&enbase;/releases/12.0R/errata.html">勘误</a> 以了解
 	      12.0 的最新消息或问题。 要获取关于 FreeBSD 发行版本的更多信息， 请参阅 <a
 	      href="&base;/releases/index.html">发行版信息</a> 页面。</p>
 	</event>
 
 	<event>
 	  <title>Cirrus CI 支持 &os;</title>
 
 	  <p><a href="https://cirrus-ci.org/">Cirrus CI</a> 系统近期增加了对
 	      &os; 的支持。 Cirrus CI 通过使用现代云技术， 使您的开发迭代更加快速、
 				有效和安全。 Cirrus CI 和您的团队一起扩展， 让您的软件交付更为快速和经济。
 				要获取更多详情， 请参阅 <a
 	      href="https://cirrus-ci.org/guide/FreeBSD/">&os; 虚拟机</a> 教程。</p>
 	</event>
       </day>
 
       <day>
 	<name>1</name>
 
 	<event>
 	  <title>&os;&nbsp;12.0-RC3 发布了</title>
 
 	  <p> &os;&nbsp;12.0 的第三个候选发布版本现已发布。
 		  用于 amd64、armv6、armv7、arm64、i386、powerpc、powerpc64、powerpcspe
 		  和 sparc64 架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-December/090138.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
 
       </day>
     </month>
 
     <month>
       <name>11</name>
 
       <day>
 	<name>25</name>
 
 	<event>
 	  <title>&os;&nbsp;12.0-RC2 发布了</title>
 
 	  <p> &os;&nbsp;12.0 的第二个候选发布版本现已发布。
 		  用于 amd64、armv6、armv7、arm64、i386、powerpc、powerpc64、powerpcspe
 		  和 sparc64 架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-November/090068.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
       </day>
 
       <day>
 	<name>17</name>
 
 
 	<event>
 	  <title>&os;&nbsp;12.0-RC1 发布了</title>
 
 	  <p> &os;&nbsp;12.0 的第一个候选发布版本现已发布。
 		  用于 amd64、armv6、armv7、arm64、i386、powerpc、powerpc64、powerpcspe
 		  和 sparc64 架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-November/090020.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
       </day>
 
       <day>
 	<name>10</name>
 
 	<event>
 	  <title>&os;&nbsp;12.0-BETA4 发布了</title>
 
 	  <p> &os;&nbsp;12.0 的第四个 BETA 版本现已发布。
 		  用于 amd64、armv6、armv7、arm64、i386、powerpc、powerpc64、powerpcspe
 		  和 sparc64 架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-November/089982.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
       </day>
 
       <day>
 	<name>3</name>
 
 	<event>
 	  <title>&os;&nbsp;12.0-BETA3 发布了</title>
 
 	  <p> &os;&nbsp;12.0 的第三个 BETA 版本现已发布。
 		  用于 amd64、armv6、armv7、arm64、i386、powerpc、powerpc64
 		  和 sparc64 架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-November/089945.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>10</name>
 
       <day>
 	<name>27</name>
 
 	<event>
 	  <title>&os;&nbsp;12.0-BETA2 发布了</title>
 
 	  <p> &os;&nbsp;12.0 的第二个 BETA 版本现已发布。
 		  用于 amd64、armv6、armv7、arm64、i386、powerpc、powerpc64、powerpcspe
 		  和 sparc64 架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-October/089897.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
       </day>
 
       <day>
 	<name>20</name>
 
 	<event>
 	  <title>&os;&nbsp;12.0-BETA1 发布了</title>
 
 	  <p> &os;&nbsp;12.0 的第一个 BETA 版本现已发布。
 		  用于 amd64、armv6、armv7、arm64、i386、powerpc、powerpc64、powerpcspe
 		  和 sparc64 架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-October/089821.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
       </day>
 
       <day>
         <name>16</name>
         <event>
           <p>新增 committer:
             <a href="mailto:tmunro@FreeBSD.org">Thomas Munro</a>
             (src)</p>
         </event>
       </day>
 
       <day>
         <name>9</name>
         <event>
           <p>新增 committer:
             <a href="mailto:yuripv@FreeBSD.org">Yuri Pankov</a>
             (src)</p>
         </event>
       </day>
 
       <day>
         <name>8</name>
         <event>
           <p>新增 committer:
             <a href="mailto:egypcio@FreeBSD.org">Vin&iacute;cius Zavam</a>
             (ports)</p>
         </event>
       </day>
 
       <day>
         <name>1</name>
         <event>
           <p>新增 committer:
             <a href="mailto:rigoletto@FreeBSD.org">Alexandre C. Guimaraes</a>
             (ports)</p>
         </event>
       </day>
 
     </month>
 
     <month>
       <name>9</name>
 
       <day>
         <name>21</name>
         <event>
           <p>新增 committer:
             <a href="mailto:skozlov@FreeBSD.org">Sergey Kozlov</a>
             (ports)</p>
         </event>
       </day>
       <day>
         <name>6</name>
         <event>
           <p>新增 committer:
             <a href="mailto:manu@FreeBSD.org">Emmanuel Vadot</a>
             (ports)</p>
         </event>
       </day>
       <day>
         <name>2</name>
         <event>
           <p>新增 committer:
             <a href="mailto:kbowling@FreeBSD.org">Kevin Bowling</a>
             (ports)</p>
         </event>
       </day>
 
     </month>
 
     <month>
       <name>8</name>
 
       <day>
 	<name>9</name>
 
 	<event>
 	   <p>commit 权限提升:
              <a href="mailto:lwhsu@FreeBSD.org">许立文</a>
 	    (ports, src)</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>7</name>
 
       <day>
 	<name>16</name>
 
 	<event>
 	   <p>新增 committer:
              <a href="mailto:jhixson@FreeBSD.org">John Hixson</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>4</name>
 
 	<event>
 	  <title>新一届 &os; Core Team 已经通过选举产生</title>
 
 	  <p>活跃的 committer 们已经选出第十届
 	    &os; Core Team。 请参阅
 	    <a href="&lists.announce;/2018-July/001836.html">官方公告</a>
 	    以了解更多信息。</p></event>
       </day>
     </month>
 
     <month>
       <name>6</name>
 
       <day>
 	<name>30</name>
 
 	<event>
 	   <p>新增 committer:
              <a href="mailto:jsm@FreeBSD.org">Jesper Schmitz Mouridsen</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>27</name>
 
 	<event>
 	  <title>&os;&nbsp;11.2-RELEASE 发布了</title>
 
 	  <p><a href="&enbase;/releases/11.2R/announce.html">FreeBSD
 	      11.2-RELEASE</a> 现已发布。 在安装前， 请查看 <a
 	      href="&enbase;/releases/11.2R/relnotes.html">发行公告</a> 和 <a
 	      href="&enbase;/releases/11.2R/errata.html">勘误</a> 以了解
 	      11.2 的最新消息或问题。 要获取关于 FreeBSD 发行版本的更多信息， 请参阅 <a
 	      href="&base;/releases/index.html">发行版信息</a> 页面。</p>
 	</event>
 
 	<event>
 	   <p>新增 committer:
              <a href="mailto:bwidawsk@FreeBSD.org">Ben Widawsky</a>
 	    (src)</p>
 	</event>
       </day>
 
       <day>
 	<name>19</name>
 
 	<event>
 	  <title>&os; 国庆日：&os; 今天 25 岁了！</title>
 
 	  <p>自 1993 年 6 月 19 日 &os; 这个名字正式确定并被使用至今。 <a
 	    href="http://www.nationalfreebsdday.org">了解更多</a>
 	    关于如何与我们共同庆祝这个重要的节日。</p>
 	</event>
       </day>
 
       <day>
 	<name>16</name>
 
 	<event>
 	  <title>&os;&nbsp;11.2-RC3 发布了</title>
 
 	  <p> &os;&nbsp;11.2 的第三个候选发布版本现已发布。
 		  用于 amd64、armv6、arm64、i386、powerpc、powerpc64 和 sparc64
 			架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-June/089116.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
 
 	<event>
 	  <p>新增 committer:
 	    <a href="mailto:0mp@FreeBSD.org">Mateusz Piotrowski</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>9</name>
 
 	<event>
 	  <title>&os;&nbsp;11.2-RC2 发布了</title>
 
 	  <p> &os;&nbsp;11.2 的第二个候选发布版本现已发布。
 		  用于 amd64、armv6、arm64、i386、powerpc、powerpc64 和 sparc64
 			架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-June/089099.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
       </day>
 
       <day>
 	<name>8</name>
 
 	<event>
 	  <title>服务中断</title>
 
 	  <p>部分 &os; 集群将于六月九日星期六因电力工程维护而离线。
 	    服务将会受到影响， 尤其是邮件列表和我们的部分网站服务。</p>
 
 	  <p>维护窗口开始于六月九日星期六 11:00 UTC (04:00 太平洋时间)，
 	    结束于 20:00 UTC (13:00 太平洋时间)</p>。
 	</event>
       </day>
 
       <day>
 	<name>2</name>
 
 	<event>
 	  <title>&os;&nbsp;11.2-RC1 发布了</title>
 
 	  <p>&os;&nbsp;11.2 的第一个候选发布版本现已发布。
 	    用于 amd64、armv6、arm64、i386、powerpc、powerpc64 和 sparc64
 			架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-June/089053.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>5</name>
 
       <day>
 	<name>26</name>
 
 	<event>
 	  <title>&os;&nbsp;11.2-BETA3 发布了</title>
 
 	  <p>&os;&nbsp;11.2 的第三个 BETA 版本现已发布。
 	    用于 amd64、armv6、arm64、i386、powerpc、powerpc64 和 sparc64
 			架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-May/089001.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
       </day>
 
       <day>
 	<name>22</name>
         <event>
 	   <p>新增 committer:
              <a href="mailto:leitao@FreeBSD.org">Breno Leitao</a>
 	    (src)</p>
 	</event>
       </day>
 
       <day>
         <name>21</name>
 
         <event>
 	   <p>新增 committer:
              <a href="mailto:luporl@FreeBSD.org">Leandro Lupori</a>
 	    (src)</p>
 	</event>
       </day>
 
       <day>
 	<name>19</name>
 
 	<event>
 	  <title>&os;&nbsp;11.2-BETA2 发布了</title>
 
 	  <p>&os;&nbsp;11.2 的第二个 BETA 版本现已发布。
 	    用于 amd64、armv6、arm64、i386、powerpc、powerpc64 和 sparc64
 			架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-May/088958.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
       </day>
 
       <day>
         <name>15</name>
 
         <event>
 	   <p>新增 committer:
              <a href="mailto:arrowd@FreeBSD.org">Gleb Popov</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>12</name>
 
 	<event>
 	  <title>&os;&nbsp;11.2-BETA1 发布了</title>
 
 	  <p>&os;&nbsp;11.2 的第一个 BETA 版本现已发布。
 	    用于 amd64、armv6、arm64、i386、powerpc、powerpc64 和 sparc64
 			架构的 ISO 映像文件已经 <a
 	      href="&lists.stable;/2018-May/088899.html">发布</a>，
 	    可以通过众多的 <a
 	      href="&url.doc.base-en;/books/handbook/mirrors-ftp.html">&os;
 	      镜像站点</a> 获得。</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>4</name>
 
       <day>
 	<name>17</name>
 
 		<event>
 	   <p>新增 commiter:
 	     <a href="mailto:sef@freeBSD.org">Sean Eric Fagan</a>
 	     (src)</p>
 	        </event>
       </day>
 
       <day>
         <name>7</name>
 
 		<event>
 	   <p>新增 committer:
              <a href="mailto:thj@FreeBSD.org">Tom Jones</a>
 	    (src)</p>
 		</event>
       </day>
 
       <day>
         <name>4</name>
 
         <event>
 	   <p>新增 committer:
              <a href="mailto:ram@FreeBSD.org">Ram Kishore Vegesna </a>
 	    (src)</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>3</name>
 
       <day>
         <name>23</name>
 
         <event>
 	   <p>新增 committer:
              <a href="mailto:mfechner@FreeBSD.org">Matthias Fechner</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
         <name>17</name>
 
         <event>
 	   <p>新增 committer:
              <a href="mailto:ericbsd@FreeBSD.org">Eric Turgeon</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>16</name>
 
 	<event>
 	   <p>新增 committer:
 	     <a href="mailto:vmaffione@FreeBSD.org">Vincenzo Maffione</a>
 	     (src)</p>
 	</event>
       </day>
 
       <day>
 	<name>14</name>
 
 	<event>
 	   <p>新增 committer:
 	     <a href="mailto:meta@FreeBSD.org">Koichiro Iwao</a>
 	     (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>3</name>
 
 	<event>
 	   <p>新增 committer:
 	     <a href="mailto:fernape@FreeBSD.org">Fernando Apesteguia</a>
 	     (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>1</name>
 
 	<event>
 	  <p>新增 committer:
 	    <a href="mailto:dteske@FreeBSD.org">Devin Teske</a>
 	    (ports)</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>2</name>
 
       <day>
 	<name>14</name>
 
 	<event>
 	  <title>FreeBSD 项目计划参加 Google Summer of Code 2018</title>
 
 	  <p>FreeBSD 项目很高兴地宣布参加 Google 的 2018 年 Summer of Code 项目，
 	    此项目资助暑期学生参与开源项目。 这将是 FreeBSD 参与该项目的第 14 年。
 			2005 至 2017 年， 通过暑期的编程项目， 我们已经指导了超过 210 名成功的学生。</p>
 
 	  <p>过去的成功项目包含了 Linux ABI 模拟的改进， NFSv4 ACLs， TCP 回归测试，
 	    FUSE 文件系统支持， 以及其他非常多的项目， 数不胜数。
 	    许多学生在参与项目后依然持做出贡献， 继而成为 FreeBSD 开发者， 也通过 FreeBSD
 			基金会的持续支持， 参加了在世界各地举办的 FreeBSD 开发者活动。</p>
 
 	  <p>我们邀请有意向的参与者申请； 更多信息， 包括提案和截止日期等， 请参阅 <a
 	      href="&enbase;/projects/summerofcode.html">FreeBSD
 	      暑期项目</a>页面。</p>
 	</event>
       </day>
 
       <day>
 	<name>8</name>
 
 	<event>
 	   <p>新增 committer:
 	     <a href="mailto:slavash@FreeBSD.org">Slava Shwartsman</a>
 	     (src)</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>1</name>
 
       <day>
 	<name>25</name>
 
 	<event>
 	   <p>新增 committer:
 	     <a href="mailto:jeb@FreeBSD.org">Jeb Cramer</a>
 	     (src)</p>
 	</event>
       </day>
 
       <day>
 	<name>4</name>
 
 	<event>
 
            <title>关于 Meltdown 和 Spectre 攻击</title>
 
 	   <p>关于 <a href="https://meltdownattack.com/">Meltdown</a>
 	   和 <a href="https://spectreattack.com/">Spectre</a> 攻击：
 	   &os; 在 2017 年十二月下旬已经注意到这个问题。
 	   我们正在与 CPU 制造商一起努力， 参考已发布的论文， 努力减轻这类攻击对
 	   &os; 的影响。 鉴于这类攻击的原理， 补丁的发布日期暂时无法确定。</p>
 	</event>
       </day>
     </month>
 
   </year>
 
   <year>
     <name>2007</name>
 
     <month>
       <name>9</name>
 
       <day>
 	 <name>28</name>
 	 <event>
 	   <title>新增 committer： <a href="mailto:kaiw@freebsd.org">王楷</a>
 	     (src).</title>
 
 	   <p><a href="mailto:kaiw@freebsd.org">王楷</a>，
 	     Summer of Code 计划的获选学生， 现在成为了正式的
 	     src/ committer。</p>
 	 </event>
       </day>
       <day>
 	 <name>25</name>
 	 <event>
 	   <title>新增 committer： <a href="mailto:rpaulo@freebsd.org">Rui Paulo</a>
 	     (src).</title>
 
 	   <p><a href="mailto:rpaulo@freebsd.org">Rui Paulo</a>，
 	     Summer of Code 计划的获选学生， 现在成为了正式的
 	     src/ committer。</p>
 	 </event>
       </day>
       <day>
          <name>17</name>
          <event>
 	   <title>Summer of Code 项目结项了</title>
 
            <p>我们非常高兴 22 位学生完成了他们的 FreeBSD <a
              href="&base;/projects/summerofcode-2007.html">Summer of
              Code</a> 项目。 在此祝贺参与项目的导师和学生， 并感谢 <a
              href="http://www.google.com/">Google</a> 运营此项活动，
              并为其提供资金赞助。</p>
 
          </event>
       </day>
     </month>
 
     <month>
       <name>8</name>
 
       <day>
         <name>29</name>
 	<event>
 	  <title>FreeBSD 基金会 2007 年 8 月新闻通讯</title>
 
 	  <p>FreeBSD 基金会发布了
 	    <a href="http://www.freebsdfoundation.org/press/2007Aug-newsletter.shtml">
 	    2007 年 8 月新闻通讯</a>， 总结了这一年的活动。</p>
 	</event>
       </day>
 
       <day>
         <name>20</name>
 	<event>
 	  <p>新增 committer： <a href="mailto:tabthorpe@freebsd.org">Thomas Abthorpe</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>2</name>
 	<event>
 	  <title>FreeBSD.org 集群连入 IPv6 了</title>
 
 	  <p>FreeBSD.org 集群中的多数机器和服务现在已连入 IPv6， 这包括 www、 邮件，
 	    以及开发人员的 ssh 访问。 此网络连接由 ISC 通过 tunnel 提供。</p>
 	</event>
 
 	<event>
 	  <p>新增 committer： <a href="mailto:loader@freebsd.org">陈福康</a>
 	    (doc)</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>7</name>
 
       <day>
         <name>10</name>
 	<event>
 	   <title>2007 年第二季度开发进度报告</title>
 
            <p>2007 年第二季度的开发进度报告 <a
              href="&enbase;/news/status/report-2007-04-2007-06.html">现已发布</a>，
 	     包含 49 项内容。</p>
 	</event>
       </day>
 
       <day>
         <name>9</name>
 	<event>
 	  <p>新增 committer： <a href="mailto:lme@freebsd.org">Lars Engels</a>
 	    (ports)</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>6</name>
 
       <day>
         <name>25</name>
         <event>
           <p>commit 权限提升： <a href="mailto:edwin@freebsd.org">Edwin Groothuis</a>
             (src, ports)</p>
         </event>
       </day>
 
       <day>
         <name>24</name>
         <event>
           <p>新增 committer： <a href="mailto:scf@freebsd.org">Sean C. Farley</a>
             (src)</p>
         </event>
       </day>
 
       <day>
 	<name>12</name>
 	<event>
 	  <p>新增 committer： <a
 	    href="mailto:timur@FreeBSD.org">Timur I. Bakeyev</a>
 	    (ports)</p>
 	</event>
 
 	<event>
           <p>commit 权限提升： <a
             href="mailto:chinsan@FreeBSD.org">Chin-San Huang</a>
             (doc, ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>7</name>
 	<event>
 	  <title>FreeBSD Project 集成了 Camellia 分块加密算法支持</title>
 
 	  <p>在 FreeBSD 7-CURRENT 中已集成了对 Camellia 分块加密算法的支持， 并将作为
 	    FreeBSD 7.0-RELEASE 的一部分发布。 欲了解进一步的信息， 请参见 <a
 	      href="http://www.emediawire.com/releases/2007/6/emw531216.htm">
 	    新闻发布</a>。</p>
 	</event>
       </day>
 
       <day>
 	<name>4</name>
 
 	<event>
 	  <p>commit 权限提升： <a href="mailto:jkois@freebsd.org">Johann Kois</a>
 	    (full doc/www)</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>5</name>
 
       <day>
 	<name>30</name>
 	<event>
 	  <p>新增 committer： <a
 	    href="mailto:beech@FreeBSD.org">Beech Rintoul</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
         <name>29</name>
         <event>
           <title>新增 committer： <a href="mailto:attilio@freebsd.org">Attilio Rao</a>
             (src)。</title>
 
           <p><a href="mailto:attilio@freebsd.org">Attilio Rao</a>，
 	      一名参加 Summer of Code 计划的学生， 成为了正式的 src/ committer。</p>
         </event>
       </day>
 
       <day>
         <name>19</name>
         <event>
           <title>在 ports 套件中引入了 Xorg 7.2</title>
           <p>感谢
             <a href="mailto:flz@FreeBSD.org">Florent Thoumie</a> (以及其他人)
             的努力工作， FreeBSD ports 套件已经开始使用模块化的
             Xorg 7.2 作为其默认 X 服务。 用于 i386 和 AMD64 6.2-STABLE
             的预编译包已经处于可用状态， 用于其他架构/版本的预编译包将在稍后发布，
             您也可以自行从源代码进行编译。 这两种情况均应参见 <a
 	      href="http://www.freebsd.org/cgi/cvsweb.cgi/ports/UPDATING?rev=1.504;content-type=text%2Fplain">
 	      /usr/ports/UPDATING 中的项目 20070519</a> 以了解如何升级。 请关注 <a
 	      href="http://docs.freebsd.org/mail/archive/freebsd-ports.html">-ports</a>
             以了解最新进展。
           </p>
         </event>
       </day>
     </month>
 
     <month>
       <name>4</name>
 
       <day>
         <name>26</name>
         <event>
           <p>新增 committer： <a href="mailto:araujo@freebsd.org">Marcelo Araujo</a>
             (ports)</p>
         </event>
       </day>
 
       <day>
         <name>25</name>
         <event>
           <p>新增 committer： <a href="mailto:nemoliu@freebsd.org">刘彤</a>
             (ports)</p>
         </event>
       </day>
 
       <day>
         <name>13</name>
 
         <event>
 	  <title>Summer of Code 资助项目公示</title>
 
 	  <p>FreeBSD Project 收到了超过 120 份 <a
 	    href="http://code.google.com/soc">Google 的
 	    Summer of Code</a> 项目申请， 其中有 25 个获得了资助。
 	    令人遗憾的是， 其中第一流的申请数量远远超出了我们获得的名额。
 	    尽管如此， 我们仍然鼓励在校学生与我们一同工作， FreeBSD
 	    Project 希望能够带领更多的在校学生通过我们的社区邮件列表及开发论坛了解操作系统的开发。
 	    参与开放源代码的软件项目是计算科学教育中的重要一环，
 	    并且也会成为软件开发者职业生涯中的一个亮点。</p>
 
 	  <p>本次被选中的学生及项目列表可以在 <a
 href="http://www.freebsd.org/projects/summerofcode-2007.html">这里</a> 看到。
 除此之外， <a href="http://wiki.freebsd.org/moin.cgi/SummerOfCode2007">Summer
 of Code wiki</a> 提供了更多的其他信息。</p>
         </event>
 
         <event>
 	  <p>新增 committer： <a href="mailto:trasz@freebsd.org">Edward Tomasz Napierala</a>
 	    (ports)</p>
         </event>
 	<event>
 	  <title>蒙古语 FreeBSD 文档计划上线了</title>
 
 	  <p>由 <a
 	      href="mailto:ganbold@micom.mng.net">Ganbold Tsagaankhuu</a>
 	    负责的蒙文翻译版本上线了。 本次新增了由 FreeBSD 蒙文文档计划翻译的官方的
 	    FreeBSD 手册， 以及对于其他语言支持的文档。 如欲了解关于 MFDP 的最新情报，
 	    请参见 <a href="&base;/docproj/translations.html">Translations page
 	    of the FreeBSD Documentation Project</a>。</p>
 	</event>
       </day>
 
       <day>
         <name>12</name>
         <event>
           <p>新增 committer： <a href="mailto:mav@freebsd.org">Alexander Motin</a>
             (src)</p>
         </event>
       </day>
 
       <day>
 	 <name>9</name>
 	 <event>
 	   <title>2007 年第一季度开发进度报告</title>
 
            <p>2007 年第一季度的开发进度报告 <a
              href="&enbase;/news/status/report-2007-01-2007-03.html">现已发布</a>，
 	     包含 19 项内容。</p>
 	 </event>
       </day>
 
       <day>
         <name>6</name>
 	<event>
 	  <title>ZFS 成为了 FreeBSD 的一部分</title>
 
 	  <p>对 Sun 的 <a href="http://www.sun.com/2004-0914/feature/">
 	      ZFS</a> 的支持， 已汇入 FreeBSD 7-CURRENT 开发分支，
 	    并将作为一项试验性功能随 FreeBSD 7.0-RELEASE 提供。 欲了解进一步信息，
 	    请参见 <a
 	      href="http://lists.freebsd.org/pipermail/freebsd-current/2007-April/070544.html">
 	      公告</a>。</p>
 	</event>
       </day>
 
       <day>
         <name>4</name>
         <event>
 	  <p>新增 committer： <a href="mailto:mm@freebsd.org">Martin Matuska</a>
 	    (ports)</p>
         </event>
       </day>
 
       <day>
         <name>3</name>
         <event>
 	  <p>新增 committer： <a href="mailto:lwhsu@freebsd.org">许立文</a>
 	    (ports)</p>
         </event>
       </day>
     </month>
 
     <month>
       <name>3</name>
 
       <day>
         <name>28</name>
         <event>
 	  <p>新增 committer： <a href="mailto:sephe@freebsd.org">乔彦珉</a>
 	    (src)</p>
         </event>
       </day>
 
       <day>
 	<name>14</name>
         <event>
 	  <title>开始接受 Summer of Code 申请</title>
 
           <p>FreeBSD Project 目前已经开始接受 Google <a
 	    href="http://code.google.com/summerofcode.html">Summer
             of Code 2007</a> 计划申请。
             这一计划将为在暑假起见为开源项目提供帮助的学生提供资助。
             专属于 FreeBSD 的项目和对应的导师， 可以在 <a
             href="&base;/projects/summerofcode.html">这里</a> 找到。</p>
 
           <p>一旦找到了合适的项目和导师， 感兴趣的学生应填写一份项目提案并提交给 Google。
 	    我们目前已经开始接受项目申请， 而最后期限则是 2007 年 3 月 24 日。
 	    请参阅 <a
 	    href="http://code.google.com/support/bin/topic.py?topic=10442">Google
 	    FAQ</a> 了解进一步的详情。</p>
         </event>
       </day>
 
       <day>
 	<name>12</name>
 	<event>
 	  <title>2007 年 3 月的快照版本发布了</title>
 
 	  <p>2007 年 3 月的 FreeBSD 7-CURRENT 和 6-STABLE 快照发行版已经发布了。
 	    FreeBSD 交付工程组发布这些快照发行版的目的是鼓励用户测试新功能，
 	    并协助改善其可靠性。 更多细节请参阅
 	    <a href="&enbase;/snapshots/index.html">快照</a>。</p>
 	</event>
       </day>
 
       <day>
         <name>11</name>
         <event>
           <title>新增 committer：<a
 	    href="mailto:bushman@FreeBSD.org">Michael Bushkov</a>
             (src)。 SoC2006 学生。</title>
 
           <p><a href="mailto:bushman@FreeBSD.org">Michael Bushkov</a>，
 	      一名参加去年 Summer of Code 计划的学生， 继续为 FreeBSD Project
 	      工作， 并成为了正式的 src/ committer。</p>
         </event>
       </day>
 
       <day>
 	<name>10</name>
 	<event>
 	  <title>FreeBSD 在 8 CPU 系统上可伸缩性方面的进展</title>
 
 	  <p>近期为 8-核 amd64 系统上运行 MySQL 而对 FreeBSD 7.0 进行的改善已取得了重大进展。
 	    在测试的负荷下 FreeBSD 的峰值性能已经与 Linux 相当， 而在更高负载下，
 	    其性能则高出 4 倍。 进一步的介绍在 <a
 	      href="http://people.freebsd.org/~kris/scaling/mysql.html">这里</a>。</p>
 	</event>
       </day>
 
       <day>
 	<name>7</name>
 	<event>
 	  <title>FreeBSD 发布了由 Intel 授权的无线网卡固件</title>
 
 	  <p>The FreeBSD project 与 Intel 就再分发其用于 Intel 无线网卡的固件文件达成了协议。
 	    请参阅 <a
 	      href="http://www.prweb.com/releases/2007/03/prweb509818.htm">新闻发布</a>
 	    以了解进一步的详情。</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>2</name>
 
       <day>
 	<name>27</name>
 	<event>
           <p>关于影响 FreeBSD 发行版本中一些时区中夏令时的变更 <a href="&base;/releng/dst_info.html">信息</a>。</p>
         </event>
       </day>
 
       <day>
 	<name>23</name>
 	<event>
 	  <p>commit 权限提升：<a
 	    href="mailto:remko@FreeBSD.org">Remko Lodder</a>
 	    (doc,src)</p>
         </event>
       </day>
 
       <day>
         <name>17</name>
         <event>
           <p>新增 committer: <a href="mailto:jinmei@FreeBSD.org">神明达哉</a>
             (src)</p>
         </event>
       </day>
 
       <day>
         <name>16</name>
         <event>
           <p>新增 committer： <a href="mailto:sepotvin@FreeBSD.org">Stephane E. Potvin</a>
             (src)</p>
         </event>
       </day>
 
       <day>
          <name>10</name>
          <event>
 	  <p>新增 committer： <a href="mailto:benjsc@freebsd.org">Benjamin Close</a>
 	    (src)</p>
          </event>
       </day>
 
       <day>
 	<name>9</name>
 	<event>
 	  <title>对 FreeBSD Core Team 成员及
 	    AsiaBSDCon 2007 组委会主席 George V.
 	    Neville-Neil 的 PodCast 访谈</title>
 
 	  <p>在最新一期的 <a href="http://bsdtalk.blogspot.com/">bsdtalk</a>
 	    podcast 中， Will Backman 对 FreeBSD 开发者 George V.
 	    Neville-Neil 就将要进行的 AsiaBSDCon 会议进行了采访。 您可从
 	    <a
 	      href="http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk099.mp3">
 	      http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk099.mp3</a> 收听。</p>
 	</event>
       </day>
 
       <day>
 	<name>8</name>
 	<event>
           <title>宣布 AsiaBSDCon 2007 议程</title>
 
 	  <p>将在 3 月 8 日至 11 日于东京举行的亚洲地区 BSD 会议， AsiaBSDCon，
 	    目前已正式公布其会议时间表。 完整的时间表可以在
 	    <a href="http://www.asiabsdcon.org/timetable.html">这里</a> 找到。</p>
 
 	  <p>正式的报名将在 2 月 12 日左右开始。</p>
 	</event>
       </day>
 
       <day>
 	<name>2</name>
 	<event>
           <p>commit 权限提升：<a
 	    href="mailto:gabor@FreeBSD.org">G&aacute;bor K&ouml;vesd&aacute;n</a>
 	    (doc, ports)</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>1</name>
 
       <day>
         <name>31</name>
         <event>
           <p>commit 权限提升：<a
             href="mailto:rafan@FreeBSD.org">范荣恩</a>
             (src, ports)</p>
         </event>
       </day>
 
       <day>
          <name>18</name>
          <event>
 	  <p>新增 committer： <a href="mailto:db@freebsd.org">Diane Bruce</a>
 	    (ports)</p>
          </event>
       </day>
 
       <day>
 	 <name>16</name>
 	 <event>
 	   <title>2006 年第四季度开发进度报告</title>
 
            <p>2006 年第四季度的开发进度报告 <a
              href="&enbase;/news/status/report-2006-10-2006-12.html">现已发布</a>，
 	     其中包含了 41 项内容。</p>
         </event>
       </day>
 
       <day>
 	<name>15</name>
 
 	<event>
           <title>FreeBSD 6.2-RELEASE 发布了</title>
 
           <p><a href="&enbase;/releases/6.2R/announce.html">FreeBSD
 	    6.2-RELEASE</a> 现已发布。 在安装前请参阅 <a
 	    href="&base;/releases/6.2R/errata.html">发行勘误</a>
 	    以了解与 6.2 有关的最新消息以及新近发现的问题。 在 <a
 	    href="&base;/releases/index.html">发行版信息</a>
 	    页面中提供了关于 FreeBSD 发行版的进一步信息。</p>
         </event>
       </day>
 
       <day>
 	<name>9</name>
 
 	<event>
 	  <title>匈牙利文 FreeBSD 文档计划启动</title>
 
 	  <p>在 FreeBSD 开发人员 G&aacute;bor K&ouml;vesd&aacute;n 的监督下，
 	    文档的匈牙利文版本的翻译工作已经开始。 这一由匈牙利 FreeBSD
 	    文档计划完成的官方译本中增加了对于文档的其他语言的支持。
 	    如欲了解关于 HFDP 团队正在进行工作的详情， 请参见
 	    <a href="http://www.FreeBSD.org/docproj/translations.html">FreeBSD
 	    文档计划的翻译页面</a>。</p>
 	</event>
       </day>
     </month>
   </year>
 
   <year>
     <name>2006</name>
     <month>
       <name>12</name>
 
       <day>
 	<name>27</name>
 	<event>
 	  <p>新增 committer：<a href="mailto:jls@freebsd.org">Jordan Sissel</a>
 	    (src)</p>
 	</event>
 
 	<event>
 	  <title>FreeBSD 6.2-RC2 发布了</title>
 
 	  <p>FreeBSD 6.2 的第二个候选发布版本现已 <a
 	    href="http://lists.freebsd.org/pipermail/freebsd-stable/2006-December/031742.html">发布</a>。
 	    用于 Tier-1 平台的 ISO 映像文件， 已可以通过众多的
 	    <a href="http://www.FreeBSD.org/doc/zh_CN.UTF-8/books/handbook/mirrors-ftp.html">
 	    FreeBSD 镜像站点</a> 获得。</p>
 	</event>
       </day>
 
       <day>
 	<name>26</name>
 	<event>
 	  <p>新增 committer：<a href="mailto:dryice@FreeBSD.org">刘栋</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>22</name>
 	<event>
 	  <p>新增 committer：<a href="mailto:nox@FreeBSD.org">Juergen Lock</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>10</name>
 	<event>
 	  <title>对 FreeBSD 开发人员 Joseph Koshy 的 Podcast 访谈</title>
 
 	  <p>在最新一期 <a href="http://bsdtalk.blogspot.com/">bsdtalk</a>
 	    podcast 中， Will Backman 就 FreeBSD 开发人员 Joseph Koshy
 	    近期在 libElf 上所做的工作进行了访谈。 这期 podcast 可以通过
 	    <a
 	      href="http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk087.mp3">
 	      http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk087.mp3</a> 收听。</p>
 	</event>
       </day>
 
       <day>
 	<name>7</name>
 	<event>
 	  <title>对 FreeBSD 开发人员 Kip Macy 的 Podcast 访谈</title>
 
 	  <p>在最新一期 <a href="http://bsdtalk.blogspot.com/">bsdtalk</a>
 	    podcast 中， Will Backman 就近期 FreeBSD/sun4v
 	    的移植进展， 对 FreeBSD 开发人员 Joseph Koshy 进行了采访。 这期 podcast 可以通过
 	    <a
 	      href="http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk086.mp3">
 	      http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk086.mp3</a> 收听。</p>
 	</event>
       </day>
 
       <day>
 	<name>5</name>
 	<event>
 	  <p>新增 committer：<a href="mailto:nivit@FreeBSD.org">Nicola Vitale</a>
 	  (ports)</p>
 	</event>
 
 	<event>
 	  <p>新增 committer：<a href="mailto:gabor@FreeBSD.org">G&aacute;bor K&ouml;vesd&aacute;n</a>
 	    (ports)。 SoC2006 学生。</p>
 
           <p><a href="mailto:gabor@FreeBSD.org">G&aacute;bor K&ouml;vesd&aacute;n</a>，
 	      一名参加去年 Summer of Code 计划的学生， 继续为 FreeBSD Project
 	      工作， 并成为了正式的 ports/ committer。</p>
 	</event>
       </day>
 
       <day>
 	<name>1</name>
 	<event>
 	  <title>对 FreeBSD 开发人员 Tom McLaughlin 的 Podcast 访谈</title>
 
 	  <p>在最新一期 <a href="http://bsdtalk.blogspot.com/">bsdtalk</a>
 	    podcast 中， Will Backman 就 BSD# 项目和 FreeBSD 上的 Mono
 	    对 FreeBSD 开发人员 Tom McLaughlin 进行了采访。 这期 podcast 可以通过
 	    <a
 	      href="http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk085.mp3">
 	      http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk085.mp3</a> 收听。</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>11</name>
 
       <day>
 	<name>29</name>
 	<event>
 	  <p>新增 committer：<a href="mailto:lx@FreeBSD.org">David Thiel</a>
 	  (ports)</p>
 	</event>
 
 	<event>
 	  <title>对 FreeBSD 交付工程师马源浩的 Podcast 访谈</title>
 
 	  <p>在最新一期 <a href="http://bsdtalk.blogspot.com/">bsdtalk</a>
 	    podcast 中， Will Backman 就将要发布的 FreeBSD 6.2 版对交付工程师马源浩 (Bruce
 	    Mah) 进行了采访。 这期 podcast 可以通过
 	    <a
 	      href="http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk084.mp3">
 	      http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk084.mp3</a> 收听</p>
 	</event>
       </day>
 
       <day>
 	<name>17</name>
 	<event>
 	  <title>FreeBSD 6.2-RC1 发布了</title>
 
 	  <p>FreeBSD 6.2 的第一个候选发布版本现已 <a
 	    href="http://lists.freebsd.org/pipermail/freebsd-stable/2006-November/030811.html">发布</a>。
 	    用于 Tier-1 平台的 ISO 映像文件， 已可以通过众多的
 	    <a href="http://www.FreeBSD.org/doc/zh_CN.UTF-8/books/handbook/mirrors-ftp.html">
 	    FreeBSD 镜像站点</a> 获得。</p>
 	</event>
       </day>
 
       <day>
 	<name>16</name>
 	<event>
 	  <title>FreeBSD 基金会秋季募捐</title>
 
 	  <p><a
 	      href="http://www.freebsdfoundation.org/">FreeBSD 基金会</a>
 	    正在举行 <a
 	      href="http://www.freebsdfoundation.org/donate/">秋季募捐</a>。
 	    本次募捐将在很大程度上影响明年基金会的预算。</p>
 	</event>
       </day>
 
       <day>
 	<name>14</name>
 	<event>
 	  <title>FreeBSD.org 系统搬移推迟</title>
 
           <p>计划于 11 月 13 日 (周一) 进行的 FreeBSD.org 系统搬移工作因故推迟。
             目前的最新计划是于美国太平洋时间 11 月 17 日 (周五) 进行此项工作。</p>
         </event>
       </day>
 
       <day>
       	<name>12</name>
 	<event>
 	  <title>FreeBSD/sun4v 安装 / Live CD 发布了</title>
 
 	  <p>在 Sun 的 UltraSparc-T1 架构上的 FreeBSD 移植工作目前已经取得了阶段性的进展，
 	    我们制作了一张包含现场文件系统的安装 ISO。 更多细节请参见
 	    <a href="http://www.FreeBSD.org/platforms/sun4v.html">FreeBSD/sun4v 计划专页</a>。</p>
 	</event>
 
 	<event>
 	  <p>新增 committer：<a href="mailto:koitsu@FreeBSD.org">Jeremy Chadwick</a>
 	  (ports)</p>
 	</event>
       </day>
 
       <day>
       	<name>7</name>
 	<event>
 	  <p>新增 committer：<a href="mailto:farrokhi@FreeBSD.org">Babak Farrokhi</a>
 	  (ports)</p>
 	</event>
 
 	<event>
 	  <p>新增 committer：<a href="mailto:laszlof@FreeBSD.org">Frank J. Laszlo</a>
 	  (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>5</name>
 	<event>
 	  <title>FreeBSD.org 系统迁移</title>
 
 	  <p>用于提供 FreeBSD Project 邮件、 web、 CVS 等的 FreeBSD.org 服务器，
 	    即将迁移到新的数据中心。 我们计划在 11 月 13 日周一 (美国太平洋标准时间)
 	    进行本次迁移。</p>
 
 	  <p>本次搬移的准备过程可能导致 FreeBSD.org 在最终完成迁移之前出现短暂的服务停止。
 	    在搬移的当天， 只有静态的部分 (例如， 纯 HTML 页面， 而不包括 CGI) 的 <a
 	      href="http://www.FreeBSD.org/">http://www.FreeBSD.org/</a>
 	    会提供服务。</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>10</name>
 
       <day>
 	<name>31</name>
 	<event>
 	  <title>FreeBSD 6.2-BETA3 发布了</title>
 
 	  <p>FreeBSD 6.2 的第三个 beta 版本现已 <a
 	    href="http://lists.freebsd.org/pipermail/freebsd-stable/2006-November/030277.html">发布</a>。
 	    用于 Tier-1 平台的 ISO 映像文件， 已可以通过众多的
 	    <a href="http://www.FreeBSD.org/doc/zh_CN.UTF-8/books/handbook/mirrors-ftp.html">
 	    FreeBSD 镜像站点</a> 获得。</p>
 	</event>
       </day>
 
       <day>
          <name>25</name>
          <event>
 	   <title>Summer of Code 项目结项了</title>
 
            <p>我们非常高兴全部 14 位学生都成功地完成了他们的 FreeBSD <a
              href="&base;/projects/summerofcode-2006.html">Summer of
              Code</a> 项目。 在此祝贺参与项目的导师和学生， 并感谢 <a
              href="http://www.google.com/bsd">Google</a> 运营此项活动，
              并为其提供资金赞助。</p>
 
          </event>
       </day>
 
       <day>
 	 <name>19</name>
 	 <event>
 	   <title>2006 年第三季度开发进度报告</title>
 
            <p>2006 年第三季度开发进度报告 <a
              href="&enbase;/news/status/report-2006-06-2006-10.html">现已发表</a>， 其中介绍了 49 项内容。</p>
         </event>
       </day>
 
       <day>
 	 <name>14</name>
 	 <event>
 	  <title>用于 FreeBSD 的 GNOME 2.16.1 发布了</title>
 
 	  <p>GNOME 2.16.1 已经发布， 并已合并到了 FreeBSD
 	      ports tree。 请访问
 	      <a href="&enbase;/gnome/index.html">FreeBSD GNOME 主页</a>
 	      以查看正式的公告， 以及重要的
 	      <a href="&base;/gnome/docs/faq216.html">升级指南</a>。</p>
       	</event>
       </day>
 
       <day>
         <name>8</name>
         <event>
           <p>新增 committer：<a
 	    href="mailto:syrinx@FreeBSD.org">Shteryana Shopova</a>
 	    (src)</p>
         </event>
       </day>
 
       <day>
 	<name>5</name>
 	<event>
 	  <title>FreeBSD 6.2-BETA2 发布了</title>
 
 	  <p>FreeBSD 6.2 的第二个 beta 版本现已 <a
 	    href="http://lists.freebsd.org/pipermail/freebsd-stable/2006-October/029171.html">发布</a>。
 	    用于 Tier-1 平台的 ISO 映像文件， 已可以通过众多的
 	    <a href="http://www.FreeBSD.org/doc/zh_CN.UTF-8/books/handbook/mirrors-ftp.html">
 	    FreeBSD 镜像站点</a> 获得。</p>
 	</event>
       </day>
     </month>
     <month>
       <name>9</name>
 
       <day>
         <name>28</name>
         <event>
           <p>新增 committer：<a href="mailto:xride@FreeBSD.org">Soeren Straarup</a> (ports)</p>
         </event>
       </day>
 
       <day>
         <name>21</name>
         <event>
           <p>新增 committer：<a href="mailto:jfv@FreeBSD.org">Jack F. Vogel</a>
             (src)</p>
         </event>
 
 	<event>
 	  <title>FreeBSD 6.2-BETA1 发布了</title>
 
 	  <p>FreeBSD 6.2 的第一个 beta 版本现已 <a
 	    href="http://lists.freebsd.org/pipermail/freebsd-stable/2006-September/028584.html">发布</a>。
 	    本次 BETA1 的 ISO 映像文件， 已可以通过众多的
 	    <a href="http://www.FreeBSD.org/doc/zh_CN.UTF-8/books/handbook/mirrors-ftp.html">
 	    FreeBSD 镜像站点</a> 获得。</p>
 	</event>
       </day>
 
       <day>
         <name>20</name>
         <event>
           <p>新增 committer：<a href="mailto:chinsan@FreeBSD.org">黄青山</a>
             (doc)</p>
         </event>
       </day>
 
       <day>
         <name>18</name>
         <event>
           <p>新增 committer：<a href="mailto:stas@FreeBSD.org">Stanislav Sedov</a>
             (ports)</p>
         </event>
       </day>
 
       <day>
         <name>12</name>
         <event>
           <p>新增 committer：<a href="mailto:alexbl@FreeBSD.org">Alexander Botero-Lowry</a>
             (ports)</p>
         </event>
       </day>
 
       <day>
 	<name>1</name>
 	<event>
 	  <p>新增 committer：<a href="mailto:rrs@FreeBSD.org">Randall R. Stewart</a>
             (src)</p>
 	</event>
       </day>
     </month>
     <month>
       <name>8</name>
 
       <day>
 	<name>20</name>
 	<event>
 	  <p>新增 committer：<a href="mailto:danger@FreeBSD.org">Daniel
 	    Ger&zcaron;o</a> (doc)</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>7</name>
       <day>
 	<name>26</name>
 	<event>
 	  <title>选举产生了新一届 FreeBSD Core Team</title>
 
 	  <p>FreeBSD Core Team 竞选已经结束。
 	    选举结果已在 <a
 	    href="http://docs.freebsd.org/cgi/getmsg.cgi?fetch=0+0+archive/2006/freebsd-announce/20060730.freebsd-announce">这里</a> 公布。
 	  </p>
 	</event>
       </day>
 
       <day>
 	<name>19</name>
 	<event>
 	  <title>对 FreeBSD 开发人员 Greg Lehey 的 Podcast 访谈</title>
 
 	  <p>在最新一期 <a href="http://bsdtalk.blogspot.com/">bsdtalk</a>
 	    podcast 中， Will Backman 对 FreeBSD 开发人员 Greg Lehey
 	    就他在 FreeBSD 和 MySQL 上的工作进行了采访。 这期 podcast 可以通过
 	    <a
 	      href="http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk055.mp3">
 	    http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk055.mp3</a> 收听。</p>
 	</event>
       </day>
 
       <day>
 	<name>18</name>
 	<event>
 	 <p>新增 committer：<a href="mailto:acm@FreeBSD.org">Jose Alonso Cardenas Marquez</a>
             (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>13</name>
 	<event>
 	  <title>对 FreeBSD 开发人员 Pawel Jakub Dawidek 的 Podcast 访谈</title>
 
 	  <p>在最新一期 <a href="http://bsdtalk.blogspot.com/">bsdtalk</a>
 	    podcast 中， Will Backman 对 FreeBSD 开发人员 Pawel Jakub Dawidek
 	    就他在 FreeBSD 上的工作， 特别是 GEOM 日志项目进行了采访。 这期
 	    podcast 可以通过 <a
 	      href="http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk052.mp3">
 	    http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk052.mp3</a> 收听。</p>
 	</event>
       </day>
 
       <day>
         <name>12</name>
         <event>
 	  <title>2006 年第二季度开发进度报告发布了</title>
 
 	  <p>2006 年第二季度的开发进度报告 <a
 	    href="&enbase;/news/status/report-2006-04-2006-06.html">现已发布</a>，
 	    其中介绍了 39 项内容。</p>
         </event>
       </day>
 
       <day>
         <name>5</name>
         <event>
 	  <title>FreeBSD 基金会发布了用于 FreeBSD 5.5、 6.1 以及 AMD64 平台的预编译 Java</title>
 
 	  <p>FreeBSD 基金会现已开始提供基于 Sun Microsystems UPDATE7 的专用于 FreeBSD
 	    的预编译版本 Java JDK 和 JRE 1.5。 欲了解更多详情，
 	    请参见 FreeBSD 基金会 <a
 	    href="http://www.freebsdfoundation.org/press/20060705-PRrelease.shtml">
 	      发布的新闻</a>。</p>
         </event>
       </day>
     </month>
 
     <month>
       <name>6</name>
 
       <day>
         <name>24</name>
         <event>
           <p>
             新增 committer：<a href="mailto:rafan@FreeBSD.org">范荣恩</a>
             (ports)
           </p>
         </event>
       </day>
 
       <day>
         <name>21</name>
         <event>
           <p>
             新增 committer：<a href="mailto:bsam@FreeBSD.org">Boris Samorodov</a>
             (ports)
           </p>
         </event>
       </day>
 
       <day>
         <name>19</name>
 	<event>
 	    <p>新增 committer：<a
 	    href="mailto:shaun@FreeBSD.org">Shaun Amott</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
         <name>5</name>
         <event>
 	    <p>新增 committer：<a
 		href="mailto:kib@FreeBSD.org">Konstantin Belousov</a>
 		(src)</p>
 	</event>
 
         <event>
 	    <p>新增 committer：<a
 	    href="mailto:miwi@FreeBSD.org">Martin Wilke</a>
 	    (ports)</p>
 	</event>
     </day>
     </month>
 
     <month>
       <name>5</name>
       <day>
         <name>30</name>
 	<event>
 	  <title>在校生项目资助计划公告</title>
 
 	  <p>The FreeBSD Project 收到了超过 120 份 <a
 	    href="http://code.google.com/summerofcode.html">Google's
 	    Summer of Code</a> 计划项目申请， 并从中选出了 14 个进行资助。
 	    非常遗憾的是， 第一流的申请远远超出了学生的名额。 不过，
 	    我们鼓励在校生继续与我们一起工作。 The FreeBSD Project
 	    一直都希望能够通过我们的邮件列表和开发论坛，
 	    帮助带领学生了解更多关于操作系统开发。 为开源软件项目提供帮助，
 	    是计算科学教育中的重要一环，
 	    同时也是软件开发职业生涯的一项绝佳的准备条件。</p>
 
 	  <p>选出的完整的学生和项目名单可以在 <a
 href="http://www.freebsd.org/projects/summerofcode.html">这里</a> 找到。 <a
 href="http://wiki.freebsd.org/moin.cgi/SummerOfCode2006">Summer of Code wiki</a> 也提供了更多的附加信息。</p>
          </event>
 
          <event>
             <title>新增 committer：<a
                                 href="mailto:piso@FreeBSD.org">Paolo Pisati</a>
                (src)。 前 SoC2005 项目成员。</title>
 
             <p><a href="mailto:piso@FreeBSD.org">Paolo Pisati</a>，
 	      去年 Summer of Code 计划的获选学生， 仍在继续参加 FreeBSD Project
 	      并成为了正式的 src/ committer。</p>
 
          </event>
       </day>
 
       <day>
 	<name>26</name>
 	<event>
 	  <title>对 FreeBSD 开发者 Poul-Henning Kamp 的 Podcast 访谈</title>
 
 	  <p>在最新的 <a href="http://bsdtalk.blogspot.com/">bsdtalk</a>
 	    podcast 中， Will Backman 就 FreeBSD 上的开发活动采访了 FreeBSD
 	    开发者 Poul-Henning Kamp。 这一 podcast 可以通过 <a
 	      href="http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk048.mp3">
 	    http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk048.mp3</a> 收听。</p>
 	</event>
       </day>
 
       <day>
         <name>25</name>
         <event>
          <title>FreeBSD 5.5-RELEASE 发布了</title>
 
           <p><a href="&enbase;/releases/5.5R/announce.html">FreeBSD
 	    5.5-RELEASE</a> 发布了。 请查看 <a
 	    href="&base;/releases/5.5R/errata.html">发行版勘误</a>
 	    以了解最新发生的新闻和已知问题。 <a
 	    href="&base;/releases/index.html">发行版信息</a>
 	    网页提供了关于 FreeBSD 发行版的进一步详情。</p>
         </event>
       </day>
 
       <day>
 	<name>21</name>
 	<event>
 	  <title>FreeBSD 能够在 Sun T1 处理器上独立运行了</title>
 
 	  <p>FreeBSD 目前已经能够在 <a
 	    href="http://www.sun.com/processors/UltraSPARC-T1/">采用 CoolThreads
 	      技术的 Sun T1 处理器</a> 的计算机上完整地完成
 	    "make buildworld" 命令， 从而达到了独立运行的目标。
 	    这些代码目前存放于 <a
 	    href="http://perforce.freebsd.org/branchView.cgi?BRANCH=kmacy%5fsun4v">
 	      FreeBSD 的 Perforce 版本控制系统</a> 中，
 	    并将在对逻辑域的支持功能完成之后合并回官方的 CVS 代码库。
 	    引导过程的日志文件可以在 <a
 	    href="http://www.fsmware.com/sun4v/dmesg_latest.txt">这里</a> 找到。</p>
 	</event>
       </day>
 
       <day>
          <name>17</name>
          <event>
             <p>新增 committer：<a
                                 href="mailto:twinterg@FreeBSD.org">Thomas Wintergerst</a>
                (src)</p>
          </event>
       </day>
 
       <day>
         <name>16</name>
 
         <event>
 	  <title>FreeBSD 5.5-RC1 发布了</title>
 
 	  <p>FreeBSD 5.5 的首个， 同时也有望成为最终的发行候选版本 <a
 	    href="http://lists.freebsd.org/pipermail/freebsd-stable/2006-May/025589.html">发布了</a>。
 	    RC1 ISO 映像文件， 已经可以从众多
 	    <a href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors-ftp.html">
 	    FreeBSD 镜像站点</a> 获得。</p>
         </event>
       </day>
 
       <day>
         <name>8</name>
         <event>
          <title>FreeBSD 6.1-RELEASE 发布了</title>
 
           <p><a href="&enbase;/releases/6.1R/announce.html">FreeBSD
 	    6.1-RELEASE</a> 正式发布了。 在安装前， 请查看 <a
 	    href="&base;/releases/6.1R/errata.html">发行版勘误</a>
 	    以了解关于 6.1 最新的消息和已知问题。 在 <a
 	    href="&base;/releases/index.html">发行版信息</a>
 	    页面上提供了关于 FreeBSD 发行版的进一步信息。</p>
         </event>
 
         <event>
 	  <title>Summer of Code 申请最后期限延长 1 天</title>
 
           <p>Google 的 <a
 	    href="http://code.google.com/summerofcode.html">Summer
             of Code 2006</a> 活动的申请最后期限已延长至太平洋时间周二
 	    11:00AM PDT。 关于 FreeBSD 专属项目以及候选导师的信息可以在 <a
             href="&enbase;/projects/summerofcode.html">here</a> 找到。</p>
         </event>
 
       </day>
 
       <day>
         <name>7</name>
         <event>
           <p>新增 committer：<a
             href="mailto:itetcu@FreeBSD.org">Ion-Mihai Tetcu</a>
             (ports)</p>
         </event>
       </day>
 
       <day>
 	<name>6</name>
 	<event>
 	  <p>新增 committer：<a
 	    href="mailto:stefan@FreeBSD.org">Stefan Walter</a>
 	    (ports)</p>
 	</event>
 
 	<event>
 	  <p>新增 committer：<a
 	    href="mailto:sat@FreeBSD.org">Andrew Pantyukhin</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
         <name>2</name>
 
         <event>
 	  <title>FreeBSD 6.1-RC2 发布了</title>
 
 	  <p>FreeBSD 6.1 的第二个， 也应该是最后一个候选发行版 <a
 	    href="http://lists.freebsd.org/pipermail/freebsd-hackers/2006-May/016386.html">发布了</a>。
 	    RC2 ISO 映像文件， 可以从众多
 	    <a href="http://www.FreeBSD.org/doc/zh_CN.UTF-8/books/handbook/mirrors-ftp.html">
 	    FreeBSD 镜像站点</a> 获得。</p>
         </event>
       </day>
 
       <day>
 	<name>1</name>
         <event>
 	  <title>开始接受 Summer of Code 项目申请</title>
 
           <p>FreeBSD Project 现在开始接受先前宣布的 Google <a
 	    href="http://code.google.com/summerofcode.html">Summer
             of Code 2006</a> 计划的项目申请。
             这个计划将为在暑期为开源项目提供帮助的学生提供资助。
             FreeBSD 专有的项目以及潜在的导师名单， 可以在 <a
             href="&enbase;/projects/summerofcode.html">这里</a> 找到。</p>
 
           <p>如果找到了合适的项目以及导师， 则有兴趣参与项目的学生应完成申请，
 	    并提交给 Google。 这些申请的最后期限是太平洋日光时间 2006 年
 	    5 月 8 日 17:00 (UTC 时间 2006 年 5 月 9 日午夜)。 获赝的候选人，
 	    将在五月下旬宣布。 请参见 <a
 	    href="http://code.google.com/soc/studentfaq.html">Student
 	    FAQ</a> 以了解进一步的信息。</p>
         </event>
 
         <event>
 	  <title>新增了用于 HighPoint RocketRAID 232x SATA RAID 控制器的驱动</title>
 
 	  <p>在 FreeBSD-CURRENT 以及 RELENG_6 和 RELENG_6_1 分支中，
 	    新增了 HighPoint 的 RocketRAID 232x 系列 SATA RAID 控制器驱动 rr232x(4)。
 	    这一驱动将包含在将发布的 FreeBSD 6.1-RELEASE 版本中。</p>
         </event>
 
 	<event>
 	  <p>commit 权限提升：<a
 	    href="mailto:delphij@FreeBSD.org">李鑫</a>
 	    (src, doc, ports)</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>4</name>
 
       <day>
 	<name>30</name>
 	<event>
 	  <p>新增 committer：<a
 	    href="mailto:lbr@FreeBSD.org">Lars Balker Rasmussen</a>
 	    (ports)</p>
 	</event>
       </day>
 
       <day>
 	<name>15</name>
 	<event>
 	  <title>对 FreeBSD 开发者 Joe Marcus Clarke 的 Podcast 访谈</title>
 
 	  <p>在最新的 <a href="http://bsdtalk.blogspot.com/">bsdtalk</a>
 	    podcast中， Will Backman 访问了 FreeBSD 开发者 Joe Marcus Clarke，
 	    讨论了与 FreeBSD 上的 GNOME 桌面环境有关的话题。 这一 podcast 可以从 <a
 	      href="http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk032.mp3">
 	    http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk032.mp3</a> 下载。</p>
 	</event>
       </day>
 
       <day>
         <name>14</name>
         <event>
 	  <title>2006 年一至三月进度报告</title>
 
 	  <p>现在可以访问包含 29 个项目的 2006 年一至三月 <a
 	    href="&enbase;/news/status/report-2006-01-2006-03.html">进度报告</a>
 	    了。</p>
         </event>
 
         <event>
           <title>Summer of Code</title>
 
           <p>FreeBSD Project 愉快地参加了 Google 的
             <a href="http://code.google.com/summerofcode.html">Summer
             of Code 2006</a> 计划。 这一计划将为在校生参与开源项目提供资助。
             FreeBSD 专属的计划和导师候选人可以在 <a
             href="&enbase;/projects/summerofcode.html">这里</a> 访问。</p>
 	</event>
      </day>
 
       <day>
         <name>13</name>
         <event>
 	  <title>FreeBSD 6.1-RC1 发布了</title>
 
 	  <p>FreeBSD 6.1 的第一个候选发行版 <a
 	    href="http://lists.freebsd.org/pipermail/freebsd-hackers/2006-April/016104.html">发布了</a>。
 	    RC1 的 ISO 映像文件可以从多数
 	    <a href="http://www.FreeBSD.org/doc/zh_CN.UTF-8/books/handbook/mirrors-ftp.html">
 	    FreeBSD 镜像站点</a> 获得。</p>
         </event>
       </day>
 
       <day>
         <name>11</name>
         <event>
 	  <title>新增了用于 Broadcom NetXtreme II 千兆以太网芯片的驱动</title>
 
 	  <p>在 FreeBSD-CURRENT 中新增了 bce(4)， 一个用于
 	    Broadcom NetXtreme II 系列千兆以太网控制芯片的驱动。
 	    这一驱动将很快合并至 FreeBSD 6-STABLE 分支。</p>
         </event>
       </day>
 
       <day>
         <name>6</name>
         <event>
 	  <title>FreeBSD 基金会宣布用于 FreeBSD 的预编译版本 Java JDK 和 JRE 1.5</title>
 
 	  <p>FreeBSD 基金会现在开始提供用于 FreeBSD 的预编译版本 Java JDK 和 JRE
 	    1.5。 更多细节， 请参见
 	    FreeBSD 基金会的 <a
 	    href="http://www.freebsdfoundation.org/press/20060405-PRrelease.shtml">
 	      新闻稿</a>。</p>
         </event>
       </day>
 
       <day>
         <name>4</name>
         <event>
           <p>新增 committer：<a
             href="mailto:alepulver@FreeBSD.org">Alejandro Pulver</a>
             (ports)</p>
         </event>
       </day>
 
       <day>
         <name>2</name>
         <event>
           <p>新增 committer：<a
             href="mailto:johans@FreeBSD.org">Johan van Selst</a>
             (ports)</p>
         </event>
       </day>
     </month>
 
     <month>
       <name>3</name>
 
       <day>
         <name>31</name>
         <event>
           <p>新增 committer：<a
             href="mailto:jmelo@FreeBSD.org">Jean Milanez Melo</a>
             (ports)</p>
         </event>
       </day>
 
       <day>
 	<name>15</name>
 	<event>
 	  <title>FreeBSD 5.5-BETA4 和 6.1-BETA4 发布了</title>
 
 	  <p>FreeBSD 5.5 和 FreeBSD 6.1 的第四个 beta 版本 <a
 	    href="http://lists.freebsd.org/pipermail/freebsd-hackers/2006-March/015730.html">发布了</a>。
 	    这些 BETA4 ISO 映像文件， 可以在多数
 	    <a href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors-ftp.html">
 	    FreeBSD 镜像站点</a> 上获得。</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>2</name>
 
       <day>
 	<name>22</name>
 	<event>
           <p>新增 committer： <a
             href="mailto:wkoszek@FreeBSD.org">Wojciech A. Koszek</a>
             (src)</p>
 	</event>
       </day>
 
       <day>
 	<name>20</name>
 	<event>
 	  <title>FreeBSD 5.5-BETA2 和 6.1-BETA2 发布了</title>
 
 	  <p>FreeBSD 5.5 和 FreeBSD 6.1 的第二个 BETA 版本现在 <a
 	    href="http://lists.freebsd.org/pipermail/freebsd-hackers/2006-February/015499.html">可用了</a>。
 	    对应的 BETA2 ISO 镜像文件可以从众多
 	    <a href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors-ftp.html">
 	    FreeBSD 镜像站点</a> 之一下载。</p>
 	</event>
       </day>
 
       <day>
 	<name>18</name>
 	<event>
 	  <title>对 FreeBSD 开发者 Kirk McKusick 的 Podcast 访谈</title>
 
 	  <p>在最新的 <a href="http://bsdtalk.blogspot.com/">bsdtalk</a>
 	    podcast 中， Will Backman 访问了 FreeBSD 开发者 Marshall Kirk
 	    McKusick。 这一 podcast 可以从 <a
 	    href="http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk018.mp3">
 	    http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk018.mp3</a>
 	    下载。</p>
 	</event>
       </day>
 
       <day>
 	<name>17</name>
 	<event>
 	  <title>对 FreeBSD 交付工程师 Scott Long 的 Podcast 访谈</title>
 
   	  <p>在 <a href="http://bsdtalk.blogspot.com/">bsdtalk</a>
 	    系列 podcast 的第 17 期中， Will Backman 访问了 FreeBSD 交付工程师
 	    Scott Long， 并就正在开发的 FreeBSD 5.5 和 6.1 版本，
 	    以及一些相关话题进行了讨论。 这一 podcast 可以从 <a
 	    href="http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk017.mp3">
 	    http://cisx1.uma.maine.edu/~wbackman/bsdtalk/bsdtalk017.mp3</a>
 	    下载。
 	    </p>
 	</event>
       </day>
 
       <day>
 	<name>13</name>
         <event>
           <p>新增 committer：<a
             href="mailto:cel@FreeBSD.org">Chuck Lever</a>
             (src)</p>
         </event>
 
 	<event>
 	  <title>即将进行的晚间 FreeBSD 内核代码导读课程</title>
 
 	  <p>在 2006 年春季将举办 “FreeBSD Kernel Internals: An Intensive Code
 	    Walkthrough” 课程。 这一课程将在具有历史意义的 Hillside Club
 	    进行， 其地址是 2286 Cedar Strett, Berkeley, CA 94709，
 	    从伯克利校园出发向北三个街区即可到达。 课程从 2 月 22 日周三开始，
 	    到 6 月 13 日结束， 每周一次， 从 6:30PM 到
 	    9:45PM。 您可以从 <a
 	    href="http://www.mckusick.com/courses/adveveclass.html">这里</a>
 	    了解参加这一培训班的详情。</p>
         </event>
       </day>
 
       <day>
 	<name>9</name>
 	<event>
 	  <title>FreeBSD 5.5-BETA1 和 6.1-BETA1 发布了</title>
 
 	  <p>FreeBSD 5.5 和 FreeBSD 6.1 的首个 BETA 版本现在 <a
 	    href="http://lists.freebsd.org/pipermail/freebsd-hackers/2006-February/015418.html">可用</a> 了。
 	    对应的 BETA1 ISO 镜像可以从许多
 	    <a href="http://www.FreeBSD.org/doc/zh_CN.UTF-8/books/handbook/mirrors-ftp.html">
 	    FreeBSD 镜像站点</a> 之一下载。</p>
 	</event>
       </day>
     </month>
 
     <month>
       <name>1</name>
 
       <day>
         <name>31</name>
         <event>
           <p>commit 权限提升：<a
             href="mailto:cperciva@FreeBSD.org">Colin Percival</a>
             (src, ports)</p>
         </event>
       </day>
 
       <day>
         <name>26</name>
         <event>
 	  <title>2005 年十至十二月进度报告</title>
 
 	  <p>现在可以访问包含 26 个项目的 2005 年十至十二月 <a
 	    href="&enbase;/news/status/report-2005-10-2005-12.html">进度报告</a>
 	    了。</p>
         </event>
       </day>
       <day>
         <name>19</name>
         <event>
           <p>新增 committer：<a
             href="mailto:matteo@FreeBSD.org">Matteo Riondato</a>
             (src)</p>
         </event>
 
         <event>
           <p>新增 committer：<a
             href="mailto:vd@FreeBSD.org">Vasil Dimov</a>
             (ports)</p>
         </event>
       </day>
 
       <day>
         <name>16</name>
         <event>
           <p>新增 committer：<a
             href="mailto:rink@FreeBSD.org">Rink Springer</a>
             (src)</p>
         </event>
       </day>
     </month>
   </year>
 
 </news>
diff --git a/zh_CN.UTF-8/share/xml/release.l10n.ent b/zh_CN.UTF-8/share/xml/release.l10n.ent
index 9b27bc05ef..cd2a1df9f2 100644
--- a/zh_CN.UTF-8/share/xml/release.l10n.ent
+++ b/zh_CN.UTF-8/share/xml/release.l10n.ent
@@ -1,196 +1,196 @@
 <?xml version="1.0" encoding="utf-8"?>
 
 <!--
     $FreeBSD$
-    Original revision: r54605
+    Original Revision: c2e32c6a50 (r54605)
 -->
 
 <![%beta2.testing;[
 <!ENTITY beta.second '
     <div xmlns="http://www.w3.org/1999/xhtml">
       <h1>&os; &betarel2.current;-&betarel2.vers;</h1>
 
       <table class="tblbasic tblwide tbldownload">
 	<tbody>
 	  <tr>
 	    <th>安装程序映像</th>
 	    <th>虚拟机映像</th>
 	    <th>SD 卡映像</th>
 	    <th>文档</th>
 	  </tr>
 	  <tr>
 	    <td>
 	      <ul class="txtdownloadlist">
 		<li><a href="&url.rel;/amd64/amd64/ISO-IMAGES/&betarel2.current;/">amd64</a></li>
 		<li><a href="&url.rel;/i386/i386/ISO-IMAGES/&betarel2.current;/">i386</a></li>
 		<li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&betarel2.current;/">armv6</a></li>
 		<li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel2.current;/">armv7</a></li>
 		<li><a href="&url.rel;/arm64/aarch64/ISO-IMAGES/&betarel2.current;/">arm64</a></li>
 		<li><a href="&url.rel;/powerpc/powerpc/ISO-IMAGES/&betarel2.current;/">powerpc</a></li>
 		<li><a href="&url.rel;/powerpc/powerpc64/ISO-IMAGES/&betarel2.current;/">powerpc64</a></li>
 		<li><a href="&url.rel;/powerpc/powerpcspe/ISO-IMAGES/&betarel2.current;/">powerpcspe</a></li>
 		<li><a href="&url.rel;/sparc64/sparc64/ISO-IMAGES/&betarel2.current;/">sparc64</a></li>
 	      </ul>
 	    </td>
 	    <td>
 	      <ul class="txtdownloadlist">
 		<li><a href="&url.rel;/VM-IMAGES/README.txt">README</a></li>
 		<li><a href="&url.rel;/VM-IMAGES/&betarel2.current;-&betarel2.vers;/amd64/Latest/">amd64</a></li>
 		<li><a href="&url.rel;/VM-IMAGES/&betarel2.current;-&betarel2.vers;/i386/Latest/">i386</a></li>
 		<li><a href="&url.rel;/VM-IMAGES/&betarel2.current;-&betarel2.vers;/aarch64/Latest/">aarch64</a></li>
 	      </ul>
 	    </td>
 	    <td>
 	      <ul class="txtdownloadlist">
 		<li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm-armv6-RPI-B.img.xz">RPI-B</a></li>
 		<li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm-armv7-BANANAPI.img.xz">BANANAPI</a></li>
 		<li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm-armv7-BEAGLEBONE.img.xz">BEAGLEBONE</a></li>
 		<li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm-armv7-CUBIEBOARD.img.xz">CUBIEBOARD</a></li>
 		<li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm-armv7-CUBIEBOARD2.img.xz">CUBIEBOARD2</a></li>
 		<li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm-armv7-CUBOX-HUMMINGBOARD.img.xz">CUBOX-HUMMINGBOARD</a></li>
 		<li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm-armv7-RPI2.img.xz">RPI2</a></li>
 		<li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm-armv7-PANDABOARD.img.xz">PANDABOARD</a></li>
 		<li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm-armv7-WANDBOARD.img.xz">WANDBOARD</a></li>
 		<li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm-armv7-GENERICSD.img.xz">GENERICSD</a></li>
 		<li><a href="&url.rel;/arm64/aarch64/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm64-aarch64-GENERIC.img.xz">GENERIC</a></li>
 		<li><a href="&url.rel;/arm64/aarch64/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm64-aarch64-RPI3.img.xz">RPI3</a></li>
 		<li><a href="&url.rel;/arm64/aarch64/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm64-aarch64-PINE64.img.xz">PINE64</a></li>
 		<li><a href="&url.rel;/arm64/aarch64/ISO-IMAGES/&betarel2.current;/&os;-&betarel2.current;-&betarel2.vers;-arm64-aarch64-PINE64-LTS.img.xz">PINE64-LTS</a></li>
 	      </ul>
 	    </td>
 	    <td>
 	      <ul class="txtdocslist">
 		<li><a href="&enbase;/releases/&betarel2.current;R/relnotes.html">发行公告</a></li>
 		<li><a href="&enbase;/releases/&betarel2.current;R/readme.html">自述文件</a></li>
 		<li><a href="&enbase;/releases/&betarel2.current;R/hardware.html">硬件兼容性列表</a></li>
 		<?ignore
 		<li><a href="&enbase;/releases/&betarel2.current;R/installation.html">安装说明</a></li>
 		?>
 		<?ignore
 		<li><a href="&enbase;/releases/&betarel2.current;R/todo.html">TODO List</a></li>
 		?>
 		<li><a href="&enbase;/releases/&betarel2.current;R/signatures.html">已签名校验和</a></li>
 	      </ul>
 	    </td>
 	  </tr>
 	</tbody>
       </table>
       <br />
     </div>
 '>
 ]]>
 <!ENTITY beta.second ''>
 
 
 <![%beta.testing;[
 <!ENTITY beta.desc '
   <div xmlns="http://www.w3.org/1999/xhtml">
     &beta.helptest;
 
     <h1>&os; &betarel.current;-&betarel.vers;</h1>
 
     <table class="tblbasic tblwide tbldownload">
       <tbody>
 	<tr>
 	  <th>安装程序映像</th>
 	  <th>虚拟机映像</th>
 	  <th>SD 卡映像</th>
 	  <th>文档</th>
 	</tr>
 	<tr>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.rel;/amd64/amd64/ISO-IMAGES/&betarel.current;/">amd64</a></li>
 	      <li><a href="&url.rel;/i386/i386/ISO-IMAGES/&betarel.current;/">i386</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&betarel.current;/">armv6</a></li>
 	      <li><a href="&url.rel;/arm64/aarch64/ISO-IMAGES/&betarel.current;/">aarch64</a></li>
 	      <li><a href="&url.rel;/powerpc/powerpc/ISO-IMAGES/&betarel.current;/">powerpc</a></li>
 	      <li><a href="&url.rel;/powerpc/powerpc64/ISO-IMAGES/&betarel.current;/">powerpc64</a></li>
 	      <li><a href="&url.rel;/powerpc/powerpcspe/ISO-IMAGES/&betarel.current;/">powerpcspe</a></li>
 	      <li><a href="&url.rel;/sparc64/sparc64/ISO-IMAGES/&betarel.current;/">sparc64</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.rel;/VM-IMAGES/README.txt">README</a></li>
 	      <li><a href="&url.rel;/VM-IMAGES/&betarel.current;-&betarel.vers;/amd64/Latest/">amd64</a></li>
 	      <li><a href="&url.rel;/VM-IMAGES/&betarel.current;-&betarel.vers;/i386/Latest/">i386</a></li>
 	      <li><a href="&url.rel;/VM-IMAGES/&betarel.current;-&betarel.vers;/aarch64/Latest/">aarch64</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdownloadlist">
 	      <li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm-armv7-BANANAPI.img.xz">BANANAPI</a></li>
 		  <?ignore
 	      <li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm-armv7-BEAGLEBONE.img.xz">BEAGLEBONE</a></li>
 		  ?>
 	      <li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm-armv7-CUBIEBOARD.img.xz">CUBIEBOARD</a></li>
 	      <li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm-armv7-GENERICSD.img.xz">GENERICSD</a></li>
 	      <li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm-armv7-CUBIEBOARD2.img.xz">CUBIEBOARD2</a></li>
 	      <li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm-armv7-CUBOX-HUMMINGBOARD.img.xz">CUBOX/HUMMINGBOARD</a></li>
 	      <li><a href="&url.rel;/arm/armv6/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm-armv6-RPI-B.img.xz">RPI-B</a></li>
 	      <li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm-armv7-RPI2.img.xz">RPI2</a></li>
 	      <li><a href="&url.rel;/arm/armv7/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm-armv7-WANDBOARD.img.xz">WANDBOARD</a></li>
 	      <li><a href="&url.rel;/arm64/aarch64/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm64-aarch64-GENERIC.img.xz">GENERIC</a></li>
 	      <li><a href="&url.rel;/arm64/aarch64/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm64-aarch64-RPI3.img.xz">RPI3</a></li>
 	      <li><a href="&url.rel;/arm64/aarch64/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm64-aarch64-PINE64.img.xz">PINE64</a></li>
 	      <li><a href="&url.rel;/arm64/aarch64/ISO-IMAGES/&betarel.current;/&os;-&betarel.current;-&betarel.vers;-arm64-aarch64-PINE64-LTS.img.xz">PINE64-LTS</a></li>
 	    </ul>
 	  </td>
 	  <td>
 	    <ul class="txtdocslist">
 	      <li><a href="&enbase;/releases/&betarel.current;R/relnotes.html">发行公告</a></li>
 	      <?ignore
 	      <li><a href="&enbase;/releases/&betarel.current;R/readme.html">自述文件</a></li>
 	      <li><a href="&enbase;/releases/&betarel.current;R/installation.html">安装说明</a></li>
 	      <li><a href="&enbase;/releases/&betarel.current;R/todo.html">TODO List</a></li>
 		  <li><a href="&enbase;/releases/&betarel.current;R/hardware.html">硬件兼容性列表</a></li>
 	      ?>
 	      <li><a href="&enbase;/releases/&betarel.current;R/signatures.html">已签名校验和</a></li>
 	    </ul>
 	  </td>
 	</tr>
       </tbody>
     </table>
     <br />
 
     &beta.second;
   </div>
 '>
 ]]>
 
 <!ENTITY beta.desc ''>
 
 <!ENTITY beta.helptest '
   <div xmlns="http://www.w3.org/1999/xhtml">
     <a name="helptest"></a>
     <h1>为即将发布的 FreeBSD 版本提供帮助</h1>
 
     <p>我们的开发人员和发布工程师正在为 FreeBSD
       接下来的版本努力工作； 如果您希望帮助进行测试， 请下载最新构建的版本。
       请注意， 这些映像是用于测试目的提供的， 因此不应在生产环境中使用。</p>
   </div>
 '>
 
 <![%beta.local.where;[
 <!ENTITY beta.local.where '
   <div xmlns="http://www.w3.org/1999/xhtml">
     &beta.helptest;
     <p>可以在 <a
 	href="&base;/where.html#helptest">下载页面</a> 获取可用的安装映像。</p>
   </div>
 '>
 ]]>
 
 <![%beta2.local.where;[
 <!ENTITY beta2.local.where '
   <div xmlns="http://www.w3.org/1999/xhtml">
     &beta.helptest;
     <p>可以在 <a
 	href="&base;/where.html#helptest">下载页面</a> 获取可用的安装映像。</p>
   </div>
 '>
 ]]>
 
 <!ENTITY beta.local.where ''>
 <!ENTITY beta2.local.where ''>
diff --git a/zh_CN.UTF-8/share/xml/trademarks.ent b/zh_CN.UTF-8/share/xml/trademarks.ent
index 81ee03e405..3eb0376cc1 100644
--- a/zh_CN.UTF-8/share/xml/trademarks.ent
+++ b/zh_CN.UTF-8/share/xml/trademarks.ent
@@ -1,587 +1,587 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
      Trademark Legend, as required by The Open Group, Sun, etc..
 
      This file contains entities with trademark attributions for all
      the companies the FreeBSD documentation references.  It also
      contains entities for common products with proper trademark
      symbols.
 
      Please keep this file sorted.
 
      $FreeBSD$
-     Original revision: r52500
+     Original Revision: 5523ddf0c6 (r52500)
 -->
 
 <!ENTITY tm-attrib.3com "<para xmlns='http://docbook.org/ns/docbook'>3Com 和 HomeConnect 是
   3Com Corporation 的注册商标。</para>">
 <!-- An XML entity can't start with a number... -->
 <!ENTITY tm.3com "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>3Com</trademark>">
 
 <!ENTITY tm-attrib.3ware "<para xmlns='http://docbook.org/ns/docbook'>3ware 是 3ware Inc 的注册商标。</para>">
 <!ENTITY tm.3ware "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>3ware</trademark>">
 
 <!-- http://www.adaptec.com/worldwide/company/compeditorial.html?prodkey=legal_copyright -->
 <!ENTITY tm-attrib.adaptec "<para xmlns='http://docbook.org/ns/docbook'>Adaptec 是
   Adaptec, Inc. 的注册商标。</para>">
 <!ENTITY adaptec "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Adaptec</trademark>">
 
 <!ENTITY tm-attrib.adobe "<para xmlns='http://docbook.org/ns/docbook'>Adobe、 Acrobat、 Acrobat Reader、 Flash， 以及
   PostScript 是 Adobe
   Systems Incorporated 在美国和/或其他国家的商标或注册商标。</para>">
 <!ENTITY acrobat "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Acrobat</trademark>">
 <!ENTITY acrobat.reader "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Acrobat&nbsp;Reader</trademark>">
 <!ENTITY adobe "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Adobe</trademark>">
 <!ENTITY flash "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Flash</trademark>">
 <!ENTITY postscript "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>PostScript</trademark>">
 
 <!-- http://www.amd.com/us-en/Trademarkinformation/0,,1435_1442,00.html -->
 <!ENTITY tm-attrib.amd "<para xmlns='http://docbook.org/ns/docbook'>AMD, AMD Athlon,
   AMD Opteron, AMD Phenom, AMD Sempron, AMD Turion, Athlon, &Eacute;lan, Opteron, 和 PCnet 是
   Advanced Micro Devices, Inc. 的商标。</para>">
 <!ENTITY amd "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>AMD</trademark>">
 <!ENTITY am486 "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Am486</trademark>">
 <!ENTITY am5x86 "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Am5x86</trademark>">
 <!ENTITY amd.athlon "<trademark xmlns='http://docbook.org/ns/docbook'>AMD&nbsp;Athlon</trademark>">
 <!ENTITY amd.duron "<trademark xmlns='http://docbook.org/ns/docbook'>AMD&nbsp;Duron</trademark>">
 <!ENTITY amd.k6 "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>AMD-K6</trademark>">
 <!ENTITY amd.opteron "<trademark xmlns='http://docbook.org/ns/docbook'>AMD&nbsp;Opteron</trademark>">
 <!ENTITY amd.phenom "<trademark xmlns='http://docbook.org/ns/docbook'>AMD&nbsp;Phenom</trademark>">
 <!ENTITY amd.sempron "<trademark xmlns='http://docbook.org/ns/docbook'>AMD&nbsp;Sempron</trademark>">
 <!ENTITY amd.turion "<trademark xmlns='http://docbook.org/ns/docbook'>AMD&nbsp;Turion</trademark>">
 <!ENTITY athlon "<trademark xmlns='http://docbook.org/ns/docbook'>Athlon</trademark>">
 <!ENTITY elan "<trademark xmlns='http://docbook.org/ns/docbook'>&Eacute;lan</trademark>">
 <!ENTITY opteron "<trademark xmlns='http://docbook.org/ns/docbook'>Opteron</trademark>">
 
 <!-- http://www.apple.com/legal/trademark/appletmlist.html -->
 <!ENTITY tm-attrib.apple "<para xmlns='http://docbook.org/ns/docbook'>Apple, AirPort, FireWire,
   iMac, iPhone, iPad,
   Mac, Macintosh, Mac OS,
   Quicktime, 以及 TrueType 是 Apple Inc. 在美国以及其他国家的注册商标。</para>">
 <!ENTITY airport "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>AirPort</trademark>">
 <!ENTITY apple "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Apple</trademark>">
 <!ENTITY firewire "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>FireWire</trademark>">
 <!ENTITY imac "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>iMac</trademark>">
 <!ENTITY ipad "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>iPad</trademark>">
 <!ENTITY iphone "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>iPhone</trademark>">
 <!ENTITY mac "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Mac</trademark>">
 <!ENTITY macintosh "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Macintosh</trademark>">
 <!ENTITY macos "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Mac&nbsp;OS</trademark>">
 <!ENTITY quicktime "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Quicktime</trademark>">
 <!ENTITY truetype "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>TrueType</trademark>">
 
 <!ENTITY tm-attrib.arm "<para xmlns='http://docbook.org/ns/docbook'>ARM 是 ARM
   Limited. 的注册商标。</para>">
 <!ENTITY arm "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>ARM</trademark>">
 
 <!-- http://www.bluetooth.com/sig/trademark.use.asp -->
 <!ENTITY bluetooth "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Bluetooth</trademark>">
 
 <!ENTITY tm-attrib.cisco "<para xmlns='http://docbook.org/ns/docbook'>Cisco, Catalyst, 和 IOS
   是 Cisco Systems, Inc. 和/或其附属机构在美国和一些其他国家的注册商标。</para>">
 <!ENTITY cisco "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Cisco</trademark>">
 <!ENTITY catalyst "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Catalyst</trademark>">
 <!ENTITY etherchannel "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>EtherChannel</trademark>">
 <!ENTITY ios "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>IOS</trademark>">
 
 <!ENTITY tm-attrib.corel "<para xmlns='http://docbook.org/ns/docbook'>Corel 和 WordPerfect 是
   Corel Corporation 和/或其子公司 在加拿大、美国和/或其他国家的注册商标。</para>">
 <!ENTITY wordperfect "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>WordPerfect</trademark>">
 
 <!-- http://www.coverity.com/html/press_story45_07_25_07.html -->
 <!ENTITY tm-attrib.coverity "<para xmlns='http://docbook.org/ns/docbook'>Coverity 是一个注册商标;
 Coverity Extend， Coverity Prevent 和 Coverity Prevent SQS 是 Coverity 公司的注册商标。</para>">
 <!ENTITY coverity "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Coverity</trademark>">
 <!ENTITY coverity.prevent "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Coverity Prevent</trademark>">
 
 <!-- http://www.creative.com/legal.asp -->
 <!ENTITY tm-attrib.creative "<para xmlns='http://docbook.org/ns/docbook'>Sound Blaster 是
   Creative Technology Ltd. 在美国和/或其他国家的注册商标。</para>">
 <!ENTITY soundblaster "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>SoundBlaster</trademark>">
 
 <!-- http://www.cvsup.org/ -->
 <!ENTITY tm-attrib.cvsup "<para xmlns='http://docbook.org/ns/docbook'>CVSup 是
   John D. Polstra 的注册商标。</para>">
 
 <!-- http://www.dell.com/us/en/gen/misc/policy_007_policy.htm -->
 <!ENTITY dell "<trademark xmlns='http://docbook.org/ns/docbook'>Dell</trademark>">
 <!ENTITY poweredge "<trademark xmlns='http://docbook.org/ns/docbook'>PowerEdge</trademark>">
 
 <!-- http://www.epson.com/cgi-bin/Store/AboutTrademarkInfo.jsp -->
 <!ENTITY epson.perfection "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>EPSON
   Perfection</trademark>">
 
 <!ENTITY tm-attrib.freebsd "<para xmlns='http://docbook.org/ns/docbook'>FreeBSD 是 FreeBSD 基金会的注册商标</para>">
 
 <!-- http://www.fpc.fujitsu.com/www/content/legal_resources/trademarks.php -->
 <!ENTITY tm-attrib.fujitsu "<para xmlns='http://docbook.org/ns/docbook'>Fujitsu, Fujitsu 商标, LifeBook,
   Stylistic, PRIMEPOWER, PRIMEQUEST, PRIMECLUSTER, ETERNUS, TRIOLE,
   ESPRIMO, BioMedCAChe, CAChe, CELLINJECTOR, isS, Materials Explorer,
   SystemWalker, 以及 Interstage 是 Fujitsu Limited
   在美国和其他国家的商标或注册商标。</para>">
 <!ENTITY fujitsu "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Fujitsu</trademark>">
 <!ENTITY primepower "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>PRIMEPOWER</trademark>">
 
 <!-- http://www.google.com/permissions/trademark/our-trademarks.html -->
 <!ENTITY tm-attrib.google "<para xmlns='http://docbook.org/ns/docbook'>Android
   是 Google Inc 的注册商标。</para>">
 <!ENTITY android "<trademark xmlns='http://docbook.org/ns/docbook'>Android</trademark>">
 
 <!-- http://www.heidelberg.com/hq/eng/small_print/trademarks.asp -->
 <!ENTITY tm-attrib.heidelberger "<para xmlns='http://docbook.org/ns/docbook'>Heidelberg、 Helvetica、
   Palatino 以及 Times Roman 是 Heidelberger Druckmaschinen AG
   在美国和其他国家的商标或注册商标。</para>">
 
 <!ENTITY tm-attrib.ibm "<para xmlns='http://docbook.org/ns/docbook'>IBM、 AIX、 OS/2、
   PowerPC、 PS/2、 S/390 以及 ThinkPad
   是国际商用机器公司在美国和其他国家的注册商标或商标。</para>">
 <!ENTITY aix "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>AIX</trademark>">
 <!ENTITY os2 "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>OS/2</trademark>">
 <!ENTITY power "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>POWER</trademark>">
 <!ENTITY powerpc "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>PowerPC</trademark>">
 <!ENTITY ps2 "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>PS/2</trademark>">
 <!ENTITY s390 "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>S/390</trademark>">
 <!ENTITY thinkpad "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>ThinkPad</trademark>">
 
 <!ENTITY tm-attrib.ieee "<para xmlns='http://docbook.org/ns/docbook'>IEEE, POSIX, 和 802 是 Institute of Electrical and Electronics Engineers,
   Inc. 在美国的注册商标。</para>">
 <!ENTITY ieee "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>IEEE</trademark>">
 <!ENTITY posix "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>POSIX</trademark>">
 
 <!-- http://www.intel.com/intel/legal/tmnouns2.htm -->
 <!ENTITY tm-attrib.intel "<para xmlns='http://docbook.org/ns/docbook'>Intel, Celeron, Centrino, Core, EtherExpress, i386,
   i486, Itanium, Pentium, 和 Xeon 是 Intel Corporation
   及其分支机构在美国和其他国家的商标或注册商标。</para>">
 <!ENTITY celeron "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Celeron</trademark>">
 <!ENTITY centrino "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Centrino</trademark>">
 <!ENTITY core "<trademark xmlns='http://docbook.org/ns/docbook'>Core</trademark>">
 <!ENTITY etherexpress "<trademark xmlns='http://docbook.org/ns/docbook'>EtherExpress</trademark>">
 <!ENTITY i386 "<trademark xmlns='http://docbook.org/ns/docbook'>i386</trademark>">
 <!ENTITY i486 "<trademark xmlns='http://docbook.org/ns/docbook'>i486</trademark>">
 <!ENTITY intel "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Intel</trademark>">
 <!ENTITY itanium "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Itanium</trademark>">
 <!ENTITY pentium "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Pentium</trademark>">
 <!ENTITY xeon "<trademark xmlns='http://docbook.org/ns/docbook'>Xeon</trademark>">
 
 <!-- http://www.quicken.com/support/trademark/ -->
 <!ENTITY tm-attrib.intuit "<para xmlns='http://docbook.org/ns/docbook'>Intuit 和 Quicken 是 Intuit Inc., 或其子公司在美国和其他国家的商标或注册商标。</para>">
 
 
 
 <!ENTITY tm-attrib.iomega "<para xmlns='http://docbook.org/ns/docbook'>Iomega, Zip, 和 Jaz 是 Iomega Corporation
   在美国和/或其他国家的商标或注册商标。</para>">
 <!ENTITY iomegazip "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Zip</trademark>">
 <!ENTITY jaz "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Jaz</trademark>">
 
 <!ENTITY tm-attrib.lantronix "<para xmlns='http://docbook.org/ns/docbook'>Lantronix 和 EasyIO 是 Lantronix Corporation 的商标。</para>">
 <!ENTITY easyio "<trademark xmlns='http://docbook.org/ns/docbook'>EasyIO</trademark>">
 
 <!-- http://www.linuxmark.org/ -->
 <!ENTITY tm-attrib.linux "<para xmlns='http://docbook.org/ns/docbook'>Linux 是 Linus Torvalds 的注册商标。</para>">
 
 <!ENTITY linux "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Linux</trademark>">
 
 <!-- http://www.lsilogic.com/trademrk.html -->
 <!ENTITY tm-attrib.lsilogic "<para xmlns='http://docbook.org/ns/docbook'>LSI Logic, AcceleRAID, eXtremeRAID,
   MegaRAID 和 Mylex 是 LSI
   Logic Corp 的商标或注册商标。</para>">
 <!ENTITY acceleraid "<trademark xmlns='http://docbook.org/ns/docbook'>AcceleRAID</trademark>">
 <!ENTITY megaraid "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>MegaRAID</trademark>">
 <!ENTITY mylex "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Mylex</trademark>">
 
 <!-- These two are no longer used in the en_US documentation, but need
   leaving until translations stop using them -->
 <!ENTITY tm-attrib.macromedia "<para xmlns='http://docbook.org/ns/docbook'>Macromedia, Flash, 以及 Shockwave
   Macromedia, Inc. 在美国和/或其他国家的商标或注册商标。</para>">
 <!ENTITY flash "<trademark xmlns='http://docbook.org/ns/docbook'>Flash</trademark>">
 <!ENTITY macromedia "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Macromedia</trademark>">
 
 <!ENTITY tm-attrib.microsoft "<para xmlns='http://docbook.org/ns/docbook'>Microsoft, IntelliMouse, MS-DOS,
   Outlook, Windows, Windows Media, 和 Windows NT 是 Microsoft Corporation
   在美国和/或其他国家的商标或注册商标。</para>">
 <!ENTITY intellimouse "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>IntelliMouse</trademark>">
 <!ENTITY microsoft "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Microsoft</trademark>">
 <!ENTITY microsoft.windows "&microsoft;&nbsp;&windows;">
 <!ENTITY ms-dos "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>MS-DOS</trademark>">
 <!ENTITY outlook "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Outlook</trademark>">
 <!ENTITY windows "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Windows</trademark>">
 <!ENTITY windows.media "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Windows Media</trademark>">
 <!ENTITY windows2k "&windows; 2000">
 <!ENTITY windowsnt "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Windows NT</trademark>">
 <!ENTITY windowsxp "&windows; XP">
 
 <!ENTITY tm-attrib.mips "<para xmlns='http://docbook.org/ns/docbook'>MIPS 和 R4000 是 MIPS Technologies, Inc.
   在美国以及其他国家的注册商标。</para>">
 <!ENTITY mips "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>MIPS</trademark>">
 
 <!-- http://www.mysql.com/company/trademark.html -->
 <!ENTITY mysql "<trademark xmlns='http://docbook.org/ns/docbook'>MySQL</trademark>">
 
 <!-- http://www.m-sys.com/content/LegalTerms.asp -->
 <!ENTITY tm-attrib.m-systems "<para xmlns='http://docbook.org/ns/docbook'>M-Systems 和 DiskOnChip 是 M-Systems Flash Disk
   Pioneers, Ltd. 的商标或注册商标。</para>">
 <!ENTITY diskonchip "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>DiskOnChip</trademark>">
 
 <!-- http://www.netbsd.org/Misc/about.html, ack'd by http://www.uspto.gov/ -->
 <!ENTITY tm-attrib.netbsd "<para xmlns='http://docbook.org/ns/docbook'>NetBSD是 NetBSD Foundation的注册商标。</para>">
 
 <!ENTITY tm-attrib.netscape "<para xmlns='http://docbook.org/ns/docbook'>Netscape 以及 Netscape Navigator
   是 Netscape Communications Corporation 在美国和其他国家的注册商标。</para>">
 <!ENTITY netscape "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Netscape</trademark>">
 <!ENTITY netscape.navigator "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Netscape Navigator</trademark>">
 
 <!-- These two are no longer used in the en_US documentation, but need
   leaving until translations stop using them -->
 <!-- http://www.nexthop.com/legal.shtml -->
 <!ENTITY tm-attrib.nexthop "<para xmlns='http://docbook.org/ns/docbook'>GateD 和 NextHop 是 NextHop 在美国和其他国家的商标或注册商标。</para>">
 <!ENTITY gated "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>GateD</trademark>">
 
 <!ENTITY tm-attrib.opengroup "<para xmlns='http://docbook.org/ns/docbook'>Motif, OSF/1, 和 UNIX
   是 The Open Group 在美国和其他国家的注册商标； IT DialTone 和 The Open Group
   是其商标。</para>">
 <!ENTITY tm-attrib.unix "<para xmlns='http://docbook.org/ns/docbook'>UNIX是 Open Group
   在美国和其它国家的注册商标。</para>">
 <!ENTITY motif "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Motif</trademark>">
 <!ENTITY unix "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>UNIX</trademark>">
 
 <!-- http://www.oracle.com/html/trademark.html -->
 <!-- http://www.oracle.com/html/3party.html -->
 <!ENTITY tm-attrib.oracle "<para xmlns='http://docbook.org/ns/docbook'>Oracle 是 Oracle Corporation 的注册商标。</para>">
 <!ENTITY oracle "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Oracle</trademark>">
 
 <!-- http://www.powerquest.com/legal/ -->
 <!ENTITY tm-attrib.powerquest "<para xmlns='http://docbook.org/ns/docbook'>PowerQuest 和 PartitionMagic 是
   PowerQuest Corporation 在美国和/或其他国家的注册商标。</para>">
 <!ENTITY partitionmagic "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>PartitionMagic</trademark>">
 
 <!-- http://www.qualcomm.com/main/legal.html -->
 <!ENTITY tm-attrib.qualcomm "<para xmlns='http://docbook.org/ns/docbook'>QUALCOMM 和 Eudora 是 QUALCOMM Incorporated 的注册商标。</para>">
 <!ENTITY eudora "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Eudora</trademark>">
 
 <!-- http://www.realnetworks.com/company/logos/policy.html -->
 <!ENTITY tm-attrib.realnetworks "<para xmlns='http://docbook.org/ns/docbook'>RealNetworks, RealPlayer, 和
   RealAudio 是 RealNetworks, Inc. 的注册商标。</para>">
 <!ENTITY realplayer "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>RealPlayer</trademark>">
 
 <!-- Note: RedHat doesn't use (r)/(tm) for their own trademarks -->
 <!-- http://www.redhat.com/legal/legal_statement.html -->
 <!ENTITY tm-attrib.redhat "<para xmlns='http://docbook.org/ns/docbook'>Red Hat, RPM, 是 Red Hat, Inc.
   在美国和其他国家的注册商标。</para>">
 
 <!-- https://riscv.org/risc-v-trademark-usage/ -->
 <!ENTITY tm-attrib.risc-v "<para xmlns='http://docbook.org/ns/docbook'>“RISC-V” 商标名是 RISC-V
   基金会正在注册的注册商标。</para>">
 <!ENTITY risc-v "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>RISC-V</trademark>">
 
 <!-- These four are no longer used in the en_US documentation, but need
   leaving until translations stop using them -->
 <!ENTITY tm-attrib.sap "<para xmlns='http://docbook.org/ns/docbook'>SAP, R/3, 和 mySAP 是 SAP AG
   在德国以及许多其他国家的商标或注册商标。</para>">
 <!ENTITY r3 "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>R/3</trademark>">
 <!ENTITY sap "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>SAP</trademark>">
 <!ENTITY sap.r3 "&sap;&nbsp;&r3;">
 
 <!ENTITY tm-attrib.sgi "<para xmlns='http://docbook.org/ns/docbook'>Silicon Graphics, SGI, 和 OpenGL 是 Silicon Graphics, Inc.
   在美国和/或其他国家的注册商标。</para>">
 <!ENTITY opengl "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>OpenGL</trademark>">
 
 <!-- http://www.sparc.org/trademarksListing.html -->
 <!ENTITY tm-attrib.sparc "<para xmlns='http://docbook.org/ns/docbook'>SPARC、 SPARC64， 以及
   UltraSPARC 是 SPARC International, Inc 在美国和其他国家的商标。
   SPARC International, Inc 拥有所有
   SPARC 商标的相关权利，
   并以许可证形式允许其会员以适当形式使用这些商标。</para>">
 <!ENTITY sparc "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>SPARC</trademark>">
 <!ENTITY sparc64 "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>SPARC64</trademark>">
 <!ENTITY ultrasparc "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>UltraSPARC</trademark>">
 
 <!-- http://www.sun.com/suntrademarks/ -->
 
 <!ENTITY tm-attrib.sun "<para xmlns='http://docbook.org/ns/docbook'>Sun、 Sun Microsystems、 Java、 Java
   Virtual Machine、 JDK、 JRE、 JSP、 JVM、 Netra、 OpenJDK、
   Solaris、 StarOffice、 SunOS
   以及 VirtualBox 是 Sun Microsystems,
   Inc. 在美国和其他国家的商标或注册商标。</para>">
 <!ENTITY java "<trademark xmlns='http://docbook.org/ns/docbook'>Java</trademark>">
 <!ENTITY java.virtual.machine "<trademark xmlns='http://docbook.org/ns/docbook'>Java Virtual Machine</trademark>">
 <!ENTITY jdk "<trademark xmlns='http://docbook.org/ns/docbook'>JDK</trademark>">
 <!ENTITY jre "<trademark xmlns='http://docbook.org/ns/docbook'>JRE</trademark>">
 <!ENTITY jsp "<trademark xmlns='http://docbook.org/ns/docbook'>JSP</trademark>">
 <!ENTITY jvm "<trademark xmlns='http://docbook.org/ns/docbook'>JVM</trademark>">
 <!ENTITY netra "<trademark xmlns='http://docbook.org/ns/docbook'>Netra</trademark>">
 <!ENTITY openjdk "<trademark xmlns='http://docbook.org/ns/docbook'>OpenJDK</trademark>">
 <!ENTITY solaris "<trademark xmlns='http://docbook.org/ns/docbook'>Solaris</trademark>">
 <!ENTITY sparcengine "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>SPARCEngine</trademark>">
 <!ENTITY staroffice "<trademark xmlns='http://docbook.org/ns/docbook'>StarOffice</trademark>">
 <!ENTITY sun "<trademark xmlns='http://docbook.org/ns/docbook'>Sun</trademark>">
 <!ENTITY sun.blade "<trademark xmlns='http://docbook.org/ns/docbook'>Sun&nbsp;Blade</trademark>">
 <!ENTITY sun.enterprise "<trademark xmlns='http://docbook.org/ns/docbook'>Sun&nbsp;Enterprise</trademark>">
 <!ENTITY sun.fire "<trademark xmlns='http://docbook.org/ns/docbook'>Sun&nbsp;Fire</trademark>">
 <!ENTITY sun.ultra "Sun&nbsp;<trademark xmlns='http://docbook.org/ns/docbook'>Ultra</trademark>">
 <!ENTITY sunos "<trademark xmlns='http://docbook.org/ns/docbook'>SunOS</trademark>">
 <!ENTITY virtualbox "<trademark xmlns='http://docbook.org/ns/docbook'>VirtualBox</trademark>">
 
 <!-- http://www.symantec.com/legal/legal_note.html -->
 <!ENTITY tm-attrib.symantec "<para xmlns='http://docbook.org/ns/docbook'>Symantec 和 Ghost 是
   Symantec Corporation 在美国和其他国家的注册商标。</para>">
 
 <!-- http://www.mathworks.com/company/trademarks.shtml -->
 <!ENTITY tm-attrib.themathworks "<para xmlns='http://docbook.org/ns/docbook'>MATLAB 是
   The MathWorks, Inc. 的注册商标。</para>">
 <!ENTITY matlab "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>MATLAB</trademark>">
 
 <!ENTITY tm-attrib.thomson "<para xmlns='http://docbook.org/ns/docbook'>SpeedTouch 是 Thomson 的商标。</para>">
 <!ENTITY speedtouch "<trademark xmlns='http://docbook.org/ns/docbook'>SpeedTouch</trademark>">
 
 <!-- http://www.usr.com/adbuilder/ab-usage-guidelines.asp -->
 <!-- http://www.usr.com/adbuilder/ab-tips-trade-ref.asp -->
 <!ENTITY tm-attrib.usrobotics "<para xmlns='http://docbook.org/ns/docbook'>U.S. Robotics 和 Sportster 是 U.S. Robotics Corporation 的注册商标。</para>">
 <!ENTITY sportster "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Sportster</trademark>">
 <!ENTITY usrobotics "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>U.S. Robotics</trademark>">
 
 <!-- http://www.maplesoft.com/trademarks.shtml -->
 <!ENTITY tm-attrib.waterloomaple "<para xmlns='http://docbook.org/ns/docbook'>Waterloo Maple 和 Maple 是 Waterloo Maple Inc 的商标或注册商标</para>">
 <!ENTITY maple "<trademark xmlns='http://docbook.org/ns/docbook'>Maple</trademark>">
 
 <!-- http://www.wolfram.com/company/terms.html -->
 <!ENTITY tm-attrib.wolframresearch "<para xmlns='http://docbook.org/ns/docbook'>Mathematica 是 Wolfram Research, Inc 的注册商标。</para>">
 <!ENTITY mathematica "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>Mathematica</trademark>">
 
 <!-- http://www.vmware.com/legal.html -->
 <!ENTITY tm-attrib.vmware "<para xmlns='http://docbook.org/ns/docbook'>VMware 是 VMware,
   Inc. 的商标</para>">
 
 <!-- http://www.xensource.com/xen-tm-faq.html -->
 <!ENTITY xen "<trademark xmlns='http://docbook.org/ns/docbook'>Xen</trademark>">
 
 <!ENTITY tm-attrib.xfree86 "<para xmlns='http://docbook.org/ns/docbook'>XFree86 是 The
   XFree86 Project, Inc 的商标。.</para>">
 <!ENTITY xfree86 "<trademark xmlns='http://docbook.org/ns/docbook'>XFree86</trademark>">
 
 <!-- http://www.xiph.org/ -->
 <!ENTITY tm-attrib.xiph "<para xmlns='http://docbook.org/ns/docbook'>Ogg Vorbis 和 Xiph.Org 是 Xiph.Org 的商标。</para>">
 
 <!-- used in the X11 chapter of the Handbook -->
 <!ENTITY amdgpu "AMD KMS 驱动程序">
 <!ENTITY i915kms "Intel KMS 驱动程序">
 <!ENTITY radeonkms "Radeon KMS 驱动程序">
 
 <!ENTITY tm-attrib.general "<para xmlns='http://docbook.org/ns/docbook'>许多制造商和经销商使用一些称为商标的图案或文字设计来彰显自己的产品。
   本文档中出现的， 为 FreeBSD Project 所知晓的商标，后面将以 <quote>&trade;</quote> 或
   <quote>&reg;</quote> 符号来标注。</para>">
 
 <!ENTITY legalnotice '
 <legalnotice xmlns="http://docbook.org/ns/docbook" xml:id="legalnotice">
   <title>版权声明</title>
 
   <important><para><emphasis>本文中许可证的非官方中文翻译仅供参考，
     不作为判定任何责任的依据。如与英文原文有出入，则以英文原文为准。</emphasis></para></important>
 
   <para>在满足下列许可条件的前提下， 允许再分发或以源代码 (SGML DocBook) 或 “编译”
     (XML、 HTML、 PDF、 PostScript、 RTF 等) 的经过修改或未修改的形式：</para>
 
   <orderedlist>
     <listitem>
       <para>再分发源代码 (XML DocBook) 必须不加修改的保留上述版权告示、
         本条件清单和下述弃权书作为该文件的最先若干行。</para>
     </listitem>
 
     <listitem>
       <para>再分发编译的形式 (转换为其它 DTD、 PDF、 PostScript、 RTF 或其它形式)，
         必须将上述版权告示、本条件清单和下述弃权书复制到与分发品一同提供的文件，
         以及其它材料中。</para>
     </listitem>
   </orderedlist>
 
   <important>
     <para>本文档由 FREEBSD DOCUMENTATION PROJECT “按现状条件” 提供，
       并在此明示不提供任何明示或暗示的保障， 包括但不限于对商业适销性、
       对特定目的的适用性的暗示保障。 任何情况下， FREEBSD DOCUMENTATION
       PROJECT 均不对任何直接、 间接、 偶然、 特殊、 惩罚性的， 或必然的损失
       (包括但不限于替代商品或服务的采购、 使用、 数据或利益的损失或营业中断)
       负责， 无论是如何导致的并以任何有责任逻辑的，
       无论是否是在本文档使用以外以任何方式产生的契约、
       严格责任或是民事侵权行为(包括疏忽或其它)中的， 即使已被告知发生该损失的可能性。</para>
   </important>
 
   <para>Redistribution and use in source (XML DocBook) and &apos;compiled&apos;
     forms (XML, HTML, PDF, PostScript, RTF and so forth) with or without
     modification, are permitted provided that the following conditions are
     met:</para>
 
   <orderedlist>
     <listitem>
       <para>Redistributions of source code (XML DocBook) must retain the
         above copyright notice, this list of conditions and the following
         disclaimer as the first lines of this file unmodified.</para>
     </listitem>
 
     <listitem>
       <para>Redistributions in compiled form (transformed to other DTDs,
         converted to PDF, PostScript, RTF and other formats) must
         reproduce the above copyright notice, this list of conditions and
         the following disclaimer in the documentation and/or other
         materials provided with the distribution.</para>
     </listitem>
   </orderedlist>
 
   <important>
     <para>THIS DOCUMENTATION IS PROVIDED BY THE FREEBSD DOCUMENTATION
       PROJECT "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
       BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
       FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
       THE FREEBSD DOCUMENTATION PROJECT BE LIABLE FOR ANY DIRECT, INDIRECT,
       INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
       BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
       OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
       ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
       TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
       USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
       DAMAGE.</para>
   </important>
 
   <important><para><emphasis>从 FreeBSD 和 FreeBSD 中文化项目官方网站获取的本文档
     PostScript&reg; 和 PDF 格式文件中内嵌的中文字体，由文鼎科技开发股份有限公司按
     《文鼎公众授权书》授权提供。</emphasis></para></important>
 
 <para xmlns="http://docbook.org/ns/docbook">文鼎公众授权书</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">版权所有(C) 1999 文鼎科技开发股份有限公司</para>
 <para xmlns="http://docbook.org/ns/docbook">台湾110台北市永吉路168号11楼</para>
 <para xmlns="http://docbook.org/ns/docbook">除以下规定外，保留所有权利。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">任何人均可以复制及分发本授权书原始文件的复本，但禁止修改之。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">前言</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">　　绝大多数软件的授权书是用来剥夺您共享和修改软件的自由。相反，
      如果您将我们所授与您的一切权利授与您的接受者，
      并且确保他们能得到本软件的修改物，
      文鼎公众授权书特别许可并鼓励您使用本软件。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">法律性条款</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">0.　定义</para>
 <para xmlns="http://docbook.org/ns/docbook">　　本授权书中，「字型」是指「文鼎PL细上海宋」、「文鼎PL中楷」（BIG-5码）
      和「文鼎PL简报宋」、「文鼎PL简中楷」（GB码）等TrueType字型，
      以及经修改而产生的该等字型的衍生物， 包括修改字型样式、 更动编码顺序、
      转换格式、 变更字型名称，
      或者在 glyph table 中增减一些文字。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">　　「PL」是指「Public License」（公众授权）。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">　　「版权人」是指在字型版权声明中被称为版权所有者之人。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">　　「您」是指被授权者或复制、再散布、修改字型的人。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">　　「自由使用」是指您在所接受的相同条件下， 有复制、
      修改字型及散布字型复制品的自由，
      而非指价格。 如果您愿意， 可以对此项服务收取费用。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">1.　复制及分发</para>
 <para xmlns="http://docbook.org/ns/docbook">　　如果在所有复制品维持本授权书文件（ARPHICPL.TXT）不变，
      您可以在任何媒体无限制复制及分发本字型之复制品。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">2.　修改</para>
 <para xmlns="http://docbook.org/ns/docbook">　　如果满足以下条件， 您可以用任何方式修改本字型的复制品， 包括修改字型样式、
      更换编码顺序、 转换格式、 变更字型名称， 或者在 glyph table 中增减一些文字，
      并且依据上述第一条的规定复制及分发该修改物。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">　a)您必须在每个修改过的文件中插入明显的声明， 表示您如何及何时修改了该文件。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">　b)您必须允许所有第三方在本授权书条款下， 得以「自由使用」该修改物的全部，
      例如通过提供指定地点的复制路径，或在通常作为软件交换的媒体上发布该修改物。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">　c)如果修改过的字型在执行时以交谈方式读取命令，
      您必须使它在开始进入一般的交谈使用方式时打印或显示声明，
      包括适当的版权声明、 无担保声明 （或者其他您提供担保的声明），
      以及使用者可以依据这些条件再分发本字型的声明，
      并且告知使用者如何看到本授权书的复本。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">　　这些要求适用于整个修改过的作品。 如果作品的可辨识部分并非衍生自本字型，
      且可以合理地认其为独立而个别的作品， 则当您将它当作个别作品分发时，
      本授权书及其条款将不适用于该部分。 因此，
      仅将非基于本字型之其他作品和本字型一起放入贮存或分发媒体的同一卷上，
      并不会使该其他作品纳入本授权书的适用范围。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">3.　解除条件</para>
 <para xmlns="http://docbook.org/ns/docbook">　　除非依照本授权书的规定， 否则您不能复制、 修改、 再授权或分发本字型。
      任何用其他方式复制、 修改、 再授权或分发本字型的意图，
      将使本授权书所授与您的权利自动失效。 不过，
      从您那依据本授权书取得复制品和权利的人，
      只要他们完全遵行条款，其权利将维持有效。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">4.　同意</para>
 <para xmlns="http://docbook.org/ns/docbook">　　因您未签订本授权书， 所以没必要遵行它。 然而，
      没有任何其他文件授与您复制、 修改、 再授权或分发本字型之权利，
      如果您不同意本授权书， 这些行为是法律所禁止的。
      因此一旦复制、 修改、 再授权或分发本字型，
      就表示您接受本授权书及其一切条款和条件。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">5.　自动取得授权</para>
 <para xmlns="http://docbook.org/ns/docbook">　　每当您再散布本字型时， 收受者便自动从原始授权者处取得依据这些条款和条件复制、
      分发或修改本字型的授权。 您不可对在此所授与收受者之权利实行强加其他限制，
      您也没有使第三方遵行本授权书的义务。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">6.　抵触</para>
 <para xmlns="http://docbook.org/ns/docbook">　　若因法院判决、 违反专利宣称或任何其他原因（不限于专利纠纷）的结果，
      使强加于您的条件（不论是法院命令、协议或其他）和授权书的条件有所冲突时，
      也不能让您违背授权书的条件。
      如果您不能同时满足本授权书所定的义务及其他相关义务来分发时，
      那麽您根本不可分发本字型。 例如，
      如果专利授权不许所有直接或间接从您那里取得复制品者，
      在免授权费的情况下再分发本字型时，
      唯一能同时满足双方要求的方法是完全避免分发本字型。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">　　如果本条款之任何部分在特定情况下无效或无法实施， 条款的其他部分将继续适用，
      并作为整体适用于其他情况。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">7.　无担保</para>
 <para xmlns="http://docbook.org/ns/docbook">　　由于本字型是免费授权， 在法律允许的范围内， 本字型将不附带任何担保。
      除非另有书面说明， 版权人或其他提供本字型者「同样」不提供任何种类的担保，
      不论是明示还是暗示， 包括但不限于销售性和适于特定目的的暗示担保。
      有关本字型品质和执行的一切危险均由您承担。 如果本字型出现瑕疵，
      您应承担一切所需服务、修复和改正的费用。</para>
 <para xmlns="http://docbook.org/ns/docbook"></para>
 <para xmlns="http://docbook.org/ns/docbook">8.　损害赔偿请求权的放弃</para>
 <para xmlns="http://docbook.org/ns/docbook">　　除非法律规定或以书面形式同意， 在任何情况下，
      任何版权人或以上被允许得以复制、 修改或再分发本字型者，
      均不对您因使用或不能使用本字型（包括但不限于替代商品或服务的采购；
      使用、 数据或利益之损失； 或者营业妨碍） 所引致的任何直接、 间接、 必然、
      偶然、 特殊或惩罚性损失负责， 即使版权人或其他人已知该损失的可能性时亦不例外。</para>
 </legalnotice>
 '>
 
 <!-- This is no longer used in the en_US documentation, but needs
   leaving until translations stop using it -->
 <!ENTITY trademarks '
 <legalnotice xmlns="http://docbook.org/ns/docbook" xml:id="trademarks" role="trademarks">
   <title>法律声明</title>
 
   <para>FreeBSD 是 XFreeBSD 基金会的注册商标。</para>
 
   <para>UNIX 是 Open Group 在美国和其它国家的注册商标。</para>
 
   <para>Sun, Sun Microsystems, SunOS, Solaris,
     Java, JDK, 以及 OpenJDK 是 Sun Microsystems, Inc.
     在美国和其它国家的商标或注册商标。</para>
 
 <!-- Product Trademarks -->
 
   <para>Apple and QuickTime是Apple Computer, Inc.的商标，
     在美国和其它国家注册。</para>
 
   <para>Macromedia and Flash是Macromedia, Inc.
     在美国和/或其它国家的商标或注册商标。</para>
 
   <para>Microsoft, Windows, and Windows Media是Microsoft Corporation
     在美国和/或其它国家的商标或注册商标。</para>
 
   <para>PartitionMagic是PowerQuest Corporation在美国和/或其它国家的注册商标。</para>
 
   <para>许多制造商和经销商使用一些称为商标的图案或文字设计来彰显自己的产品。
     本文档中出现的， 为 FreeBSD Project 所知晓的商标，后面将以 &trade; 或
     &reg; 符号来标注。</para>
 
 </legalnotice>
 '>
diff --git a/zh_CN.UTF-8/share/xml/transtable.xml b/zh_CN.UTF-8/share/xml/transtable.xml
index c2b781cc88..f10ac6e311 100644
--- a/zh_CN.UTF-8/share/xml/transtable.xml
+++ b/zh_CN.UTF-8/share/xml/transtable.xml
@@ -1,362 +1,362 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- Original Revision: r39632 -->
+<!-- Original Revision: 77d737ee88 (r39632) -->
 <!-- $FreeBSD$ -->
 
 <!--
 
   This is a translation table used in transtable-common.xsl.
   For example:
 
   <group id="country">
     <word>
       <orig>word in English</orig>
       <tran>word in your language</tran>
     </word>
   </group>
 
 -->
 
 <transtable>
     <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">
       $FreeBSD$
     </cvs:keyword>
 
   <group id="country">
     <word>
       <orig>Central Servers</orig>
       <tran>中央服务器</tran>
     </word>
 
     <word>
       <orig>Primary Mirror Sites</orig>
       <tran>主要镜像站点</tran>
     </word>
 
     <word>
       <orig>Argentina</orig>
       <tran>阿根廷</tran>
     </word>
 
     <word>
       <orig>Armenia</orig>
       <tran>亚美尼亚</tran>
     </word>
 
     <word>
       <orig>Australia</orig>
       <tran>澳大利亚</tran>
     </word>
 
     <word>
       <orig>Austria</orig>
       <tran>奥地利</tran>
     </word>
 
     <word>
       <orig>Belgium</orig>
       <tran>比利时</tran>
     </word>
 
     <word>
       <orig>Brazil</orig>
       <tran>巴西</tran>
     </word>
 
     <word>
       <orig>Bulgaria</orig>
       <tran>保加利亚</tran>
     </word>
 
     <word>
       <orig>Canada</orig>
       <tran>加拿大</tran>
     </word>
 
     <word>
       <orig>China</orig>
       <tran>中国大陆</tran>
     </word>
 
     <word>
       <orig>Costa Rica</orig>
       <tran>哥斯达黎加</tran>
     </word>
 
     <word>
       <orig>Croatia</orig>
       <tran>克罗地亚</tran>
     </word>
 
     <word>
       <orig>Czech Republic</orig>
       <tran>捷克共和国</tran>
     </word>
 
     <word>
       <orig>Denmark</orig>
       <tran>丹麦</tran>
     </word>
 
     <word>
       <orig>Estonia</orig>
       <tran>爱沙尼亚</tran>
     </word>
 
     <word>
       <orig>Finland</orig>
       <tran>芬兰</tran>
     </word>
 
     <word>
       <orig>France</orig>
       <tran>法国</tran>
     </word>
 
     <word>
       <orig>Germany</orig>
       <tran>德国</tran>
     </word>
 
     <word>
       <orig>Greece</orig>
       <tran>希腊</tran>
     </word>
 
     <word>
       <orig>Hong Kong</orig>
       <tran>中国香港</tran>
     </word>
 
     <word>
       <orig>Hungary</orig>
       <tran>匈牙利</tran>
     </word>
 
     <word>
       <orig>Iceland</orig>
       <tran>冰岛</tran>
     </word>
 
     <word>
       <orig>Indonesia</orig>
       <tran>印度尼西亚</tran>
     </word>
 
     <word>
       <orig>Ireland</orig>
       <tran>爱尔兰</tran>
     </word>
 
     <word>
       <orig>Italy</orig>
       <tran>意大利</tran>
     </word>
 
     <word>
       <orig>Japan</orig>
       <tran>日本</tran>
     </word>
 
     <word>
       <orig>Korea</orig>
       <tran>韩国</tran>
     </word>
 
     <word>
       <orig>Kuwait</orig>
       <tran>科威特</tran>
     </word>
 
     <word>
       <orig>Kyrgyzstan</orig>
       <tran>吉尔吉斯斯坦</tran>
     </word>
 
     <word>
       <orig>Latvia</orig>
       <tran>拉脱维亚</tran>
     </word>
 
     <word>
       <orig>Lithuania</orig>
       <tran>立陶宛</tran>
     </word>
 
     <word>
       <orig>Netherlands</orig>
       <tran>荷兰</tran>
     </word>
 
     <word>
       <orig>New Zealand</orig>
       <tran>新西兰</tran>
     </word>
 
     <word>
       <orig>Norway</orig>
       <tran>挪威</tran>
     </word>
 
     <word>
       <orig>Philippines</orig>
       <tran>菲律宾</tran>
     </word>
 
     <word>
       <orig>Poland</orig>
       <tran>波兰</tran>
     </word>
 
     <word>
       <orig>Portugal</orig>
       <tran>葡萄牙</tran>
     </word>
 
     <word>
       <orig>Romania</orig>
       <tran>罗马尼亚</tran>
     </word>
 
     <word>
       <orig>Russia</orig>
       <tran>俄罗斯</tran>
     </word>
 
     <word>
       <orig>San Marino</orig>
       <tran>圣马力诺</tran>
     </word>
 
     <word>
       <orig>Saudi Arabia</orig>
       <tran>沙特阿拉伯</tran>
     </word>
 
     <word>
       <orig>Singapore</orig>
       <tran>新加坡</tran>
     </word>
 
     <word>
       <orig>Slovak Republic</orig>
       <tran>斯洛伐克共和国</tran>
     </word>
 
     <word>
       <orig>Slovenia</orig>
       <tran>斯洛文尼亚</tran>
     </word>
 
     <word>
       <orig>South Africa</orig>
       <tran>南非</tran>
     </word>
 
     <word>
       <orig>Spain</orig>
       <tran>西班牙</tran>
     </word>
 
     <word>
       <orig>Sweden</orig>
       <tran>瑞典</tran>
     </word>
 
     <word>
       <orig>Switzerland</orig>
       <tran>瑞士</tran>
     </word>
 
     <word>
       <orig>Taiwan</orig>
       <tran>中国台湾</tran>
     </word>
 
     <word>
       <orig>Thailand</orig>
       <tran>泰国</tran>
     </word>
 
     <word>
       <orig>Turkey</orig>
       <tran>土耳其</tran>
     </word>
 
     <word>
       <orig>Ukraine</orig>
       <tran>乌克兰</tran>
     </word>
 
     <word>
       <orig>United Kingdom</orig>
       <tran>英国</tran>
     </word>
 
     <word>
       <orig>USA</orig>
       <tran>美国</tran>
     </word>
   </group>
 
   <group id="number-month">
     <word>
       <orig>1</orig>
       <tran>1月</tran>
     </word>
 
     <word>
       <orig>2</orig>
       <tran>2月</tran>
     </word>
 
     <word>
       <orig>3</orig>
       <tran>3月</tran>
     </word>
 
     <word>
       <orig>4</orig>
       <tran>4月</tran>
     </word>
 
     <word>
       <orig>5</orig>
       <tran>5月</tran>
     </word>
 
     <word>
       <orig>6</orig>
       <tran>6月</tran>
     </word>
 
     <word>
       <orig>7</orig>
       <tran>7月</tran>
     </word>
 
     <word>
       <orig>8</orig>
       <tran>8月</tran>
     </word>
 
     <word>
       <orig>9</orig>
       <tran>9月</tran>
     </word>
 
     <word>
       <orig>10</orig>
       <tran>10月</tran>
     </word>
 
     <word>
       <orig>11</orig>
       <tran>11月</tran>
     </word>
 
     <word>
       <orig>12</orig>
       <tran>12月</tran>
     </word>
   </group>
 </transtable>