User and Reference Guide

Contents

STATE

Syntax
STATE <pattern> <filter body>
Variable
VT_STATE
Default
on
Description
Defines a filter for any state or function that matches the pattern. Patterns are extended shell patterns: they may contain the wildcard characters
*
,
**
,
?
and
[]
to match any number of characters but not the colon, any number of characters including the colon, exactly one character or a list of specific characters. Pattern matching is case insensitive.
The state or function name that the pattern is applied to consists of a class name and the symbol name, separated by a
:
(colon). Deeper class hierarchies as in Java* or C++ may have several class names, also separated by a colon. The colon is special and not matched by the
*
or
?
wildcard. To match it use
**
. The body of the filter may specify the logging state with the same options as PCTRACE. On some platforms further options are supported, as described below.
Valid patterns are:
  • MPI:*
    (all MPI functions)
  • *:*send*
    (any function that contains "send" inside any class)
  • **:*send*
    (any function that contains "send", even if the class actually consists of multiple levels; same as
    **send*
    )
  • MPI:*send*
    (only send functions in MPI)

Product and Performance Information

1

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