xref: /dflybsd-src/contrib/openpam/doc/man/openpam_nullconv.3 (revision 4c84ab30f7dd59ef873b5a6d4e27bcea89d9f848)
110b5fe87SSascha Wildner.\" Generated from openpam_nullconv.c by gendoc.pl
210b5fe87SSascha Wildner.\" $OpenPAM: openpam_nullconv.c 938 2017-04-30 21:34:42Z des $
3*4c84ab30SSascha Wildner.Dd February 24, 2019
4ade90846SJoerg Sonnenberger.Dt OPENPAM_NULLCONV 3
5ade90846SJoerg Sonnenberger.Os
6ade90846SJoerg Sonnenberger.Sh NAME
7ade90846SJoerg Sonnenberger.Nm openpam_nullconv
8ade90846SJoerg Sonnenberger.Nd null 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_nullconv "int n" "const struct pam_message **msg" "struct pam_response **resp" "void *data"
15ade90846SJoerg Sonnenberger.Sh DESCRIPTION
16ade90846SJoerg SonnenbergerThe
17577efdeeSPeter Avalos.Fn openpam_nullconv
18ade90846SJoerg Sonnenbergerfunction is a null conversation function suitable
19ade90846SJoerg Sonnenbergerfor applications that want to use PAM but don't support interactive
20ade90846SJoerg Sonnenbergerdialog with the user.
21ade90846SJoerg SonnenbergerSuch applications should set
22ade90846SJoerg Sonnenberger.Dv PAM_AUTHTOK
23ade90846SJoerg Sonnenbergerto whatever authentication
24ade90846SJoerg Sonnenbergertoken they've obtained on their own before calling
25ade90846SJoerg Sonnenberger.Xr pam_authenticate 3
26ade90846SJoerg Sonnenbergerand / or
27ade90846SJoerg Sonnenberger.Xr pam_chauthtok 3 ,
28ade90846SJoerg Sonnenbergerand their PAM configuration should specify the
29ade90846SJoerg Sonnenberger.Dv use_first_pass
30ade90846SJoerg Sonnenbergeroption for all modules that require access to the
31ade90846SJoerg Sonnenbergerauthentication token, to make sure they use
32ade90846SJoerg Sonnenberger.Dv PAM_AUTHTOK
33ade90846SJoerg Sonnenbergerrather than
34ade90846SJoerg Sonnenbergertry to query the user.
35ade90846SJoerg Sonnenberger.Pp
36ade90846SJoerg Sonnenberger.Sh RETURN VALUES
37ade90846SJoerg SonnenbergerThe
38577efdeeSPeter Avalos.Fn openpam_nullconv
39ade90846SJoerg Sonnenbergerfunction returns one of the following values:
40ade90846SJoerg Sonnenberger.Bl -tag -width 18n
4110b5fe87SSascha Wildner.It Bq Er PAM_SUCCESS
4210b5fe87SSascha WildnerSuccess.
43ade90846SJoerg Sonnenberger.It Bq Er PAM_CONV_ERR
44ade90846SJoerg SonnenbergerConversation failure.
45ade90846SJoerg Sonnenberger.El
46ade90846SJoerg Sonnenberger.Sh SEE ALSO
47ade90846SJoerg Sonnenberger.Xr openpam_ttyconv 3 ,
48ade90846SJoerg Sonnenberger.Xr pam 3 ,
49ade90846SJoerg Sonnenberger.Xr pam_authenticate 3 ,
50ade90846SJoerg Sonnenberger.Xr pam_chauthtok 3 ,
51ade90846SJoerg Sonnenberger.Xr pam_prompt 3 ,
52ade90846SJoerg Sonnenberger.Xr pam_set_item 3 ,
53ade90846SJoerg Sonnenberger.Xr pam_strerror 3 ,
54ade90846SJoerg Sonnenberger.Xr pam_vprompt 3
55ade90846SJoerg Sonnenberger.Sh STANDARDS
56ade90846SJoerg SonnenbergerThe
57577efdeeSPeter Avalos.Fn openpam_nullconv
58ade90846SJoerg Sonnenbergerfunction is an OpenPAM extension.
59ade90846SJoerg Sonnenberger.Sh AUTHORS
60ade90846SJoerg SonnenbergerThe
61577efdeeSPeter Avalos.Fn openpam_nullconv
62577efdeeSPeter Avalosfunction and this manual page were
63577efdeeSPeter Avalosdeveloped for the
64ade90846SJoerg Sonnenberger.Fx
65577efdeeSPeter AvalosProject by ThinkSec AS and Network Associates Laboratories, the
66f23594ceSHasso TepperSecurity Research Division of Network Associates, Inc.\& under
67ade90846SJoerg SonnenbergerDARPA/SPAWAR contract N66001-01-C-8035
68ade90846SJoerg Sonnenberger.Pq Dq CBOSS ,
69ade90846SJoerg Sonnenbergeras part of the DARPA CHATS research program.
7010b5fe87SSascha Wildner.Pp
7110b5fe87SSascha WildnerThe OpenPAM library is maintained by
7210b5fe87SSascha Wildner.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
73