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 February 24, 2019
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
15The
16.Fn pam_set_item
17function sets the item specified by the
18.Fa item_type
19argument to a copy of the object pointed to by the
20.Fa item
21argument.
22The item is stored in the PAM context specified by the
23.Fa pamh
24argument.
25See
26.Xr pam_get_item 3
27for a list of recognized item types.
28.Sh RETURN VALUES
29The
30.Fn pam_set_item
31function returns one of the following values:
32.Bl -tag -width 18n
33.It Bq Er PAM_SUCCESS
34Success.
35.It Bq Er PAM_BAD_ITEM
36Unrecognized or restricted item.
37.It Bq Er PAM_BUF_ERR
38Memory 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
50The
51.Fn pam_set_item
52function and this manual page were
53developed for the
54.Fx
55Project by ThinkSec AS and Network Associates Laboratories, the
56Security Research Division of Network Associates, Inc.\& under
57DARPA/SPAWAR contract N66001-01-C-8035
58.Pq Dq CBOSS ,
59as part of the DARPA CHATS research program.
60.Pp
61The OpenPAM library is maintained by
62.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
63