opensolaris man page for sasl_setpass

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)