clearenv.3c (2010 09)

c
clearenv(3C) clearenv(3C)
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().
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.
SEE ALSO
environ(5), getenv(3C), putenv(3C), thread_safety(5), <stdlib.h>.
STANDARDS CONFORMANCE
clearenv(): AES
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1