接受(accept)类型BIO
---依据openssl doc\crypto\bio_s_accept.pod翻译和自己的理解写成
(作者:DragonKing, Mail: wzhah@263.net ,公布于:http://gdwzh.126.com之o
penssl专业论坛)
接受(accept)类型的BIO跟连接(connect)类型BIO是相相应的,它封装了Socke
t的accept方法及其相关的一些操作,使得可以对不同的平台使用同一的函数进行操作。
其定义的相关函数例如以下(openssl\bio.h):
BIO_METHOD * BIO_s_accept(void);
#define BIO_set_accept_port(b,name) BIO_ctrl(b,BIO_C_SET_ACCEPT,0,(char
*)name)
#define BIO_get_accept_port(b) BIO_ptr_ctrl(b,BIO_C_GET_ACCEPT,0)
BIO *BIO_new_accept(char *host_port);
#define BIO_set_nbio_accept(b,n) BIO_ctrl(b,BIO_C_SET_ACCEPT,1,(n)?"a":
NULL)
#define BIO_set_accept_bios(b,bio) BIO_ctrl(b,BIO_C_SET_ACCEPT,2,(char
*)bio)
#define BIO_set_bind_mode(b,mode) BIO_ctrl(b,BIO_C_SET_BIND_MODE,mode,N
ULL)
#define BIO_get_bind_mode(b,mode) BIO_ctrl(b,BIO_C_GET_BIND_MODE,0,NULL
)
#define BIO_BIND_NORMAL 0
#define BIO_BIND_REUSEADDR_IF_UNUSED 1
#define BIO_BIND_REUSEADDR 2
#define BIO_do_accept(b) BIO_do_handshake(b)
【BIO_s_accept】
该函数返回一个接受(Accept)类型的BIO_METHOD结构,其定义例如以下:
static BIO_METHOD methods_acceptp=
{
BIO_TYPE_ACCEPT,
"socket accept",
acpt_write,
acpt_read,
acpt_puts,
NULL, /* connect_gets, */
acpt_ctrl,
acpt_new,
acpt_free,
NULL,
};
通过该结构我们能够一目了然的知道该方法支持什么I/O操作。在本类型中,BIO_g
ets的操作是不支持的。跟连接(connect)类型BIO一样,openssl也定义了一个维护接
受Socket信息的结构,在此我也不再具体介绍该结构,大家參考bss_acpt.c文件。
本类型的BIO对各种平台的TCP/IP的accept做了封装,所以在使用的时候就能够同一
的使用BIO的规则进行操作,而不用操心由于不同的平台带来程序改写或添加移植的工作
量,这也是BIO非常重要的一个目的。
BIO_read和BIO_write函数操作调用了底层平台连接的I/O相关操作,假设这时候没
有连接建立,port设置正确,那么该BIO就会等待连接的建立。其实。当一个连接建立
的时候,一个新的socket类型BIO就会被创建并附加到BIO链中。形成accept->socket的
BIO结构,所以这时候对初始化了的接受socket进行IO操作就会导致它处于等待连接建立
的状态。当一个接受类型的BIO在BIO链的末尾的时候,在处理I/O调用之前它会先等待一
个连接的建立。假设不是在末尾。那么它简单的把I/O调用传到下一个BIO。
假设接受(accept)类型BIO的关闭标志设置了,那么当BIO被释放的时候。该BIO链
上不论什么活动的连接和socket都会被关闭。
BIO_get_fd和BIO_set_fd能够用来取得和设置该连接的socket描写叙述符,具体情况參
看《BIO系列之12---描写叙述符(fd)类型BIO》。
【BIO_set_accept_port】
该函数使用字串名来设置接受端口。其形式为“host:port”,“host”是要使用的
接口,“port”是port。这两部分都能够为“*”。这时候表示能够使用随意接口和port
。
这里的port的字符串含义跟连接(connect)类型BIO里面定义的一样。能够为数字形
式的,能够使用getservbyname函数去匹配得到,还能够使用字符串的表。请參看连接型
BIO说明的相关部分。
【BIO_new_accept】
该函数将BIO_new和BIO_set_accept_port函数放在一个函数里面调用,创建一个新
的接受(accept)类型的BIO。
【BIO_set_nbio_accept】
该函数设置接受socket是否为堵塞模式(缺省)。假设參数n为0,为堵塞模式,n为
1则为非堵塞模式。
【BIO_set_accept_bios】
该函数用来设置一个BIO链。当接受到一个连接的时候。这个设置好的BIO链就会被
复制或附加到整个BIO链上来。有的时候这中处理方法是很好的,比方。假设每一个连接
都须要一个缓冲区或SSL类型的BIO。这时候使用本函数就省了非常多麻烦了。
须要注意的
是,在调用本函数后,这个设置的链上的BIO不能自己释放。在接受(accept)BIO被释
放后,它们会自己主动释放。
当该函数调用的时候,其设置的BIO链位于接受BIO和socket类型的BIO之间。即形成
:accept->otherbios->socket的新的BIO链。
【BIO_set_bind_mode和BIO_get_bind_mode】
这两个函数用来设置和取得眼下的绑定模式。假设设置为BIO_BIND_NORMAL(缺省)
,那么另外一个socket就不能绑定到同一个port。假设设置为BIO_BIND_REUSEADDR ,那
么另外的socket能够绑定到同一个port。假设设置为BIO_BIND_REUSEADDR_IF_UNUSED,
那么首先会尝试以BIO_BIND_NORMAL的模式绑定到port。假设失败了并且port没有使用,
那么就会使用BIO_BIND_REUSEADDR 模式绑定到port。
【BIO_do_accept】
该函数有两个功能,当它在接受(accept)BIO设置好之后第一被调用的时候,它会
创建一个接受socket并把它跟地址绑定;第二次被调用的时候,它会等待连接的到来。
【注意】
假设server端希望能够处理多个连接的情况(通常都是这种)。那么接受BIO必须
可以用来处理以后的连接。这时候可以这样做:
等待到一个连接后。调用
connection=BIO_pop(accept)
这样。cnnection会包括一个近期建立的连接的BIO,accept就再次成为一个独立的
BIO,能够用来处理其他连接了。假设没有其他连接建立,那么就能够使用BIO_free释放
该BIO。
当然,假设仅仅有一个连接须要处理。也能够使用连接BIO本身来进行I/O操作。可是
一般来说不推荐这样做。由于这时候该接受BIO依旧处于接受其他连接建立的状态。这可
以使用上述的方法解决。
【样例】
这个样例在4444port接受了两个连接。发送信息到每一个连接上然后释放他们。
BIO *abio, *cbio, *cbio2;
ERR_load_crypto_strings();
abio = BIO_new_accept("4444");
/* 首先调用BIO_accept启动接受BIO */
if(BIO_do_accept(abio) <= 0) {
fprintf(stderr, "Error setting up accept\n");
ERR_print_errors_fp(stderr);
exit(0);
}
/* 等待连接建立*/
if(BIO_do_accept(abio) <= 0) {
fprintf(stderr, "Error accepting connection\n");
ERR_print_errors_fp(stderr);
exit(0);
}
fprintf(stderr, "Connection 1 established\n");
/* 返回连接的BIO*/
cbio = BIO_pop(abio);
BIO_puts(cbio, "Connection 1: Sending out Data on initial connection\n"
);
fprintf(stderr, "Sent out data on connection 1\n");
/* 等待还有一个连接的建立 */
if(BIO_do_accept(abio) <= 0) {
fprintf(stderr, "Error accepting connection\n");
ERR_print_errors_fp(stderr);
exit(0);
}
fprintf(stderr, "Connection 2 established\n");
/* 关闭连接BIO。不再接受连接的建立 */
cbio2 = BIO_pop(abio);
BIO_free(abio);
BIO_puts(cbio2, "Connection 2: Sending out Data on second\n");
fprintf(stderr, "Sent out data on connection 2\n");
BIO_puts(cbio, "Connection 1: Second connection established\n");
/* 关闭这两个连接 */
BIO_free(cbio);
BIO_free(cbio2);