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