文件描写叙述符(fd)类型BIO
---依据openssl doccryptoio_s_fd.pod翻译和自己的理解写成
(作者:DragonKing Mailwzhah@263.net 公布于:httpgdwzh.126.com之openssl专
业论坛)
文件描写叙述符类型BIO也是一个source/sink型的BIO,它定义了下面一些类型的函数(
opensslio.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 ");
BIO_free(out);