Downloading and Installing PAPI
Clone the PAPI repository the first time with the following command:
> git clone https://bitbucket.org/icl/papi.git
This creates a complete copy of the papi git repository on your computer in a folder called 'papi'.
To make sure your copy is up to date with the repository:
> cd papi
> git pull https://bitbucket.org/icl/papi.git
To install PAPI on your system:
- Find the section in INSTALL.txt that pertains to your hardware and operating system.
- Follow the directions to install required components and build the PAPI libraries.
- Run the test suite when you are finished to verify that everything went ok. NOTE: Although we make every attempt to get all tests to PASS or SKIP on all platforms, there are occasional instances of FAILures due to excessively tight compliance thresholds or platform idiosyncrasies. Don't panic if one or two tests FAIL. Contact us with complete output and we'll see what we can do.
PAPI 5.6.0 Release
PAPI 5.6.0 contains a major cleanup of the source code and the build system to have consistent code structure, eliminate errors, and reduce redundancies. A number of validation tests have been added to PAPI to verify the PAPI preset events. Improvements and changes to multiple PAPI components have been made, varying from supporting new events to fixes in the component testing.
For specific and detailed information on changes made in this release, see ChangeLogP560.txt for keywords of interest or go directly to the PAPI git repository.
- Validation tests: A substantial effort to add validation tests to PAPI to check and detect problems in the definition of PAPI preset events.
- Event testing: Thorough cleanup of code in the C and Fortran testing to add processor support, cleanup output and make the testing behavior consistent.
- CUDA component: Updated and rewritten to support CUPTI Metric API (combinations of basic events). This component now supports NVLink information through the Metric API. Updated testing for the component.
- NVML component: Updated to support power management limits and improved event names. Minor other bug fixes.
- RAPL component: Added support for: Intel Atom models Goldmont / Gemini_Lake / Denverton, Skylake-X / Kabylake
- PAPI preset events: Many updates to the PAPI preset event mappings; Skylake X support, initial AMD fam17h, fix AMD fam16h, added more Power8 events, initial Power9 events.
- Updating man and help pages for papi_avail and papi_native_avail.
- Powercap component: Added test for setting power caps via PAPI powercap component.
- Infiniband component: Bugfix for infiniband_umad component.
- Uncore component: Updated to support recent processors.
- Lmsensors component updated to support correct runtime linking, better events name, and a number of bug fixes.
- Updated and fixed timer support for multiple architectures.
- All components: Cleanup and standardize testing behavior in the components.
- Build system: Much needed cleanup of configure and make scripts.
- Support for C++ was enhanced.
- Enabling optional support for reading events using perfevent-rdpmc on recent Linux kernels can speed up PAPI_read() by a factor of 5.
- Pthread testing limited to avoid excessive CPU consumption on highly parallel machines.
Acknowledgements: This release is the result of efforts from many people, with special Thanks to Vince Weaver, Phil Mucci, Steve Kauffman, William Cohen, Will Schmidt, and Stephane Eranian (for libpfm4) from the internal PAPI team.
To verify the integrity of the download, the MD5 sum of
papi-5.6.0.tar.gz = fdd075860b2bc4b8de8b8b5c3abf594a
PAPI 5.5.1 Release
PAPI 5.5.1 is now available. This is a point release intended primarily to add support for uncore performance monitoring events on Intel Xeon Phi Knights Landing (KNL). Other minor bugfixes have also been made.
For specific and detailed information on changes made in this release, see ChangeLogP551.txt for keywords of interest or go directly to the PAPI git repository.
- Added Knights Landing (KNL) uncore event support via libpfm4.
- Fix some possible string termination problems.
- Cleanup lustre and mx components.
- Enable RAPL for Broadwell-EP.
PAPI 5.5.0 release
PAPI 5.5 is now available. This release includes a new component that provides read and write access to the information and controls exposed via the Linux powercap interface.The PAPI powercap component supports measuring and capping power usage on recent Intel architectures.
We have added core support for Knights Landing (uncore support will be released later) as well as power monitoring via the RAPL and powercap components.
- Added Knights Landing (KNL) core events and preset events.
- Added Intel Broadwell/Skylake/Knights Landing RAPL support
- Updated PAPI preset event support for Intel Broadwell/Skylake
- Powercap component: PAPI now supports the Linux Power Capping Framework which exposes power capping devices and power measurement to user space via a sysfs virtual file system interface.
- Add support for multiple flavors of POWER8 processors.
- Force all processors to check event schedulability by checking that PAPI can successfully read the counters.
- Support for Intel Broadwell-EP, Skylake, Goldmont, Haswell-EP inherited from libpfm4.
- Shared memory object (.so) naming is made more limited so that minor updates do not break ABI compatibility.
- Improve testlib error messages if a component fails to initialize.
- Fix _papi_hwi_postfix_calc parsing and robustness.
- Clean build rules for CUDA sampling subcomponent.
- Correct IBM Power7 and Power8 computation of PAPI_L1_DCA.
- Eliminate the sole use of ftests_skip subroutine.
- Correct the event string names for tenth.c.
- Have Fortran test support code report errors more clearly.
- Cleanup output from libmsr component.
- PAPI internal functions were marked as static to avoid exposing them externally.
- Multiple component were fixed to make internal functions static where possible, to avoid exposing the functions as externally accessible entry points.
- CUDA component configuration bug fixed.
PAPI 5.4.3 release
PAPI 5.4.3 is now available.
This release includes some new implementations of components and tools, some general enhancements, and a number of bug fixes.
- libmsr component: Using LLNL's libmsr library to access Intel RAPL (Running Average Power Limit) library adds power capping abilities to PAPI.
- CUDA PC sampling: A new standalone CUDA sampling tool (papi_cuda_sampling) has been added to the CUDA component (components/cuda/sampling/) and can be used as a preloader to perform PC sampling on Nvidia GPUs which support the CUPTI sampling interface (e.g. Maxwell).
- ARM Cortex A53 support: Event definitions added.
- Added Haswell-EP uncore support
- Initial Broadwell, Skylake support
- Added a general CUDA example (components/cuda/test) that uses LD_PRELOAD to attach to a running CUcontext.
- Added "-check" flag to papi_avail and papi_native_avail to test counter availability/validity, unifying previous flags.
Information about the bug fixes can be found in the release notes and the ChangeLogP543.txt documents.
Last but not least, a special Thank You goes out to all our collaborators and contributors! This project would not be successful without your help!
Announcing PAPI 5.4.1
PAPI 5.4.1 is now available. This is a minor release with a major rewrite of the CUDA component as well as several other enhancements and bug fixes.
This release provides CUDA 6.5 support for multiple GPU devices and multiple CUDA contexts.
There have been several other bug fixes and enhancements:
- Updated support for Intel Haswell and Haswell-EP
- Added ARM Cortex A7
- Added ARM 1176 CPU (original Raspberry Pi)
- Enhance PAPI preset events to allow user defined events.
User defined events are set up via a user event definition file.
- New test demonstrating attaching an eventset to a single CPU rather than a thread.
- Use the term "event qualifiers" instead of "event masks" to clarify understanding.
- Added pkg-config support to PAPI.
- Fixed lustre segfault bug in lustre component.
- Fixed compilation in the absence of a Fortran compiler.
- Fixed bug in krental_pthreads ctest to join threads properly on exit.
- Fixed bug in perf_events where event masks were not getting cleared properly.
- Fixed memory leak bug in perf_events.
More details on these changes can be found in the file ChangeLogP541.txt inside the PAPI tarball.
Last but not least, a special Thank You goes out to all our collaborators and contributors!
Copyright © 2019 The University of Tennessee. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
· Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
· Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer listed in this license in the documentation and/or other materials provided with the distribution.
· Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
This software is provided by the copyright holders and contributors "as is" and any express 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 copyright owner or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.