sasl_server_userdb_checkpass_t(10 July 2001)

NAME
sasl_server_userdb_checkpass_t - Plaintext Password Verification Callback

SYNOPSIS
#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)

DESCRIPTION

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.

context context from the callback record

user and ulen Un-canonicalized username (and length)

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 and out_umax and out_ulen The output buffer, max length, and actual length for the username.

RETURN VALUE
SASL callback functions should return SASL return codes. See sasl.h for a complete list. SASL_OK indicates success.

SEE ALSO
sasl(3), sasl_callbacks(3), sasl_errors(3)