1sasl_listmech(3)                SASL man pages                sasl_listmech(3)
2
3
4

NAME

6       sasl_listmech - Retrieve a list of the supported SASL mechanisms
7

SYNOPSIS

9       #include <sasl/sasl.h>
10
11
12       int sasl_listmech(sasl_conn_t *conn,
13                        const char *user,
14                        const char *prefix,
15                        const char *sep,
16                        const char *suffix,
17                        const char **result,
18                        unsigned *plen,
19                        int *pcount);
20
21

DESCRIPTION

23       sasl_listmech()  returns  a  string  listing  the SASL names of all the
24       mechanisms available to the specified user. This is typically given  to
25       the  client  through  a  capability command or initial server response.
26       Client applications need this list so that they  know  what  mechanisms
27       the server supports.
28
29       conn the SASL context for this connection user (optional) restricts the
30       mechanism list to only those available to the user.  prefix appended to
31       beginning  of result sep appended between mechanisms suffix appended to
32       end of result result NULL terminated result string (allocated/freed  by
33       library) plen length of result filled in by library. May be NULL pcount
34       Number of mechanisms available (filled in by library). May be NULL
35
36       Example:
37
38       sasl_listmech(conn,NULL,"(",",",")",&mechlist,NULL,NULL);
39
40       may give the string
41       (ANONYMOUS,KERBEROS_V4,DIGEST-MD5)
42       as a result
43

RETURN VALUE

45       Returns SASL_OK on success. SASL error code on failure.
46
47

CONFORMING TO

49       RFC 4422
50

SEE ALSO

52       sasl(3), sasl_errors(3), sasl_server_new(3), sasl_client_new(3)
53
54
55
56SASL                             10 July 2001                 sasl_listmech(3)
Impressum