opensolaris man page for sasl_server_userdb_setpass_t

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

NAME
       sasl_server_userdb_setpass_t - user database plaintext password setting callback function

SYNOPSIS
       cc [ flag ... ] file ... -lsasl	 [ library ... ]
       #include <sasl/sasl.h>

       int sasl_server_userdb_setpass_t(sasl_conn_t *conn, void *context,
	    const char *user, const char *pass, unsigned passlen, struct propctx *propctx,
	    unsigned flags);

DESCRIPTION
       Use  the  sasl_server_userdb_setpass_t()  callback function to store or change a a plaintext password in the callback supplier's user data-
       base.

PARAMETERS
       conn	  The SASL connection context.

       context	  The context from the callback record.

       user	  A null-terminated user name with user@realm syntax.

       pass	  The password to check. This string cannot be null-terminated.

       passlen	  The length of pass.

       propctx	  Auxiliary properties. The value of propctx is not stored.

       flags	  See sasl_setpass(3SASL). sasl_server_userdb_setpass_t() uses the same flags that are passed to sasl_setpass().

RETURN VALUES
       Like other SASL callback functions, sasl_server_userdb_setpass_t() returns an integer that corresponds to a SASL error code.  See  <sasl.h>
       for a complete list of SASL error codes.

ERRORS
       SASL_OK	  The call to sasl_server_userdb_setpass_t() 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_setpass(3SASL), attributes(5)

SunOS 5.11							    27 Oct 2003 			       sasl_server_userdb_setpass_t(3SASL)