sunos 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 mecha-
       nism 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.10							    15 Oct 2003 					       sasl_setpass(3SASL)