Contents

• 1. Introduction
  • 1.1. What is CUDA-GDB?
  • 1.2. Supported Features
  • 1.3. About This Document
• 2. Release Notes
• 3. Getting Started
  • 3.1. Setting Up the Debugger Environment
    • 3.1.1. Temporary Directory
    • 3.1.2. Using the CUDA-GDB debugger on Jetson and Drive Tegra devices
  • 3.2. Compiling the Application
    • 3.2.1. Debug Compilation
    • 3.2.2. Compilation With Linenumber Information
    • 3.2.3. Compilation With PTX Debug Option
    • 3.2.4. Compiling For Specific GPU architectures
    • 3.2.5. Compiling with tensor memory checks
  • 3.3. Using the Debugger
    • 3.3.1. Single-GPU Debugging with the Desktop Manager Running
    • 3.3.2. Multi-GPU Debugging
    • 3.3.3. Remote Debugging
    • 3.3.4. Multiple Debuggers
    • 3.3.5. Attaching/Detaching
• 4. CUDA-GDB Extensions
  • 4.1. Command Naming Convention
  • 4.2. Getting Help
  • 4.3. Initialization File
  • 4.4. GUI Integration
  • 4.5. GPU core dump support
• 5. Kernel Focus
  • 5.1. Software Coordinates vs. Hardware Coordinates
  • 5.2. Current Focus
  • 5.3. Switching Focus
• 6. Program Execution
  • 6.1. Interrupting the Application
  • 6.2. Single Stepping
• 7. Breakpoints and Watchpoints
  • 7.1. Symbolic Breakpoints
  • 7.2. Line Breakpoints
  • 7.3. Address Breakpoints
  • 7.4. Kernel Entry Breakpoints
  • 7.5. Conditional Breakpoints
  • 7.6. Watchpoints
• 8. Inspecting Program State
  • 8.1. Memory and Variables
  • 8.2. Variable Storage and Accessibility
  • 8.3. Info CUDA Commands
    • 8.3.1. info cuda devices
    • 8.3.2. info cuda sms
    • 8.3.3. info cuda warps
    • 8.3.4. info cuda lanes
    • 8.3.5. info cuda kernels
    • 8.3.6. info cuda barriers
    • 8.3.7. info cuda blocks
    • 8.3.8. info cuda threads
    • 8.3.9. info cuda launch trace
    • 8.3.10. info cuda launch children
    • 8.3.11. info cuda contexts
    • 8.3.12. info cuda managed
  • 8.4. Disassembly
  • 8.5. Registers
  • 8.6. Const banks
• 9. Event Notifications
  • 9.1. Context Events
  • 9.2. Kernel Events
• 10. Automatic Error Checking
  • 10.1. Checking API Errors
  • 10.2. GPU Error Reporting
  • 10.3. Autostep
• 11. Walk-Through Examples
  • 11.1. Example: bitreverse
    • 11.1.1. Walking through the Code
  • 11.2. Example: autostep
    • 11.2.1. Debugging with Autosteps
  • 11.3. Example: MPI CUDA Application
• 12. Tips and Tricks
  • 12.1. set cuda break_on_launch
  • 12.2. set cuda launch_blocking
  • 12.3. set cuda notify
  • 12.4. set cuda ptx_cache
  • 12.5. set cuda single_stepping_optimizations
  • 12.6. set cuda thread_selection
  • 12.7. set cuda value_extrapolation
  • 12.8. Debugging Docker Containers
  • 12.9. Thread Block Clusters
  • 12.10. Debugging OptiX/RTCore applications
  • 12.11. Debugging on Windows Subsystem for Linux
  • 12.12. Accessing unmanaged device memory from host thread
• 13. Supported Platforms
• 14. Common Issues on Supported Operating Systems
• 15. Known Issues
• 16. Notices
  • 16.1. Notice
  • 16.2. OpenCL
  • 16.3. Trademarks