NAME
putenv - Sets an environment variable
LIBRARY
Standard C Library (libc.a)
SYNOPSIS
#include <stdlib.h>
int putenv (
char *string );
PARAMETERS
string
Points to a name=value string.
DESCRIPTION
The putenv() function sets the value of an environment vari-
able by altering an existing variable or by creating a new
one. The string parameter points to a string of the form
name=value, where name is the environment variable and value
is the new value for it.
NOTES
The putenv() function manipulates the environ external vari-
able, and it can be used in conjunction with the getenv()
function. However, the third parameter to the main function
(the environment pointer), is not changed.
The putenv() function uses the malloc() function to enlarge
the environment.
AES Support Level: Trial use
RETURN VALUES
Upon successful completion, a value of 0 (zero) is returned.
If the malloc() function is unable to obtain sufficient
space to expand the environment, then the putenv() function
returns a nonzero value.
RELATED INFORMATION
Functions: clearenv(3), exec(2), getenv(3), malloc(3)
Acknowledgement and Disclaimer