嵌入式boa服务器移植

开发板：EDUKIT-III实验箱，S3C2410+LINUX2.4，实验箱随箱光盘提供的Zimage，nor flash启动。

主机：ubnutn10.4LTS，arm-linux-gcc 2.95.3

问题1：交叉工具链：cross-2.95.3.tar.bz2（下载地址：），开始使用的交叉工具链是arm-linux-gcc-3.3.2（下载地址：），使用该工具链编译出来的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，然后重启后生效。

问题2：对boa配置及其源码修改完成后，./configure没有问题，make时遇到如下错误：
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，问题解决

问题3：在开发板上运行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
    1 root        476 S   init
    2 root            SW  [keventd]
    3 root            SWN [ksoftirqd_CPU0]
    4 root            SW  [kswapd]
    5 root            SW  [bdflush]
    6 root            SW  [kupdated]
    8 root            SW  [mtdblockd]
    9 root            SW  [khubd]
   30 root        500 S   /sbin/httpd -h /usr/embest
   32 root        528 S   /sbin/inetd
   43 root        700 S   -sh
   44 root        476 S   init
   45 root        476 S   init
   46 root        476 S   init
   59 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
    1 root        476 S   init
    2 root            SW  [keventd]
    3 root            SWN [ksoftirqd_CPU0]
    4 root            SW  [kswapd]
    5 root            SW  [bdflush]
    6 root            SW  [kupdated]
    8 root            SW  [mtdblockd]
    9 root            SW  [khubd]
   32 root        528 S   /sbin/inetd
   43 root        704 S   -sh
   44 root        476 S   init
   45 root        476 S   init
   46 root        476 S   init
   62 root        604 S   ./boa
   63 root        608 R   ps

boa启动成功

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

【boa移植步骤参考如下文档】

方法:（注意：第1-11步是在PC机上开启boa服务器的过程）
1.在/tmp下建立一个目录boa，把boa源码（boa-0.94.13.tar.gz）拷贝到该目录下，然后解压tar -xzvf boa-0.94.13.tar.gz
2.在LINUX家目录下建立boa目录，这是boa的安装目录。拷贝boa.conf到/home/boa
3.指定配置文档路径，把/tmp/boa/boa-0.94.13/src下的defines.h中的第30行#define SERVER_ROOT   “/etc/boa“ 改为#define SERVER_ROOT   “/home/boa“
4.以下步骤按照“boa的移植.txt”文档进行。
5.在 /tmp/boa/boa-0.94.13/src下执行./configure，提示
creating ./config.status
creating Makefile
creating config.h
6.然后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可执行文件。
7.拷贝boa boa.indexer到/home/boa/目录
8.按照“boa的移植.txt”配置boa.conf
9.在/home/boa下创建www文件夹,cig-bin文件夹，log文件夹，把html相关文件拷贝到www文件夹
10.启动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
11.打开浏览器，访问该boa服务器，浏览器地址栏中输入,该地址为主机IP。浏览器输出“hello, this is a web server!”
12.移植boa到嵌入式开发板，打开boa.conf的94行，#ServerName ，去掉注释#
13.boa.conf的第155行MimeTypes /etc/mime.types修改为MimeTypes /dev/null，如果不修改该行，则应该把PC上/etc/mime.types文件拷贝到开发板
14.打开/tmp/boa/boa-0.94.13/src下的Makefile文件，CC = gcc  和CPP = gcc -E 修改为CC=arm-linux-gcc 和 CPP = arm-linux-gcc -E
15.然后重新make。先执行make clean，然后再make
16.启动开发板，进入到开发板上的LINUX，在/home目录下新建boa目录
17.在/home/boa目录下新建www,log,cgi-bin目录下
18.把PC机上编译好的boa,boa_indexer，boa.conf通过串口线下载到开发板的/home/boa下
19.把PC机上的www目录下的文件压缩打包，然后传送到开发板，解压后，放入/home/boa/www下
20.使用ifconfig eth0 ipaddress
20.在PC机上的浏览器中输入开发板网址，可以看到“hello, this is a web server!”，boa服务器就在开发板中正确搭建了。
21.网页中的cgi编程：编写程序代码，比如为demo2.c，根据请求网页（demo2.html）中

规定的demo2.cgi文件名，然后进行编译，arm-linux-gcc -o demo2.cgi demo2.c
22.然后把demo2.html下载到开发板/home/boa/www目录下，把编译好的demo2.cgi拷贝到开发板的/home/boa/cgi-bin目录下，并为demo2.cgi增加执行权限
23.在PC机中的浏览器地址栏输入，这就是使用cgi编程的流程。
24.html网页向boa服务器发送的数据格式是默认的，也可以通过脚本文件，更改发送数据格式。
25.该例子的所有文件均在该目录下。

【boa的移植】

boa服务器移植:

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

<二> 编译boa:
   1. ./configure
   2. make

<三> 配置：
    1. 拷贝boa、boa_indexer到开发板/home/boa目录
    2. 拷贝boa.conf到开发板/home/boa目录
    3. 修改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 ，去掉注释#，#后面的字符为服务器的名字，可以随便取。
 h.boa.conf的第155行MimeTypes /etc/mime.types修改为MimeTypes /dev/null，如果不修改该行，则应该把PC上/etc/mime.types文件拷贝到开发板
  
    4. 根据配置创建相关目录：（在/home/boa/目录下创建以下目录）
       log  www  cgi-bin
    5. 在www放入html文件, 在cgi-bin放入cgi脚本

【boa服务器移植常见错误】

一> 编译boa程序
1. 下载boa-0.94.13.tar.gz
2. 解压
3. ./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   

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

六> 常见错误：
 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

【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源码

下载地址:

最新发行版本： 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");
                   }

为：

 

否则会出现错误：

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

 

我使用的是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文件夹，将原开发板的所有内容转移到该文件夹下

浏览器中输入访问

 

第四步 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/下，浏览器输入