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