PAM_PROMPT(3)

  .SH "NAME" pam_prompt, pam_vprompt - interface to conversation function
  .SH "SYNOPSIS"

#include <security/pam_ext.h>

      .HP u int pam_prompt(pam_handle_t *pamh, int style, char **response, const char *fmt, ...);
      .HP u int pam_vprompt(pam_handle_t *pamh, int style, char **response, const char *fmt, va_list args);

  .SH "DESCRIPTION"

    .PP 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.

  .SH "RETURN VALUES"

      .PP PAM_BUF_ERR

               Memory buffer error.

          .RE
          .PP PAM_CONV_ERR

                   Conversation failure.

              .RE
              .PP PAM_SUCCESS

                       Conversation succeeded, response is set.

                  .RE
                  .PP PAM_SYSTEM_ERR

                           System error.

                      .RE

                  .SH "SEE ALSO"

                    .PP pam(8), pam_conv(3)

                  .SH "STANDARDS"

                    .PP The pam_prompt and pam_vprompt functions are Linux-PAM extensions.