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);