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
This commit is contained in:
Sean Farley 2009-12-06 23:51:27 +00:00
parent cd53fc8e5f
commit ef6ccfb52a

View File

@ -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 ,