2. EL 6 ELS
  3. pam-devel
  4. pam_prompt(3)

Scroll to navigation

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(8), pam_conv(3)



STANDARDS

The pam_prompt and pam_vprompt functions are Linux-PAM extensions.

03/02/2009 Linux-PAM Manual