c_cpp/lib/gnulib/doc/posix-functions/unsetenv.texi

   1 @node unsetenv
   2 @section @code{unsetenv}
   3 @findex unsetenv
   4
   5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/unsetenv.html}
   6
   7 Gnulib module: unsetenv
   8
   9 Portability problems fixed by Gnulib:
  10 @itemize
  11 @item
  12 This function is missing on some platforms:
  13 AIX 5.1, HP-UX 11.23, IRIX 6.5, Solaris 9, mingw, MSVC 9, BeOS.
  14 @item
  15 This function is not declared on some platforms:
  16 OSF/1 5.1.
  17 @item
  18 This function has the return type @samp{void} instead of @samp{int} on some
  19 platforms:
  20 Mac OS X 10.3, FreeBSD 6.0, NetBSD 1.6, OpenBSD 3.8, OSF/1 5.1.
  21 @item
  22 On some platforms, this function does not fail with @samp{EINVAL} when
  23 passed an empty string or a string containing @samp{=}:
  24 FreeBSD 6.0, NetBSD 1.6, OpenBSD 4.7.
  25 @item
  26 This function removes only the first value association for the given
  27 environment variable, not all of them, on some platforms:
  28 Solaris 11 2011-11, Haiku.
  29 @end itemize
  30
  31 Portability problems not fixed by Gnulib:
  32 @itemize
  33 @item
  34 Older versions of POSIX required that @code{unsetenv(NULL)} gracefully
  35 fail with @code{EINVAL}, but not all implementations guarantee this,
  36 and the requirement was removed.
  37 @end itemize