一、BOA


http://www.boa.org/


基于嵌入式WEB服务器2(boa)

boa在嵌入式Linux上的移植


本文也是在网上从多的移植文章中修改添加得来的。


Boa程序的移植


1、下载Boa源码


下载地址: http://www.boa.org/, 或者http://sourceforge.net


最新发行版本: 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文件


修改 CC = gcc


为 CC = arm-linux-gcc(也可以使用绝对路径,网上说得用2.95.3编译,高一点的编译器会报错,这一点,我没有去验证,我用的就是2.95.3)


修改 CPP = gcc - E


为 CPP = arm-linux-gcc -E


4、编译


# make 这一步编译时用编译工具用2.95.3以上的版本会出错:

util.c: 100: 1: pasting “t” and “->” does not give 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版本的编译器。


# arm-linux-strip boa(去掉boa中的调试信息)


第二步 Boa的配置


Boa需要在/etc目录下建立一个boa目录,里面放入Boa的主要配置文件boa.conf。在Boa源码目录下已有一个示例boa.conf,可以 在其基础上进行修改。关于boa.conf文件当中各配置选项的定义在文章的结尾后面附带,这儿是摘抄网上一篇博客上的文章中的,原文链接地址如下:http://hi.baidu.com/lucku17/blog/item/a4ab911893962b0134fa4137.html






1、Group的修改


修改 Group nogroup


为 Group 0


由于在/etc/group文件中没有nogroup组,所以设成0。另外在/etc/passwd中有nobody用户,所以User nobody不用修改。其实若是根用户,也不用修改,我移植之后,就没有修改,就是


User root


Group root


这样也行,关键是看你的/etc/group文件中是否有这个组和这个组中是否有这个用户。




2、ScriptAlias的修改


修改 ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/


为 ScriptAlias /cgi-bin/ /var/www/cgi-bin/




3、ServerName的设置


修改 ServerName www.your.org.here


为 ServerName www.your.org.here




注意:该项默认为未打开,执行Boa会异常退出,提示“gethostbyname::No such file or directory”,所以必须打开。其它默认设置即可。




4、User的设置


在上面的设置中设置了,


User root


在boa.conf的控制文件中可以设置 ErrorLog 为 /etc/console这样错误信息,就可以马上输出到控制台上了,其实我移植的时候,这些都是默认的。若在移植的过程中出现:


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 &


直接在浏览器中输入http://192.168.1.107,出现Red Hat的欢迎网页。静态HTML调试成功。


boa.c:194 - unable to bind: Address already in use


解决办法:可以用PS指令查看一下,占用的进程,然后用kill指令杀死该进程,就可以啦


第四步 CGI脚本测试




1、编写Helloworld.c程序


#include




int main(void)


{


printf("Content-type: text/html ");


printf(" ");


printf(" ");


printf(" ");


printf("

Hello,world.");


printf(" ");


printf(" ");


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/下,浏览器输入


ip/cgi/bin/helloworld.cgi


这样就OK了。




boa.conf各配置选项的定义,不代表个人意见,仅作参考




#监听的端口号,缺省都是80,一般无需修改


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目录


ErrorLog /var/log/boa/error_log


#访问日志文件。如果没有以/开始,则表示从服务器的根路径开始。如果不需要错误日志,则用#/dev/null或直接注释掉。在下面设置时,注意一定要建立/var/log/boa目录


#AccessLog /var/log/boa/access_log


#是否使用本地时间。如果没有注释掉,则使用本地时间。注释掉则使用UTC时间


#UseLocaltime


#是否记录CGI运行信息,如果没有注释掉,则记录,注释掉则不记录


#VerboseCGILogs


#服务器名字


ServerName www.hyesco.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目录下。




总结一下移植过程中出现的错误及解决方法:

六. 常见错误:

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