Import OpenSSL-0.9.8i.
[dragonfly.git] / crypto / openssl-0.9.7d / doc / crypto / DSA_SIG_new.pod
blob3ac614003816606db879fb8dfe037db2a713a7cc
1 =pod
3 =head1 NAME
5 DSA_SIG_new, DSA_SIG_free - allocate and free DSA signature objects
7 =head1 SYNOPSIS
9  #include <openssl/dsa.h>
11  DSA_SIG *DSA_SIG_new(void);
13  void   DSA_SIG_free(DSA_SIG *a);
15 =head1 DESCRIPTION
17 DSA_SIG_new() allocates and initializes a B<DSA_SIG> structure.
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.
22 =head1 RETURN VALUES
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)|ERR_get_error(3)>. Otherwise it returns a pointer
27 to the newly allocated structure.
29 DSA_SIG_free() returns no value.
31 =head1 SEE ALSO
33 L<dsa(3)|dsa(3)>, L<ERR_get_error(3)|ERR_get_error(3)>,
34 L<DSA_do_sign(3)|DSA_do_sign(3)>
36 =head1 HISTORY
38 DSA_SIG_new() and DSA_SIG_free() were added in OpenSSL 0.9.3.
40 =cut