contrib/openpam/doc/man/pam_set_item.3

   1 .\" Generated from pam_set_item.c by gendoc.pl
   2 .\" $OpenPAM: pam_set_item.c 938 2017-04-30 21:34:42Z des $
   3 .Dd April 30, 2017
   4 .Dt PAM_SET_ITEM 3
   5 .Os
   6 .Sh NAME
   7 .Nm pam_set_item
   8 .Nd set authentication information
   9 .Sh SYNOPSIS
  10 .In sys/types.h
  11 .In security/pam_appl.h
  12 .Ft "int"
  13 .Fn pam_set_item "pam_handle_t *pamh" "int item_type" "const void *item"
  14 .Sh DESCRIPTION
  15 The
  16 .Fn pam_set_item
  17 function sets the item specified by the
  18 .Fa item_type
  19 argument to a copy of the object pointed to by the
  20 .Fa item
  21 argument.
  22 The item is stored in the PAM context specified by the
  23 .Fa pamh
  24 argument.
  25 See
  26 .Xr pam_get_item 3
  27 for a list of recognized item types.
  28 .Sh RETURN VALUES
  29 The
  30 .Fn pam_set_item
  31 function returns one of the following values:
  32 .Bl -tag -width 18n
  33 .It Bq Er PAM_SUCCESS
  34 Success.
  35 .It Bq Er PAM_BAD_ITEM
  36 Unrecognized or restricted item.
  37 .It Bq Er PAM_BUF_ERR
  38 Memory buffer error.
  39 .El
  40 .Sh SEE ALSO
  41 .Xr pam 3 ,
  42 .Xr pam_get_item 3 ,
  43 .Xr pam_strerror 3
  44 .Sh STANDARDS
  45 .Rs
  46 .%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
  47 .%D "June 1997"
  48 .Re
  49 .Sh AUTHORS
  50 The
  51 .Fn pam_set_item
  52 function and this manual page were
  53 developed for the
  54 .Fx
  55 Project by ThinkSec AS and Network Associates Laboratories, the
  56 Security Research Division of Network Associates, Inc.\& under
  57 DARPA/SPAWAR contract N66001-01-C-8035
  58 .Pq Dq CBOSS ,
  59 as part of the DARPA CHATS research program.
  60 .Pp
  61 The OpenPAM library is maintained by
  62 .An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .