User Guide

Intel® VTune™ Profiler User Guide

ID 766319
Date 11/07/2023
Public

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

Document Table of Contents

strategy

Specify which processes to analyze.

GUI Equivalent

Configure Analysis window > WHAT pane > Analyze child processes check box > Per-process Configuration

Syntax

-strategy <process_name1>:<profiling_mode>,<process_name2>:<profiling_mode>,...

Arguments

Argument

Description

<process_name>

The name of the process to which the strategy configuration applies. If <process_name> is empty, the strategy configuration applies by default to all processes for which a profiling strategy is not specified.

<profiling_mode>

The strategy for profiling the specified process. Possible values are:

Value

Description

trace:trace

Collect data on the process, and its child processes.

notrace:trace

Do not analyze the process, but collect data on its child processes.

notrace:notrace

Ignore the process, and its child processes, while collecting data.

trace:notrace

Analyze the process, but do not collect data on its child processes.

Default

:trace:trace

Analyze both parent and child processes.

Actions Modified

collect, collect-with

Description

Use the strategy action-option to specify which processes to analyze, and which to ignore.

This option is not applicable to hardware event-based analysis types.

Example

This example performs a Hotspots analysis where the strategy configuration limits data collection to the example process, and ignores its child processes.

vtune -collect hotspots -strategy :notrace:trace,example:trace:notrace /home/test/run_example.sh