openssl/doc/crypto/DSA_generate_key.pod

=pod

=head1 NAME

DSA_generate_key - generate DSA key pair

=head1 SYNOPSIS

 #include <openssl/dsa.h>

 int DSA_generate_key(DSA *a);

=head1 DESCRIPTION

DSA_generate_key() expects B<a> to contain DSA parameters. It generates
a new key pair and stores it in B<a-E<gt>pub_key> and B<a-E<gt>priv_key>.

The PRNG must be seeded prior to calling DSA_generate_key().

=head1 RETURN VALUE

DSA_generate_key() returns 1 on success, 0 otherwise.
The error codes can be obtained by L<ERR_get_error(3)>.

=head1 SEE ALSO

L<dsa(3)>, L<ERR_get_error(3)>, L<rand(3)>,
L<DSA_generate_parameters(3)>

=cut
Document DSA and SHA. New function BN_pseudo_rand(). Use BN_prime_checks_size(BN_num_bits(w)) rounds of Miller-Rabin when generating DSA primes (why not use BN_is_prime()?) 2000-01-27 19:31:26 +00:00			`=pod`

			`=head1 NAME`

nicer manpages 2000-02-24 11:55:57 +00:00			`DSA_generate_key - generate DSA key pair`
Document DSA and SHA. New function BN_pseudo_rand(). Use BN_prime_checks_size(BN_num_bits(w)) rounds of Miller-Rabin when generating DSA primes (why not use BN_is_prime()?) 2000-01-27 19:31:26 +00:00
			`=head1 SYNOPSIS`

			`#include <openssl/dsa.h>`

			`int DSA_generate_key(DSA *a);`

			`=head1 DESCRIPTION`

			`DSA_generate_key() expects B<a> to contain DSA parameters. It generates`
			`a new key pair and stores it in B<a-E<gt>pub_key> and B<a-E<gt>priv_key>.`

			`The PRNG must be seeded prior to calling DSA_generate_key().`

			`=head1 RETURN VALUE`

			`DSA_generate_key() returns 1 on success, 0 otherwise.`
Fix L<> content in manpages L<foo\|foo> is sub-optimal If the xref is the same as the title, which is what we do, then you only need L<foo>. This fixes all 1457 occurrences in 349 files. Approximately. (And pod used to need both.) Reviewed-by: Richard Levitte <levitte@openssl.org> 2015-08-17 19:21:33 +00:00			`The error codes can be obtained by L<ERR_get_error(3)>.`
Document DSA and SHA. New function BN_pseudo_rand(). Use BN_prime_checks_size(BN_num_bits(w)) rounds of Miller-Rabin when generating DSA primes (why not use BN_is_prime()?) 2000-01-27 19:31:26 +00:00
			`=head1 SEE ALSO`

Fix L<> content in manpages L<foo\|foo> is sub-optimal If the xref is the same as the title, which is what we do, then you only need L<foo>. This fixes all 1457 occurrences in 349 files. Approximately. (And pod used to need both.) Reviewed-by: Richard Levitte <levitte@openssl.org> 2015-08-17 19:21:33 +00:00			`L<dsa(3)>, L<ERR_get_error(3)>, L<rand(3)>,`
			`L<DSA_generate_parameters(3)>`
Document DSA and SHA. New function BN_pseudo_rand(). Use BN_prime_checks_size(BN_num_bits(w)) rounds of Miller-Rabin when generating DSA primes (why not use BN_is_prime()?) 2000-01-27 19:31:26 +00:00
			`=cut`