OSF

NAME

clearenv − Clears the process environment

LIBRARY

Standard C Library (libc.a)

SYNOPSIS

#include <stdlib.h>
int clearenv ( void );

DESCRIPTION

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

AES Support Level:
Trial use

RETURN VALUES

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. 

RELATED INFORMATION

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