CLEARENV(3C) Standard C Library Functions CLEARENV(3C)
clearenv - clear environment
#include <stdlib.h>
int
clearenv(void);
The clearenv() function clears the contents of the environment. All
environment variables in the calling process are removed as though the
function unsetenv(3C) had been called on every environment variable.
Until subsequent calls to putenv(3C) or setenv(3C) are made, calls to
getenv(3C) will always return NULL.
Upon successful completion, clearenv() returns 0. Otherwise, it
returns a non-zero value and sets errno to indicate the error. At this
time, no errors are defined for clearenv(), it will always succeed.
Portable applications should always check the return value of
clearenv().
No errors are defined.
Committed.
MT-LEVEL
Mt-Safe.
getenv(3C), setenv(3C), unsetenv(3C), attributes(7), environ(7),
standards(7)
illumos December 20, 2014 illumos
NAME
clearenv - clear environment
SYNOPSIS
#include <stdlib.h>
int
clearenv(void);
DESCRIPTION
The clearenv() function clears the contents of the environment. All
environment variables in the calling process are removed as though the
function unsetenv(3C) had been called on every environment variable.
Until subsequent calls to putenv(3C) or setenv(3C) are made, calls to
getenv(3C) will always return NULL.
RETURN VALUES
Upon successful completion, clearenv() returns 0. Otherwise, it
returns a non-zero value and sets errno to indicate the error. At this
time, no errors are defined for clearenv(), it will always succeed.
Portable applications should always check the return value of
clearenv().
ERRORS
No errors are defined.
INTERFACE STABILITY
Committed.
MT-LEVEL
Mt-Safe.
SEE ALSO
getenv(3C), setenv(3C), unsetenv(3C), attributes(7), environ(7),
standards(7)
illumos December 20, 2014 illumos