sasl_client_init

Section: SASL man pages (3)
Updated: 21 June 2001
Index Return to Main Contents

---

 

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

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 4422  

SEE ALSO

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

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

RETURN VALUE

ERRORS

CONFORMING TO

SEE ALSO