Return to README CVS log

Up to [Pegasus] / pegasus_unsupported / config

PEP#: 9999
TITLE: Configuration Script

DESCRIPTION: added vxworks support.

This directory is a work-in-progress to develop a standard configure mechanism
that can be used to configure Pegasus for compiling and linking.

This script is based on the standards for configure options used by the
GNU community as defined in the GNU coding standards. All options to be
used in this script (--enable..., --disable, etc.)  The coding standards can
be found at

    http://www.gnu.org/prep/standards/standards.html

The goal of this script is to replace manually setting of environment
variables for Pegaus builds with a configure mechanism that simplifies
the choices and also confirms that the choices are correct (ex. confirms
that the SSL libraries are where they are defined)

Overview

This script can be used with existing pegasus source trees on Linux and 
Solaris today.  It DOES NOT modify the existing source tree but adds two
new files to the pegasus root directory to define the options defined by
the configure script and allow them to be incorporated with make. This 
depends on a feature of GNUMake that provides a precedence mechanism 
for the makefile names (GNUmakefile, Makefile, ...). 


  options.mak - options to be used with this build
  GNUmakefile - Makefile that is called by default by make and simply includes
                the options.mak and calls Makefile.
                It includes one target (distclean) to remove all things
	        created by this script. 

The configure script MUST BE executed from the directory that is the top of 
the Pegasus source tree (ex. pegasus) since it puts the created files in
that directory.

Note that in accord with the GNU standards it defines a directory with the
platform definition under the source top directory to be used as the output
directory (PEGASUS_HOME)

This file attempts to automate the selection of platform, compiler, etc. to
create the PEGASUS_PLATFORM environment variable.

Usage:

1. Get configure from pegasus_unsupported.

2. Go to the directory that will become PEGASUS_ROOT (the top of the Pegasus
source tree).

3. Create a softlink to the configure script (do this in root of OpenPegasus 
   distribution).
   ln -s <PARENTDIRECTORY>/pegasus_unsupported/config/configure .

4. Execute the script.
   a. If you execute it with no options, it will install what it feels is the
      standard build environment variables into the options.mak and create the
      GNUmakefile
   b. If you execute with the --help option it will list all options
   c. Execute with the enable/disable options you desire and it will create
      the options.mak with these options and the required environment
      variables into options.mak and creates the GNUmakefile
   d. Build pegasus with the standard commands (ex. make, make world,
      make new world, etc.)

5. Examples:

    Configuring without out-of-process providers:

        $ ./configure --disable-oop

    Configuring for debug

        $ ./configure --enable-debug

    Enabling ssh:

        $ ./configure --enable-ssl