diff options
Diffstat (limited to 'doc/man3/EVP_MD_meth_new.pod')
| -rw-r--r-- | doc/man3/EVP_MD_meth_new.pod | 32 |
1 files changed, 23 insertions, 9 deletions
diff --git a/doc/man3/EVP_MD_meth_new.pod b/doc/man3/EVP_MD_meth_new.pod index e17a4cd519ab..a553c378f3d7 100644 --- a/doc/man3/EVP_MD_meth_new.pod +++ b/doc/man3/EVP_MD_meth_new.pod @@ -2,8 +2,8 @@ =head1 NAME -EVP_MD_meth_dup, -EVP_MD_meth_new, EVP_MD_meth_free, EVP_MD_meth_set_input_blocksize, +EVP_MD_meth_new, EVP_MD_meth_dup, EVP_MD_meth_free, +EVP_MD_meth_set_input_blocksize, EVP_MD_meth_set_result_size, EVP_MD_meth_set_app_datasize, EVP_MD_meth_set_flags, EVP_MD_meth_set_init, EVP_MD_meth_set_update, EVP_MD_meth_set_final, EVP_MD_meth_set_copy, EVP_MD_meth_set_cleanup, @@ -12,12 +12,16 @@ EVP_MD_meth_get_result_size, EVP_MD_meth_get_app_datasize, EVP_MD_meth_get_flags, EVP_MD_meth_get_init, EVP_MD_meth_get_update, EVP_MD_meth_get_final, EVP_MD_meth_get_copy, EVP_MD_meth_get_cleanup, EVP_MD_meth_get_ctrl -- Routines to build up EVP_MD methods +- Routines to build up legacy EVP_MD methods =head1 SYNOPSIS #include <openssl/evp.h> +The following functions have been deprecated since OpenSSL 3.0, and can be +hidden entirely by defining B<OPENSSL_API_COMPAT> with a suitable version value, +see L<openssl_user_macros(7)>: + EVP_MD *EVP_MD_meth_new(int md_type, int pkey_type); void EVP_MD_meth_free(EVP_MD *md); EVP_MD *EVP_MD_meth_dup(const EVP_MD *md); @@ -56,15 +60,20 @@ EVP_MD_meth_get_ctrl =head1 DESCRIPTION +All of the functions described on this page are deprecated. +Applications should instead use the OSSL_PROVIDER APIs. + The B<EVP_MD> type is a structure for digest method implementation. It can also have associated public/private key signing and verifying routines. EVP_MD_meth_new() creates a new B<EVP_MD> structure. +These B<EVP_MD> structures are reference counted. EVP_MD_meth_dup() creates a copy of B<md>. -EVP_MD_meth_free() destroys a B<EVP_MD> structure. +EVP_MD_meth_free() decrements the reference count for the B<EVP_MD> structure. +If the reference count drops to 0 then the structure is freed. EVP_MD_meth_set_input_blocksize() sets the internal input block size for the method B<md> to B<blocksize> bytes. @@ -135,7 +144,7 @@ computations after the method's private data structure has been copied from one B<EVP_MD_CTX> to another. If all that's needed is to copy the data, there is no need for this copy function. Note that the copy function is passed two B<EVP_MD_CTX *>, the private -data structure is then available with EVP_MD_CTX_md_data(). +data structure is then available with EVP_MD_CTX_get0_md_data(). This copy function is called by EVP_MD_CTX_copy() and EVP_MD_CTX_copy_ex(). @@ -143,7 +152,7 @@ EVP_MD_meth_set_cleanup() sets the function for B<md> to do extra cleanup before the method's private data structure is cleaned out and freed. Note that the cleanup function is passed a B<EVP_MD_CTX *>, the -private data structure is then available with EVP_MD_CTX_md_data(). +private data structure is then available with EVP_MD_CTX_get0_md_data(). This cleanup function is called by EVP_MD_CTX_reset() and EVP_MD_CTX_free(). @@ -175,14 +184,19 @@ L<EVP_DigestInit(3)>, L<EVP_SignInit(3)>, L<EVP_VerifyInit(3)> =head1 HISTORY +All of these functions were deprecated in OpenSSL 3.0. + The B<EVP_MD> structure was openly available in OpenSSL before version -1.1. The functions described here were added in OpenSSL 1.1. +1.1. +The functions described here were added in OpenSSL 1.1. +The B<EVP_MD> structure created with these functions became reference +counted in OpenSSL 3.0. =head1 COPYRIGHT -Copyright 2015-2018 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2015-2021 The OpenSSL Project Authors. All Rights Reserved. -Licensed under the OpenSSL license (the "License"). You may not use +Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at L<https://www.openssl.org/source/license.html>. |