Env

env
Operating systemUnix, Unix-like, Inferno
PlatformCross-platform
TypeCommand
Licensecoreutils: GPLv3+

env is a shell command for Unix and Unix-like operating systems. It is used to either print a list of environment variables or run another utility in an altered environment without having to modify the currently existing environment. Using env, variables may be added or removed, and existing variables may be changed by assigning new values to them.

In practice, env has another common use. It is often used by shell scripts to launch the correct interpreter. In this usage, the environment is typically not changed.

History

The version of env bundled in GNU coreutils was written by Richard Mlynarik, David MacKenzie, and Assaf Gordon.[1] It first appeared in 4.4BSD, and is a part of POSIX.1 (with the -i option only).[2]

GNU's env has been extended to handle signals and the current directory.[1] FreeBSD's env supports a custom search path. Extensions found in both versions include -u, for unsetting variables, and -S, for splitting arguments (mainly in shebang).[2]

Examples

To print out the set of current environment variables:

env

To create a new environment without any existing environment variables for a new shell:

env -i /bin/sh

To execute the X application xcalc and have it appear on a different display (i.e., with a modified environment whether the specified environment variable is replaced with the new value):

env DISPLAY=foo.bar:1.0 xcalc

Note that this use of env is often unnecessary since most shells support setting environment variables in front of a command:

DISPLAY=foo.bar:1.0 xcalc

env may also be used in the hashbang line of a script to allow the interpreter to be looked up via the PATH. For example, here is the code of a Python script:

#!/usr/bin/env python3
print("Hello, World!")

In this example, /usr/bin/env is the full path of the env command. The environment is not altered.

Note that it is possible to specify the interpreter without using env, by giving the full path of the python interpreter. A problem with that approach is that on different computer systems, the exact path may be different. By instead using env as in the example, the interpreter is searched for and located at the time the script is run (more precisely, env does a system call to execvp, which does the job of locating the interpreter and launching it). This makes the script more portable, but also increases the risk that the wrong interpreter is selected because it searches for a match in every directory on the executable search path. It also suffers from the same problem in that the path to the env binary may also be different on a per-machine basis.

See also

References

  1. ^ a b env(1) – Linux User Manual – User Commands
  2. ^ a b env(1) – FreeBSD General Commands Manual