xref: /onnv-gate/usr/src/common/openssl/doc/crypto/DSA_SIG_new.pod (revision 2175:b0b2f052a486)
1*2175Sjp161948=pod
2*2175Sjp161948
3*2175Sjp161948=head1 NAME
4*2175Sjp161948
5*2175Sjp161948DSA_SIG_new, DSA_SIG_free - allocate and free DSA signature objects
6*2175Sjp161948
7*2175Sjp161948=head1 SYNOPSIS
8*2175Sjp161948
9*2175Sjp161948 #include <openssl/dsa.h>
10*2175Sjp161948
11*2175Sjp161948 DSA_SIG *DSA_SIG_new(void);
12*2175Sjp161948
13*2175Sjp161948 void	DSA_SIG_free(DSA_SIG *a);
14*2175Sjp161948
15*2175Sjp161948=head1 DESCRIPTION
16*2175Sjp161948
17*2175Sjp161948DSA_SIG_new() allocates and initializes a B<DSA_SIG> structure.
18*2175Sjp161948
19*2175Sjp161948DSA_SIG_free() frees the B<DSA_SIG> structure and its components. The
20*2175Sjp161948values are erased before the memory is returned to the system.
21*2175Sjp161948
22*2175Sjp161948=head1 RETURN VALUES
23*2175Sjp161948
24*2175Sjp161948If the allocation fails, DSA_SIG_new() returns B<NULL> and sets an
25*2175Sjp161948error code that can be obtained by
26*2175Sjp161948L<ERR_get_error(3)|ERR_get_error(3)>. Otherwise it returns a pointer
27*2175Sjp161948to the newly allocated structure.
28*2175Sjp161948
29*2175Sjp161948DSA_SIG_free() returns no value.
30*2175Sjp161948
31*2175Sjp161948=head1 SEE ALSO
32*2175Sjp161948
33*2175Sjp161948L<dsa(3)|dsa(3)>, L<ERR_get_error(3)|ERR_get_error(3)>,
34*2175Sjp161948L<DSA_do_sign(3)|DSA_do_sign(3)>
35*2175Sjp161948
36*2175Sjp161948=head1 HISTORY
37*2175Sjp161948
38*2175Sjp161948DSA_SIG_new() and DSA_SIG_free() were added in OpenSSL 0.9.3.
39*2175Sjp161948
40*2175Sjp161948=cut
41