linux-pam (1.5.3)

(root)/
share/
man/
man3/
pam_prompt.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(8), pam_conv(3)

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

Linux-PAM 05/07/2023 PAM_PROMPT(3)