Add gnutls_psk_set_server_credentials_hint.

2 files changed, 30 insertions, 2 deletions

diff --git a/lib/auth_psk.h b/lib/auth_psk.h
index ba68b09a62..c71ec15ff9 100644
--- a/lib/auth_psk.h
+++ b/lib/auth_psk.h
@@ -49,6 +49,9 @@ typedef struct gnutls_psk_server_credentials_st
    * parameters.
    */
   gnutls_params_function *params_func;
+
+  /* Identity hint. */
+  char *hint;
 } psk_server_cred_st;
 
 /* these structures should not use allocated data */
diff --git a/lib/gnutls_psk.c b/lib/gnutls_psk.c
index e29bd2a5c7..fb09279682 100644
--- a/lib/gnutls_psk.c
+++ b/lib/gnutls_psk.c
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2005, 2007 Free Software Foundation
+ * Copyright (C) 2005, 2007, 2008 Free Software Foundation
  *
  * Author: Nikos Mavrogiannopoulos
  *
@@ -220,6 +220,31 @@ gnutls_psk_set_server_credentials_file (gnutls_psk_server_credentials_t
   return 0;
 }
 
+/**
+ * gnutls_psk_set_server_credentials_hint - Set a identity hint, in a %gnutls_psk_server_credentials_t structure
+ * @res: is an #gnutls_psk_server_credentials_t structure.
+ * @hint: is the PSK identity hint string
+ *
+ * This function sets the identity hint, in a
+ * %gnutls_psk_server_credentials_t structure.  This hint is sent to
+ * the client to help it chose a good PSK credential (i.e., username
+ * and password).
+ *
+ * Returns: %GNUTLS_E_SUCCESS on success, or an error code.
+ **/
+int
+gnutls_psk_set_server_credentials_hint (gnutls_psk_server_credentials_t res,
+					const char *hint)
+{
+  res->hint = gnutls_strdup (hint);
+  if (res->hint == NULL)
+    {
+      gnutls_assert ();
+      return GNUTLS_E_MEMORY_ERROR;
+    }
+
+  return 0;
+}
 
 /**
   * gnutls_psk_set_server_credentials_function - Used to set a callback to retrieve the user's PSK credentials
@@ -261,7 +286,7 @@ gnutls_psk_set_server_credentials_function (gnutls_psk_server_credentials_t
   * int (*callback)(gnutls_session_t, char** username,
   *  gnutls_datum_t* key);
   *
-  * The @username and @key must be allocated using gnutls_malloc().
+  * The @username and @key->data must be allocated using gnutls_malloc().
   * @username should be ASCII strings or UTF-8 strings prepared using
   * the "SASLprep" profile of "stringprep".
   *