NAME
openpam_ttyconv
- simple tty-based conversation function
LIBRARY
SYNOPSIS
int
openpam_ttyconv(
int n
, const struct pam_message **msg
, struct pam_response **resp
, void *data
)
DESCRIPTION
The
openpam_ttyconv
function is a standard conversation function
suitable for use on TTY devices.
It should be adequate for the needs of most text-based interactive
programs.
The
openpam_ttyconv
function displays a prompt to, and reads in a
password from /dev/tty. If this file is not accessible,
openpam_ttyconv
displays the prompt on the standard error output and reads from the
standard input.
The
openpam_ttyconv
function allows the application to specify a
timeout for user input by setting the global integer variable
openpam_ttyconv_timeout
to the length of the timeout in seconds.
RETURN VALUES
The
openpam_ttyconv
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
getpass(3),
openpam_nullconv(3),
pam(3),
pam_prompt(3),
pam_strerror(3),
pam_vprompt(3)
STANDARDS
The
openpam_ttyconv
function is an OpenPAM extension.
AUTHORS
The
openpam_ttyconv
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.