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)