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(7) 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(7) October 14, 2003 SASL_CHALPROMPT_T(3SASL)
