1e71b7053SJung-uk Kim=pod 2e71b7053SJung-uk Kim 3e71b7053SJung-uk Kim=head1 NAME 4e71b7053SJung-uk Kim 5e71b7053SJung-uk KimDSA_size, DSA_bits, DSA_security_bits - get DSA signature size, key bits or security bits 6e71b7053SJung-uk Kim 7e71b7053SJung-uk Kim=head1 SYNOPSIS 8e71b7053SJung-uk Kim 9e71b7053SJung-uk Kim #include <openssl/dsa.h> 10e71b7053SJung-uk Kim 11*b077aed3SPierre ProncheryThe following functions have been deprecated since OpenSSL 3.0, and can be 12*b077aed3SPierre Proncheryhidden entirely by defining B<OPENSSL_API_COMPAT> with a suitable version value, 13*b077aed3SPierre Proncherysee L<openssl_user_macros(7)>: 14*b077aed3SPierre Pronchery 15e71b7053SJung-uk Kim int DSA_bits(const DSA *dsa); 16*b077aed3SPierre Pronchery 17*b077aed3SPierre Pronchery int DSA_size(const DSA *dsa); 18*b077aed3SPierre Pronchery 19e71b7053SJung-uk Kim int DSA_security_bits(const DSA *dsa); 20e71b7053SJung-uk Kim 21e71b7053SJung-uk Kim=head1 DESCRIPTION 22e71b7053SJung-uk Kim 23*b077aed3SPierre ProncheryAll of the functions described on this page are deprecated. 24*b077aed3SPierre ProncheryApplications should instead use L<EVP_PKEY_get_bits(3)>, 25*b077aed3SPierre ProncheryL<EVP_PKEY_get_security_bits(3)> and L<EVP_PKEY_get_size(3)>. 26*b077aed3SPierre Pronchery 27*b077aed3SPierre ProncheryDSA_bits() returns the number of bits in key I<dsa>: this is the number 28*b077aed3SPierre Proncheryof bits in the I<p> parameter. 29*b077aed3SPierre Pronchery 30e71b7053SJung-uk KimDSA_size() returns the maximum size of an ASN.1 encoded DSA signature 31*b077aed3SPierre Proncheryfor key I<dsa> in bytes. It can be used to determine how much memory must 32e71b7053SJung-uk Kimbe allocated for a DSA signature. 33e71b7053SJung-uk Kim 34*b077aed3SPierre ProncheryDSA_security_bits() returns the number of security bits of the given I<dsa> 35e71b7053SJung-uk Kimkey. See L<BN_security_bits(3)>. 36e71b7053SJung-uk Kim 37e71b7053SJung-uk Kim=head1 RETURN VALUES 38e71b7053SJung-uk Kim 39*b077aed3SPierre ProncheryDSA_security_bits() returns the number of security bits in the key, or -1 if 40*b077aed3SPierre ProncheryI<dsa> doesn't hold any key parameters. 41e71b7053SJung-uk Kim 42*b077aed3SPierre ProncheryDSA_bits() returns the number of bits in the key, or -1 if I<dsa> doesn't 43*b077aed3SPierre Proncheryhold any key parameters. 44*b077aed3SPierre Pronchery 45*b077aed3SPierre ProncheryDSA_size() returns the signature size in bytes, or -1 if I<dsa> doesn't 46*b077aed3SPierre Proncheryhold any key parameters. 47e71b7053SJung-uk Kim 48e71b7053SJung-uk Kim=head1 SEE ALSO 49e71b7053SJung-uk Kim 50*b077aed3SPierre ProncheryL<EVP_PKEY_get_bits(3)>, 51*b077aed3SPierre ProncheryL<EVP_PKEY_get_security_bits(3)>, 52*b077aed3SPierre ProncheryL<EVP_PKEY_get_size(3)>, 53e71b7053SJung-uk KimL<DSA_new(3)>, L<DSA_sign(3)> 54e71b7053SJung-uk Kim 55*b077aed3SPierre Pronchery=head1 HISTORY 56*b077aed3SPierre Pronchery 57*b077aed3SPierre ProncheryAll of these functions were deprecated in OpenSSL 3.0. 58*b077aed3SPierre Pronchery 59e71b7053SJung-uk Kim=head1 COPYRIGHT 60e71b7053SJung-uk Kim 61*b077aed3SPierre ProncheryCopyright 2000-2021 The OpenSSL Project Authors. All Rights Reserved. 62e71b7053SJung-uk Kim 63*b077aed3SPierre ProncheryLicensed under the Apache License 2.0 (the "License"). You may not use 64e71b7053SJung-uk Kimthis file except in compliance with the License. You can obtain a copy 65e71b7053SJung-uk Kimin the file LICENSE in the source distribution or at 66e71b7053SJung-uk KimL<https://www.openssl.org/source/license.html>. 67e71b7053SJung-uk Kim 68e71b7053SJung-uk Kim=cut 69