sasl_chalprompt_t(3SASL)		      Simple Authentication Security Layer Library Functions			  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  com-
       plete 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		     |SUNWlibsasl		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

SunOS 5.10							    14 Oct 2003 					  sasl_chalprompt_t(3SASL)