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