Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Clone this wiki locally
This page provides instructions for installing Ocelot on various platforms.
You may want to have a look here for a short installation guide.
The following compiler tools are required (tested):
- C++ Compiler (GCC 4.7.3)
- GCC 4.8 version can be supported, but may CUDA 4.2 may not work with GCC 4.8
- Lex Lexer Generator (Flex 2.5.35)
- YACC Parser Generator (Bison 2.5.1)
- The default version of bison in Ubuntu 14.04 is higher than 2.5.1 which is not supported by GPUOcelot.
- CUDA 4.2
- CUDA 5.0 and CUDA 5.5 can be supported, but regression tests may fail.
The following libraries are required to be installed:
- boost_system (1.49)
- Ocelot does not work with boost version > 1.49
- boost_filesystem (1.49)
- boost_serialization (1.49)
- GLEW (optional for GL interop) (1.5)
- GL (for NVIDIA GPU Devices)
The following external library headers are required to be on your search path:
- boost (http://www.boost.org/)
We require a compiler that supports parts of the upcoming C++0x standard.
Ocelot is rigorously tested on 64-bit Ubuntu 12.04.1 LTS using GCC-4.6.3. We strive to be ANSI C++ compliant, but only the specified systems is actively tested.
The GPU target requires a CUDA enabled driver to be installed and on your library search path.
Checkout Ocelot from github:
- git clone https://github.com/gtcasl/gpuocelot.git
Checkout Hydrazine submodule under /path/to/gpuocelot:
- git submodule init; git submodule update;
Optionally: Install boost
- sudo apt-get install libboost-all-dev
Optionally: Install compiler tools
- sudo apt-get install flex bison g++ scons
Enter the gpuocelot/ocelot directory
- cd gpuocelot/ocelot
Run the build script.
- sudo ./build.py --install
This will install the Ocelot development headers and libraries:
Create the necessary system links to the Ocelot library so the dynamic linker will find it:
- sudo ldconfig
This library can be used to access the tools within ocelot or linked against a CUDA application compiled with NVCC to emulate a CUDA device.
Alternatively, there is a new utility, OcelotConfig that is intended simply the process of linking against Ocelot.
To link a program against Ocelot:
- g++ -o my_program my_program.o
Ocelot comes with the NVIDIA CUDA SDK 2.2 and 2.3 as regression tests and as examples of how to correctly build and link programs.
- Download the sdk from subversion or the download page
- Extract the archive
- Configure with: ./configure LDFLAGS="-Lpath_to_ocelot_libs -Lpath_to_cublas_and_cufft_libs"
- Run make check to build all of the sdk tests
- Run make test to run all of the sdk examples and verify the outputs.
Windows Build (Experimental)
- Boost (http://www.boost.org/doc/libs/1_46_1/more/getting_started/windows.html)
- MinGW (http://www.mingw.org/)
- Visual Studio 2010
- Python 2.7
- Open a visual studio command line prompt
- Go to the Ocelot trunk
- Put MinGW/bin on your path (make sure it has flex/bison)
- python.exe build.py --install --path C:\Ocelot -w