README
This is a readme file for extran project for Nemerle. Extran project is a testbed for
using existing extensible programming tools for parallel programming.
REQUIREMENTS
In order to compile this project, you need to have the following installed on your computer:
1) a version of Mono which will run Nemerle under Linux (2.0.1 was tested, in later
versions, either Nemerle or Mono is broken)
2) a version of Nemerle 1.0.0, better build 9025 or higher (tested with 9025)
3) NUnit version 2.4.8 (required only to run tests)
For running OpenCL and NUDA programs:
1) a GPU with OpenCL 1.0 or higher support. Any NVidia GPU with CUDA capability 1.1 and
higher, and any ATI Radeon HD 3000 or higher series GPU (or equivalent professional or
servier grade GPUs) is OK
2) working OpenCL GPU implementation (AMD Stream SDK 2.1 or higher, or NVidia CUDA 3.0 or
higher is OK)
BUILDING
To build the dll, simply run the following command in the root directory of the project:
make
For testing, run the following command in the root directory of the project:
make test
Note that if you don't have a supported GPU (see REQUIREMENTS), all OpenCL-related tests
will fail.
To compile the current version of documentation in doc/, you'll need a working LaTeX
distributive. To compile documentation, run the following command in the root of the
project:
make doc
INSTALLATION
First, set your mono path in the makefile.def file. Mono requires additional manipulation
for GAC-installed libraries to be visible to the compiler, and those manipulations need to
know the root Mono path. By default, it is /usr/lib/mono, and it can be changed in makefile.def.
For installing, run the following command in the root directory of the project:
make install
This will sign the assemblies, install them into GAC and set necessary softlinks. Note
that the user running this command must be permission to write into GAC. With default
installation path, this means the user must be a root.
For uninstallation, run the following command in the root directory of the project:
make uninstall
SAMPLES
In order to compile samples, execute make in samples directory. If you already have a
version of NUDA installed in GAC (see INSTALLATION), be sure to set MONO_PATH=. in order
to use development version.
USING
See samples directory for Extran and NUDA samples. Also see documentation in doc/extran-guide.pdf.
