Simple Authentication Security Layer Library Functions
                                             sasllistmech(3SASL)



NAME
     sasllistmech -  retrieve  a  list  of  the  supported  SASL
     mechanisms

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

     int sasllistmech(saslconnt *conn, const char *user, const char *prefix,
          const char *sep, const char *suffix, const char **result,
          unsigned *plen,int *pcount);


DESCRIPTION
     The sasllistmech() interface returns a string  listing  the
     SASL  names of all the mechanisms available to the specified
     user. This call is typically given to the client  through  a
     capability command or initial server response. Client appli-
     cations need this list so that they know what mechanisms the
     server supports.

PARAMETERS
     conn      The SASL context for  this  connection  user  res-
               tricts  the  mechanism  list  to  those mechanisms
               available to the user. This parameter is optional.


     user      Restricts security mechanisms to  those  available
               to  that  user. The value of user may be NUL, and
               it is not used if called by  the  client  applica-
               tion.


     prefix    Appended to the beginning of result.


     sep       Appended between mechanisms.


     suffix    Appended to the end of result.


     result    A null-terminated result string.  result  must  be
               allocated or freed by the library.


     plen      The length of the result filled in by the library.
               The value of plen may be NUL.






SunOS 5.11          Last change: 14 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                             sasllistmech(3SASL)



     pcount    The number of mechanisms available. The  value  of
               pcount  is  filled in by the library. The value of
               pcount may be NUL


RETURN VALUES
     sasllistmech() returns an integer  that  corresponds  to  a
     SASL error code.

ERORS
     SASLOK    The call to sasllistmech() 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)



















SunOS 5.11          Last change: 14 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                             sasllistmech(3SASL)






















































SunOS 5.11          Last change: 14 Oct 2003                    3