ENV(1)

ENV(1) | General Commands Manual | ENV(1)

# NAME

`env` —
set and print environment

# SYNOPSIS

`env` | [`-0i`] [`-u` name] [name=value ...] [utility [argument ...]]

# DESCRIPTION

`env` executes utility after modifying the environment as specified on the command line. The option name=value specifies an environmental variable, name, with a value of value. The option ‘`-i`’ causes `env` to completely ignore the environment it inherits.

The option ‘`-u` name’ causes removal of the name environment variable if it is in the environment. This is similar to the `unset` command in sh(1). The value for name must not include the ‘`=`’ character.

If no utility is specified, `env` prints out the names and values of the variables in the environment. Each name=value pair is separated by a new line unless `-0` is specified, in which case name/value pairs are separated by NUL. Both `-0` and utility must not be specified together.

# EXIT STATUS

`env` exits with one of the following values:

0
  utility was invoked and completed successfully. In this case the exit code is returned by the utility itself, not `env`. If no utility was specified, then `env` completed successfully and returned the exit code itself.
1
  An invalid command line option was passed to `env`.
1-125
  utility was invoked, but failed in some way; see its manual page for more information. In this case the exit code is returned by the utility itself, not `env`.
125
  utility was specified together with the `-0` option.
126
  utility was found, but could not be invoked.
127
  utility could not be found.

# COMPATIBILITY

The historic `-` option has been deprecated but is still supported in this implementation.

The `-u` and `-0` options are non-standard extensions.

# SEE ALSO

execvp(3), environ(7)

# STANDARDS

The `env` utility conforms to IEEE Std 1003.2-1992 (“POSIX.2”).

# HISTORY

The `env` command appeared in 4.4BSD.

The `-u` and `-0` options first appeared in NetBSD 10.

# BUGS

`env` doesn't handle commands with equal (“=”) signs in their names, for obvious reasons.

February 8, 2020 | NetBSD 10.0