Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gnutls_psk_set...tials_function3(3)  gnutls  gnutls_psk_set...tials_function3(3)

NAME
     gnutls_psk_set_client_credentials_function3 - API function

SYNOPSIS
     #include <gnutls/gnutls.h>

     void  gnutls_psk_set_client_credentials_function3(gnutls_psk_client_creden-
     tials_t cred, gnutls_psk_client_credentials_function3 * func);

ARGUMENTS
     gnutls_psk_client_credentials_t cred
		 is a gnutls_psk_server_credentials_t type.

     gnutls_psk_client_credentials_function3 * func
		 is the callback function

DESCRIPTION
     This function can be used to set a callback to retrieve  the  username  and
     password  for  client PSK authentication.	The callback's function form is:
     int (*callback)(gnutls_session_t, gnutls_datum_t* username, gnutls_datum_t*
     key, gnutls_datum_t* context, gnutls_psk_key_flags *flags);

     This   callback   function   has	the   same   semantics	 as   that    of
     gnutls_psk_set_client_credentials_function2(), but it returns flags associ-
     ated  with  the key.  The callback may import external PSK using the method
     described in RFC 9258 by using gnutls_psk_format_imported_identity().

     The data field of	username ,  key , and  context must be	allocated  using
     gnutls_malloc().	The  username should be an ASCII string or UTF-8 string.
     In case of a UTF-8 string it is recommended  to  be  following  the  PRECIS
     framework for usernames (rfc8265).

     The callback function will be called once per handshake.

     The callback function should return 0 on success.	-1 indicates an error.

REPORTING BUGS
     Report bugs to <bugs@gnutls.org>.
     Home page: https://www.gnutls.org

COPYRIGHT
     Copyright (C) 2001-2023 Free Software Foundation, Inc., and others.
     Copying  and  distribution  of this file, with or without modification, are
     permitted in any medium without royalty provided the copyright  notice  and
     this notice are preserved.

SEE ALSO
     The  full	documentation  for gnutls is maintained as a Texinfo manual.  If
     the /usr/local/share/doc/gnutls/ directory does not contain the  HTML  form
     visit

     https://www.gnutls.org/manual/

gnutls				     3.8.13  gnutls_psk_set...tials_function3(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnutls_psk_set_client_credentials_function3&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help