2017-10-07 20:42:05 +08:00
|
|
|
=pod
|
|
|
|
|
|
|
|
|
|
=head1 NAME
|
|
|
|
|
|
2020-04-20 09:07:38 +08:00
|
|
|
DH_new_by_nid, DH_get_nid - create or get DH named parameters
|
2017-10-07 20:42:05 +08:00
|
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
|
|
|
|
#include <openssl/dh.h>
|
2020-02-03 17:05:31 +08:00
|
|
|
|
2021-12-02 19:33:49 +08:00
|
|
|
The following functions have been deprecated since OpenSSL 3.0, and can be
|
|
|
|
|
hidden entirely by defining B<OPENSSL_API_COMPAT> with a suitable version value,
|
|
|
|
|
see L<openssl_user_macros(7)>:
|
2020-02-03 17:05:31 +08:00
|
|
|
|
2022-08-01 19:08:45 +08:00
|
|
|
DH *DH_new_by_nid(int nid);
|
|
|
|
|
|
2020-04-20 09:07:38 +08:00
|
|
|
int DH_get_nid(const DH *dh);
|
2017-10-07 20:42:05 +08:00
|
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
|
|
|
|
|
DH_new_by_nid() creates and returns a DH structure containing named parameters
|
|
|
|
|
B<nid>. Currently B<nid> must be B<NID_ffdhe2048>, B<NID_ffdhe3072>,
|
2020-01-31 06:18:46 +08:00
|
|
|
B<NID_ffdhe4096>, B<NID_ffdhe6144>, B<NID_ffdhe8192>,
|
|
|
|
|
B<NID_modp_1536>, B<NID_modp_2048>, B<NID_modp_3072>,
|
|
|
|
|
B<NID_modp_4096>, B<NID_modp_6144> or B<NID_modp_8192>.
|
|
|
|
|
|
2017-10-07 20:42:05 +08:00
|
|
|
DH_get_nid() determines if the parameters contained in B<dh> match
|
2020-03-07 05:47:58 +08:00
|
|
|
any named safe prime group. It returns the NID corresponding to the matching
|
|
|
|
|
parameters or B<NID_undef> if there is no match.
|
|
|
|
|
This function is deprecated.
|
2017-10-07 20:42:05 +08:00
|
|
|
|
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
|
|
|
|
|
|
DH_new_by_nid() returns a set of DH parameters or B<NULL> if an error occurred.
|
|
|
|
|
|
2020-03-07 05:47:58 +08:00
|
|
|
DH_get_nid() returns the NID of the matching set of parameters for p and g
|
|
|
|
|
and optionally q, otherwise it returns B<NID_undef> if there is no match.
|
2017-10-07 20:42:05 +08:00
|
|
|
|
2020-02-03 17:05:31 +08:00
|
|
|
=head1 HISTORY
|
|
|
|
|
|
2022-08-01 19:08:45 +08:00
|
|
|
All of these functions were deprecated in OpenSSL 3.0.
|
2020-02-03 17:05:31 +08:00
|
|
|
|
2017-10-07 20:42:05 +08:00
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
|
2020-01-31 06:18:46 +08:00
|
|
|
Copyright 2017-2020 The OpenSSL Project Authors. All Rights Reserved.
|
2017-10-07 20:42:05 +08:00
|
|
|
|
2018-12-06 21:04:44 +08:00
|
|
|
Licensed under the Apache License 2.0 (the "License"). You may not use
|
2017-10-07 20:42:05 +08:00
|
|
|
this file except in compliance with the License. You can obtain a copy
|
|
|
|
|
in the file LICENSE in the source distribution or at
|
|
|
|
|
L<https://www.openssl.org/source/license.html>.
|
|
|
|
|
|
|
|
|
|
=cut
|
