sasl_server_step - Perform a step in the authentication
negotiation
SYNOPSIS
#include <sasl.h>
int sasl_server_step(sasl_conn_t *conn,
const char *clientin,
unsigned clientinlen,
char ** serverout,
unsigned * serveroutlen,
const char ** errstr);
DESCRIPTION
sasl_server_step() performs a step in the authentication
negotiation. It returns SASL_OK if the whole negotiation
is sucessful and SASL_CONTINUE if this step is ok but at
least one more step is needed.
errstr is sometimes returned on error and gives a mecha
nism specific reason for failure. This information should
not be given to the client.
conn is the SASL connection context clientin is the data
given by the client (decoded if the protocol encodes
requests sent over the wire) clientinlen is the length of
clientin serverout and serveroutlen is allocated by the
library and should be sent to the client.
RETURN VALUE
sasl_server_step returns an integer which corresponds to
one of the following codes. SASL_CONTINUE indicates sucess
and that there are more steps needed in the authentica
tion. SASL_OK indicates that the authentication is com
plete. All other return codes indicate errors and should
either be handled or the authentication session should be
quit.
ERRORS
SASL_OK Success. Authentication complete
SASL_CONTINUE
Success. keep going.
SASL_INTERACT
user interaction needed to fill in prompt_need
SASL_BADVERS
Mechanism version mismatch
SASL_BADPARAM
error in config file
SASL_NOMEM
not enough memory to complete operation
CONFORMING TO
RFC 2222
SEE ALSO
othersaslstuff
Man(1) output converted with
man2html