Intel® VTune™ Profiler

User Guide

ID 766319
Date 3/22/2024
Public

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

Document Table of Contents

finalize

Perform symbol resolution to finalize or re-resolve a result.

GUI Equivalent

Configure Analysis tab > Re-resolve button

Syntax

-finalize -result-dir <PATH>

-I -result-dir <PATH>

Arguments

The finalize action must be used with the result-dir action-option, which passes in the PATH/name of the result directory.

Default

Result finalization is performed automatically as part of the collection process.

Description

Use the finalize action when you need to finalize an un-finalized or improperly finalized result in the directory specified by the result-dir action-option. Use GUI tools to change search directories settings, or use the search-dir action-option with the finalize action to re-finalize the result and update symbol information.

Normally, finalization is performed automatically as part of a collect or import action. However, you may need to re-finalize a result if:

  • Finalization was suppressed during collection or importation, for example when the -finalization-mode=none action-option was specified for a collect or collect-with action.

  • Re-resolve a result that was not properly finalized because some of the source or symbol files were missing. When viewed in the GUI or reports, the word [Unknown] commonly appears.

Example

In this example, finalization is suppressed when generating a Hotspots analysis result r001hs on Linux*.

vtune -collect hotspots -finalization-mode=none -result-dir /tmp/test/r001hs

Finalize the unfinalized Hotspots analysis result r001hs created previously.

vtune -finalize -result-dir /tmp/test/r001hs

Re-finalize a Hotspots analysis result r004hs, specifying search directories for symbol files.

vtune -finalize -search-dir /home/foo/system_modules -result-dir /tmp/test/r001hs