1ENV(1) User Commands ENV(1)
2
3
4
6 env - run a program in a modified environment
7
9 env [OPTION]... [-] [NAME=VALUE]... [COMMAND [ARG]...]
10
12 Set each NAME to VALUE in the environment and run COMMAND.
13
14 Mandatory arguments to long options are mandatory for short options
15 too.
16
17 -i, --ignore-environment
18 start with an empty environment
19
20 -0, --null
21 end each output line with NUL, not newline
22
23 -u, --unset=NAME
24 remove variable from the environment
25
26 -C, --chdir=DIR
27 change working directory to DIR
28
29 -S, --split-string=S
30 process and split S into separate arguments; used to pass multi‐
31 ple arguments on shebang lines
32
33 -v, --debug
34 print verbose information for each processing step
35
36 --help display this help and exit
37
38 --version
39 output version information and exit
40
41 A mere - implies -i. If no COMMAND, print the resulting environment.
42
44 -S/--split-string usage in scripts
45 The -S option allows specifing multiple parameters in a script. Run‐
46 ning a script named 1.pl containing the following first line:
47
48 #!/usr/bin/env -S perl -w -T
49
50 Will execute perl -w -T 1.pl .
51
52 Without the '-S' parameter the script will likely fail with:
53
54 /usr/bin/env: 'perl -w -T': No such file or directory
55
56 See the full documentation for more details.
57
59 Written by Richard Mlynarik, David MacKenzie, and Assaf Gordon.
60
62 GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
63 Report env translation bugs to <https://translationproject.org/team/>
64
66 Copyright © 2018 Free Software Foundation, Inc. License GPLv3+: GNU
67 GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
68 This is free software: you are free to change and redistribute it.
69 There is NO WARRANTY, to the extent permitted by law.
70
72 Full documentation at: <https://www.gnu.org/software/coreutils/env>
73 or available locally via: info '(coreutils) env invocation'
74
75
76
77GNU coreutils 8.30 July 2018 ENV(1)