CUDA-GDB(1)

NAME

cuda-gdb - The NVIDIA CUDA Debugger

cuda-gdbserver - The NVIDIA CUDA-GDB server for remote debugging

SYNOPSIS

cuda-gdb [gdb-options] [--cuda-use-lockfile VALUE] [prog [core|procID]]

cuda-gdb [gdb-options] [--cuda-use-lockfile VALUE] --args prog [arguments]

DESCRIPTION

cuda-gdb is the NVIDIA CUDA debugger for Unix platforms. It is gdb with extra commands specific to CUDA debugging.

All the existing gdb commands are supported. On top of those commands, the following CUDA-specific commands are also supported.

  Info Commands

Commands to query information about CUDA activities:

info cuda devices
    information about all the devices

info cuda sms
    information about all the SMs in the current device

info cuda warps
    information about all the warps in the current SM

info cuda lanes
    information about all the lanes in the current warp

info cuda kernels
    information about all the active kernels

info cuda contexts
    information about all the contexts

info cuda blocks
    information about all the active blocks in the current kernel

info cuda threads
    information about all the active threads in the current kernel

info cuda launch trace
    information about the parent kernels of the kernel in focus

info cuda launch children
    information about the kernels launched by the kernels in focus

  Focus Commands

Commands to query or switch the focus of the debugger:

cuda block
    Print or select the current CUDA block

cuda device
    Print or select the current CUDA device

cuda grid
    Print or select the current CUDA grid

cuda kernel
    Print or select the current CUDA kernel

cuda lane
    Print or select the current CUDA lane

cuda sm
    Print or select the current CUDA SM

cuda thread
    Print or select the current CUDA thread

cuda warp
    Print or select the current CUDA warp

  Configuration Commands

Commands to configure the CUDA-specific commands:

set cuda api_failures
    Set the api_failures to ignore/stop/hide on CUDA driver API call errors

set cuda break_on_launch
    Automatically set a breakpoint at the entrance of kernels

set cuda coalescing
    Turn on/off coalescing of the CUDA commands output

set cuda context_events
    Turn on/off context events (push/pop/create/destroy) output messages

set cuda defer_kernel_launch_notifications
    Turn on/off deferral of kernel launch messages

set cuda disassemble_from
    Choose whether to disassemble from the device memory (slow) or the ELF image (fast)

set cuda gpu_busy_check
    Turn on/off GPU busy check the next time the inferior application is run

set cuda hide_internal_frame
    Set hiding of the internal CUDA frames when printing the call stack

set cuda kernel_events
    Turn on/off kernel events (launch/termination) output messages

set cuda launch_blocking
    Turn on/off CUDA kernel launch blocking (effective starting from the next run)

set cuda memcheck
    Turn on/off CUDA Memory Checker next time the inferior application is run

set cuda notify
    Thread to notify about CUDA events when no other known candidate

set cuda software_preemption
    Turn on/off CUDA software preemption debugging the next time the inferior application is run

set cuda thread_selection
    Set the automatic thread selection policy to use when the current thread cannot be selected

OPTIONS

CUDA-GDB supports the same options as GDB, with the addition of the following options:

--cuda-use-lockfile=VALUE
    If VALUE is 0, CUDA-GDB will not create a lock file and will not enforce the exclusive usage of GPUs.

ENVIRONMENT

TMPDIR
    If non-null, the full pathname for an alternate temporary directory. Note that the debugger must have write and exec permission to that directory.

FILES

~/.cuda-gdbinit
    Per user configuration file. The file format is indentical to ~/.gdbinit. See gdb(5) for further details.

/tmp/cuda-dbg/
    Temporary directory where the debugger stores intermediate files. The directory must have write and and exec permissions. Use $TMPDIR to override the location.

NOTES

For more information about cuda-gdb, please see the online documentation at http://docs.nvidia.com/cuda/cuda-gdb/index.html.

For more information about CUDA-related features, type help cuda or help info cuda from within CUDA-GDB, or consult the CUDA-GDB online manual.

SEE ALSO

cuda-binaries(1), cuda-libraries(7), gdb(1)

REPORTING BUGS

Email bugs to cuda-debugger-bugs@nvidia.com

COPYRIGHT

©2013 NVIDIA Corporation. All rights reserved.