env

This article is about the Unix shell command. For the viral gene, see Env (gene). For other uses, see Env (disambiguation).

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.

env

env command on a Void Linux machine.
Operating system	Unix, Unix-like, Inferno
Platform	Cross-platform
Type	Command
License	coreutils: GPLv3

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. It first appeared in 4.4BSD, and is a part of POSIX.1 (with the -i option only).

GNU's env has been extended to handle signals and the current directory. 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).

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

• set

External links

• env: set the environment for command invocation – Shell and Utilities Reference, The Single UNIX Specification, Version 4 from The Open Group
• env(1) – Inferno General commands Manual
• env—manual page from GNU coreutils.
• env(1) – FreeBSD General Commands Manual
• env(1): run a program in a modified environment – OpenBSD General Commands Manual
• env(1): set and print environment – NetBSD General Commands Manual
• env(1) – Linux User Manual – User Commands
• env(1) – Solaris 11.4 User Commands Reference Manual