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