Lets you enable or disable the instrumentation of specified functions.
IA-32, Intel® 64 architectures
Linux: | -tcollect-filter filename |
Mac OS X: | None |
Windows: | /Qtcollect-filter:filename |
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. |
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. |
This option lets you enable or disable the instrumentation of specified functions.
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:
The source file name is followed by a colon-separated function name. Source file names should contain the full path, if available. For example:
/home/joe/src/file.f:FOO_bar
Classes and function names are separated by double colons. For example:
/home/joe/src/file.fpp:app::foo::bar
You can use option -opt-report (Linux) or /Qopt-report (Windows) to get a full list of file and function names that the compiler recognizes from the compilation unit. This list can be used as the basis for filtering in the configuration file.
To use this option, you must have the Intel® Trace Collector installed and set up through one of its set-up scripts. This tool is a component of the Intel® Trace Analyzer and Collector.
For more details, see the Intel® Trace Collector User Guide.
None
Consider the following filters in a configuration file:
'.*' OFF '.*vector.*' ON
The above will cause instrumentation of only those functions having the string 'vector' in their names. No other function will be instrumented. Note that reversing the order of the two lines will prevent instrumentation of all functions.
To get a list of the file or routine strings that can be matched by the regular expression filters, generate an optimization report with tcollect information. For example:
Windows OS: ifort /Qtcollect /Qopt-report /Qopt-report-phase tcollect
Linux OS: ifort -tcollect -opt-report -opt-report-phase tcollect
Copyright © 1996-2010, Intel Corporation. All rights reserved.