本来想把configure.ac和各种m4文件分析明白,发现有点困难,不过好在也能理解一些。
基本教程
首先要明白m4,参见这个教程,写得不错,不论怎么样m4替换来替换去的,还真是不那么容易懂,好在我们自己不用写,只要看懂大意而已~
然后我们还得去了解下 autoconf和automake,这本书不错 《Autotools: A Practioner's Guide to GNU Autoconf, Automake, and Libtool》,csdn有下载。
文件夹结构
当autoconf和automake时使用时,用户自定义宏应该放在 acinclude.m4和m4/*.m4(GNU autoconf手册上说好像是 aclocal/*.m4),流程是这样的:
acinclude.m4
aclocal/*.m4 | === aclocal perl script (由automake提供) ===> aclocal.m4
configure.ac /
然后 autoconf 会在处理 configure.ac 之前先处理 aclocal.m4,使 acinclude.m4 aclocal/*.m4中包含的宏定义可在configure.ac中使用
aclocal/*.m4
- version.m4:定义_RTEMS_VERSION和_RTEMS_API常数
- rtems-top.m4:定义RTEMS_TOPdir=源代码顶层目录(相对路径)和PROJECT_TOPdir=build-tree顶层目录(相对路径)
- enable-cxx.m4:定义 --enable-cxx 选项,最终对应变量为 RTEMS_HAS_CPLUSPLUS,默认为 no
- enable-drvmgr.m4:定义 --enable-drvmgr 选项,最终对应变量为 RTEMS_DRVMGR_STARTUP,默认为 yes
- enable-multiprocessing.m4:定义 --enable-multiprocessing 选项,最终对应变量为 enable_multiprocessing,默认为 no
- enable-networking.m4:定义 --enable-networking 选项,最终对应变量为 RTEMS_HAS_NETWORKING,默认为 yes
- enable-paravirt.m4:定义 --enable-paravirt 选项,最终对应变量为 RTEMS_HAS_PARAVIRT,默认为 no
- enable-posix.m4:定义 --enable-posix 选项,最终对应变量为 RTEMS_HAS_POSIX_API, 默认为 yes
- enable-rtemsbsp.m4:定义 --enable-rtemsbsp 选项,最终对应变量为 enable_rtemsbsp,这是一个列表,每个--enable-rtemsbsp都会向这个列表中添加新的bsp,也可以一次性加入多个以空格分隔的bsp列表,默认为空
- enable-rtems-debug.m4:定义 --enable-rtems-debug 选项,最终对应变量为 enable_rtems_debug, 默认为 no
- enable-smp.m4:定义 --enable-smp 选项,最终对应变量为 RTEMS_HAS_SMP, 默认为 no
- enable-tests.m4:定义 --enable-tests 选项,最终对应变量为 enable_tests, 取值可为 yes/no/samples 默认为 samples
- multilib.m4:定义 --enable-multilib 选项,最终对应变量为 multilib, 默认为 no,同时定义了automake条件 MULTILIB,将会定义两个autoconf变量,@@MULTILIB_TRUE@@和@@MULTILIB_FALSE@@可在makefile中使用,一个将被定义为空,另一个为#(makefile注释)
- path-ksh.m4:将 bash/ksh/sh中第一个找到的shell的绝对路径设置到KSH变量中,AC_PATH_PROGS和AC_CHECK_PROGS相似,但设置的是绝对路径
- project-root.m4:设置 PACKHEX和BIN2C变量,指向编译好的tools/build/packhex和rtems-bin2c工具
- canonical-target-name.m4:从$target变量中获取RTEMS_CPU变量
- check-bsps.m4:定义 RTEMS_CHECK_BSPS 该宏将参数指定的shell变量赋于所有BSP列表(此处隐含rtems的BSP是不能重名的),所有BSP是怎么确定的呢?其实先 ls c/lib/libbsp/$RTEMS_CPU/*/bsp_specs,其中 * 就是bsp family,然后再找bsp family 文件夹下的 make/custom/*.cfg,这就是bsp了。对于beagle来说,就是 c/lib/libbsp/arm/beagle/make/custom/*.cfg 即 beagleboardorig / beagleboardxm / beagleboneblack / beaglebonewhite
- check-custom-bsp.m4:定义了 _RTEMS_CHECK_CUSTOM_BSP[bsp_name, path],查找 <bsp_name>.cfg文件是否存在,并将全路径赋于 <path> 的shell变量
- bsp-alias.m4:定义了 _RTEMS_BSP_ALIAS[bsp_path, bsp_family],根据bsp配置的文件路径返回bsp_family,bsp_path 默认为 $RTEMS_BSP,bsp_family 默认为 RTEMS_BSP_FAMILY
acinclude.m4 文件有点复杂,没有仔细看,另外,我发现 c/src/aclocal 和 cpukit/aclocal 有很多与 顶层目录的 aclocal 目录中相似或相同的文件(这种设计应该是有问题的),暂时也用不着,先不管了,知道怎么加一个bsp就可以继续向前了。