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 
       ⟨http://www.linux-pam.org/⟩.  If you have a bug report for this manual
       page, see ⟨//www.linux-pam.org/⟩.  This page was obtained from the
       tarball Linux-PAM-1.3.0.tar.gz fetched from 
       ⟨http://www.linux-pam.org/library/⟩ on 2017-07-05.  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)

Pages that refer to this page: pam_error(3)