From 1ee78ddef3e28fdc58b3c96c16b3931d90a5565a Mon Sep 17 00:00:00 2001 From: Daniel Barry Date: Fri, 21 Jun 2024 11:53:55 -0400 Subject: [PATCH] FAQ: update outdated links Replace outdated links with newer equivalents. --- PAPI_FAQ.html | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/PAPI_FAQ.html b/PAPI_FAQ.html index ec6e0a8be..156466a59 100644 --- a/PAPI_FAQ.html +++ b/PAPI_FAQ.html @@ -16,12 +16,19 @@

PAPI FAQ

General Questions (FAQ)

ptools-perfapi@icl.utk.edu

Please note, this is a moderated group and if you are not subscribed to it, there may be a delay till the moderators get to your message and approve it.

How do I install the PAPI library?

Please see INSTALL.txt in the papi root directory.

Where do I go for help? -

First, read this document thoroughly. Then consult the PAPI Home Page at http://icl.utk.edu/papi. If that doesn't help, then search the archives as mentioned below. If that fails, then send mail to one of the two mailing lists, the users group at ptools-perfapi@icl.utk.edu or the PAPI-developers group perfapi-devel@icl.utk.edu. The former is a group for general announcements, questions and miscellaneous topics. The latter is is a discussion group for the developers of PAPI and it receives all CVS update messages. (which can be a significant amount of mail!)

What are the mailing lists and how do I subscribe? +

First, read this document thoroughly. Then consult the PAPI Home Page at http://icl.utk.edu/papi. If that doesn't help, then search the archives as mentioned below. If that fails, then send mail to one of the two mailing lists, the users group at ptools-perfapi@icl.utk.edu or the PAPI-developers group perfapi-devel@icl.utk.edu. The former is a group for general announcements, questions and miscellaneous topics. The latter is is a discussion group for the developers of PAPI and it receives all CVS update messages. (which can be a significant amount of mail!)

What are the mailing lists and how do I subscribe?

There are currently two mailing lists, ptools-perfapi, which is a group for general announcements, questions and miscellaneous topics and perfapi-devel, which is a discussion group for the developers of PAPI and it receives all CVS update messages (which can be a significant amount of mail!)

To subscribe to or maintain your subscription to either of the above groups, go to:
https://groups.google.com/a/icl.utk.edu/forum/#!forum/ptools-perfapi  or https://groups.google.com/a/icl.utk.edu/forum/#!forum/perfapi-devel

Where are the archives for the mailing lists?

The archives for the general PAPI mailing list are located at https://groups.google.com/a/icl.utk.edu/forum/#!forum/ptools-perfapi. The archives for the developers list are located at https://groups.google.com/a/icl.utk.edu/forum/#!forum/perfapi-devel.

What is needed to use PAPI? -

See the Platform section at http://icl.utk.edu/papi/custom/index.html?lid=62&slid=96..

What tools are available for PAPI? -

Some of the more popular tools using PAPI can be found under the Tools link on the PAPI web page at http://icl.utk.edu/papi/. You can also see the latest list of third party tools and related software at http://icl.utk.edu/papi/links/index.html. If you have a tool to be posted, send it to the mailing list.

Is PAPI compatible with MacOS? +

See the Platform section at https://github.com/icl-utk-edu/papi/wiki/Supported-Architectures.

What tools are available for PAPI? +

Some of the more popular tools using PAPI are PaRSEC, + Caliper, + Kokkos, + TAU, + HPCToolkit , + Score-P, + Vampir, and + Scalasca. If you have a tool to be posted, send it to the mailing list.

Is PAPI compatible with MacOS?

No. There is no PAPI version with MacOS support for CPU hardware counter monitoring. In addition to not supporting timer_create() and other POSIX realtime timers, MacOS does not export hardware counters that PAPI can read.


The PAPI Library

 @@ -30,7 +37,7 @@

The PAPI Library

The warning message here is benign, but since it occurs on the last file to be compiled, it often looks like the build has been aborted. The reason the message occurs is that the compiler thinks it is trying to stuff too many bits into an integer value. You can fix it by rearranging the code a little bit. Or just download the latest copy of fmultiplex2.F from the cvs tree.

How do I convert my code from PAPI 2 to PAPI 3?

PAPI 3 represents a major upgrade to the PAPI library. -Because of this, there have been a number of interface changes. The process to upgrade from PAPI 2 to PAPI 3 is straightforward, and documented in the PAPI Conversion Cookbook. You can read it online, or download it in a number of different formats.

How do I compile PAPI with debugging support? +Because of this, there have been a number of interface changes. The process to upgrade from PAPI 2 to PAPI 3 is straightforward, and documented in the PAPI Conversion Cookbook.

How do I compile PAPI with debugging support?

To compile with debugging, define CFLAGS to include -DDEBUG in the corresponding Makefile or Rules. file.

How do I use the debugging features of the PAPI library?

To enable debugging messages at run time, set the PAPI_DEBUG environment variable to one or more of the following with any character as a separator.

SUBSTRATE
API
@@ -69,16 +76,16 @@

The PAPI Library

The PAPI GIT Source Repository

Can I browse the source repository on the web? -

Yes. The latest copy of the PAPI source tree is viewable through a web based source browser accessible from the GitHub repository at:
https://github.com/icl-utk-edu/papi

+

Yes. The latest copy of the PAPI source tree is viewable through a web based source browser accessible from the GitHub repository at:
https://github.com/icl-utk-edu/papi

 

How do I download a copy of the current PAPI source tree? -

Make sure git is installed on your machine. You can download a copy here.

+

Make sure git is installed on your machine. You can download a copy of git here.

Download the PAPI repository the first time with the following command:

> git clone https://github.com/icl-utk-edu/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 

Can I commit changes to the PAPI repository?

You can always commit changes to your local copy of the PAPI respository using the "git commit" command and its variations. You cannot push those changes to the master copy of the repository without obtaining credentials from the PAPI team.

Where can I learn more about GIT? -

The web has a variety of resources targetted at teaching you how to use GIT. A good place to start is the official GIT site.
History and background of GIT can be found on Wikipedia.
This user-friendly introduction might help "git" you started.


+

The web has a variety of resources targetted at teaching you how to use GIT. A good place to start is the official GIT site.
History and background of GIT can be found on Wikipedia.
This user-friendly introduction might help "git" you started.


PAPI on AIX POWER Processors

 @@ -360,4 +367,4 @@

Solaris-Ultra

1) Ultra I/II/III/III+ are currently supported;

2) Some of the cache events have documented bugs, see the Sun UltraSparc hardware reference manual.

3) WARNING FOR PEOPLE USING MULTITHREADED LIBRARIES ON SOLARIS 2.8: There is a bug that prevents setitimer() from being called after the process has called pthread() create at any point in time. Therefore if you suspect your communication library is multithreaded, you had better start the instrumentation before initializing it. See multiplex3_pthreads for details.

My Sun box doesn't have libcpc.h. What should I do? -

You didn't check the PAPI Supported Platform Matrix. The hardware counters on SunOS withUltraSparc are only available on Sun OS 5.8 and above. That's Solaris 2.8 for you SVR4 people.

+

You didn't check the PAPI Supported Platforms. The hardware counters on SunOS withUltraSparc are only available on Sun OS 5.8 and above. That's Solaris 2.8 for you SVR4 people.