xref: /dflybsd-src/contrib/openpam/doc/man/openpam_ttyconv.3 (revision 4c84ab30f7dd59ef873b5a6d4e27bcea89d9f848)
110b5fe87SSascha Wildner.\" Generated from openpam_ttyconv.c by gendoc.pl
210b5fe87SSascha Wildner.\" $OpenPAM: openpam_ttyconv.c 938 2017-04-30 21:34:42Z des $
3*4c84ab30SSascha Wildner.Dd February 24, 2019
4ade90846SJoerg Sonnenberger.Dt OPENPAM_TTYCONV 3
5ade90846SJoerg Sonnenberger.Os
6ade90846SJoerg Sonnenberger.Sh NAME
7ade90846SJoerg Sonnenberger.Nm openpam_ttyconv
8ade90846SJoerg Sonnenberger.Nd simple tty-based conversation function
9ade90846SJoerg Sonnenberger.Sh SYNOPSIS
10ade90846SJoerg Sonnenberger.In sys/types.h
11ade90846SJoerg Sonnenberger.In security/pam_appl.h
12ade90846SJoerg Sonnenberger.In security/openpam.h
13ade90846SJoerg Sonnenberger.Ft "int"
14ade90846SJoerg Sonnenberger.Fn openpam_ttyconv "int n" "const struct pam_message **msg" "struct pam_response **resp" "void *data"
15ade90846SJoerg Sonnenberger.Sh DESCRIPTION
16ade90846SJoerg SonnenbergerThe
17577efdeeSPeter Avalos.Fn openpam_ttyconv
18ade90846SJoerg Sonnenbergerfunction is a standard conversation function
19ade90846SJoerg Sonnenbergersuitable for use on TTY devices.
20ade90846SJoerg SonnenbergerIt should be adequate for the needs of most text-based interactive
21ade90846SJoerg Sonnenbergerprograms.
22ade90846SJoerg Sonnenberger.Pp
23ade90846SJoerg SonnenbergerThe
24577efdeeSPeter Avalos.Fn openpam_ttyconv
25ade90846SJoerg Sonnenbergerfunction allows the application to specify a
26ade90846SJoerg Sonnenbergertimeout for user input by setting the global integer variable
27ade90846SJoerg Sonnenberger.Va openpam_ttyconv_timeout
28ade90846SJoerg Sonnenbergerto the length of the timeout in seconds.
29ade90846SJoerg Sonnenberger.Pp
30ade90846SJoerg Sonnenberger.Sh RETURN VALUES
31ade90846SJoerg SonnenbergerThe
32577efdeeSPeter Avalos.Fn openpam_ttyconv
33ade90846SJoerg Sonnenbergerfunction returns one of the following values:
34ade90846SJoerg Sonnenberger.Bl -tag -width 18n
3510b5fe87SSascha Wildner.It Bq Er PAM_SUCCESS
3610b5fe87SSascha WildnerSuccess.
37ade90846SJoerg Sonnenberger.It Bq Er PAM_BUF_ERR
38ade90846SJoerg SonnenbergerMemory buffer error.
39ade90846SJoerg Sonnenberger.It Bq Er PAM_CONV_ERR
40ade90846SJoerg SonnenbergerConversation failure.
41ade90846SJoerg Sonnenberger.It Bq Er PAM_SYSTEM_ERR
42ade90846SJoerg SonnenbergerSystem error.
43ade90846SJoerg Sonnenberger.El
44ade90846SJoerg Sonnenberger.Sh SEE ALSO
45ade90846SJoerg Sonnenberger.Xr openpam_nullconv 3 ,
46ade90846SJoerg Sonnenberger.Xr pam 3 ,
47ade90846SJoerg Sonnenberger.Xr pam_prompt 3 ,
48ade90846SJoerg Sonnenberger.Xr pam_strerror 3 ,
49ade90846SJoerg Sonnenberger.Xr pam_vprompt 3
50ade90846SJoerg Sonnenberger.Sh STANDARDS
51ade90846SJoerg SonnenbergerThe
52577efdeeSPeter Avalos.Fn openpam_ttyconv
53ade90846SJoerg Sonnenbergerfunction is an OpenPAM extension.
54ade90846SJoerg Sonnenberger.Sh AUTHORS
55ade90846SJoerg SonnenbergerThe
56577efdeeSPeter Avalos.Fn openpam_ttyconv
57577efdeeSPeter Avalosfunction and this manual page were
58577efdeeSPeter Avalosdeveloped for the
59ade90846SJoerg Sonnenberger.Fx
60577efdeeSPeter AvalosProject by ThinkSec AS and Network Associates Laboratories, the
61f23594ceSHasso TepperSecurity Research Division of Network Associates, Inc.\& under
62ade90846SJoerg SonnenbergerDARPA/SPAWAR contract N66001-01-C-8035
63ade90846SJoerg Sonnenberger.Pq Dq CBOSS ,
64ade90846SJoerg Sonnenbergeras part of the DARPA CHATS research program.
6510b5fe87SSascha Wildner.Pp
6610b5fe87SSascha WildnerThe OpenPAM library is maintained by
6710b5fe87SSascha Wildner.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
68