xstep.c File Reference

#include "internal.h"

Go to the source code of this file.

Functions
int	gsasl_step (Gsasl_session *sctx, const char *input, size_t input_len, char **output, size_t *output_len)
int	gsasl_step64 (Gsasl_session *sctx, const char *b64input, char **b64output)

---

Function Documentation

int gsasl_step	(	Gsasl_session *	sctx,
		const char *	input,
		size_t	input_len,
		char **	output,
		size_t *	output_len
	)

gsasl_step:

Parameters:

	sctx	libgsasl session handle.
	input	input byte array.
	input_len	size of input byte array.
	output	newly allocated output byte array.
	output_len	pointer to output variable with size of output byte array.

Perform one step of SASL authentication. This reads data from the other end (from and ), processes it (potentially invoking callbacks to the application), and writes data to server (into newly allocated variable and that indicate the length of ).

The contents of the buffer is unspecified if this functions returns anything other than GSASL_OK or GSASL_NEEDS_MORE. If this function return GSASL_OK or GSASL_NEEDS_MORE, however, the buffer is allocated by this function, and it is the responsibility of caller to deallocate it by calling free ().

Return value: Returns GSASL_OK if authenticated terminated successfully, GSASL_NEEDS_MORE if more data is needed, or error code.

Definition at line 51 of file xstep.c.

References Gsasl_mechanism::client, Gsasl_session::clientp, Gsasl_session::mech, Gsasl_session::mech_data, Gsasl_mechanism::server, and Gsasl_mechanism_functions::step.

Referenced by gsasl_step64().

int gsasl_step64	(	Gsasl_session *	sctx,
		const char *	b64input,
		char **	b64output
	)

gsasl_step64:

Parameters:

	sctx	libgsasl client handle.
	b64input	input base64 encoded byte array.
	b64output	newly allocated output base64 encoded byte array.

This is a simple wrapper around gsasl_step() that base64 decodes the input and base64 encodes the output.

The contents of the buffer is unspecified if this functions returns anything other than GSASL_OK or GSASL_NEEDS_MORE. If this function return GSASL_OK or GSASL_NEEDS_MORE, however, the buffer is allocated by this function, and it is the responsibility of caller to deallocate it by calling free ().

Return value: Returns GSASL_OK if authenticated terminated successfully, GSASL_NEEDS_MORE if more data is needed, or error code.

Definition at line 86 of file xstep.c.

References GSASL_BASE64_ERROR, gsasl_base64_from(), gsasl_base64_to(), GSASL_NEEDS_MORE, GSASL_OK, and gsasl_step().

---