filter
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
-report < option. If you do not specify a result directory, the latest
result is used by default.
vtune
report_name
> -r <result_dir
>
filter=?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