NAME    [Toc]    [Back]

       getenv - Return the value of an environment variable

SYNOPSIS    [Toc]    [Back]

       #include <stdlib.h>

       char *getenv(
               const char *name );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       getenv():  XPG4, XPG4-UNIX

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Specifies the name of an environment variable.

DESCRIPTION    [Toc]    [Back]

       The  getenv() function searches the environment list for a
       string of the form name=value, and returns a pointer to  a
       string containing the corresponding 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() functions from the same thread.

RETURN VALUES    [Toc]    [Back]

       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.

SEE ALSO    [Toc]    [Back]

       Functions: putenv(3), clearenv(3)

       Commands: sh(1)

       Standards: standards(5)



                                                        getenv(3)