xref: /netbsd-src/external/bsd/openpam/dist/doc/man/pam_getenv.3 (revision 0d9d0fd8a30be9a1924e715bbcf67a4a83efd262)
1*0d9d0fd8Schristos.\"	$NetBSD: pam_getenv.3,v 1.9 2023/06/30 21:46:20 christos Exp $
244269bb5Schristos.\"
38fa0fefeSchristos.\" Generated from pam_getenv.c by gendoc.pl
4*0d9d0fd8Schristos.Dd June 27, 2023
544269bb5Schristos.Dt PAM_GETENV 3
644269bb5Schristos.Os
744269bb5Schristos.Sh NAME
844269bb5Schristos.Nm pam_getenv
944269bb5Schristos.Nd retrieve the value of a PAM environment variable
1044269bb5Schristos.Sh SYNOPSIS
1144269bb5Schristos.In sys/types.h
1244269bb5Schristos.In security/pam_appl.h
1344269bb5Schristos.Ft "const char *"
1444269bb5Schristos.Fn pam_getenv "pam_handle_t *pamh" "const char *name"
1544269bb5Schristos.Sh DESCRIPTION
1644269bb5SchristosThe
17e1b25b17Schristos.Fn pam_getenv
1844269bb5Schristosfunction returns the value of an environment variable.
1944269bb5SchristosIts semantics are similar to those of
2044269bb5Schristos.Xr getenv 3 ,
2144269bb5Schristosbut it accesses the PAM
2244269bb5Schristoscontext's environment list instead of the application's.
2344269bb5Schristos.Sh RETURN VALUES
2444269bb5SchristosThe
25e1b25b17Schristos.Fn pam_getenv
2644269bb5Schristosfunction returns
2744269bb5Schristos.Dv NULL
2844269bb5Schristoson failure.
2944269bb5Schristos.Sh SEE ALSO
3044269bb5Schristos.Xr getenv 3 ,
3144269bb5Schristos.Xr pam 3 ,
3244269bb5Schristos.Xr pam_getenvlist 3 ,
3344269bb5Schristos.Xr pam_putenv 3 ,
3444269bb5Schristos.Xr pam_setenv 3
3544269bb5Schristos.Sh STANDARDS
3644269bb5Schristos.Rs
3744269bb5Schristos.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
3844269bb5Schristos.%D "June 1997"
3944269bb5Schristos.Re
4044269bb5Schristos.Sh AUTHORS
4144269bb5SchristosThe
42e1b25b17Schristos.Fn pam_getenv
43e1b25b17Schristosfunction and this manual page were
44e1b25b17Schristosdeveloped for the
4544269bb5Schristos.Fx
46e1b25b17SchristosProject by ThinkSec AS and Network Associates Laboratories, the
4744269bb5SchristosSecurity Research Division of Network Associates, Inc.\& under
4844269bb5SchristosDARPA/SPAWAR contract N66001-01-C-8035
4944269bb5Schristos.Pq Dq CBOSS ,
5044269bb5Schristosas part of the DARPA CHATS research program.
518fa0fefeSchristos.Pp
528fa0fefeSchristosThe OpenPAM library is maintained by
534cb4af11Schristos.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
54