summaryrefslogtreecommitdiffstats
path: root/secure/lib/libcrypto/man/RSA_check_key.3
diff options
context:
space:
mode:
Diffstat (limited to 'secure/lib/libcrypto/man/RSA_check_key.3')
-rw-r--r--secure/lib/libcrypto/man/RSA_check_key.316
1 files changed, 12 insertions, 4 deletions
diff --git a/secure/lib/libcrypto/man/RSA_check_key.3 b/secure/lib/libcrypto/man/RSA_check_key.3
index a97e622..f5a5581 100644
--- a/secure/lib/libcrypto/man/RSA_check_key.3
+++ b/secure/lib/libcrypto/man/RSA_check_key.3
@@ -1,5 +1,5 @@
.\" Automatically generated by Pod::Man version 1.15
-.\" Thu May 9 13:18:21 2002
+.\" Tue Jul 30 09:21:49 2002
.\"
.\" Standard preamble:
.\" ======================================================================
@@ -137,8 +137,8 @@
.rm #[ #] #H #V #F C
.\" ======================================================================
.\"
-.IX Title "RSA_CHECK_KEY 1"
-.TH RSA_CHECK_KEY 1 "perl v5.6.1" "2000-04-13" "User Contributed Perl Documentation"
+.IX Title "RSA_check_key 3"
+.TH RSA_check_key 3 "0.9.6e" "2002-07-30" "OpenSSL"
.UC
.SH "NAME"
RSA_check_key \- validate private \s-1RSA\s0 keys
@@ -158,7 +158,9 @@ in fact prime, and that \fBn = p*q\fR.
It also checks that \fBd*e = 1 mod (p-1*q-1)\fR,
and that \fBdmp1\fR, \fBdmq1\fR and \fBiqmp\fR are set correctly or are \fB\s-1NULL\s0\fR.
.PP
-The key's public components may not be \fB\s-1NULL\s0\fR.
+As such, this function can not be used with any arbitrary \s-1RSA\s0 key object,
+even if it is otherwise fit for regular \s-1RSA\s0 operation. See \fB\s-1NOTES\s0\fR for more
+information.
.SH "RETURN VALUE"
.IX Header "RETURN VALUE"
\&\fIRSA_check_key()\fR returns 1 if \fBrsa\fR is a valid \s-1RSA\s0 key, and 0 otherwise.
@@ -166,6 +168,12 @@ The key's public components may not be \fB\s-1NULL\s0\fR.
.PP
If the key is invalid or an error occurred, the reason code can be
obtained using ERR_get_error(3).
+.SH "NOTES"
+.IX Header "NOTES"
+This function does not work on \s-1RSA\s0 public keys that have only the modulus
+and public exponent elements populated. It performs integrity checks on all
+the \s-1RSA\s0 key material, so the \s-1RSA\s0 key structure must contain all the private
+key data too.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
rsa(3), err(3)
OpenPOWER on IntegriCloud