sasl_canon_user_t - Cyrus SASL documentation

       The Cyrus Team

RFC4422

       1993-2016, The Cyrus Team

2.1.28                                             2025-02-28                               SASL_CANON_USER_T(3)

intsasl_canon_user_t(sasl_conn_t*conn,void*context,constchar*user,unsignedulen,unsignedflags,constchar*user_realm,char*out_user,unsignedout_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

              ReturnsSASL_OK indicates success. See sasl_errors(3) for a full list of SASL error codes.

       sasl_canon_user_t - Cyrus SASL documentation

sasl(3), sasl_errors(3), sasl_callbacks(3)

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