Intel® VTune™ Amplifier XE and Intel® VTune™ Amplifier for Systems Help
The amplxe-cl command tool of the Intel® VTune™ Amplifier supports different command options.
Run the specified analysis type and collect data into a result. |
|
Run a custom hardware event-based sampling or user-mode sampling and tracing collection using your settings. |
|
Issue a command to a running collect action. |
|
Perform symbol resolution to finalize or re-resolve a result. |
|
Display brief explanations of command line arguments. |
|
Import one or more collection data files/directories. |
|
Generate a specified type of report from an analysis result. |
|
Display version information for the amplxe-cl. |
To access the most current command line documentation for an action, enter amplxe-cl -help <action>, where <action> is one of the available actions. To see all available actions, enter amplxe-cl -help.
Action options define a behavior applicable to the specified action; for example, the -result-dir option specifies the result directory path for the collect action.
To access the list of available action options for an action, enter amplxe-cl -help <action>, where <action> is one of the available actions. To see all available actions, enter amplxe-cl -help.
Action-Option Usage Rules:
If opposing action-options are used on the same command line, the last specified action-option applies.
An action-option that is redundant or has no meaning in the context of the specified action is ignored.
Attempted use of an inappropriate action-option which would lead to unexpected behavior returns a usage error.
Global options define a behavior applicable to all actions; for example, the -quiet option suppresses non-essential messages for all actions. You may have one or more global options per command.
To access the list of available global options for an action, enter amplxe-cl -help <action>, where <action> is one of the available actions. To see all available actions, enter amplxe-cl -help.
Intel® VTune™ Amplifier offers many ways to get information on analysis options.
VTune Amplifier can re-use analysis configuration options set in the GUI version and Generating Command Line Configuration from GUI version of such a configuration. You can copy this command line to the clipboard and use it for the command line analysis. To do this, use the Command Line... button in the Analysis Type window. This also works for custom analysis types.
To get more information on an action, enter: amplxe-cl -help <action>. For example, this command returns help for the collect-with action:
$ amplxe-cl -help collect-with
For information on a specific analysis type, enter: amplxe-cl -help collect <analysis_type> or amplxe-cl -help collect-with <analysis_type>. For example, this command returns help for the locksandwaits analysis type:
$ amplxe-cl -help collect locksandwaits
For information on a specific report, enter: amplxe-cl -help report <report_name>. For example, this command returns help for the callstacks report:
$ amplxe-cl -help report callstacks