env

env [OPTION]... [-] [NAME=VALUE]... [COMMAND [ARG]...]

Set each NAME to VALUE in the environment and run COMMAND

Options

--ignore-environment, -i

start with an empty environment

--chdir=<DIR>, -C <DIR>

change working directory to DIR

--null, -0

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

--file=<PATH>, -f <PATH>

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

--unset=<NAME>, -u <NAME>

remove variable from the environment

--debug, -v

print verbose information for each processing step

--split-string=<S>, -S <S>

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

--argv0=<a>, -a <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

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

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 under the CC BY 4.0 License.

Please note that, as uutils is a work in progress, some examples might fail.