25.7 重新编译 “world”

25.7.1 更新系统的规范方法

　　在更新系统时， 一定要首先查看 /usr/src/UPDATING 文件， 以便了解在 buildworld 之前需要进行的操作， 然后按照下面列出的步骤进行操作：

　　这些更新步骤假定您使用的是包含旧编译器、 内核以及用户态工具及配置的旧版 FreeBSD。 我们使用 “world” 来表示系统中的核心执行文件、 函数库和程序文件。 编译器是 “world” 的一部分， 但有其特殊性。

　　此外， 我们还假定您已经获得了较新版本操作系统的源代码。 如果您正更新的系统中的源代码也是旧版系统所附带的， 您还需要参阅 第 25.6 节 来把代码同步到较新的版本。

　　从源代码更新系统， 有时会比初看上去的时候更麻烦一些， 另一方面， FreeBSD 的开发人员有时会不得不修改推荐的更新步骤， 特别是当出现了一些无法避免的依赖关系的时候。 这一节余下的部分， 将介绍目前推荐的更新步骤背后的原理。

　　成功的更新操作必须解决下面的这些问题：

• 旧的编译器可能无法编译新的内核。 (另一方面， 旧的编译器很可能有 bug。) 因此， 新的内核应该以新的编译器编译。 更具体地说， 新的编译器应在新内核开始联编之前已经完成了联编步骤。 请注意， 新的编译器并不一定需要在联编新内核之前 安装 到系统中。

• 新的 world 有可能依赖一些新的内核特性。 因此， 新内核必须在新的 world 之前安装。

　　这两个问题就是为什么我们将在后面的章节中介绍的， 需要按照 buildworld、 buildkernel、 installkernel、 installworld 的顺序来更新系统的原因。 这并不是您需要遵守推荐的更新操作的全部原因， 除了这两个最重要的理由之外， 还有一些并不那么显而易见的原因：

• 旧的 world 可能无法配合新的内核正常工作， 因此， 您在安装完新内核之后， 应尽快将 world 也随之更新。

• 有些配置文件的变动必须在安装新的 world 之前完成， 而另一些配置文件的变动则有可能导致旧 world 工作不正常。 因此， 通常而言会需要两次不同的配置文件更新步骤。

• 多数情况下， 更新步骤只会替换或增加文件； 换言之， 现有的旧文件并不会被删除。 有时， 这可能会导致一些其他问题。 因此， 有时安装操作会指明， 必须在某些操作之前手工删除一些文件。 这些在未来可能会被自动化， 也可能不会自动化。

　　由于有这些考虑， 因此一般情况下我们建议使用下列更新步骤。 请注意， 具体的更新操作中可能会需要一些附加的步骤， 但核心的过程应该是不会轻易发生变化的：

1. make buildworld

   这步操作会联编新的编译器， 以及少量相关工具， 并在随后使用新的编译器来联编 world。 联编的结果会存放在 /usr/obj。

2. make buildkernel

   与旧式的、 使用 config(8) 和 make(1) 的方法不同， 这种做法会使用存放于 /usr/obj 中的 新的 编译器。 这种做法使得您免去了由于编译器与内核源代码不一致导致的问题。

3. make installkernel

   安装新的内核及其模块， 使系统能够以更新后的内核启动。

4. 重启系统并进入单用户模式。

   单用户模式使得更新正在运行的软件可能导致的问题减到最少。 此外， 它也使配合新内核运行旧 world 可能出现的问题减到最少。

5. mergemaster -p

   这步操作会进行完成安装新的 world 所需的配置文件更新操作。 例如， 它可能会在系统的密码数据库中添加新的用户组或用户。 这些操作通常在上次更新之后增加了新的用户组或特殊系统用户之后是需要的， 因为 installworld 这步操作会需要这些用户或组才能顺利完成。

6. make installworld

   从 /usr/obj 中复制 world。 这步操作之后， 您在盘上的系统， 包括内核和 world 就都是新的了。

7. mergemaster

   更新余下的配置文件， 因为您的 world 已经更新完成了。

8. 重启系统。

   这步操作将加在新的内核， 以及新的 world 和更新过的配置文件。

　　注意， 如果您正从同一 FreeBSD 版本分支升级， 例如， 从 7.0 到 7.1， 则上述过程可能没有那么必要， 因为您不太可能遇到严重的编译器、 内核源代码、 用户态程序源代码或配置文件不匹配的情形。 旧式的 make world 然后再联编新内核的升级方法， 很可能有机会能够正常运作而完成升级工作。

