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

finalization-mode

Perform full finalization, fast finalization, deferred finalization or skip finalization.

GUI Equivalent

Configure Analysis window > WHAT pane > Advanced section > Select finalization mode option

Syntax

finalization-mode=<value>

Arguments

full

Perform full finalization on the target system.

fast

Reduce the number of loaded samples to speed up post-processing.

deferred

Only calculate the binary checksums for finalization on another machine.

none

Skip finalization.

Default

fast

vtune performs fast finalization with the reduced number of loaded samples.

Description

Use the finalization-mode option with the collect, collect-with, import, and finalize commands to define the finalization mode for the result.

Use the full finalization mode to perform the finalization on unchanged sampling data on the target system. This mode takes the most time and resources to complete, but produces the most accurate results.

Use the fast finalization mode to perform the finalization on the target system using algorithmically reduced sampling data. This greatly reduces the finalization time with a negligible impact on accuracy in most cases. If you discover inaccuracies in your finalization, you can always use the finalize action with the full finalization mode to re-finalize the result in full mode.

Use the deferred finalization mode to collect the sampling data and the binary checksums to perform the finalization on another machine. After data collection completes, you can finalize and open the analysis result on the host system. This mode may be useful for profiling applications on targets with limited computational resources, such as IoT devices, and finalizing the result later on the host machine.

NOTE:

To have binaries successfully resolved during finalization, ensure that the host system has access to the binaries.

Use the none option to skip finalization entirely and to not collect the binary checksums. You can also finalize this result later, however, you may encounter certain limitations. For example, if the binaries on the target system have changed or have become unavailable since the sampling data collection, binary resolution may produce an inaccurate or missing result for the affected binary.

You can always repeat the finalization process in a different mode using the finalize action.

Example

The following command starts the Hotspots analysis on Windows and only calculates the binary checksums for finalization on another machine.

vtune -collect hotspots -knob sampling-mode=hw -finalization-mode=deferred -- C:\test\myApp.exe