OS Manuals

/usr/local/cuda-13.2/bin/cuda-gdbserver

CUDA GDB

From nvidia-cuda-gdb-13.2 13.2.86-r2 (extra-packages), captured 2026-11-05 by running cuda-gdbserver --help (exit 0). permalink

Usage:	gdbserver [OPTIONS] COMM PROG [ARGS ...]
	gdbserver [OPTIONS] --attach COMM PID
	gdbserver [OPTIONS] --multi COMM

COMM may either be a tty device (for serial debugging),
HOST:PORT to listen for a TCP connection, or '-' or 'stdio' to use
stdin/stdout of gdbserver.
PROG is the executable program.  ARGS are arguments passed to inferior.
PID is the process ID to attach to, when --attach is specified.

Operating modes:

  --attach              Attach to running process PID.
  --multi               Start server without a specific program, and
                        only quit when explicitly commanded.
  --once                Exit after the first connection has closed.
  --help                Print this message and then exit.
  --version             Display version information and exit.

Other options:

  --wrapper WRAPPER --  Run WRAPPER to start new programs.
  --disable-randomization
                        Run PROG with address space randomization disabled.
  --no-disable-randomization
                        Don't disable address space randomization when
                        starting PROG.
  --startup-with-shell
                        Start PROG using a shell.  I.e., execs a shell that
                        then execs PROG.  (default)
  --no-startup-with-shell
                        Exec PROG directly instead of using a shell.
                        Disables argument globbing and variable substitution
                        on UNIX-like systems.

Debug options:

  --debug[=OPT1,OPT2,...]
                        Enable debugging output.
                          Options:
                            all, threads, event-loop, remote
                          With no options, 'threads' is assumed.
                          Prefix an option with '-' to disable
                          debugging of that component.
  --debug-format=OPT1[,OPT2,...]
                        Specify extra content in debugging output.
                          Options:
                            all
                            none
                            timestamp
  --disable-packet=OPT1[,OPT2,...]
                        Disable support for RSP packets or features.
                          Options:
                            vCont, T, Tthread, qC, qfThreadInfo and
                            threads (disable all threading packets).

For more information, consult the 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 (13)
OptionDescriptionSource
--attachAttach to running process PID.help
--multiStart server without a specific program, and only quit when explicitly commanded.help
--onceExit after the first connection has closed.help
--helpPrint this message and then exit.help
--versionDisplay version information and exit.help
--wrapper WRAPPERRun WRAPPER to start new programs.help
--disable-randomizationRun PROG with address space randomization disabled.help
--no-disable-randomizationDon't disable address space randomization when starting PROG.help
--startup-with-shellStart PROG using a shell.help
--no-startup-with-shellExec PROG directly instead of using a shell.help
--debug OPT1Enable debugging output.help
--debug-format OPT1Specify extra content in debugging output.help
--disable-packet OPT1Disable support for RSP packets or features.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.