arm-hpc/papi


ARM branch of PAPI from utk

License: BSD-3-Clause

Language: C


/* 
* File:    README
* CVS:     $Id$
* Author:  Philip Mucci
*          mucci@cs.utk.edu
* Mods:    <your name here>
*          <your email address>
*/  

This directory contains:

README			This file.
LICENSE.txt		The text of the PAPI license.	
INSTALL.txt		Instructions for installing on all supported platforms.
RELEASENOTES.txt	Information about recent releases.
ChangeLogPxxx.txt	Detailed log of changes committed to the repository.
doc/ 			User documentation and support files.
				See doc/README for details.
man/ 			Stuff related to PAPI man pages. See man/README for details.
src/ 			The PAPI library source files and support files.
				See src/README for more details.


Getting Started
---------------

If this is the first file you've opened in the PAPI tree, we'll try to give you
a few tips on where to go from here.

- Read the license found in LICENSE.txt. It's pretty short, and not very 
  restrictive, but it'll give you an idea of what you can and can't do with the
  PAPI sources.
- Visit the website at: <http://icl.cs.utk.edu/papi>
  There you can find late-breaking news that may be more current than in these
  files. You can also find documentation in a greater variety of formats than
  in the papi/doc/ directory.
- Sign up for the PAPI mailing list(s). Instructions are on our home page.
- Read the RELEASENOTES.txt file to get an idea of what's new in the current release.


Installing PAPI
---------------

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.

Using PAPI
----------

To use PAPI in your own programs:
- Read the PAPI Overview found at:
	http://icl.cs.utk.edu/projects/papi/wiki/Main_Page.
- Try out the utility programs in /utils to see what's in your system.
- Try a test program. Source for a number of tests in both C and FORTRAN is
  available in the src/tests/ and src/ftests/ directories. Find a program
  that's similar to what you want to do. Make sure you can build it and run it.
- Write a test program of your own, exercising the PAPI events and features of
  interest to you.
- Go for broke. Fold PAPI calls into your sources and see what you can learn.


Bugs and Questions
------------------
- Visit our FAQ at: <http://icl.cs.utk.edu/papi/faq/>
  or read a snapshot of the FAQ in papi/PAPI_FAQ.html
- Subscribe to the PAPI mailing list at:
  <http://lists.cs.utk.edu/listinfo/ptools-perfapi>
- Read historical postings to the list.
- Post questions to the list.

Project Statistics

Sourcerank 4
Repository Size 27 MB
Stars 3
Forks 1
Watchers 0
Open issues 0
Dependencies 0
Contributors 12
Tags 152
Created
Last updated
Last pushed

Top Contributors See all

Vince Weaver Brian Sheely Asim YarKhan Heike Jagode Sangamesh Ragate Harald Servat William Cohen Tushar Mohan George V. Neville-Neil Peter Bailey Philipp Thomas Karl Fuerlinger

Recent Tags See all

papi-5-4-1-t March 02, 2015
papi-5-4-0-t November 13, 2014
papi-5-3-2-t July 03, 2014
papi-5-3-0-t November 21, 2013
papi-5-2-0-t August 06, 2013
papi-5-1-1-t May 22, 2013
papi-5-1-0-2-t January 15, 2013
papi-5-1-0-1-t January 15, 2013
papi-5-1-0-t January 11, 2013
papi-5-0-1-t September 20, 2012
papi-5-0-0-t August 23, 2012
papi-4-4-0-t April 17, 2012
papi-4-2-1-t February 14, 2012
libpfm-4_27Jan2012 January 27, 2012
libpfm-4_11Jan2012 January 11, 2012

Something wrong with this page? Make a suggestion

Login to resync this repository