PEGASUS-VERSION(1)														PEGASUS-VERSION(1)

NAME

       pegasus-version - print or match the version of the toolkit.

SYNOPSIS

       pegasus-version [-Dproperty=value] [-m [-q]] [-V] [-f] [-l]

DESCRIPTION

       This program prints the version string of the currently active Pegasus toolkit on stdout.

       pegasus-version is a simple command-line tool that reports the version number of the Pegasus distribution being used. In its most basic
       invocation, it will show the current version of the Pegasus software you have installed:

	   $ pegasus-version
	   3.1.0cvs

       If you want to know more details about the installed version, i.e. which system it was compiled for and when, use the long or full mode:

	   $ pegasus-version -f
	   3.1.0cvs-x86_64_cent_5.6-20110706191019Z

OPTIONS

       -Dproperty=value
	   The -D option allows an experienced user to override certain properties which influence the program execution, among them the default
	   location of the user's properties file and the PEGASUS_HOME location. One may set several CLI properties by giving this option multiple
	   times.

	   The -D option(s) must be the first option on the command line. CLI properties take precedence over the file-based properties of the
	   same key.

       -f, --full
	   The --full mode displays internal build metrics, like OS type and libc version, addition to the version number. It appends the build
	   time as time stamp to the version. The time stamp uses ISO 8601 format, and is a UTC stamp.

       -l, --long
	   This option is an alias for --full.

       -V, --version
	   Displays the version of the Pegasus planner you are using.

       --verbose
	   is ignored in this tool. However, to provide a uniform interface for all tools, the option is recognized and will not trigger an error.

RETURN VALUE

       The program will usually return with success (0). In match mode, if the internal version does not match the external installation, an exit
       code of 1 is returned. If run-time errors are detected, an exit code of 2 is returned, 3 for fatal errors.

ENVIRONMENT VARIABLES

       JAVA_HOME
	   should be set and point to a valid location to start the intended Java virtual machine as $JAVA_HOME/bin/java.

EXAMPLE

	   $ pegasus-version
	   3.1.0cvs

	   $ pegasus-version -f
	   3.1.0cvs-x86_64_cent_5.6-20110706191019Z

AUTHORS

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

       Pegasus Team http://pegasus.isi.edu

								    05/24/2012							PEGASUS-VERSION(1)