xref: /netbsd-src/external/bsd/openpam/dist/doc/man/pam_getenv.3 (revision 627f7eb200a4419d89b531d55fccd2ee3ffdcde0)
1.\"	$NetBSD: pam_getenv.3,v 1.8 2019/12/15 17:08:21 christos Exp $
2.\"
3.\" Generated from pam_getenv.c by gendoc.pl
4.\" $OpenPAM: pam_getenv.c 944 2019-02-22 09:49:12Z des $
5.Dd February 24, 2019
6.Dt PAM_GETENV 3
7.Os
8.Sh NAME
9.Nm pam_getenv
10.Nd retrieve the value of a PAM environment variable
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.Sh RETURN VALUES
25The
26.Fn pam_getenv
27function returns
28.Dv NULL
29on failure.
30.Sh SEE ALSO
31.Xr getenv 3 ,
32.Xr pam 3 ,
33.Xr pam_getenvlist 3 ,
34.Xr pam_putenv 3 ,
35.Xr pam_setenv 3
36.Sh STANDARDS
37.Rs
38.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
39.%D "June 1997"
40.Re
41.Sh AUTHORS
42The
43.Fn pam_getenv
44function and this manual page were
45developed for the
46.Fx
47Project by ThinkSec AS and Network Associates Laboratories, the
48Security Research Division of Network Associates, Inc.\& under
49DARPA/SPAWAR contract N66001-01-C-8035
50.Pq Dq CBOSS ,
51as part of the DARPA CHATS research program.
52.Pp
53The OpenPAM library is maintained by
54.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
55