pegasus-invoke(1) [debian man page]

PEGASUS-INVOKE(1)														 PEGASUS-INVOKE(1)

NAME

       pegasus-invoke - invokes a command from a file

SYNOPSIS

       pegasus-invoke ( app | @fn ) [ arg | *@fn [..]]

DESCRIPTION

       The pegasus-invoke tool invokes a single application with as many arguments as your Unix permits (128k characters for Linux). Arguments are
       come from two places, either the command-line as regular arguments, or from a special file, which contains one argument per line.

       The pegasus-invoke tool became necessary to work around the 4k argument length limit in Condor. It also permits to use arguments inside
       argument files without worry about shell, Condor or Globus escape necessities. All argument file contents are passed as is, one line per
       argument entry.

ARGUMENTS

       -d
	   This option increases the debug level. Currently, only debugging or no debugging is distinguished. Debug message are generated on
	   stdout . By default, debugging is disabled.

       -h
	   This option prints the help message and exits the program.

       --
	   This option stops any option processing. It may only be necessary, if the application is stated on the command-line, and starts with a
	   hyphen itself.The first argument must either be the application to run as fully-specified location (either absolute, or relative to
	   current wd), or a file containing one argument per line. The PATH environment variables is not used to locate an application.
	   Subsequent arguments may either be specified explicitely on the commandline. Any argument that starts with an at (@) sign is taken to
	   introduce a filename, which contains one argument per line. The textual file may contain long arguments and filenames. However, Unices
	   still impose limits on the maximum length of a directory name, and the maximum length of a file name. These lengths are not checked,
	   because pegasus-invoke is oblivious of the application (e.g. what argument is a filename, and what argument is a mere string resembling
	   a filename).

RETURN VALUE

       The pegasus-invoke tool returns 127, if it was unable to find the application. It returns 126, if there was a problem parsing the file. All
       other exit status, including 126 and 127, come from the application.

SEE ALSO

       pegasus-kickstart(1)

EXAMPLE

	   $ echo "/bin/date" > X
	   $ echo "-Isec" >> X
	   $ pegasus-invoke @X
	   2005-11-03T15:07:01-0600

       Recursion is also possible. Please mind not to use circular inclusions. Also note how duplicating the initial at (@) sign will escape its
       meaning as inclusion symbol.

	   $ cat test.3
	   This is test 3

	   $ cat test.2
	   /bin/echo
	   @test.3
	   @@test.3

	   $ pegasus-invoke @test.2
	   This is test 3 @test.3

RESTRICTIONS

       While the arguments themselves may contain files with arguments to parse, starting with an at (@) sign as before, the maximum recursion
       limit is 32 levels of inclusions. It is not possible (yet) to use stdin as source of inclusion.

HISTORY

       As you may have noticed, pegasus-invoke had the name invoke in previous incantations. We are slowly moving to the new name to avoid clashes
       in a larger OS installation setting. However, there is no pertinent need to change the internal name, too, as no name clashes are expected.

AUTHORS

       Mike Wilde <wilde at mcs dot anl dot gov>

       Jens-S. Vockler <voeckler at isi dot edu>

       Pegasus http://pegasus.isi.edu/

								    05/24/2012							 PEGASUS-INVOKE(1)

PEGASUS-CONFIG(1)														 PEGASUS-CONFIG(1)

NAME

       pegasus-config - The authority for where parts of the Pegasus system exists on the filesystem. pegasus-config can be used to find libraries
       such as the DAX generators.

SYNOPSIS

       pegasus-config [-h] [--help] [-V] [--version] [--noeoln]
		      [--perl-dump] [--perl-hash] [--python-dump] [--sh-dump]
		      [--bin] [--conf] [--java] [--perl] [--python]
		      [--python-externals] [--schema] [--classpath]
		      [--local-site] [--full-local]

DESCRIPTION

       pegasus-config is used to find locations of Pegasus system components. The tool is used internally in Pegasus and by users who need to find
       paths for DAX generator libraries and schemas.

OPTIONS

       -h, --help
	   Prints help and exits.

       -V, --version
	   Prints Pegasus version information

       --perl-dump
	   Dumps all settings in perl format as separate variables.

       --perl-hash
	   Dumps all settings in perl format as single perl hash.

       --python-dump
	   Dumps all settings in python format.

       --sh-dump
	   Dumps all settings in shell format.

       --bin
	   Print the directory containing Pegasus binaries.

       --conf
	   Print the directory containing configuration files.

       --java
	   Print the directory containing the jars.

       --perl
	   Print the directory to include into your PERL5LIB.

       --python
	   Print the directory to include into your PYTHONLIB.

       --python-externals
	   Print the directory to the external Python libraries.

       --schema
	   Print the directory containing schemas.

       --classpath
	   Builds a classpath containing the Pegasus jars.

       --noeoln
	   Do not produce a end-of-line after output. This is useful when being called from non-shell backticks in scripts. However, order is
	   important for this option: If you intend to use it, specify it first.

       --local-site [d]
	   Create a site catalog entry for site "local". This is only an XML snippet without root element nor XML headers. The optional argument
	   "d" points to the mount point to use. If not specified, defaults to the user's $HOME directory.

       --full-local [d]
	   Create a complete site catalog with only site "local". The an XML snippet without root element nor XML headers. The optional argument
	   "d" points to the mount point to use. If not specified, defaults to the user's $HOME directory.

EXAMPLE

       To set the PYTHONPATH variable in your shell for using the Python DAX API:

	   export PYTHONPATH=`pegasus-config --python`

       To set the same path inside Python:

	   config = subprocess.Popen("pegasus-config --python-dump", stdout=subprocess.PIPE, shell=True).communicate()[0]
	   exec config

       To set the PERL5LIB variable in your shell for using the Perl DAX API:

	   export PERL5LIB=`pegasus-config --perl`

       To set the same path inside Perl:

	   eval `pegasus-config --perl-dump`;
	   die("Unable to eval pegasus-config output: $@") if $@;

       will set variables a number of lexically local-scoped my variables with prefix "pegasus_" and expand Perl's search path for this script.

       Alternatively, you can fail early and collect all Pegasus-related variables into a single global %pegasus variable for convenience:

	   BEGIN {
	       eval `pegasus-config --perl-hash`;
	       die("Unable to eval pegasus-config output: $@") if $@;
	   }

AUTHOR

       Pegasus Team http://pegasus.isi.edu

								    05/24/2012							 PEGASUS-CONFIG(1)