SASL_CHALPROMPT_T(3SASL) Simple Authentication Security Layer Library Functions


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
complete 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 |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


sasl_errors(3SASL), sasl_server_new(3SASL), attributes(5)


October 14, 2003 SASL_CHALPROMPT_T(3SASL)