NAME    [Toc]    [Back]

       clearenv - Clears the process environment

SYNOPSIS    [Toc]    [Back]

       #include <stdlib.h>

       int clearenv(
               void );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

DESCRIPTION    [Toc]    [Back]

       The  clearenv()  function  clears the process environment.
       No environment variables are defined immediately  after  a
       call to clearenv(). The clearenv() function sets the value
       of the external variable environ to NULL.

NOTES    [Toc]    [Back]

       Trial use

RETURN VALUES    [Toc]    [Back]

       Upon  successful  completion,  the   clearenv()   function
       returns 0 (zero). Otherwise, it returns -1.

       If  environ  has  been modified by anything other than the
       putenv(),  getenv(),   or   clearenv()   functions,   then
       clearenv()  will  return an error and the process environment
 will remain unchanged.

SEE ALSO    [Toc]    [Back]

       Functions: exec(2), getenv(3), putenv(3)



                                                      clearenv(3)