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