


sasl_setpass(10 July 2001)             sasl_setpass(10 July 2001)


NAME
       sasl_setpass - Check a plaintext password

SYNOPSIS
       #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
       sasl_setpass  will set passwords in the sasldb, and trigger the setpass
       callbacks for all available mechanisms.

       user is the username to set the password for.

       pass and passlen are the password to set and its length

       oldpass and oldpasslen are the old  password  &  its  length  (and  are
       optional)

       flags  Are  flags  including  SASL_SET_CREATE  and SASL_SET_DISABLE (to
       cause the creating of nonexistent accounts  and  the  disabling  of  an
       account, respectively)


NOTES
       oldpass  and  oldpasslen  are  unused in the Cyrus SASL implementation,
       though are passed on to any mechanisms that may require them.


RETURN VALUE
       Returns SASL_OK on success. SASL error code on failure.


CONFORMING TO
       RFC 2222

SEE ALSO
       sasl(3), sasl_errors(3), sasl_checkpass(3)














SASL man pages                 SASL                             1


