嵌入式boa服务器移植

开发板环境

开发板：EDUKIT-III实验箱，S3C2410+LINUX2.4，实验箱随箱光盘提供的Zimage，nor flash启动。
主机：ubnutn10.4LTS，arm-linux-gcc 2.95.3

移植过程中出现的问题

交叉工具链：cross-2.95.3.tar.bz2（下载地址：http://ftp.arm.linux.org.uk/pub/armlinux/toolchain/ ),开始使用的交叉工具链是arm-linux-gcc-3.3.2（下载地址：http://www.handhelds.org/download/projects/toolchain/arm-linux-gcc-3.3.2.tar.bz2），使用该工具链编译出来的boa，在开发板上运行时，提示如下错误:

ssh: /lib/i686/libc.so.6: version `GLIBC_2.3′ not found (required by ./boa)

这是因为arm-linux-gcc-3.3.2使用的glibc库版本为2.3版本，但是开发板上运行的LINUX的glibc版本为2.2，因此运行boa，在动态链接glibc库时，在开发板上找不到glibc2.3的库，所以提示这样的错误，解决方法用arm-linux-gcc-2.95.3交叉工具链。
交叉工具链安装在/usr/local/arm/2.95.3/目录下，要把arm-linux-gcc添加到PATH环境变量当中，方法有两个：
(1).export PATH=/usr/local/arm/2.95.3/bin:$PATH,source /etc/profile，这种方法每次重启终端后都必须执行一次；
(2).编辑/etc/profile文件，在该文件最后添加expot PATH=/usr/local/arm/2.95.3/bin:$PAH，然后重启后生效。

对boa配置及其源码修改完成后，./configure没有问题，make时遇到如下错误：

stuyou@VMUBUNTU:/tmp/boa/boa-0.94.13/src$ make
yacc  -d boa_grammar.y
make: yacc: Command not found
make: *** [y.tab.c] Error 127

编译一个linux下的c系统，包含词法和语法分析模块，Linux上用bison和flex。
yacc是一个文法分析器的生成器,bison即是yacc的GNU版本.Lex和YACC是用于构造词法分析机和语法解释器的工具，利用Lex和yacc你可以轻松的构造一个语法解释器。
解决方法：sudo apt-get install flex bison
重新make，问题解决

在开发板上运行boa时，提示无法绑定IP地址，

[03/Aug/2028:07:59:35 +0000] boa.c:194 - unable to bind: Address already in use，

通过ps命令查看当前运行进程，结果如下：

/etc/var/boa # ps
  PID  Uid     VmSize Stat Command
root        476 S   init
root            SW  [keventd]
root            SWN [ksoftirqd_CPU0]
root            SW  [kswapd]
root            SW  [bdflush]
root            SW  [kupdated]
root            SW  [mtdblockd]
root            SW  [khubd]
root        500 S   /sbin/httpd -h /usr/embest
root        528 S   /sbin/inetd
root        700 S   -sh
root        476 S   init
root        476 S   init
root        476 S   init
root        608 R   ps

发现httpd进程正在运行，进程号为30，因此首先禁掉该进程

/etc/var/boa # kill 30

然后再重新启动boa

etc/var/boa # ./boa
/etc/var/boa # [03/Aug/2028:08:00:03 +0000] boa: server version Boa/0.94.13
[03/Aug/2028:08:00:03 +0000] boa: server built Aug 22 2010 at 14:50:23.
[03/Aug/2028:08:00:03 +0000] boa: starting server pid=62, port 80
/etc/var/boa # ps
  PID  Uid     VmSize Stat Command
root        476 S   init
root            SW  [keventd]
root            SWN [ksoftirqd_CPU0]
root            SW  [kswapd]
root            SW  [bdflush]
root            SW  [kupdated]
root            SW  [mtdblockd]
root            SW  [khubd]
root        528 S   /sbin/inetd
root        704 S   -sh
root        476 S   init
root        476 S   init
root        476 S   init
root        604 S   ./boa
root        608 R   ps

boa启动成功

cgi脚本不能正常运行。这是因为在主机上编译cgi脚本的时候，主机用户为非root用户，这时编译出来的cgi脚本不能运行。解决方法切换到root用户，sudo -i,然后再编译cgi，arm-linux-gcc -o demo1.cgi demo1.c，下载到开发板上，运行成功。

boa移植步骤参考如下文档

方法:（注意：第1-11步是在PC机上开启boa服务器的过程）

在/tmp下建立一个目录boa，把boa源码（boa-0.94.13.tar.gz）拷贝到该目录下，然后解压tar -xzvf boa-0.94.13.tar.gz
在LINUX家目录下建立boa目录，这是boa的安装目录。拷贝boa.conf到/home/boa
指定配置文档路径，把/tmp/boa/boa-0.94.13/src下的defines.h中的第30行#define SERVER_ROOT “/etc/boa“ 改为#define SERVER_ROOT “/home/boa“
以下步骤按照“boa的移植.txt”文档进行。
在 /tmp/boa/boa-0.94.13/src下执行./configure，提示
creating ./config.status
creating Makefile
creating config.h
然后make，以下是make信息

make: Warning: File `Makefile' has modification time 9.5 s in the future
bison -y  -d boa_grammar.y
gcc  -g -O2 -pipe -Wall -I.   -c -o y.tab.o y.tab.c
y.tab.c: 在函数 ‘yyparse’ 中：
y.tab.c:1295: 警告：隐式声明函数 ‘yylex’
flex  boa_lexer.l
gcc  -g -O2 -pipe -Wall -I.   -c -o lex.yy.o lex.yy.c
boa_lexer.l: 在函数 ‘yylex’ 中：
boa_lexer.l:82: 警告：隐式声明函数 ‘yyerror’
boa_lexer.l: 在顶层：
lex.yy.c:1183: 警告：‘yyunput’ 定义后未使用
gcc  -g -O2 -pipe -Wall -I.   -c -o alias.o alias.c
gcc  -g -O2 -pipe -Wall -I.   -c -o boa.o boa.c
gcc  -g -O2 -pipe -Wall -I.   -c -o buffer.o buffer.c
gcc  -g -O2 -pipe -Wall -I.   -c -o cgi.o cgi.c
gcc  -g -O2 -pipe -Wall -I.   -c -o cgi_header.o cgi_header.c
gcc  -g -O2 -pipe -Wall -I.   -c -o config.o config.c
gcc  -g -O2 -pipe -Wall -I.   -c -o escape.o escape.c
gcc  -g -O2 -pipe -Wall -I.   -c -o get.o get.c
gcc  -g -O2 -pipe -Wall -I.   -c -o hash.o hash.c
gcc  -g -O2 -pipe -Wall -I.   -c -o ip.o ip.c
gcc  -g -O2 -pipe -Wall -I.   -c -o log.o log.c
gcc  -g -O2 -pipe -Wall -I.   -c -o mmap_cache.o mmap_cache.c
gcc  -g -O2 -pipe -Wall -I.   -c -o pipe.o pipe.c
gcc  -g -O2 -pipe -Wall -I.   -c -o queue.o queue.c
gcc  -g -O2 -pipe -Wall -I.   -c -o read.o read.c
gcc  -g -O2 -pipe -Wall -I.   -c -o request.o request.c
request.c: 在函数 ‘get_request’ 中：
request.c:84: 警告：传递参数 3 (属于 ‘accept’) 给指针时目标与指针有/无符号不一致
gcc  -g -O2 -pipe -Wall -I.   -c -o response.o response.c
gcc  -g -O2 -pipe -Wall -I.   -c -o select.o select.c
gcc  -g -O2 -pipe -Wall -I.   -c -o signals.o signals.c
gcc  -g -O2 -pipe -Wall -I.   -c -o util.o util.c
gcc  -g -O2 -pipe -Wall -I.   -c -o sublog.o sublog.c
gcc  -g -O2 -pipe -Wall -I.   -c -o timestamp.o timestamp.c
gcc  -o boa y.tab.o lex.yy.o alias.o boa.o buffer.o cgi.o cgi_header.o config.o escape.o get.o hash.o ip.o log.o mmap_cache.o pipe.o queue.o read.o request.o response.o select.o signals.o util.o sublog.o timestamp.o -g
gcc  -g -O2 -pipe -Wall -I.   -c -o index_dir.o index_dir.c
gcc  -o boa_indexer index_dir.o escape.o -g
make: 警告：检测到时钟错误。您的创建可能是不完整的。

