diff options
| author | djm <> | 2010-10-01 22:59:01 +0000 |
|---|---|---|
| committer | djm <> | 2010-10-01 22:59:01 +0000 |
| commit | 8922d4bc4a8b8893d72a48deb2cdf58215f98505 (patch) | |
| tree | 939b752540947d33507b3acc48d76a8bfb7c3dc3 /src/lib/libcrypto/doc/EVP_DigestInit.pod | |
| parent | 76262f7bf9262f965142b1b2b2105cb279c5c696 (diff) | |
| download | openbsd-8922d4bc4a8b8893d72a48deb2cdf58215f98505.tar.gz openbsd-8922d4bc4a8b8893d72a48deb2cdf58215f98505.tar.bz2 openbsd-8922d4bc4a8b8893d72a48deb2cdf58215f98505.zip | |
resolve conflicts, fix local changes
Diffstat (limited to 'src/lib/libcrypto/doc/EVP_DigestInit.pod')
| -rw-r--r-- | src/lib/libcrypto/doc/EVP_DigestInit.pod | 23 |
1 files changed, 13 insertions, 10 deletions
diff --git a/src/lib/libcrypto/doc/EVP_DigestInit.pod b/src/lib/libcrypto/doc/EVP_DigestInit.pod index 236e2fa8d1..37a751b1c5 100644 --- a/src/lib/libcrypto/doc/EVP_DigestInit.pod +++ b/src/lib/libcrypto/doc/EVP_DigestInit.pod | |||
| @@ -64,9 +64,9 @@ EVP digest routines | |||
| 64 | 64 | ||
| 65 | The EVP digest routines are a high level interface to message digests. | 65 | The EVP digest routines are a high level interface to message digests. |
| 66 | 66 | ||
| 67 | EVP_MD_CTX_init() initializes digest contet B<ctx>. | 67 | EVP_MD_CTX_init() initializes digest context B<ctx>. |
| 68 | 68 | ||
| 69 | EVP_MD_CTX_create() allocates, initializes and returns a digest contet. | 69 | EVP_MD_CTX_create() allocates, initializes and returns a digest context. |
| 70 | 70 | ||
| 71 | EVP_DigestInit_ex() sets up digest context B<ctx> to use a digest | 71 | EVP_DigestInit_ex() sets up digest context B<ctx> to use a digest |
| 72 | B<type> from ENGINE B<impl>. B<ctx> must be initialized before calling this | 72 | B<type> from ENGINE B<impl>. B<ctx> must be initialized before calling this |
| @@ -102,7 +102,7 @@ the passed context B<ctx> does not have to be initialized, and it always | |||
| 102 | uses the default digest implementation. | 102 | uses the default digest implementation. |
| 103 | 103 | ||
| 104 | EVP_DigestFinal() is similar to EVP_DigestFinal_ex() except the digest | 104 | EVP_DigestFinal() is similar to EVP_DigestFinal_ex() except the digest |
| 105 | contet B<ctx> is automatically cleaned up. | 105 | context B<ctx> is automatically cleaned up. |
| 106 | 106 | ||
| 107 | EVP_MD_CTX_copy() is similar to EVP_MD_CTX_copy_ex() except the destination | 107 | EVP_MD_CTX_copy() is similar to EVP_MD_CTX_copy_ex() except the destination |
| 108 | B<out> does not have to be initialized. | 108 | B<out> does not have to be initialized. |
| @@ -132,7 +132,9 @@ return B<EVP_MD> structures for the MD2, MD5, SHA, SHA1, MDC2 and RIPEMD160 dige | |||
| 132 | algorithms respectively. The associated signature algorithm is RSA in each case. | 132 | algorithms respectively. The associated signature algorithm is RSA in each case. |
| 133 | 133 | ||
| 134 | EVP_dss() and EVP_dss1() return B<EVP_MD> structures for SHA and SHA1 digest | 134 | EVP_dss() and EVP_dss1() return B<EVP_MD> structures for SHA and SHA1 digest |
| 135 | algorithms but using DSS (DSA) for the signature algorithm. | 135 | algorithms but using DSS (DSA) for the signature algorithm. Note: there is |
| 136 | no need to use these pseudo-digests in OpenSSL 1.0.0 and later, they are | ||
| 137 | however retained for compatibility. | ||
| 136 | 138 | ||
| 137 | EVP_md_null() is a "null" message digest that does nothing: i.e. the hash it | 139 | EVP_md_null() is a "null" message digest that does nothing: i.e. the hash it |
| 138 | returns is of zero length. | 140 | returns is of zero length. |
| @@ -228,12 +230,6 @@ digest name passed on the command line. | |||
| 228 | printf("\n"); | 230 | printf("\n"); |
| 229 | } | 231 | } |
| 230 | 232 | ||
| 231 | =head1 BUGS | ||
| 232 | |||
| 233 | The link between digests and signing algorithms results in a situation where | ||
| 234 | EVP_sha1() must be used with RSA and EVP_dss1() must be used with DSS | ||
| 235 | even though they are identical digests. | ||
| 236 | |||
| 237 | =head1 SEE ALSO | 233 | =head1 SEE ALSO |
| 238 | 234 | ||
| 239 | L<evp(3)|evp(3)>, L<HMAC(3)|HMAC(3)>, L<MD2(3)|MD2(3)>, | 235 | L<evp(3)|evp(3)>, L<HMAC(3)|HMAC(3)>, L<MD2(3)|MD2(3)>, |
| @@ -253,4 +249,11 @@ EVP_md_null(), EVP_md2(), EVP_md5(), EVP_sha(), EVP_sha1(), | |||
| 253 | EVP_dss(), EVP_dss1(), EVP_mdc2() and EVP_ripemd160() were | 249 | EVP_dss(), EVP_dss1(), EVP_mdc2() and EVP_ripemd160() were |
| 254 | changed to return truely const EVP_MD * in OpenSSL 0.9.7. | 250 | changed to return truely const EVP_MD * in OpenSSL 0.9.7. |
| 255 | 251 | ||
| 252 | The link between digests and signing algorithms was fixed in OpenSSL 1.0 and | ||
| 253 | later, so now EVP_sha1() can be used with RSA and DSA, there is no need to | ||
| 254 | use EVP_dss1() any more. | ||
| 255 | |||
| 256 | OpenSSL 1.0 and later does not include the MD2 digest algorithm in the | ||
| 257 | default configuration due to its security weaknesses. | ||
| 258 | |||
| 256 | =cut | 259 | =cut |
