------------------------------------------------------------------------------
NVIDIA OpenCL Visual Profiler 
Linux Release Notes
Version 1.0 Beta
------------------------------------------------------------------------------

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


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

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

* OpenCLVisualProfiler/projects        : Directory containing sample profiler projects

* OpenCLVisualProfiler/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
. OpenCL 1.0 NVIDIA driver


INSTALLATION AND SETUP
---------------------
Extract all files from the release tar zip into a directory 
(referred to as <OpenCLVisualProfilerInstallDir>)
  > cd <OpenCLVisualProfilerInstallDir>
  > gunzip <release.tar.gz>
  > tar xvf <release.tar>

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


RUNNING OpenCL Visual Profiler
----------------------------
 > <OpenCLVisualProfilerInstallDir>/OpenCLVisualProfiler/bin/openclprof &


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

KNOWN ISSUES
------------
1) GPU timestamp values are incorrect on 64-bit platforms. In this case all profiler 
   features which use timestamps like GPU Time Width plot will be incorrect.

2) There are issues with profiling on setups with multiple NVIDIA GPUs.
   In some cases when multiple profiler counters are enabled
   OpenCL Visual Profiler crashes.
   
3) 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.