嵌入式Linux上通過boa伺服器實作cgi/html的web上網簡介:
第一步 Boa程式的移植
1.下載下傳Boa源碼
2、生成Makefile檔案
3、修改Makefile檔案
4、編譯
第二步 Boa的配置
第三步boa的執行
1.将根文系統ramdisk在電腦主機上mount –o loop ramdisk 目标目錄進行展開
2.測試操作
3.将ramdisk檔案重新打包壓縮下載下傳到嵌入式闆子上
4.CGI腳本測試
簡介
随着Internet技術的興起,在嵌入式裝置的管理與互動中,基于Web方式的應用成為目 前的主流,這種程式結構也就是大家非常熟悉的B/S結構,即在嵌入式裝置上運作一個支援腳本或CGI功能的Web伺服器,能夠生成動态頁面,在使用者端隻需 要通過Web浏覽器就可以對嵌入式裝置進行管理和監控,非常友善實用。本節主要介紹這種應用的開發和移植工作。
嵌入式Web伺服器移植 由于嵌入式裝置資源一般都比較有限,并且也不需要能同時處理很多使用者的請求,是以不會使用Linux下最常用的如Apache 等伺服器,而需要使用一些專門為嵌入式裝置設計的Web伺服器,這些Web伺服器在存貯空間和運作時所占有的記憶體空間上都會非常适合于嵌入式應用場合。
典型的嵌入式Web伺服器有Boa (http://www.boa.org/)和thttpd (http://www.acme.com/software/thttpd/)等,它們和Apache等高性能的Web伺服器主要的差別在于它們一般是單程序伺服器,隻有在完成一個使用者請求後才能響應另一個使用者的請求,而無法并發響應,但這在嵌入式裝置的應用場合裡已經足夠了。
Boa是一個非常小巧的Web伺服器,可執行代碼隻有約60KB。它是一個單任務Web服務 器,隻能依次完成使用者的請求,而不會fork出新的程序來處理并發連接配接請求。但Boa支援CGI,能夠為CGI程式fork出一個程序來執行。Boa的設 計目标是速度和安全,在其站點公布的性能測試中,Boa的性能要好于Apache伺服器。
說明:下面的移植和操作是在at91rm9200晶片linux2.4.27上進行的。
第一步 Boa程式的移植
這一步的工作在電腦主機上完成。
對于uClinux-dist而言,就是make menuconfig在應用程式選單中,在network application下面選擇boa,然後到uClinux-dist目錄下執行make編譯即可。
對于有MMU的平台,如armlinux和ppclinux,都是到網上下載下傳一個boa的 tar包,随便找個主流的可用的版本即可,不要最新的也不要最舊的。下載下傳到RedHat主控端上後,解壓到任意目錄,然後修改boa/src /Makefile裡面的編譯器,就隻要加入兩三行即可,如下幾步操作:
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檔案
boa-0.94.13.tar.gz解壓後生成boa-0.94.13目錄,直接運作./電腦主機目錄/boa-0.94.13/src/configure檔案
3、修改Makefile檔案
a、 修改 CC = gcc
為 CC = /usr/local/arm/2.95.3/bin/arm-linux-gcc (根據自己電腦主機的編譯器位置定)
b、 修改 CPP = gcc - E
為 CPP = /usr/local/arm/2.95.3/bin/arm-linux-gcc -E
注意:boa-0.94.13用3.3.2和3.4.1編譯器編譯不通過。沒有具體研究。
4、編譯
進入:/電腦主機目錄/boa-0.94.13/src目錄
# make
# /usr/local/arm/2.95.3/bin/arm-linux-strip boa (這是為了進行去除boa中生成的編譯資訊,讓檔案變小)
第二步 Boa的配置
這一步的工作也在電腦主機上完成。
在電腦主機上的Boa源碼boa-0.94.13目錄下已有一個示例boa.conf,可以在其基礎上進行修改。如下:
1、Group的修改
修改 Group nogroup
為 Group 0
由于在/etc/group檔案中沒有nogroup組,是以設成0。另外在/etc/passwd中有nobody使用者,是以User nobody不用修改。
2、ScriptAlias的修改
修改 ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
為 ScriptAlias /cgi-bin/ /var/www/cgi-bin/
3、ServerName的設定
修改 ServerName www.linuxidc.com
為 ServerName www.linuxidc.com
注意:該項預設為未打開,執行Boa會異常退出,提示“gethostbyname::No such file or directory”,是以必須打開。其它預設設定即可。
注釋: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 [email protected]
#錯誤日志檔案。如果沒有以/開始,則表示從伺服器的根路徑開始。如果不需要錯誤日志,
則用#/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 http://www.linuxidc.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的執行
這一步的工作也在電腦主機上完成。但是操作到的目錄跟嵌入式闆子上的目錄有關。
1.将根文系統ramdisk在電腦主機上mount –o loop ramdisk 目标 目錄進行展開
進入展開後ramdisk的根檔案夾,然後執行下面:
# mkdir /var/log
# mkdir /var/log/boa(建立日志檔案目錄)
# mkdir /var/www (建立HTML文檔的主目錄)
# mkdir /etc/boa
将第二步中修改過的boa.conf檔案從電腦主機上别的目錄拷貝到ramdsik的相關目錄下
# cp /電腦主機目錄/ boa-0.94.13/boa.conf /etc/boa/
将mime.types檔案複制到嵌入式闆子ramdsik的/etc目錄下,通常mime.types可以從linux電腦主機的 /etc目錄下直接複制即可。
# cp / etc/mime.type /etc/
上面第一步驟中編譯生成的boa可執行檔案,将其複制到展開後ramdsik的bin目錄裡面。
# cp /電腦主機目錄/ boa-0.94.13/src/boa /bin/
2.測試操作
可以将主機 /usr/share/doc/HTML/目錄下的index.html(這個是靜态的html網頁顯示檔案,是RedHat9的歡迎首頁,當在區域網路的 PC的IE上輸入http://嵌入式闆子的IP位址時會顯示這個預設的靜态網頁)檔案和img目錄複制到嵌入式ramdsik的/var/www目錄下
# cp /usr/share/doc/HTML/index.html /var/www/
# cp /usr/share/doc/HTML/img /var/www/
# cp /usr/share/doc/HTML/index-ZH_CH.html /var/www/
3.将ramdisk檔案重新打包壓縮下載下傳到嵌入式闆子上。
Ramdisk重新大包壓縮下載下傳到闆子上後,在闆子的超級終端的根目錄下輸入./boa,看boa是否可以執行。
可能提示錯誤如:libso.0.6 GLIB2.2版本問題,這個一般是boa執行時需要動态共享庫,解決的辦法是,在編譯boa的時候用靜态的方式進行編譯,即
進入:/電腦主機目錄/boa-0.94.13/src目錄下,修改makefile檔案中:
LDFLAGS = -g
修改為:LDFLAGS = -static 就可以了。
執行boa時,可能出現其他的錯誤,則可以在開發闆的/var/log/boa/error_log檔案中找原因。大部分是跟boa.conf配置檔案的正确與否有關。如:
問題:在執行./boa時出現錯誤:boa執行時,出錯 log.c:73 unable to dup2 the error log:bad file descriptor
解決方法:在log.c裡注釋掉那個if語句。
又出現了另個問題:unable to dup2 the error log: Bad file descriptor
解決方法:在boa.conf裡注釋掉#AccessLog /var/log/boa/access_log
4.CGI腳本測試
書寫下面的test.c測試程式,
#include
#include
int main(void)
{
printf("Contenttype:text/html/n/n");
printf("/n");
printf("
An HTML Page From a CGI/n");
printf("
/n");
printf("
This is an HTML page generated from with in a CGI program..
/n");
printf("
/n");
printf("
Go back to out put.html page/n");
printf("/n");
printf("/n");
fflush(stdout);
}
交叉編譯生成test.cgi
# /usr/local/arm/2.95.3/bin/arm-linux-gcc -o test.cgi test.c
将test.cgi拷貝至嵌入式闆子的/var/www/cgi-bin/下,當在區域網路PC的IE上輸入 http:// 嵌入式闆子的IP位址/cgi-bin/test.cgi
可以顯示出test.cgi的網頁。
有關CGI的知識可以學習:用C語言實作CGI相關資料。
注意:上面代碼執行時,可能會出現錯誤提示:
502 Bad Gateway
The CGI was not CGI/1.1 compliant.
可能出現的原因:
1.測試下看是否能浏覽靜态網頁,以保證網絡是正确的。
在上面“第三步的 2.測試操作”後區域網路的PC的IE上輸入http://嵌入式闆子的IP位址,如果能顯示RedHat9的歡迎首頁,說明靜态通路是正确的了。
2.将.cgi檔案拷貝至目标闆上後,必須改變其權限
chmod 755 test.cgi
否則,上位機浏覽時會提示上面錯誤
3.最有可能是CGI程式本身的問題。
我們已經看到test.c的列印開頭有使用MIME頭資訊″Content type :text/html/n/n″來表示輸出HTML源代碼給Web伺服器。請注意任何MIME頭資訊後必須有一個空行,就是加了/n/n,
是以這點必須保證。
4.Test.c的原檔案是在文本模式下編輯的,在linux下不能執行
可以改動:dos2unix test.c 改動後再進行編譯
5.還有一種可能,test.cgi被編譯成了動态形式,然而程式執行時在嵌入式中找不到動态庫檔案,是以在編譯程式時加上-static,編譯成靜态的形式,但是這樣編譯出來的檔案很大,在嵌入式中不适宜采用這種方式。