contrib/openpam/doc/man/pam_get_data.3

   1 .\" Generated from pam_get_data.c by gendoc.pl
   2 .\" $Id: pam_get_data.c 913 2017-01-21 15:11:12Z des $
   3 .Dd February 19, 2017
   4 .Dt PAM_GET_DATA 3
   5 .Os
   6 .Sh NAME
   7 .Nm pam_get_data
   8 .Nd get module information
   9 .Sh SYNOPSIS
  10 .In sys/types.h
  11 .In security/pam_appl.h
  12 .Ft "int"
  13 .Fn pam_get_data "const pam_handle_t *pamh" "const char *module_data_name" "const void **data"
  14 .Sh DESCRIPTION
  15 The
  16 .Fn pam_get_data
  17 function looks up the opaque object associated with
  18 the string specified by the
  19 .Fa module_data_name
  20 argument, in the PAM
  21 context specified by the
  22 .Fa pamh
  23 argument.
  24 A pointer to the object is stored in the location pointed to by the
  25 .Fa data
  26 argument.
  27 If
  28 .Fn pam_get_data
  29 fails, the
  30 .Fa data
  31 argument is untouched.
  32 .Pp
  33 This function and its counterpart
  34 .Xr pam_set_data 3
  35 are useful for managing
  36 data that are meaningful only to a particular service module.
  37 .Sh RETURN VALUES
  38 The
  39 .Fn pam_get_data
  40 function returns one of the following values:
  41 .Bl -tag -width 18n
  42 .It Bq Er PAM_NO_MODULE_DATA
  43 Module data not found.
  44 .El
  45 .Sh SEE ALSO
  46 .Xr pam 3 ,
  47 .Xr pam_set_data 3 ,
  48 .Xr pam_strerror 3
  49 .Sh STANDARDS
  50 .Rs
  51 .%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
  52 .%D "June 1997"
  53 .Re
  54 .Sh AUTHORS
  55 The
  56 .Fn pam_get_data
  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 .