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