2000-01-12 06:35:21 +08:00
|
|
|
=pod
|
|
|
|
|
|
|
|
=head1 NAME
|
|
|
|
|
2017-08-09 23:25:19 +08:00
|
|
|
RSA_size, RSA_bits, RSA_security_bits - get RSA modulus size or security bits
|
2000-01-12 06:35:21 +08:00
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2017-08-09 23:25:19 +08:00
|
|
|
#include <openssl/rsa.h>
|
2000-01-12 06:35:21 +08:00
|
|
|
|
2020-04-28 17:03:05 +08:00
|
|
|
int RSA_bits(const RSA *rsa);
|
|
|
|
|
2020-02-12 13:23:01 +08:00
|
|
|
Deprecated since OpenSSL 3.0, can be hidden entirely by defining
|
|
|
|
B<OPENSSL_API_COMPAT> with a suitable version value, see
|
|
|
|
L<openssl_user_macros(7)>:
|
|
|
|
|
2017-08-09 23:25:19 +08:00
|
|
|
int RSA_size(const RSA *rsa);
|
2015-04-18 18:23:12 +08:00
|
|
|
|
2020-07-15 16:26:35 +08:00
|
|
|
int RSA_security_bits(const RSA *rsa);
|
2000-01-12 06:35:21 +08:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2020-04-28 17:03:05 +08:00
|
|
|
RSA_bits() returns the number of significant bits.
|
|
|
|
|
|
|
|
B<rsa> and B<rsa-E<gt>n> must not be B<NULL>.
|
|
|
|
|
|
|
|
The remaining functions described on this page are deprecated.
|
Rename all getters to use get/get0 in name
For functions that exist in 1.1.1 provide a simple aliases via #define.
Fixes #15236
Functions with OSSL_DECODER_, OSSL_ENCODER_, OSSL_STORE_LOADER_,
EVP_KEYEXCH_, EVP_KEM_, EVP_ASYM_CIPHER_, EVP_SIGNATURE_,
EVP_KEYMGMT_, EVP_RAND_, EVP_MAC_, EVP_KDF_, EVP_PKEY_,
EVP_MD_, and EVP_CIPHER_ prefixes are renamed.
Reviewed-by: Paul Dale <pauli@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/15405)
2021-05-21 22:58:08 +08:00
|
|
|
Applications should instead use L<EVP_PKEY_get_size(3)>, L<EVP_PKEY_get_bits(3)>
|
|
|
|
and L<EVP_PKEY_get_security_bits(3)>.
|
2020-02-12 13:23:01 +08:00
|
|
|
|
2015-04-18 18:23:12 +08:00
|
|
|
RSA_size() returns the RSA modulus size in bytes. It can be used to
|
2000-01-12 06:35:21 +08:00
|
|
|
determine how much memory must be allocated for an RSA encrypted
|
|
|
|
value.
|
|
|
|
|
2017-08-09 23:25:19 +08:00
|
|
|
RSA_security_bits() returns the number of security bits of the given B<rsa>
|
|
|
|
key. See L<BN_security_bits(3)>.
|
|
|
|
|
2017-12-25 17:50:39 +08:00
|
|
|
=head1 RETURN VALUES
|
2000-01-12 06:35:21 +08:00
|
|
|
|
2020-04-28 17:03:05 +08:00
|
|
|
RSA_bits() returns the number of bits in the key.
|
2017-08-09 23:25:19 +08:00
|
|
|
|
2020-04-28 17:03:05 +08:00
|
|
|
RSA_size() returns the size of modulus in bytes.
|
2017-08-09 23:25:19 +08:00
|
|
|
|
|
|
|
RSA_security_bits() returns the number of security bits.
|
2000-01-12 06:35:21 +08:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
2016-06-10 04:39:19 +08:00
|
|
|
L<BN_num_bits(3)>
|
2000-01-12 06:35:21 +08:00
|
|
|
|
|
|
|
=head1 HISTORY
|
|
|
|
|
2020-04-28 17:03:05 +08:00
|
|
|
The RSA_size() and RSA_security_bits() functions were deprecated in OpenSSL 3.0.
|
2020-02-12 13:23:01 +08:00
|
|
|
|
2018-12-09 08:02:36 +08:00
|
|
|
The RSA_bits() function was added in OpenSSL 1.1.0.
|
2000-01-12 06:35:21 +08:00
|
|
|
|
2016-05-18 23:44:05 +08:00
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
2020-04-23 20:55:52 +08:00
|
|
|
Copyright 2000-2020 The OpenSSL Project Authors. All Rights Reserved.
|
2016-05-18 23:44:05 +08:00
|
|
|
|
2018-12-06 21:04:44 +08:00
|
|
|
Licensed under the Apache License 2.0 (the "License"). You may not use
|
2016-05-18 23:44:05 +08:00
|
|
|
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>.
|
|
|
|
|
|
|
|
=cut
|