env(1)

NAME
     env - set environment for command

SYNOPSIS
     env [-ia] [name=value] ...  [utility [argument...]]

DESCRIPTION
     Env modifies its environment according to the name=value  arguments,  and
     executes utility with the given arguments with the modified environment.

     If no utility is specified then the modified environment  is  printed  as
     name=value strings, one per line.

OPTIONS

     -i   Use  exactly  the  environment  specified  by  the  arguments;   the
          inherited environment is ignored.

     -a   Specify all arguments  for  the  utility,  i.e.  the  first  of  the
          arguments  is  used  as  argv[0],  the  program  name.  Normally the
          program name is utility itself.

ENVIRONMENT

     PATH    The path used to find utility.  It is as modified  by  env,  i.e.
             not the inherited PATH.

SEE ALSO
     sh(1), execvp(3), environ(5).

DIAGNOSTICS
     The return code is 0 after successfully printing the environment, 1 on an
     error  within  env,  126  if the utility could not be executed, or 127 if
     utility could not be found.  Appropriate diagnostic messages are  printed
     on  standard  error.  If utility can be executed then it replaces env, so
     the return code is then the return code of utility.

NOTES
     Env is only useful with options  or  without  arguments.   Otherwise  the
     shell  can  do exactly what env can do, simply omit the word "env" on the
     command line.

AUTHOR
     Kees J. Bot (kjb@cs.vu.nl)