sasl_listmech(3) [suse man page]

sasl_listmech(10 July 2001)											       sasl_listmech(10 July 2001)

NAME

       sasl_listmech - Retrieve a list of the supported SASL mechanisms

SYNOPSIS

       #include <sasl/sasl.h>

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

DESCRIPTION

       sasl_listmech()	returns  a string listing the SASL names of all the mechanisms available to the specified user. This is typically given to
       the client through a capability command or initial server response. Client applications need this list so that they  know  what	mechanisms
       the server supports.

       conn  the  SASL	context  for  this  connection	user  (optional) restricts the mechanism list to only those available to the user.  prefix
       appended to beginning of result sep appended between mechanisms suffix appended to end of  result  result  NULL	terminated  result  string
       (allocated/freed  by  library)  plen length of result filled in by library. May be NULL pcount Number of mechanisms available (filled in by
       library). May be NULL

       Example:

       sasl_listmech(conn,NULL,"(",",",")",&mechlist,NULL,NULL);

       may give the string
       (ANONYMOUS,KERBEROS_V4,DIGEST-MD5)
       as a result

RETURN VALUE

       Returns SASL_OK on success. SASL error code on failure.

CONFORMING TO

       RFC 2222

SEE ALSO

       sasl(3), sasl_errors(3), sasl_server_new(3), sasl_client_new(3)

SASL man pages							       SASL					       sasl_listmech(10 July 2001)

sasl_listmech(3SASL)			      Simple Authentication Security Layer Library Functions			      sasl_listmech(3SASL)

NAME

       sasl_listmech - retrieve a list of the supported SASL mechanisms

SYNOPSIS

       cc [ flag ... ] file ... -lsasl	 [ library ... ]
       #include <sasl/sasl.h>

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

DESCRIPTION

       The sasl_listmech() 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 applications need this list so that they know
       what mechanisms the server supports.

PARAMETERS

       conn	       The SASL context for this connection user restricts 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 NULL, and it is not used if called
		       by the client application.

       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 NULL.

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

RETURN VALUES

       sasl_listmech() returns an integer that corresponds to a SASL error code.

ERRORS

       SASL_OK	       The call to sasl_listmech() was successful.

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

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWlibsasl		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       sasl_errors(3SASL), attributes(5)

SunOS 5.10							    14 Oct 2003 					      sasl_listmech(3SASL)