Diab Jerius > App-Env-0.15 > appexec

Download:
App-Env-0.15.tar.gz

Annotate this POD

CPAN RT

Open  0
Report a bug
Source  

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=fmt | -d fmt

Output the environmental variables to the standard output stream. The output format is determined by the --dumpfmt option.

The possible formats are:

  bash
  csh
  ksh
  raw
  tcsh
  unquoted
--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>