NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | STANDARDS | COLOPHON

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

NAME         top

       pam_prompt, pam_vprompt - interface to conversation function

SYNOPSIS         top

       #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         top

       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         top

       PAM_BUF_ERR
           Memory buffer error.

       PAM_CONV_ERR
           Conversation failure.

       PAM_SUCCESS
           Conversation succeded, response is set.

       PAM_SYSTEM_ERR
           System error.

SEE ALSO         top

       pam(8), pam_conv(3)

STANDARDS         top

       The pam_prompt and pam_vprompt functions are Linux-PAM extensions.

COLOPHON         top

       This page is part of the linux-pam (Pluggable Authentication Modules
       for Linux) project.  Information about the project can be found at 
       ⟨https://fedorahosted.org/linux-pam/⟩.  If you have a bug report for
       this manual page, see ⟨https://fedorahosted.org/linux-pam/report⟩.
       This page was obtained from the tarball Linux-PAM-1.3.0.tar.gz
       fetched from ⟨http://www.linux-pam.org/library/⟩ on 2017-03-13.  If
       you discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for the
       page, or you have corrections or improvements to the information in
       this COLOPHON (which is not part of the original manual page), send a
       mail to man-pages@man7.org

Linux-PAM Manual                 04/01/2016                    PAM_PROMPT(3)