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 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 [email protected]

COPYRIGHT

   2013 NVIDIA Corporation. All rights reserved.

Opportunity

Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.

Education

Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.