openssl之BIO系列之6---BIO的IO操作函数

BIO的IO操作函数
    ---依据openssl doc/crypto/bio/bio_read.pod翻译和自己的理解写成
    
    （作者：DragonKing Mail:wzhah@263.net 公布于：http://gdwzh.126.com之openssl专业论坛）
    
    这些函数是BIO的基本读写操作函数，包含四个，他们的定义例如以下（openssl/bio.h）：
     int BIO_read(BIO *b, void *buf, int len);
     int BIO_gets(BIO *b,char *buf, int size);
     int BIO_write(BIO *b, const void *buf, int len);
     int BIO_puts(BIO *b,const char *buf);
    【BIO_read】
    从BIO接口中读出指定数量字节len的数据并存储到buf中。成功就返回真正读出的数据的长度，失败返回0或－1，假设该BIO没有实现本函数则返回－2。
    【BIO_gets】
    该函数从BIO中读取一行长度最大为size的数据。通常情况下，该函数会以最大长度限制读取一行数据，可是也有例外，比方digest型的BIO，该函数会计算并返回整个digest信息。

此外，有些BIO可能不支持这个函数。成功就返回真正读出的数据的长度，失败返回0或－1。假设该BIO没有实现本函数则返回－2。须要注意的时，假设对应的BIO不支持这个函数，那么对该函数的调用可能导致BIO链自己主动添加一个buffer型的BIO。

    【BIO_write】
    往BIO中写入长度为len的数据。成功就返回真正写入的数据的长度。失败返回0或－1，假设该BIO没有实现本函数则返回－2。

    【BIO_puts】
    往BIO中写入一个以NULL为结束符的字符串，成功就返回真正写入的数据的长度，失败返回0或－1，假设该BIO没有实现本函数则返回－2。
    
    须要注意的是。返回指为0或－1的时候并不一定就是发生了错误。在非堵塞型的source/sink型或其他一些特定类型的BIO中，这只代表眼下没有数据能够读取。须要稍后再进行该操作。
    有时候。你可能会使用了堵塞类型的sokect使用的一些系统调用技术（如select,poll,equivalent）来决定BIO中是否有有效的数据被read函数读取，但建议不要在堵塞型的接口中使用这些技术。由于这种情况下假设调用BIO_read就会导致在底层的IO中多次调用read函数。从而导致port堵塞。建议select（或equivalent）应该和非堵塞型的IO一起使用，可以在失败之后可以又一次读取该IO，而不是堵塞住了。
    关于BIO的IO操作为什么会失败以及怎么处理这些情况请參加BIO_should_retry()函数的说明文档。