openssl之BIO系列之12---文件描写叙述符(fd)类型BIO

文件描写叙述符(fd)类型BIO

    ---依据openssl doc\crypto\bio_s_fd.pod翻译和自己的理解写成

    （作者：DragonKing Mailwzhah@263.net 公布于：httpgdwzh.126.com之openssl专

业论坛）

    文件描写叙述符类型BIO也是一个source/sink型的BIO,它定义了下面一些类型的函数（

openssl\bio.h）：

     BIO_METHOD * BIO_s_fd(void);

     #define BIO_set_fd(b,fd,c) BIO_int_ctrl(b,BIO_C_SET_FD,c,fd)

     #define BIO_get_fd(b,c) BIO_ctrl(b,BIO_C_GET_FD,0,(char *)c)

     BIO *BIO_new_fd(int fd, int close_flag);

    有一点须要说明的是，尽管存在bss_fd.c文件。可是关于fd类型的BIO的实现函数。

并不是真正在bss_fd.c里面，而是在bss_sock.c里面，bss_fd.c这是简单包括了bss_sock

.c文件，所以大家要找实现函数，应该到bss_sock.c里面找。

    【BIO_s_fd】

    该函数返回一个文件描写叙述符类型的BIO_METHOD结构，它封装了文件描写叙述符类型的一

些规则，如read()和write()函数等。fd类型的BIO_METHOD结构例如以下：

    static BIO_METHOD methods_fdp=

     {

     BIO_TYPE_FD,"file descriptor",

     fd_write,

     fd_read,

     fd_puts,

     NULL, /* fd_gets, */

     fd_ctrl,

     fd_new,

     fd_free,

     NULL,

     };

    可见。跟file类型BIO相比，它没有实现gets的方法。以下对一些相同的BIO操作函

数作些简单说明：

    BIO_read和BIO_write对底层的文件描写叙述符结构进行读写操作。

这两个函数的一些行

为取决于他们所在的平台的文件描写叙述符的读写函数的行为。假设底层的文件描写叙述符是非

堵塞型的，那么他们基本上是跟我们前面介绍过得BIO的IO操作函数一样的。请參看前面

的文章和资料。

socket是一类特殊的描写叙述符，不应该使用文件描写叙述符类型的BIO来封装它

。而应该使用专门的socke类型BIO，在以后我们会进行介绍。

    BIO_puts是支持的，可是BIO_gets在本类型描写叙述符中是不支持的。

    假设设置了关闭标志。那么当BIO被释放的时候底层的文件描写叙述符就会被关闭。

    BIO_reset调用lseek(fd,0,0)函数，使文件指针指向開始的位置。调用成功返回0，

失败返回－1。

    BIO_seek调用了lseek(fd,ofs,0)函数。设置文件指针的位置到从文件头偏移ofs的

位置，成功返回文件指针的位置，失败返回－1。

    BIO_tell返回眼下文件指针的位置。它事实上调用了lseek(fd,0,1)函数，失败返回－

1。

    【BIO_set_fd】

    该函数将BIO的底层文件描写叙述符设置为fd，关闭标志也同一时候做了设置，其含义与文件

类型BIO对应的含义一样。返回1。

    【BIO_get_fd】返回对应BIO的底层文件描写叙述符。存于參数c。只是。同一时候也作为返

回值返回。c应该为int *类型的指针。

假设BIO没有初始化。调用该函数将失败，返回－

1。

    【BIO_new_fd】

    创建并返回一个底层描写叙述符为fd，关闭标志为close_flag的文件描写叙述符类型的BIO。

事实上，该函数依次调用了BIO_s_fd、BIO_new和BIO_set_fd完毕了该功能。该函数假设调

用失败返回NULL。

    以下是一个简单的样例：

     BIO *out;

     out = BIO_new_fd(fileno(stdout), BIO_NOCLOSE);

     BIO_printf(out, "Hello World\n");

     BIO_free(out);