RSA_new.3ossl - Man Page

allocate and free RSA objects

Synopsis

 #include <openssl/rsa.h>

The following functions have been deprecated since OpenSSL 3.0, and can be hidden entirely by defining OPENSSL_API_COMPAT with a suitable version value, see openssl_user_macros(7):

 RSA *RSA_new(void);

 void RSA_free(RSA *rsa);

Description

RSA_new() allocates and initializes an RSA structure. It is equivalent to calling RSA_new_method(NULL).

RSA_free() frees the RSA structure and its components. The key is erased before the memory is returned to the system. If rsa is NULL nothing is done.

Return Values

If the allocation fails, RSA_new() returns NULL and sets an error code that can be obtained by ERR_get_error(3). Otherwise it returns a pointer to the newly allocated structure.

RSA_free() returns no value.

See Also

ERR_get_error(3), RSA_generate_key(3), RSA_new_method(3)

History

All functions described here were deprecated in OpenSSL 3.0. For replacement see EVP_PKEY-RSA(7).

Referenced By

RSA_get0_key.3ossl(3), RSA_meth_new.3ossl(3), RSA_set_method.3ossl(3).

The man page RSA_free.3ossl(3) is an alias of RSA_new.3ossl(3).

2024-04-04 3.2.1 OpenSSL