SASL_SERVER_STEP(3SASL)
Simple Authentication Security Layer Library Functions

NAME

sasl_server_step - perform a step in the server authentication
negotiation

SYNOPSIS

cc [ flag ... ] file ... -lsasl [ library ... ]
#include <sasl/sasl.h>

int sasl_server_step(sasl_conn_t *conn, const char *clientin,
unsigned clientinlen, const char **serverout,
unsigned *serveroutlen);

DESCRIPTION

The sasl_server_step() performs a step in the authentication
negotiation.

PARAMETERS

conn
The SASL context for this connection.


clientin
The data given by the client. The data is decoded if
the protocol encodes requests that are sent over the
wire.


clientinlen
The length of clientin.


serverout
serveroutlen
Set by the library and sent to the client.

RETURN VALUES

sasl_server_step() returns an integer that corresponds to a SASL
error code.

ERRORS

SASL_OK
The whole authentication completed successfully.


SASL_CONTINUE
The call to sasl_server_step() was successful, and
at least one more step is needed for the
authentication.


All other error codes indicate an error situation that you must
handle, or you should quit the authentication session. See
sasl_errors(3SASL) for information on SASL error codes.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

sasl_errors(3SASL), attributes(7)

October 14, 2003 SASL_SERVER_STEP(3SASL)