一、acl 是什么？

 

　　其实是一个很简单的问题，acl 的英文字母 advanced C library 的缩写（当然，您也可以认为是 a C library 的缩写）。也许有人会问："现在有这么多C的函数库，为何还费这么大劲再写一个？"。的确，现在开源的 C 函数库真是太多了，比如：glib（这是一个gnome工作组开发维护的库，开始也是为了gnome界面用，后来发展成通用的 C 函数库），libevent（这是UNIX平台下一个封装了 select/poll/epoll/kquue 等的库，主要是为了应对大并发网络程序的开发），pthread-win32（这是在win32平台下按Posix接口标准写的库，其中google的 chrome 浏览器就用到了它），当然还有更为著名的 C++ 函数库 ACE（还有自称比ACE还好的C++库ICE）。每个库都有各自的特点，都能满足不同的应用需求。但是，当我在开发一个希望能跨平台的、支持常见数据算法、有很好的服务器框架、支持线程池/进程池、支持同步/异步通信、简单易用可扩展、支持HTTP协议、ICMP协议、DNS协议等的应用时，就不得不组合各个函数库，有时还得为这些库的不兼容性做些努力。

 

二、acl 是怎么来的？

 

　　因此写一个通用简单的 C 库就成为了一个小小的目标，开始 acl 的名字叫 util，生成的库名叫 lib_util.a，并且该库的函数大部是从 Postfix 借鉴过来的，也就是说初期没有 Postfix 就不会有 acl。Postifx 虽然只是一个邮件的 mta（现在国内的很多大的网站的MTA就是由 Postfix 修改而成，象 sohu, 263, sina, qq　等的邮件系统），但其中的函数库却设计的如此巧夺天工， 虽然是用 C 语言写成，但其设计思想却可与 C++ 媲美，Wietse Venema   不愧为世界级架构师，否则IBM也就不会请他来写 Postfix 了，在读了 Postfix 的源码后，本人将其中一些具有通用性的函数库(象vstring.c, htable.c, ring.c, etc)抽出来，构成了 lib_util.a 的主体部分。随着时间的演变， lib_util 里加的函数库越来越多，并且在与其它函数库连用时很容易造成命名冲突，因为 C 语言没有象 C++ 命名空间的概念，一般的做法都是在函数名前加 xxx 前后缀来区分。所以，是应该重新给 lib_util 起个名字的时候了，象 tcl(turbo c library), 等名字都被用过，但总觉得有点别扭，有一天突然想到用 acl 似乎也不错，嗯，advanced C library －－－高级 C 库，意思是应该比 ANSI C 的标准库提供更为高级的功能。acl 名称确定下来后，于是把函数的名称都加了小写的 acl_ 前缀，结构、宏、全局定义的名称前都加了 ACL_ 前缀，确实是个不错的命名。

 

三、acl 的目录划分

 

　　开始时 acl 的目录规划比较简单，只有 src/ 和 include/ 两个目录，所有的源代码及头文件都分别放在这两个目录下，当然这也主要是因为 Postifx 的 util/ 目录下是通用的函数库的原因（当初就是想把 Postfix 的 util/ 下的库单独抽出来），当发现函数库越来越多时，发现将所有源代码放在同一目录下维护起来是多么地麻烦，所以想应该规划一下目录结构了，于是乎，划分了几个一级目录：stdlib/, event/, aio/, thread/ 等目录，其中在 stdlib/ 目录下还有 common/, memroy/, string/, configure/ 等二级目录。这样，acl 的体系结构算是基本形成了。现在 acl 的目录划分基本是以功能为标准的，各个目录的主要功能如下：

 

3.1 src 目录

 

3.1.1 init/ : 主要用于初始化 acl 基础库

 

3.1.2 stdlib/ : 是一些比较基础的功能函数库，在 stdlib/ 根目录下主要包括一些有关日志记录、网络/文件流处理、VSTRING缓冲操作等功能函数；在 stdlib/ 下还有二级目录，如下：

3.1.2.1 common/ : 该目录主要为一些常用的数据结构及算法的功能函数库，象哈希表、链表、队列、动态数组、堆栈、缓存、平衡二叉树、模式匹配树等；

3.1.2.2 memory/ : 该目录主要包含与内存操作相关的函数库，象内存基础分配与校验、内存池管理、内存切片管理等；

3.1.2.3 filedir/ : 该目录主要包含与目录遍历、目录创建等相关的库；

3.1.2.4 configure/ : 该目录主要包含配置文件的分析库；

3.1.2.5 iostuff/ : 该目录主要包含一些常用的IO操作的函数库，象读/写超时、设置IO句柄的阻塞模式等；

3.1.2.6 string/ : 该目录主要包含一些常用的字符串操作的库，提供了比标准C更灵活高效的字符串操作功能；

3.1.2.7 debug/ : 主要用于协助调试内存的泄露等功能；

3.1.2.8 sys/ : 主要是与不同操作系统平台相关的API的封装函数库；

 

3.1.3 net/: 是与网络操作相关的函数库，包含网络监听、网络连接、DNS查询、套接口参数设置等功能；

3.1.3.1 connect/ : 主要是与网络连接相关的函数库，包含网络连接、域套接口连接等；

3.1.3.2 listen/ : 主要是与网络监听相关的函数库，包含网络监听、域套接口监听等；

3.1.3.3 dns/ : 主要是与DNS域名查询相关的函数库，包含对 gethostbyname 等接口的封装、按RFC1035标准直接发送UDP包方式进行查询等功能；

 

3.1.4 event/ : 主要封装了 select/poll/epoll/kqueue/devpoll 等系统API接口，使处理网络事件更加灵活、高效、简单，另外还包含定时器接口，acl 中的很多网络应用都会用到这些接口，象 aio、master 等模块；

 

3.1.5 aio/ : 主要包含网络异步操作的功能函数，该套函数库在处理高并发时有非常高的效率，而且提供了比基础API更为高级的调用方式，比使用象 libevent 之类的函数库更为简单，而且是线程安全的；

 

3.1.6 msg/ : 主要包含了基于线程的消息事件及基于网络的消息事件功能；

 

3.1.7 thread/ : 主要是封装了各个OS平台下的基础线程API，使对外接口保持一致性，消除了平台的差异性，同时还提供了半驻留线程池的函数库，以及对于线程局部变量的扩展；

 

3.1.8 db/ : 主要是一些与数据库有关的功能库，定义了一个通用的数据库连接池的框架（并且实现了mysql的连接池实例）；一个简单的内存数据库（由哈希表、链表、平衡二叉树组合而成）；ZDB数据存储引擎，这是一个高效的基于数字键的存储引擎；

 

3.1.9 proctl/ : win32 平台下父子进程控制功能库；

 

3.1.10 code/ : 常见编码函数库，包括 base64编解码、URL编解码以及一些汉字字符集编码等；

 

3.1.11 unit_test/ : 包含有关进行 C 语言单元测试的功能库；

 

3.1.12 xml/：是一个流式的 xml 解析器及构造器，可以支持阻塞及阻塞式网络通信；

 

3.1.13 json/：是一个流式的 json 解析器及构造器，可以支持阻塞及阻塞式网络通信；

 

3.1.14 master/: 是在 UNIX 环境下支持多种服务器模式的服务器框架，目前主要支持多进程模式、多进程多线程模式、多进程非阻塞模式以及多进程触发器模式；

 

四、acl 是如何跨平台的？是如何支持WIN32平台的？

 

　　在开发 acl 库时是完全基于 linux 平台的，后来公司要做一个P2P的项目，需要在WIN32下开发客户端程序，主要需要 acl 中的 HTTP 协议通信及协议解析部分，所以为了项目需要， acl 中的HTTP协议库及HTTP协议库所依赖的一些函数库被移植至WIN32下。由此，觉得 acl 应该有一个 win32 版本，所以本人花费数周N个晚上，将 acl 库中的几乎所有函数库都移植至WIN32下（当然目前仅有master服务器框架还没移植），后来还移植至FreeBSD、Solaris(x86)上（从LINUX移植至这些UNIX平台相对容易些），主要还是在移植至WIN32平台时比较费劲，因为WIN32的API与UNIX及POSIX的真是相差太远了，感觉一点就是在WIN32下直接用API编程还是挺辛苦的，有时本来一个非常简单的IO读写，在WIN32下却需要N个参数，并且微软的API 还有一个特点，就是很多API都有一个Ex（扩展）版，看来是它们的工程师在当初设计API时发现不够用又加进去的。

　　另外，微软的编译器版本比较多，有VC6，VC2002，VC2003，VC2005，VC2008，现在还有VC2010，各个编译器之间还有一些差别，要想完全支持这些编译器工作量是巨大的，所以acl 目前可以用 VC6, VC2003, VC2008 编译，说起仅支持这些编译器还是有原因的，VC6做为一个老牌的编译器，存在的历史时期比较久，自 Borland 的BC被VC打败后，微软就在VC编译器无所作为了，N年未大改过VC6，说实在话，这个VC6也真是够难用的（当然现在还有许多人在用它），后来微软终于出VC2002，算是VC6的一个大版本升级，终于变得“比较”好用了，不过VC2002似乎存在不少BUGS，所以微软又推出了VC2003，这个版本本人觉得还是很不错的，可以说是VC6的终极版，因为VC2005后，微软在VC编译器的改动就比较大了，显著一点就是比较浪费系统资源了，对于象我这样用惯 vi 编辑程序的程序员，机器配置并不需要太高，而用VC2005时明显机器的CPU及内存不够用的，本人感觉 VC6, VC2002,VC2003　属于一个系列的，标准C库变动不是特别大，但到了VC2005后就变动比较多了，比如在VC2003时一般用 snprintf 就可以了，但用VC2008时，你会发现微软“自作聪明”地提示你应该用 snprintf_s ，而且多了几个参数，为了支持VC2008，acl库里还是做了不少改动。但本人还是比较偏爱VC2003，它仅不会象VC2005/VC2008那样费资源，又比VC6好用，而且没有VC2002那么多BUGS，所以 acl 库在WIN32的主推编译器是VC2003:)。

 

五、acl 从哪些开源软件中汲取了经验？

　　首先得感谢 Postfix(2002-2005本人在方标以此作为方标邮件系统的MTA模块), 里面良好的框架设计及编码风格是 acl 始终追求的；squid(2005-2007年本人在和讯改造SQUID以适应和讯的网络访问需求)/nginx，这两款HTTP代理加速软件在HTTP 协议处理方面给本人了很多启示；ircd 是一个比较“古老”的聊天服务器(2000-2002年本人在263做的263  web聊天室的后台服务器就是基于 ircd)，也是本人最早接触的服务器程序，而且同 squid/nginx 一样是非阻塞通讯模式。

 

acl 下载