sasl_canon_user_t − Cyrus SASL documentation
#include <sasl/sasl.h>
int
sasl_canon_user_t(sasl_conn_t *conn, void *context, const
char *user, unsigned ulen,
unsigned flags, const char *user_realm, char *out_user,
unsigned out_umax, unsigned *out_ulen)
int
sasl_canon_user_t(sasl_conn_t *conn,
void *context,
const char *user,
unsigned ulen,
unsigned flags,
const char *user_realm,
char *out_user,
unsigned out_umax,
unsigned *out_ulen)
sasl_canon_user_t is the
callback for an application−supplied user
canonicalization function. This function is subject to the
requirements that all user canonicalization functions are:
It must copy the result into the output buffers, but the
output buffers and the input buffers may be the same.
Parameters
• |
context â context from the callback record | ||
• |
user â un−canonicalized username | ||
• |
ulen â length of user | ||
• |
flags â Either SASL_CU_AUTHID (indicating the authentication ID is being canonicalized) or SASL_CU_AUTHZID (indicating the authorization ID is to be canonicalized) or a bitwise OR of the the two. | ||
• |
user_realm â Realm of authentication. | ||
• |
out_user â The output buffer for the canonicalized username | ||
• |
out_umax â Maximum length for out_user | ||
• |
out_ulen â Actual length of out_user |
Returns
SASL_OK indicates success. See sasl_errors(3) for a full list of SASL error codes.
RFC 4422
sasl(3), sasl_errors(3), sasl_callbacks(3)
The Cyrus Team
1993-2016, The Cyrus Team