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
- performs fast finalization with the reduced number of loaded samples.vtune
Actions Modified
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.
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