SylixOS移植Boa服务器

1. Boa简介

Boa是一种非常小巧的Web服务器，其可执行代码只有大约60KB左右。作为一种单任务Web服务器，Boa只能依次完成用户的请求，而不会fork出新的进程来处理并发连接请求。但Boa支持CGI，能够为CGI程序fork出一个进程来执行。Boa的设计目标是速度和安全，适合于嵌入式系统的单任务的http服务器，源代码开放、性能高。

下面给大家介绍一下Boa服务器在SylixOS上移植的具体操作步骤，希望能够有帮助。

2. SylixOS Boa移植：

Boa采用服务器模型，因此需要编译出服务器的可执行程序。

2.1 下载Boa源码

在官网下载第三方中间件的资源，Boa的官方网站为：http://www.boa.org/。本文中使用的版本是boa-0.94.13，下载后解压文件，文件目录如图 2-1所示。

图 2-1 Boa解压后的文件

2.2 服务器工程创建

在Real-Evo IDE中创建boa_sylixos应用工程，删除工程中src目录下的boa_sylixos.c文件，导入源码中的src目录下的一系列相关.c和.h文件。导入完成后的工程文件如图 2-2所示。

图 2-2 工程文件

2.3 修改源码文件

具体源码文件修改，详见《移植boa服务器过程文档》。

2.4 修改boa.conf配置文件

在boa-0.94.13目录下已有一个示例boa.conf，可以在其基础上进行修改。如下：

(1)Group的修改

修改：Group nogroup

为 ：Group 0

(2)user的修改

修改：User nobody

为 ：User 0

(3)ScriptAlias的修改

修改：ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/

为 ：ScriptAlias /cgi-bin/ /var/www/cgi-bin/

(5)DoucmentRoot的修改

DoucmentRoot /var/www

(6)ServerName的设置

修改：#ServerName www.your.org.here

为 ：ServerName www.your.org.here

否则会出现错误“gethostbyname::No such file or directory”

(7)AccessLog修改

修改：AccessLog /var/log/boa/access_log

为：#AccessLog /var/log/boa/access_log

否则会出现错误提示：“unable to dup2 the error log: Bad file descriptor”

2.5 编译生成boa_sylixos可执行文件

编译生成可执行文件boa_sylixos，并将之上传至目标机/etc/boa目录下；

2.6 拷贝mime.types文件

将linux /etc目录下的mime.types文件拷贝到目标机/etc目录下；（mime.types文件用来指明不同文件扩展名对应的MIME类型，一般可以直接从Linux主机上拷贝一个，大部分也都是在主机的/etc目录下。）

2.7 新建工程boa_cgi_child_func

目的：实现Boa源码中的fork函数功能

1) 创建app工程，修改boa_cgi_child_func.c文件，加入如下代码：

