146acc370SDag-Erling Smørgrav.\"- 2856bb440SDag-Erling Smørgrav.\" Copyright (c) 2002 Networks Associates Technology, Inc. 346acc370SDag-Erling Smørgrav.\" All rights reserved. 446acc370SDag-Erling Smørgrav.\" 546acc370SDag-Erling Smørgrav.\" This software was developed for the FreeBSD Project by ThinkSec AS and 646acc370SDag-Erling Smørgrav.\" NAI Labs, the Security Research Division of Network Associates, Inc. 746acc370SDag-Erling Smørgrav.\" under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the 846acc370SDag-Erling Smørgrav.\" DARPA CHATS research program. 946acc370SDag-Erling Smørgrav.\" 1046acc370SDag-Erling Smørgrav.\" Redistribution and use in source and binary forms, with or without 1146acc370SDag-Erling Smørgrav.\" modification, are permitted provided that the following conditions 1246acc370SDag-Erling Smørgrav.\" are met: 1346acc370SDag-Erling Smørgrav.\" 1. Redistributions of source code must retain the above copyright 1446acc370SDag-Erling Smørgrav.\" notice, this list of conditions and the following disclaimer. 1546acc370SDag-Erling Smørgrav.\" 2. Redistributions in binary form must reproduce the above copyright 1646acc370SDag-Erling Smørgrav.\" notice, this list of conditions and the following disclaimer in the 1746acc370SDag-Erling Smørgrav.\" documentation and/or other materials provided with the distribution. 1846acc370SDag-Erling Smørgrav.\" 3. The name of the author may not be used to endorse or promote 1946acc370SDag-Erling Smørgrav.\" products derived from this software without specific prior written 2046acc370SDag-Erling Smørgrav.\" permission. 2146acc370SDag-Erling Smørgrav.\" 2246acc370SDag-Erling Smørgrav.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 2346acc370SDag-Erling Smørgrav.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 2446acc370SDag-Erling Smørgrav.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 2546acc370SDag-Erling Smørgrav.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 2646acc370SDag-Erling Smørgrav.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 2746acc370SDag-Erling Smørgrav.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 2846acc370SDag-Erling Smørgrav.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 2946acc370SDag-Erling Smørgrav.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 3046acc370SDag-Erling Smørgrav.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 3146acc370SDag-Erling Smørgrav.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 3246acc370SDag-Erling Smørgrav.\" SUCH DAMAGE. 3346acc370SDag-Erling Smørgrav.\" 3455e3fbc9SDag-Erling Smørgrav.\" $P4: //depot/projects/openpam/doc/man/openpam_ttyconv.3#10 $ 3546acc370SDag-Erling Smørgrav.\" 3655e3fbc9SDag-Erling Smørgrav.Dd May 24, 2002 3746acc370SDag-Erling Smørgrav.Dt OPENPAM_TTYCONV 3 3846acc370SDag-Erling Smørgrav.Os 3946acc370SDag-Erling Smørgrav.Sh NAME 4046acc370SDag-Erling Smørgrav.Nm openpam_ttyconv 4146acc370SDag-Erling Smørgrav.Nd simple tty-based conversation function 4246acc370SDag-Erling Smørgrav.Sh LIBRARY 4346acc370SDag-Erling Smørgrav.Lb libpam 4446acc370SDag-Erling Smørgrav.Sh SYNOPSIS 4546acc370SDag-Erling Smørgrav.In security/pam_appl.h 46ac7e3b9dSDag-Erling Smørgrav.In security/openpam.h 4746acc370SDag-Erling Smørgrav.Ft int 4846acc370SDag-Erling Smørgrav.Fn openpam_ttyconv "int n" "const struct pam_message **msg" "struct pam_response **resp" "void *data" 4946acc370SDag-Erling Smørgrav.Sh DESCRIPTION 5055e3fbc9SDag-Erling SmørgravThe 5155e3fbc9SDag-Erling Smørgrav.Nm 5255e3fbc9SDag-Erling Smørgravfunction is a standard conversation function 5355e3fbc9SDag-Erling Smørgravsuitable for use on TTY devices. It should be adequate for the needs 5455e3fbc9SDag-Erling Smørgravof most text-based interactive programs. 5555e3fbc9SDag-Erling Smørgrav.Pp 5655e3fbc9SDag-Erling SmørgravThe 5755e3fbc9SDag-Erling Smørgrav.Nm 5855e3fbc9SDag-Erling Smørgravfunction allows the application to specify a 5955e3fbc9SDag-Erling Smørgravtimeout for user input by setting the global variable 6055e3fbc9SDag-Erling Smørgrav.Va openpam_ttyconv_timeout 6155e3fbc9SDag-Erling Smørgravto the length of the timeout in seconds. 6255e3fbc9SDag-Erling Smørgrav.Pp 6346acc370SDag-Erling Smørgrav.Sh RETURN VALUES 6446acc370SDag-Erling SmørgravThe 6546acc370SDag-Erling Smørgrav.Nm 6646acc370SDag-Erling Smørgravfunction returns one of the following values: 6746acc370SDag-Erling Smørgrav.Bl -tag -width 18n 6846acc370SDag-Erling Smørgrav.It Bq Er PAM_BUF_ERR 6946acc370SDag-Erling SmørgravMemory buffer error. 7046acc370SDag-Erling Smørgrav.It Bq Er PAM_CONV_ERR 7146acc370SDag-Erling SmørgravConversation failure. 7246acc370SDag-Erling Smørgrav.It Bq Er PAM_SYSTEM_ERR 7346acc370SDag-Erling SmørgravSystem error. 7446acc370SDag-Erling Smørgrav.El 7546acc370SDag-Erling Smørgrav.Sh SEE ALSO 7655e3fbc9SDag-Erling Smørgrav.Xr openpam_nullconv 3 , 7746acc370SDag-Erling Smørgrav.Xr pam 3 , 7855e3fbc9SDag-Erling Smørgrav.Xr pam_prompt 3 , 7955e3fbc9SDag-Erling Smørgrav.Xr pam_strerror 3 , 8055e3fbc9SDag-Erling Smørgrav.Xr pam_vprompt 3 8146acc370SDag-Erling Smørgrav.Sh STANDARDS 8246acc370SDag-Erling SmørgravThe 8346acc370SDag-Erling Smørgrav.Nm 8446acc370SDag-Erling Smørgravfunction is an OpenPAM extension. 8546acc370SDag-Erling Smørgrav.Sh AUTHORS 8646acc370SDag-Erling SmørgravThe 8746acc370SDag-Erling Smørgrav.Nm 8846acc370SDag-Erling Smørgravfunction and this manual page were developed for the FreeBSD Project 8946acc370SDag-Erling Smørgravby ThinkSec AS and NAI Labs, the Security Research Division of Network 9046acc370SDag-Erling SmørgravAssociates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 9146acc370SDag-Erling Smørgrav.Pq Dq CBOSS , 9246acc370SDag-Erling Smørgravas part of the DARPA CHATS research program. 93