一、BOA
基于嵌入式WEB服务器2(boa)
boa在嵌入式Linux上的移植
本文也是在网上从多的移植文章中修改添加得来的。
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文件
修改 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
为 ServerName
注意：该项默认为未打开，执行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 &
直接在浏览器中输入，出现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
#是否启动虚拟主机功能，即设备可以有多个网络接口，每个接口都可以拥有一个虚拟的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
#为路径加上别名
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 前的注释符号(#)
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
阅读(3773) | 评论(0) | 转发(1) |
