嵌入式linux项目开发(一)——BOA移植
项目目标：使用BOA、CGIC、SQLite搭建嵌入式web服务器
一、嵌入式web服务器BOA简介
在嵌入式设备的管理与交互中，基于Web方式的应用成为目前的主流，即在嵌入式设备上运行一个支持脚本或CGI功能的Web服务器，能够生成动态页面，在用户端只需要通过Web浏览器就可以对嵌入式设备进行管理和监控，使用极为方便。
目前嵌入式设备中所使用的web服务器主要有：boa、thttpd、mini_httpd、shttpd、lighttpd、goaheand、appweb和apache等。
BOA是Paul Philips在1991年开发的开源的嵌入式web服务器，BOA功能强大，支持认证，CGI等，应用广泛，特别适合于嵌入式设备。与传统的web服务器为每个访问连接开启一个进程不同，BOA是一个单任务的web服务器，不会为多个连接开启多个任务进程。BOA对所有的活动的http连接在内部进行处理，而且只为每个CGI连接(独立的进程)开启新的进程。因此，BOA在同等硬件条件下显示出更快的速度。测试表明boa在Pentium 300MHZ下能够每秒钟处理几千次点击，在20 MHz 386/SX下能够每秒钟处理几十次点击访问。
BOA与apache等高性能web服务器主要区别是，BOA是单进程的服务器，只有在完成一个用户请求后才能响应另一个用户的请求，无法并发响应，在嵌入式设备的应用场合里已经足够。
BOA是一个非常小巧的Web服务器，可执行代码只有约60KB，是一个单任务Web服务器，只能依次完成用户的请求，而不会fork出新的进程来处理并发连接请求；但BOA支持CGI，能够为CGI程序fork出一个进程来执行。
BOA的设计目标是速度和安全，是指不被恶意用户暗中破坏，而不是指它有很好的访问控制和通信加密。可以添加SSL来保证数据传输中的保密和安全。在其站点公布的性能测试中，BOA的性能要好于Apache服务器。
二、嵌入式BOA服务器编译
1、下载BOA源码
从www.boa.org下载boa-0.94.13.tar.gz源码
2、生成配置文件
在BOA顶层目录src下运行./configure
3、修改Makefile文件
修改Makefile文件中的交叉编译工具选项
CC = arm-linux-gcc
CPP = arm-linux-gcc–E
LDFLAGS = -static
4、修改boa.c文件
将boa.c文件中的一下内容注释
if ( setuid ( 0 ) != - 1 ) {
DIE ( "icky Linux kernel bug!" );
}
5、修改compat.h文件
#define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff
修改成
#define TIMEZONE_OFFSET(foo) (foo)->tm_gmtoff
6、修改config.c文件
将if(!server_name){..........}内容注释，位于266-286行
不注释会报错：gethostbyname:: Resource temporarily unavailable
7、修改log.c文件
注释掉以下内容
if (dup2(error_log, STDERR_FILENO) == -1) {
DIE("unable to dup2 the error log");
}
不注释会报错：unable to dup2 the error log:bad file descriptor
8、编译
make
9、去除调试信息
arm-linux-strip boa
10、修改执行权限
chmod 777 boa
三、BOA服务器配置
1、boa.conf文件解析
#监听的端口
Port 80
#服务器绑定的IP地址，注释掉表示绑定到INADDR_ANY，适配服务器所有的IP
#Listen 192.68.0.5
#服务器运行的用户和组
#User o
User 0
#Group o
Group 0
#当服务器发生问题时发送报警的email地址
#ServerAdmin root@localhost
#错误日志文件
ErrorLog /var/log/boa/error_log
#访问日志文件
AccessLog /var/log/boa/access_log
#是否使用本地时间。如果没注释掉，则使用本地时间。注释掉则使用UTC时间
#UseLocaltime
#是否记录CGI运行信息
#VerboseCGILogs
#服务器名字
#是否启动虚拟主机功能，即设备可以有多个网络接口，每个接口都可以拥有一个虚拟的Web服务器
#VirtualHost
#非常重要，HTML文档的主目录
DocumentRoot /var/www
#如果收到一个用户请求的话，在用户主目录后再增加的目录名
UserDir public_html
#HTML目录索引的文件名
DirectoryIndex index.html
#一个连接所允许的HTTP持续作用请求最大数目
KeepAliveMax 1000
#HTTP持续作用中服务器在两次请求之间等待的时间数，以秒为单位，超时将关闭连接
KeepAliveTimeout 10
#指明mime.types文件位置
MimeTypes /etc/mime.types
#文件扩展名没有或未知的话，使用的缺省MIME类型
DefaultType text/plain
#提供CGI程序的PATH环境变量值
CGIPath /bin:/usr/bin:/usr/local/bin
#为路径加上别名
Alias /doc /usr/doc
#指明CGI脚本的虚拟路径对应的实际路径
ScriptAlias /cgi-bin/ /var/www/cgi-bin/
2、其他文件移植
从linux的etc目录拷贝mime.types、passwd、group文件到开发板系统的etc目录
创建web服务器HTML文档的主目录/var/www
创建CGI脚本所在目录/var/www/cgi-bin/
四、BOA移植过程中错误的解决方案
1、gethostbyname:: No such file or directory
解决办法:修改boa.conf去掉ServerName www.your.org.here前的注释符号(#)
2、util.c:100:1: error: pasting "t" and "->"does not give a valid preprocessing token make: *** [util.o]
解决办法:
修改src/compat.h
#defineTIMEZONE_OFFSET(foo) foo##->tm_gmtoff
修改成
#defineTIMEZONE_OFFSET(foo) (foo)->tm_gmtoff
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
解决办法:
修改src/boa.c，注释掉下面语句:
if(setuid(0) != -1) {
DIE(”icky Linux kernel bug!”);
}
即修改为:
#if 0
if(setuid(0) != -1) {
DIE(”icky Linux kernel bug!”);
}
#endif
5、log.c:73 unable to dup2 the error log:bad file descriptor
解决方法:
修改src/log.c
注释掉
if(dup2(error_log, STDERR_FILENO) == -1) {
DIE("unableto dup2 the error log");
}
即修改为:
#if 0
if (dup2(error_log, STDERR_FILENO) == -1) {
DIE("unable to dup2 the error log");
}
#endif
6、执行boa程序报错not found
解决方法：
修改Makefile
LDFLAGS = -static
2...)
)
