sasl_server_init

Section: Misc. Reference Manual Pages (10 July 2001)
Updated: SASL
Index Return to Main Contents

NAME

sasl_server_init - SASL server authentication initialization

SYNOPSIS

#include <sasl/sasl.h>

int sasl_server_init(const sasl_callback_t *callbacks, 
                     const char *appname);

DESCRIPTION

sasl_server_init() initializes SASL. It must be called before any calls to sasl_server_start, and only once per process. This call initializes all SASL mechanism 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 (or at compile time).

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

appname is the name of the application. It is used for where to find the default configuration file.

RETURN VALUE

sasl_server_init returns an integer which corresponds to one of the SASL error 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.

CONFORMING TO