NAME

appexec - execute a command under a specified environment

SYNOPSIS

appexec --env environment [options] program [program arguments]

appexec [options] environment program [program arguments]

DESCRIPTION

appexec will execute a program with the specified arguments in the specified environment. The environment is generated by App::Env, so an appropriate App::Env application module must exist.

OPTIONS AND ARGUMENTS

appexec uses long options. Options may be abbreviated, and the "=" character shown below in the option templates may be replaced by whitespace.

The environment to use may be specified either via the --env option, or as the first non-option argument.

The following options are available:

--env=name

The name of the environment (or application in App::Env terminology) in which to run the program. The Perl module App::Env::name must be exist.

If this option is not specified, the first non-option argument should be the environment name

--appopts key=value or -o key=value

Specify a option key and value to be passed via AppOpts to the App::Env application module. This option may be specified multiple times.

--site=site

Specify a site. (See App::Env for more information.)

--dumpenv=format

Output the environmental variables to the standard output stream. The possible formats are:

  bash
  raw
  unquoted

If format is not specified, it defaults to raw.

--verbose

Print the command to be run to the standard output stream before running it.

--help

Print a short help summary and exit.

--usage

Print full documentation and exit.

EXAMPLES

Real-life examples:

1. Run the fhelp tool from the HEADAS FTOOLS application suite:

     appexec HEADAS fhelp fparkey

2. Run the dmlist tool from the CIAO version 3.4 application suite:

     appexec -o version=3.4 CIAO dmlist

VERSION

This documents version 1.0.0 of appexec.

COPYRIGHT AND LICENSE

This software is copyright the Smithsonian Astrophysical Observatory and is released under the GNU General Public License. You may find a copy at http://www.fsf.org/copyleft/gpl.html.

AUTHOR

Diab Jerius <djerius@cfa.harvard.edu>