dbm数据库源代码分析(2)：构建性文件

   现在解剖GNU dbm的构建性文件。由于项目的构建使用了Autotools工具集及make工具来完成。因此只解剖一些对理解项目至关重要的文件，主要有开发者编写的README、NEWS、ChangeLog、configure.in，由Autotools自动生成的COPYING、INSTALL、Makefile文件（由Makefile.in生成）。由于Makefile文件在项目构建时比较重要（我们很多时候都是自己来编写Makefile），需要用到源代码树中的各个源文件，因此需要在解剖完各源代码文件之后再来解剖。其他一些由Autotools自动生成的文件，如aclocal.m4、configure脚本（由configure.in生成）、config.guess、config.sub、install-sh、autoconf.h（由autoconf.h.in生成）、config.status、libtool等，有可能的话也会在最后进行解剖（它们对项目的理解并没有太大的影响，因为我们在开发时常用Autotools工具来自动生成它们，一般无需自己编写）。
   （1）README。介绍了软件包的编译和安装方法，以及项目中包含的文件列表。注意有时软件包可以根据不同配置来编译成多种的发布包形式，这里都会有介绍。

GNU dbm是一个数据库例程集，它使用了与标准的UNIX dbm例程集类似的可扩展的散列方法和工作集。 这是GNU dbm 1.8.3发布版。 编译gdbm： a) configure <配置参数类似于 -prefix ... 参看INSTALL> b) make 编译可选的测试和转换程序： a) make progs 安装基本包： a) make install 安装可选的dbm和ndbm API兼容库和头文件： a) make install-compat 有bug请报告到 bug-gnu-utils@gnu.org ------------------------------------------ 文件包括： INSTALL - 安装建议和信息 NEWS - 新闻和更改方面的信息 COPYING - 版权信息 README - 本文件 bucket.c, extern.h, falloc.c, findkey.c, gdbm.proto, gdbmclose.c, gdbmconst.h gdbmdefs.h, gdbmdelete.c, gdbmerrno.h, gdbmfdesc.c, gdbmfetch.c, gdbmsync.c, gdbmopen.c, gdbmreorg.c, gdbmseq.c, gdbmstore.c, global.c, gdbm.h, hash.c systems.h, update.c, version.c - GNU dbm库的源代码 dbm.h dbminit.c, delete.c, fetch.c, seq.c, store.c - DBM接口的源代码 dbmclose.c, dbmdelete.c, dbmdirfno.c, dbmfetch.c, dbmopen.c, dbmpagfno.c dbmseq.c, dbmstore.c, ndbm.h - NDBM接口的源代码 Makefile - Makefile，用来构建gdbm.a (BSD和SYSV) testgdbm.c - 一个简单的测试程序 testdbm.c - 一个简单测试程序 testndbm.c - 一个简单的测试程序 conv2gdbm.c - 一个dbm数据库转换程序 gdbm.3, gdbm.texinfo - gdbm的文档 可以通过e-mail地址phil@cs.wwu.edu与GNU gdbm的作者交流， 可以通过downsi@downsj.com与当前的维护者交流。 E-mail可以发送给两者之中的任何一个。

   （2）NEWS。按版本号的顺序记录了所做的改进动作（略）。

   （3）ChangeLog。按时间顺序记录了对每个文件所做的改进（略）。

   （4）COPYING。记录了软件的版权信息，对于GNU项目，一般是GPL版权信息（略）。

   （5）INSTALL。介绍编译和安装软件包的方法和建议，信息比较详细，对不同平台上的编译和安装都给出了具体建议。重点介绍了./configure的选项参数--srcdir=DIR、--prefix=PATH、--exec-prefix=PATH、--no-create、--with-PACKAGE等。

