Using the VTune(TM) Performance Analyzer Sampling Collector for Mobile Internet Device (MID) User's Guide The VTune™ Performance Analyzer sampling data collector for Mobile Internet Device (MID) is a standalone command-line tool that provides the event-based sampling (EBS) functionality on a local system. The hardware-based sampling is a low-overhead, system- wide profiling that helps to identify which modules and functions are consuming the most time, giving a detailed look at the operating system and application. This tool enables you to configure the data collection, perform the system-wide profiling, and store the results in a file. The goal of this guide is to introduce you to all the sampling collector command-line options and explain how to use them to get more useful results. Contents 1 Sampling Collector Command-line Options........................................................... 4 1.1 Generic Collector Options ....................................................................... 4 [-d | -duration <in seconds>] ................................................................. 4 [-nb | -non-blocking]............................................................................. 4 [-c | -count] ......................................................................................... 4 [-ce | -count-emon] .............................................................................. 4 [-rc | -rerun-based-on-count] ................................................................. 5 [-si | -sampling-interval <interval in milliseconds>] ................................... 5 [-sb | -sample-buffer-size <size in kilobytes>].......................................... 6 [-sd | -sampling-delay <delay in seconds>].............................................. 6 [-msc | -max-samples-to-collect <maximum number of samples to collect>] 6 [-sm | -sampling-method <ebs|tbs>] ...................................................... 6 [-sp | -start-paused] ............................................................................. 6 [-cm | -cpu-mask <”text to specify the cpu mask”>] ................................. 7 [-out | -output-file <file name>] ............................................................. 7 [-of | -options-from-file <file name>] ...................................................... 7 [-app <full-path-to-the-application>]....................................................... 8 [-em | -event-multiplexing] .................................................................... 8 1.2 Event Specific Options............................................................................ 9 [-ec | -event-config ............................................................................... 9 Using the VTune(TM) Performance Analyzer Sampling Collector for Mobile Internet Device (MID) [-dc | -data-config................................................................................. 9 Syntax 10 1.2.1 Generic Event Modifiers............................................................10 :sa | sample-after = <sample after value> .................................10 1.2.2 Event Modifiers for P6 Processor Family ......................................10 2 Using the VTune Analyzer Sampling Collector for Mobile Internet Device (MID) ........12 2.1 Starting Data Collection.........................................................................12 2.1.1 Output...................................................................................12 2.2 Duration Considerations ........................................................................12 2.2.1 Pause ....................................................................................12 2.2.2 Start Delay.............................................................................13 2.2.3 Zero Duration and Multiple Runs................................................13 2.3 Data Collection Considerations ...............................................................13 2.3.1 Starting Applications with the Sampling Collector .........................13 2.3.2 Calculating Sample After Value..................................................14 2.3.3 Event Count and Re-run Based on Count.....................................14 2.3.4 The Event Count File Format .....................................................14 2.3.5 Fixed Counter Support .............................................................15 2.4 Usage Examples...................................................................................15 3 Viewing Collected Data ....................................................................................17 3.1 Using vtl to View Sampling Data .............................................................17 3.2 Using vtlec to View Sampling Data ..........................................................17 2 Document Number: 318121-002US Sampling Collector Command-line Options Disclaimer and Legal Information INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL® PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. UNLESS OTHERWISE AGREED IN WRITING BY INTEL, THE INTEL PRODUCTS ARE NOT DESIGNED NOR INTENDED FOR ANY APPLICATION IN WHICH THE FAILURE OF THE INTEL PRODUCT COULD CREATE A SITUATION WHERE PERSONAL INJURY OR DEATH MAY OCCUR. Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined." Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with this information. The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request. Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order. Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-548-4725, or by visiting Intel's Web Site. Intel processor numbers are not a measure of performance. Processor numbers differentiate features within each processor family, not across different processor families. See http://www.intel.com/products/processor_number for details. BunnyPeople, Celeron, Celeron Inside, Centrino, Centrino logo, Core Inside, FlashFile, i960, InstantIP, Intel, Intel logo, Intel386, Intel486, Intel740, IntelDX2, IntelDX4, IntelSX2, Intel Core, Intel Inside, Intel Inside logo, Intel. Leap ahead., Intel. Leap ahead. logo, Intel NetBurst, Intel NetMerge, Intel NetStructure, Intel SingleDriver, Intel SpeedStep, Intel StrataFlash, Intel Viiv, Intel vPro, Intel XScale, IPLink, Itanium, Itanium Inside, MCS, MMX, Oplus, OverDrive, PDCharm, Pentium, Pentium Inside, skoool, Sound Mark, The Journey Inside, VTune, Xeon, and Xeon Inside are trademarks of Intel Corporation in the U.S. and other countries. * Other names and brands may be claimed as the property of others. Copyright © 2004–2007, Intel Corporation. This product includes software developed by the Apache Software Foundation (http://www.apache.org). The following software license applies to the software developed by the Apache Software Foundation. Copyright (c) 2000-2004, The Apache Software Foundation. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistribution of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributing in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. The end-user documentation included with the redistribution, if any, must include the following acknowledgment: "This product includes software developed by the Apache Software Foundation (http://www.apache.org/)." Alternately, this acknowledgment may appear in the software itself, if and wherever such third-party acknowledgments normally appear. The names "Apache" and "Apache Software Foundation" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact [email protected]. Products derived from this software may not be called "Apache", nor may "Apache" appear in their name, without prior written permission of the Apache Software Foundation. THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR