Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sasl_listmech(3sasl) [sunos man page]

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)

Check Out this Related Man Page

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

NAME

       sasl_chalprompt_t - prompt for input in response to a challenge

SYNOPSIS

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

       int  sasl_chalprompt_t(void  *context,  int  id,  const	char  *challenge,  const char *prompt, const char *defresult, const char **result,
       unsigned *len);

DESCRIPTION

       Use the sasl_chalprompt_t() callback interface to prompt for input in response to a server challenge.

PARAMETERS

       context	       The context from the callback record.

       id	       The callback id. id can have a value of SASL_CB_ECHOPROMPT or SASL_CB_NOECHOPROMPT

       challenge       The server's challenge.

       prompt	       A prompt for the user.

       defresult       The default result. The value of defresult can be NULL

       result	       The user's response. result is a null-terminated string.

       len	       The length of the user's response.

RETURN VALUES

       Like other SASL callback functions, sasl_chalprompt_t() returns an integer that corresponds to a SASL error code. See <sasl.h> for  a  com-
       plete list of SASL error codes.

ERRORS

       SASL_OK	       The call to sasl_chalprompt_t() 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), sasl_server_new(3SASL), attributes(5)

SunOS 5.10							    14 Oct 2003 					  sasl_chalprompt_t(3SASL)
Man Page