Less documentation for deprecated API

pre-allocated B<BN_CTX> (to save the overhead of allocating and

freeing the structure in a loop), or B<NULL>.

BN_GENCB_call calls the callback function held in the B<BN_GENCB> structure

BN_GENCB_call() calls the callback function held in the B<BN_GENCB> structure

and passes the ints B<a> and B<b> as arguments. There are two types of

B<BN_GENCB> structure that are supported: "new" style and "old" style. New

programs should prefer the "new" style, whilst the "old" style is provided

for backwards compatibility purposes.

A BN_GENCB structure should be created through a call to BN_GENCB_new(),

A B<BN_GENCB> structure should be created through a call to BN_GENCB_new(),

and freed through a call to BN_GENCB_free().

For "new" style callbacks a BN_GENCB structure should be initialised with a

It is possible to obtained the argument associated with a BN_GENCB structure

(set via a call to BN_GENCB_set or BN_GENCB_set_old) using BN_GENCB_get_arg.

BN_generate_prime (deprecated) works in the same way as

BN_generate_prime_ex but expects an old style callback function

BN_generate_prime() (deprecated) works in the same way as

BN_generate_prime_ex() but expects an old-style callback function

directly in the B<callback> parameter, and an argument to pass to it in

the B<cb_arg>. Similarly BN_is_prime and BN_is_prime_fasttest are

deprecated and can be compared to BN_is_prime_ex and

BN_is_prime_fasttest_ex respectively.

the B<cb_arg>. BN_is_prime() and BN_is_prime_fasttest()

can similarly be compared to BN_is_prime_ex() and

BN_is_prime_fasttest_ex(), respectively.

=head1 RETURN VALUES

 int BN_set_word(BIGNUM *a, unsigned long w);

 unsigned long BN_get_word(BIGNUM *a);

Deprecated:

 #if OPENSSL_API_COMPAT < 0x00908000L

 int BN_zero(BIGNUM *a);

 #endif

=head1 DESCRIPTION

BN_zero(), BN_one() and BN_set_word() set B<a> to the values 0, 1 and

BN_get_word() returns the value B<a>, and 0xffffffffL if B<a> cannot

be represented as an unsigned long.

BN_one(), BN_set_word() and the deprecated version of BN_zero()

return 1 on success, 0 otherwise.

BN_one() and BN_set_word() return 1 on success, 0 otherwise.

BN_value_one() returns the constant.

The preferred version of BN_zero() never fails and returns no value.

BN_zero() never fails and returns no value.

=head1 BUGS

Someone might change the constant.

If a B<BIGNUM> is equal to 0xffffffffL it can be represented as an

unsigned long but this value is also returned on error.

L<BN_bn2bin(3)>

=head1 HISTORY

In OpenSSL 0.9.8, BN_zero() was changed to not return a value; previous

versions returned an int.

=head1 COPYRIGHT

Copyright 2000-2017 The OpenSSL Project Authors. All Rights Reserved.

=head1 DESCRIPTION

CONF_modules_free() closes down and frees up all memory allocated by all

configuration modules.

configuration modules.  Normally, in versions of OpenSSL prior to 1.1.0,

applications called

CONF_modules_free() at exit to tidy up any configuration performed.

CONF_modules_finish() calls each configuration modules B<finish> handler

to free up any configuration that module may have performed.

B<all> is set to B<0> only modules loaded from DSOs will be unloads. If

B<all> is B<1> all modules, including builtin modules will be unloaded.

=head1 NOTES

Normally in versions of OpenSSL prior to 1.1.0 applications will only call

CONF_modules_free() at application exit to tidy up any configuration performed.

From 1.1.0 CONF_modules_free() is deprecated and no explicit CONF cleanup is

required at all. For more information see L<OPENSSL_init_crypto(3)>.

=head1 RETURN VALUE

None of the functions return a value.

=head1 HISTORY

CONF_modules_free() was deprecated in OpenSSL 1.1.0.

CONF_modules_free() was deprecated in OpenSSL 1.1.0; do not use it.

For more information see L<OPENSSL_init_crypto(3)>.

=head1 COPYRIGHT

DH_generate_parameters_ex() generates Diffie-Hellman parameters that can

be shared among a group of users, and stores them in the provided B<DH>

structure. The pseudo-random number generator must be

seeded prior to calling DH_generate_parameters().

seeded before calling it.

The parameters generated by DH_generate_parameters_ex() should not be used in

signature schemes.

B<prime_len> is the length in bits of the safe prime to be generated.

B<generator> is a small number E<gt> 1, typically 2 or 5.

of the key generation. If B<cb> is not B<NULL>, it will be

called as described in L<BN_generate_prime(3)> while a random prime

number is generated, and when a prime has been found, B<BN_GENCB_call(cb, 3, 0)>

is called. See L<BN_generate_prime(3)> for information on

is called. See L<BN_generate_prime_ex(3)> for information on

the BN_GENCB_call() function.

DH_generate_parameters() is similar to DH_generate_prime_ex() but

expects an old-style callback function; see

L<BN_generate_prime(3)> for information on the old-style callback.

DH_check_params() confirms that the B<p> and B<g> are likely enough to

be valid.

This is a lightweight check, if a more thorough check is needed, use

DH_generate_parameters_ex(), DH_check() and DH_check_params() return 1

if the check could be performed, 0 otherwise.

DH_generate_parameters() (deprecated) returns a pointer to the DH structure, or

NULL if the parameter generation fails.

DH_generate_parameters() returns a pointer to the DH structure or NULL if

the parameter generation fails.

The error codes can be obtained by L<ERR_get_error(3)>.

=head1 NOTES

DH_generate_parameters_ex() and DH_generate_parameters() may run for several

hours before finding a suitable prime.

The parameters generated by DH_generate_parameters_ex() and DH_generate_parameters()

are not to be used in signature schemes.

=head1 SEE ALSO

L<DH_new(3)>, L<ERR_get_error(3)>, L<RAND_bytes(3)>,

L<DH_free(3)>

=head1 HISTORY

DH_generate_parameters() was deprecated in OpenSSL version 0.9.8; use

DH_generate_parameters_ex() instead.

=head1 COPYRIGHT

Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved.

=head1 SEE ALSO

L<DSA_new(3)>, L<ERR_get_error(3)>, L<RAND_bytes(3)>,

L<DSA_generate_parameters(3)>

L<DSA_generate_parameters_ex(3)>

=head1 COPYRIGHT