|GETENV(3)||Library Functions Manual||GETENV(3)|
char *name, const char
getenv() function obtains the current
value of the environment variable name. If the
variable name is not in the current environment, a
null pointer is returned.
setenv() function inserts or resets
the environment variable name in the current
environment list. If the variable name does not exist
in the list, it is inserted with the given value. If
the variable does exist, the argument overwrite is
tested; if overwrite is zero, the variable is not
reset, otherwise it is reset to the given value.
putenv() function takes an argument of
the form name=value. The memory
pointed to by string becomes part of the environment
and must not be deallocated by the caller. If the variable already exists,
it will be overwritten. A common source of bugs is to pass a
string argument that is a locally scoped string
buffer. This will result in corruption of the environment after leaving the
scope in which the variable is defined. For this reason, the
setenv() function is preferred over
unsetenv() function deletes all
instances of the variable name pointed to by name from
unsetenv() functions return the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.
getenv() function returns a pointer to
the requested value, or
NULL if it could not be
getenv() is successful, the string
returned should be considered read-only.
unsetenv() function was passed an empty name or a NULL pointer, or was passed a name containing an ‘=’ character.
putenv() function was passed a
string that did not contain an ‘=’
putenv() function failed because it was unable to allocate memory for the environment.
getenv() function conforms to ANSI X3.159-1989 (“ANSI C89”). The
unsetenv() functions conform to IEEE Std 1003.1-2008 (“POSIX.1”).
getenv() appeared in Version 7 AT&T UNIX and 3BSD. The functions
unsetenv() appeared in 4.3BSD-Tahoe. The
putenv() function appeared in 4.3BSD-Reno.
getenv() to read untrusted environment variables in setuid programs. The
issetugid() function is provided for this purpose.
|July 11, 2014||OpenBSD-current|