NAME
clearenv — clear the process environment
SYNOPSIS
#include <stdlib.h>
int clearenv(void);
DESCRIPTION
clearenv()
clears the process environment.
No environment variables are defined immediately after a call to
clearenv().
clearenv()
modifies the value of the pointer
environ.
This means that copies of that pointer are invalid
after a call to
clearenv().
APPLICATION USAGE
clearenv()
is thread-safe. It is not async-cancel-safe.
RETURN VALUE
Upon successful completion,
clearenv()
returns zero;
otherwise, it returns -1 and sets
errno
to indicate the error.
ERRORS
clearenv()
fails if the following condition is encountered:
- [ENOMEM]
Failed to free or reallocate memory for the process environment.
STANDARDS CONFORMANCE
clearenv(): AES
