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