man > pam_vprompt(3)

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

NAME
       pam_prompt, pam_vprompt - interface to conversation function

SYNOPSIS
       #include <security/pam_ext.h>


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

       int 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
           Conversation succeeded, response is set.

       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                                    09/15/2023                                PAM_PROMPT(3)