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