User Guide

Intel® VTune™ Profiler User Guide

ID 766319
Date 7/13/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

filter

Specify which data to include or exclude.

GUI Equivalent

Toolbar: Filter

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

report

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