Movatterモバイル変換

gnutls_srp_set_server_credentials_function(3) — Linux manual page

gnutls_srp_se...ials_function(3)  gnutlsgnutls_srp_se...ials_function(3)

NAME        top

       gnutls_srp_set_server_credentials_function - API function

SYNOPSIS        top

#include <gnutls/gnutls.h>voidgnutls_srp_set_server_credentials_function(gnutls_srp_server_credentials_tcred, gnutls_srp_server_credentials_function *func);

ARGUMENTS        top

       gnutls_srp_server_credentials_t cred                   is agnutls_srp_server_credentials_ttype.       gnutls_srp_server_credentials_function * func                   is the callback function

DESCRIPTION        top

       This function can be used to set a callback to retrieve the user's       SRP credentials.  The callback's function form is:       int (*callback)(gnutls_session_t, const char* username,       gnutls_datum_t *salt, gnutls_datum_t *verifier, gnutls_datum_t       *generator, gnutls_datum_t *prime);username contains the actual username.  Thesalt ,verifier ,generator andprime must be filled in using thegnutls_malloc().       For convenienceprime andgenerator may also be one of the       static parameters defined in gnutls.h.       Initially, the data field is NULL in everygnutls_datum_t       structure that the callback has to fill in. When the callback is       done GnuTLS deallocates all of those buffers which are non-NULL,       regardless of the return value.       In order to prevent attackers from guessing valid usernames, if a       user does not exist, g and n values should be filled in using a       random user's parameters. In that case the callback must return       the special value (1).  Seegnutls_srp_set_server_fake_salt_seed       too.  If this is not required for your application, return a       negative number from the callback to abort the handshake.       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        top

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

COPYRIGHT        top

       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        top

       The full documentation forgnutlsis maintained as a Texinfo       manual.  If the /usr/share/doc/gnutls/ directory does not contain       the HTML form visithttps://www.gnutls.org/manual/

COLOPHON        top

       This page is part of theGnuTLS (GnuTLS Transport Layer Security       Library) project.  Information about the project can be found at       ⟨http://www.gnutls.org/⟩.  If you have a bug report for this       manual page, send it to bugs@gnutls.org.  This page was obtained       from the tarball fetched from       ⟨https://www.gnupg.org/ftp/gcrypt/gnutls/⟩ on 2025-08-11.  If you       discover any rendering problems in this HTML version of the page,       or you believe there is a better or more up-to-date source for the       page, or you have corrections or improvements to the information       in this COLOPHON (which isnot part of the original manual page),       send a mail to man-pages@man7.orggnutls                            3.8.10gnutls_srp_se...ials_function(3)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.