嵌入式hi3516-hi3518海思平台移植nginx-1.12.2

参考：http://blog.csdn.net/fish43237/article/details/40515897


正文：
    先编译了linux下的nginx没有太大的问题。但是因为 nginx 对交叉编译的支持不太好。所以如果想 nginx 移植到其它环境中，会出现比较多的问题。本文 编译的是 最新的 stalble 版本，nginx-1.12.2， 目标是海思的hi3518， 编译器为arm-hisvi100nptl-linux。


pcre-8.41：下载地址 https://ftp.pcre.org/pub/pcre/pcre-8.41.tar.gz
nginx-1.12.2 :下载地址 http://nginx.org/en/download.html
openssl-1.0.2l :  下载地址 https://www.openssl.org/source/old/
分别解压到/home/share/opensource




1、环境设置、声明变量、执行configure
（1）cd nginx-1.12.2/
（3）nginx 编译用到的变量
 BUILD_PATH=$PWD
 INSTALL_PATH=/opt/nginx     //安装目录，可自定义
CC_PATH=/opt/hisi-linux-nptl/arm-hisiv100-linux/target/bin/arm-hisiv100nptl-linux-gcc 
   CPP_PATH=/opt/hisi-linux-nptl/arm-hisiv100-linux/target/bin/arm-hisiv100nptl-linux-g++
   CONFIG_DIR=/opt/nginx/conf
   LOG_DIR=/opt/nginx/log
   TEMP_DIR=/opt/nginx/tmp


（4）执行configure，生成Makefile
./configure \
--prefix=$INSTALL_PATH \
--conf-path=$CONFIG_DIR/nginx.conf \
--error-log-path=$LOG_DIR/error.log \
--pid-path=$CONFIG_DIR/nginx.pid \
--lock-path=$CONFIG_DIR/nginx.lock \
--http-log-path=$LOG_DIR/access.log \
--http-client-body-temp-path=$TEMP_DIR/body \
--http-proxy-temp-path=$TEMP_DIR/proxy \
--http-fastcgi-temp-path=$TEMP_DIR/fastcgi \
--without-http_uwsgi_module \
--without-http_scgi_module \
--without-http_gzip_module \
--with-http_ssl_module \
--with-pcre=/home/share/opensource/pcre-8.41 \
--with-openssl=/home/share/opensource/openssl-1.0.2l \
--with-cc=$CC_PATH  \
--with-cpp=$CPP_PATH \
--with-cc-opt="-I /opt/hisi-linux-nptl/arm-hisiv100-linux/target/bin" \
--with-ld-opt="-L /opt/hisi-linux-nptl/arm-hisiv100-linux/target/lib" \
--with-http_ssl_module


（4）执行make 和make install




二、遇到的问题
（1）问题内容：
 + Linux 3.2.0-29-generic-pae i686
checking for C compiler ... found but is not working


./configure: error: C compiler /opt/hisi-linux-nptl/arm-hisiv100-linux/target/bin/arm-hisiv100nptl-linux-gcc is not found


（2）原因分析：
configure首先会编译一个小测试程序，通过测试其运行结果来判断编译器是否能正常工作，由于交叉编译器所编译出的程序是无法在编译主机上运行的，故而产生此错误。
（3）解决办法：
编辑auto/cc/name文件，将21行的“exit 1”注释掉（令测试程序不会报错）。


三、遇到的问题
（1）问题内容：
autotest : 4 : not found 
autotest:Syntax error: Unterminated quoted string bytes 
./configure : error:can not detect int size
cat : /home/ubuntu/packets/nginx-1.6.2/build/autotest.c: No such file or directory
（2）原因分析：
configure通过运行测试程序来获得“int、long、longlong”等数据类型的大小，由于交叉编译器所编译出的程序无法在编译主机上运行而产生错误。
（3）解决办法：可以通过修改configure文件来手动指定各数据类型的大小，但会非常麻烦。这里，由于编译主机与目标平台均为32位系统，故可以用“gcc”替代“mips-openwrt-linux-gcc”来进行数据类型大小的测试（注意：不同的编译环境可能编译器有点不同）
编辑auto/types/sizeof文件，大概36行的位置（ $CC 改为 gcc ）
ngx_test="$CC $CC_TEST_FLAGS $CC_AUX_FLAGS
该为ngx_test="gcc $CC_TEST_FLAGS $CC_AUX_FLAGS 


