Simple Authentication Security Layer Library Functions
                                            saslcheckpass(3SASL)



NAME
     saslcheckpass - check a plaintext password

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

     int saslcheckpass(saslconnt *conn, const char *user, unsigned userlen,
          const char *pass, unsigned passlen);


DESCRIPTION
     The saslcheckpass() interface checks a plaintext  password.
     The  saslcheckpass()  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
     pwcheckmethod.


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


     The saslcheckpass() interface checks  the  posible  reposi-
     tories  until it succeeds or there are no more repositories.
     If     saslserveruserdbcheckpasst     is     registered,
     saslcheckpass() tries it first.


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


     The saslcheckpass() interface supports  the  transition  of
     passwords if the SASL option autotransition is on.


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

PARAMETERS
     conn       The saslconnt 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
                                            saslcheckpass(3SASL)



     user       User to query in current userdomain


     userlen    The length of username.


RETURN VALUES
     saslcheckpass() returns an integer that  corresponds  to  a
     SASL error code.

ERORS
     SASLOK    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 saslerrors(3SASL) for information on SASL error codes.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWlibsasl                 
    
     Interface Stability          Evolving                    
    
     MT-Level                     Safe                        
    


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
















SunOS 5.11          Last change: 14 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                            saslcheckpass(3SASL)






















































SunOS 5.11          Last change: 14 Oct 2003                    3