Debugging and profiling: Difference between revisions

From Alliance Doc
Jump to navigation Jump to search
(Created page with "The Compute Canada national clusters offer a variety of debugging and profiling tools, both command line and those with a graphical user interface, whose use requires an X11 c...")
 
No edit summary
 
(48 intermediate revisions by 6 users not shown)
Line 1: Line 1:
The Compute Canada national clusters offer a variety of debugging and profiling tools, both command line and those with a graphical user interface, whose use requires an X11 connection. Note that debugging sessions should be conducted using an [[Running_jobs#Interactive_jobs | interactive job]] and not run on the login node.  
<languages />
<translate>
<!--T:1-->
An important step in the software development process, particularly for compiled languages like Fortran and C/C++, concerns the use of a program called a debugger to detect and identify the origin of runtime errors (e.g. memory leaks, floating point exceptions and so forth) so that they can be eliminated. Once the program's correctness is assured, a further step is profiling the software. This involves the use of another software tool, a profiler, determine what percentage of the total execution time each section of the source code is responsible for when run with a representative test case. A profiler can give information like how many times a particular function is called, which other functions are calling it and how many milli-seconds of time each invocation of this function costs on average.  


== Gnu Debugger (gdb) ==
= Debugging and profiling tools= <!--T:2-->


== PGI Debugger (pgdb) ==
<!--T:3-->
Our national clusters offer a variety of debugging and profiling tools, both command line and those with a graphical user interface, whose use requires an X11 connection. Note that debugging sessions should be conducted using an [[Running_jobs#Interactive_jobs | interactive job]] and not run on a login node.


== Allinea Debugger (ddt) ==
== GNU debugger (gdb) == <!--T:4-->


Please see the [[Allinea_software | Allinea software page]].
<!--T:5-->
Please see the [[GDB | GDB page]].
 
== PGI debugger (pgdb) == <!--T:6-->
Please see the [https://docs.alliancecan.ca/wiki/Pgdbg Pgdbg page].
 
== ARM debugger (ddt) == <!--T:7-->
 
<!--T:8-->
Please see the [[ARM software | ARM software page]].
 
==GNU profiler (gprof) == <!--T:9-->
 
<!--T:10-->
Please see the [[Gprof | Gprof  page]].
 
== Scalasca profiler (scalasca, scorep, cube) == <!--T:11-->
 
<!--T:19-->
Scalasca is an open source, GUI-driven parallel profiling tool set. It is currently available for <b>gcc 9.3.0</b> and <b>OpenMPI 4.0.3</b>, with AVX2 or AVX512 architecture. Its environment can be loaded with:
 
<!--T:20-->
<code>module load StdEnv/2020 gcc/9.3.0 openmpi/4.0.3 scalasca</code>
 
<!--T:21-->
The current version is <b>2.5</b>. More information can be found in the 2.x user guide, which contains workflow examples [https://apps.fz-juelich.de/scalasca/releases/scalasca/2.5/docs/manual/ here].
 
== PGI profiler (pgprof) == <!--T:12-->
Please see the [[PGPROF | Pgprof page]].
 
== Nvidia command-line profiler (nvprof) == <!--T:13-->
Please see the [[Nvprof | nvprof page]].
 
==Valgrind== <!--T:15-->
 
<!--T:22-->
Please see the [[Valgrind | Valgrind page]].
 
= External references = <!--T:16-->
 
<!--T:17-->
* [https://docs.scinet.utoronto.ca/index.php/Introduction_To_Performance Introduction to (Parallel) Performance] from SciNet
* [https://www.youtube.com/watch?v=YsF5KMr9uEQ Code profiling on Graham], video, 54 minutes.
 
<!--T:18-->
[[Category:Pages with video links]]
</translate>

Latest revision as of 17:40, 5 June 2023

Other languages:

An important step in the software development process, particularly for compiled languages like Fortran and C/C++, concerns the use of a program called a debugger to detect and identify the origin of runtime errors (e.g. memory leaks, floating point exceptions and so forth) so that they can be eliminated. Once the program's correctness is assured, a further step is profiling the software. This involves the use of another software tool, a profiler, determine what percentage of the total execution time each section of the source code is responsible for when run with a representative test case. A profiler can give information like how many times a particular function is called, which other functions are calling it and how many milli-seconds of time each invocation of this function costs on average.

Debugging and profiling tools

Our national clusters offer a variety of debugging and profiling tools, both command line and those with a graphical user interface, whose use requires an X11 connection. Note that debugging sessions should be conducted using an interactive job and not run on a login node.

GNU debugger (gdb)

Please see the GDB page.

PGI debugger (pgdb)

Please see the Pgdbg page.

ARM debugger (ddt)

Please see the ARM software page.

GNU profiler (gprof)

Please see the Gprof page.

Scalasca profiler (scalasca, scorep, cube)

Scalasca is an open source, GUI-driven parallel profiling tool set. It is currently available for gcc 9.3.0 and OpenMPI 4.0.3, with AVX2 or AVX512 architecture. Its environment can be loaded with:

module load StdEnv/2020 gcc/9.3.0 openmpi/4.0.3 scalasca

The current version is 2.5. More information can be found in the 2.x user guide, which contains workflow examples here.

PGI profiler (pgprof)

Please see the Pgprof page.

Nvidia command-line profiler (nvprof)

Please see the nvprof page.

Valgrind

Please see the Valgrind page.

External references

Retrieved from "https://docs.alliancecan.ca/mediawiki/index.php?title=Debugging_and_profiling&oldid=137709"