env(1) — AIX PS/2 1.2.1



ENV, PRINTENV(1,C)          AIX Commands Reference           ENV, PRINTENV(1,C)



-------------------------------------------------------------------------------
env, printenv



PURPOSE

Displays current environment or sets the environment for the execution of a
command.

SYNTAX


       +------------------------------------+
env ---| +-----+                            |---|
       +-|     |--- name=value --- command -+
         +- - -+ ^              |
                 +--------------+

            +--------+
printenv ---|        |---|
            +- name -+


DESCRIPTION

The env command lets you get and change your current environment, and then run
the named command with the changed environment.  Changes in the form name=value
are added to the current environment before the command is run.  If - (minus)
is used, the current environment is ignored and the command runs with only the
changed environment.  Changes are only in effect while the named command is
running.

If a command is not specified, env displays your current environment one
name=value pair per line.

Printenv displays the values of the variables in the environment.  If a name is
specified, only its value is printed.  If a name is not specified, printenv
displays the current environment, one name = value per line.

If a name is specified and it is not defined in the environment, printenv
returns exit status 1, else it returns status 0.

EXAMPLES

  1. To add a shell variable to the environment for the duration of one
    command:

      TZ=MST7MDT date
      env TZ=MST7MDT date





Processed November 8, 1990    ENV, PRINTENV(1,C)                              1



ENV, PRINTENV(1,C)          AIX Commands Reference           ENV, PRINTENV(1,C)



    Each of these commands displays the current date and time in Mountain
    Standard Time.  The two commands shown are equivalent. When date is
    finished, the previous value of TZ takes effect again.

  2. To replace the environment with another one:

      env - PATH=$PATH IDIR=/u/jim/include LIBDIR=/u/jim/lib make

    This runs make in an environment that consists only of these definitions
    for "PATH", "IDIR", and "LIBDIR".  You must redefine PATH so that the shell
    can find the make command.

    When make is finished, the previous environment takes effect again.

RELATED INFORMATION

See the following commands:  "sh, Rsh" and "csh."

See exec system call, the profile file, and the environ miscellaneous facility
in AIX Operating System Technical Reference.

COMPATIBILITY NOTE

The env and the printenv commands without parameters provide the same function.































Processed November 8, 1990    ENV, PRINTENV(1,C)                              2

Museum

Related Articles