sasl_setpass(3) [debian man page]

sasl_setpass(3) 						  SASL man pages						   sasl_setpass(3)

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 4422

SEE ALSO

       sasl(3), sasl_errors(3), sasl_checkpass(3)

SASL
								   10 July 2001 						   sasl_setpass(3)

sasl_setpass(3SASL)			      Simple Authentication Security Layer Library Functions			       sasl_setpass(3SASL)

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(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWlibsasl		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       sasl_errors(3SASL), sasl_getprop(3SASL), attributes(5)

SunOS 5.11							    15 Oct 2003 					       sasl_setpass(3SASL)