sasl_client_init(3)

sasl_client_init(21 June 2001MISC. REFERENCE MANUAL PAGEsasl_client_init(21 June 2001)

NAME

     sasl_client_init - SASL client authentication initialization

SYNOPSIS

     #include <sasl/sasl.h>

     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 initializes
     all SASL client drivers  (e.g.  authentication  mechanisms).
     These  are usually found in the /usr/lib/sasl2 directory but
     the directory may be overridden with the SASL_PATH  environ-
     ment variable.

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

RETURN VALUE

     sasl_client_init returns an integer which corresponds to one
     of  the  following codes. SASL_OK is the only one that indi-
     cates 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          Last change: SASL                       1