Manual Pages for UNIX Operating System command usage for man sasl_canon_user_t

Simple Authentication Security Layer Library Functions
                                         sasl_canon_user_t(3SASL)



NAME
     sasl_canon_user_t - the canon user callback

SYNOPSIS
     cc [ flag ... ] file ... -lsasl   [ library ... ]
     #include 

     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
     The sasl_canon_user_t() interface is the  callback  function
     for  an  application-supplied  user canonical function. This
     function is subject to the  requirements  of  all  canonical
     functions.  It must copy the result into the output buffers,
     but the output buffers and the  input  buffers  can  be  the
     same.

PARAMETERS
     conn          The SASL connection context.


     context       The context from the callback record.


     user          User name. The form of user is not canonical.


     ulen          Length of user. The form of ulen is not canon-
                   ical.


     flags         One of the following values, or a  bitwise  OR
                   of both:

                   SASL_CU_AUTHID     Indicates  the  authentica-
                                      tion ID is canonical


                   SASL_CU_AUTHZID    Indicates the authorization
                                      ID is canonical



     user_realm    Realm of authentication.


     out_user      The output buffer for the user name.




SunOS 5.11          Last change: 27 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                         sasl_canon_user_t(3SASL)



     out_max       The maximum length for the user name.


     out_len       The actual length for the user name.


RETURN VALUES
     Like  other  SASL  callback  functions,  sasl_canon_user_t()
     returns  an  integer  that corresponds to a SASL error code.
     See  for a complete list of SASL error codes.

ERRORS
     SASL_OK    The call to sasl_canon_user_t() was successful.



     See sasl_errors(3SASL) for information on SASL error codes.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     _______________________________________________________________
    |       ATTRIBUTE TYPE        |         ATTRIBUTE VALUE        |
    |_____________________________|________________________________|
    | Availability                | system/library/security/libsasl|
    |_____________________________|________________________________|
    | Interface Stability         | Committed                      |
    |_____________________________|________________________________|
    | MT-Level                    | MT-Safe                        |
    |_____________________________|________________________________|


SEE ALSO
     sasl_errors(3SASL), sasl_server_new(3SASL), attributes(5)

















SunOS 5.11          Last change: 27 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                         sasl_canon_user_t(3SASL)






















































SunOS 5.11          Last change: 27 Oct 2003                    3