diff options
Diffstat (limited to '')
| -rw-r--r-- | man/env.1 | 86 |
1 files changed, 86 insertions, 0 deletions
diff --git a/man/env.1 b/man/env.1 new file mode 100644 index 0000000..fe240d7 --- /dev/null +++ b/man/env.1 @@ -0,0 +1,86 @@ +.\" 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 |