sasl_client_init(21 June 2001)     sasl_client_init(21 June 2001)



NAME
       sasl_client_init  - SASL client authentication initializa-
       tion



SYNOPSIS
       #include 

       int sasl_client_init(const  sasl_callback_t *callbacks);


DESCRIPTION
       sasl_client_init() initializes SASL.  It  must  be  called
       before  any calls to sasl_client_start. This call initial-
       izes all SASL client drivers (e.g.  authentication  mecha-
       nisms).  These  are  usually  found  in the /usr/lib/sasl2
       directory but the directory may  be  overridden  with  the
       SASL_PATH environment variable.

       callbacks specifies the base callbacks for all client con-
       nections. See the sasl_callbacks man page for more  infor-
       mation

RETURN VALUE
       sasl_client_init  returns  an integer which corresponds to
       one of the following codes. SASL_OK is the only  one  that
       indicates  success.  All others indicate errors and should
       either be handled or the authentication session should  be
       quit.



ERRORS
       SASL_OK Success

       SASL_BADVERS
               Mechanism version mismatch

       SASL_BADPARAM
               Error in config file

       SASL_NOMEM
               Not enough memory to complete operation


CONFORMING TO
       RFC 2222

SEE ALSO
       sasl(3),       sasl_callbacks(3),      sasl_client_new(3),
       sasl_client_start(3), sasl_client_step(3)



SASL man pages                 SASLsasl_client_init(21 June 2001)