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 identical 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.