diff options
Diffstat (limited to 'src/lib/libcrypto/doc/EVP_DigestInit.pod')
| -rw-r--r-- | src/lib/libcrypto/doc/EVP_DigestInit.pod | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/src/lib/libcrypto/doc/EVP_DigestInit.pod b/src/lib/libcrypto/doc/EVP_DigestInit.pod index 367691cc7a..dcc5d73f69 100644 --- a/src/lib/libcrypto/doc/EVP_DigestInit.pod +++ b/src/lib/libcrypto/doc/EVP_DigestInit.pod | |||
| @@ -26,18 +26,18 @@ EVP digest routines | |||
| 26 | int EVP_MD_CTX_cleanup(EVP_MD_CTX *ctx); | 26 | int EVP_MD_CTX_cleanup(EVP_MD_CTX *ctx); |
| 27 | void EVP_MD_CTX_destroy(EVP_MD_CTX *ctx); | 27 | void EVP_MD_CTX_destroy(EVP_MD_CTX *ctx); |
| 28 | 28 | ||
| 29 | int EVP_MD_CTX_copy_ex(EVP_MD_CTX *out,const EVP_MD_CTX *in); | 29 | int EVP_MD_CTX_copy_ex(EVP_MD_CTX *out,const EVP_MD_CTX *in); |
| 30 | 30 | ||
| 31 | int EVP_DigestInit(EVP_MD_CTX *ctx, const EVP_MD *type); | 31 | int EVP_DigestInit(EVP_MD_CTX *ctx, const EVP_MD *type); |
| 32 | int EVP_DigestFinal(EVP_MD_CTX *ctx, unsigned char *md, | 32 | int EVP_DigestFinal(EVP_MD_CTX *ctx, unsigned char *md, |
| 33 | unsigned int *s); | 33 | unsigned int *s); |
| 34 | 34 | ||
| 35 | int EVP_MD_CTX_copy(EVP_MD_CTX *out,EVP_MD_CTX *in); | 35 | int EVP_MD_CTX_copy(EVP_MD_CTX *out,EVP_MD_CTX *in); |
| 36 | 36 | ||
| 37 | #define EVP_MAX_MD_SIZE 64 /* SHA512 */ | 37 | #define EVP_MAX_MD_SIZE 64 /* SHA512 */ |
| 38 | 38 | ||
| 39 | int EVP_MD_type(const EVP_MD *md); | 39 | int EVP_MD_type(const EVP_MD *md); |
| 40 | int EVP_MD_pkey_type(const EVP_MD *md); | 40 | int EVP_MD_pkey_type(const EVP_MD *md); |
| 41 | int EVP_MD_size(const EVP_MD *md); | 41 | int EVP_MD_size(const EVP_MD *md); |
| 42 | int EVP_MD_block_size(const EVP_MD *md); | 42 | int EVP_MD_block_size(const EVP_MD *md); |
| 43 | 43 | ||
| @@ -136,10 +136,10 @@ reasons. | |||
| 136 | EVP_md2(), EVP_md5(), EVP_sha(), EVP_sha1(), EVP_sha224(), EVP_sha256(), | 136 | EVP_md2(), EVP_md5(), EVP_sha(), EVP_sha1(), EVP_sha224(), EVP_sha256(), |
| 137 | EVP_sha384(), EVP_sha512(), EVP_mdc2() and EVP_ripemd160() return B<EVP_MD> | 137 | EVP_sha384(), EVP_sha512(), EVP_mdc2() and EVP_ripemd160() return B<EVP_MD> |
| 138 | structures for the MD2, MD5, SHA, SHA1, SHA224, SHA256, SHA384, SHA512, MDC2 | 138 | structures for the MD2, MD5, SHA, SHA1, SHA224, SHA256, SHA384, SHA512, MDC2 |
| 139 | and RIPEMD160 digest algorithms respectively. | 139 | and RIPEMD160 digest algorithms respectively. |
| 140 | 140 | ||
| 141 | EVP_dss() and EVP_dss1() return B<EVP_MD> structures for SHA and SHA1 digest | 141 | EVP_dss() and EVP_dss1() return B<EVP_MD> structures for SHA and SHA1 digest |
| 142 | algorithms but using DSS (DSA) for the signature algorithm. Note: there is | 142 | algorithms but using DSS (DSA) for the signature algorithm. Note: there is |
| 143 | no need to use these pseudo-digests in OpenSSL 1.0.0 and later, they are | 143 | no need to use these pseudo-digests in OpenSSL 1.0.0 and later, they are |
| 144 | however retained for compatibility. | 144 | however retained for compatibility. |
| 145 | 145 | ||
| @@ -178,21 +178,21 @@ The B<EVP> interface to message digests should almost always be used in | |||
| 178 | preference to the low level interfaces. This is because the code then becomes | 178 | preference to the low level interfaces. This is because the code then becomes |
| 179 | transparent to the digest used and much more flexible. | 179 | transparent to the digest used and much more flexible. |
| 180 | 180 | ||
| 181 | New applications should use the SHA2 digest algorithms such as SHA256. | 181 | New applications should use the SHA2 digest algorithms such as SHA256. |
| 182 | The other digest algorithms are still in common use. | 182 | The other digest algorithms are still in common use. |
| 183 | 183 | ||
| 184 | For most applications the B<impl> parameter to EVP_DigestInit_ex() will be | 184 | For most applications the B<impl> parameter to EVP_DigestInit_ex() will be |
| 185 | set to NULL to use the default digest implementation. | 185 | set to NULL to use the default digest implementation. |
| 186 | 186 | ||
| 187 | The functions EVP_DigestInit(), EVP_DigestFinal() and EVP_MD_CTX_copy() are | 187 | The functions EVP_DigestInit(), EVP_DigestFinal() and EVP_MD_CTX_copy() are |
| 188 | obsolete but are retained to maintain compatibility with existing code. New | 188 | obsolete but are retained to maintain compatibility with existing code. New |
| 189 | applications should use EVP_DigestInit_ex(), EVP_DigestFinal_ex() and | 189 | applications should use EVP_DigestInit_ex(), EVP_DigestFinal_ex() and |
| 190 | EVP_MD_CTX_copy_ex() because they can efficiently reuse a digest context | 190 | EVP_MD_CTX_copy_ex() because they can efficiently reuse a digest context |
| 191 | instead of initializing and cleaning it up on each call and allow non default | 191 | instead of initializing and cleaning it up on each call and allow non default |
| 192 | implementations of digests to be specified. | 192 | implementations of digests to be specified. |
| 193 | 193 | ||
| 194 | In OpenSSL 0.9.7 and later if digest contexts are not cleaned up after use | 194 | In OpenSSL 0.9.7 and later if digest contexts are not cleaned up after use |
| 195 | memory leaks will occur. | 195 | memory leaks will occur. |
| 196 | 196 | ||
| 197 | Stack allocation of EVP_MD_CTX structures is common, for example: | 197 | Stack allocation of EVP_MD_CTX structures is common, for example: |
| 198 | 198 | ||
