openssl之BIO系列之23

MD类型BIO

—根据openssldoc\crypto\bio_f_md.pod翻译和自己的理解写成

(作者:DragonKing,Mail:wzhah@263.net,发布于:之o

penssl专业论坛)

该类型为过滤(filter)类型BIO,其定义如下(openssl\bio.h,openssl\evp.h)

BIO_METHOD*BIO_f_md(void);

intBIO_set_md(BIO*b,EVP_MD*md);

intBIO_get_md(BIO*b,EVP_MD**mdp);

intBIO_get_md_ctx(BIO*b,EVP_MD_CTX**mdcp);

跟Cipher类型一样,该类型的一些定义和实现文件是在evp\bio_md.c里面,而不是

在bio目录下。大家要看源文件,请参看这个文件。

【BIO_f_md】

该函数返回一个MD类型的BIO_METHOD结构,其定义如下:

staticBIO_METHODmethods_md=

{

BIO_TYPE_MD,"messagedigest",

md_write,

md_read,

NULL,/*md_puts,*/

md_gets,

md_ctrl,

md_new,

md_free,

md_callback_ctrl,

};

MD类型BIO对通过它的任何数据都进行摘要操作(digest),事实上,该类型BIO封装

了EVP_DigestInit、EVP_DigestUpdate和EVP_DigestFinal三个函数的功能和行为。该类

型BIO是完全对称的,也就是说,不管是读数据(BIO_read)还是写数据(BIO_write),

都进行相同的摘要操作。

BIO_gets函数执行的时候,如果给定的size参数足够大,可以完成摘要(digest)

计算,那么就会返回摘要值。BIO_puts函数是不支持的,如果需要支持该函数,可以在

前面附加一个buffer类型的BIO。

BIO_reset函数重新初始化一个摘要类型的BIO,事实上,它是简单重新调用了EVP_

DigestInit函数进行初始化。

注意,在从一个摘要BIO里面读取完摘要信息之后,在重新使用该BIO之前,必须调

用BIO_reset或BIO_set_md重新初始化该BIO才行。

【BIO_set_md】

该函数是一个BIO_ctrl函数的宏定义函数,它使用参数md设置给定BIO的摘要算法。

该函数必须在执行读写操作之前调用,用来初始化一个摘要类型的BIO。调用成功返回1

,否则返回0。

【BIO_get_md】

该函数也是BIO_ctrl函数一个宏定义。它返回BIO摘要方法的指针到mdp参数里面。

调用成功返回1,否则返回0。

【BIO_get_md_ctx】

该函数返回摘要BIO的方法结构到mdcp参数里面。该结构可以作为参数使用在EVP_D

igestFinal、EVP_SignFinal和EVP_VerifyFinal函数里,这增加了灵活性。因为该函数

返回的结构是一个BIO内部的结构,所以对该结构的任何改变操作都会影响到相应的BIO

,,并且如果该BIO释放了,该结构指针也就无效了。调用成功返回1,否则返回0。

【例子】

1.下列的例子创建一个包含SHA1和MD5类型摘要BIO的BIO链,并将数据"HelloWorl

d"通过它们进行摘要操作。

BIO*bio,*mdtmp;

charmessage[]="HelloWorld";

bio=BIO_new(BIO_s_null());

mdtmp=BIO_new(BIO_f_md());

BIO_set_md(mdtmp,EVP_sha1());

//使用BIO_push在BIO链前面增加一个sink类型的BIO,作为BIO链开始的标志

bio=BIO_push(mdtmp,bio);

mdtmp=BIO_new(BIO_f_md());

BIO_set_md(mdtmp,EVP_md5());

bio=BIO_push(mdtmp,bio);

/*注意,现在mdtmp变量已经没有用了*/

BIO_write(bio,message,strlen(message));//因为最后一个BIO是null型的BIO

,所以数据实际上已经自动被丢弃了。

2.下面的例子演示了从摘要类型BIO读数据的过程:

BIO*bio,*mdtmp;

charbuf[1024];

intrdlen;

bio=BIO_new_file(file,"rb");

mdtmp=BIO_new(BIO_f_md());

BIO_set_md(mdtmp,EVP_sha1());

bio=BIO_push(mdtmp,bio);

mdtmp=BIO_new(BIO_f_md());

BIO_set_md(mdtmp,EVP_md5());

bio=BIO_push(mdtmp,bio);

do{

rdlen=BIO_read(bio,buf,sizeof(buf));

/*可以在这里面加入处理数据的代码*/

}while(rdlen>0);

3.下面的例子从一个BIO链中读取摘要数据并输出。可以跟上面的例子一起使用。

BIO*mdtmp;

unsignedcharmdbuf[EVP_MAX_MD_SIZE];

intmdlen;

inti;

mdtmp=bio;/*这里假设BIO已经设置好了*/

do{

EVP_MD*md;

mdtmp=BIO_find_type(mdtmp,BIO_TYPE_MD);

if(!mdtmp)break;

BIO_get_md(mdtmp,&md);

printf("%sdigest",OBJ_nid2sn(EVP_MD_type(md)));

mdlen=BIO_gets(mdtmp,mdbuf,EVP_MAX_MD_SIZE);

for(i=0;i<mdlen;i++)printf(":%02X",mdbuf[i]);

printf("\n");

mdtmp=BIO_next(mdtmp);

}while(mdtmp);

BIO_free_all(bio);

鸟儿爱美,不仅需要羽毛之美,还需要鸣声婉转之美;

openssl之BIO系列之23

相关文章:

你感兴趣的文章:

标签云: