PAM_PROMPT
Section: Linux-PAM Manual (3)
Updated: 11/25/2020
Page Index
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.