Boa服務器在ARM+Linux上的移植

Boa是一種非常小巧的Web服務器，其可執行代碼只有大約60KB左右。

作為一種單任務Web服務器，Boa只能依次完成用戶的請求，而不會fork出新的進程來處理并發連接請求。但Boa支持CGI，能夠為CGI程序fork出一個進程來執行。Boa的設計目標是速度和安全。

二、移植環境

（1）源碼的獲取

Boa的源碼可以從網站www.boa.org獲取

（2）Boa移植平臺

nPC機（RedHat9.0操作系統）

n交叉編譯工具,arm-linux,最好是2.9的

三、移植步驟

（1）解壓源碼$ tar xzvf boa-0.94-14.tar.gz

（2）$cd boa-0.94-14 目錄下，進入src目錄中

（3） ./configure 配置安裝文件，自動根據Makefile.in 生成Makefile文件

（4） 生成的Makefile文件是針對X86平臺的，為了生成能夠在ARM上運行的boa，

需要修改Makefile文件,用vi或則gedit修改Makefile文件中的CC = CC ；CPP = CC –E修改為自己的交叉編譯器如：

CC = arm-linux-gcc；和CC = arm-linux-gcc –E(這是在交叉編譯器環境變量配置好的情況下，如果沒有配置好，需要把路徑填寫完整)

（5）然后執行make，生成可執行程序boa，就在src目錄下面，后面就要用到這個可執行程序。

三、Boa.conf文件分析

在Boa源碼目錄下已有一個示例boa.conf，可以在其基礎上進行修改，下面解釋一下該文件的含義：

#監聽的端口號，缺省都是80，一般無需修改注意，如果你你的httpd服務時已經開啟，那么你必須關掉或者重新設定端口號，當你修改了模式http端口那么訪問的時候要加上端口號，如http：//192.168.0.2:1100

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地址，目前未用，注釋掉

#ServerAdminroot@localhost

#錯誤日志文件。如果沒有以/開始，則表示從服務器的根路徑開始。如果不需要錯誤日志，則用#/dev/null。在下面設置時，注意一定要建立/var/log/boa目錄，也可以將其注釋掉否則為出現Can’t open /var/log/boa/error_log錯誤

ErrorLog /var/log/boa/error_log

#訪問日志文件。如果沒有以/開始，則表示從服務器的根路徑開始。如果不需要錯誤日志，則用#/dev/null或直接注釋掉。(在這里我遇到的問題是，cannot open /usr/boa/log/boa/access_log for logging,permission denied.<前面的路徑是我定義的路徑，大家依據自己的情況作適當修改>這是權限不足的問題，可是其它的方法我都試了一遍，也沒有成功，最好把AcessLog /usr/boa/log/boa/access_log前面加個#號，也就是注掉，如下面，問題就解決了) 在下面設置時，注意一定要建立/var/log/boa目錄,也可以將其注釋掉否則會出錯

#AccessLog /var/log/boa/access_log

#是否使用本地時間。如果沒有注釋掉，則使用本地時間。注釋掉則使用UTC時間

#UseLocaltime

#是否記錄CGI運行信息，如果沒有注釋掉，則記錄，注釋掉則不記錄

#VerboseCGILogs

#服務器名字

ServerName www.shuzhengfeng.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 /barhttp://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目錄下。

四、源碼修改

第一、修改boa-0.94-14/src目錄下面的defines.h里的

#ifndef SERVER_ROOT

#define SERVER_ROOT"/etc/boa"

#endif,

"/etc/boa"該路徑為boa.conf存放的路徑。

第二、修改boa.conf文件

（1）Group nogroup

Group nogroup—>改為Group nobody

（2）DoucmentRoot的修改

修改DoucmentRoot /var/www ，為存放網頁的路徑

第三、運行Boa

./Boa

出現boa：server version Boa/0.94.14

boa: server built Sep 15 2009 at 01:02:14

boa: starting server pid=14390 ,port 80

五、服務器測試以及網頁編寫

（1）測試

打開Mozilla瀏覽器，輸入自己的IP地址如：192.168.0.2 就可以打開網頁。

（2）簡單網頁的編寫網頁

equiv="Content-Type" content="text/html; charset=gb2312">

Hello veryone!!!!!!!!!!!!!!!!!!!!!!!!

六、可能出錯及修正

(1) 會出現錯誤：util.c:100:1: error: pasting "t" and "->" does not give a valid preprocessing token make: * [util.o] 錯誤 1

修改 src/compat.h

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

修改成

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

(2) 會出現錯誤log.c:73 unable to dup2 the error log:bad file descriptor

修改 src/log.c注釋掉

　　if (dup2(error_log, STDERR_FILENO) == -1) {

　　DIE("unable to dup2 the error log");

　　}

　　為：

(3) 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）會出現問題：boa.c:228 - icky Linux kernel bug!: 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