1.\" Generated from openpam_nullconv.c by gendoc.pl
2.\" $Id: openpam_nullconv.c 648 2013-03-05 17:54:27Z des $
3.Dd February 19, 2017
4.Dt OPENPAM_NULLCONV 3
5.Os
6.Sh NAME
7.Nm openpam_nullconv
8.Nd null 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_nullconv "int n" "const struct pam_message **msg" "struct pam_response **resp" "void *data"
15.Sh DESCRIPTION
16The
17.Fn openpam_nullconv
18function is a null conversation function suitable
19for applications that want to use PAM but don't support interactive
20dialog with the user.
21Such applications should set
22.Dv PAM_AUTHTOK
23to whatever authentication
24token they've obtained on their own before calling
25.Xr pam_authenticate 3
26and / or
27.Xr pam_chauthtok 3 ,
28and their PAM configuration should specify the
29.Dv use_first_pass
30option for all modules that require access to the
31authentication token, to make sure they use
32.Dv PAM_AUTHTOK
33rather than
34try to query the user.
35.Pp
36.Sh RETURN VALUES
37The
38.Fn openpam_nullconv
39function returns one of the following values:
40.Bl -tag -width 18n
41.It Bq Er PAM_CONV_ERR
42Conversation failure.
43.El
44.Sh SEE ALSO
45.Xr openpam_ttyconv 3 ,
46.Xr pam 3 ,
47.Xr pam_authenticate 3 ,
48.Xr pam_chauthtok 3 ,
49.Xr pam_prompt 3 ,
50.Xr pam_set_item 3 ,
51.Xr pam_strerror 3 ,
52.Xr pam_vprompt 3
53.Sh STANDARDS
54The
55.Fn openpam_nullconv
56function is an OpenPAM extension.
57.Sh AUTHORS
58The
59.Fn openpam_nullconv
60function and this manual page were
61developed for the
62.Fx
63Project by ThinkSec AS and Network Associates Laboratories, the
64Security Research Division of Network Associates, Inc.\& under
65DARPA/SPAWAR contract N66001-01-C-8035
66.Pq Dq CBOSS ,
67as part of the DARPA CHATS research program.
68.Pp
69The OpenPAM library is maintained by
70.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
71