将Boa移植到Android平台上

/>
boa是一款轻量级的、高性能的嵌入式web服务器，和普通的web服务器一样，它能够解析http协议，完成接收客户端的请求，分析请求，响应请求，向客户端返回响应结果等任务。本文将介绍如何把它移植到Android平台上。下面是具体的移植步骤：

一、移植准备：
（1）Android源码，可以到google网站下载。
（2）boa源码，本人用的版本是0.94.13，可以到 下载。

二、在Android平台上编译boa和boa_indexer
将boa移植到Android平台上，最主要一点就是把boa的makefile改成Android平台上的makefile，即Android.mk。
我们首先将boa源码目录拷贝到Android源码的一个目录下，比如external目录下，然后在boa源码目录下新建Android.mk文件，参照boa的makefile，将生成boa可执行程序需要的那些源文件放在Android.mk的LOCAL_SRC_FILES:=中，如下：

/*****************************************************************************/
LOCAL_SRC_FILES:=
         src/lex.yy.c
         src/y.tab.c
         src/alias.c
         src/boa.c
         src/buffer.c
         src/cgi.c
         src/cgi_header.c
         src/config.c
         src/escape.c
         src/get.c
         src/hash.c
         src/ip.c
         src/log.c
         src/mmap_cache.c
         src/pipe.c
         src/queue.c
         src/read.c
         src/request.c
         src/response.c
         src/select.c
         src/signals.c
         src/util.c
         src/sublog.c
         src/timestamp.c

/*****************************************************************************/
接着，将boa的makefile中的编译规则GCC_FLAGS，搬到Android.mk的LOCAL_CFLAGS后面，如下：
/*****************************************************************************/
LOCAL_CFLAGS := -Wstrict-prototypes -Wpointer-arith -Wcast-align -Wcast-qual
      -Wtraditional
      -Wshadow
      -Wconversion
      -Waggregate-return
      -Wmissing-prototypes
      -Wnested-externs
      -Wall
      -Wundef -Wwrite-strings -Wredundant-decls –Winline

/*****************************************************************************/
最后，生成boa可执行程序，如下：
/*****************************************************************************/
LOCAL_MODULE:= boa
include $(BUILD_EXECUTABLE)
/*****************************************************************************/
注意：源码中的lex.yy.c在boa的源文件中找不到，但从makefile中我们可看出该文件由flex调用boa_lexer.l脚本生成的，命令如下：
flex  boa_lexer.l，所以，我们需要手动执行该命令，先生成lex.yy.c。
至此，在Android源码根目录下执行"make boa",便可执行程序boa生成。
接下来是boa_indexer，
这个的makefile 更简单，因为源文件较少，只有两个，它的makefile如下：
/*****************************************************************************/

include $(CLEAR_VARS)
LOCAL_SRC_FILES:=
         src/index_dir.c
         src/escape.c
 
LOCAL_SHARED_LIBRARIES :=
         libcutils
 
LOCAL_CFLAGS := -Wstrict-prototypes -Wpointer-arith -Wcast-align -Wcast-qual
      -Wtraditional
      -Wshadow
      -Wconversion
      -Waggregate-return
      -Wmissing-prototypes
      -Wnested-externs
      -Wall
      -Wundef -Wwrite-strings -Wredundant-decls –Winline
 
LOCAL_MODULE:= boa_indexer
include $(BUILD_EXECUTABLE)

/*****************************************************************************/
改好后，make boa_indexer,搞定。
编译的过程中，可能不会那么顺利，由于Android的C库跟其他的嵌入式工具链的C库有较大差别，所以编译过程中肯定会出现一些错误，但不要紧，按照错误提示，适当改一下就没问题了。

三、把boa放到Android目标板上运行

1.在pc上配置好boa.conf,关键要配置好以下几项
 1）修改 Group nogroup 为 Group 0
 2）修改 ErrorLog /var/log/boa/error_log 为 ErrorLog /etc/boa/log/error_log
 3）修改 AccessLog /var/log/boa/access_log 为 AccessLog  /etc/boa/log/access_log
 4）修改 #ServerName 为 ServerName
 5）修改 DocumentRoot /var/www 为 DocumentRoot /etc/boa/www
 6）修改 MimeTypes /etc/mime.types 为 MimeTypes /etc/boa/mime.types
 7）修改 ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/ 为
ScriptAlias /cgi-bin/ /etc/boa/www/cgi-bin/

 上面的几项修改好后，在Android目标板上创建跟上面配置相应的目录，如下：
 /etc/boa/用于存放所有关于boa的东西，
 /etc/boa/log用于存放日志文件，
 /etc/boa/www用于存放静态网页，
 /etc/boa/www/cgi-bin/，用于存放cgi脚本程序

2.使用adb将boa相关制品push到Android目标板上（本人用的是带wifi的Android手机）
 （1）push boa到/etc/boa目录下。
         命令：adb push boa /etc/boa
（2）push boa_indexer到/etc/boa目录下。
         命令：adb push boa_indexer /etc/boa
 （3）push mime.types到/etc/boa目录下，mime.types可以从PC的/etc目录下取得。
   命令：adb push mime.types /etc/boa
 （4）push一个简单的静态html页面到/etc/boa/www目录下。
   命令：adb push xxx.html /etc/boa/www

3.测试
 （1）启动目标板的wifi，并将其设为热。
 （2）将电脑连接到目标板的wifi热点上。
 （3）启动目标板的boa服务器。
 （4）在浏览器上输入wifi热点的ip地址，例如192.168.2.254，如果正常，你将能看到刚放进去的xxx.html页面。

到这里，移植到我们的目标板上的boa算是可以跑了，但这并不代表boa就没问题了，现在的boa只能处理简单的客户端的get请求而已，还无法支持客户端的post请求，这个问题的根本原因是用户权限不够导致的，处理post请求，boa必须先取得root权限，但boa的配置默认不是root权限，所以我们必须首先要给boa root权限，改两个地方即可，
（1）修改配置文件boa.conf中的User nobody 改为: User root。
（2）注释掉boa.c源文件中的如下几行代码：
     if( setuid(0)!=-1 ){
         DIE(“icky Linux kernel bug!”);
}

至此，boa到Android平台的移植完成。