#include
#include
#define NI_MAXHOST 20
#define CGI_ENV_MAX 50
#define SOCKETBUF_SIZE 8192
#define MAX_HEADER_LENGTH 1024
#define CLIENT_STREAM_SIZE SOCKETBUF_SIZE
#define BUFFER_SIZE CLIENT_STREAM_SIZE
struct mmap_entry {
dev_t dev;
ino_t ino;
char *mmap;
int use_count;
size_t len;
};
struct request { /* pending requests */
int fd; /* client's socket fd */
int status; /* see #defines.h */
time_t time_last; /* time of last succ. op. */
char *pathname; /* pathname of requested file */
int simple; /* simple request? */
int keepalive; /* keepalive status */
int kacount; /* keepalive count */
int data_fd; /* fd of data */
unsigned long filesize; /* filesize */
unsigned long filepos; /* position in file */
char *data_mem; /* mmapped/malloced char array */
int method; /* M_GET, M_POST, etc. */
char *logline; /* line to log file */
char *header_line; /* beginning of un or incompletely processed header line */
char *header_end; /* last known end of header, or end of processed data */
int parse_pos; /* how much have we parsed */
int client_stream_pos; /* how much have we read... */
int buffer_start; /* where the buffer starts */
int buffer_end; /* where the buffer ends */
char *http_version; /* HTTP/?.? of req */
int response_status; /* R_NOT_FOUND etc. */
char *if_modified_since; /* If-Modified-Since */
time_t last_modified; /* Last-modified: */
char local_ip_addr[NI_MAXHOST]; /* for virtualhost */
/* CGI vars */
int remote_port; /* could be used for ident */
char remote_ip_addr[NI_MAXHOST]; /* after inet_ntoa */
int is_cgi; /* true if CGI/NPH */
int cgi_status;
int cgi_env_index; /* index into array */
/* Agent and referer for logfiles */
char *header_user_agent;
char *header_referer;
int post_data_fd; /* fd for post data tmpfile */
char *path_info; /* env variable */
char *path_translated; /* env variable */
char *script_name; /* env variable */
char *query_string; /* env variable */
char *content_type; /* env variable */
char *content_length; /* env variable */
struct mmap_entry *mmap_entry_var;
struct request *next; /* next */
struct request *prev; /* previous */
/* everything below this line is kept regardless */
char buffer[BUFFER_SIZE + 1]; /* generic I/O buffer */
char request_uri[MAX_HEADER_LENGTH + 1]; /* uri */
char client_stream[CLIENT_STREAM_SIZE]; /* data from client - fit or be hosed */
char *cgi_env[CGI_ENV_MAX + 4]; /* CGI environment */
#ifdef ACCEPT_ON
char accept[MAX_ACCEPT_LENGTH]; /* Accept: fields */
#endif
};
typedef struct request request;
int main (int argc, char **argv)
{
void (*child_func)(request *req,int *pipes,int use_pipes);
request *req;
int *pipes;
int use_pipes;
child_func = (void *) atoi(argv[0]);
req = (request *)atoi(argv[1]);
pipes = (int *) atoi(argv[2]);
use_pipes = *((int *) atoi(argv[3]));
child_func(req,pipes,use_pipes);
return (0);
}

2.8 测试Boa服务器功能2) 编译生成boa_cgi_child_func可执行文件，利用FTP工具上传到目标机/etc/boa目录下。

2.8.1 不包含cgic库的CGI程序

1) index.html 网页

<html>
<head><title>CGI登陆</title></head>
<body>
<form name="login" action="./cgi-bin/login.cgi">姓名：<input type="text" name="name" />
<br/>密码：<input type="password" name="pwd" />
<br/>确定：<input type="submit" value="登陆" />
</form>
</body>
</html>

2) test.c CGI测试程序代码

#include<stdio.h>
#include<stdlib.h>
int main()
{
char *date;
char name[50],pwd[20];
printf("content-type:text/html;charset=gb2312\n\n");
printf("<TITLE>登陆结果</TITLE>");
printf("<H3>登陆结果</h3>");
date=getenv("QUERY_STRING");
if(date==NULL)
printf("<p>错误：数据没有被输入或数据传输发生错误</p>");
else
{
sscanf(date,"name=%[^&]&pwd=%s",name,pwd);
printf("<p>name=%s</p>",name);
printf("<p>pwd=%s</p>",pwd);
printf("%s",date);
}
return 0;
}

3) 操作流程

a) 将index.html拷贝到先前我们创建的/var/www目录下；

b) 在IDE中新建boa_test应用工程，生成测试CGI程序：boa_test；

c) 将boa_test拷贝到/var/www/cgi-bin目录下

d) 执行./boa_sylixos

e) 在浏览器地址栏输入http://192.168.7.32/index.html，产生如图 2-3所示。

图 2-3 index.html登陆界面

f) 在姓名和密码栏分别输入相应值，点击登陆按钮，进入如图 24所示界面。

图 2-4 CGI响应程序执行

2.8.2 包含cgic库的CGI程序

1) 操作流程

g) 从CGI官网（http://www.boutell.com/cgic/）上下载cgic库文件；

h) 在RealEvo IDE中创建boa_cgictest应用工程；

i) 把cgic.h、cgic.c、cgictest.c 拷贝到工程boa_cgictest源码文件所在的目录src下，然后编译生成boa_cgictest文件，并将之上传到目标机/var/www/cgi-bin目录下；

j) 执行./boa_sylixos

k) 在浏览器地址栏输入http://192.168.7.32/cgi-bin/boa_cgictest，效果如图 25所示。

图 25 CGI响应程序执行

可以看到一个网页被展示出来。这样，包含cgic库的的CGI程序就运行起来了。

3. 参考资料

1) http://blog.chinaunix.net/uid-20620288-id-3139686.html

2) http://blog.csdn.net/manchestermi/article/details/50826129