svn commit: r200195 - head/lib/libc/stdlib

[Sean Farley]

Author: scf
Date: Sun Dec  6 23:51:27 2009
New Revision: 200195
URL: http://svn.freebsd.org/changeset/base/200195

Log:
  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

Modified:
  head/lib/libc/stdlib/getenv.3

Modified: head/lib/libc/stdlib/getenv.3
==============================================================================
--- head/lib/libc/stdlib/getenv.3	Sun Dec  6 23:48:38 2009	(r200194)
+++ head/lib/libc/stdlib/getenv.3	Sun Dec  6 23:51:27 2009	(r200195)
@@ -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 ,