xref: /freebsd/crypto/openssl/doc/man3/DSA_generate_key.pod (revision 8df8b2d3e51d1b816201d8a1fe8bc29fe192e562)
1=pod
2
3=head1 NAME
4
5DSA_generate_key - generate DSA key pair
6
7=head1 SYNOPSIS
8
9 #include <openssl/dsa.h>
10
11 int DSA_generate_key(DSA *a);
12
13=head1 DESCRIPTION
14
15DSA_generate_key() expects B<a> to contain DSA parameters. It generates
16a new key pair and stores it in B<a-E<gt>pub_key> and B<a-E<gt>priv_key>.
17
18The PRNG must be seeded prior to calling DSA_generate_key().
19
20=head1 RETURN VALUES
21
22DSA_generate_key() returns 1 on success, 0 otherwise.
23The error codes can be obtained by L<ERR_get_error(3)>.
24
25=head1 SEE ALSO
26
27L<DSA_new(3)>, L<ERR_get_error(3)>, L<RAND_bytes(3)>,
28L<DSA_generate_parameters_ex(3)>
29
30=head1 COPYRIGHT
31
32Copyright 2000-2018 The OpenSSL Project Authors. All Rights Reserved.
33
34Licensed under the OpenSSL license (the "License").  You may not use
35this file except in compliance with the License.  You can obtain a copy
36in the file LICENSE in the source distribution or at
37L<https://www.openssl.org/source/license.html>.
38
39=cut
40