CUDA Debugging

Purpose

Guide agents through debugging CUDA programs with cuda-gdb for interactive GPU thread inspection, NVIDIA Compute Sanitizer for automated memory and race detection, GPU core dump analysis, device-side printf, and triaging common CUDA runtime error codes.

When to Use

• cudaErrorIllegalAddress (700) or segmentation fault on device
• Intermittent correctness failures in multi-threaded GPU code
• Debugging race conditions between warps or between host and device
• Stepping through kernel code line-by-line with cuda-gdb
• Validating uninitialized memory reads with initcheck
• Kernel hang or cudaErrorLaunchTimeout (702)

Workflow

1. Build for debugging