# pam_vprompt - interface to conversation function - man(3) - [phpMan]

[_PAM_PROMPT_(3)](https://www.chedong.com/phpMan.php/man/PAMPROMPT/3/markdown)                             Linux-PAM Manual                             [_PAM_PROMPT_(3)](https://www.chedong.com/phpMan.php/man/PAMPROMPT/3/markdown)

## 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)](https://www.chedong.com/phpMan.php/man/pam/7/markdown), [**pam_conv**(3)](https://www.chedong.com/phpMan.php/man/pamconv/3/markdown)

## STANDARDS
       The **pam_prompt **and **pam_vprompt **functions are Linux-PAM extensions.

Linux-PAM                                    09/15/2023                                [_PAM_PROMPT_(3)](https://www.chedong.com/phpMan.php/man/PAMPROMPT/3/markdown)