Introduction

This guide shows you how to build the networking libraries in the QUANTA distribution using configure You can also install the CAVERNsoft modules which use the networking modules.

1. System Requirements
2. Building and installing the QUANTA libraries
3. Building your own application
4. Support
5. Appendix A: Directory Structure
6. Appendix B : Configuring the QUANTA libraries with other options
7. Appendix C: Building and installing Quanta libraries from the source rpm.

System Requirements

The networking modules of QUANTA were tested on the platforms listed below.

Building and installing the QUANTA libraries

The process has 4 main steps.

1. Downloading the distribution into a working directory

a. Download the QUANTA_xxx.tar.gz file to a working directory( where xxx is the version number).

b. Uncompress the distribution by using the command:
gunzip QUANTA_xxx.tar.gz

Untar the distribution with the command :
tar -xvf QUANTA_xxx.tar

The entire distribution will be placed in your working directory under the sub directory
QUANTA_xxx.

If your working directory is /usr/tmp/QUANTA then you will see the distribution in
/usr/tmp/QUANTA/QUANTA_xxx (where xxx is the version number of the distribution).

Note: A brief description of the directories in the distribution is available in Appendix A

2. Building the QUANTA libraries

a. configure command will run the configure script and will set up the makefiles for your platform automatically.

The configure command is platform dependent. Here is the list for various platforms. Use the command corresponding to your platform.

Platform		configure Command
Linux (32 bit & 64 bit Itanium systems)		./configure
Free BSD		./configure CXX=g++ CXXFLAGS=-pthread
Cygwin under Windows		./bootstrap ./configure
SGI Irix	32	configure --enable-bin-type=32 CXX='CC -32 -exceptions' CC='CC -32 -exceptions' LD='CC -32 -exceptions'
	n32	./configure --enable-bin-type=n32 CXX=CC CXXFLAGS=-n32 LD=CC
	64	./configure --enable-bin-type=64 CC=CC CFLAGS=-64 CXX=CC CXXFLAGS=-64 LD=CC

The --enable-bin-type option can be 32, n32 or 64. By default, configure builds Quanta for n32 bit binary type on IRIX, 32 bit binary type on Linux, Darwin, Free BSD and Cygwin and 64 bit binary type on Itanium and Opteron systems. The CXX option allows you to specify the compiler name. It is recommended to use CC on the SGI and g++ on Linux, Darwin or Cygwin.

Additional Options available  with the configure command 

The following are few additional options that you can use with the configure command:

1) --prefix=<install directory path> to install QUANTA in a directory of your choice. If you do not use this option, then 'make install' will install QUANTA in the /usr/local directory

2) --enable-shared=yes/no, --enable-static=yes/no option with configure command to build dynamic or static Quanta library. By default, configure builds both static and dynamic libraries.

Type 'configure --help' to find out what options you can use with the configure script and to use the variables to override the choices made by configure.

see Appendix B for more options on using the configure command.

b. The table below lists the default compilers used to build the libraries.

c. Type
  make

This command will build the QUANTA libraries as per the option given with the configure command. The networking libraries are now ready for use.

The build environment will recursively build starting in the current directory ( i.e. the directory in which the make command is given). If the make command is given in the top directory QUANTA_XXX, the entire package will be built including the libraries, demos and tools. To build an individual component of the QUANTA_XXX distribution, an isolated demo binary for example, change to the directory that contains the file to compile, then type make

If you need to make the QUANTA networking APIs available to other users, you should install QUANTA in a deployment directory. This deployment directory is specified using the --prefix option when you run configure.
Type
make install
to install QUANTA in the deployment directory.

4. Demo programs

The demo programs are a set of sample programs located in the 'demos' sub directory of the distribution. These demo programs are strictly for QUANTA networking APIs. The demo programs exist in four directories under the demos sub directory (db, network, misc, threads). A 'README' file in each directory (located in the 'docs' sub directory) describes the demo programs.

Configure builds the demo programs automatically during make.

Look into each directory and use the docs/README.html file to understand how the demos should be run.

Building your own application

You are now ready to write your own applications with QUANTA. Click here to see a Sample Makefile. It demonstrates how you can compile and link a program 'test.cxx' with QUANTA. Type
make to build your program.

Right click to download a copy of the sample makefile

Support

Please post your questions, comments on the Quanta forum

Appendix A : Directory Structure

The QUANTA distribution is organized into several sub directories.

Each sub directory is described below.

Appendix B : Configuring the QUANTA libraries with other options

You can configure the libraries for different binary types (32 bit, 64 bit or n32 bits). These options are not available for all platforms. The table below specifies the command to be used to configure QUANTA for a certain type of library and also indicates whether a certain library type is available/relevant to that platform.

(Y indicates that you can use the command for that platform, N implies that you cannot)

Appendix C: Building and installing Quanta library from source rpm

Use the following instructions to build and install Quanta libraries if you have downloaded the source rpm. You will need to have root permissions to install Quanta.

1. Download the QUANTA-x.x.x-src-rpm
2. Type rpmbuild --rebuild QUANTA-x.x.x-src-rpm. This command builds and creates the binary rpm under rpm/RPMS directory.
3. Once you build the binary rpm, you can install Quanta using the command rpm -ivh QUANTA-x.x.x-i386.rpm (for 32 bit machine) or rpm -ivh QUANTA-x.x.x-x86_64.rpm (for 64 bit machine).