User Commands                                              env(1)

NAME
     env - set environment for command invocation

SYNOPSIS
     /usr/bin/env [ -i | - ]  [ name=value ... ]  [   utility   [
     arg ...    ]  ]

     /usr/xpg4/bin/env [ -i | - ]  [ name=value ... ]  [  utility
     [  arg ...    ]  ]

DESCRIPTION
     The env utility obtains the current environment, modifies it
     according  to  its arguments, then invokes the utility named
     by the utility operand with the modified environment.

     Optional arguments are passed  to  utility.  If  no  utility
     operand  is  specified, the resulting environment is written
     to the standard output, with one name=value pair per line.

  /usr/bin/env
     If env executes commands with arguments, it uses the default
     shell /usr/bin/sh (see sh(1)).

  /usr/xpg4/bin/env
     If  env  executes   commands   with   arguments,   it   uses
     /usr/xpg4/bin/sh,  which  is equivalent to /usr/bin/ksh (see
     ksh(1)).

OPTIONS
     The following options are supported:

     -i | -
           Ignore the environment that would otherwise be  inher-
           ited  from  the current shell.  Restricts the environ-
           ment for utility to that specified by the arguments.

OPERANDS
     The following operands are supported:

     name=value
           Arguments of the form name=value modify the  execution
           environment,   and   are  placed  into  the  inherited
           environment before utility is invoked.

     utility
           The name of the utility to  be  invoked.   If  utility
           names any of the special shell built-in utilities, the
           results are undefined.

     arg   A string to pass as an argument for the invoked  util-
           ity.

SunOS 5.8           Last change: 18 Mar 1997                    1

User Commands                                              env(1)

EXAMPLES
     Example 1: Invoking utilities with new PATH values.

     The following utility:

     example% env -i PATH=/mybin mygrep xyz myfile

     invokes the utility mygrep with a new PATH value as the only
     entry  in  its  environment.  In  this case, PATH is used to
     locate mygrep, which then must reside in /mybin.

ENVIRONMENT VARIABLES
     See environ(5) for descriptions of the following environment
     variables  that  affect  the  execution  of  env:  LC_CTYPE,
     LC_MESSAGES, and NLSPATH.

EXIT STATUS
     If utility is invoked, the exit status of env  is  the  exit
     status of utility; otherwise, the env utility is with one of
     the following values:

     0     Successful completion.

     1-125 An error occurred.

     126   utility was found but could not be invoked.

     127   utility could not be found.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

  /usr/bin/env
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Availability                | SUNWcsu                     |
    | CSI                         | enabled                     |
    |_____________________________|_____________________________|

  /usr/xpg4/bin/env
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Availability                | SUNWxcu4                    |
    | CSI                         | enabled                     |
    |_____________________________|_____________________________|

SEE ALSO
     ksh(1),   sh(1),   exec(2),    profile(4),    attributes(5),
     environ(5), XPG4(5)

SunOS 5.8           Last change: 18 Mar 1997                    2