goAhead2.5嵌入式web服务器移植

1. GoAhead Web服务器介绍

goAhead Web服务器,小巧、精致,提供了值得称道的性能,特别适合于嵌入式系统,因此,在很多嵌入式产品如路由器中都用到了goAhead作为嵌入式web服务器。

goAhead Web服务器,具有如下特点:
支持ASP;
嵌入式的JavaScript,即Ejscript;
支持内存中的CGI处理;
快速响应,每秒中可处理超过65个请求;
符合HTTP1.0/HTTP1.1标准;
拥有众多扩展API,方便用户开发;
支持SSL3.0(Secure Sockets Layer),如MatrixSSL(最新版本为:MatrixSSL 3-2);
支持用户群组管理;
支持DAA访问认证;
占用很小内存,如果不包含SSL,仅要求60K内存;包含SSL,要求500K内存;
Web页面可存在于ROM或文件系统中;
支持多种操作系统,如linux、wince、vxworks等等;

当前最新版本为:WebServer 2.5,本次移植即是这个版本。

2. 获取Goahead源码包

地址为:
http://velep.com/archives/321.html
http://velep.com/download/webs-2-5.tar.gz
当前最新版本为:WebServer 2.5

下载后,解压压缩包:

1
2
#tar -xzvf webs-2-5.tar.gz
#cd webs-2-5/

3. goAhead源码结构

进入goAhead的源码目录webs-2-5/,很容易了解其源码结构。
webs-2-5/

| 各种OS移植子目录,分别有:CE、ECOS、LINUX、LYNX、MACOSX、NW、QNX4、VXWORKS、WIN

| utils:当前只有webcomp.c,即网页编译器

| www:存放web网页

| wwwdemo:goAhead带的demo网页,里面包含了goAhead的一些文档

| goAhead服务器源程序文件(C程序文件)

从上面可以看到,goAhead支持window系统的,有兴趣的可以在PC机上移植试试。
得到源码后,建议用source insight等工具建一个goAhead工程,便于代码的阅读或者查询API函数等。

4. goAhead自带帮助文档

进入goAhead的wwwdemo目录,找到Webs25GettingStarted.pdf文件,这就是goAhead带的帮助文档,移植前,建议先看下。

5. GoAhead Web服务器移植到arm-linux步骤

在获取源码包并解压后,现在把goAhead移植到arm-linux中,arm指at91sam9g35,linux-2.6.39。
移植步骤很简单,基本上在编译阶段不会出现什么问题,而且这几个步骤在网上诸多博客中都有说明。但在测试服务器的时候,遇到了问题,在浏览器死活都打不开网页,不过,最终还是解决了,请看下面说明。

5.1 修改Makefile文件

进入goAhead源码下的LINUX目录,用UE打开Makefile文件。

Makefile文件默认是虚拟机的本身的GCC编译器,因此,指定其交叉编译器,注意,交叉编译器的版本应与你的文件系统用的交叉编译器一致。

在Makefile文件开头添加如下信息:
1
2
3
4
5
6
7
8
9
10
11
# add by: cuiqingwei
CROSS_COMPILE =/opt/arm-2007q1/bin/arm-none-linux-gnueabi-
AS = $(CROSS_COMPILE)as
LD = $(CROSS_COMPILE)ld
CC = $(CROSS_COMPILE)gcc
CPP = $(CC) -E
AR = $(CROSS_COMPILE)ar
NM = $(CROSS_COMPILE)nm
STRIP = $(CROSS_COMPILE)strip
OBJCOPY = $(CROSS_COMPILE)objcopy
OBJDUMP = $(CROSS_COMPILE)objdump
同时把Makefile中的语句:
1
matrixsslDir:=$(shell ls -d ../matrixssl-3-1*/)  
屏蔽掉。这一句是用来启动SSL matrixssl的,具体参考Webs25GettingStarted.pdf文档中的说明(Page8)。

5.2 修改LINUX/main.c文件:initWebs()函数中指定IP地址

由于LINUX/main.c文件:initWebs()函数中原程序无法正确获得服务器IP;因此置服务器一个静态IP地址。

修改如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/*
* Define the local Ip address, host name, default home page and the
* root web directory.
*/
/* del by: cuiqingwei
if (gethostname(host, sizeof(host)) < 0) {
error(E_L, E_LOG, T("Can't get hostname"));
return -1;
}
if ((hp = gethostbyname(host)) == NULL) {
error(E_L, E_LOG, T("Can't get host address"));
return -1;
}
memcpy((char *) &intaddr, (char *) hp->h_addr_list[0],
(size_t) hp->h_length);
*/
intaddr.s_addr = inet_addr(T("192.168.1.159")); // add by: cuiqnigwei

5.3 编译:make clean;make

在shell中进入LINUX目录下,执行命令
make clean
make
即可编译通过。

编译通过后,在LINUX目录下,得到两文件,分别为:libwebs.a和webs可执行文件。用如下命令查看webs执行文件依赖的库文件:

arm-none-linux-gnueabi-readelf -a webs >a.txt

其中,arm-none-linux-gnueabi-依你用的交叉编译器而定。

