env

 

---

 
 
 
 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
 
 
 

---