.\"
.\" Copyright (c) 2003 Gunnar Ritter
.\"
.\" This software is provided 'as-is', without any express or implied
.\" warranty. In no event will the authors be held liable for any damages
.\" arising from the use of this software.
.\"
.\" Permission is granted to anyone to use this software for any purpose,
.\" including commercial applications, and to alter it and redistribute
.\" it freely, subject to the following restrictions:
.\"
.\" 1. The origin of this software must not be misrepresented; you must not
.\"    claim that you wrote the original software. If you use this software
.\"    in a product, an acknowledgment in the product documentation would be
.\"    appreciated but is not required.
.\"
.\" 2. Altered source versions must be plainly marked as such, and must not be
.\"    misrepresented as being the original software.
.\"
.\" 3. This notice may not be removed or altered from any source distribution.
.\"
.\" Sccsid @(#)env.1	1.5 (gritter) 12/6/04
.TH ENV 1 "12/6/04" "Heirloom Toolchest" "User Commands"
.SH NAME
env \- set environment for command invocation
.SH SYNOPSIS
\fBenv\fR [\fB\-i\fR] [\fIname\fB=\fIvalue\fR\ ...]
[\fIutility\fR [\fIargument\fR ...]]
.sp
\fBenv\fR [\fB\-\fR] [\fIname\fB=\fIvalue\fR\ ...]
[\fIutility\fR [\fIargument\fR ...]]
.SH DESCRIPTION
The
.B env
command will either print a possibly modified environment
or execute a
.I utility
with it.
.PP
If
.B \-
or the
.B \-i
option (which was introduced by POSIX.2) is given,
the initial environment is cleared.
.PP
Each \fIname\fB=\fIvalue\fR pair
is then put in the environment.
.PP
If no
.I utility
is given,
the
.B env
command will print the current environment and exit.
.PP
Otherwise,
.I utility
will be executed using the remaining arguments.
.SH "ENVIRONMENT VARIABLES"
The following environment variables are evaluated at
the invocation of
.IR utility :
.TP
.B PATH
Used to locate
.IR utility .
.SH "SEE ALSO"
sh(1),
execvp(3),
environ(5)