|GETENV(3)||Library Functions Manual||GETENV(3)|
environment variable functions
char *name, const char
These functions set, unset, and fetch environment variables from the host environment list.
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
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”).
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
function appeared in 4.3BSD-Reno.
Library code must be careful about using
getenv() to read untrusted environment variables in
setuid programs. The
issetugid() function is
provided for this purpose.
|July 11, 2014||OpenBSD-current|