doc/man/pam_prompt.3

   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
  15 The
  16 .Fn pam_prompt
  17 function constructs a message from the specified format
  18 string and arguments and passes it to the given PAM context's
  19 conversation function.
  20 .Pp
  21 A pointer to the response, or
  22 .Dv NULL
  23 if the conversation function did
  24 not return one, is stored in the location pointed to by the
  25 .Fa resp
  26 argument.
  27 .Pp
  28 See
  29 .Xr pam_vprompt 3
  30 for further details.
  31 .Pp
  32 .Sh RETURN VALUES
  33 The
  34 .Fn pam_prompt
  35 function returns one of the following values:
  36 .Bl -tag -width 18n
  37 .It Bq Er PAM_BUF_ERR
  38 Memory buffer error.
  39 .It Bq Er PAM_CONV_ERR
  40 Conversation failure.
  41 .It Bq Er PAM_SYSTEM_ERR
  42 System 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
  51 The
  52 .Fn pam_prompt
  53 function is an OpenPAM extension.
  54 .Sh AUTHORS
  55 The
  56 .Fn pam_prompt
  57 function and this manual page were
  58 developed for the
  59 .Fx
  60 Project by ThinkSec AS and Network Associates Laboratories, the
  61 Security Research Division of Network Associates, Inc.\& under
  62 DARPA/SPAWAR contract N66001-01-C-8035
  63 .Pq Dq CBOSS ,
  64 as part of the DARPA CHATS research program.
  65 .Pp
  66 The OpenPAM library is maintained by
  67 .An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .