PAM_VPROMPT(3) | Library Functions Manual | PAM_VPROMPT(3) |
pam_vprompt
— call
the conversation function
Pluggable Authentication Module Library (libpam, -lpam)
#include
<sys/types.h>
#include
<security/pam_appl.h>
int
pam_vprompt
(const
pam_handle_t *pamh, int
style, char **resp,
const char *fmt,
va_list ap);
The pam_vprompt
function constructs a
string from the fmt and ap
arguments using vsnprintf(3), and
passes it to the given PAM context's conversation function.
The style argument specifies the type of interaction requested, and must be one of the following:
PAM_PROMPT_ECHO_OFF
PAM_PROMPT_ECHO_ON
PAM_ERROR_MSG
PAM_TEXT_INFO
A pointer to the response, or NULL
if the
conversation function did not return one, is stored in the location pointed
to by the resp argument.
The message and response should not exceed
PAM_MAX_MSG_SIZE
or
PAM_MAX_RESP_SIZE
, respectively. If they do, they
may be truncated.
The pam_vprompt
function returns one of
the following values:
PAM_BUF_ERR
]PAM_CONV_ERR
]PAM_SYSTEM_ERR
]pam(3), pam_error(3), pam_info(3), pam_prompt(3), pam_strerror(3), pam_verror(3), pam_vinfo(3), vsnprintf(3)
The pam_vprompt
function is an OpenPAM
extension.
The pam_vprompt
function and this manual
page were developed for the FreeBSD Project by
ThinkSec AS and Network Associates Laboratories, the Security Research
Division of Network Associates, Inc. under DARPA/SPAWAR contract
N66001-01-C-8035 (“CBOSS”), as part of the DARPA CHATS
research program.
December 21, 2007 | macOS 14.6 |