1.1. Getting Started for Impatient Users

This section is designed for impatient, UNIX-literate readers who wish to start using POOMA as quickly as possible. We describe how to obtain, configure, compile, and use the toolkit with a minimum of explanation.

Download

Download pooma-2.3.0.tgz from the POOMA download page (http://pooma.codesourcery.com/pooma/download). Uncompress and extract the source code:


tar xzvf pooma-2.3.0.tgz
Move into the directory containing the source code:

cd pooma-2.3.0

Configure

To create files necessary for compiling, use


./configure - -arch architecture - -opt
where architecture indicates the operating system and compiler. Permitted choices are the names of files in the config/arch/ subdirectory omitting the .conf suffixes.

Compilation of the Library

Create the POOMA library file by first setting the POOMASUITE environment variable to the architecture's name and then compiling the source code:


export POOMASUITE=architecture
make

Compiling Programs

We illustrate compiling the "Hello, POOMA" program available at examples/Manual/Sequential/initialize-finalize.cpp:


export POOMAHOME=/home/oldham/pooma/pooma1
g++ -I${POOMAHOME}/src \
-I${POOMAHOME}/lib/${POOMASUITE} \
initialize-finalize.cpp \
-o initialize-finalize \
-L${POOMAHOME}/lib/${POOMASUITE} -lpooma-gcc
The POOMAHOME environment variable indicates the location of the toolkit header files and the library.