这是一个用于实用程序发布的通用INSTALL文件。 如果本软件包没有包含，例如，可安装的文档或数据文件，请忽略下面对它们的引用。 为了编译本软件包： 1、根据你的系统来配置本软件包。在本文件所在的目录中，键入“./configure“。如果你正在一个老版本的系统V上使用“csh“，你可能需要键入”sh configure“，以避免“csh”去执行“configure”本身。 对在编译过程中使用的各种依赖于系统的变量，“configure”脚本会猜测他们的正确值， 然后创建Makefile(s)（在源代码目录的每个子目录下都会创建一个）。 在一些包中它会创建含有依赖于系统定义的C头文件。它也会创建一个“config.status”文件， 你将来可以运行这个文件来重新创建当前的配置。 运行“configure”需要1到2分钟。当它正在运行时，它打印一些消息，以告知它正在做什么。 如果你不想看到这些消息，可以运行“configure”并且把标准输出重定向到“/dev/null”， 例如，“./configure > /dev/null”。 为了在一个与包含源代码的目录不同的目录中编译软件包，你必须使用支持VPATH变量版本的“make“， 例如GNU make。“cd”到你想放置目标文件和可执行程序的目录（即你把configure脚本放在这个目录中了）， 然后运行“configure”。“configure”自动检查“configure”所在的目录以及“..”目录中的源代码。 如果因为某些原因“configure”不位于你正在配置的源代码目录中，它将会报告不能找到源代码。 在这种情况下，可以运行带“--srcdir=DIR”选项的“configure”，这里DIR是包含源代码的目录。 默认情况下，“make install”将把包的文件安装到/usr/local/bin、/usr/local/lib、/usr/local/man等目录下。 通过给“configure”指定一个选项“--prefix=PATH”，你可以指定一个安装目录前缀来替换/usr/local。可选地，你也 可以在运行“make”时为变量“prefix”指定一个值来达到同样的效果。例如， make prefix=/usr/gnu make prefix=/usr/gnu install 你可以为体系结构相关的文件和体系结构独立的文件指定不同的安装前缀。如果你给“configure”指定 选项“--exec-prefix=PATH”，或者把“make”变量“exec_prefix”的值设置为PATH，软件包将使用 PATH作为前缀来安装程序和库。数据文件和文档将仍然使用正常的前缀。一般地，所有文件在安装时都 使用正常的前缀。 另外一个“configure”选项主要用在更新“config.staus”和“Makefile”的“Makefile”规则上。 “--no-create”选项描述你的系统的配置并把它记录在“config.status”中，它并没有实际地去 配置软件（即创建“Makefile”和一个可能的配置头文件）。之后，你可以运行“./config.status” 来实际地配置软件包。你也可以给“config.status”指定“--recheck”选项，这个选项使它重新运行 “configure”（带的参数与你之前使用的相同）。这个选项在你改变“configure”时很有用。 一些软件包关注“configure”的“--with-PACKAGE”选项，这里PACKAGE是一些像“gnu-libc”或者 “x”（对X窗口系统）的东西。README文件中应该提及任何软件包能识别的--with-选项。 “configure”忽略你给出的任何其他参数。 如果你的系统需要一些“configure”不知道的选项才能进行编译和链接，你可以通过在环境中设置的方式 给“configure”指定一些变量初值。在Bourne兼容的shell中，你可以在命令行上这样做： CC='gcc -traditional' DEFS=-D_POSIX_SOURCE ./configure 当运行“configure”时，你想用环境变量来覆盖的“make”变量有： （对这些变量，任何在环境中给出的值都会覆盖“configure”选择的值：） CC C编译器程序 默认为“cc”，或者 “gcc“，如果”gcc“在你的PATH中 INSTALL 用来安装文件的程序 默认为“install”，如果你有它的话，否则为“cp” （对这些变量，任何在环境中给出的值都会添加到“configure”选择的值中：） DEFS 配置选项，格式为“-Dfoo -Dbar ...” 不要在创建配置头文件的包中使用这个变量 LIBS 需要链接的库，格式为“-lfoo -lbar ...” 如果你需要做一些不常用的配置来编译软件包，我们鼓励你描述出“configure”怎样才能检测是否 做它们，然后发邮件到README中给出的地址，以便我们能够在下一个版本中包含它们。 2、键入“make”来编译软件包。如果你需要，可以像这样覆盖“make”变量CFLAGS和LDFLAGS： make CFLAGS=-O2 LDFLAGS=-s 3、如果软件包包含自测试并且你想运行它们，键入“make check”。如果你不能确定是否存在自测试， 也可以试着运行这个命令；如果“make”像这样响应你 make: *** No way to make target `check'. Stop. 这就说明包中不包含自测试。 4、键入“make install”来安装程序、数据文件和文档。 5、你可以通过键入“make clean”从源目录中删除程序二进制文件和目录文件。为了删除Makefile(s)、 含有依赖于系统定义的头文件（如果软件包使用了的话）和“config.status”（“configure”创建的所有文件）， 可以键入“make distclean”。 文件“configure.in”是“autoconf”程序用来创建“configure”的模板文件。仅当你想使用一个更新版本的“autoconf“ 来重新创建“configure”时，你都会用到它。

   （6）configure.in。这个文件被autoconf使用，以生成configure脚本。它主要指定软件包的名称和版本、要生成的包含平台相关常量定义的文件和Makefile文件名、使用的程序语言、要测试的头文件、库、函数、结构体等。

dnl 使用autoconf来处理这个文件，以生成configure脚本 AC_INIT([gdbm], [1.8.3]) # 指定软件包的名字为gdbm，版本号为1.8.3，bug报告地址为空 AC_PREREQ(2.54) # 使用的autoconf版本，这里为2.54，autoconf使用本文件来生成configure脚本 AC_CONFIG_SRCDIR([gdbmdefs.h]) # 测所指定的源码文件是否存在（这里为gdbmdefs.h），以源码目录的有效性 AC_CONFIG_HEADERS([autoconf.h]) # 指定与平台相关的宏定义头文件名 AC_PROG_CC # 指定测试程序用的语言，为C语言 AC_PROG_CPP # 指定C++语言 AC_PROG_INSTALL # 指定安装程序 AM_PROG_LIBTOOL # 指定要调用调用libtoolize，以便使用平台无关的接口来生成静态库或共享库 dnl AC_PROG_RANLIB # 表示编译程序时使用到库 dnl AC_C_BIGENDIAN([]) AC_C_CONST # 指定测试头文件 AC_CHECK_HEADERS([stdlib.h string.h sys/file.h unistd.h fcntl.h sys/types.h memory.y]) AC_CHECK_LIB(dbm, main) # 指定测试库 AC_CHECK_LIB(ndbm, main) AC_CHECK_FUNCS([rename ftruncate flock bcopy fsync]) # 指定测试函数 AC_REPLACE_FUNCS(getopt) # 指定覆盖函数 AC_TYPE_OFF_T AC_CHECK_MEMBERS([struct stat.st_blksize]) # 指定测试结构体 AC_CONFIG_FILES([Makefile]) # 指定生成的Makefile文件名 AC_OUTPUT