Boa

是一套小型的网页服务器，很适合应用在Embedded System上，并且内建就可以直接支援以C写的CGI网页，这篇是移植Boa到ARM9

S3C2410平台的过程，Linux版本为2.6.17.4 ，使用arm-linux toolchain 3.4.1编译。

1.产生Makefile

下载Source code并解压缩进到src目录。

# ./configure –host=arm-linux

2.修改Makefile使用跨平台编译

CC = arm-linux-gcc

CPP = arm-linux-gcc -E

# make (如果编译或执行时有错误请看Q&A)

# arm-linux-strip boa

3.配置Boa

可以在源码目录找到这个设定档，放到/etc/boa里面，有修改的部份如下：

User 0

Group 0

#DirectoryMaker /usr/lib/boa/boa_indexer

CGIPath /bin:/usr/bin:/var/www/cgi-bin

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

然后需要放一个mime.types档案在/etc，我是直接复制ubuntu里的档案。

4.加入boa执行档

将编译好的boa执行档加入档案系统/bin，要启动server只要输入boa即可，可到/var/log/boa查看log。

问题Q&A：

Q：使用toolchain 3.4.1编译出现错误

arm-linux-gcc -g -O2 -pipe -Wall -I. -c -o util.o util.c

util.c:100:1: pasting "t" and "->" does not give a valid preprocessing token

make: *** [util.o] Error 1

A：修改src/compat.h

找到

#define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff

修改成

#define TIMEZONE_OFFSET(foo) (foo)->tm_gmtoff

Q：执行boa出现"gethostbyname::No such file or directory"

A：需将boa.conf里的ServerName开头注解拿掉

Q：无法启动Boa，error log显示"boa.c:266.icky Linux kernel bug!:No such file"

A：修改src/boa.c，将底下判断式注解掉：

/*if (setuid(0) != -1) {

DIE("icky Linux kernel bug!");

}*/

重新编译

Q：无法启动Boa，error log显示"boa.c:211 - getpwuid….略"

A：修改src/boa.c，将底下两个判断式注解掉：

/*if (passwdbuf == NULL) {

DIE("getpwuid");

}

if (initgroups(passwdbuf->pw_name, passwdbuf->pw_gid) == -1) {

DIE("initgroups");

}*/boa的配置文件是/etc/boa/boa.conf。

Port：boa服务器监听的端口，默认的端口是80。如果端口小于1024，则必须是root用户启动服务器。

Listen：绑定的ip地址。不使用这个参数时，将绑定所有的地址。

User：连接到服务器的客户端的身份，可以是用户名或UID。(为什么非要指定为文件的所有者才能访问网页呢？nobody用户也有读权限啊)

Group：连接到服务器的客户端的组，可以是组名或GID。

ServerAdmin：服务器出故障时要通知的邮箱地址。

ErrorLog：指定错误日志文件。如果路径没有以“/”开始，则相对于ServerRoot路径。没有配置时默认的文件是/dev/stderr。若不想记录日志，指定文件为/dev/null。

AccessLog：设置存取日志文件，与ErrorLog类似。

UseLocaltime：设置使用本地时间，使用UTC时注释这个参数。这个参数没有值。

VerboseCGILogs：在错误日志文件中记录CGI启动和停止时间，若不记录，注释这个参数。这个参数没有值。

ServerName：指定服务器的名称，当客户端使用gethostname + gethostbyname时返回给客户端。

VirtualHost：虚拟主机开关。使用此参数，则会在DocumentRoot设定的目录添加一个ip地址作为新的DocumentRoot来

处理客户端的请求。如DocumentRoot设置为/var/www，则

则转换成/var/www/127.0.0.1/，若注释此参数，则为/var/www/。

DocumentRoot：HTML文件的根目录(也就是网站的目录)。

UserDir：指定用户目录。

DirectoryIndex：指定预生成目录信息的文件，注释此变量将使用DirectoryMaker变量。这个变量也就是设置默认主页的文件名。

DirectoryMaker：指定用于生成目录的程序，注释此变量将不允许列目录。

DirectoryCache：当DirectoryIndex文件不存在，而DirecotryMaker又被注释掉时，将列出这个参数指定目录给客户端。

KeepAliveMax：每个连接允许的请求数量。如果将此值设为" 0 "，将不限制请求的数目。

KeepAliveTimeOut：在关闭持久连接前等待下一个请求的秒数。(秒)。

MimeTypes：设置包含mimetypes信息的文件，一般是/etc/mime.types。

DefaultType：默认的mimetype类型，一般是text/html。

CGIPath：相当于给CGI程序使用的$PATH变量。

SinglePostLimit：一次POST允许最大的字节数，默认是1MB.

AddType: 增加MimeType没有指定的类型，例: AddType type extension [extension ...]。要使用cgi，必须添加cgi类型：AddType application/x-httpd-cgi cgi

Redirect：重定向文件

Aliases：指定路径的别名。

ScriptAlias：指定脚本路径的虚拟路径。