FreeBSD manual
download PDF document: sasl_getsimple_t.3.pdf
SASL_GETSIMPLE_T(3) Cyrus SASL SASL_GETSIMPLE_T(3)
NAME
sasl_getsimple_t - Cyrus SASL documentation
SYNOPSIS
#include <sasl/sasl.h>
int sasl_getsimple_t(void *context,
int id,
const char ** result,
unsigned * len);
DESCRIPTION
int sasl_getsimple_t(void *context,
int id,
const char ** result,
unsigned * len);
sasl_getsimple_t is used to retrieve simple things from the
application. In practice this is authentication name,
authorization name, and realm.
Parameters
o context - SASL connection context
o id -
indicates which value is being requested. Possible
values include:
o SASL_CB_USER - Client user identity to login as
o SASL_CB_AUTHNAME - Client authentication name
o SASL_CB_LANGUAGE - Comma-separated list of RFC 1766
languages
o SASL_CB_CNONCE - Client-nonce (for testing mostly)
o result - value of the item requested
o len - lenth of the result
RETURN VALUE
SASL callback functions should return SASL return codes. See sasl.h
for a complete list. SASL_OK indicates success.
SEE ALSO
RFC 4422,:saslman:sasl(3), sasl_callbacks(3), sasl_errors(3)
AUTHOR
The Cyrus Team