ENV(3) OpenBSD Programmer's Manual GETENV(3)
NAME
getenv, putenv, setenv, unsetenv - environment variable functions
SYNOPSIS
#include <stdlib.h>
char *
getenv(const char *name);
int
setenv(const char *name, const char *value, int overwrite);
int
putenv(const char *string);
void
unsetenv(const char *name);
DESCRIPTION.
RETURN VALUES
The functions setenv() and putenv() return zero if successful; otherwise
the global variable errno is set to indicate the error and a -1 is re-
turned.
If getenv() is successful, the string returned should be considered read-
only.
ERRORS
[ENOMEM] The function setenv() or putenv() failed because they were un-
able to allocate memory for the environment.
SEE ALSO
csh(1), sh(1), execve(2), environ(7)
STANDARDS
The getenv() function conforms to ANSI X3.159-1989 (``ANSI C'').
HISTORY
The functions setenv() and unsetenv() appeared in Version 7 AT&T UNIX.
The putenv() function appeared in 4.3BSD-Reno.
OpenBSD 2.6 December 11, 1993 1