1.\" Generated from openpam_ttyconv.c by gendoc.pl 2.\" $Id: openpam_ttyconv.c 890 2016-01-11 16:22:09Z des $ 3.Dd February 19, 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_BUF_ERR 36Memory buffer error. 37.It Bq Er PAM_CONV_ERR 38Conversation failure. 39.It Bq Er PAM_SYSTEM_ERR 40System error. 41.El 42.Sh SEE ALSO 43.Xr openpam_nullconv 3 , 44.Xr pam 3 , 45.Xr pam_prompt 3 , 46.Xr pam_strerror 3 , 47.Xr pam_vprompt 3 48.Sh STANDARDS 49The 50.Fn openpam_ttyconv 51function is an OpenPAM extension. 52.Sh AUTHORS 53The 54.Fn openpam_ttyconv 55function and this manual page were 56developed for the 57.Fx 58Project by ThinkSec AS and Network Associates Laboratories, the 59Security Research Division of Network Associates, Inc.\& under 60DARPA/SPAWAR contract N66001-01-C-8035 61.Pq Dq CBOSS , 62as part of the DARPA CHATS research program. 63.Pp 64The OpenPAM library is maintained by 65.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no . 66