openpam_ttyconv(3)

NAME

openpam_ttyconv - simple tty-based conversation function

LIBRARY

library ``libpam''

SYNOPSIS

#include <sys/types.h>
#include <security/pam_appl.h>
#include <security/openpam.h>
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 allows the application to spec

ify a timeout
for user input by setting the global integer variable
openpam_ttyconv_timeout to the length of the timeout in sec

onds.

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

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 de

veloped for the
FreeBSD Project by ThinkSec AS and Network Associates Labo

ratories, 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.

BSD June 16, 2005

BSD