NAME

env - Set each NAME to VALUE in the environment and run COMMAND

SYNOPSIS

env [-i|--ignore-environment] [-C|--chdir] [-0|--null] [-f|--file] [-u|--unset] [-v|--debug]... [-S|--split-string] [-a|--argv0] [--ignore-signal] [--default-signal] [--block-signal] [--list-signal-handling] [-h|--help] [-V|--version] [vars]

DESCRIPTION

Set each NAME to VALUE in the environment and run COMMAND

OPTIONS

-i, --ignore-environment

start with an empty environment

-C, --chdir <DIR>

change working directory to DIR

-0, --null

end each output line with a 0 byte rather than a newline (only valid when printing the environment)

-f, --file <PATH>

read and set variables from a ".env"-style configuration file (prior to any unset and/or set)

-u, --unset <NAME>

remove variable from the environment

-v, --debug

print verbose information for each processing step

-S, --split-string <S>

process and split S into separate arguments; used to pass multiple arguments on shebang lines

-a, --argv0 <a>

Override the zeroth argument passed to the command being executed. Without this option a default value of `command` is used.

--ignore-signal[=<SIG>]

set handling of SIG signal(s) to do nothing

--default-signal[=<SIG>]

reset handling of SIG signal(s) to the default action

--block-signal[=<SIG>]

block delivery of SIG signal(s) while running COMMAND

--list-signal-handling

list signal handling changes requested by preceding options

-h, --help

Print help

-V, --version

Print version

[vars]

EXTRA

A mere - implies -i. If no COMMAND, print the resulting environment.

VERSION

v(uutils coreutils) 0.10.0

EXAMPLES

Show the environment:

env

Run a program. Often used in scripts after the shebang (#!) for looking up the path to the program:

env program

Clear the environment and run a program:

env [-i|--ignore-environment] program

Remove variable from the environment and run a program:

env [-u|--unset] variable program

Set a variable and run a program:

env variable=value program

Set one or more variables and run a program:

env variable1=value variable2=value variable3=value ... program

Run a program under a different name:

env [-a|--argv0] custom_name program

The examples are provided by the tldr-pages project <https://tldr.sh> under the CC BY 4.0 License. Please note that, as uutils is a work in progress, some examples might fail.