1*0d9d0fd8Schristos.\" $NetBSD: openpam_nullconv.3,v 1.9 2023/06/30 21:46:20 christos Exp $ 244269bb5Schristos.\" 38fa0fefeSchristos.\" Generated from openpam_nullconv.c by gendoc.pl 4*0d9d0fd8Schristos.Dd June 27, 2023 544269bb5Schristos.Dt OPENPAM_NULLCONV 3 644269bb5Schristos.Os 744269bb5Schristos.Sh NAME 844269bb5Schristos.Nm openpam_nullconv 944269bb5Schristos.Nd null conversation function 1044269bb5Schristos.Sh SYNOPSIS 1144269bb5Schristos.In sys/types.h 1244269bb5Schristos.In security/pam_appl.h 1344269bb5Schristos.In security/openpam.h 1444269bb5Schristos.Ft "int" 1544269bb5Schristos.Fn openpam_nullconv "int n" "const struct pam_message **msg" "struct pam_response **resp" "void *data" 1644269bb5Schristos.Sh DESCRIPTION 1744269bb5SchristosThe 18e1b25b17Schristos.Fn openpam_nullconv 1944269bb5Schristosfunction is a null conversation function suitable 2044269bb5Schristosfor applications that want to use PAM but don't support interactive 2144269bb5Schristosdialog with the user. 2244269bb5SchristosSuch applications should set 2344269bb5Schristos.Dv PAM_AUTHTOK 2444269bb5Schristosto whatever authentication 2544269bb5Schristostoken they've obtained on their own before calling 2644269bb5Schristos.Xr pam_authenticate 3 2744269bb5Schristosand / or 2844269bb5Schristos.Xr pam_chauthtok 3 , 2944269bb5Schristosand their PAM configuration should specify the 3044269bb5Schristos.Dv use_first_pass 3144269bb5Schristosoption for all modules that require access to the 3244269bb5Schristosauthentication token, to make sure they use 3344269bb5Schristos.Dv PAM_AUTHTOK 341ae23164Schristosrather than try to query the user. 3544269bb5Schristos.Sh RETURN VALUES 3644269bb5SchristosThe 37e1b25b17Schristos.Fn openpam_nullconv 3844269bb5Schristosfunction returns one of the following values: 3944269bb5Schristos.Bl -tag -width 18n 404cb4af11Schristos.It Bq Er PAM_SUCCESS 414cb4af11SchristosSuccess. 4244269bb5Schristos.It Bq Er PAM_CONV_ERR 4344269bb5SchristosConversation failure. 4444269bb5Schristos.El 4544269bb5Schristos.Sh SEE ALSO 4644269bb5Schristos.Xr openpam_ttyconv 3 , 4744269bb5Schristos.Xr pam 3 , 4844269bb5Schristos.Xr pam_authenticate 3 , 4944269bb5Schristos.Xr pam_chauthtok 3 , 5044269bb5Schristos.Xr pam_prompt 3 , 5144269bb5Schristos.Xr pam_set_item 3 , 5244269bb5Schristos.Xr pam_strerror 3 , 5344269bb5Schristos.Xr pam_vprompt 3 5444269bb5Schristos.Sh STANDARDS 5544269bb5SchristosThe 56e1b25b17Schristos.Fn openpam_nullconv 5744269bb5Schristosfunction is an OpenPAM extension. 5844269bb5Schristos.Sh AUTHORS 5944269bb5SchristosThe 60e1b25b17Schristos.Fn openpam_nullconv 61e1b25b17Schristosfunction and this manual page were 62e1b25b17Schristosdeveloped for the 6344269bb5Schristos.Fx 64e1b25b17SchristosProject by ThinkSec AS and Network Associates Laboratories, the 6544269bb5SchristosSecurity Research Division of Network Associates, Inc.\& under 6644269bb5SchristosDARPA/SPAWAR contract N66001-01-C-8035 6744269bb5Schristos.Pq Dq CBOSS , 6844269bb5Schristosas part of the DARPA CHATS research program. 698fa0fefeSchristos.Pp 708fa0fefeSchristosThe OpenPAM library is maintained by 714cb4af11Schristos.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no . 72