出现警告可以忽略，只要不出现错误即可，Make完成后，会在当前目录下生成boa可执行文件。

拷贝boa boa.indexer到/home/boa/目录
按照“boa的移植.txt”配置boa.conf
在/home/boa下创建www文件夹,cig-bin文件夹，log文件夹，把html相关文件拷贝到www文件夹
启动boa.在/home/boa/目录下执行./boa，默认在后台运行，ps -a命令，可以看到boa正确启动，或者cat log/error_log观察错误信息，如果boa启动正确，则打印如下信息

[27/Jul/2010:07:57:05 +0000] boa: server version Boa/0.94.13
[27/Jul/2010:07:57:05 +0000] boa: server built Jul 27 2010 at 15:30:25.
[27/Jul/2010:07:57:05 +0000] boa: starting server pid=3526, port 80

打开浏览器，访问该boa服务器，浏览器地址栏中输入http://192.168.1.120,该地址为主机IP。浏览器输出“hello, this is a web server!”
移植boa到嵌入式开发板，打开boa.conf的94行，#ServerName www.your.org.here，去掉注释#
boa.conf的第155行MimeTypes /etc/mime.types修改为MimeTypes /dev/null，如果不修改该行，则应该把PC上/etc/mime.types文件拷贝到开发板
打开/tmp/boa/boa-0.94.13/src下的Makefile文件，CC = gcc 和CPP = gcc -E 修改为CC=arm-linux-gcc 和 CPP = arm-linux-gcc -E
然后重新make。先执行make clean，然后再make
启动开发板，进入到开发板上的LINUX，在/home目录下新建boa目录
在/home/boa目录下新建www,log,cgi-bin目录下
把PC机上编译好的boa,boa_indexer，boa.conf通过串口线下载到开发板的/home/boa下
把PC机上的www目录下的文件压缩打包，然后传送到开发板，解压后，放入/home/boa/www下
使用ifconfig eth0 ipaddress
在PC机上的浏览器中输入开发板网址，可以看到“hello, this is a web server!”，boa服务器就在开发板中正确搭建了。
网页中的cgi编程：编写程序代码，比如为demo2.c，根据请求网页（demo2.html）中规定的demo2.cgi文件名，然后进行编译，arm-linux-gcc -o demo2.cgi demo2.c
然后把demo2.html下载到开发板/home/boa/www目录下，把编译好的demo2.cgi拷贝到开发板的/home/boa/cgi-bin目录下，并为demo2.cgi增加执行权限
在PC机中的浏览器地址栏输入http://http://192.168.1.120/demo2.html，这就是使用cgi编程的流程。
html网页向boa服务器发送的数据格式是默认的，也可以通过脚本文件，更改发送数据格式。
该例子的所有文件均在该目录下。

