*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->FreeBSD man pages -> pam_vprompt (3)              



NAME    [Toc]    [Back]

     pam_vprompt -- call the conversation function

LIBRARY    [Toc]    [Back]

     PAM Library (libpam, -lpam)

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>
     #include <security/pam_appl.h>

     pam_vprompt(pam_handle_t *pamh, int style, char **resp, const char *fmt,
         va_list ap);

DESCRIPTION    [Toc]    [Back]

     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

     The style argument specifies the type of interaction requested, and must
     be one of the following:

                         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    [Toc]    [Back]

     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    [Toc]    [Back]

     pam(3), pam_error(3), pam_info(3), pam_prompt(3), pam_strerror(3),
     pam_verror(3), pam_vinfo(3), vsnprintf(3)

STANDARDS    [Toc]    [Back]

     The pam_vprompt function is an OpenPAM extension.

AUTHORS    [Toc]    [Back]

     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.

FreeBSD 5.2.1                    July 15, 2003                   FreeBSD 5.2.1
[ Back ]
 Similar pages
Name OS Title
openpam_nullconv FreeBSD null conversation function
openpam_ttyconv FreeBSD simple tty-based conversation function
pam_conv FreeBSD PAM conversation system
cflow Linux print a function call hierarchy
bioscall NetBSD call system BIOS function from real mode
XmTransferSetParameters HP-UX A toolkit function that establishes parameters to be passed by the next call to XmTransferValue
shm_unlink Tru64 Removes a shared memory object created by a call to the shm_open function (P1003.1b)
execppp IRIX Start a PPP call.
stopppp IRIX Stop a PPP call.
syscall Tru64 indirect system call
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service