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_server_userdb_checkpass_t(3SASL)	      Simple Authentication Security Layer Library Functions	     sasl_server_userdb_checkpass_t(3SASL)

NAME

       sasl_server_userdb_checkpass_t - plaintext password verification callback function

SYNOPSIS

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

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

DESCRIPTION

       Use the sasl_sasl_server_userdb_checkpass_t() callback function to verify a plaintext password against the callback supplier's  user  data-
       base. Verification allows additional ways to encode the userPassword property.

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	       The property context to fill in with userPassword.

RETURN VALUES

       Like other SASL callback functions, sasl_server_userdb_checkpass_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_checkpass_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), attributes(5)

SunOS 5.10							    27 Oct 2003 			     sasl_server_userdb_checkpass_t(3SASL)
Man Page