Simple Authentication Security Layer Library Functions
                                         saslcanonusert(3SASL)



NAME
     saslcanonusert - the canon user callback

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

     int saslcanonusert(saslconnt *conn, void *context, const char *user,
          unsigned ulen, unsigned flags, const char *userrealm, char *outuser,
          unsigned *outumax, unsigned *outulen);


DESCRIPTION
     The saslcanonusert() 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:

                   SASLCUAUTHID     Indicates  the  authentica-
                                      tion ID is canonical


                   SASLCUAUTHZID    Indicates the authorization
                                      ID is canonical



     userrealm    Realm of authentication.


     outuser      The output buffer for the user name.




SunOS 5.11          Last change: 27 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                         saslcanonusert(3SASL)



     outmax       The maximum length for the user name.


     outlen       The actual length for the user name.


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

ERORS
     SASLOK    The call to saslcanonusert() was successful.



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

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWlibsasl                 
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     saslerrors(3SASL), saslservernew(3SASL), attributes(5)

















SunOS 5.11          Last change: 27 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                         saslcanonusert(3SASL)






















































SunOS 5.11          Last change: 27 Oct 2003                    3