1SASL_SETPASS(3)                   Cyrus SASL                   SASL_SETPASS(3)
2
3
4

NAME

6       sasl_setpass - Cyrus SASL documentation
7

SYNOPSIS

9       #include <sasl/sasl.h>
10
11       int sasl_setpass(sasl_conn_t *conn,
12                        const char *user,
13                        const char *pass, unsigned passlen,
14                         const char *oldpass, unsigned oldpasslen,
15                         unsigned flags)
16

DESCRIPTION

18       int sasl_setpass(sasl_conn_t *conn,
19
20       const char *user,
21
22       const char *pass, unsigned passlen,
23
24       const char *oldpass, unsigned oldpasslen,
25
26       unsigned flags)
27              sasl_setpass  will  set passwords in the sasldb, and trigger the
28              setpass callbacks for all available mechanisms.
29
30              Parameters
31
32                     • conn – is the SASL connection context
33
34                     • user – is the username to set the password for
35
36                     • pass – the password to set
37
38                     • passlen – length of the password to set (pass)
39
40                     • oldpass – optional. The old password.
41
42                     • oldpasslen – optional. The old password length.
43
44                     • flags –
45
46                       are flags including SASL_SET_CREATE  and  SASL_SET_DIS‐
47                       ABLE (to cause the creating of nonexistent accounts and
48                       the disabling of an account, respectively)
49
50                       oldpass and oldpasslen are unused in the Cyrus SASL im‐
51                       plementation,  though  are  passed on to any mechanisms
52                       that may require them.
53
54

RETURN VALUE

56       SASL  callback  functions should return SASL return codes.  See  sasl.h
57       for a complete list. SASL_OK indicates success.
58
59       Other return codes indicate errors and should be handled.
60

SEE ALSO

62       RFC 4422,:saslman:sasl(3), sasl_errors(3), sasl_checkpass(3)
63

AUTHOR

65       The Cyrus Team
66

68       1993-2016, The Cyrus Team
69
70
71
72
732.1.28                         February 18, 2022               SASL_SETPASS(3)
Impressum