NAME
pam_vprompt —
call the conversation
function
SYNOPSIS
#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);
DESCRIPTION
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
- Display the message and obtain the user's response without
displaying it.
-
-
PAM_PROMPT_ECHO_ON
- Display the message and obtain the user's response.
-
-
PAM_ERROR_MSG
- Display the message as an error message, and do not wait
for a response.
-
-
PAM_TEXT_INFO
- Display the message as an informational message, and do not
wait for a response.
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.
RETURN VALUES
The
pam_vprompt() function returns one of the following
values:
-
-
- [
PAM_SUCCESS
]
- Success.
-
-
- [
PAM_BUF_ERR
]
- Memory buffer error.
-
-
- [
PAM_CONV_ERR
]
- Conversation failure.
-
-
- [
PAM_SYSTEM_ERR
]
- System error.
SEE ALSO
pam(3),
pam_error(3),
pam_info(3),
pam_prompt(3),
pam_strerror(3),
pam_verror(3),
pam_vinfo(3),
vsnprintf(3)
STANDARDS
The
pam_vprompt() function is an OpenPAM extension.
AUTHORS
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.
The OpenPAM library is maintained by
Dag-Erling
Smørgrav
<
des@des.no>.