sasl_chalprompt_t(3SASL)

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 Availability system/library/security/libsasl Interface Stability Committed MT-Level MT–Safe

See also

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