User Guide

  • 2022.2
  • 08/08/2022
  • Public Content
Contents

PCTRACE

Syntax

PCTRACE [on|off|<trace levels>|<skip levels>:<trace levels>]

Variable

VT_PCTRACE

Default

off
for performance analysis,
on
otherwise

Description

Some platforms support the automatic stack sampling for MPI calls and user-defined events. Intel Trace Collector then remembers the Program Counter (PC) values on the call stack and translates them to source code locations based on debug information in the executable. It can sample a certain number of levels (
<trace levels>
) and skip the initial levels (
<skip levels>
). Both values can be in the range of
0
to
15
.
Skipping levels is useful when a function is called from within another library and the source code locations within this library shall be ignored.
ON
is equivalent to
0:1
(no skip levels, one trace level).
The value specified with
PCTRACE
applies to all symbols that are not matched by any filter rule or where the relevant filter rule sets the logging state to
ON
. In other words, an explicit logging state in a filter rule overrides the value given with
PCTRACE
.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.