Skip to content
Snippets Groups Projects
Commit 55153b0f authored by Jan Siwiec's avatar Jan Siwiec
Browse files

Update intel-debugger.md

parent 6239151a
No related branches found
No related tags found
4 merge requests!368Update prace.md to document the change from qprace to qprod as the default...,!367Update prace.md to document the change from qprace to qprod as the default...,!366Update prace.md to document the change from qprace to qprod as the default...,!323extended-acls-storage-section
# Intel Debugger # Intel Debugger
IDB is no longer available since Intel Parallel Studio 2015 !!! note
IDB is no longer available since Intel Parallel Studio 2015.
## Debugging Serial Applications ## Debugging Serial Applications
The intel debugger version is available, via module intel/13.5.192. The debugger works for applications compiled with C and C++ compiler and the ifort fortran 77/90/95 compiler. The debugger provides java GUI environment. Use [X display][1] for running the GUI. The Intel debugger version is available via the intel/13.5.192 module. The debugger works for applications compiled with the C and C++ compiler and the ifort Fortran 77/90/95 compiler. The debugger provides a Java GUI environment. Use [X display][1] to run the GUI.
```console ```console
$ ml intel/13.5.192 $ ml intel/13.5.192
...@@ -12,13 +13,13 @@ $ ml Java ...@@ -12,13 +13,13 @@ $ ml Java
$ idb $ idb
``` ```
The debugger may run in text mode. To debug in text mode, use The debugger may run in text mode. To debug in the text mode, use:
```console ```console
$ idbc $ idbc
``` ```
To debug on the compute nodes, module intel must be loaded. The GUI on compute nodes may be accessed using the same way as in [the GUI section][1]. To debug on the compute nodes, the intel module must be loaded. The GUI on compute nodes may be accessed using the same way as in the [GUI section][1].
Example: Example:
...@@ -32,15 +33,15 @@ $ icc -O0 -g myprog.c -o myprog.x ...@@ -32,15 +33,15 @@ $ icc -O0 -g myprog.c -o myprog.x
$ idb ./myprog.x $ idb ./myprog.x
``` ```
In this example, we allocate 1 full compute node, compile program myprog.c with debugging options -O0 -g and run the idb debugger interactively on the myprog.x executable. The GUI access is via X11 port forwarding provided by the PBS workload manager. In this example, we allocate 1 full compute node, compile the myprog.c program with the -O0 -g debugging options and run the IDB debugger interactively on the myprog.x executable. The GUI access is via the X11 port forwarding provided by the PBS workload manager.
## Debugging Parallel Applications ## Debugging Parallel Applications
Intel debugger is capable of debugging multithreaded and MPI parallel programs as well. The Intel debugger is capable of debugging multithreaded and MPI parallel programs as well.
### Small Number of MPI Ranks ### Small Number of MPI Ranks
For debugging small number of MPI ranks, you may execute and debug each rank in separate xterm terminal (do not forget the [X display][1]. Using Intel MPI, this may be done in following way: For debugging small number of MPI ranks, you may execute and debug each rank in a separate xterm terminal (do not forget the [X display][1]. Using Intel MPI, this may be done in the following way:
```console ```console
$ qsub -q qexp -l select=2:ncpus=24 -X -I $ qsub -q qexp -l select=2:ncpus=24 -X -I
...@@ -50,11 +51,11 @@ $ ml intel ...@@ -50,11 +51,11 @@ $ ml intel
$ mpirun -ppn 1 -hostfile $PBS_NODEFILE --enable-x xterm -e idbc ./mympiprog.x $ mpirun -ppn 1 -hostfile $PBS_NODEFILE --enable-x xterm -e idbc ./mympiprog.x
``` ```
In this example, we allocate 2 full compute node, run xterm on each node and start idb debugger in command line mode, debugging two ranks of mympiprog.x application. The xterm will pop up for each rank, with idb prompt ready. The example is not limited to use of Intel MPI In this example, we allocate 2 full compute nodes, run xterm on each node, and start the IDB debugger in the command line mode, debugging two ranks of the mympiprog.x application. The xterm will pop up for each rank with IDB prompt ready. The example is not limited to use of Intel MPI.
### Large Number of MPI Ranks ### Large Number of MPI Ranks
Run the idb debugger from within the MPI debug option. This will cause the debugger to bind to all ranks and provide aggregated outputs across the ranks, pausing execution automatically just after startup. You may then set break points and step the execution manually. Using Intel MPI: Run the IDB debugger from within the MPI debug option. This will cause the debugger to bind to all ranks and provide aggregated outputs across the ranks, pausing execution automatically just after startup. You may then set break points and step the execution manually. Using Intel MPI:
```console ```console
$ qsub -q qexp -l select=2:ncpus=24 -X -I $ qsub -q qexp -l select=2:ncpus=24 -X -I
...@@ -66,11 +67,11 @@ $ mpirun -n 48 -idb ./mympiprog.x ...@@ -66,11 +67,11 @@ $ mpirun -n 48 -idb ./mympiprog.x
### Debugging Multithreaded Application ### Debugging Multithreaded Application
Run the idb debugger in GUI mode. The menu Parallel contains number of tools for debugging multiple threads. One of the most useful tools is the **Serialize Execution** tool, which serializes execution of concurrent threads for easy orientation and identification of concurrency related bugs. Run the IDB debugger in GUI mode. The Parallel menu contains a number of tools for debugging multiple threads. One of the most useful tools is the **Serialize Execution** tool, which serializes execution of concurrent threads for easy orientation and identification of concurrency related bugs.
## Further Information ## Further Information
Exhaustive manual on IDB features and usage is published at [Intel website][a]. Exhaustive manual on IDB features and usage is published at the [Intel website][a].
[1]: ../../../general/accessing-the-clusters/graphical-user-interface/x-window-system.md [1]: ../../../general/accessing-the-clusters/graphical-user-interface/x-window-system.md
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment