X-Git-Url: https://git.openssl.org/?p=openssl.git;a=blobdiff_plain;f=doc%2Fcrypto%2FBIO_f_md.pod;h=2cc41f89d2fda1624b927844356ea31057189ffe;hp=ebca9440654bc20c2e191417c8d108cf6890bc7b;hb=687403fb2486eec0502ccb36689d3f57e0a173aa;hpb=1e4e5492966007268485920a56613b9c6893f237 diff --git a/doc/crypto/BIO_f_md.pod b/doc/crypto/BIO_f_md.pod index ebca944065..2cc41f89d2 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 1.0.0 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 +1.0.0 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