查看得到a.txt,如下信息:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
Program Headers:
Type Offset VirtAddr PhysAddr FileSiz MemSiz Flg Align
EXIDX 0x00f074 0x00017074 0x00017074 0x00008 0x00008 R 0x4
PHDR 0x000034 0x00008034 0x00008034 0x00100 0x00100 R E 0x4
INTERP 0x000134 0x00008134 0x00008134 0x00013 0x00013 R 0x1
[Requesting program interpreter: /lib/ld-linux.so.3]
LOAD 0x000000 0x00008000 0x00008000 0x0f080 0x0f080 R E 0x8000
LOAD 0x00f080 0x0001f080 0x0001f080 0x0063c 0x007e0 RW 0x8000
DYNAMIC 0x00f08c 0x0001f08c 0x0001f08c 0x000e8 0x000e8 RW 0x4
NOTE 0x000148 0x00008148 0x00008148 0x00020 0x00020 R 0x4
GNU_STACK 0x000000 0x00000000 0x00000000 0x00000 0x00000 RW 0x4
....
Dynamic section at offset 0xf08c contains 24 entries:
Tag Type Name/Value
0x00000001 (NEEDED) Shared library: [libc.so.6]
0x0000000c (INIT) 0x8ddc
0x0000000d (FINI) 0x158f0
0x00000019 (INIT_ARRAY) 0x1f080
0x0000001b (INIT_ARRAYSZ) 4 (bytes)
0x0000001a (FINI_ARRAY) 0x1f084
0x0000001c (FINI_ARRAYSZ) 4 (bytes)
0x00000004 (HASH) 0x8168
0x00000005 (STRTAB) 0x886c
0x00000006 (SYMTAB) 0x83ac
0x0000000a (STRSZ) 615 (bytes)
0x0000000b (SYMENT) 16 (bytes)
0x00000015 (DEBUG) 0x0
0x00000003 (PLTGOT) 0x1f174
0x00000002 (PLTRELSZ) 584 (bytes)
0x00000014 (PLTREL) REL
0x00000017 (JMPREL) 0x8b94
0x00000011 (REL) 0x8b8c
0x00000012 (RELSZ) 8 (bytes)
0x00000013 (RELENT) 8 (bytes)
0x6ffffffe (VERNEED) 0x8b6c
0x6fffffff (VERNEEDNUM) 1
0x6ffffff0 (VERSYM) 0x8ad4
0x00000000 (NULL) 0x0
从上面可看到,webs依赖ld-linux.so.3和libc.so.6两个动态文件,查看文件系统中lib目录下是否包含了这动态文件,如果没有,则需从交叉编译器安装路径中获取这个动态库文件到文件系统lib目录中。
1
cd /opt/arm-2007q1
查找文件
1
find -name ld-linux.so.3
得出结果
1
2
3
4
./arm-none-linux-gnueabi/libc/thumb2/lib/ld-linux.so.3
./arm-none-linux-gnueabi/libc/lib/ld-linux.so.3
./arm-none-linux-gnueabi/libc/armv4t/lib/ld-linux.so.3
./arm-none-linux-gnueabi/libc/marvell-f/lib/ld-linux.so.3
复制ld-linux.so.3
1
cp arm-none-linux-gnueabi/libc/armv4t/lib/ld-linux.so.3 开发板/lib
查找文件
1
find -name libc.so.6
得出结果
1
2
3
4
5
6
./arm-none-linux-gnueabi/libc/thumb2/lib/libc.so.6
./arm-none-linux-gnueabi/libc/lib/libc.so.6
./arm-none-linux-gnueabi/libc/armv4t/lib/libc.so.6
./arm-none-linux-gnueabi/libc/marvell-f/lib/libc.so.6
复制libc.so.6
cp arm-none-linux-gnueabi/libc/armv4t/lib/libc.so.6 开发板/lib

5.4 测试webs服务器

用FTP把webs执行文件传到目标板中,本人把其放到了/mnt/webs/目录中。

配置开发版IP地址
1
ifconfig eth0 192.168.1.159
挂载NFS
1
mount 192.168.1.158:/srv/nfs /mnt
运行web服务
1
./webs &
杀死web服务
1
killall webs
在PC机用IE浏览器浏览goAhead服务器的网页,输入http://192.168.1.159:8080/

运行webdemo服务
1
./webs -demo &
杀死web服务
1
killall webs
需要注意的是,在goAhead2.5版本中,web网页的根目录是在webs程序的../www或../wwwdemo(webs执行时带-demo参数)中,
这一点可查看LINUX/main.c    文件中190行处代码和注释。因此,把goAhead源码目录下的www和wwwdemo两文件夹传用FTP传到/mnt/目录下。

在PC机用IE浏览器浏览goAhead服务器的网页,输入http://192.168.1.159:8080/

192.168.1.159是目标板的IP地址即goAhead服务器的地址,8080是goAhead用的端口号,这是默认的端口号,定义在webs.h文件。
文章目录
  1. 1. 1. GoAhead Web服务器介绍
  2. 2. 2. 获取Goahead源码包
  3. 3. 3. goAhead源码结构
  4. 4. 4. goAhead自带帮助文档
  5. 5. 5. GoAhead Web服务器移植到arm-linux步骤
    1. 5.1. 5.1 修改Makefile文件
    2. 5.2. 5.2 修改LINUX/main.c文件:initWebs()函数中指定IP地址
    3. 5.3. 5.3 编译:make clean;make
    4. 5.4. 5.4 测试webs服务器