Click this button to go to the index for this section.

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 standards
  as follows:

  getenv():  XPG4, XPG4-UNIX

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

PARAMETERS
  name	    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
  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.

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)