summaryrefslogtreecommitdiffstats
path: root/lib/libc/stdlib
diff options
context:
space:
mode:
authorscf <scf@FreeBSD.org>2009-12-06 23:51:27 +0000
committerscf <scf@FreeBSD.org>2009-12-06 23:51:27 +0000
commit07b9b1d87c9c827c726ff5d99e9faa57bca3a7ab (patch)
tree2907d5992496149c84ac8d074105fbfc5f3504a5 /lib/libc/stdlib
parented12b259e2e717d077258df5ecd9bb0fe47226d3 (diff)
downloadFreeBSD-src-07b9b1d87c9c827c726ff5d99e9faa57bca3a7ab.zip
FreeBSD-src-07b9b1d87c9c827c726ff5d99e9faa57bca3a7ab.tar.gz
Update the getenv(3) man page to reflect the recent change to the behavior
of setenv(), putenv() and unsetenv() when dealing with corrupt entries in environ. They now output a warning and complete their task without error. MFC after: 1 week
Diffstat (limited to 'lib/libc/stdlib')
-rw-r--r--lib/libc/stdlib/getenv.318
1 files changed, 9 insertions, 9 deletions
diff --git a/lib/libc/stdlib/getenv.3 b/lib/libc/stdlib/getenv.3
index 33d9c36..fd7d856 100644
--- a/lib/libc/stdlib/getenv.3
+++ b/lib/libc/stdlib/getenv.3
@@ -107,6 +107,15 @@ function
deletes all instances of the variable name pointed to by
.Fa name
from the list.
+.Pp
+If corruption (e.g., a name without a value) is detected while making a copy of
+environ for internal usage, then
+.Fn setenv ,
+.Fn unsetenv
+and
+.Fn putenv
+will output a warning to stderr about the issue, drop the corrupt entry and
+complete the task without error.
.Sh RETURN VALUES
The
.Fn getenv
@@ -159,15 +168,6 @@ The function
or
.Fn putenv
failed because they were unable to allocate memory for the environment.
-.It Bq Er EFAULT
-The functions
-.Fn setenv ,
-.Fn unsetenv
-or
-.Fn putenv
-failed to make a valid copy of the environment due to the environment being
-corrupt (i.e., a name without a value). A warning will be output to stderr with
-information about the issue.
.El
.Sh SEE ALSO
.Xr csh 1 ,
OpenPOWER on IntegriCloud