　　但是， 在大版本升级的过程中， 不按照前面所介绍的操作来进行升级时， 便很可能遇到一些问题。

　　此外， 还需要注意的是， 有些时候升级的过程中 (例如从 4.X 到 5.0) 可能会需要一些额外的步骤 (例如在 installworld 之前更名或删除一些文件)。 请仔细阅读 /usr/src/UPDATING 这个文件， 特别是它的结尾部分所介绍的推荐的升级操作顺序。

　　由于开发人员发现不可能完全避免一些不匹配方面的问题， 这个过程一直在演化过程中。 不过幸运的是， 目前推荐的这个升级步骤， 应该能够在很长一段时间内不需要做任何调整。

　　总结一下， 目前推荐的从源代码升级 FreeBSD 的方法是：

# cd /usr/src
# make buildworld
# make buildkernel
# make installkernel
# shutdown -r now

　　在 installkernel 成功完成之后， 您需要引导到单用户模式 (举例而言， 可以在加载器提示后输入 boot -s)。 接下来执行：

# adjkerntz -i
# mount -a -t ufs
# mergemaster -p
# cd /usr/src
# make installworld
# mergemaster
# reboot

25.7.2 阅读 /usr/src/UPDATING

　　在您做其它事之前，请阅读 /usr/src/UPDATING (或在您的源码里的等效的文件)。 这个文件要包含有关于您可能遇到的问题的重要信息， 或指定了您可能使用到的命令的执行顺序。如果 UPDATING 与您这里读到相矛盾，那就先依据 UPDATING。

25.7.3 检查 /etc/make.conf

　　检查 /usr/share/examples/etc/make.conf 以及 /etc/make.conf。 第一个文件包含了一些默认的定义 – 它们中的绝大多数都注释掉了。 为了在重新编译系统时能够使用它们， 请把这些选项加入到 /etc/make.conf。 请注意在 /etc/make.conf 中的任何设置同时也会影响每次运行 make 的结果， 因此设置一些适合自己系统的选项是一个好习惯。

　　一般的用户通常会从 /usr/share/examples/etc/make.conf 复制 CFLAGS 和 NO_PROFILE 这样的设置到 /etc/make.conf 中并令它们生效。

　　请考虑其他的一些选项 (例如 COPTFLAGS、 NOPORTDOCS 等等)， 看看是否合用。

25.7.4 更新 /etc 里的文件

　　/etc 目录包含有除了您的系统启动时执行的脚本外大部分的系统配置信息。 有些脚本随 FreeBSD 的版本而不同。

　　有些配置文件在天天运行的系统里也是要使用到的。尤其是 /etc/group。

　　偶尔， 作为安装过程的一部分， make installworld 会要求事先创建某些特定的用户或组。 在进行升级时， 它们可能并不存在。 这会给升级造成问题。 有时， make buildworld 会检查它们是否已经存在。

　　最近就有个这样的例子， 当时新增了 smmsp 用户。 当用户尝试完成安装操作时， 在 mtree(8) 尝试建立 /var/spool/clientmqueue 时失败了。

　　解决办法是通过使用 -p 选项以构建前 (pre-buildworld) 模式运行 mergemaster(8)。 这表示只对比那些对于成功执行 buildworld 或 installworld 起关键作用的文件。 在第一次这样做时， 如果使用的是早期的不支持 -p 的 mergemaster 版本的话， 使用源码中的新版本即可。

# cd /usr/src/usr.sbin/mergemaster
# ./mergemaster.sh -p

25.7.5 改为单用户模式

　　您可能想在单用户模式下编译系统。 除了对更快处理事情显然有好处外， 重装系统将触及许多重要的系统文件， 包括所有标准系统二进制文件、库文件、包含 (include) 文件等等。 在正运行的系统 (尤其是在有活跃的用户的时候) 中更改这些文件是自寻烦恼。

　　另一种模式是在多用户模式下编译系统，然后转换到单用户模式下安装。 如果您喜欢这种方式，只需在建立 (build) 完成后才执行下边的步骤。 您推迟转换到单用户模式下直到您必须 installkernel 或 installworld。

　　从运行的系统里，以超级用户方式执行：

# shutdown now

　　这样就会转换到单用户模式。

　　除此之外， 也可以重启系统， 并在启动菜单处选择 “single user”(单用户) 选项。 这样系统将以单用户模式启动。 接着， 在 shell 提示符处执行：

