sasl_client_init(21 June 2001) sasl_client_init(21 June 2001)
NAMEsasl_client_init - SASL client authentication initializa-
tion
SYNOPSIS
#include <sasl/sasl.h>
int sasl_client_init(const sasl_callback_t *callbacks);
DESCRIPTIONsasl_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/sasl
directory but the directory may be overriden with the
SASL_PATH enviornment variable.
callbacks specifies the base callbacks for all client con-
nections. See the sasl_callbacks man page for more infor-
mation
RETURN VALUEsasl_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 ALSOsasl(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)