2015-01-23 23:22:06 +00:00
|
|
|
.Dd January 24, 2015
|
2015-01-31 13:20:02 +00:00
|
|
|
.Dt ENV 1
|
2015-01-30 20:17:58 +00:00
|
|
|
.Os
|
2015-01-23 23:22:06 +00:00
|
|
|
.Sh NAME
|
|
|
|
|
.Nm env
|
|
|
|
|
.Nd modify the environment, then print it or run a command
|
|
|
|
|
.Sh SYNOPSIS
|
2015-01-30 20:17:58 +00:00
|
|
|
.Nm
|
2015-01-23 23:22:06 +00:00
|
|
|
.Op Fl i
|
|
|
|
|
.Oo Fl u Ar variable Oc ...
|
|
|
|
|
.Oo Ar variable Ns = Ns Ar value Oc ...
|
|
|
|
|
.Oo Ar cmd Oo arg ... Oc Oc
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
.Nm
|
|
|
|
|
unsets each
|
|
|
|
|
.Ar variable ,
|
|
|
|
|
then adds or sets each
|
|
|
|
|
.Ar ( variable , value )
|
|
|
|
|
tuple in the environment.
|
|
|
|
|
.Pp
|
2013-07-20 05:27:42 +00:00
|
|
|
If
|
2015-01-23 23:22:06 +00:00
|
|
|
.Ar cmd
|
|
|
|
|
is given, it is executed in this new environment;
|
|
|
|
|
otherwise, the modified environment is printed to stdout.
|
|
|
|
|
.Sh OPTIONS
|
|
|
|
|
.Bl -tag -width Ds
|
|
|
|
|
.It Fl i
|
|
|
|
|
Completely ignore the existing environment and execute
|
|
|
|
|
.Ar cmd
|
|
|
|
|
only with each
|
|
|
|
|
.Ar ( variable , value )
|
2015-01-23 23:24:42 +00:00
|
|
|
tuple specified.
|
2015-01-24 22:04:40 +00:00
|
|
|
.It Fl u Ar variable
|
|
|
|
|
Unset
|
|
|
|
|
.Ar variable
|
|
|
|
|
in the environment.
|
2015-01-23 23:22:06 +00:00
|
|
|
.El
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr printenv 1 ,
|
|
|
|
|
.Xr putenv 3 ,
|
|
|
|
|
.Xr environ 7
|
|
|
|
|
.Sh STANDARDS
|
|
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
utility is compliant with the
|
|
|
|
|
.St -p1003.1-2008
|
|
|
|
|
specification.
|
|
|
|
|
.Pp
|
|
|
|
|
The
|
|
|
|
|
.Op Fl u
|
|
|
|
|
flag is an extension to that specification.
|