boa的移植

修改源码：

修改src/defines.h中的第30行：#define SERVER_ROOT “/home/boa” # boa配置文件(boa.conf)的存放路径
修改compat.h:去掉第120行”#define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff” 中的 “##” 这是早期编译器使用的，现在编译器不支持该动作，所以去掉。去掉第126行”#define TIMEZONE(foo) foo##->tm_zone” 中的 “##”
修改boa.c:注释掉第210行~215行:
注释掉第226行 : //DIE(“icky Linux kernel bug!”);

编译boa:

(1) ./configure (2) make

配置：

拷贝boa、boa_indexer到开发板/home/boa目录
拷贝boa.conf到开发板/home/boa目录
修改boa.conf
a. 修改User nobody 为 User 0 ; 表示root用户运行该程序
b. 修改Group nogroup 为 Group 0
c. ErrorLog /home/boa/log/boa/error_log 错误日志放在该文件夹下。
d. AccessLog /home/boa/log/access_log 访问日志放在该文件夹下
e. DocumentRoot /home/boa/www 网页文件放在该目录下
DirectoryMaker /home/boa/boa_indexer
f. ScriptAlias /cgi-bin/ /home/boa/cgi-bin 脚本放置目录 g. 此步只要在开发板上做(如果boa运行在开发板上，则要做这一步，如果只运行在PC机上，则不用做这步)： 94行，#ServerName www.your.org.here，去掉注释#，#后面的字符为服务器的名字，可以随便取。 h.boa.conf的第155行MimeTypes /etc/mime.types修改为MimeTypes /dev/null，如果不修改该行，则应该把PC上/etc/mime.types文件拷贝到开发板
根据配置创建相关目录：（在/home/boa/目录下创建以下目录）
log www cgi-bin
在www放入html文件, 在cgi-bin放入cgi脚本

