6de81e3d1d40cafd1b25accdceef5e935751fca7
[openssl.git] / doc / crypto / X509_new.pod
1 =pod
2
3 =head1 NAME
4
5 X509_new, X509_free, - X509 certificate ASN1 allocation functions
6
7 =head1 SYNOPSIS
8
9  X509 *X509_new(void);
10  void X509_free(X509 *a);
11
12 =head1 DESCRIPTION
13
14 The X509 ASN1 allocation routines, allocate and free an
15 X509 structure, which represents an X509 certificate.
16
17 X509_new() allocates and initializes a X509 structure.
18
19 X509_free() frees up the B<X509> structure B<a>.
20
21 =head1 RETURN VALUES
22
23 If the allocation fails, X509_new() returns B<NULL> and sets an error
24 code that can be obtained by L<ERR_get_error(3)|ERR_get_error(3)>.
25 Otherwise it returns a pointer to the newly allocated structure.
26
27 X509_free() returns no value.
28
29 =head1 SEE ALSO
30
31 L<ERR_get_error(3)|ERR_get_error(3)>, L<d2i_X509(3)|d2i_X509(3)>
32
33 =head1 HISTORY
34
35 X509_new() and X509_free() are available in all versions of SSLeay and OpenSSL.
36
37 =cut