contrib/openpam/doc/man/openpam_nullconv.3

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