.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH ENV "1" "July 2018" "GNU coreutils 8.30" "User Commands"
.SH NAME
env \- run a program in a modified environment
.SH SYNOPSIS
.B env
[\fI\,OPTION\/\fR]... [\fI\,-\/\fR] [\fI\,NAME=VALUE\/\fR]... [\fI\,COMMAND \/\fR[\fI\,ARG\/\fR]...]
.SH DESCRIPTION
.\" Add any additional description here
.PP
Set each NAME to VALUE in the environment and run COMMAND.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\fB\-i\fR, \fB\-\-ignore\-environment\fR
start with an empty environment
.TP
\fB\-0\fR, \fB\-\-null\fR
end each output line with NUL, not newline
.TP
\fB\-u\fR, \fB\-\-unset\fR=\fI\,NAME\/\fR
remove variable from the environment
.TP
\fB\-C\fR, \fB\-\-chdir\fR=\fI\,DIR\/\fR
change working directory to DIR
.TP
\fB\-S\fR, \fB\-\-split\-string\fR=\fI\,S\/\fR
process and split S into separate arguments;
used to pass multiple arguments on shebang lines
.TP
\fB\-v\fR, \fB\-\-debug\fR
print verbose information for each processing step
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
A mere \- implies \fB\-i\fR.  If no COMMAND, print the resulting environment.
.SH OPTIONS
.SS "\-S/\-\-split\-string usage in scripts"
The
.B \-S
option allows specifing multiple parameters in a script.
Running a script named
.B 1.pl
containing the following first line:
.PP
.RS
.nf
#!/usr/bin/env \-S perl \-w \-T
...
.fi
.RE
.PP
Will execute
.B "perl \-w \-T 1.pl".
.PP
Without the
.B '\-S'
parameter the script will likely fail with:
.PP
.RS
.nf
/usr/bin/env: 'perl \-w \-T': No such file or directory
.fi
.RE
.PP
See the full documentation for more details.
.SH AUTHOR
Written by Richard Mlynarik, David MacKenzie, and Assaf Gordon.
.SH "REPORTING BUGS"
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
.br
Report env translation bugs to <https://translationproject.org/team/>
.SH COPYRIGHT
Copyright \(co 2018 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
Full documentation at: <https://www.gnu.org/software/coreutils/env>
.br
or available locally via: info \(aq(coreutils) env invocation\(aq
