Simple Authentication Security Layer Library Functions
                                          saslgetsimplet(3SASL)



NAME
     saslgetsimplet - the SASL callback function for  username,
     authname and realm

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

     int saslgetsimplet(void *context, int id, const char **result,
          unsigned *len);


DESCRIPTION
     Use the saslgetsimplet()  callback  function  to  retrieve
     simple  data from the application such as the authentication
     name, the authorization name, and the realm. The id  parame-
     ter indicates which value is requested.

PARAMETERS
     context    The context from the callback structure.


     id         The callback ID. Possible values for id include:

                SASLCBUSER        Client  user   identity   for
                                    login.


                SASLCBAUTHNAME    Client authentication name.


                SASLCBLANGUAGE    Comma-separated    list    of
                                    languages   pursuant  to  RFC
                                    1766.


                SASLCBCNONCE      The client-nonce. This  value
                                    is  used  primarily for test-
                                    ing.



     result     To cancel user, set the value of  result  with  a
                null-terminated string. If the value of result is
                NUL, then the user is cancelled.


     len        The length of result.






SunOS 5.11          Last change: 27 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                          saslgetsimplet(3SASL)



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

ERORS
     SASLOK    The call to saslgetsimplet() 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), attributes(5)


     Alvestrand, H. RFC 1766,  Tags  for  the  Identification  of
     Languages. Network Working Group. November 1995.



















SunOS 5.11          Last change: 27 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                          saslgetsimplet(3SASL)






















































SunOS 5.11          Last change: 27 Oct 2003                    3