- NAME
- SYNOPSIS
- DESCRIPTION
- RETURN VALUES
- SEE ALSO
- HISTORY

# NAME

RSA_new, RSA_free - allocate and free RSA objects

# SYNOPSIS

     #include <openssl/rsa.h>

     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.

# RETURN VALUES

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

`RSA_free()` returns no value.

# SEE ALSO

ERR_get_error, rsa, RSA_generate_key, RSA_new_method

# HISTORY

`RSA_new()` and `RSA_free()` are available in all versions of SSLeay and OpenSSL.