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