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