Man Linux: Main Page and Category List

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.