RSA_check_key.pod 817 字节
Newer Older
U
Ulf Möller 已提交
1 2 3 4
=pod

=head1 NAME

U
Ulf Möller 已提交
5
RSA_check_key - validate private RSA keys
U
Ulf Möller 已提交
6 7 8 9 10 11 12 13 14 15 16 17

=head1 SYNOPSIS

 #include <openssl/rsa.h>

 int RSA_check_key(RSA *rsa);

=head1 DESCRIPTION

This function validates RSA keys. It checks that B<p> and B<q> are
in fact prime, and that B<n = p*q>.

U
Ulf Möller 已提交
18
It also checks that B<d*e = 1 mod (p-1*q-1)>,
U
Ulf Möller 已提交
19 20 21 22 23 24 25 26 27 28
and that B<dmp1>, B<dmq1> and B<iqmp> are set correctly or are B<NULL>.

The key's public components may not be B<NULL>.

=head1 RETURN VALUE

RSA_check_key() returns 1 if B<rsa> is a valid RSA key, and 0 otherwise.
-1 is returned if an error occurs while checking the key.

If the key is invalid or an error occurred, the reason code can be
29
obtained using L<ERR_get_error(3)|ERR_get_error(3)>.
U
Ulf Möller 已提交
30 31 32

=head1 SEE ALSO

33
L<rsa(3)|rsa(3)>, L<err(3)|err(3)>
U
Ulf Möller 已提交
34 35 36 37 38 39

=head1 HISTORY

RSA_check() appeared in OpenSSL 0.9.4.

=cut