evt-tls 项目常见问题解决方案

evt-tls 项目常见问题解决方案

evt-tls The asynchronous TLS abstraction for OpenSSL 项目地址: https://gitcode.com/gh_mirrors/ev/evt-tls

1. 项目基础介绍和主要编程语言

项目名称： evt-tls

项目简介： evt-tls 是一个基于 OpenSSL 的异步 TLS 抽象层，它使用 BIO 对来提供基于回调的异步 API。这个库旨在轻松地与任何基于事件的网络库（如 libuv、libevent 和 libev）或其他希望将 OpenSSL 作为状态机使用的网络库集成。evt-tls 目前处于 alpha 阶段，还在不断开发中，目标是使其适用于生产环境。

主要编程语言： C

2. 新手在使用这个项目时需要特别注意的3个问题和详细解决步骤

问题一：如何初始化和配置 evt-tls？

问题描述： 新手在使用 evt-tls 时，可能会对如何初始化和配置这个库感到困惑。

解决步骤：

1. 安装 OpenSSL： 确保你的系统中已经安装了 OpenSSL 库。
2. 包含头文件： 在你的代码中包含 evt-tls 的头文件，通常是 #include "uv_tls.h"。
3. 创建和初始化 uv_loop： 使用 uv_loop_t *loop = uv_default_loop(); 来获取默认的事件循环。
4. 创建 uv_tls 对象： 使用 uv_tls_t *sclient = malloc(sizeof(*sclient)); 分配内存给 uv_tls 对象。
5. 初始化 uv_tls： 使用 uv_tls_init((evt_ctx_t*)server->data, tcp, sclient) 来初始化 uv_tls 对象。
6. 设置回调函数： 设置必要的回调函数，例如握手完成后的回调、读取数据的回调等。

问题二：如何处理 TLS 握手？

问题描述： 新手可能不清楚如何处理 TLS 握手过程。

解决步骤：

1. 设置握手回调： 在初始化 uv_tls 对象后，设置一个握手回调函数，例如 uv_tls_accept(sclient, on_uv_handshake)。
2. 编写握手回调函数： 在握手回调函数中，检查握手是否成功。如果成功，可以开始读取数据；如果失败，关闭连接。

   void on_uv_handshake(uv_tls_t *ut, int status) {
       if (0 == status) {
           uv_tls_read(ut, uv_rd_cb);
       } else {
           uv_tls_close(ut, (uv_tls_close_cb)free);
       }
   }
   

问题三：如何读写数据？

问题描述： 新手可能会对如何在 TLS 连接中发送和接收数据感到困惑。

解决步骤：

1. 读取数据： 设置读取数据的回调函数，例如 uv_tls_read(ut, uv_rd_cb)。
2. 编写读取回调函数： 在读取回调函数中，检查读取的结果。如果读取成功，可以通过回调函数处理数据。

   void uv_rd_cb(uv_tls_t *strm, ssize_t nrd, const uv_buf_t *bfr) {
       if (nrd <= 0) return;
       uv_tls_write(strm, (uv_buf_t*)bfr, on_write);
   }
   

3. 发送数据： 使用 uv_tls_write(strm, (uv_buf_t*)bfr, on_write) 发送数据，并设置写入完成后的回调函数。
4. 编写写入回调函数： 在写入回调函数中，可以根据需要处理写入完成后的逻辑。

   void on_write(uv_tls_t *tls, int status) {
       uv_tls_close(tls, (uv_tls_close_cb)free);
   }
   

evt-tls The asynchronous TLS abstraction for OpenSSL 项目地址: https://gitcode.com/gh_mirrors/ev/evt-tls