From 8a80834fca8e7f45569cb1eb0b0c18c1d5aa6361 Mon Sep 17 00:00:00 2001 From: Tor Aamodt Date: Tue, 26 Jul 2011 11:55:18 -0800 Subject: fixup some dangling references update README and CHANGES to hopefully anticipate most basic questions we'll see [git-p4: depot-paths = "//depot/gpgpu_sim_research/fermi/distribution/": change = 9880] --- README | 38 +++++++++++++++++--------------------- 1 file changed, 17 insertions(+), 21 deletions(-) (limited to 'README') diff --git a/README b/README index 62bbc8a..2cd3a5f 100644 --- a/README +++ b/README @@ -1,6 +1,7 @@ GPGPU-Sim Simulator version 3.0.0b (beta) -See doc/GPGPU-Sim_Manual.html for more documentation. +This version of GPGPU-Sim works with CUDA version 3.1 and some earlier +versions. It does not work with CUDA version 4.x. Please see the copyright notice in the file COPYRIGHT distributed with this release in the same directory as this file. @@ -30,17 +31,12 @@ simulation, and various configuration files to provide a programming model close to CUDA. Creating benchmarks for the original GPGPU-Sim simulator was a very time consuming process. This motivated the development an interface for directly running CUDA applications to leverage the growing number of -applications being developed to use CUDA. +applications being developed to use CUDA. We subsequently added support for +OpenCL and removed all SimpleScalar code. The interconnection network is simulated using the booksim simulator developed by Bill Dally's research group at Stanford. -The current version of GPGPU-Sim still uses a few portions of SimpleScalar -functional simulation code: support for memory spaces and command line option -processing (but not for any timing model purposes). SimpleScalar code has very -strict restrictions on non-academic use (these portions may be removed in a -future version of GPGPU-Sim). - To produce output that is compatible with the output from running the same CUDA program on the GPU, we have implemented several PTX instructions using the CUDA Math library (part of the CUDA toolkit). Code to interface with the CUDA Math @@ -56,7 +52,8 @@ version 11.1) and has been used on several other Linux platforms. Step 1: Ensure you have gcc, g++, make, makedepend, zlib, bison and flex installed on your system. For CUDA 2.x we used gcc version 4.3.2, for CUDA 1.1 -we used gcc/g++ version 4.1.3. We used bison version 2.3, and flex version 2.5.33. +we used gcc/g++ version 4.1.3. This version of GPGPU-Sim does not work with +CUDA 4.x; We used bison version 2.3, and flex version 2.5.33. Step 2: Download and install the CUDA Toolkit and CUDA SDK code samples from NVIDIA's website: . If you want to run OpenCL on @@ -78,26 +75,25 @@ From a bash shell, type the following in this directory: Step 5: Type "make" in this directory. This will build the simulator with optimizations enabled so the simulator runs faster. If you want to run the -simulator in gdb to debug it, then build it using "make DEBUG=1" instead. +simulator in gdb to debug it, then uncomment the line + + #export GPGPUSIM_CONFIG=debug + +in setup_environment and type ". setup_environment" again, then "make" again. Step 6: Run a CUDA built with a recent version of CUDA (or an OpenCL application) and the device code should now run on the simulator instead of your graphics card. To be able to run the application on your graphics card -again, remove $GPGPUSIM_ROOT/lib from your LD_LIBRARY_PATH. There is also a -"static" build setup used for some of the examples in the benchmarks directory -(more information on this is available in doc/GPGPU-Sim_Manual.html) - -By default, this version of GPGPU-Sim uses the ptx source embedded within the -binary. To use the .ptx files in the current directory, type: - - export PTX_SIM_USE_PTX_FILE=1 +again, remove $GPGPUSIM_ROOT/lib from your LD_LIBRARY_PATH. Note that for OpenCL applications the NVIDIA driver is required to convert -OpenCL ".cl" files to PTX. The resulting PTX can be saved to disk by adding +OpenCL ".cl" files to PTX (this in turn may require you have a graphics card, +but to run CUDA applications on the simulator a graphics card is not +necessary). The resulting PTX can be saved to disk by adding -save_embedded_ptx to your gpgpusim.config file (embedded PTX files with be saved as _0.ptx, _1.ptx, etc...). 3. USING THE SIMULATOR -For guidelines on using and configuring the simulator, please see -doc/GPGPU-Sim_Manual.html +Note that doc/GPGPU-Sim_Manual.html has not yet been updated to reflect +changes to GPGPU-Sim versus the earlier 2.x versions. -- cgit v1.3