Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sasl_checkpass(3sasl) [sunos man page]

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

NAME

       sasl_checkpass - check a plaintext password

SYNOPSIS

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

       int sasl_checkpass(sasl_conn_t *conn, const char *user, unsigned userlen, const char *pass, unsigned passlen);

DESCRIPTION

       The  sasl_checkpass()  interface  checks a plaintext password. The sasl_checkpass() interface is used for protocols that had a login method
       before SASL, for example, the LOGIN command in IMAP. The password is checked with the pwcheck_method.

       The sasl_checkpass() interface is a server interface. You cannot use it to check passwords from a client.

       The  sasl_checkpass()  interface  checks  the  posible  repositories  until  it	succeeds  or  there   are   no	 more	repositories.	If
       sasl_server_userdb_checkpass_t is registered, sasl_checkpass() tries it first.

       Use the pwcheck_method SASL option to specify which pwcheck methods to use.

       The sasl_checkpass() interface supports the transition of passwords if the SASL option auto_transition is on.

       If user is NULL, check is plaintext passwords are enabled.

PARAMETERS

       conn	       The sasl_conn_t for which the request is being made

       pass	       Plaintext password to check

       passlen	       The length of pass

       user	       User to query in current user_domain

       userlen	       The length of username.

RETURN VALUES

       sasl_checkpass() returns an integer that corresponds to a SASL error code.

ERRORS

       SASL_OK	       Indicates that the authentication is complete

       All  other  error  codes  indicate  an  error  situation  that  must  be  handled,  or  the  authentication  session  should  be  quit. 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		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       sasl_errors(3SASL), attributes(5)

SunOS 5.10							    14 Oct 2003 					     sasl_checkpass(3SASL)

Check Out this Related Man Page

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)
Man Page