X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=doc%2Fcrypto%2FBIO_f_md.pod;h=e49b652a784711eaadf4ff0ec34f9ced410fcd24;hb=0501f02b060e45f2e2d275d779d864f3159f8ea9;hp=ebca9440654bc20c2e191417c8d108cf6890bc7b;hpb=1e4e5492966007268485920a56613b9c6893f237;p=oweals%2Fopenssl.git diff --git a/doc/crypto/BIO_f_md.pod b/doc/crypto/BIO_f_md.pod index ebca944065..e49b652a78 100644 --- a/doc/crypto/BIO_f_md.pod +++ b/doc/crypto/BIO_f_md.pod @@ -28,7 +28,7 @@ BIO_gets(), if its B parameter is large enough finishes the digest calculation and returns the digest value. BIO_puts() is not supported. -BIO_reset() reinitializes a digest BIO. +BIO_reset() reinitialises a digest BIO. BIO_set_md() sets the message digest of BIO B to B: this must be called to initialize a digest BIO before any data is @@ -58,6 +58,12 @@ If an application needs to call BIO_gets() or BIO_puts() through a chain containing digest BIOs then this can be done by prepending a buffering BIO. +Before OpenSSL 0.9.9 the call to BIO_get_md_ctx() would only work if the BIO +had been initialized for example by calling BIO_set_md() ). In OpenSSL +0.9.9 and later the context is always returned and the BIO is state is set +to initialized. This allows applications to initialize the context externally +if the standard calls such as BIO_set_md() are not sufficiently flexible. + =head1 RETURN VALUES BIO_f_md() returns the digest BIO method. @@ -127,7 +133,7 @@ outputs them. This could be used with the examples above. =head1 BUGS -The lack of support for BIO_puts() and the non standard behavior of +The lack of support for BIO_puts() and the non standard behaviour of BIO_gets() could be regarded as anomalous. It could be argued that BIO_gets() and BIO_puts() should be passed to the next BIO in the chain and digest the data passed through and that digests should be retrieved using a