2017-07-23 15:47:13 +08:00
## acl库使用FAQ
2017-07-23 14:36:29 +08:00
2017-07-23 18:48:51 +08:00
* [一、基础问题 ](#一基础问题 )
* [1、acl 库是啥、主要包含哪些功能？ ](#1acl-库是啥主要包含哪些功能 )
* [2、acl 库支持哪些平台？ ](#2acl-库支持哪些平台 )
* [3、acl 库主要包含几个库？ ](#3acl-库主要包含几个库 )
* [4、acl 库有哪些外部依赖库？ ](#4acl-库有哪些外部依赖库 )
* [5、没有这些第三方库 acl 能否使用？ ](#5没有这些第三方库-acl-能否使用 )
* [6、acl 库的源码下载位置在哪儿？ ](#6acl-库的源码下载位置在哪儿 )
* [二、编译&使用问题 ](#二编译使用问题 )
* [1、acl 库的编译过程？ ](#1acl-库的编译过程 )
* [2、Linux 平台下库的编译顺序问题？ ](#2linux-平台下库的编译顺序问题 )
* [3、Unix/Linux 平台下编译 acl 库时的编译选项是什么 ](#3unixlinux-平台下编译-acl-库时的编译选项是什么 )
* [4、请给出 Linux 平台下最简单的一个 Makefile？ ](#4请给出-linux-平台下最简单的一个-makefile )
2017-07-23 20:21:30 +08:00
* [5、Linux 平台下找不到 libz.a 库怎么办？ ](#5linux-平台下找不到-libza-库怎么办 )
2017-07-23 18:48:51 +08:00
* [6、Linux 平台下 acl 库能打包成一个库吗？ ](#6linux-平台下-acl-库能打包成一个库吗 )
* [7、Linux 平台下如何使用 ssl 功能？ ](#7linux-平台下如何使用-ssl-功能 )
* [8、Linux 下如何使用 mysql 功能？ ](#8linux-下如何使用-mysql-功能 )
* [三、各个功能模块的使用问题 ](#三各个功能模块的使用问题 )
2017-07-23 19:00:50 +08:00
* [（一）、网络通信 ](#一网络通信 )
2017-07-23 18:55:26 +08:00
* [（ ） #二http-模块 )
* [1. acl HTTP 服务器是否支持断点下载功能？ ](#1-acl-http-服务器是否支持断点下载功能 )
* [2. acl HTTP 服务器是否支持文件上传功能？ ](#2-acl-http-服务器是否支持文件上传功能 )
2017-07-23 18:59:32 +08:00
* [3. acl HTTP 模块是否支持服务器/客户端两种模式？ ](#3-acl-http-模块是否支持服务器客户端两种模式 )
2017-07-23 18:55:26 +08:00
* [4. acl HTTP 模块是否支持 websocket 通信协议？ ](#4-acl-http-模块是否支持-websocket-通信协议 )
* [5. acl HTTP 模块是否支持 session? ](#5-acl-http-模块是否支持-session )
2017-07-23 19:00:50 +08:00
* [（ ） #三redis-模块 )
2017-07-23 18:55:26 +08:00
* [1. acl redis 库是否支持集群功能？ ](#1-acl-redis-库是否支持集群功能 )
* [2. acl redis 库是如何划分的？ ](#2-acl-redis-库是如何划分的 )
* [3. acl redis 库中的哪些类对象操作是线程安全的？ ](#3-acl-redis-库中的哪些类对象操作是线程安全的 )
* [4. acl redis 客户库当连接断开时是否会重连？ ](#4-acl-redis-客户库当连接断开时是否会重连 )
* [（四）、协程模块 ](#四协程模块 )
* [1. 协程里面的非阻塞是什么原理的？ ](#1-协程里面的非阻塞是什么原理的 )
* [2. acl 协程库是否支持多线程？ ](#2-acl-协程库是否支持多线程 )
* [3. acl 协程库如何支持多核 CPU？ ](#3-acl-协程库如何支持多核-cpu )
* [4. acl 协程里针对 mysql 客户端库的协程化是否修改了 mysql 库的源码？ ](#4-acl-协程里针对-mysql-客户端库的协程化是否修改了-mysql-库的源码 )
* [5. acl 协程库支持域名解析功能吗？ ](#5-acl-协程库支持域名解析功能吗 )
* [6. acl 协程库的系统 errno 号如何处理？ ](#6-acl-协程库的系统-errno-号如何处理 )
* [7. 如果启动的协程过多，会不会对于后端例如 mysql 之类服务造成并发压力？如何避免？ ](#7-如果启动的协程过多会不会对于后端例如-mysql-之类服务造成并发压力如何避免 )
* [（五）、服务器模块 ](#五服务器模块 )
* [1. 有几种服务器编程模型？均有何特点？ ](#1-有几种服务器编程模型均有何特点 )
* [2. acl_master 的作用是什么？支持哪些平台？ ](#2-acl_master-的作用是什么支持哪些平台 )
* [3. 没有 acl_master 控制管理，服务子进程是否可以单独运行？ ](#3-没有-acl_master-控制管理服务子进程是否可以单独运行 )
2017-07-23 20:29:48 +08:00
* [4. 手工模式下运行时遇到“idle timeout -- exiting, idle”怎么办？ ](#4-手工模式下运行时遇到idle-timeout--exiting-idle怎么办 )
2017-07-23 18:59:32 +08:00
* [5. acl_master 控制模式下，服务子进程如何预启动多个进程？ ](#5-acl_master-控制模式下服务子进程如何预启动多个进程 )
* [6. acl_master 控制模式下，如何只监听内网地址？ ](#6-acl_master-控制模式下如何只监听内网地址 )
2017-07-23 18:55:26 +08:00
* [（六）、邮件&mime模块 ](#六邮件mime模块 )
2017-07-23 18:48:51 +08:00
2017-07-23 15:47:13 +08:00
### 一、基础问题
2017-07-23 14:36:29 +08:00
### 1、acl 库是啥、主要包含哪些功能？
acl 工程是一个跨平台（ ， ， ， ， ） ， ， ， ， ， （ ： ） ， ：
### 2、acl 库支持哪些平台？
目前主要支持 Linux/Windows/Macos/Freebsd/Solaris(x86)。
### 3、acl 库主要包含几个库？
主要包括： （ ） （ ） （ （ ） （
### 4、acl 库有哪些外部依赖库？
lib_acl/lib_protocol/lib_fiber 仅依赖系统基础库； ， ） ；
### 5、没有这些第三方库 acl 能否使用？
可以。默认情况下，没有这些第三方库编译和使用 acl 库是没有问题的，只是不能使用 mysql/sqlite/ssl/protobuf 功能。
### 6、acl 库的源码下载位置在哪儿？
- github：
- oschina: https://git.oschina.net/acl-dev/acl/
- sourceforge：
2017-07-23 15:47:13 +08:00
### 二、编译&使用问题
2017-07-23 14:36:29 +08:00
### 1、acl 库的编译过程？
acl 库的编译过程请参考：[acl 的编译与使用](http://zsxxsz.iteye.com/blog/1506554) 博客。
### 2、Linux 平台下库的编译顺序问题？
lib_acl 库是 acl 库中的基础库， ， ： ， ， ，
### 3、Unix/Linux 平台下编译 acl 库时的编译选项是什么？
在 Unix/Linux 平台下编译 acl 库时需要指明 gcc 的编译选项，
- Linux 平台：-DLINUX2
- MacOS 平台：-DMACOSX
- FreeBSD 平台：-DFREEBSD
- Solaris(x86) 平台：-DSUNOS5
### 4、请给出 Linux 平台下最简单的一个 Makefile？
下面是使用 acl 的三个库的最简单的编译选项（因为排版问题，当拷贝下面内容至 Makefile 时，需要注意将每行前空格手工转成 TAB 键）：
~~~
fiber: main.o
g++ -o fiber main.o \
-L./lib_acl_cpp/lib -l_acl_cpp \
-L./lib_protocol/lib -l_protocol \
-L./lib_acl/lib -l_acl \
-lz -lpthread -ldl
main.o: main.cpp
g++ -O3 -Wall -c main.cpp -DLINUX2 \
-I./lib_acl/include \
-I./lib_acl_cpp/include
~~~
2017-07-23 20:19:23 +08:00
### 5、Linux 平台下找不到 libz.a 库怎么办？
2017-07-23 14:36:29 +08:00
一般 Unix/Linux 平台下系统会自带 libz.a 或 libz.so 压缩库，如果找不到该库，则可以在线安装或采用编译安装 zlib 库，针对 Centos 和 Ubuntu 可分别通过以下方式在线安装（均需切换至 root 身份）：
- Centos：
- Ubuntu：
### 6、Linux 平台下 acl 库能打包成一个库吗？
可以。在 acl 目录下运行： ，
### 7、Linux 平台下如何使用 ssl 功能？
如果使用上面统一的 acl 库，则可以在 acl 根目录下编译时运行： ； ： ， ， ， ： ， ； ， ：
### 8、Linux 下如何使用 mysql 功能？
lib_acl_cpp 库是以动态加载方式加载 mysql 动态库的，所以在编译 lib_acl_cpp 时，
2017-07-23 15:47:13 +08:00
### 三、各个功能模块的使用问题
2017-07-23 14:36:29 +08:00
### （一）、网络通信
### （ ）
#### 1. acl HTTP 服务器是否支持断点下载功能？
支持。acl HTTP 模块支持断点续传功能， ：
#### 2. acl HTTP 服务器是否支持文件上传功能？
支持。参考示例：
2017-07-23 18:55:26 +08:00
#### 3. acl HTTP 模块是否支持服务器/客户端两种模式？
2017-07-23 14:36:29 +08:00
支持。目前 acl 的 HTTP 协议模块同时支持客户端及服务端模式，即你既可以使用 acl HTTP 编写客户端程序，又可以编写服务器程序，其中 acl 中的 http_request/http_request_pool/http_request_manager 类用来编写客户端程序，
2017-07-23 18:55:26 +08:00
#### 4. acl HTTP 模块是否支持 websocket 通信协议？
2017-07-23 14:36:29 +08:00
支持。可以参考示例：
2017-07-23 18:55:26 +08:00
#### 5. acl HTTP 模块是否支持 session?
2017-07-23 14:36:29 +08:00
支持。acl HTTP 模块当用在服务器编程时支持 session 存储，目前支持使用 memcached 或 redis 存储 session 数据。
### （ ）
#### 1. acl redis 库是否支持集群功能？
答案： ，
#### 2. acl redis 库是如何划分的？
acl redis 客户端库主要分为两类： ， ： ， ； ， ， ，
#### 3. acl redis 库中的哪些类对象操作是线程安全的？
acl redis 库中的所有命令类对象及 redis_client 单连接类对象不能同时被多个线程使用（就象 std::string 一样不能跨线程使用） ； ，
#### 4. acl redis 客户库当连接断开时是否会重连？
acl redis 库中的连接类中： ， ，
### （四）、协程模块
2017-07-23 18:48:51 +08:00
#### 1. 协程里面的非阻塞是什么原理的？
比如我现在需要访问数据库， ， ， ？
2017-07-23 14:36:29 +08:00
协程方式在底层将系统的 IO API（ ， ，
#### 2. acl 协程库是否支持多线程？
acl 协程库支持多线程方式，只是支持的方式与 go 语言有所不同。用户可以创建多个线程，每个线程一个协程调度器，线程之间的协程调度是相互隔离的，正如多进程与多线程之间的关系一样（每个进程内可以启动多个线程，但进程之间的线程的调度过程是隔离的），在每个线程内部可以创建大量 acl 协程，每个协程均由其所属的线程内的协程调度器调度运行。
#### 3. acl 协程库如何支持多核 CPU？
正如 2） ， ，
#### 4. acl 协程里针对 mysql 客户端库的协程化是否修改了 mysql 库的源码？
没有。mysql 客户端库使用的系统 IO API 为 read/write/poll， ，
#### 5. acl 协程库支持域名解析功能吗？
支持。很多 C/C++ 实现的协程库并未实现 gethostbyname(_r) 函数， ， ，
协程库基于此功能模块 HOOK 了系统的 gethostbyname(_r) API 而无须借助第三方函数库或起单独的线程完成域名解析。
#### 6. acl 协程库的系统 errno 号如何处理？
acl 协程库实现了协程安全的 errno 号，正如之前使用多线程编程时 errno 可以与每个线程绑定一样，在 acl 协程库里 errno 也是与每个 acl 协程进行绑定的。因此，当你调用 strerror(errno) 时也是协程安全的。
#### 7. 如果启动的协程过多，会不会对于后端例如 mysql 之类服务造成并发压力？如何避免？
当启动用协程较多且都需要 mysql 操作时的确会造成 mysql 服务器的并发压力。为避免此并发压力，
### （五）、服务器模块
#### 1. 有几种服务器编程模型？均有何特点？
目前 acl 库中提供：
__进程池模型：
__线程池模型：
__非阻塞模型：
__协程模型：
__UDP通信模型：
以上的服务模型均可启动多个进程，通过配置文件的配置项来决定启动进程的数量。
#### 2. acl_master 的作用是什么？支持哪些平台？
acl_master 为由以上各个服务器编写的服务进程的控制管理程序， acl_master
启动、停止各个服务子进程， ， ；
目前 acl_master 进程仅支持 LINUX/MACOS/FREEBSD/SOLARIS(X86）
#### 3. 没有 acl_master 控制管理，服务子进程是否可以单独运行？
可以。在没有 acl_master 的情况下，由以上各个服务模型编写的服务程序可以通过手工方式启动。启动方式一般为：./xxxx alone xxxx.cf，
2017-07-23 20:29:48 +08:00
#### 4. 手工模式下运行时遇到"idle timeout -- exiting, idle"怎么办？
2017-07-23 14:36:29 +08:00
因为 acl 的服务器编程模型均支持半驻留方式（即运行空闲一段时间或处理连接次数达到设定值后会自动退出，这样的好处是：可以定期通过进程退出释放可能存在的资源泄露，另一方面便于用户在开发时通过 valgrind 进行内存检查），如果让进程不退出，可以在 alone 模式下给服务程序传递启动配置文件，如启动方式为：./xxxx alone xxxx.cf（
** 程池模型：** 将配置项 single_use_limit 和 single_idle_limit 设为 0；
** 线程池模型：** 将配置项 ioctl_use_limit 和 ioctl_idle_limit 设为 0；
** 非阻塞模型：** 将配置项 aio_use_limit 和 aio_idle_limit 设为 0；
** 协程模型：** 将配置项 fiber_use_limit 和 fiber_idle_limit 设为 0；
** UDP通信模型： ；
** 触发器模型：** 将配置项 trigger_use_limit 设为。
2017-07-23 18:59:32 +08:00
#### 5. acl_master 控制模式下，服务子进程如何预启动多个进程？
2017-07-23 14:36:29 +08:00
需要修改每个服务子进程的配置文件， ： ， ， （ ）
2017-07-23 18:59:32 +08:00
#### 6. acl_master 控制模式下，如何只监听内网地址？
2017-07-23 14:36:29 +08:00
在 acl_master 模式下，可以将 master_service 配置项支持模糊匹配方式，即可以将监听地址写成 192.168.*.*:xxx 或 10.0.*.*:xxx 方式，这样 acl_master 会自动扫描服务器所有的网卡地址，但只监听服务匹配条件的内网地址，这样为统一部署提供方便。
### （六）、邮件&mime模块
。。。
- 微博：
- qq 群：
