finalize
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=noneaction-option was specified for acollectorcollect-withaction.
- 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/r001hsFinalize the unfinalized Hotspots analysis result
r001hs
created previously.
vtune -finalize -result-dir /tmp/test/r001hsRe-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