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