Manual Pages for UNIX Operating System command usage for man sasl_checkpass

Simple Authentication Security Layer Library Functions
                                            sasl_checkpass(3SASL)



NAME
     sasl_checkpass - check a plaintext password

SYNOPSIS
     cc [ flag ... ] file ... -lsasl   [ library ... ]
     #include 

     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  com-
     mand   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  reposi-
     tories  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






SunOS 5.11          Last change: 14 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                            sasl_checkpass(3SASL)



     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  attri-
     butes:



     _______________________________________________________________
    |       ATTRIBUTE TYPE        |         ATTRIBUTE VALUE        |
    |_____________________________|________________________________|
    | Availability                | system/library/security/libsasl|
    |_____________________________|________________________________|
    | Interface Stability         | Committed                      |
    |_____________________________|________________________________|
    | MT-Level                    | Safe                           |
    |_____________________________|________________________________|


SEE ALSO
     sasl_errors(3SASL), attributes(5)
















SunOS 5.11          Last change: 14 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                            sasl_checkpass(3SASL)






















































SunOS 5.11          Last change: 14 Oct 2003                    3