2021SC@SDUSC openssl-gpu 抽象IO

2021SC@SDUSC
7 抽象IO
7.1 openssl 抽象 IO

openssl 抽象 IO(I/O abstraction，即 BIO)是 openssl 对于 io 类型的抽象封装,
包括:内存、 文件、日志、标准输入输出、socket(TCP/UDP)、加/解密、摘要和 ssl 通道等。
Openssl BIO 通过回调函数为用户隐藏了底层实现细节，所有类型的 bio 的调用大体上是类似的。
Bio 中的数据能从一个 BIO 传送到另外一个 BIO 或者是应用程序。

其实包含了很多种接口，用通用的函数接口，主要控制在BIO_METHOD中的不同实现函数控制，
包括6种filter型和8种source/sink型。

source/sink类型的BIO是数据源，
例如，sokect BIO 和 文件BIO。
而filter BIO就是把数据从一个BIO转换到另外一个BIO或应用接口,
在转换过程中,些数据可以不修改（如信息摘要BIO)，也可以进行转换.
例如在加密BIO中，如果写操作，数据就会被加密，如果是读操作，数据就会被解密。

BIO是封装了许多类型I/O接口细节的一种应用接口,
可以和SSL连接、 非加密的网络连接以及文件IO进行透明的连接。
BIO可以连接在一起成为一个BIO链（单个的BIO就是一个环节的BIO链的特例）,

如下是BIO的结构定义，可以看到它有上下环节。

一个BIO链通常包括一个source BIO和一个或多个filter BIO，数据从第一个BIO读出或写入,
然后经过一系列BIO变化到输出（通常是一个source/sink BIO）。

BIO目录文件的简要说明:

bio.h： 主定义的头文件，包括了很多通用的宏的定义。
bio_lib.c: 主要的BIO操作定义文件，是比较上层的函数了。
bss_*系列：是soruce/sink型BIO具体的操作实现文件
bf_*系列： 是filter型BIO具体的操作实现文件
bio_err.c: 是错误信息处理文件
bio_cb.c： 是callback函数的相关文件
b_print.c: 是信息输出的处理函数文件
b_socket.c: 是Socket连接的一些相关信息处理文件
b_dump.c: 是对内存内容的存储操作处理

7.2 数据结构

BIO 数据结构主要有 2 个，在 crypto/bio.h 中定义如下:

    BIO_METHOD

typedef struct bio_method_st {
   
        int type;
        const char *name;
        int (*bwrite)(BIO *, const char *, int);
        int (*bread)(BIO *, char *, int);
        int (*bputs)(BIO *, const char *);
        int (*bgets)(BIO *, char *, int);
        long (*ctrl)(BIO *, int, long, void *);
        int  (*create)(BIO *);
        int  (*destroy)(BIO *);
        long (*callback_ctrl)(BIO *, int, bio_info_cb *);
} BIO_METHOD;

该结构定义了 IO 操作的各种回调函数，根据需要，具体的 bio 类型必须实现其中的一种或多种回调函数，各项意义如下:

type: 具体 BIO 类型;
name: 具体 BIO 的名字;
bwrite: 具体 BIO 写操作回调函数;
bread: 具体 BIO 读操作回调函数;
bputs: 具体 BIO 中写入字符串回调函数;
bgets: 具体 BIO 中读取字符串函数;
ctrl: 具体 BIO 的控制回调函数;
create: 生成具体 BIO 回调函数;
destroy: 销毁具体 BIO 回调函数;
callback_ctrl: 具体 BIO 控制回调函数,与 ctrl 回调函数不一样,
该函数可由调用者(而不是实现者)来实现,然后通过
BIO_set_callback 等函数来设置。

    BIO

truct bio_st {
   
    BIO_METHOD *method;
    /* bio, mode, argp, argi, argl, ret */
    long (*callback)(struct bio_st *,int,const char *,int, long,long);
    char *cb_arg;   /* first argument for the callback */
    int  init;
    int  shutdown;
    int  flags;      /* extra storage */
    int  retry_reason;
    int  num;
    void *ptr;
    structbio_st *next_bio;   /*usedbyfilterBIOs*/
    struct bio_st *prev_bio; /* used by filter BIOs */
    int references;
    nsigned long  num_read;
    unsigned long num_write;
    CRYPTO_EX_DATA ex_data;
};

/*
主要项含义:

init: 具体句柄初始化标记，初始化后为1。
比如:文件 BIO 中,通过 BIO_set_fp 关联一个文件指针时，该标记则置 1 ;
socket BIO中,通过 BIO_set_fd 关联一个链接时,设置该标记为 1。

shutdown: BIO 关闭标记，当该值不为 0 时，释放资源; 该值可以通过控制函 数来设置。

flags: 有些 BIO 实现需要它来控制各个函数的行为。
比如文件 BIO 默认该值为 BIO_FLAGS_UPLINK，
这时文件读操作调用UP_fread 函数而不是调用fread 函数。

retry_reason: 重试原因,主要用在 socket 和 ssl BIO 的异步阻塞。
比如 socket bio 中，遇到 WSAEWOULDBLOCK 错误时，
openssl 告诉用户的操作需要重试。

num: 该值因具体 BIO 而异，比如 socket BIO 中 num 用来存放链接字。

ptr: 指针,体 bio 有不同含义。比如:
文件 BIO 中它用来存放文件句柄;
mem BIO 中它用来存放内存地址;
connect BIO 中它用来存放 BIO_CONNECT 数据，
accept BIO 中它用来存放 BIO_ACCEPT 数据。

next_bio: 下一个 BIO 地址，BIO 数据可以从一个BIO传送到另一个BIO，
该值指明了下一个 BIO 的地址。

references: 被引用数量。
num_read: BIO 中已读取的字节数。
num_write: BIO 中已写入的字节数。
ex_data: 用于存放额外数据。
*/

typedef struct bio_st BIO;

struct bio_st
{
   
     BIO_METHOD *method; //BIO方法结构，是决定BIO类型和行为的重要参数,各种BIO的不同之处主要也正在于此项。

     long (*callback)(struct