xref: /freebsd/crypto/openssl/doc/man3/DSA_generate_key.pod (revision f7c32ed617858bcd22f8d1b03199099d50125721)
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 random generator must be seeded prior to calling DSA_generate_key().
19If the automatic seeding or reseeding of the OpenSSL CSPRNG fails due to
20external circumstances (see L<RAND(7)>), the operation will fail.
21
22=head1 RETURN VALUES
23
24DSA_generate_key() returns 1 on success, 0 otherwise.
25The error codes can be obtained by L<ERR_get_error(3)>.
26
27=head1 SEE ALSO
28
29L<DSA_new(3)>, L<ERR_get_error(3)>, L<RAND_bytes(3)>,
30L<DSA_generate_parameters_ex(3)>
31
32=head1 COPYRIGHT
33
34Copyright 2000-2019 The OpenSSL Project Authors. All Rights Reserved.
35
36Licensed under the OpenSSL license (the "License").  You may not use
37this file except in compliance with the License.  You can obtain a copy
38in the file LICENSE in the source distribution or at
39L<https://www.openssl.org/source/license.html>.
40
41=cut
42