HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

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 indi-
cate 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 2: December 2007 Update − 1 − Hewlett-Packard Company 185