xref: /netbsd-src/external/bsd/openpam/dist/doc/man/pam_setenv.3 (revision 82d56013d7b633d116a93943de88e08335357a7c)
1.\"	$NetBSD: pam_setenv.3,v 1.8 2019/12/15 17:08:21 christos Exp $
2.\"
3.\" Generated from pam_setenv.c by gendoc.pl
4.\" $OpenPAM: pam_setenv.c 938 2017-04-30 21:34:42Z des $
5.Dd February 24, 2019
6.Dt PAM_SETENV 3
7.Os
8.Sh NAME
9.Nm pam_setenv
10.Nd mirrors setenv(3)
11.Sh SYNOPSIS
12.In sys/types.h
13.In security/pam_appl.h
14.Ft "int"
15.Fn pam_setenv "pam_handle_t *pamh" "const char *name" "const char *value" "int overwrite"
16.Sh DESCRIPTION
17The
18.Fn pam_setenv
19function sets an environment variable.
20Its semantics are similar to those of
21.Xr setenv 3 ,
22but it modifies the PAM
23context's environment list instead of the application's.
24.Sh RETURN VALUES
25The
26.Fn pam_setenv
27function returns one of the following values:
28.Bl -tag -width 18n
29.It Bq Er PAM_SUCCESS
30Success.
31.It Bq Er PAM_BUF_ERR
32Memory buffer error.
33.It Bq Er PAM_SYSTEM_ERR
34System error.
35.El
36.Sh SEE ALSO
37.Xr pam 3 ,
38.Xr pam_getenv 3 ,
39.Xr pam_getenvlist 3 ,
40.Xr pam_putenv 3 ,
41.Xr pam_strerror 3 ,
42.Xr setenv 3
43.Sh STANDARDS
44The
45.Fn pam_setenv
46function is an OpenPAM extension.
47.Sh AUTHORS
48The
49.Fn pam_setenv
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