原文:
Building XFree86 from a Source Distribution
http://www.xfree86.org/4.3.0/BUILD.html
26 February 2003
————————–
这个文档描述了怎样从源代码发行版构建XFree86,要结合特定操作系统的README文件来使用它。
———————————–
注:构建XFree86之前,最好参考特定操作系统的README文件,这些文件包含了在你的操作系统下成功构建XFree86所需的详细信息。
我们强烈推荐使用GCC构建XFree86,但是通常也可以使用各个平台的本地编译器。
—————————
1、怎样得到XFree86 4.3.0 的源码
推荐的方法是从XFree86的CVS库中获取XFree86 4.3.0 的源码。有多种途径可以做到这一点,可以在我们的CVS页面找到xf-4.3.0发行版的标签。
另一个途径是再XFree86的FTP站点下载4.3.0的tar格式源码包。步骤如下:
*XFree86 4.3.0的源码包含在 X430src-1.tgz, X430src-2.tgz, X430src-3.tgz, X430src-4.tgz,X430src-5.tgz, X430src-6.tgz 和 X430src-7.tgz 中。这些文件可以在ftp://ftp.xfree86.org/pub/XFree86/4.3.0/source/ 或XFree86站点的类似地址中找到。X430src-4.tgz 和 X430src-5.tgz包含了字体,X430src-6.tgz 和 X430src-7.tgz包含了文档。X430src-1.tgz, X430src-2.tgz 和 X430src-3.tgz包含了其他所有的东西。如果你不需要字体和文档,可以只下载X430src-1.tgz, X430src-2.tgz 和 X430src-3.tgz。
*运行下面的命令解压每个文件,确保足够的空间,全部源码大约需要305M,还要一些空间编译二进制文件。
gzip -d < X430src-1.tgz | tar vxf –
gzip -d < X430src-2.tgz | tar vxf –
gzip -d < X430src-3.tgz | tar vxf –
gzip -d < X430src-4.tgz | tar vxf –
gzip -d < X430src-5.tgz | tar vxf –
gzip -d < X430src-6.tgz | tar vxf –
gzip -d < X430src-7.tgz | tar vxf –
如果你已经有了一份XFree86 4.2.0源码的拷贝,可以从ftp://ftp.xfree86.org/pub/XFree86/4.3.0/patches/下载补丁来升级到4.3.0。补丁的下载和使用信息可以在这个发行版的REDAME文件的“How to get XFree86”段找到。
所有的方法都将产生一个主源码目录,叫做xc。
—————————
2、构建之前先配置源码
在大多数情况下,没有必要做任何配置。
如果你确实想要改变配置,建议你先进入 xc/config/cf 目录,复制xf86site.def为host.def。然后通过阅读host.def文件,根据你的配置设置你想要的参数。你也可以通过查看.cf文件,找出针对你的操作系统的默认设置。
通常遵循的规则是,只修改你理解的选项,并且有好的修改原因。修改默认配置容易产生一些问题。很多配置选项记录在 xc/config/cf/README。
如果你只使用源代码的x430src-1.tgz,x430src-2.tgz和x430src-3.tgx部分,你需要定义BuildFonts为NO。
—————————
3、使用符号链接的目录来构建
推荐的做法是,用一个符号链接的目录来构建XFree86。这样可以保证源代码目录在构建过程中不被修改,还有以下好处:
*当使用CVS维护源码树的更新时,更新进程不会被非CVS控制的文件所干扰。
*可以用同样的源码为不同的操作系统或架构构建XFree86,用只读的NFS共享。
*可以用不同的配置构建XFree86,只需要在每一个构建树中放一个host.def的拷贝,并且分别定义。
用下面步骤建立一个符号链接目录:
*在构建树的顶层创建目录,通常新建在xc目录的同层,但不是强制性的。
cd [xc目录]
mkdir build
*用“lndir”命令创建影子树:
lndir ../xc
注:如果需要的话,最好使用xc目录的绝对路径。
如果你的系统没有安装lndir,你可以用下面的命令从XFree86的源码安装它:
cd xc/config/util
make -f Makefile.ini lndir
cp lndir [some directory in your PATH]
随着时间的推移,可能在构建树中产生一些陈旧的链接,例如,当源码中的文件被删除或重命名。可以在构建目录中运行“cleanlinks”脚本来清除。很少会因为一些变化而要从头开始重新创建构建树。如果有这样的情况,那可能是构建过程中问题。最好的方法是删除构建树,然后按上面的步骤重新构建。
—————————-
4、构建和安装
构建之前,读一下xc/programs/Xserver/hw/xfree86/doc中与你相关的特定操作系统的README。一旦特定操作系统的详情已经有了描述,就可以到你的构建目录(xc目录或之前建立的影子树),运行“make World”,如果有必要,就带上README中描述的BOOTSTRAPCFLAGS设置,但是XFree86支持大多数操作系统已经不需要BOOTSTRAPCFLAGS。一个明智的做法是将stdout和stderr重定向到World.log,以便追踪构建过程中可能产生的问题。
在类Bourne的shell(Bash,Korn shell,zsh,等)中使用如下的命令:
make World > World.log 2>&1
C-shell(csh,tcsh,等)中使用:
make World >& World.log
你可以根据构建的进展运行:
tail -f World.log
构建完成后,如果有什么问题,你需要检查World.log文件。如果没有问题,你就可以安装二进制文件了。默认的“make World”过程会忽略错误,以便尽可能的构建成功。如果在这一步中有无法解决的问题,安装过程将会失败。解决问题后重新开始构建时,只需要运行“make”。如果在解决问题的过程中改变了Imakefile或其它构建配置,需要重新运行“make World”或“make Everything”。
如果你想要“make World”在第一个错误是结束,用下面的命令来替换前面所讲的:
在类Bourne的shell中:
make WORLDOPTS= World > World.log 2>&1
在C-shell中:
make WORLDOPTS= World >& World.log
对于安装,运行“make install”和“make install.man”。确保/usr/X11R6中有足够的空间用于安装。如果你想要安装在/usr之外的文件系统,需要在新建一个指向/usr/X11R6的符号连接。
————————-
5、重新配置服务器
为服务器构建不同的设置,或带有不同驱动设置的服务器。
1.确保新的驱动源码在正确的位置(例如,驱动源码应该在xc/programs/Xserver/hw/xfree86/drivers下的一个子目录)。
2.修改host.def(你要构建的服务器)中定义的服务器设置,也可以根据你的需要修改驱动列表。
3.在xc/programs/Xserver中运行:
make Makefile
make Makefiles
make includes
make depend
make
————————
6、其他有用的make目标
下面是一些在XFree86的Makefile中定义的其他有用的目标:
*Everything make Worle之后,make Everything会做任何make World可以做的,除了清理树。这是一个为源码打补丁后、快速重新构建树的方法。但它并不是100%可靠的。最好是用make World做一次完整的构建。
*clean 用于对源码树进行局部清理。删除目标文件和生成的手册页,但是保留Makefile和生成的依赖文件。执行make clean后,你需要重新运行以下命令来重新构建XFree86:
make include
make depend
make
*disclean 对源码树进行完全清理,删除所有的生产文件。make disclean后,只能用make World重新构建XFree86。
*includes 生产所有的可生成头文件和构建所需的符号链接。make clean时,这些文件会被删除。
*depend 重新计算Makefile中各个目标的依赖关系。根据操作系统,依赖关系储存在Makefile,或一个独立的文件中,叫做.depend。这目标需要用到make includes生产的头文件。VerifyOS 显示检测到的操作系统的版本。如版本号与你的系统不匹配,你可能要在host.def中设置并且向XFree86@XFree86.org报告这个问题