Shulou(Shulou.com)06/02 Report--

1. Brief introduction to Boa

Boa is a very small Web server with only about 60KB executable code. As a single-task Web server, Boa can only complete the user's requests in turn, and will not fork new processes to handle concurrent connection requests. However, Boa supports CGI and can be executed by a process for the CGI program fork. The design goal of Boa is speed and security. It is a single-task http server suitable for embedded systems with open source code and high performance.

The following is to introduce the specific steps of porting Boa server on SylixOS. I hope it will be helpful.

2. SylixOS Boa migration:

Boa uses the server model, so the executable program of the server needs to be compiled.

2.1 download the Boa source code

Download the resources of third-party middleware on the official website. The official website of Boa is http://www.boa.org/. The version used in this article is boa-0.94.13, which is downloaded and extracted, and the file directory is shown in figure 2-1.

Figure 2-1 Boa decompressed file

2.2 Server project creation

Create a boa_sylixos application project in Real-Evo IDE, delete the boa_sylixos.c file in the src directory in the project, and import a series of related .c and .h files in the src directory in the source code. The project file after import is shown in figure 2-2.

Figure 2-2 Engineering document

2.3 modify the source file

Specific source code file modification, see "porting boa server process documentation" for more information.

2.4 modify the boa.conf configuration file

There is already a sample boa.conf in the boa-0.94.13 directory that can be modified based on it. As follows:

(1) Modification of Group

Modify: Group nogroup

Is: Group 0

(2) Modification of user

Modify: User nobody

Is: User 0

(3) Modification of ScriptAlias

Modified: ScriptAlias / cgi-bin/ / usr/lib/cgi-bin/

Is: ScriptAlias / cgi-bin/ / var/www/cgi-bin/

(5) Modification of DoucmentRoot

DoucmentRoot / var/www

(6) setting of ServerName

Modify: # ServerName www.your.org.here

Is: ServerName www.your.org.here

Otherwise, there will be an error "gethostbyname::No such file or directory"

(7) AccessLog modification

Modified: AccessLog / var/log/boa/access_log

Is: # AccessLog / var/log/boa/access_log

Otherwise, an error message will appear: "unable to dup2 the error log: Bad file descriptor"

2.5 compile to generate boa_sylixos executable file

Compile and generate the executable file boa_sylixos, and upload it to the target machine / etc/boa directory

2.6 copy mime.types Fil

Copy the mime.types file under the linux / etc directory to the target machine / etc directory; (the mime.types file is used to indicate the MIME type corresponding to different file extensions. Generally, you can copy one directly from the Linux host, and most of them are also in the / etc directory of the host. )

2.7 New Project boa_cgi_child_func

Objective: to realize the function of fork function in Boa source code

1) create an app project, modify the boa_cgi_child_func.c file, and add the following code:

# 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 [buff _ SIZE + 1]; / * generic Imax 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 allow [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) compile and generate boa_cgi_child_func executable files and upload them to the target machine / etc/boa directory using FTP tools.

2.8Test Boa server function 2.8.1 CGI programs without cgic libraries

1) index.html web page

CGI login

Name:

Password:

Determine:

2) test.c CGI test program code

# include

# include

Int main ()

{

Char * date

Char name [50], pwd [20]

Printf ("content-type:text/html;charset=gb2312\ n\ n")

Printf ("login results")

Printf ("login results")

Date=getenv ("QUERY_STRING")

If (date==NULL)

Printf ("

Error: data was not entered or an error occurred in data transfer

")

Else

{

Sscanf (date, "name=% [^ &] & pwd=%s", name,pwd)

Printf ("

Name=%s

", name)

Printf ("

Pwd=%s

", pwd)

Printf ("% s", date)

}

Return 0

}

3) Operation flow

A) copy index.html to the / var/www directory we created earlier

B) create a new boa_test application project in IDE and generate a test CGI program: boa_test

C) copy boa_test to the / var/www/cgi-bin directory

D) execute. / boa_sylixos

E) enter http://192.168.7.32/index.html in the browser address bar to produce as shown in figure 2-3.

Figure 2-3 index.html login interface

F) enter the corresponding values in the name and password fields, and click the login button to enter the interface shown in figure 24.

Figure 2-4 CGI responder execution

2.8.2 CGI programs containing cgic libraries

1) Operation flow

G) download cgic library files from the CGI official website (http://www.boutell.com/cgic/)

H) create a boa_cgictest application project in RealEvo IDE

I) copy cgic.h, cgic.c, cgictest.c to the directory where the project boa_cgictest source code file is located, compile and generate the boa_cgictest file, and upload it to the target machine / var/www/cgi-bin directory

J) execute. / boa_sylixos

K) enter http://192.168.7.32/cgi-bin/boa_cgictest in the browser address bar, and the effect is shown in figure 25.

Figure 25 CGI Responder execution

You can see a web page displayed. In this way, the CGI program that contains the cgic library runs.

3. references

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

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

Welcome to subscribe "Shulou Technology Information " to get latest news, interesting things and hot topics in the IT industry, and controls the hottest and latest Internet news, technology news and IT industry trends.