11 February 2011

Introduction

The Intel® VTune™ Amplifier XE 2011 for MeeGo* provides an integrated performance analysis and tuning environment with graphical user interface that helps you analyze code performance on systems with Intel® Atom Processors.

This document provides system requirements, installation instructions, issues and limitations, and legal information.

The Intel® VTune™ Amplifier XE 2011 for MeeGo*has a graphical user interface on Linux and Windows for displaying performance results, a command-line interface (amplxe-cl) for doing Hardware Event-based Sampling Analysis and User-Mode Sampling and Tracing Analysis, and an alternate command line interface for doing Hardware Event-based Sampling Analysis.

Product Contents

Intel® VTune™ Amplifier XE for MeeGo* includes the following components:

What’s New

The Intel® VTune™ Amplifier XE 2011 Update2 for MeeGo*:

• MeeGo* Support

System Requirements

For an explanation of architecture names, see

http://software.intel.com/en-us/articles/intel-architecture-platform-terminology/

Host System Requirements to analyze applications based on MeeGo* targets

• A PC based on an IA-32 or Intel® 64 architecture processor supporting the Intel® Streaming SIMD Extensions 3 (Intel® SSE3) instructions (Intel® Core™2 Duo processor or later, Intel® Atom™ processor, or compatible non-Intel processor)
• 2GB of RAM (2GB recommended)
• 280MB free disk space for all features
• One of the following Linux* distributions (this is the list of distributions tested by Intel, other distributions may or may not work and are not recommended – please refer to Technical Support if you have questions):
  • Fedora* 12, 13
  • Ubuntu* 9.10, 10.04 Windows 7* Professional or Windows XP* SP3
• MeeGo* v1.1 SDK or v1.2 preview SDK

Application coding requirements

Supported programming languages:

• C
• C++

Supported threading methodologies:

• Intel® Threading Building Blocks
• Posix* Threads

Requirements to analyze applications on tablets

• Intel® Atom™ N330 processor or later (Intel® Atom™ N450 processor recommended)
• MeeGo* v1.2 for tablets
• 1GB of RAM (2GB recommended)
• 200KB free disk space for all Command Line Tools
• 280MB free to install GUI components (Default Installation)

Requirements to analyze applications on netbooks

