blob: 9ff755335255596fd635fa174d15e066ca0b8c08 [file] [log] [blame]
Ulf Möller38e33ce2000-01-27 19:31:26 +00001=pod
2
3=head1 NAME
4
Ulf Möller4d524e12000-02-24 11:55:57 +00005DSA_generate_key - generate DSA key pair
Ulf Möller38e33ce2000-01-27 19:31:26 +00006
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
Paul Yang1f13ad32017-12-25 17:50:39 +080020=head1 RETURN VALUES
Ulf Möller38e33ce2000-01-27 19:31:26 +000021
22DSA_generate_key() returns 1 on success, 0 otherwise.
Rich Salz9b869742015-08-17 15:21:33 -040023The error codes can be obtained by L<ERR_get_error(3)>.
Ulf Möller38e33ce2000-01-27 19:31:26 +000024
25=head1 SEE ALSO
26
Richard Levitteb97fdb52016-11-11 09:33:09 +010027L<DSA_new(3)>, L<ERR_get_error(3)>, L<RAND_bytes(3)>,
Rich Salzb3696a52017-09-02 09:35:50 -040028L<DSA_generate_parameters_ex(3)>
Ulf Möller38e33ce2000-01-27 19:31:26 +000029
Rich Salze2f92612016-05-18 11:44:05 -040030=head1 COPYRIGHT
31
Paul Yang61f805c2018-01-16 01:01:46 +080032Copyright 2000-2018 The OpenSSL Project Authors. All Rights Reserved.
Rich Salze2f92612016-05-18 11:44:05 -040033
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