]> git.ipfire.org Git - thirdparty/openssl.git/blame - doc/man3/RSA_new.pod
Update copyright year
[thirdparty/openssl.git] / doc / man3 / RSA_new.pod
CommitLineData
2186cd8e
UM
1=pod
2
3=head1 NAME
4
5RSA_new, RSA_free - allocate and free RSA objects
6
7=head1 SYNOPSIS
8
9 #include <openssl/rsa.h>
10
e9b77246 11 RSA *RSA_new(void);
2186cd8e
UM
12
13 void RSA_free(RSA *rsa);
14
15=head1 DESCRIPTION
16
ac120e20
GT
17RSA_new() allocates and initializes an B<RSA> structure. It is equivalent to
18calling RSA_new_method(NULL).
2186cd8e
UM
19
20RSA_free() frees the B<RSA> structure and its components. The key is
60b52453 21erased before the memory is returned to the system.
d6407083 22If B<rsa> is NULL nothing is done.
2186cd8e
UM
23
24=head1 RETURN VALUES
25
26If the allocation fails, RSA_new() returns B<NULL> and sets an error
9b86974e 27code that can be obtained by L<ERR_get_error(3)>. Otherwise it returns
2186cd8e
UM
28a pointer to the newly allocated structure.
29
30RSA_free() returns no value.
31
32=head1 SEE ALSO
33
53934822 34L<ERR_get_error(3)>,
9b86974e
RS
35L<RSA_generate_key(3)>,
36L<RSA_new_method(3)>
2186cd8e 37
e2f92610
RS
38=head1 COPYRIGHT
39
40Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved.
41
42Licensed under the OpenSSL license (the "License"). You may not use
43this file except in compliance with the License. You can obtain a copy
44in the file LICENSE in the source distribution or at
45L<https://www.openssl.org/source/license.html>.
46
47=cut