summaryrefslogtreecommitdiffstats
path: root/man3/getenv.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/getenv.3')
-rw-r--r--man3/getenv.321
1 files changed, 10 insertions, 11 deletions
diff --git a/man3/getenv.3 b/man3/getenv.3
index 705eb43..50b17cf 100644
--- a/man3/getenv.3
+++ b/man3/getenv.3
@@ -11,7 +11,7 @@
.\" Modified Sat Jul 24 19:30:29 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Fri Feb 14 21:47:50 1997 by Andries Brouwer (aeb@cwi.nl)
.\"
-.TH getenv 3 2023-07-20 "Linux man-pages 6.05.01"
+.TH getenv 3 2023-10-31 "Linux man-pages 6.7"
.SH NAME
getenv, secure_getenv \- get an environment variable
.SH LIBRARY
@@ -20,16 +20,16 @@ Standard C library
.SH SYNOPSIS
.nf
.B #include <stdlib.h>
-.PP
+.P
.BI "char *getenv(const char *" name );
.BI "char *secure_getenv(const char *" name );
.fi
-.PP
+.P
.RS -4
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.RE
-.PP
+.P
.BR secure_getenv ():
.nf
_GNU_SOURCE
@@ -43,7 +43,7 @@ environment variable
and returns a pointer to the corresponding
.I value
string.
-.PP
+.P
The GNU-specific
.BR secure_getenv ()
function is just like
@@ -60,10 +60,10 @@ set-group-ID program);
the effective capability bit was set on the executable file; or
.IP \[bu]
the process has a nonempty permitted capability set.
-.PP
+.P
Secure execution may also be required if triggered
by some Linux security modules.
-.PP
+.P
The
.BR secure_getenv ()
function is intended for use in general-purpose libraries
@@ -90,7 +90,6 @@ T{
.BR secure_getenv ()
T} Thread safety MT-Safe env
.TE
-.sp 1
.SH STANDARDS
.TP
.BR getenv ()
@@ -107,13 +106,13 @@ POSIX.1-2001, C89, C99, SVr4, 4.3BSD.
glibc 2.17.
.SH NOTES
The strings in the environment list are of the form \fIname=value\fP.
-.PP
+.P
As typically implemented,
.BR getenv ()
returns a pointer to a string within the environment list.
The caller must take care not to modify this string,
since that would change the environment of the process.
-.PP
+.P
The implementation of
.BR getenv ()
is not required to be reentrant.
@@ -126,7 +125,7 @@ and can be modified by a subsequent call to
.BR setenv (3),
or
.BR unsetenv (3).
-.PP
+.P
The "secure execution" mode of
.BR secure_getenv ()
is controlled by the