四、遇到的问题
（1）问题内容：
./configure:error:can not detect int size
cat:/home/ubuntu/packets/nginx-1.6.2/build/autotest.c: No such file ordirectory
（2）原因分析：检测不到size
（3）解决办法：两个问题，一个是检测不到size。一个是找不到测试程序源代码。
先解决 size 问题，修改 auto/types/sizeof 文件，找到 ngx_size= 这一行，改为 ngx_size=4
修改完之后，再次configure，发现 autotest.c 的问题也消失了。


五、遇到的问题：
（1）问题内容：sha1 library is not found
（2）原因分析：弄不清楚
（3）解决办法：configure的时候增加参数 --with-http_ssl_module


六、遇到的问题：
（1）问题内容：./configure : error :SSL modules require the OpenSSL library.
（2）原因分析：没有说清楚openssl的源代码路径
（3）解决办法：指明openssl代码的路径。--with-openssl=DIR（DIR表示openssl源代码解压的路径）


七、遇到的问题：
（1）问题内容： make:没有什么可以做的为`default'。
（2）原因分析：没有说清楚openssl的源代码路径
（3）解决办法：
进入build目录（具体是哪个目录，需要察看Makefile，执行make）
譬如说我的 configure 生成的 Makefile 里面有一段
build:
$(MAKE) -f /home/ubuntu/packets/nginx-1.6.2/build/Makefile
$(MAKE) -f /home/ubuntu/packets/nginx-1.6.2/build/Makefile manpage
所以应该进入/home/ubuntu/packets/nginx-1.6.2/build目录，执行make


八、遇到的问题
（1）问题内容：没有规则可以创建 “/home/ubuntu/packets/nginx-1.4.7/build/src/core/nginx.o” 需要的目标 “src/core/nginx.h” 。
（2）原因分析：不知道是不是软件的 bug，指定build路径后，build路径里面的源代码是空的
（3）解决办法：把主目录的src文件夹里面的东西，拷贝到build目录（build目录请根据自己实际情况进行确定，参考上面那个问题）


九、遇到的问题
（1）问题内容：
checking whether we are cross compiling... configure: error: in `/home/share/opensource/pcre-8.41':
configure: error: cannot run C compiled programs.
If you meant to cross compile, use `--host'.
See `config.log' for more details
make[1]: *** [/home/share/opensource/pcre-8.41/Makefile] 错误 1


