NAME

       gnutls_psk_set_server_credentials_function3 - API function

SYNOPSIS

       #include <gnutls/gnutls.h>

       void   gnutls_psk_set_server_credentials_function3(gnutls_psk_server_credentials_t   cred,
       gnutls_psk_server_credentials_function3 func);

ARGUMENTS

       gnutls_psk_server_credentials_t cred
                   is a gnutls_psk_server_credentials_t type.

       gnutls_psk_server_credentials_function3 func
                   is the callback function

DESCRIPTION

       This function can be used to set a callback to retrieve the user's PSK  credentials.   The
       callback's  function  form  is:  int  (*callback)(gnutls_session_t,  const gnutls_datum_t*
       username, gnutls_datum_t* key, gnutls_psk_key_flags *flags);

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

        username   contains  the  actual  username.   The   key  must  be  filled  in  using  the
       gnutls_malloc().

       In case the callback returned a negative number then gnutls will assume that the  username
       does not exist.

       The  callback  function  will  only  be  called once per handshake.  The callback function
       should return 0 on success, while -1 indicates an error.

REPORTING BUGS

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

COPYRIGHT

       Copyright © 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/share/doc/gnutls/ directory does not contain the HTML form visit

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