1gnutls_srp_set_client_credentials_gfnuungtcnltusit_olsnsr(p3_)set_client_credentials_function(3)
2
3
4
6 gnutls_srp_set_client_credentials_function - API function
7
9 #include <gnutls/gnutls.h>
10
11 void gnutls_srp_set_client_credentials_function(gnutls_srp_client_cre‐
12 dentials_t cred, gnutls_srp_client_credentials_function
13 * func);
14
16 gnutls_srp_client_credentials_t cred
17 is a gnutls_srp_server_credentials_t type.
18
19 gnutls_srp_client_credentials_function * func
20 is the callback function
21
23 This function can be used to set a callback to retrieve the username
24 and password for client SRP authentication. The callback's function
25 form is:
26
27 int (*callback)(gnutls_session_t, char** username, char**password);
28
29 The username and password must be allocated using gnutls_malloc().
30
31 The username should be an ASCII string or UTF-8 string. In case of a
32 UTF-8 string it is recommended to be following the PRECIS framework for
33 usernames (rfc8265). The password can be in ASCII format, or normalized
34 using gnutls_utf8_password_normalize().
35
36 The callback function will be called once per handshake before the ini‐
37 tial hello message is sent.
38
39 The callback should not return a negative error code the second time
40 called, since the handshake procedure will be aborted.
41
42 The callback function should return 0 on success. -1 indicates an er‐
43 ror.
44
46 Report bugs to <bugs@gnutls.org>.
47 Home page: https://www.gnutls.org
48
49
51 Copyright © 2001- Free Software Foundation, Inc., and others.
52 Copying and distribution of this file, with or without modification,
53 are permitted in any medium without royalty provided the copyright no‐
54 tice and this notice are preserved.
55
57 The full documentation for gnutls is maintained as a Texinfo manual.
58 If the /usr/share/doc/gnutls/ directory does not contain the HTML form
59 visit
60
61 https://www.gnutls.org/manual/
62
63gnutls gnut3l.s7_.s2rp_set_client_credentials_function(3)