From 6ab0fbfc84836b695413c7d20c2db2d870d2331e Mon Sep 17 00:00:00 2001 From: Andreas Jaeger Date: Sun, 8 Apr 2012 19:43:41 +0200 Subject: Document return values of putenv and setenv [BZ #10153] * manual/startup.texi (Environment Access): Describe return value for putenv and setenv. --- manual/startup.texi | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'manual') diff --git a/manual/startup.texi b/manual/startup.texi index 93dca30..ed75e7b 100644 --- a/manual/startup.texi +++ b/manual/startup.texi @@ -335,6 +335,9 @@ definition is added to the environment. Otherwise, the @var{string} is interpreted as the name of an environment variable, and any definition for this variable in the environment is removed. +If the function is successful it returns @code{0}. Otherwise the return +value is nonzero and @code{errno} is set to indicate the error. + The difference to the @code{setenv} function is that the exact string given as the parameter @var{string} is put into the environment. If the user should change the string after the @code{putenv} call this will @@ -364,6 +367,10 @@ the old entry is replaced by the new one. Please note that you cannot remove an entry completely using this function. +If the function is successful it returns @code{0}. Otherwise the +environment is unchanged and the return value is @code{-1} and +@code{errno} is set. + This function was originally part of the BSD library but is now part of the Unix standard. @end deftypefun -- cgit v1.1