NAME
env, printenv - Displays or sets the current environment, or
displays the values of environment variables
SYNOPSIS
env [-] [name=value ...] [command] [argument ...]
printenv [name]
FLAGS
- Invokes command with the environment specified by the
arguments; env ignores the inherited environment.
(Obsolescent)
DESCRIPTION
The env command lets you get and change your current
environment, and then run the specified command with the
changed environment. Changes in the form name=value are
added to the current environment before the command is run.
If the -i flag is used, the current environment is ignored
and the command runs with only the changed environment.
Changes are only in effect while the specified command is
running.
If command is not specified, env displays your current
environment, one name=value pair per line.
The printenv command displays the values of the variables in
the environment. If name is specified, only its value is
printed. If name is not specified, printenv displays the
current environment, one name=value per line.
EXAMPLES
1. To add a shell variable to the environment for the
duration of one command (sh only), enter:
TZ=MST7MDT date
env TZ=MST7MDT date
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, enter:
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 com-
mand.
When make is finished, the previous environment takes
effect again.
3. To find the current setting of the TERM environment
variable, enter:
printenv TERM
The command returns the value for the TERM environment
variable.
EXIT VALUES
The env command exists with the following values:
0 The env command completed successfully.
127 An error occurred for the env command or command could
not be invoked.
If name is specified and it is not defined in the environ-
ment, printenv returns exit status 1; otherwise, printenv
returns status 0 (zero).
RELATED INFORMATION
Commands: csh(1), ksh(1), sh(1).
Functions: exec(2).
"Using Internationalization Features" in the OSF/1 User's
Guide.
Acknowledgement and Disclaimer