summaryrefslogtreecommitdiff
path: root/lib/psk.c
diff options
context:
space:
mode:
authorNikos Mavrogiannopoulos <nmav@redhat.com>2017-08-22 08:48:03 +0200
committerNikos Mavrogiannopoulos <nmav@redhat.com>2017-08-22 08:55:37 +0200
commit356674a7ceaa4c4ecb3f478d0d3b3cc682a1540c (patch)
treeadec29efbc92e162b19e8725ea69b7011ec3692f /lib/psk.c
parent8152376033d28c65c43006d3536e124a88441464 (diff)
downloadgnutls-356674a7ceaa4c4ecb3f478d0d3b3cc682a1540c.tar.gz
dh params: document DH param setting functions as deprecated
They are no longer useful after the RFC7919 DH parameter negotiation. Signed-off-by: Nikos Mavrogiannopoulos <nmav@redhat.com>
Diffstat (limited to 'lib/psk.c')
-rw-r--r--lib/psk.c19
1 files changed, 19 insertions, 0 deletions
diff --git a/lib/psk.c b/lib/psk.c
index b8c27ee3e0..34083c8de7 100644
--- a/lib/psk.c
+++ b/lib/psk.c
@@ -371,6 +371,11 @@ const char *gnutls_psk_client_get_hint(gnutls_session_t session)
* This function will set the Diffie-Hellman parameters for an
* anonymous server to use. These parameters will be used in
* Diffie-Hellman exchange with PSK cipher suites.
+ *
+ * Deprecated: This function is unnecessary and discouraged on GnuTLS 3.6.0
+ * or later. Since 3.6.0, DH parameters are negotiated
+ * following RFC7919.
+ *
**/
void
gnutls_psk_set_server_dh_params(gnutls_psk_server_credentials_t res,
@@ -396,6 +401,10 @@ gnutls_psk_set_server_dh_params(gnutls_psk_server_credentials_t res,
* Ephemeral Diffie-Hellman cipher suites and will be selected from
* the FFDHE set of RFC7919 according to the security level provided.
*
+ * Deprecated: This function is unnecessary and discouraged on GnuTLS 3.6.0
+ * or later. Since 3.6.0, DH parameters are negotiated
+ * following RFC7919.
+ *
* Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise a
* negative error value.
*
@@ -418,6 +427,11 @@ gnutls_psk_set_server_known_dh_params(gnutls_psk_server_credentials_t res,
* This function will set a callback in order for the server to get
* the Diffie-Hellman parameters for PSK authentication. The callback
* should return %GNUTLS_E_SUCCESS (0) on success.
+ *
+ * Deprecated: This function is unnecessary and discouraged on GnuTLS 3.6.0
+ * or later. Since 3.6.0, DH parameters are negotiated
+ * following RFC7919.
+ *
**/
void
gnutls_psk_set_server_params_function(gnutls_psk_server_credentials_t res,
@@ -434,6 +448,11 @@ gnutls_psk_set_server_params_function(gnutls_psk_server_credentials_t res,
* This function will set a callback in order for the server to get
* the Diffie-Hellman or RSA parameters for PSK authentication. The
* callback should return %GNUTLS_E_SUCCESS (0) on success.
+ *
+ * Deprecated: This function is unnecessary and discouraged on GnuTLS 3.6.0
+ * or later. Since 3.6.0, DH parameters are negotiated
+ * following RFC7919.
+ *
**/
void
gnutls_psk_set_params_function(gnutls_psk_server_credentials_t res,