Totalview® for HPC User Guide : PART II Debugging Tools and Tasks : Chapter 7 Stepping through and Executing your Program : Using Stepping Commands : Skipping Function Calls
Skipping Function Calls
You can define skip rules that allow you to identify functions that you are not interested in debugging. The TotalView dskip command allows you to create and manage single-stepper skip rules that modify the way source-level single stepping works.
You can add rules that match a function, all functions in a source file, or a specific function in a specific source file. Functions can be matched by the function name or a regular expression (Tcl “regexp”). Files can be matched by the file name or a glob pattern (Tcl “string match”).
TotalView implements two skip rule variants, over and through, as follows:
1. A matching and enabled skip over rule changes the behavior of all source-level step-into operations, such as the dstep command or the Step button or menu items in the graphical user interface.
A skip over rule tells TotalView to not step into the function, but instead step over the function. Skip over is most useful to avoid stepping into library functions, such as C++ STL code.
2. A matching and enabled skip through rule changes the behavior of all source-level single-stepping operations, such as the dstep and dnext commands or the Step and Next buttons or menu items in the graphical user interface.
A skip through rule tells TotalView to ignore any source-line information for the function, so that single stepping does not stop at source lines within the function. However, if the function being skipped through calls another function, that call is handled according to original single-stepping operation. Skip through is most useful for callback or thunk functions.
 
RELATED TOPICS 
 
The dskip command
dskip in "CLI Commands" in the TotalView for HPC Reference Guide
The dnext command
dnext in "CLI Commands" in the TotalView for HPC Reference Guide
The dstep command
dstep in "CLI Commands" in the TotalView for HPC Reference Guide