Intel(R) VTune(TM) Amplifier XE 2011 Update 7 (build 206420) Command Line Tool
Copyright (C) 2009-2011 Intel Corporation. All rights reserved.-c, -collect=<string> Choose analysis type.
Perform a data collection of the specified analysis type.
Action Options:
-allow-multiple-runs | -no-allow-multiple-runs (default)
Enable multiple runs to achieve more precise
results for hardware event-based collections.
When disabled, the collector multiplexes events
running a single collection, which lowers result
precision.
-analyze-system | -no-analyze-system (default)
Enable analyzing all processes running on the
system. When disabled, only the target process is
analyzed. This option is applicable to hardware
event-based analysis types only.
-app-working-dir=<string> Specify the working directory to be used when
profiling a program.
-auto-finalize (default) | -no-auto-finalize
Turn on/off automatic result finalization after
data collection/import. --no-auto-finalize option
also turns off the summary report (--no-summary).
-call-stack-mode=all | user-only | user-plus-one (user-only)
Choose how to show system functions in the stack.
-cpu-mask=<string> Specify CPU(s) to collect data on (for example:
2-8,10,12-14). This option is applicable to
hardware event-based analysis types only.
-data-limit=<integer> (100) Limit the amount of raw data to be collected.
This option is not applicable to hardware
event-based analysis types.
-discard-raw-data | -no-discard-raw-data (default)
Discard raw collector data from the result upon
finalization.
-duration=<string> Specify the duration for collection (in seconds).
Required for system-wide collection. Can also be
'unlimited'.
-fast-frames-threshold=<double> (100)
Specify a threshold to separate Good and Fast
frames. Frame rates higher than this threshold
are marked as Fast. This threshold needs to be
larger than the Slow frames threshold.
-follow-child (default) | -no-follow-child
Collect data on processes launched by the target
process. Recommended for applications launched by
a script.
-inline-mode=on | off (on) Choose to show or hide inline functions in the
stack.
-k, -knob=<string> Set knob value for selected analysis type as
-knob knobName=knobValue.
-mrte-mode=auto | native | mixed | managed (auto)
Select a profiling mode. The Native mode does not
attribute data to managed source. The Mixed mode
attributes data to managed source where
appropriate. The Managed mode tries to limit
attribution to managed source when available.
-r, -result-dir=<string> (r@@@{at})
Specify result directory path.
-resume-after=<unsigned integer>
Specify time (in milliseconds) to delay data
collection after the application starts.
-return-app-exitcode | -no-return-app-exitcode
Return the target exit code instead of the
command-line interface exit code.
-search-dir=<string> <all | bin | src | sym[:<p | r>]>=<directory>.
<directory> is the name of the search directory
for binaries (bin), sources (src), symbols (sym),
or all these file types (all). Use ':r' to
perform a recursive search of all subdirectories.
Use ':p' to indicate highest priority search
directories (directories that should be searched
prior to others, including environment paths and
absolute paths). You can use these options
together as ':rp'.
-slow-frames-threshold=<double> (40)
Specify a threshold to separate Slow and Good
frames. Frame rates lower than this threshold are
marked as Slow. This threshold needs to be
smaller than the Fast frames threshold.
-start-paused Start data collection paused.
-strategy=<string> Specify how exactly child processes should be
analyzed. This option is not applicable to
hardware event-based analysis types.
-summary (default) | -no-summary
Turn on/off showing the summary report after data
collection/import.
-target-duration-type=veryshort | short | medium | long (short)
Estimate the application duration time. This
value affects the size of collected data. For
long running targets, sampling interval is
increased to reduce the result size. For hardware
event-based analysis types, the duration estimate
affects a multiplier applied to the configured
Sample after value.
-target-pid=<unsigned integer>
Attach collection to a running process specified
by process ID.
-target-process=<string> Attach collection to a running process specified
by process name.
Global Options:
-q, -quiet Suppress non-essential messages
-user-data-dir=<string> Specify the base directory for result paths
provided by --result-dir option. By default, the
current working directory is used.
-v, -verbose Print additional information
Examples:
1) Perform the hotspots collection on the given target.
amplxe-cl -collect hotspots a.out
The default naming template for result directories is r@@@{at}, where:
@@@ is an increasing numeric sequence automatically assigned by amplxe-cl;
{at} is an abbreviation of the analysis type.
2) Collect the results into the 'r001cc' result directory.
amplxe-cl -collect concurrency -r r001cc a.out
Use '-help collect <analysis type>' for more information about each analysis type.
Available Analysis Types:
atom-general-exploration Intel(R) Atom(TM) Processor - General Exploration
concurrency Concurrency
core2-bandwidth Intel(R) Core(TM) 2 Processor Family - Bandwidth
core2-bandwidth-breakdown Intel(R) Core(TM) 2 Processor Family - Bandwidth Breakdown
core2-cycles-uops Intel(R) Core(TM) 2 Processor Family - Cycles and uOps
core2-general-exploration Intel(R) Core(TM) 2 Processor Family - General Exploration
core2-memory-access Intel(R) Core(TM) 2 Processor Family - Memory Access
hotspots Hotspots
lightweight-hotspots Lightweight Hotspots
locksandwaits Locks and Waits
nehalem-cycles-uops Intel(R) Microarchitecture Code Name Nehalem - Cycles and uOps
nehalem-frontend-investigation Intel(R) Microarchitecture Code Name Nehalem - Front End Investigation
nehalem-general-exploration Intel(R) Microarchitecture Code Name Nehalem - General Exploration
nehalem-memory-access Intel(R) Microarchitecture Code Name Nehalem - Memory Access
snb-access-contention Intel(R) Microarchitecture Code Name Sandy Bridge - Access Contention
snb-bandwidth Intel(R) Microarchitecture Code Name Sandy Bridge - Bandwidth
snb-branch-analysis Intel(R) Microarchitecture Code Name Sandy Bridge - Branch Analysis
snb-client Intel(R) Microarchitecture Code Name Sandy Bridge - Client Analysis
snb-core-port-saturation Intel(R) Microarchitecture Code Name Sandy Bridge - Core Port Saturation
snb-cycles-uops Intel(R) Microarchitecture Code Name Sandy Bridge - Cycles and uOps
snb-general-exploration Intel(R) Microarchitecture Code Name Sandy Bridge - General Exploration
snb-loop-analysis Intel(R) Microarchitecture Code Name Sandy Bridge - Loop Analysis
snb-memory-access Intel(R) Microarchitecture Code Name Sandy Bridge - Memory Access
snb-port-saturation Intel(R) Microarchitecture Code Name Sandy Bridge - Port Saturation
wsmex-read-bandwidth Intel(R) Microarchitecture Code Name Nehalem - Read Bandwidth
wsmex-write-bandwidth Intel(R) Microarchitecture Code Name Nehalem - Write Bandwidth