Developer Guide and Reference

Contents

tcollect-filter, Qtcollect-filter

Lets you enable or disable the instrumentation of specified functions. You must also specify option [Q]tcollect.

Syntax

Linux:
-tcollect-filter
filename
macOS:
None
Windows:
/Qtcollect-filter
:
filename
Arguments
filename
Is a configuration file that lists filters, one per line. Each filter consists of a regular expression string and a switch. Strings with leading or trailing white spaces must be quoted. Other strings do not have to be quoted. The switch value can be ON, on, OFF, or off.
Default
OFF
Functions are not instrumented. However, if option
-tcollect
(Linux)
or
/Qtcollect
(Windows)
is specified, the filter setting is ".* ON" and all functions get instrumented.
Description
This option lets you enable or disable the instrumentation of specified functions.
To get instrumentation with a specified filter (or filters), you must specify both option
[Q]tcollect
and option
[Q]tcollect-filter
.
During instrumentation, the regular expressions in the file are matched against the function names. The switch specifies whether matching functions are to be instrumented or not. Multiple filters are evaluated from top to bottom with increasing precedence.
The names of the functions to match against are formatted as follows:
  • C++ function names are demangled and the C++ class hierarchy is used. Function parameters are stripped to keep the function names shorter.