$Id: openpam_ttyconv.c 807 2014-09-09 09:41:32Z des $
.Dd September 12, 2014 .Dt OPENPAM_TTYCONV 3 .Os .Sh NAME .Nm openpam_ttyconv .Nd simple tty-based conversation function .Sh LIBRARY .Lb libpam .Sh SYNOPSIS n sys/types.h n security/pam_appl.h n security/openpam.h .Ft "int" .Fn openpam_ttyconv "int n" "const struct pam_message **msg" "struct pam_response **resp" "void *data" .Sh DESCRIPTION The .Fn 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.
p The .Fn openpam_ttyconv function allows the application to specify a timeout for user input by setting the global integer variable .Va openpam_ttyconv_timeout to the length of the timeout in seconds.
p .Sh RETURN VALUES The .Fn openpam_ttyconv function returns one of the following values: l -tag -width 18n t Bq Er PAM_BUF_ERR Memory buffer error. t Bq Er PAM_CONV_ERR Conversation failure. t Bq Er PAM_SYSTEM_ERR System error. .El .Sh SEE ALSO .Xr openpam_nullconv 3 , .Xr pam 3 , .Xr pam_prompt 3 , .Xr pam_strerror 3 , .Xr pam_vprompt 3 .Sh STANDARDS The .Fn openpam_ttyconv function is an OpenPAM extension. .Sh AUTHORS The .Fn openpam_ttyconv function and this manual page were developed for the .Fx Project by ThinkSec AS and Network Associates Laboratories, the Security Research Division of Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
q Dq CBOSS , as part of the DARPA CHATS research program.
p The OpenPAM library is maintained by .An Dag-Erling Sm\(/orgrav Aq des@des.no .