1.\" Generated from openpam_ttyconv.c by gendoc.pl 2.\" $Id: openpam_ttyconv.c 688 2013-07-11 16:40:08Z des $ 3.Dd September 7, 2013 4.Dt OPENPAM_TTYCONV 3 5.Os 6.Sh NAME 7.Nm openpam_ttyconv 8.Nd simple tty-based conversation function 9.Sh LIBRARY 10.Lb libpam 11.Sh SYNOPSIS 12.In sys/types.h 13.In security/pam_appl.h 14.In security/openpam.h 15.Ft "int" 16.Fn openpam_ttyconv "int n" "const struct pam_message **msg" "struct pam_response **resp" "void *data" 17.Sh DESCRIPTION 18The 19.Fn openpam_ttyconv 20function is a standard conversation function 21suitable for use on TTY devices. 22It should be adequate for the needs of most text-based interactive 23programs. 24.Pp 25The 26.Fn openpam_ttyconv 27function allows the application to specify a 28timeout for user input by setting the global integer variable 29.Va openpam_ttyconv_timeout 30to the length of the timeout in seconds. 31.Pp 32.Sh RETURN VALUES 33The 34.Fn openpam_ttyconv 35function returns one of the following values: 36.Bl -tag -width 18n 37.It Bq Er PAM_BUF_ERR 38Memory buffer error. 39.It Bq Er PAM_CONV_ERR 40Conversation failure. 41.It Bq Er PAM_SYSTEM_ERR 42System error. 43.El 44.Sh SEE ALSO 45.Xr openpam_nullconv 3 , 46.Xr pam 3 , 47.Xr pam_prompt 3 , 48.Xr pam_strerror 3 , 49.Xr pam_vprompt 3 50.Sh STANDARDS 51The 52.Fn openpam_ttyconv 53function is an OpenPAM extension. 54.Sh AUTHORS 55The 56.Fn openpam_ttyconv 57function and this manual page were 58developed for the 59.Fx 60Project by ThinkSec AS and Network Associates Laboratories, the 61Security Research Division of Network Associates, Inc.\& under 62DARPA/SPAWAR contract N66001-01-C-8035 63.Pq Dq CBOSS , 64as part of the DARPA CHATS research program. 65.Pp 66The OpenPAM library is maintained by 67.An Dag-Erling Sm\(/orgrav Aq des@des.no . 68