写在前面: boa相关目录:
1. boa.conf 的存放目录:
默认boa.conf是在/etc/boa.conf目录的，boa运行时会自动去找/etc/bon.conf文件。
这个设定是在define.h文件中定义的，可在编译之前进行修改。
2. log目录: 分为 Errorlog 和 AccessLog 两个目录，可在boa.conf中修改。
如:
ErrorLog /var/log/boa/error_log
AccessLog /var/log/boa/access_log
3. html文件存放目录, 可在boa.conf文件中修改。
如: DocumentRoot /var/www
4. cgi脚本存放目录, 可在boa.conf文件中修改。
如: ScriptAlias /cgi-bin/ /var/www/cgi-bin
5. mime.types存放目录 , 可在boa.conf文件中修改。
如: MimeTypes /etc/mime.types
=======================================================
移植boa服务
=======================================================
一. 编译boa程序
1. 下载boa-0.94.13.tar.gz
2. 解压: tar –zxvf boa-0.94.13.tar.gz
3. 进入boa-0.94.13/src目录， 执行./configure
4. make
编译时用2.95.3以上的版本会出错：
util.c: 100: 1: pasting “t” and “->” does not give a valid preprocessing token make: [util.o] Error1
解决方法:
方法1>. 修改compat.h中的
#define TIMEZONE_OFFSET(foo) foo## ->tm_gmtoff
为：
#define TIMEZONE_OFFSET(foo) foo->tm_gmtoff
方法2>. 改用2.95.3版本的编译器。
二. 修改配置文件boa.conf
1. 建立/etc/boa目录, 并复制boa.conf到/etc/boa目录下，并按照以下步骤进行修改。
2. 修改访问权限： 修改User nobody 为 User 0 ; 修改Group nogroup 为 Group 0
3. 设定日志目录：boa日志有两部分，Errorlog 和 AccessLog
一般情况下为/var/log/boa/error_log 和 /var/log/boa/access_log两个文件。所以根据自己的情况情况设置日志目录：
ErrorLog /var/log/boa/error_log
AccessLog /var/log/boa/access_log
(注意:这里/var/log/boa目录必须为可写，否则会出项错误:log.c:73 – Unable to dup2 the error log: Bad file r.)
4. 设置html文件目录: DocumentRoot /var/www
5. 设置默认首页: DirectoryIndex index.html
6. 设置cgi脚本目录: 将
ScriptAlias /cgi-bin/ /usr/lib/cgi-bin
修改为
ScriptAlias /cgi-bin/ /var/www/cgi-bin
三. 根据第二步设置建立相关文件夹并放入文件:
1. 根据(第二.3步)的设置建立/var/boa 文件夹 。
2. 根据(第二.4步)的设置建立/var/www 文件夹 , 并在此目录下存放html文件(包括index.html文件)。
3. 根据(第二.6步)的设置建立/var/www/cgi-bin 文件夹 , 并存放一些用来测试的cgi脚本。
四. OK，运行boa程序。
在windows 下通过这种形式访问，进行测试。
五. 移植到开发板
1>. (第一.3步)操作完成之后，修改Makefile文件:
将:
CC = gcc
CPP = gcc -E
该为:
CC = arm-linux-gcc
CPP = arm-linux-gcc -E
make即可。
2>. 拷贝PC上/etc/mime.types文件到开发板/etc目录下
(或者将boa.conf文件中 MimeTypes /etc/mime.types 修改为: MimeTypes /dev/null )
六. 常见错误：
1>. 错误1: gethostbyname:: No such file or directory
解决办法: 修改boa.conf 去掉 ServerName 前的注释符号(#)
2>. 错误1: util.c:100:1: error: pasting "t" and "->" does not give a valid preprocessing token make: *** [util.o]
解决办法: 修改 src/compat.h
找到
#define TIMEZONE_OFFSET(foo) foo## ->tm_gmtoff
修改成
#define TIMEZONE_OFFSET(foo) foo->tm_gmtoff
3>. 错误2: 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>. 错误3: 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>. 错误4: log.c:73 unable to dup2 the error log:bad file descriptor
解决方法:
方法1> 确定日志目录对与所有用户都具有可读/写的权限
方法2> 修改src/log.c (建议采用方法1)
注释掉
if (dup2(error_log, STDERR_FILENO) == -1) {
DIE("unable to dup2 the error log");
}
即修改为:
#if 0
if (dup2(error_log, STDERR_FILENO) == -1) {
DIE("unable to dup2 the error log");
}
#endif
[linux嵌入式方向] Boa服务器移植
farsight2009 发表于 2009-7-8 13:21:00
作者： 曹忠明，华清远见嵌入式学院 讲师。
Boa是一种非常小巧的Web服务器，其可执行代码只有大约60KB左右。作为一种单任务Web服务器，Boa只能依次完成用户的请求，而不会 fork出新的进程来处理并发连接请求。但Boa支持CGI，能够为CGI程序fork出一个进程来执行。Boa的设计目标是速度和安全。
下面给大家介绍一下Boa服务器移植的具体操作步骤，希望能够有帮助。
环境
主机：ubuntu8.10
交叉工具链：gcc-3.4.5-glibc-2.3.6
目标：s3c2410开发板
结合网上一些文档，整理了一个比较完整的文档。
1．下载Boa源码
下载地址:
最新发行版本： 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
为 ServerName
否则会出现错误“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目录下
8、测试
打开一个浏览器输入开发板ip看看效果
OK
Boa移植笔记
嵌入式Web服务器移植
《嵌入式Linux系统开发详解——基于EP93XX系列ARM》一书和boa自带的文档等对该内容有比较详细的介绍，但在实验过程中，仍可能会出现一些问题。下面是我在WNC201系统（AT91RM9200）上的移植过程，欢迎讨论。
第一步 Boa程序的移植
1、下载Boa源码
下载地址: ， 或者
最新发行版本： 0.94.13
下载 boa-0.94.13.tar.gz，注意：从boa上下载的是boa-0.94.13.tar.tar，解压方式一样
解压：# tar xzf boa-0.94.13.tar.gz
2、生成Makefile文件
直接运行src/configure文件
3、修改Makefile文件
a、
修改 CC = gcc
为 CC = /usr/local/arm/2.95.3/bin/arm-linux-gcc
b、
修改 CPP = gcc - E
为 CPP = /usr/local/arm/2.95.3/bin/arm-linux-gcc -E
4、编译
# make
# /usr/local/arm/2.95.3/bin/arm-linux-strip boa
第二步 Boa的配置
Boa需要在/etc目录下建立一个boa目录，里面放入Boa的主要配置文件boa.conf。在Boa源码目录下已有一个示例boa.conf，可以在其基础上进行修改。
1、Group的修改
修改 Group nogroup
为 Group 0
由于在/etc/group文件中没有nogroup组，所以设成0。另外在/etc/passwd中有nobody用户，所以User nobody不用修改。
2、ScriptAlias的修改
修改 ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
为 ScriptAlias /cgi-bin/ /var/www/cgi-bin/
3、ServerName的设置
修改 ServerName
为 ServerName
注意：该项默认为未打开，执行Boa会异常退出，提示“gethostbyname::No such file or directory”,所以必须打开。其它默认设置即可。
4、User的设置
原文是以nobody用户启动boa的，在后来的实践中发现，该用户无法实现POST，无法上传文件，无法访问共享内存，所以在我的系统中，
修改 User nobody
为 User root 或者 0
但是这样，boa无法正常启动，查看ErrorLog可以看到，“boa.c:266.icky Linux kernel bug!:No such file ”。解决该问题的方法是将boa.c文件中以下几行判断去掉即可。
if ( setuid( 0) ! = - 1) {
DIE( "icky Linux kernel bug!" ) ;
}
第三部：Boa的执行
成功配置以后，还需要创建日志文件所在目录/var/log/boa，创建HTML文档的主目录/var/www，将静态网页存入该目录下（可以将主机 /usr/share/doc/HTML/目录下的index.html文件和img目录复制到/var/www目录下），创建CGI脚本所在录/var /www/cgi-bin，将cgi的脚本存放在该目录下。另外还要将mime.types文件复制/etc目录下，通常可以从linux主机的/etc 目录下直接复制即可。
实际运行时，可以将boa.conf文件、index.html文件、img目录和mime.types文件放到CF卡目录下，建立目录后，拷贝至相应目录。
制作run.sh
mkdir /etc/boa
cp /cf/boa/boa.conf /etc/boa/
mkdir /var/log
mkdir /var/log/boa
mkdir /var/www
cp /cf/boa/index.html /var/www/
cp -r /cf/boa/img /var/www/
mkdir /var/www/cgi-bin
cp /cf/boa/mime.types /etc/
cp /cf/boa/boa /
./boa &
直接在浏览器中输入 ，出现Red Hat的欢迎网页。静态HTML调试成功。
第四步 CGI脚本测试
1、编写Helloworld.c程序
# include < stdio. h>
int main( void )
{
printf ( "Content-type: text/html\n\n" ) ;
printf ( "\n" ) ;
printf ( "
CGI Output\n" ) ;
printf ( "\n" ) ;
printf ( "Hello,world.
\n" ) ;
printf ( "\n" ) ;
printf ( "\n" ) ;
exit ( 0) ;
}
交叉编译生成helloworld.cgi
# /usr/local/arm/2.95.3/bin/ arm-linux-gcc -o helloworld.cgi helloworld.c
2、浏览
将helloworld.cgi拷贝至/var/www/cgi-bin/下，浏览器输入
注意：拷贝至目标板上后，必须更改其属性chmod 755 *
