PAM_PROMPT

Section: Linux-PAM Manual (3) Updated: 08/31/2010 Local index Up

NAME

pam_prompt, pam_vprompt - interface to conversation function

SYNOPSIS

#include <security/pam_ext.h>

void pam_prompt(pam_handle_t *pamh, int style, char **response, const char *fmt, ...);
void 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

: Transaction was successful created.

PAM_SYSTEM_ERR

: System error.

STANDARDS

The pam_prompt and pam_vprompt functions are Linux-PAM extensions.

This document was created by man2html, using the manual pages.
Time: 21:51:58 GMT, April 16, 2011