Scroll to navigation

sasl_client_init(21 June 2001) sasl_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 environment variable.

callbacks specifies the base callbacks for all client connections. See the sasl_callbacks man page for more information

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

Success
Mechanism version mismatch
Error in config file
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 SASL man pages