OSF

NAME

putenv − Sets an environment variable

LIBRARY

Standard C Library (libc.a)

SYNOPSIS

#include <stdlib.h>

int putenv (
char ∗string );

PARAMETERS

stringPoints to a name=value string. 

DESCRIPTION

The putenv() function sets the value of an environment variable 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 variable, 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)