Simple Authentication Security Layer Library Functions
sasl_getsimple_t(3SASL)
NAME
sasl_getsimple_t - the SASL callback function for username,
authname and realmSYNOPSIS
cc [ flag ... ] file ... -lsasl [ library ... ]
#include
int sasl_getsimple_t(void *context, int id, const char **result,
unsigned *len);DESCRIPTION
Use the sasl_getsimple_t() callback function to retrieve
simple data from the application such as the authenticationname, the authorization name, and the realm. The id parame-
ter indicates which value is requested.PARAMETERS
context The context from the callback structure. id The callback ID. Possible values for id include:SASL_CB_USER Client user identity for
login.SASL_CB_AUTHNAME Client authentication name.
SASL_CB_LANGUAGE Comma-separated list of
languages pursuant to RFC 1766.SASL_CB_CNONCE The client-nonce. This value
is used primarily for test-
ing. result To cancel user, set the value of result with anull-terminated string. If the value of result is
NULL, then the user is cancelled. len The length of result.SunOS 5.11 Last change: 27 Oct 2003 1
Simple Authentication Security Layer Library Functionssasl_getsimple_t(3SASL)
RETURN VALUES
Like other SASL callback functions, sasl_getsimple_t()
returns an integer that corresponds to a SASL error code. Seefor a complete list of SASL error codes. ERRORS
SASL_OK The call to sasl_getsimple_t() was successful.
See sasl_errors(3SASL) for information on SASL error codes.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:_______________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|________________________________|
| Availability | system/library/security/libsasl||_____________________________|________________________________|
| Interface Stability | Committed ||_____________________________|________________________________|
| MT-Level | MT-Safe |
|_____________________________|________________________________|
SEE ALSO
sasl_errors(3SASL), attributes(5)
Alvestrand, H. RFC 1766, Tags for the Identification of Languages. Network Working Group. November 1995.SunOS 5.11 Last change: 27 Oct 2003 2
Simple Authentication Security Layer Library Functionssasl_getsimple_t(3SASL)
SunOS 5.11 Last change: 27 Oct 2003 3