nginx源码分析configure脚本详解

cd nginx; ./auto/configure --with-pcre && make

################## nginx/auto/configure #######################
#!/bin/sh
 
# Copyright (C) Igor Sysoev
# Copyright (C) Nginx, Inc.
 
LC_ALL=C
export LC_ALL
 
#执行auto/options文件中的命令，行中的“.”表示在当前的sh环境中执行auto/options
#文件中的命令（与source命令效果一样）不同于sh命令会导致创建子进程，由于configure
#文件中命令与options的命令都在同一sh环境下，所以变量在两个文件中都是彼此可见的
. auto/options   #设置变量，并将之置空
. auto/init     #初始化一些变量诸如：NGX_AUTO_HEADERS_H=$NGX_OBJS/ngx_auto_headers.h
. auto/sources   #设置核心模块、平台代码对应的源文件
 
test -d $NGX_OBJS || mkdir -p $NGX_OBJS
 
echo > $NGX_AUTO_HEADERS_H
echo > $NGX_AUTOCONF_ERR
 
echo "#define NGX_CONFIGURE \"$NGX_CONFIGURE\"" > $NGX_AUTO_CONFIG_H
 
if [ $NGX_DEBUG = YES ]; then
  have=NGX_DEBUG . auto/have   #设置NGX_DEBUG=1
fi
 
.....
 
. auto/cc/conf   #检查编译器相关选项
 
if [ "$NGX_PLATFORM" != win32 ]; then
  . auto/headers   #检查相关头文件，并将结果输出到ngx_auto_headers.h文件中
fi
 
. auto/os/conf   #检查系统平台所需的函数
 
if [ "$NGX_PLATFORM" != win32 ]; then
  . auto/unix   #检查unix环境下一些文件、函数
fi  
 
. auto/threads
 
#统计要编译到nginx中的模块信息，创建并初始化ngx_module_t *ngx_modules[]和
#char *ngx_module_names[]两个数组中（这两个数组在init_cycle中被调用）存放
#到之前创建的nginx/objs/ngx_modules.c文件中
. auto/modules  
. auto/lib/conf
 
.......
 
#定义变量NGX_SBIN_PATH的值为"\"$NGX_SBIN_PATH\""
have=NGX_SBIN_PATH value="\"$NGX_SBIN_PATH\"" . auto/define 
have=NGX_CONF_PATH value="\"$NGX_CONF_PATH\"" . auto/define
have=NGX_PID_PATH value="\"$NGX_PID_PATH\"" . auto/define
 
......
 

################ nginx/auto/have ##############
cat << END >> $NGX_AUTO_CONFIG_H
 
#ifndef $have
#define $have 1
#endif
 
END

#ifndef NGX_PCRE
#define NGX_PCRE 1
#endif

############## nginx/auto/modules ################
......
modules="$modules $MISC_MODULES"
 
cat << END                  > $NGX_MODULES_C
 
#include <ngx_config.h>
#include <ngx_core.h>
 
$NGX_PRAGMA
 
END
 
#声明模块为全局变量
for mod in $modules
do
  echo "extern ngx_module_t $mod;"     >> $NGX_MODULES_C
done
 
#定义并初始化ngx_module_t *ngx_modules[] 数组，然后输出重定向到$NGX_MODULES_C
echo                     >> $NGX_MODULES_C
echo 'ngx_module_t *ngx_modules[] = {'    >> $NGX_MODULES_C
 
for mod in $modules
do
  echo "  &$mod,"             >> $NGX_MODULES_C
done
 
cat << END                  >> $NGX_MODULES_C
  NULL
};
 
END
 
#定义并初始化char *ngx_module_names[]数组，然后输出重定向到$NGX_MODULES_C
echo 'char *ngx_module_names[] = {'      >> $NGX_MODULES_C
 
for mod in $modules
do
  echo "  \"$mod\","           >> $NGX_MODULES_C
done
 
cat << END                  >> $NGX_MODULES_C
  NULL
};
 
END
.......

################# nginx/auto/unix ###############
......
#定义当前feature的各个元素
ngx_feature="poll()"
ngx_feature_name=
ngx_feature_run=no
ngx_feature_incs="#include <poll.h>"
ngx_feature_path=
ngx_feature_libs=
#测试当前feature是否可用的代码段
ngx_feature_test="int n; struct pollfd pl;
         pl.fd = 0;
         pl.events = 0;
         pl.revents = 0;
         n = poll(&pl, 1, 0);
         if (n == -1) return 1"
#利用上面定义的各个变量测试poll()函数这个feature是否可用
. auto/feature
 
#如果上述的测试结果表明该feature不可用，就将相应的宏设置为NONE
if [ $ngx_found = no ]; then
  EVENT_POLL=NONE
fi
......

################# nginx/auto/feature ###############
......
 
#利用cat命令将END分隔符之间的内容（与测试feature的代码段组合成的一个简单的C程序）
#写到 $NGX_AUTOTEST.c文件中
cat << END > $NGX_AUTOTEST.c
 
#include <sys/types.h>
$NGX_INCLUDE_UNISTD_H
$ngx_feature_incs
 
int main(void) {
  $ngx_feature_test;
  return 0;
}
 
END
 
#将编译链接$NGX_AUTOTEST.c的命令赋值给ngx_test变量
ngx_test="$CC $CC_TEST_FLAGS $CC_AUX_FLAGS $ngx_feature_inc_path \
     -o $NGX_AUTOTEST $NGX_AUTOTEST.c $NGX_TEST_LD_OPT $ngx_feature_libs"
 
ngx_feature_inc_path=
 
#执行ngx_test变量指向的编译、链接指令，完成对$NGX_AUTOTEST.c的编译、链接生成可执行程序NGX_AUTOTEST
eval "/bin/sh -c \"$ngx_test\" >> $NGX_AUTOCONF_ERR 2>&1"
 
#检查是否成功生成可执行程序$NGX_AUTOTEST
if [ -x $NGX_AUTOTEST ]; then
   #根据feature的类型，采用不同的方案验证feature的可行性
  case "$ngx_feature_run" in
    yes)
      # /bin/sh is used to intercept "Killed" or "Abort trap" messages
      #执行对应的可执行程序，并重定向输出
      if /bin/sh -c $NGX_AUTOTEST >> $NGX_AUTOCONF_ERR 2>&1; then
        #执行成功，将ngx_found设成yes，表示该feature可用
        echo " found"
        ngx_found=yes
 
        #调用auto/have文件，在$NGX_AUTO_CONFIG_H 文件中，设置该feature对应的宏的值为1（启用该feature）
        if test -n "$ngx_feature_name"; then
          have=$ngx_have_feature . auto/have
        fi
 
      else
        echo " found but is not working"
      fi
    ;;
......