xref: /freebsd/contrib/openpam/doc/man/pam_putenv.3 (revision ba3c1f5972d7b90feb6e6da47905ff2757e0fe57)
1.\" Generated from pam_putenv.c by gendoc.pl
2.Dd June 27, 2023
3.Dt PAM_PUTENV 3
4.Os
5.Sh NAME
6.Nm pam_putenv
7.Nd set the value of an environment variable
8.Sh SYNOPSIS
9.In sys/types.h
10.In security/pam_appl.h
11.Ft "int"
12.Fn pam_putenv "pam_handle_t *pamh" "const char *namevalue"
13.Sh DESCRIPTION
14The
15.Fn pam_putenv
16function sets an environment variable.
17Its semantics are similar to those of
18.Xr putenv 3 ,
19but it modifies the PAM
20context's environment list instead of the application's.
21.Pp
22.Sh RETURN VALUES
23The
24.Fn pam_putenv
25function returns one of the following values:
26.Bl -tag -width 18n
27.It Bq Er PAM_SUCCESS
28Success.
29.It Bq Er PAM_BUF_ERR
30Memory buffer error.
31.It Bq Er PAM_SYSTEM_ERR
32System error.
33.El
34.Sh SEE ALSO
35.Xr pam 3 ,
36.Xr pam_getenv 3 ,
37.Xr pam_getenvlist 3 ,
38.Xr pam_setenv 3 ,
39.Xr pam_strerror 3 ,
40.Xr putenv 3
41.Sh STANDARDS
42.Rs
43.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
44.%D "June 1997"
45.Re
46.Sh AUTHORS
47The
48.Fn pam_putenv
49function and this manual page were
50developed for the
51.Fx
52Project by ThinkSec AS and Network Associates Laboratories, the
53Security Research Division of Network Associates, Inc.\& under
54DARPA/SPAWAR contract N66001-01-C-8035
55.Pq Dq CBOSS ,
56as part of the DARPA CHATS research program.
57.Pp
58The OpenPAM library is maintained by
59.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
60