diff options
| -rw-r--r-- | CHANGES | 14 | ||||
| -rw-r--r-- | README | 96 |
2 files changed, 68 insertions, 42 deletions
@@ -1,8 +1,15 @@ CHANGE LOG: Version 3.0.1 versus 3.0.0b -- Updated README and more streamlined setup -- Changed Quadro FX 5800 configuration to use ptx (not sass) by default +- Updated README and setup_environment for more streamlined setup. + Including install instructions for Ubuntu 10.04.3 LTS +- Changed Quadro FX 5800 config to use PTX by default (not SASS/decuda) +- Added Doxygen generated documentation +- Removed ISPASS 2009 configuration (use Quadro FX 5800 config instead) +- Removed common.mk (run native CUDA/OpenCL applications) +- Removed out-of-date GPGPU-Sim documentation. This wil be updated in a + later release. Refer to Doxygen documentation and/or source code. - Added prints for L1 data cache statistics +- SIMD width option removed from shader_core_pipeline_opt (was not used) - Added read-to-precharge constraint in DRAM - Disabled Stream Manager's verbose output by default, use debug level 3 to enable it @@ -10,8 +17,6 @@ Version 3.0.1 versus 3.0.0b - Ejection from the clock domain interface buffer between interconnection network and L2 cache happens in the L2 clock domain instead of interconnect clock domain. -- Testing the simulator on Ubuntu 10.04.3 LTS -- Added Doxygen generated documentation - Bug fixes - Fixed the variation in instruction count seen under different cache configurations on the same workload @@ -20,6 +25,7 @@ Version 3.0.1 versus 3.0.0b - Fixed compilation issues when using gcc 4.5.1 - Cleanup and bugfixes to build scripts - Fixed gpu_sim_cycle with sequential kernel launches + - Fixed memory corruption bug in decuda_to_ptxplus causing parse errors Version 3.0.0b versus 2.1.2b - massive refactoring of code to C++ (most global variables eliminated) @@ -1,6 +1,6 @@ GPGPU-Sim Simulator Version 3.0.1 build $Change$ -This version of GPGPU-Sim works with CUDA version 3.1 and some earlier +This version of GPGPU-Sim works with CUDA version 3.1 and some earlier versions. It does not (yet) work with CUDA version 4.x. Please see the copyright notice in the file COPYRIGHT distributed with this @@ -13,8 +13,8 @@ Analyzing CUDA Workloads Using a Detailed GPU Simulator, in IEEE International Symposium on Performance Analysis of Systems and Software (ISPASS), Boston, MA, April 19-21, 2009. -Please sign up for the google groups page for Q&A (see gpgpu-sim.org), but -note that use of this simulator does not imply any level of support. Questions +Please sign up for the google groups page for Q&A (see gpgpu-sim.org), but note +that use of this simulator does not imply any level of support. Questions answered on a best effort basis. See Section 2 "INSTALLING, BUILDING and RUNNING GPGPU-Sim" below to get started. @@ -24,7 +24,7 @@ See Section 2 "INSTALLING, BUILDING and RUNNING GPGPU-Sim" below to get started. GPGPU-Sim was created by Tor Aamodt's research group at the University of British Columbia. Many students have contributed including: Wilson W.L. Fung, Ali Bakhoda, George Yuan, Ivan Sham, Henry Wong, Henry Tran, Andrew Turner, -Aaron Ariel, Inderpret Singh, Tim Rogers, and others. +Aaron Ariel, Inderpret Singh, Tim Rogers, Jimmy Kwa, and others. GPGPU-Sim models the features of a modern graphics processor that are relevant to non-graphics applications. The first version of GPGPU-Sim was used in a @@ -50,11 +50,30 @@ See file CHANGES for updates in this and earlier versions. 2. INSTALLING, BUILDING and RUNNING GPGPU-Sim -GPGPU-Sim was developed on Linux SuSe (this release was tested with SuSe -version 11.1) We have tested it also on Ubuntu 10.04.3 LTS (32 bits) -and has been used on several other Linux platforms. +GPGPU-Sim was developed on Linux SuSe. This release was tested with SuSe +version 11.1 and Ubuntu 10.04.3 LTS (32 bits). + +Step 1: Dependencies +==================== + +Download and install the CUDA Toolkit. To use ptxplus (native hardware +instructions) you must currently use the CUDA Toolkit version 2.3. Otherwise +use CUDA 3.1. + +If you want to run OpenCL on the simulator, download and install NVIDIA's +OpenCL driver from <http://developer.nvidia.com/object/opencl-download.html>. +Update your PATH and LD_LIBRARY_PATH as indicated by the NVIDIA install +scripts. Note that you will need to use the lib64 directory if you are using a +64bit machine. + +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. This version of GPGPU-Sim does not yet work +with CUDA 4.x; We used bison version 2.3, and flex version 2.5.33. + +If you are using Ubuntu, the following commands will install all required +dependencies besides the CUDA Toolkit. -If you are using Ubuntu, please run the following commands as necessary gpgpu-sim dependencies: "sudo apt-get install build-essentials xutils-dev bison zlib1g-dev flex libboost-all-dev libglu1-mesa-dev" @@ -64,45 +83,50 @@ gpgpu-sim documentation: cuda sdk dependencies: "sudo apt-get install libxi-dev libxmu-dev libglut3-dev" -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. 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. If you want to run OpenCL on -the simulator, download and install NVIDIA's OpenCL driver from -<http://developer.nvidia.com/object/opencl-download.html>. Update your PATH and -LD_LIBRARY_PATH as indicated by the NVIDIA install scripts. Note that you will -need to use the lib64 directory if you are using a 64bit machine. +Step 2: Build +============= -Step 3: Read the file setup_environment carefully and change it to match your -system. Then, from a bash shell, type the following in this directory: +Read the file setup_environment and modify CUDA_INSTALL_PATH to match the +location of the CUDA toolkit compute SDK on your system. Then, from a bash +shell, type the following in this directory: source setup_environment -Step 4: 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 run +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 run source setup_environment debug then "make" again. -Step 4.1 [optional]: Type "make docs" in this directory to build the doxygen -documentation. You need to have doxygen and graphviz installed for this to work. -"make cleandocs" will remove the generated documentation. The documentation resides -at doc/doxygen/html. +[optional]: Type "make docs" in this directory to build the doxygen +documentation. You need to have doxygen and graphviz installed for this to +work. "make cleandocs" will remove the generated documentation. The +documentation resides at doc/doxygen/html. -Step 5: Copy or create the configuration files gpgpusim.conf and \ -icnt_config_quadro_islip.txt in your working directory. Sample configuration -files are provided under gpgpu-sim/v3.x/configs/*/ +Step 3: Run +============ -Step 6: Build a CUDA appliction (or an OpenCL -application). +Copy gpgpusim.conf and icnt_config_quadro_islip.txt from +gpgpu-sim/v3.x/configs/QuadroFX5800/ to your application's working directory. -Step 7: Run the 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 +To use ptxplus (native ISA) uncomment the following two lines in +gpgpusim.config (again, note this requires CUDA toolkit 2.3): + +#-gpgpu_ptx_convert_to_ptxplus 1 +#-gpgpu_ptx_save_converted_ptxplus 1 + +Now run your unmodified CUDA or OpenCL application. It will automatically +execute kernels on GPGPU-Sim. + +If you have not done so you need to build a CUDA appliction (or an OpenCL +application). Note that you no longer need to recompile your application to run +on GPGPU-Sim. GPU kernels will automatically run on the simulator instead of +your graphics card since the setup_environment script modifies your +LD_LIBRARY_PATH to point to $GPGPUSIM_ROOT/lib. To be able to run the +application on your graphics card again, remove $GPGPUSIM_ROOT/lib from LD_LIBRARY_PATH. Note that for OpenCL applications the NVIDIA driver is required to convert @@ -115,7 +139,3 @@ saved as _0.ptx, _1.ptx, etc...). If you need to run the set of applications in the NVIDIA CUDA SDK code samples then you will need to download, install and build the SDK. -3. USING/MODIFYING THE SIMULATOR - -Note that doc/GPGPU-Sim_Manual.html has not yet been updated to reflect -changes to GPGPU-Sim versus the earlier 2.x versions. |