M4宏什么鬼
一 背景
本来以为通过上周的学习,已经对整个流程已经比较熟悉了,但是没想到还是遇到undefined reference to
问题,虽然很快通过添加依赖的类库解决了,但是为什么生成的Makefile没有引入库,还是需要分析下configure.ac,本着不能错误进步机会,留下知识盲点的原则,还是进一步学习下m4宏的一些基础语法.
GNU M4是传统UNIX宏处理器的一种实现方式,它还具有一些内置功能,包括文件,shell,运算等。
作为一个宏处理器,将输入复制到扩展的输出,它要么内置,要么用户定义,且可以接受参数。
另外这个还有内置函数,包括命名文件、运行UNIX命令、执行整数运算、以各种方式操作文本、递归等。M4既可以作为编译器的前端使用,也可以作为自己的宏处理器使用。
GNU M4的最大用户之一是GNU AutoCOF项目。
二 AC_ARG_ENABLE
AC_ARG_ENABLE
是属于M4的宏代码中的,意思是做个标识,标识我们启用或者禁用某个功能,这样我们在调用configure
的时候,可以根据实际的环境情况,可能禁止或启用特定功能。
多数库的引入都可以采用这个模板,稍微改下就可以,虽然我也改过,但是对含义不是特别清楚,梳理下,一段段贴出来解读下:
AC_ARG_ENABLE(mysql,
AS_HELP_STRING([--enable-mysql],[Enable MySql output support]),
[ enable_mysql="yes"],
[ enable_mysql="no"])
AC_ARG_ENABLE
语法说明如下:
AC_ARG_ENABLE(option-name, help-string, [action-if-present,] [action-if-not-present])
AC_ARG_ENABLE
定义一个命令行选项,选项基本名字为option-name
,完整名字为:
enable-option-name
帮助字符串为:
help-string
,帮助字符串是./configure --help
会打印出来的信息,通过AS_HELP_STRING
将字符串格式化,截取一段如下显示:
action-if-present
为用户指定值执行的m4动作,action-if-not-present
为用户未指定值的时候执行的动作。
上文的m4宏,只有两个参数,省略了,很多,我们看看一般的用法:
我们如果在调用configure
时候指定:
--enable-mysql=yes
或者--enable-mysql
则宏变量:enable_mysql
值为yes。
如果指定:
--enable_mysql=no
或者-disable_mysql
则宏变量enable_mysql
值为no。
帮助字符串信息见上面截图。
三 AC_ARG_WITH
一般我们当启用特定的功能后,有时候需要引入特定的库来支持这个功能,而这些库或头文件的位置在不同的机器上安装位置不同,所以可以通过这个宏来定义下具体的位置,语法非常类似:
AC_ARG_ENABLE
,只是使用的是with
开头,如下,引入了mysql的库的头文件定义和库位置定义。
AC_ARG_WITH(libmysql_includes,
[ --with-libmysql-includes=DIR libmysql include directory],
[with_libmysql_includes="$withval"],[with_libmysql_includes="no"])
AC_ARG_WITH(libmysql_libraries,
[ --with-libmysql-libraries=DIR libmysql library directory],
[with_libmysql_libraries="$withval"],[with_libmysql_libraries="no"])
configure指定:
--enable-mysql --with-libmysql-includes=/usr/include/mysql --with-libmysql-libraries=/usr/lib64
四 判断和真正引入库
刚才通过enable
来启用特定功能,用with
指定库和头文件位置,那么这些位置是不是对的,是不是真的有需要依赖的库,如果判断没问题,则真正通过-I
引入库的头文件,-L库路径
和-lxx
引入具体的库文件。
如下:
if test "$enable_mysql" = "yes"; then
if test "$with_libmysql_includes" != "no"; then
CPPFLAGS="${CPPFLAGS} -I${with_libmysql_includes}"
fi
AC_CHECK_HEADER(mysql.h,MYSQL="yes",MYSQL="no")
if test "$MYSQL" = "yes"; then
if test "$with_libmysql_libraries" != "no"; then
LDFLAGS="${LDFLAGS} -L${with_libmysql_libraries}"
fi
AC_CHECK_LIB(mysqlclient, mysql_thread_init,, MYSQL="no")
fi
if test "$MYSQL" = "no"; then
echo
echo " ERROR! libmysql library not found, go get it"
echo " from http://www.maxmind.com/en/geolite or your distribution:"
echo
echo " Ubuntu: apt-get install mysql-devel"
echo " Fedora: yum install mysql-devel"
echo
exit 1
fi
AC_DEFINE([HAVE_MYSQL],[1],[libmysql available])
enable_mysql="yes"
fi
这里面的基本语法应该都看得懂,就是AC_CHECK_HEADER
宏,比较简单,故名思意,就是检查头文件,如果mysql.h
存在,则定义MYSQL=yes
,不然就定义:MYSQL=no
,后面如果真正有,则引入库。
AC_CHECK_LIB
宏,也比较简单,判断库是否存在,
语法:
AC_CHECK_LIB(lib,function[,aciton_if_found[,action_if_not_found[,otherlibs]]])
,判断lib中是否存在指定函数function,如果测试成功,执行action_if_found
如果判断库里面不包含 action_if_not_found
中得命令。
五 pkg-config和PKG_CHECK_MODULES
5.1 pkg-config
刚才我们启动功能后,通过with
选项来指定库的位置和头文件位置,接着我们设置引入库和头文件。库的种类很多,库也可能也要依赖其他库,就造成去写执行库依赖很麻烦。
来看看pkg-config
一个命令的例子:
#pkg-config --cflags --libs htp
-I/usr/local/include -I/usr/local/lib/htp/include -L/usr/local/lib -lhtp
这样我们可以简化Makefile
CFLAGS := -O3 $(EXTRA_INC) -std=c++11 -I/usr/local/include -I/usr/local/lib/htp/include -L/usr/local/lib -lhtp
这部分就可以简化为:
CFLAGS := -O3 $(EXTRA_INC) -std=c++11 `pkg-config --cflags --libs htp`
pkg-config
为什么可以知道这些头文件的位置和依赖库的选项那,那是因为通过安装库的时候有.pc
文件来指明一些头文件,依赖库选项,举例如下:
#cat /home/peter/lib/pkgconfig/htp.pc
prefix=/home/peter
exec_prefix=${prefix}
libdir=${exec_prefix}/lib
includedir=${prefix}/include
Name: LibHTP
Description: A security-aware HTTP parser, designed for use in IDS/IPS and WAF products.
Version: 0.5.26
Libs: -L${libdir} -lhtp
Cflags: -I${includedir} -I${libdir}/htp/include
如果pkg-config
找不到库,则看看是不是pc文件的路径是不是在PKG_CONFIG_PATH
环境变量中,如果不在添加进去即可。
5.2 PKG_CHECK_MODULES
PKG_CHECK_MODULES
为m4宏,作用是利用pkg-config
来判断模块是否存在类似于通过:
pkg-config --libs --cflags --modversion nss
来检查错误。 具体的定义在pkg.m4中定义如下:
AC_DEFUN([PKG_CHECK_MODULES],
[AC_REQUIRE([PKG_PROG_PKG_CONFIG])dnl
AC_ARG_VAR([$1][_CFLAGS], [C compiler flags for $1, overriding pkg-config])dnl
AC_ARG_VAR([$1][_LIBS], [linker flags for $1, overriding pkg-config])dnl
pkg_failed=no
AC_MSG_CHECKING([for $1])
_PKG_CONFIG([$1][_CFLAGS], [cflags], [$2])
_PKG_CONFIG([$1][_LIBS], [libs], [$2])
m4_define([_PKG_TEXT], [Alternatively, you may set the environment variables $1[]_CFLAGS
and $1[]_LIBS to avoid the need to call pkg-config.
See the pkg-config man page for more details.])
if test $pkg_failed = yes; then
AC_MSG_RESULT([no])
_PKG_SHORT_ERRORS_SUPPORTED
if test $_pkg_short_errors_supported = yes; then
$1[]_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "$2" 2>&1`
else
$1[]_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "$2" 2>&1`
fi
# Put the nasty error message in config.log where it belongs
echo "$$1[]_PKG_ERRORS" >&AS_MESSAGE_LOG_FD
m4_default([$4], [AC_MSG_ERROR(
[Package requirements ($2) were not met:
$$1_PKG_ERRORS
Consider adjusting the PKG_CONFIG_PATH environment variable if you
installed software in a non-standard prefix.
_PKG_TEXT])[]dnl
])
elif test $pkg_failed = untried; then
AC_MSG_RESULT([no])
m4_default([$4], [AC_MSG_FAILURE(
[The pkg-config script could not be found or is too old. Make sure it
is in your PATH or set the PKG_CONFIG environment variable to the full
path to pkg-config.
_PKG_TEXT
To get pkg-config, see <http://pkg-config.freedesktop.org/>.])[]dnl
])
else
$1[]_CFLAGS=$pkg_cv_[]$1[]_CFLAGS
$1[]_LIBS=$pkg_cv_[]$1[]_LIBS
AC_MSG_RESULT([yes])
$3
fi[]dnl
])# PKG_CHECK_MODULES
它是在pkgconfig安装包中会安装到系统中,CentOS7下,缺省目录是:/usr/share/aclocal/pkg.m4,上次的文章即是pkg.m4
里面文件找不到,所以宏没有展开,直接原样在configure
里面了,所以报错,通过指定路径解决了这个问题:
autoreconf -I /usr/share/aclocal
六 问题
前几天遇到的问题是没有引入nss库,导致一堆没有定义符号的错误,为什么没能引入那,是通过PKG_CHECK_MODULES
这个m4宏来检查的时候,nss.pc文件所在的路径,没有在配置的PKG_CONFIG_PATH
路径中,所以认为nss库不存在,所以没有引入相关的库,从而报找不到符号的错误,简单的解决办法:
七 诗词欣赏
燕歌行
[唐] [高适]
汉家烟尘在东北,汉将辞家破残贼。男儿本自重横行,
天子非常赐颜色。摐金伐鼓下榆关,旌旆逶迤碣石间。
校尉羽书飞瀚海,单于猎火照狼山。山川萧条极边土,
胡骑凭陵杂风雨。战士军前半死生,美人帐下犹歌舞。
大漠穷秋塞草腓,孤城落日斗兵稀。身当恩遇恒轻敌,
力尽关山未解围。铁衣远戍辛勤久,玉箸应啼别离后。
少妇城南欲断肠,征人蓟北空回首。边庭飘飖那可度,
绝域苍茫更何有。杀气三时作阵云,寒声一夜传***斗。
相看白刃血纷纷,死节从来岂顾勋。君不见沙场征战苦,
至今犹忆李将军。
作者:明翼(XGogo)
-------------
公众号:TSparks
微信:shinelife
扫描关注我的微信公众号感谢
-------------