OS Manuals

/usr/local/cuda-13.0/bin/cuda-gdb

CUDA GDB

From nvidia-cuda-gdb-13.0 13.0.85-r3 (extra-packages), captured 2026-11-05 by running cuda-gdb --help (exit 0). permalink

This is the GNU debugger with CUDA support.  Usage:

    cuda-gdb [options] [executable-file [core-file or process-id]]
    cuda-gdb [options] --args executable-file [inferior-arguments ...]

Selection of debuggee and its files:

  --args             Arguments after executable-file are passed to inferior.
  --core=COREFILE    Analyze the core dump COREFILE.
  --exec=EXECFILE    Use EXECFILE as the executable.
  --pid=PID          Attach to running process PID.
  --directory=DIR    Search for source files in DIR.
  --se=FILE          Use FILE as symbol file and executable file.
  --symbols=SYMFILE  Read symbols from SYMFILE.
  --readnow          Fully read symbol files on first access.
  --readnever        Do not read symbol files.
  --write            Set writing into executable and core files.

Initial commands and command files:

  --command=FILE, -x Execute CUDA-GDB commands from FILE.
  --init-command=FILE, -ix
		     Like -x but execute commands before loading inferior.
  --eval-command=COMMAND, -ex
		     Execute a single CUDA-GDB command.
		     May be used multiple times and in conjunction
		     with --command.
  --init-eval-command=COMMAND, -iex
		     Like -ex but before loading inferior.
  --nh               Do not read ~/.cuda-gdbinit.
  --nx               Do not read any .cuda-gdbinit files in any directory.

Output and user interface control:

  --fullname         Output information used by emacs-GDB interface.
  --interpreter=INTERP
		     Select a specific interpreter / user interface.
  --tty=TTY          Use TTY for input/output by the program being debugged.
  -w                 Use the GUI interface.
  --nw               Do not use the GUI interface.
  -q, --quiet, --silent
		     Do not print version number on startup.

Operating modes:

  --batch            Exit after processing options.
  --batch-silent     Like --batch, but suppress all cuda-gdb stdout output.
  --return-child-result
		     CUDA-GDB exit code will be the child's exit code.
  --configuration    Print details about CUDA-GDB configuration and then exit.
  --help             Print this message and then exit.
  --version          Print version information and then exit.

Remote debugging options:

  -b BAUDRATE        Set serial port baud rate used for remote debugging.
  -l TIMEOUT         Set timeout in seconds for remote debugging.

Other options:

  --cd=DIR           Change current directory to DIR.
  --data-directory=DIR, -D
		     Set CUDA-GDB's data-directory to DIR.

At startup, CUDA-GDB reads the following early init files and executes their
commands:
   None found.

At startup, CUDA-GDB reads the following init files and executes their commands:
   None found.

For more information, type "help" from within CUDA-GDB, or consult the
CUDA-GDB manual (available as on-line info or a printed manual).

Report bugs to <https://forums.developer.nvidia.com/c/developer-tools/cuda-developer-tools/cuda-gdb>.
Options (31)
OptionDescriptionSource
--argsArguments after executable-file are passed to inferior.help
--core COREFILEAnalyze the core dump COREFILE.help
--exec EXECFILEUse EXECFILE as the executable.help
--pid PIDAttach to running process PID.help
--directory DIRSearch for source files in DIR.help
--se FILEUse FILE as symbol file and executable file.help
--symbols SYMFILERead symbols from SYMFILE.help
--readnowFully read symbol files on first access.help
--readneverDo not read symbol files.help
--writeSet writing into executable and core files.help
--init-command, -ix FILELike -x but execute commands before loading inferior.help
--eval-command, -ex COMMANDExecute a single CUDA-GDB command.help
--init-eval-command, -iex COMMANDLike -ex but before loading inferior.help
--nhDo not read ~/.cuda-gdbinit.help
--nxDo not read any .cuda-gdbinit files in any directory.help
--fullnameOutput information used by emacs-GDB interface.help
--interpreter INTERPSelect a specific interpreter / user interface.help
--tty TTYUse TTY for input/output by the program being debugged.help
-wUse the GUI interface.help
--nwDo not use the GUI interface.help
-q, --quiet, --silentDo not print version number on startup.help
--batchExit after processing options.help
--batch-silentLike --batch, but suppress all cuda-gdb stdout output.help
--return-child-resultCUDA-GDB exit code will be the child's exit code.help
--configurationPrint details about CUDA-GDB configuration and then exit.help
--helpPrint this message and then exit.help
--versionPrint version information and then exit.help
-b BAUDRATESet serial port baud rate used for remote debugging.help
-l TIMEOUTSet timeout in seconds for remote debugging.help
--cd DIRChange current directory to DIR.help
--data-directory, -D DIRSet CUDA-GDB's data-directory to DIR.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.