Page Menu
Home
FreeBSD
Search
Configure Global Search
Log In
Files
F174670816
D39078.id118809.diff
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Mute Notifications
Flag For Later
Award Token
Size
1 KB
Referenced Files
None
Subscribers
None
D39078.id118809.diff
View Options
diff --git a/lib/libc/stdlib/getenv.3 b/lib/libc/stdlib/getenv.3
--- a/lib/libc/stdlib/getenv.3
+++ b/lib/libc/stdlib/getenv.3
@@ -32,7 +32,7 @@
.\" @(#)getenv.3 8.2 (Berkeley) 12/11/93
.\" $FreeBSD$
.\"
-.Dd March 13, 2023
+.Dd March 14, 2023
.Dt GETENV 3
.Os
.Sh NAME
@@ -81,19 +81,16 @@
.Fn getenv
function.
.Pp
-The GNU-specific function,
-.Fn secure_getenv
-wraps the
-.Fn getenv
-function to prevent it from being run in "secure execution".
-Unlike in glibc,
+The
.Fn secure_getenv
-only checks if the
-.Fa setuid
-and
-.Fa setgid
-bits have been set or changed.
-These checks are subject to extension and change.
+returns
+.Va NULL
+when the environment cannot be trusted, otherwise it acts like
+.Fn getenv .
+The environment currently not trusted when
+.Xr issetugid 3
+returns a non-zero value, but other conditions may be added
+in the future.
.Pp
The
.Fn setenv
@@ -222,6 +219,9 @@
.Fn unsetenv
functions conforms to
.St -p1003.1-2001 .
+The
+.Fn secure_getenv
+function is expected to be glibc compatible.
.Sh HISTORY
The functions
.Fn setenv
@@ -249,7 +249,9 @@
.Pp
The
.Fn clearenv
-was added in
+and
+.Fn secure_getenv
+functions were added in
.Fx 14 .
.Sh BUGS
Successive calls to
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Tue, Oct 6, 2:27 AM (2 h, 10 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
40273693
Default Alt Text
D39078.id118809.diff (1 KB)
Attached To
Mode
D39078: secure_getenv: Improve documentation wording
Attached
Detach File
Event Timeline
Log In to Comment