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

文件描述符(fd)类型BIO
    
    ---根据openssl doc/crypto/bio_s_fd.pod翻译和自己的理解写成
    
    （作者：DragonKing [e-mail] 发布于：http://gdwzh.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);