*** UNIX MANUAL PAGE BROWSER ***

getenv(3) Library Functions Manual getenv(3) NAME getenv - Returns the value of an environment variable LIBRARY Standard C Library (libc.so, libc.a) SYNOPSIS #include <stdlib.h> char *getenv( const char *name); STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: getenv(): XPG4, XPG4-UNIX Refer to the standards(5) reference page for more information about in- dustry standards and associated tags. PARAMETERS Specifies the name of an environment variable. DESCRIPTION The getenv() function searches the environment list for a string of the form name=value, and returns a pointer to a string containing the cor- responding value for name. The returned string should not be modified by the application, but may be overwritten by a subsequent call to the getenv() or putenv() func- tions. RETURN VALUES The getenv() function returns a pointer to a string containing the value in the current environment if such a string is present. If such a string is not present, a null pointer is returned. RELATED INFORMATION Functions: putenv(3), clearenv(3) Commands: sh(1) Standards: standards(5) delim off getenv(3)