PAM_VPROMPT (3) | C library functions | Unix Manual Pages | :man▋
NAME
pam_vprompt - call the conversation function
CONTENTS
Library Synopsis Description Return Values See Also Standards Authors
LIBRARY
.Lb libpam
SYNOPSIS
.In sys/types.h .In security/pam_appl.h "int" pam_vprompt "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 contexts 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 users response without displaying it. | PAM_PROMPT_ECHO_ON | | Display the message and obtain the users 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_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
AUTHORS
|