auto/headers脚本分析-part9

本节我们介绍auto/headers脚本，其主要用于包含类Unix操作系统下的头文件。所关联的脚本文件主要有两个：

auto/include脚本文件
auto/headers脚本文件

1. auto/include脚本

脚本内容如下：

# Copyright (C) Igor Sysoev
# Copyright (C) Nginx, Inc.


echo $ngx_n "checking for $ngx_include ...$ngx_c"

cat << END >> $NGX_AUTOCONF_ERR

----------------------------------------
checking for $ngx_include

END


ngx_found=no

cat << END > $NGX_AUTOTEST.c

$NGX_INCLUDE_SYS_PARAM_H
#include <$ngx_include>

int main() {
    return 0;
}

END


ngx_test="$CC -o $NGX_AUTOTEST $NGX_AUTOTEST.c"

eval "$ngx_test >> $NGX_AUTOCONF_ERR 2>&1"

if [ -x $NGX_AUTOTEST ]; then

    ngx_found=yes

    echo " found"

    ngx_name=`echo $ngx_include \
              | tr abcdefghijklmnopqrstuvwxyz/. ABCDEFGHIJKLMNOPQRSTUVWXYZ__`


    have=NGX_HAVE_$ngx_name . auto/have_headers

    eval "NGX_INCLUDE_$ngx_name='#include <$ngx_include>'"

    #STUB
    eval "NGX_$ngx_name='#include <$ngx_include>'"

else
    echo " not found"

    echo "----------"    >> $NGX_AUTOCONF_ERR
    cat $NGX_AUTOTEST.c  >> $NGX_AUTOCONF_ERR
    echo "----------"    >> $NGX_AUTOCONF_ERR
    echo $ngx_test       >> $NGX_AUTOCONF_ERR
    echo "----------"    >> $NGX_AUTOCONF_ERR
fi

rm -rf $NGX_AUTOTEST*

下面我们对脚本进行分析。

1.1 打印相关提示信息

分别向控制台及autoconf.err文件中打印相应的提示信息：

echo $ngx_n "checking for $ngx_include ...$ngx_c"

cat << END >> $NGX_AUTOCONF_ERR

----------------------------------------
checking for $ngx_include

END

$ngx_n及$ngx_c我们前面讲述过，分别指相应的换行符和退行符。$ngx_include这里为所需要包含的头文件。

1.2 生成测试程序并编译

如下首先将ngx_found的值置为no,然后生成autotest.c源文件并编译。

ngx_found=no

cat << END > $NGX_AUTOTEST.c

$NGX_INCLUDE_SYS_PARAM_H
#include <$ngx_include>

int main() {
    return 0;
}

END


ngx_test="$CC -o $NGX_AUTOTEST $NGX_AUTOTEST.c"

eval "$ngx_test >> $NGX_AUTOCONF_ERR 2>&1"

1.3 处理程序运行结果

if [ -x $NGX_AUTOTEST ]; then

    ngx_found=yes

    echo " found"

    ngx_name=`echo $ngx_include \
              | tr abcdefghijklmnopqrstuvwxyz/. ABCDEFGHIJKLMNOPQRSTUVWXYZ__`


    have=NGX_HAVE_$ngx_name . auto/have_headers

    eval "NGX_INCLUDE_$ngx_name='#include <$ngx_include>'"

    #STUB
    eval "NGX_$ngx_name='#include <$ngx_include>'"

else
    echo " not found"

    echo "----------"    >> $NGX_AUTOCONF_ERR
    cat $NGX_AUTOTEST.c  >> $NGX_AUTOCONF_ERR
    echo "----------"    >> $NGX_AUTOCONF_ERR
    echo $ngx_test       >> $NGX_AUTOCONF_ERR
    echo "----------"    >> $NGX_AUTOCONF_ERR
fi

根据生成的程序是否可执行，分成如下两种情况处理：

(1) 程序存在并且可执行

将ngx_found变量置为yes,同时对$ngx_include变量所引用的头文件名将小写转换成成大写，将/.转换成__保存在变量$ngx_name中。

接着再调用auto/have_headers脚本文件向ngx_auto_headers.h头文件中写入NGX_HAVE_$ngx_name的宏定义。

最后再赋值给NGX_INCLUDE_$ngx_name和NGX_$ngx_name这两个变量，用于保存对应的头文件信息。

(2) 程序不存在或者不可执行

向控制台及objs/autoconf.err文件打印相应的信息。

1.4 删除生成的测试程序

rm -rf $NGX_AUTOTEST*

2. auto/headers脚本