Intel® VTune™ Amplifier
Command output from amplxe-cl includes the following:
A collect or collect-with action generates a result directory to contain the analysis result.
By default, the result directory name is r@@@{at} where:
@@@ - next available number for similarly named result directories in the current working directory. The series begins with 000.
{at} - analysis type code. This code represents the analysis type used when the result was created.
For example: r001hs, where:
001 - next available number
hs - the selected analysis type (hs stands for "Hotspots" analysis type)
The result directory name may be assigned according to the default naming conventions, or you may use the result-dir option to specify the result directory name during collection. Your specified result directory name can include up to five @ counters, so the result directory can be specified in scripts without having to update the result directory value each time.
By default, result directories are created in the current working directory. If you want to specify an alternative location, use the user-data-dir option to specify the parent directory for result directories. If you use this option during collection, remember to include it for any other actions you might perform on these results, such as generating reports.
You cannot put multiple results into the same result directory. If you specify the same result directory for multiple analysis runs, an error is returned. Use the auto-increment counter (@@@) to work around this restriction.
During a collect or collect-with action, the amplxe-cl command tool creates a result directory in which it stores the *.amplxe result file. In addition to analysis data, the result file stores data about the analysis environment, including start time, host machine name, product ID, CPU count, and analysis type used for collection.
The result filename is derived from the result directory name. For example: If the result directory name is r001hs, the result filename is r001hs.amplxe.
At the end of an analysis run, the amplxe-cl command tool displays the following information by default:
The summary performance statistics is written to stdout.
Internal errors are written to stderr.
The amplxe-cl command returns the following exit codes:
|
0 |
Success and no new problems detected |
|
1 |
Usage error |
|
2 |
Internal error |
|
4 |
Application returned a non-zero exit code |
|
5 |
Application returned a non-zero exit code and usage error |
|
6 |
Application returned a non-zero exit code and internal error |
Use the return-app-exitcode action-option if you want to return the application exit code instead of the amplxe-cl exit code.
After collecting a result, you can use the report action to generate one or more types of reports from the result.
By default, the report is output in text format to stdout.