NAME    [Toc]    [Back]

       RSA_check_key - Validate private RSA keys

SYNOPSIS    [Toc]    [Back]

       #include <openssl/rsa.h>

       int RSA_check_key(
               RSA *rsa );

DESCRIPTION    [Toc]    [Back]

       This  function  validates RSA keys. It checks that p and q
       are prime, and that n = p*q.

       It also checks that d*e = 1 mod (p-1*q-1), and that  dmp1,
       dmq1 and iqmp are set correctly or are NULL.

       As  such, this function can not be used with any arbitrary
       RSA key object, even if it is otherwise  fit  for  regular
       RSA operation. See Notes for more informaiton

NOTES    [Toc]    [Back]

       This  function  does not work on RSA public keys that have
       only the modulus and public exponent  elements  populated.
       It  performs integrity checks on all the RSA key material,
       so the RSA key structure must contain all the private  key
       data.

RETURN VALUE    [Toc]    [Back]

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

       If  the  key  is  invalid or an error occurred, the reason
       code can be obtained using the ERR_get_error() function.

HISTORY    [Toc]    [Back]

       The RSA_check_key() function appeared in OpenSSL 0.9.4.

SEE ALSO    [Toc]    [Back]

       Functions: rsa(3), err(3)



                                                 RSA_check_key(3)