User Guide

Contents

filter

Specify which data to include or exclude.
GUI Equivalent

Syntax

-filter
<column_name>
<value>
Arguments
Argument
Description
<column_name>
Column to which this filter will apply.
<value>
Program unit name to be filtered in or out.
Actions Modified
Description
Use the
filter
option to include or exclude data from a report based on the specified
column_name
, the
= or != operator
, and the
value
for that column.
To display a list of available filter attributes for a particular report, use
vtune
-report <
report_name
> -r <
result_dir
> filter=?
option. If you do not specify a result directory, the latest result is used by default.
Examples
Generate a hotspots report on Linux* from the specified hotspots result that only includes data from the
appname
process. Data from other processes is excluded. This report is sent to
stdout
.
vtune -report hotspots -filter process=appname -result-dir /temp/test/r001hs
Generate a hotspots report from the most recent hotspots for all modules except
foo
, and save it as a text file in the specified directory on Windows*.
vtune -R hotspots -filter module!=foo -report-output C:\Test\report.txt
Obtain a list of filters available for the hw-events report for a Microarchitecture Exploration analysis result on Linux:
vtune -report hw-events -r /temp/test/r029ue/r029ue filter=? vtune: Using result path '/temp/test/r029ue/r029ue' Available values for '-filter' option are: basic-block : Basic Block basic-block-only : Basic Block function-only : Function function-mangled : Function module : Module module-path : Module Path process : Process thread-id : TID process-id : PID source-file : Source File source-line : Source Line source-file-path : Source File Path thread : Thread function-callstack : Function function-parent-callstack : Function callstack : Call Stack callstack-address : Call Stack no-attr-callstack : Call Stack cpuid : Logical Core address : Code Location function-start-address : Start Address function : Function source-function : Source Function package : Package

Product and Performance Information

1

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