pam_vprompt(3) [debian man page]

PAM_PROMPT(3)							 Linux-PAM Manual						     PAM_PROMPT(3)

NAME

       pam_prompt, pam_vprompt - interface to conversation function

SYNOPSIS

       #include <security/pam_ext.h>

       void pam_prompt(pam_handle_t *pamh, int style, char **response, const char *fmt, ...);

       void pam_vprompt(pam_handle_t *pamh, int style, char **response, const char *fmt, va_list args);

DESCRIPTION

       The pam_prompt function constructs a message from the specified format string and arguments and passes it to the conversation function as
       set by the service. Upon successful return, response is set to point to a string returned from the conversation function. This string is
       allocated on heap and should be freed.

RETURN VALUES

       PAM_BUF_ERR
	   Memory buffer error.

       PAM_CONV_ERR
	   Conversation failure.

       PAM_SUCCESS
	   Transaction was successful created.

       PAM_SYSTEM_ERR
	   System error.

SEE ALSO

       pam(7), pam_conv(3)

STANDARDS

       The pam_prompt and pam_vprompt functions are Linux-PAM extensions.

Linux-PAM Manual						    06/04/2011							     PAM_PROMPT(3)

PAM_PROMPT(3)						   BSD Library Functions Manual 					     PAM_PROMPT(3)

NAME

     pam_prompt -- call the conversation function

LIBRARY

     Pluggable Authentication Module Library (libpam, -lpam)

SYNOPSIS

     #include <sys/types.h>
     #include <security/pam_appl.h>

     int
     pam_prompt(const pam_handle_t *pamh, int style, char **resp, const char *fmt, ...);

DESCRIPTION

     The pam_prompt function constructs a message from the specified format string and arguments and passes it to the given PAM context's conver-
     sation function.

     A pointer to the response, or NULL if the conversation function did not return one, is stored in the location pointed to by the resp argu-
     ment.

     See pam_vprompt(3) for further details.

RETURN VALUES

     The pam_prompt function returns one of the following values:

     [PAM_BUF_ERR]	 Memory buffer error.

     [PAM_CONV_ERR]	 Conversation failure.

     [PAM_SYSTEM_ERR]	 System error.

SEE ALSO

     pam(3), pam_error(3), pam_info(3), pam_strerror(3), pam_vprompt(3)

STANDARDS

     The pam_prompt function is an OpenPAM extension.

AUTHORS

     The pam_prompt function and this manual page were developed for the FreeBSD Project by ThinkSec AS and Network Associates Laboratories, the
     Security Research Division of Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 (``CBOSS''), as part of the DARPA CHATS
     research program.

BSD
								 December 21, 2007							       BSD