# fsck -p
# mount -u /
# mount -a -t ufs
# swapon -a

　　这会检查文件系统，重新将 / 以读/写模式挂接， 参考 /etc/fstab 挂接其它所有的 UFS 文件系统，然后启用交换区。

25.7.6 删除 /usr/obj

　　随着重新构建系统的进行， 编译结果会放到 (默认情况下) /usr/obj 下。 这些目录会映射到 /usr/src。

　　通过删除这个目录， 可以加速 make buildworld 的过程， 并避免相互依赖关系等复杂的问题。

　　/usr/obj 中的某些文件可能设置了不可改标记 (详情参见 chflags(1))， 需要首先去掉这些标志。

# cd /usr/obj
# chflags -R noschg *
# rm -rf *

25.7.7 重新编译基本系统

# script /var/tmp/mw.out
Script started, output file is /var/tmp/mw.out
# make TARGET
… compile, compile, compile …
# exit
Script done, …

# cd /usr/src

# make -x -DVARIABLE target

# make -DNO_PROFILE target

NO_PROFILE=    true 	#    避免编译性能分析库

# make target

# make buildworld

# make -j4 buildworld

25.7.8 编译和安装新内核

　　要充分利用您的新系统，您应该重新编译内核。 这是很有必要的，因为特定的内存结构已经发生了改变，像 ps(1) 和 top(1) 这样的程序会不能工作， 除非内核同源码树的版本是一样的。

　　最简单、最安全的方式是 build 并安装一个基于 GENERIC 的内核。虽然 GENERIC 可能没有适合您的系统的所有必要的设备， 但它包括了启动您的系统到单用户模式所必需的内容。 这是个不错的检测新系统是否工作正常的测试。在从 GENERIC 启动、核实系统可以工作后， 您就可以建立 (build) 一个基于您的正常内核配置文件的新的内核了。

　　在 FreeBSD 中， 首先完成 build world 然后再编译新内核非常重要。

　　注意，如果您已把 内核安全级别(kern.securelevel) 调高到了 1 以上，而且还设置了 noschg 或相似的标识到了您的内核二进制里边，您可能会发现转换到单用户模式里使用 installkernel 是很有必要的。 如果您没有设置它， 则应该也能毫无问题地在多用户模式执行这两个命令。 请参考 init(8) 以了解更多关于 内核安全级(kern.securelevel) 的信息；查看 chflags(1) 了解更多关于不同文件标识的信息。

25.7.9 重启到单用户模式

　　您应该单用户模式测试新内核。照第 25.7.5 节处的说明去做。

25.7.10 安装编译好的新系统

　　您现在应使用 installworld 来安装新的系统二进制。

　　执行

# cd /usr/src
# make installworld

25.7.11 不是由 make installworld 更新的更新文件

　　重新编译整个系统不会使用新的或改过的配置文件更新某些目录 (尤其像 /etc、/var 和 /usr)

　　更新这些文件最简单的方式就是使用 mergemaster(8)，手工去做也是可以的，只要您愿意。 不管您选择哪一种，一定记得备份 /etc 以防出错。

# mkdir /var/tmp/root
# cd /usr/src/etc
# make DESTDIR=/var/tmp/root distrib-dirs distribution

# cd /var/tmp/root
# find -d . -type d | xargs rmdir 2>/dev/null

# diff /etc/shells /var/tmp/root/etc/shells

25.7.12 重启

　　现在完成了。在您检查所有内容都放置正确后， 您可以重启系统了。只是简单的 shutdown(8) 可以这样做：

# shutdown -r now

25.7.13 结束

　　恭喜！您现在成功升级了您的 FreeBSD 系统。

　　如果还有轻微的错误，可以轻易地重建系统的选定部分。 例如，在部分升级或合并 /etc 时，您不小心删除了 /etc/magic，file(1) 命令就会停止工作。这种情况下，执行下边进行修复：

# cd /usr/src/usr.bin/file
# make all install

25.7.14 问题

src/games/cribbage/instr.c
src/games/sail/pl_main.c
src/release/sysinstall/config.c
src/release/sysinstall/media.c
src/share/mk/bsd.port.mk

… 问题修复 …
# cd /usr/src
# make -DNO_CLEAN all

--------------------------------------------------------------
Building everything..
--------------------------------------------------------------

# chflags -R noschg /usr/obj/usr
# rm -rf /usr/obj/usr
# cd /usr/src
# make cleandir
# make cleandir