Content-type: text/html Man page of sasl_listmech

sasl_listmech

Section: Simple Authentication Security Layer Library Functions (3SASL)
Updated: 14 Oct 2003
Index Return to Main Contents
 

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 TYPEATTRIBUTE VALUE
AvailabilitySUNWlibsasl
Interface StabilityEvolving
MT-LevelMT-Safe

 

SEE ALSO

sasl_errors(3SASL), attributes(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
PARAMETERS
RETURN VALUES
ERRORS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:13 GMT, October 02, 2010