boa服务器移植常见错误

编译boa程序

www.boa.org下载boa-0.94.13.tar.gz
解压
./configure
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

建立/etc/boa目录, 并复制boa.conf到/etc/boa目录下，并按照以下步骤进行修改。
修改访问权限：修改User nobody 为 User 0 ; 修改Group nogroup 为 Group 0
设定日志目录：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.)
设置html文件目录: DocumentRoot /var/www
设置默认首页: DirectoryIndex index.html
设置cgi脚本目录: 将ScriptAlias /cgi-bin/ /usr/lib/cgi-bin修改为ScriptAlias /cgi-bin/ /var/www/cgi-bin

根据第二步设置建立相关文件夹并放入文件:

根据(第二.3步)的设置建立/var/boa 文件夹。
根据(第二.4步)的设置建立/var/www 文件夹, 并在此目录下存放html文件(包括index.html文件)。
根据(第二.6步)的设置建立/var/www/cgi-bin 文件夹, 并存放一些用来测试的cgi脚本。

OK，运行boa程序。

在windows 下通过http://172.20.223.151这种形式访问，进行测试。

移植到开发板

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
boa配置相关目录:

boa.conf 的存放目录:
默认boa.conf是在/etc/boa.conf目录的，boa运行时会自动去找/etc/bon.conf目录。
这个设定是在define.h文件中定义的，可在编译之前进行修改。
log目录: 分为 Errorlog 和 AccessLog 两个目录，可在boa.conf中修改。
如:
ErrorLog /var/log/boa/error_log
AccessLog /var/log/boa/access_log
html文件存放目录, 可在boa.conf文件中修改。
如: DocumentRoot /var/www
cgi脚本存放目录, 可在boa.conf文件中修改。
如: ScriptAlias /cgi-bin/ /var/www/cgi-bin
mime.types存放目录, 可在boa.conf文件中修改。
如: MimeTypes /etc/mime.types

常见错误：

 1>. 错误1: gethostbyname:: No such file or directory
     解决办法: 修改boa.conf   去掉 ServerName www.your.org.here 前的注释符号(#)
 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

boa服务器的移植流程，网上某篇文档

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源码下载地址: 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.c1: 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”); } 为：

否则会出现错误： 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目录下
8、测试
打开一个浏览器输入开发板ip看看效果
OK

我使用的是micro2440开发板
boa.conf配置如下：

Port 80
User root
Group root
ErrorLog /dev/console
AccessLog /dev/null
ServerName IntelligenceApplianceServer
DocumentRoot /www
DirectoryIndex index.html
KeepAliveMax 1000
KeepAliveTimeout 10
MimeTypes /etc/mime.types
DefaultType text/plain
CGIPath /bin
AddType application/x-httpd-cgi cgi
ScriptAlias /cgi-bin/ /www/cgi-bin/

在/www目录下创建micro2440文件夹，将原开发板的所有内容转移到该文件夹下浏览器中输入http://192.168.0.126/micro2440/访问

第四步 CGI脚本测试 1、编写Helloworld.c程序

#include
int main(void)
{
        printf("Content-type: text/html\n\n");
        printf("\n");
        printf("\n");
        printf("\n");
        printf("
Hello,world.
\n");
        printf("\n");
        printf("\n");
        exit(0);
}

交叉编译生成helloworld.cgi

#arm-linux-gcc -o helloworld.cgi helloworld.c

2、浏览.将helloworld.cgi拷贝至/var/www/cgi-bin/下，浏览器输入http://192.168.0.126/cgi-bin/helloworld.cgi

Fiber+EmbeddedLinux

游走在光纤通信和嵌入式开发之间。。。