Index for Section 3

Alphabetical listing for R

Bottom of page

RSA_check_key(3)
NAME
  RSA_check_key - Validate private RSA keys

SYNOPSIS
  #include <openssl/rsa.h>

  int RSA_check_key(
	  RSA *rsa );

DESCRIPTION
  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
  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
  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
  The RSA_check_key() function appeared in OpenSSL 0.9.4.

SEE ALSO
  Functions: rsa(3), err(3)

Index for Section 3

Alphabetical listing for R

Top of page