SASL_SETPASS(3SASL) Simple Authentication Security Layer Library Functions
NAME
sasl_setpass - set the password for a user
SYNOPSIS
cc [
flag ... ]
file ...
-lsasl [
library ... ]
#include <sasl/sasl.h>
int sasl_setpass(
sasl_conn_t *conn,
const char *user,
const char *pass,
unsigned passlen,
const char *oldpass,
unsigned oldpasslen,
unsigned flags);
DESCRIPTION
Use the
sasl_setpass() interface to set passwords.
sasl_setpass() uses the
SASL_CB_SERVER_USERDB_SETPASS callback, if one is supplied.
Additionally, if any server mechanism plugins supply a setpass
callback, the setpass callback would be called. None of the server
mechanism plugins currently supply a setpass callback.
PARAMETERS
conn The SASL connection context
user The username for which the password is set
pass The password to set
passlen The length of
pass oldpass The old password, which is optional
oldpasslen The length of
oldpass, which is optional
flags Refers to flags, including,
SASL_SET_CREATE and
SASL_SET_DISABLE. Use these flags to create and
disable accounts.
RETURN VALUES
sasl_setpass() returns an integer that corresponds to a SASL error
code.
ERRORS
SASL_OK The call to
sasl_setpass() was successful.
See
sasl_errors(3SASL) for information on SASL error codes.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
SEE ALSO
sasl_errors(3SASL),
sasl_getprop(3SASL),
attributes(7) October 15, 2003 SASL_SETPASS(3SASL)
