readline_callback_handler_install(3) [php man page]

READLINE_CALLBACK_HANDLER_INSTALL(3)					 1				      READLINE_CALLBACK_HANDLER_INSTALL(3)

readline_callback_handler_install - Initializes the readline callback interface and terminal, prints the prompt and returns immediately

SYNOPSIS

       bool readline_callback_handler_install (string  $prompt, callable  $callback)

DESCRIPTION

	Sets up a readline callback interface then prints $prompt and immediately returns. Calling this function twice without removing the previ-
       ous callback interface will automatically and conveniently overwrite the old interface.

	The callback feature is useful when combined with stream_select(3) as it allows interleaving of IO and user input, unlike readline(3).

PARAMETERS

	      o $prompt
		- The prompt message.

	      o $callback
		- The $callback function takes one parameter; the user input returned.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

       Example #1

	      Readline Callback Interface Example

	      <?php
	      function rl_callback($ret)
	      {
		  global $c, $prompting;

		  echo "You entered: $ret
";
		  $c++;

		  if ($c > 10) {
		      $prompting = false;
		      readline_callback_handler_remove();
		  } else {
		      readline_callback_handler_install("[$c] Enter something: ", 'rl_callback');
		  }
	      }

	      $c = 1;
	      $prompting = true;

	      readline_callback_handler_install("[$c] Enter something: ", 'rl_callback');

	      while ($prompting) {
		  $w = NULL;
		  $e = NULL;
		  $n = stream_select($r = array(STDIN), $w, $e, null);
		  if ($n && in_array(STDIN, $r)) {
		      // read a character, will call the callback when a newline is entered
		      readline_callback_read_char();
		  }
	      }

	      echo "Prompting disabled. All done.
";
	      ?>

       readline_callback_handler_remove(3), readline_callback_read_char(3), stream_select(3).

PHP Documentation Group 										      READLINE_CALLBACK_HANDLER_INSTALL(3)

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.11							    14 Oct 2003 					  sasl_chalprompt_t(3SASL)