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