Boa服务器在ARM+Linux上的移植
转自
一、Boa服务器介绍
Boa是一种非常小巧的Web服务器，其可执行代码只有大约60KB左右。
作为一种单任务Web服务器，Boa只能依次完成用户的请求，而不会fork出新的进程来处理并发连接请求。但Boa支持CGI，能够为CGI程序fork出一个进程来执行。Boa的设计目标是速度和安全。
二、移植环境
（1） 源码的获取
Boa的源码可以从网站www.boa.org获取
（2） Boa移植平台
n PC机（RedHat9.0操作系统）
n 交叉编译工具,arm-linux,最好是2.9的
三、移植步骤
（1） 解压源码$ tar xzvf boa-0.94-14.tar.gz
（2） $cd boa-0.94-14 目录下，进入src目录中
（3） ./configure 配置安装文件，自动根据Makefile.in 生成Makefile文件
（4） 生成的Makefile文件是针对X86平台的，为了生成能够在ARM上运行的boa，
需要修改Makefile文件,用vi或则gedit修改Makefile文件中的CC = CC ；CPP = CC –E修改为自己的交叉编译器如：
CC = arm-linux-gcc ；和CC = arm-linux-gcc –E(这是在交叉编译器环境变量配置好的情况下，如果没有配置好，需要把路径填写完整)
（5） 然后执行make，生成可执行程序boa，就在src目录下面，后面就要用到这个可执行程序。
三、Boa.conf文件分析
在Boa源码目录下已有一个示例boa.conf，可以在其基础上进行修改，下面解释一下该文件的含义：
#监听的端口号，缺省都是80，一般无需修改注意，如果你你的httpd服务时已经开启，那么你必须关掉或者重新设定端口号，当你修改了模式http端口那么访问的时候要加上端口号，如http：//192.168.0.2:1100
Port 80
# bind调用的IP地址，一般注释掉，表明绑定到INADDR_ANY，通配于服务器的所有IP地址，
#Listen 192.68.0.5
#作为哪个用户运行，即它拥有该用户的权限，一般都是nobody，需
要 /etc/passwd中有nobody用户
User nobody
#作为哪个用户组运行，即它拥有该用户组的权限，一般都是nogroup，需要在/etc/group文件中有nogroup组
Group nogroup
#当服务器发生问题时发送报警的email地址，目前未用，注释掉
#ServerAdmin root@localhost
#错误日志文件。如果没有以/开始，则表示从服务器的根路径开始。如果不需要错误日志，则用#/dev/null。在下面设置时，注意一定要建立/var/log/boa目录，也可以将其注释掉否则为出现Can’t open /var/log/boa/error_log错误
ErrorLog /var/log/boa/error_log
#访问日志文件。如果没有以/开始，则表示从服务器的根路径开始。如果不需要错误日志，则用#/dev/null或直接注释掉。(在这里我遇到的问题是，cannot open /usr/boa/log/boa/access_log for logging,permission denied.<前面的路径是我定义的路径，大家依据自己的情况作适当修改>这是权限不足的问题，可是其它的方法我都试了一遍，也没有成功，最好把AcessLog /usr/boa/log/boa/access_log前面加个#号，也就是注掉，如下面，问题就解决了) 在下面设置时，注意一定要建立/var/log/boa目录,也可以将其注释掉否则会出错
#AccessLog /var/log/boa/access_log
#是否使用本地时间。如果没有注释掉，则使用本地时间。注释掉则使用UTC时间
#UseLocaltime
#是否记录CGI运行信息，如果没有注释掉，则记录，注释掉则不记录
#VerboseCGILogs
#服务器名字
ServerName www.shuzhengfeng.com
#是否启动虚拟主机功能，即设备可以有多个网络接口，每个接口都可以拥有一个虚拟的Web服务器。一般注释掉，即不需要启动
#VirtualHost
#非常重要，HTML文档的主目录。如果没有以/开始，则表示从服务器的根路径开始。注意，如果此处设置不正确，将不能打开网页
DocumentRoot /var/www
#如果收到一个用户请求的话，在用户主目录后再增加的目录名
UserDir public_html
#HTML目录索引的文件名，也是没有用户只指明访问目录时返回的文件名
DirectoryIndex index.html
#当HTML目录没有索引文件时，用户只指明访问目录时，boa会调用该程序生成索引文件然后返回给用户，因为该过程比较慢最好不执行，可以注释掉或者给每个HTML目录加上DirectoryIndex指明的文件
#DirectoryMaker /usr/lib/boa/boa_indexer
#如果DirectoryIndex不存在，并且DirectoryMaker被注释，那么就用Boa自带的索引生成程序来生成目录的索引文件并输出到下面目录，该目录必须是Boa能读写
# DirectoryCache /var/spool/boa/dircache
#一个连接所允许的HTTP持续作用请求最大数目，注释或设为0都将关闭HTTP持续作用
KeepAliveMax 1000
#HTTP持续作用中服务器在两次请求之间等待的时间数，以秒为单位，超时将关闭连接
KeepAliveTimeout 10
#指明mime.types文件位置。如果没有以/开始，则表示从服务器的根路径开始。可以注释掉避免使用mime.types文件，此时需要用AddType在本文件里指明
MimeTypes /etc/mime.types
#文件扩展名没有或未知的话，使用的缺省MIME类型
DefaultType text/plain
#提供CGI程序的PATH环境变量值
CGIPath /bin:/usr/bin:/usr/local/bin
#将文件扩展名和MIME类型关联起来，和mime.types文件作用一样。如果用mime.types
#文件，则注释掉，如果不使用mime.types文件，则必须使用
#AddType application/x-httpd-cgi cgi
#指明文档重定向路径
#Redirect /bar http://elsewhere/feh/bar
#为路径加上别名
Alias /doc /usr/doc
#非常重要，指明CGI脚本的虚拟路径对应的实际路径。一般所有的CGI脚本都要放在实际路径里，用户访问执行时输入站点+虚拟路径+CGI脚本名
ScriptAlias /cgi-bin/ /var/www/cgi-bin/
用户可以根据自己需要，对boa.conf进行修改，但必须要保证其他的辅助文件和设置必须和boa.conf里的配置相符，不然Boa就不能正常工作。在上面的例子中，我们还需要创建日志文件所在目录/var/log/boa，创建HTML文档的主目录/var/www，将mime.types文件拷贝到/etc目录，创建CGI脚本所在目录/var/www/cgi-bin/。mime.types文件用来指明不同文件扩展名对应的MIME类型，一般可以直接从Linux主机上拷贝一个，大部分也都是在主机的/etc目录下。
四、源码修改
第一、 修改boa-0.94-14/src目录下面的defines.h里的
#ifndef SERVER_ROOT
#define SERVER_ROOT "/etc/boa"
#endif,
"/etc/boa"该路径为boa.conf存放的路径。
第二、 修改boa.conf文件
（1） Group nogroup
Group nogroup—>改为Group nobody
（2） DoucmentRoot的修改
修改DoucmentRoot /var/www ，为存放网页的路径
第三、 运行Boa
./Boa
出现boa：server version Boa/0.94.14
boa: server built Sep 15 2009 at 01:02:14
boa: starting server pid=14390 ,port 80
五、服务器测试以及网页编写
（1）测试
打开Mozilla浏览器，输入自己的IP地址如：192.168.0.2 就可以打开网页。
（2）简单网页的编写网页
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<title> Web服务器测试页面</title>
</head>
<body>
Hello veryone!!!!!!!!!!!!!!!!!!!!!!!!
</body>
</html>
六、可能出错及修正
(1) 会出现错误：util.c:100:1: error: pasting "t" and "->" does not give a valid preprocessing token make: *** [util.o] 错误 1
修改 src/compat.h
#define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff
修改成
#define TIMEZONE_OFFSET(foo) (foo)->tm_gmtoff
(2) 会出现错误log.c:73 unable to dup2 the error log:bad file descriptor
修改 src/log.c注释掉
if (dup2(error_log, STDERR_FILENO) == -1) {
DIE("unable to dup2 the error log");
}
为：
(3) boa.c:211 - getpwuid: No such file or directory
修改src/boa.c注释掉下面两句话：
if (passwdbuf == NULL) {
DIE(”getpwuid”);
}
if (initgroups(passwdbuf->pw_name, passwdbuf->pw_gid) == -1) {
DIE(”initgroups”);
}为
#if 0
if (passwdbuf == NULL) {
DIE(”getpwuid”);
}
if (initgroups(passwdbuf->pw_name, passwdbuf->pw_gid) == -1) {
DIE(”initgroups”);
}
#endif
（4）会出现问题：boa.c:228 - icky Linux kernel bug!: No such file or directory
注释掉下面语句：
if (setuid(0) != -1) {
DIE(”icky Linux kernel bug!”);
}为
#if 0
if (setuid(0) != -1) {
DIE(”icky Linux kernel bug!”);
}
#endif
下面给大家介绍一下Boa服务器移植的具体操作步骤，希望能够有帮助。
环境
主机：ubuntu8.10
交叉工具链：gcc-3.4.5-glibc-2.3.6
目标：s3c2410开发板
结合网上一些文档，整理了一个比较完整的文档。
1．下载Boa源码
下载地址: http://www.boa.org/
最新发行版本： 0.94.13
下载 boa-0.94.13.tar.gz
解压：# tar xzf boa-0.94.13.tar.gz
2.安装需要工具bison，flex
sudo apt-get install bison flex
否则会出现如下错误
make: yacc：命令未找到
make: *** [y.tab.c] 错误 127
make: lex：命令未找到
make: *** [lex.yy.c] 错误 127
3.修改文件
(1)修改 src/compat.h
找到
#define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff
修改成
#define TIMEZONE_OFFSET(foo) (foo)->tm_gmtoff
否则会出现错误：
util.c:100:1: error: pasting "t" and "->" does not give a valid preprocessing token make: *** [util.o] 错误 1
(2)修改 src/log.c
注释掉
if (dup2(error_log, STDERR_FILENO) == -1) {
DIE("unable to dup2 the error log");
}
为：
/*if (dup2(error_log, STDERR_FILENO) == -1) {
DIE("unable to dup2 the error log");
}*/
否则会出现错误：
log.c:73 unable to dup2 the error log:bad file descriptor
(3)修改src/boa.c
注释掉下面两句话：
if (passwdbuf == NULL) {
DIE(”getpwuid”);
}
if (initgroups(passwdbuf->pw_name, passwdbuf->pw_gid) == -1) {
DIE(”initgroups”);
}
为
#if 0
if (passwdbuf == NULL) {
DIE(”getpwuid”);
}
if (initgroups(passwdbuf->pw_name, passwdbuf->pw_gid) == -1) {
DIE(”initgroups”);
}
#endif
否则会出现错误：boa.c:211 - getpwuid: No such file or directory
注释掉下面语句：
if (setuid(0) != -1) {
DIE(”icky Linux kernel bug!”);
}
为
#if 0
if (setuid(0) != -1) {
DIE(”icky Linux kernel bug!”);
}
#endif
否则会出现问题：boa.c:228 - icky Linux kernel bug!: No such file or directory
4、生成Makefile文件
执行：
#cd boa-0.94.13/src
#./configure
5、修改Makefile
cd src
vim Makefile
修改CC ＝ gcc 为 CC ＝ arm-softfloat-linux-gnu-gcc
修改CPP ＝ gcc -E 为 CC ＝ arm-softfloat-linux-gnu-gcc -E
6、编译
make
ls -l boa
-rwxr-xr-x 1 david david 189223 2009-05-31 13:44 boa
然后为生成的二进制文件boa瘦身
arm-softfloat-linux-gnu-strip boa
ls -l boa
-rwxr-xr-x 1 david david 61052 2009-05-31 13:51 boa
可以发现boa的大小前后差距很大这为我们节省了很大的空间
7、Boa的配置
这一步的工作也在电脑主机上完成。
在boa-0.94.13目录下已有一个示例boa.conf，可以在其基础上进行修改。如下：
#vi boa.conf
(1)Group的修改
修改 Group nogroup
为 Group 0
(2)user的修改
修改 User nobody
为 User 0
(3)ScriptAlias的修改
修改ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
为 ScriptAlias /cgi-bin/ /www/cgi-bin/
(5)DoucmentRoot的修改
修改DoucmentRoot /var/www
为DoucmentRoot /www
(6)ServerName的设置
修改#ServerName www.your.org.here
为 ServerName www.your.org.here
否则会出现错误“gethostbyname::No such file or directory”
(7)AccessLog修改
修改AccessLog /var/log/boa/access_log
为#AccessLog /var/log/boa/access_log
否则会出现错误提示：“unable to dup2 the error log: Bad file descriptor”
(8)以下配置和boa.conf的配置有关，都是在ARM根文件系统中创建
以下步骤在开发板上进行：
创建目录/etc/boa并且把boa 和 boa.conf拷贝到这个目录下
mkdir /etc/boa
创建HTML文档的主目录/www
mkdir /www
创建CGI脚本所在录 /www/cgi-bin
mkdir /www/cgi-bin
以下步骤在ubuntu下进行：
将boa.conf拷贝到开发板根文件系统的/etc/boa下
#cp boa.conf /source/rootfs/etc/boa
将boa拷贝到开发板根文件系统的/etc/boa下
#cp src/boa /source/rootfs/etc/boa
将ubuntu下/etc/mime.types拷贝到开发板根文件系统的/etc下
#cp /etc/mime.types /source/rootfs/etc
将你的主页index.html拷贝到www目录下
9、测试
打开一个浏览器输入开发板ip看看效果
OK