sasl_client_new - Create a new client authentication
object
SYNOPSIS
#include <sasl.h>
int sasl_client_new(const char *service,
const char *serverFQDN,
const sasl_callback_t *prompt_supp,const,
int secflags,
sasl_conn_t ** pconn);
DESCRIPTION
sasl_client_new() creates a new SASL context. This context
will be used for all SASL calls for one connection. It
handles both authentication and integrity/encyption layers
after authentication.
service is the registered name of the service (usually the
protocol name) using SASL (e.g. "imap"). serverFQDN is
the fully qualified domain name of the server (e.g.
"serverhost.cmu.edu"). prompt_supp is a list of client
interactions supported that is unique to this connection.
If this parameter is NULL the global callbacks (specified
in sasl_client_init) will be used. See sasl_callback for
more information. secflags XXX security flags (see above)
pconn is the conection context allocated by the library.
This structure will be used for all future SASL calls for
this connection.
RETURN VALUE
sasl_client_new 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
not enough memory to complete operation
CONFORMING TO
RFC 2222
SEE ALSO
othersaslstuff
Man(1) output converted with
man2html