thttpd 是一个小型的 HTTP 服务器
官方网址:http://www.acme.com/software/thttpd/
下载 version 2.25b 的源码后解压,切换到源码目录,编译步骤为:
./configure
make
thttpd一共有16个源文件:
config.h fdwatch.h libhttpd.h match.h mmc.h tdate_parse.h timers.h version.h
fdwatch.c libhttpd.c match.c mmc.c strerror.c tdate_parse.c thttpd.c timers.c
fdwatch是套接字管理模块
mmc是内存管理模块
timers是定时器管理模块
libhttpd实现http 服务端的处理方法
thttpd实现了主函数
下面是主模块的大体流程图:
mmc模块分析
映射文件到内存,如果定义了HAVE_MMAP,使用mmap,否则使用malloc。
mmc_map函数的步骤是:
查找哈希表,如果已经存在于哈希表中,直接从表中取出,然后返回;
否则查找free_maps,如果free_maps可用,直接取出来用,free_maps为空时,malloc一块内存使用;
接下来判断文件大小,大小不为0时,因为定义了HAVE_MMAP,所以使用mmap内存映射文件;
然后把这个Map结构体添加到哈希表中,同时把这个Map添加到全局变量maps的链表头部。
mmc_unmap函数的步骤:
首先在哈希表中查找这个Map结构,如果没有找到,遍历全局变量maps链表寻找;
如果都没有找到或者找到后发现引用计数<=0,打印错误日志,函数结束;
找到了就减少这个Map的引用计数。
mmc_cleanup函数的步骤:
遍历全局变量maps,当此Map上的引用计数为0或者时间过期了,调用really_unmap。
如果空闲总数大于DESIRED_FREE_COUNT,循环删除全局变量free_maps链表的头部的元素,直到
free_count<=DESIRED_FREE_COUNT
really_unmap函数的步骤:
munmap取消内存映射,将这个Map结构添加到free_maps链表的头部,减少映射总数,增加空闲总数
mmc_destroy函数的步骤:
遍历maps链表,调用really_unmap,然后遍历free_maps链表,释放内存,减少空闲总数、分配总数。
check_hash_size函数的步骤:
当hash_table为空时,初始化hash_size、hash_mask,
当hash_size >= 3倍的映射总数,直接返回,
否则释放掉原先的哈希表,增大hash_size,
malloc (hash_size)大小的内存,遍历maps链表,调用add_hash将所有元素
添加到哈希表中。
fdwatch模块分析
此源文件根据Makefile中的宏定义决定采用哪种模型。
select,kqueue -- BSD系统
poll -- SysV系统
fdwatch_get_nfiles函数的功能:
获取可操作的文件描述符总数;
根据HAVE_SELECT,HAVE_POLL,HAVE_DEVPOLL,HAVE_KQUEUE这其中的哪个宏被定义,
调用宏INIT,因为HAVE_SELECT宏被定义,所以INIT被定义为select_init。
fdwatch_add_fd
宏ADD_FD被定义为select_add_fd
fdwatch_del_fd
宏DEL_FD被定义为select_del_fd
fdwatch
宏WATCH被定义为select_watch
fdwatch_check_fd
宏CHECK_FD被定义为select_check_fd
fdwatch_get_next_client_data
宏GET_FD被定义为select_get_fd
libhttpd模块分析
httpd_initialize函数的功能:
malloc(httpd_server),申请一块内存用来保存httpd_server这个结构体,然后设置这个结构体中的成员;
根据参数sa6P和sa4P创建套接字,绑定套接字,然后监听这个套接字;
初始化mime媒体类型。
httpd_unlisten函数的功能:
调用close关闭监听套接字
httpd_get_conn函数的功能:
httpd_realloc_str分配内存空间;
调用accept接收客户机的连接,对httpd_conn结构体中的字段进行赋值
httpd_parse_request函数的功能:
调用bufgets获取远程连接的HTTP各个字段,如HTTP版本,mime类型。
httpd_close_conn函数的功能:
释放文件映射,关闭此套接字连接
ls函数的功能:
扫描指定目录下的子目录和文件,列出文件名,属性,链接数,大小,修改时间。
thttpd主模块分析
handle_term函数的步骤是:
对信号SIGTERM,SIGINT进行处理的函数
parse_args函数的步骤是:
处理进程启动时传递的参数,设置相应的全局变量。
read_config函数的步骤是:
读取配置文件,设置相应的全局变量。
read_throttlefile函数的步骤是:
读取‘流量控制配置文件’,设置throttletab。
shut_down函数的步骤是:
关闭connecttab中所有的连接,销毁这些连接;
关闭监听套接字,销毁http服务端;
销毁内存管理对象、定时器对象。
handle_newconnect函数的步骤是:
malloc一块内存保存httpd_conn,调用httpd_get_conn获取接收连接,
调用httpd_set_ndelay设置为非阻塞模式;
然后调用fdwatch_add_fd加入select集合。
handle_read函数的步骤是:
调用read读取此套接字上发送过来的数据,调用httpd_got_request获取http请求头,
调用httpd_parse_request分析请求头,调用check_throttles检查一下是否符合流控策略,
调用httpd_start_request发送给回HTTP响应头,
调用fdwatch_del_fd移除此读套接字,然后调用fdwatch_add_fd加入写套接字。
finish_connection函数的步骤是:
调用httpd_write_response发送完buffer中的数据;
调用clear_connection清除连接。
really_clear_connection函数的步骤是:
调用fdwatch_del_fd从select集合中移除此套接字;
调用httpd_close_conn关闭此连接;
调用clear_throttles清除此流控;
将此连接表的状态设置为空闲,将此空闲连接索引设置为可用,减少连接总数;
idle函数的步骤是:
遍历connects数组,获取状态,根据当前状态进行处理;
此函数为主函数中设置的空闲定时器调用例程。
show_stats函数的步骤是:
调用logstats函数,logstats函数调用thttpd_logstats、httpd_logstats、mmc_logstats、
fdwatch_logstats、tmr_logstats记录日志。
main函数的步骤是:
调用openlog打开系统日志;
调用parse_args处理main函数传进来的参数;
调用read_throttlefile读取流控配置文件;
调用系统函数getcwd获取当前工作目录;
因为Makefile文件定义了HAVE_DAEMON,所以调用daemon启动后台服务,fork创建子进程,父进程退出;
因为定义了宏HAVE_SETSID,所以调用系统函数setsid;
调用fdwatch_get_nfiles初始化fdwatch,获取资源信息;
因为定义了宏HAVE_SIGSET,所以调用sigset设置对系统信号的处理函数;
调用tmr_init初始化定时器对象;
调用httpd_initialize初始化http server对象;
安装occasional,idle,update_throttles,show_stats 4个系统定时器;
设置UID;
调用malloc分配connects连接表数组;
调用fdwatch_add_fd将IPV4,IPV6监听套接字加入select集合;
进入主循环;
调用fdwatch获取套接字集合中的信息;
当套接字上有事件发生时,检查此套接字,调用handle_newconnect获取新的连接;
调用fdwatch_get_next_client_data获取数据,判断此套接字的连接状态,
根据状态分别调用handle_read,handle_send,handle_linger函数;
调用tmr_run运行定时器;
判断全局变量got_usr1,当SIGUSR1信号被接收时,handle_usr1函数被调用,got_usr1被置1,此时
terminate变量被置1,主循环结束,监听套接字被移除,httpd_unlisten函数被调用;
调用shut_down销毁http server对象;
关闭系统日志,守护进程自此结束。