Intel® VTune™ Profiler User Guide

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.