1.\" Generated from pam_prompt.c by gendoc.pl 2.\" $Id: pam_prompt.c 648 2013-03-05 17:54:27Z des $ 3.Dd February 19, 2017 4.Dt PAM_PROMPT 3 5.Os 6.Sh NAME 7.Nm pam_prompt 8.Nd call the conversation function 9.Sh SYNOPSIS 10.In sys/types.h 11.In security/pam_appl.h 12.Ft "int" 13.Fn pam_prompt "const pam_handle_t *pamh" "int style" "char **resp" "const char *fmt" "..." 14.Sh DESCRIPTION 15The 16.Fn pam_prompt 17function constructs a message from the specified format 18string and arguments and passes it to the given PAM context's 19conversation function. 20.Pp 21A pointer to the response, or 22.Dv NULL 23if the conversation function did 24not return one, is stored in the location pointed to by the 25.Fa resp 26argument. 27.Pp 28See 29.Xr pam_vprompt 3 30for further details. 31.Pp 32.Sh RETURN VALUES 33The 34.Fn pam_prompt 35function returns one of the following values: 36.Bl -tag -width 18n 37.It Bq Er PAM_BUF_ERR 38Memory buffer error. 39.It Bq Er PAM_CONV_ERR 40Conversation failure. 41.It Bq Er PAM_SYSTEM_ERR 42System error. 43.El 44.Sh SEE ALSO 45.Xr pam 3 , 46.Xr pam_error 3 , 47.Xr pam_info 3 , 48.Xr pam_strerror 3 , 49.Xr pam_vprompt 3 50.Sh STANDARDS 51The 52.Fn pam_prompt 53function is an OpenPAM extension. 54.Sh AUTHORS 55The 56.Fn pam_prompt 57function and this manual page were 58developed for the 59.Fx 60Project by ThinkSec AS and Network Associates Laboratories, the 61Security Research Division of Network Associates, Inc.\& under 62DARPA/SPAWAR contract N66001-01-C-8035 63.Pq Dq CBOSS , 64as part of the DARPA CHATS research program. 65.Pp 66The OpenPAM library is maintained by 67.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no . 68