1.\" Generated from openpam_ttyconv.c by gendoc.pl 2.\" $OpenPAM: openpam_ttyconv.c 938 2017-04-30 21:34:42Z des $ 3.Dd April 30, 2017 4.Dt OPENPAM_TTYCONV 3 5.Os 6.Sh NAME 7.Nm openpam_ttyconv 8.Nd simple tty-based conversation function 9.Sh SYNOPSIS 10.In sys/types.h 11.In security/pam_appl.h 12.In security/openpam.h 13.Ft "int" 14.Fn openpam_ttyconv "int n" "const struct pam_message **msg" "struct pam_response **resp" "void *data" 15.Sh DESCRIPTION 16The 17.Fn openpam_ttyconv 18function is a standard conversation function 19suitable for use on TTY devices. 20It should be adequate for the needs of most text-based interactive 21programs. 22.Pp 23The 24.Fn openpam_ttyconv 25function allows the application to specify a 26timeout for user input by setting the global integer variable 27.Va openpam_ttyconv_timeout 28to the length of the timeout in seconds. 29.Pp 30.Sh RETURN VALUES 31The 32.Fn openpam_ttyconv 33function returns one of the following values: 34.Bl -tag -width 18n 35.It Bq Er PAM_SUCCESS 36Success. 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 Mt des@des.no . 68