PRINTENV(1) BSD General Commands Manual PRINTENV(1)
printenv, env -- print out the environment, set and print environment
env [-i] [name=value ...] [utility [argument ...]]
The printenv utility prints out the names and values of the variables in the environment,
with one name/value pair per line. If name is specified, only its value is printed.
Some shells may provide a builtin printenv command which is similar or identical to this
utility. Consult the builtin(1) manual page.
The env utility executes utility after modifying the environment as specified on the command
line. The option name=value specifies an environment variable, name, with a value of value.
The options are as follows:
-i Execute the utility with only those environment values specified. The environment
inherited by env is ignored completely.
If no utility is specified, env prints out the names and values of the variables in the
environment, with one name/value pair per line.
The env utility is sometimes useful with the ``#!'' construct (see execve(2)). The only
difference between ``#!/usr/local/bin/foo'' and ``#!/usr/bin/env /usr/local/bin/foo'' is
that the latter works even if /usr/local/bin/foo is itself interpreted. Using env this way
also allows one to reference foo without the path, as well as set up the environment as
The env utility uses the PATH environment variable is used to locate the requested utility
if the name contains no '/' characters.
The printenv utility exits 0 on success, and >0 if an error occurs.
The env utility exits 0 on success, and >0 if an error occurs. An exit status of 126 indi-
cates utility was found, but could not be executed. An exit status of 127 indicates utility
could not be found.
The env utility accepts the - option as a synonym for -i.
csh(1), sh(1), execvp(3), environ(7)
The env utility conforms to IEEE Std 1003.1-2001 (``POSIX.1'').
The printenv command appeared in 3.0BSD.
The env utility doesn't handle utility arguments with equal (``='') signs in their names,
for obvious reasons.
BSD June 6, 1993 BSD