• Intel® Atom™ N270 processor or later (Intel® Atom™ N450 processor recommended)
• MeeGo* v1.1 for netbooks
• 200Mb free disk space for all Command Line Tools
• 280Mb free to install GUI components (Default Installation

Technical Support, Documentation and Samples

For information about how to find Technical Support, product documentation and samples, please visit http://appdeveloper.intel.com/en-us/article/intel-appup-sdk-suite-meego-support-articles.

Installation Notes

For Installation instructions see “Installing and Using VTune Amplifier XE for MeeGo at http://appdeveloper.intel.com/en-us/article/intel-appup-sdk-suite-meego-support-articles.

Removing the Product

2. Linux Host or MeeGo Target

If you want to remove components from an installation, run uninstall.sh script as root user from the product installation folder.

3. Changing, Updating and Removing the Product on the Windows Host

If you want to add or remove components from an installation, open the Control Panel and select the Add or Remove Programs applet, select “Intel® VTune™ Amplifier XE 2011” and click Change. To remove the product, select Remove instead of Change.

When installing an updated version of the product, you do not need to remove the older version. Installation program will remove the old version automatically.

Note: If the SEP driver uninstallation failed during the normal uninstall process, open Command Prompt window and execute the following commands with Administrative privileges to manually remove the SEP driver from the system:

cd %windir%\system32\drivers

dir sep*.sys

net stop sep3_1 # unload SEP3 driver from kernel

del sep3_1.sys # delete SEP3 driver from filesystem

net stop sepdal # unload PAX driver from kernel

del sepdal.sys # delete PAX driver from filesystem

Known Issues and Limitations

• Hotspots, Concurrency and Locks and Waits analysis types may not work on MeeGo 1.2 for Tablets OS images (200205225)

  • The problem with data collection  “Error 0x4000001e (Cannot load raw collector data)” for the listed analysis types was observed on one of MeeGo 1.2 pre-release images and potentially can affect other MeeGo 1.2 builds.

• GUI may not be responsive when filtering results (200052892)
  • When filtering large results, changing the filtering selection can take some time to process. This problem may cause the GUI to appear to hang.

• Running time is attributed with a skid of 1 instruction (200108041)
  • To collect the data about time-consuming running regions of the target, the VTune™ Amplifier XE for MeeGo*interrupts executing target threads and attributes the time to the context IP address.
  • Due to the collection mechanism, the captured IP address points to the instruction occurred AFTER the one that is actually consuming most of the time. This leads to the skid of one instruction for running time distribution in the Assembly view. In rare cases, this can also lead to wrong attribution of running time in the source - the time may be erroneously attributed to the source line AFTER the actual hot line.

• Re-finalized Hotspots analysis result may contain <unknown> items (200109010)
  • Re-finalized results for the C++ projects with the active build or target configurations different from those used during collection may contain incorrect function/source files names. To resolve this problem, re-finalize results using the same active build and target configurations as for the collection.

• Link to instruction guide: instruction set reference document is not positioned on description of proper instruction. (200091200)
  • The reference information for assembly instructions can be opened in any PDF viewer, but only Adobe Acrobat Reader* supports positioning the instruction reference document on the required page. To ensure correct functionality of this feature, you are recommended to install the latest available version of Adobe Acrobat Reader.

• Specifying too low "Sampling After Value" for some events may cause system hang due to frequent events triggering during the collection (200093394)
  • Use reasonable "Sampling After Value" that result in about 1000 events triggering per second. This is statistically sufficient for the data analysis. For more fine grained analysis of sampling results, decrease the "Sampling After Value" gradually observing the system responsiveness slowdown due to frequent interruptions.

• The tool may not be able to parse correctly certain characters in an application’s command arguments passed though a shell script (200155871)
  • Using quotes and double quotes in the application’s command arguments may not be parsed correctly. To work around the problem, use double quotes and backslashes to screen double quotes inside.
  • Incorrect: ‘this “style” text’
  • Correct: "this \"style\" text"

• VTune™ Amplifier XE for MeeGo* does not show collected results if installed into the directory with non-English characters (200185779)
  • When you install the product on a system with language localization, make sure the path to the installation directory does not contain non-English characters.

• Event-based sampling collection cannot start if the result directory path contains non-English characters (200185851)
  • When you install the product on a system with language localization, make sure the path to the result directory does not contain non-English characters.

Atributions

Boost Software License - Version 1.0 - August 17th, 2003

Permission is hereby granted, free of charge, to any person or organization

obtaining a copy of the software and accompanying documentation covered by

this license (the "Software") to use, reproduce, display, distribute,

execute, and transmit the Software, and to prepare derivative works of the

Software, and to permit third-parties to whom the Software is furnished to

do so, all subject to the following:

The copyright notices in the Software and this entire statement, including

the above license grant, this restriction and the following disclaimer,

must be included in all copies of the Software, in whole or in part, and

all derivative works of the Software, unless such copies or derivative

works are solely in the form of machine-executable object code generated by

a source language processor.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT

SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE

FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,

ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

DEALINGS IN THE SOFTWARE.

Libxml2

Except where otherwise noted in the source code (e.g. the files hash.c,list.c and the trio files, which are covered by a similar license but with different Copyright notices) all the files are:

Copyright (C) 1998-2003 Daniel Veillard. All Rights Reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE DANIEL VEILLARD BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHERIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name of Daniel Veillard shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization from him.

Libunwind

Copyright (c) 2002 Hewlett-Packard Co.

Permission is hereby granted, free of charge, to any person obtaining

a copy of this software and associated documentation files (the

"Software"), to deal in the Software without restriction, including

without limitation the rights to use, copy, modify, merge, publish,

distribute, sublicense, and/or sell copies of the Software, and to

permit persons to whom the Software is furnished to do so, subject to

the following conditions:

The above copyright notice and this permission notice shall be

included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE

LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION

OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION

WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except where otherwise noted in the source code (e.g. the files hash.c,

list.c and the trio files, which are covered by a similar licence but

with different Copyright notices) all the files are:

Copyright (C) 1998-2003 Daniel Veillard. All Rights Reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the Software is fur-

nished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in

all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FIT-

NESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

DANIEL VEILLARD BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER

IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CON-

NECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name of Daniel Veillard shall not

be used in advertising or otherwise to promote the sale, use or other deal-

ings in this Software without prior written authorization from him.

PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2

1. This LICENSE AGREEMENT is between the Python Software Foundation

("PSF"), and the Individual or Organization ("Licensee") accessing and

otherwise using this software ("Python") in source or binary form and

its associated documentation.

2. Subject to the terms and conditions of this License Agreement, PSF

hereby grants Licensee a nonexclusive, royalty-free, world-wide

license to reproduce, analyze, test, perform and/or display publicly,

prepare derivative works, distribute, and otherwise use Python

alone or in any derivative version, provided, however, that PSF's

License Agreement and PSF's notice of copyright, i.e., "Copyright (c)

2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Python Software Foundation;

All Rights Reserved" are retained in Python alone or in any derivative

version prepared by Licensee.

3. In the event Licensee prepares a derivative work that is based on

or incorporates Python or any part thereof, and wants to make

the derivative work available to others as provided herein, then

Licensee hereby agrees to include in any such work a brief summary of

the changes made to Python.

4. PSF is making Python available to Licensee on an "AS IS"

basis.  PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR

IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND

DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS

FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT

INFRINGE ANY THIRD PARTY RIGHTS.

5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON

FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS

A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON,

OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.

6. This License Agreement will automatically terminate upon a material

breach of its terms and conditions.

7. Nothing in this License Agreement shall be deemed to create any

relationship of agency, partnership, or joint venture between PSF and

Licensee.  This License Agreement does not grant permission to use PSF

trademarks or trade name in a trademark sense to endorse or promote

products or services of Licensee, or any third party.

8. By copying, installing or otherwise using Python, Licensee

agrees to be bound by the terms and conditions of this License

Agreement.

wxWidgets Library

This product includes wxWindows software which can be downloaded from www.wxwidgets.org/downloads.

wxWindows Library License, Version 3.1

======================================

Copyright (C) 1998-2005 Julian Smart, Robert Roebling et al

Everyone is permitted to copy and distribute verbatim copies

of this licence document, but changing it is not allowed.

WXWINDOWS LIBRARY LICENCE

TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

This library is free software; you can redistribute it and/or modify it

under the terms of the GNU Library General Public Licence as published by

the Free Software Foundation; either version 2 of the Licence, or (at

your option) any later version.

This library is distributed in the hope that it will be useful, but

WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library

General Public Licence for more details.

You should have received a copy of the GNU Library General Public Licence

along with this software, usually in a file named COPYING.LIB. If not,

write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,

Boston, MA 02111-1307 USA.

EXCEPTION NOTICE

1. As a special exception, the copyright holders of this library give

permission for additional uses of the text contained in this release of

the library as licenced under the wxWindows Library Licence, applying

either version 3.1 of the Licence, or (at your option) any later version of

the Licence as published by the copyright holders of version

3.1 of the Licence document.

2. The exception is that you may use, copy, link, modify and distribute

under your own terms, binary object code versions of works based

on the Library.

3. If you copy code from files distributed under the terms of the GNU

General Public Licence or the GNU Library General Public Licence into a

copy of this library, as this licence permits, the exception does not

apply to the code that you add in this way. To avoid misleading anyone as

to the status of such modified files, you must delete this exception

notice from such code and/or adjust the licensing conditions notice

accordingly.

4. If you write modifications of your own for this library, it is your

choice whether to permit this exception to apply to your modifications.

If you do not wish that, you must delete the exception notice from such

code and/or adjust the licensing conditions notice accordingly.

/* zlib.h -- interface of the 'zlib' general purpose compression library

version 1.2.3, July 18th, 2005

Copyright (C) 1995-2005 Jean-loup Gailly and Mark Adler

This software is provided 'as-is', without any express or implied

warranty. In no event will the authors be held liable for any damages

arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,

including commercial applications, and to alter it and redistribute it

freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not

claim that you wrote the original software. If you use this software

in a product, an acknowledgment in the product documentation would be

appreciated but is not required.

2. Altered source versions must be plainly marked as such, and must not be

misrepresented as being the original software.

3. This notice may not be removed or altered from any source distribution.

Jean-loup Gailly jloup@gzip.org

Mark Adler madler@alumni.caltech.edu

*/

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 go to: http://www.intel.com/#/en_US_01.

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.

This document contains information on products in the design phase of development.

BunnyPeople, Celeron, Celeron Inside, Centrino, Centrino Inside, Core Inside, i960, Intel, the Intel logo, Intel Atom, Intel Atom Inside, Intel Core, Intel Inside, Intel Inside logo, Intel NetBurst, Intel NetMerge, Intel NetStructure, Intel SingleDriver, Intel SpeedStep, Intel Sponsors of Tomorrow., the Intel Sponsors of Tomorrow. logo, Intel StrataFlash, Intel Viiv, Intel vPro, Intel XScale, InTru, the InTru logo, InTru soundmark, Itanium, Itanium Inside, MCS, MMX, Moblin, Pentium, Pentium Inside, skoool, the skoool logo, Sound Mark, The Journey Inside, vPro 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.

Microsoft, Windows, Visual Studio, Visual C++, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in the United States and/or other countries.

Java and all Java based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.

Copyright (C) 2011, Intel Corporation. All rights reserved.