------------------------------------------------------------------------------
NVIDIA OpenCL Visual Profiler 
Linux Release Notes
Version 1.1
------------------------------------------------------------------------------

PLEASE REFER EULA.txt FOR THE LICENSE AGREEMENT FOR USING NVIDIA SOFTWARE.


FILES IN THE RELEASE:
--------------------
* openclprof/bin/openclprof  : OpenCL Visual Profiler Executable

* openclprof/bin/libQt*.so.4 : Qt shared libraries

* openclprof/projects        : Directory containing sample profiler projects

* openclprof/doc             : Directory containing files for user documentation.


SUPPORTED LINUX DISTRIBUTIONS
-----------------------------

NVIDIA OpenCL Visual Profiler is supported and tested on the following Linux 
distributions:

32-bit operating systems
* Red Hat Enterprise Linux 4.6
* Red Hat Enterprise Linux 5.0
 
64-bit operating systems
* Red Hat Enterprise Linux 4.6
* Red Hat Enterprise Linux 5.0

OpenCL Visual Profiler is compiled with gcc 3.4.6 and the same tools should be 
used on other distributions. Alternatively, compatibility packages containing 
libstdc++.so.6 may be used.  These are available for many Linux distributions. 
For example, on recent Fedora Core releases, the compat-libstdc++-34 is needed.

Note that there is a separate OpenCL Visual Profiler package for 32-bit and 
64-bit linux distributions.

SYSTEM REQUIREMENTS
-------------------
Following are required to be able to run and profile OpenCL applications:
. OpenCL compatible NVIDIA GPU Card
. NVIDIA driver version 195.x


INSTALLATION AND SETUP
---------------------
The installation is part of the CUDA toolkit installation. The files are
installed under "<CudaToolkitDir>/openclprof" where <CudaToolkitDir> is the 
directory under which the CUDA Toolkit is installed.

Setup LD_LIBRARY PATH to include the OpenCLVisualProfiler bin directory:
 > export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<CudaToolkitDir>/openclprof/bin


RUNNING OpenCL Visual Profiler
----------------------------
  > <CudaToolkitDir>/openclprof/bin/openclprof &


Refer the OpenCL Visual Profiler openclprof.html document for more information.

KNOWN ISSUES
------------
1) If some OpenCL resources (contexts, events, etc.) are not released in the program, 
   the profiler output may be incomplete or empty and Visual profiler will report 
   the message ‘Error in reading profiler output'. The program needs to be
   modified to properly free up all OpenCL resources before termination.

2) You need to use the command line argument "--noprompt" for running most
   of the OpenCL SDK samples. You can enable the "Run in separate window"
   checkbox in the Session settings dialog to open a separate window.
   Only with this option you can give some keyboard input for console-based
   OpenCL programs.