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_cre-
       dentials_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 as-
       sociated	with the key.  The callback may	import external	PSK using  the
       method  described in RFC	9258 by	using gnutls_psk_format_imported_iden-
       tity().

       The data	field of  username ,  key , and	 context must be allocated us-
       ing 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 er-
       ror.

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 no-
       tice 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.9 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+14.3.quarterly>

home | help