（2）原因分析：出错的是pcre而不是openssl。原因是编译 pcre 没有指定 `--host' 参数
（3）解决办法：
打开objs/Makefile，找到 pcre 参数设定的那几行。
1171 /home/share/opensource/pcre-8.41/Makefile:      objs/Makefile
1172         cd /home/share/opensource/pcre-8.41 \
1173         && if [ -f Makefile ]; then $(MAKE) distclean; fi \
1174         && CC="$(CC)" CFLAGS="-O2 -fomit-frame-pointer -pipe " \
1175         ./configure --disable-shared --host=arm-hisiv100nptl-linux 


在configure那里再添加一个参数 --host=arm-hisiv100nptl-linux(根据自己的编译器修改)


十、遇到的问题
（1）问题内容：
src/os/unix/ngx_errno.c: In function 'ngx_strerror':
src/os/unix/ngx_errno.c:37: error: 'NGX_SYS_NERR' undeclared (first use in this function)
src/os/unix/ngx_errno.c:37: error: (Each undeclared identifier is reported only once
src/os/unix/ngx_errno.c:37: error: for each function it appears in.)
src/os/unix/ngx_errno.c: In function 'ngx_strerror_init':
src/os/unix/ngx_errno.c:58: error: 'NGX_SYS_NERR' undeclared (first use in this function)
make[1]: *** [objs/src/os/unix/ngx_errno.o] 错误 1
（2）原因分析：
NGX_SYS_NERR未定义，NGX_SYS_NERR正常情况下应定义在objs/ngx_auto_config.h文件中，特别注意，这是一个auto性质的文件，只有在执行了./configure后，才能生成这个文件。宏NGX_SYS_NERR的意义为，在Linux系统中有132个错误编码。
（3）解决办法：
找到ngx_auto_config.h这个文件（我的ngx_auto_config.h objs目录下，不同的configure参数，这个文件的位置可能不一样）


在文件中添加如下三行：
#ifndef NGX_SYS_NERR
#define NGX_SYS_NERR  132
#endif
然后，继续执行make。


十一、遇到的问题
（1）问题内容：
./dftables pcre_chartables.c
/bin/bash:./dftables:无法执行二进制文件
（2）原因分析：dftables需要在编译的时候运行，而交叉编译的程序是不能运行的，要用系统的gcc来编译才能运行
（3）解决办法：用x86的gcc来单独编译dftables（我的是ubuntu自带的gcc）。
进入pcre代码所在的目录，并且执行
gcc -Wall -O2 -DCROSS_COMPILE dftables.c -o dftables
执行完之后，返回刚才的目录，执行 make 继续编译


十二、遇到的问题
（1）问题内容：
/opt/hisi-linux-nptl/arm-hisiv100-linux/bin/../lib/gcc/arm-hisiv100-linux-uclibcgnueabi/4.4.1/../../../../arm-hisiv100-linux-uclibcgnueabi/bin/ld: /home/share/opensource/openssl-1.0.2l/.openssl/lib/libssl.a(s23_meth.o): Relocations in generic ELF (EM: 3)
/opt/hisi-linux-nptl/arm-hisiv100-linux/bin/../lib/gcc/arm-hisiv100-linux-uclibcgnueabi/4.4.1/../../../../arm-hisiv100-linux-uclibcgnueabi/bin/ld: /home/share/opensource/openssl-1.0.2l/.openssl/lib/libssl.a(s23_meth.o): Relocations in generic ELF (EM: 3)
/opt/hisi-linux-nptl/arm-hisiv100-linux/bin/../lib/gcc/arm-hisiv100-linux-uclibcgnueabi/4.4.1/../../../../arm-hisiv100-linux-uclibcgnueabi/bin/ld: /home/share/opensource/openssl-1.0.2l/.openssl/lib/libssl.a(s23_meth.o): Relocations in generic ELF (EM: 3)
/home/share/opensource/openssl-1.0.2l/.openssl/lib/libssl.a: could not read symbols: File in wrong format
collect2: ld returned 1 exit status
make[1]: *** [objs/nginx] 错误 1


（2）原因分析：原因是编译在nginx执行configure的时候，交叉编译参数没有很好的传到openssl。
（3）解决办法：
打开主目录的Makefile，搜索到包含 /home/share/opensource/openssl-1.0.2l/.openssl/include/openssl/ssl.h:的那一行（可能不同的版本会有一点点区别，搜索openssl，找到最接近那行）
然后，在config的参数那里增加一个，指明交叉编译器所在的路径（请根据实际情况设定）
 --cross-compile-prefix=/opt/hisi-linux-nptl/arm-hisiv100-linux/target/bin/arm-hisiv100nptl-linux- \


(需要注意的是，最后那里的横杠不能少，如果编译器是arm-hisiv100nptl-linux-gcc那就是arm-hisiv100nptl-linux-，如果是arm-linux-gcc就是arm-linux-)
修改完makefile之后，会导致make把所有东西都构建一遍，所以之前已经解决了的那几个问题可能会重新出现，需要再解决一回。


十三、遇到的问题
（1）问题内容：
x86cpuid.s: Assembler messages:
x86cpuid.s:4: Error: unrecognized symbol type ""
x86cpuid.s:5: Error: alignment too large: 15 assumed
x86cpuid.s:8: Error: bad instruction `pushl %ebp'
x86cpuid.s:9: Error: bad instruction `pushl %ebx'
.......
（2）原因分析：原因是编译在nginx执行configure的时候，交叉编译参数没有很好的传到openssl。
（3）解决办法：找到上面那个问题添加--cross-compile-prefix的那一行，继续添加一个参数no-asm，禁用汇编代码。


十四、遇到的问题
（1）问题内容：
objs/src/core/ngx_cycle.o: In function `ngx_init_cycle':
/home/share/opensource/nginx-1.12.2/src/core/ngx_cycle.c:473: undefined reference to `ngx_shm_free'
/home/share/opensource/nginx-1.12.2/src/core/ngx_cycle.c:478: undefined reference to `ngx_shm_alloc'
/home/share/opensource/nginx-1.12.2/src/core/ngx_cycle.c:675: undefined reference to `ngx_shm_free'
objs/src/event/ngx_event.o: In function `ngx_event_module_init':
/home/share/opensource/nginx-1.12.2/src/event/ngx_event.c:506: undefined reference to `ngx_shm_alloc'
collect2: ld returned 1 exit status
make[1]: *** [objs/nginx] 错误 1


（2）原因分析：`ngx_shm_free'函数未定义
通过查看源码可以发现，`ngx_shm_free'定义在
src/os/unix/ngx_shmem.c文件中，这个函数要正常使用的话必须要求
“NGX_HAVE_MAP_ANON、NGX_HAVE_MAP_DEVZERO、NGX_HAVE_SYSVSHM”这三个宏中有一个被定义。
（3）解决办法：
修改ngx_auto_config.h ,加入这几行：
#ifndef NGX_HAVE_SYSVSHM
#define NGX_HAVE_SYSVSHM 1
#endif