Merge pull request #229 from adanalis/master

Version updates

RELEASENOTES.txt

@@ -4,6 +4,49 @@ order.
 For details on installing PAPI on your machine, consult the INSTALL.txt file
 in this directory.
 
+===============================================================================
+PAPI 7.2.0b1 RELEASE NOTES                                          30 Aug 2024
+===============================================================================
+
+PAPI 7.2.0b1 is now available as a beta release. This release introduces a new
+component, rocp_sdk, which supports AMD GPUs/APUs through the ROCprofiler-SDK
+interface, currently still under development and testing. The release also
+includes general improvements to the PAPI code, enhancing both design and
+functionality, as well as various bug fixes.
+
+Additional Major Changes are:
+* Preliminary support for AMD ROCprofiler-SDK events
+* AMD Zen5 L3 PMU support
+* AMD Zen5 core PMU support
+* Preset support for Zen5
+* Preset support for Ice Lake ICL
+* Basic support for the RISC-V architecture (no events yet)
+* Initial heterogenous CPU support: Alderlake and Raptorlake can now enumerate events for both Power and Efficiency cores on heterogeneous systems
+* Intel AlderLake Gracemont (E-Core) core PMU support
+* Intel AlderLake Goldencove (P-Core) core PMU support
+* Intel Raptorlake PMU support: Enables support for Raptorlake, Raptorlake P, Raptorlake S
+* Intel GraniteRapids core PMU support
+* Intel SapphireRapids uncore PMU support for:
+   +++ Coherence and Home Agent (CHA)
+   +++ Ultra Path Interconnect PMU (UPI)
+   +++ memory controller PMU (IMC)
+* Intel IcelakeX uncore PMU support for:
+   +++ Mesh to IIO PMU (M2PCIE)
+   +++ UBOX PMU (UBOX)
+   +++ Mesh to UPI PMU (M3UPI)
+   +++ Ultra Path Interconnect PMU (UPI)
+   +++ Power Control unit PMU (PCU)
+   +++ Mesh to Memory PMU (M2M)
+   +++ PCIe IIO Ring Port PMU (IRP)
+   +++ PCIe I/O controller PMU (IIO)
+   +++ memory controller PMU (IMC)
+   +++ Coherency and Home Agent (CHA)
+* Sysdetect: support for ARM Neoverse V2
+* SDE: support for ntv_code_to_info functionality
+* Removed the obsolete bundled perfctr and libpfm-3.y code
+
+Acknowledgements:
+This release is the result of efforts from many people. The PAPI team would like to express special Thanks to Vince Weaver, Stephane Eranian (for libpfm4), William Cohen, Steve Kaufmann, Peinan Zhang, Rashawn Knapp and Phil Mucci.
 
 ===============================================================================
 PAPI 7.1.0 RELEASE NOTES                                            18 Dec 2023

doc/Doxyfile-common

@@ -31,7 +31,7 @@ PROJECT_NAME           = PAPI
 # This could be handy for archiving the generated documentation or
 # if some version control system is used.
 
-PROJECT_NUMBER         = 7.1.0.0
+PROJECT_NUMBER         = 7.2.0.0b1
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer

man/man1/PAPI_derived_event_files.1

@@ -1,4 +1,4 @@
-.TH "PAPI_derived_event_files" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPI_derived_event_files" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_avail.1

@@ -1,8 +1,8 @@
-.TH "papi_avail" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_avail" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-papi_avail \- papi_avail utility\&.
+papi_avail \- papi_avail utility\&.   
 .PP
 file papi_avail\&.c 
 .SH "Name"
@@ -33,7 +33,6 @@ papi_avail is a PAPI utility program that reports information about the current
 .PP
 Event filtering options 
 .PD 0
-
 .IP "\(bu" 2
 --br Display branch related PAPI preset events 
 .IP "\(bu" 2

man/man1/papi_clockres.1

@@ -1,4 +1,4 @@
-.TH "papi_clockres" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_clockres" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_command_line.1

@@ -1,4 +1,4 @@
-.TH "papi_command_line" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_command_line" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man1/papi_component_avail.1

@@ -1,10 +1,10 @@
-.TH "papi_component_avail" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_component_avail" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
 papi_component_avail \- papi_component_avail utility\&.
 .PP
-file papi_component_avail\&.c
+file papi_component_avail\&.c   
 .SH "NAME"
 .PP
 papi_component_avail - provides detailed information on the PAPI components available on the system\&.

man/man1/papi_cost.1

@@ -1,8 +1,8 @@
-.TH "papi_cost" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_cost" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-papi_cost \- papi_cost utility\&.
+papi_cost \- papi_cost utility\&.   
 .PP
 file papi_cost\&.c 
 .SH "NAME"

man/man1/papi_decode.1

@@ -1,8 +1,8 @@
-.TH "papi_decode" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_decode" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-papi_decode \- papi_decode utility\&.
+papi_decode \- papi_decode utility\&.   
 .PP
 file papi_decode\&.c 
 .SH "NAME"

man/man1/papi_error_codes.1

@@ -1,8 +1,8 @@
-.TH "papi_error_codes" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_error_codes" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-papi_error_codes \- papi_error_codes utility\&.
+papi_error_codes \- papi_error_codes utility\&.   
 .PP
 file error_codes\&.c 
 .SH "NAME"

man/man1/papi_event_chooser.1

@@ -1,8 +1,8 @@
-.TH "papi_event_chooser" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_event_chooser" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-papi_event_chooser \- papi_event_chooser utility\&.
+papi_event_chooser \- papi_event_chooser utility\&.   
 .PP
 file event_chooser\&.c 
 .SH "NAME"

man/man1/papi_hardware_avail.1

@@ -1,10 +1,10 @@
-.TH "papi_hardware_avail" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_hardware_avail" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
 papi_hardware_avail \- papi_hardware_avail utility\&.
 .PP
-file papi_hardware_avail\&.c
+file papi_hardware_avail\&.c   
 .SH "NAME"
 .PP
 papi_hardware_avail - provides detailed information on the hardware available in the system\&.

man/man1/papi_hybrid_native_avail.1

@@ -1,10 +1,10 @@
-.TH "papi_hybrid_native_avail" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_hybrid_native_avail" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
 papi_hybrid_native_avail \- papi_hybrid_native_avail utility\&.
 .PP
-file hybrid_native_avail\&.c
+file hybrid_native_avail\&.c   
 .SH "NAME"
 .PP
 papi_hybrid_native_avail - provides detailed information for PAPI native events\&.
@@ -34,7 +34,6 @@ papi_hybrid_native_avail is a PAPI utility program that reports information abou
 .PP
 Processor-specific options 
 .PD 0
-
 .IP "\(bu" 2
 --darr display events supporting Data Address Range Restriction 
 .IP "\(bu" 2

man/man1/papi_mem_info.1

@@ -1,8 +1,8 @@
-.TH "papi_mem_info" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_mem_info" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-papi_mem_info \- papi_mem_info utility\&.
+papi_mem_info \- papi_mem_info utility\&.   
 .PP
 file papi_mem_info\&.c 
 .SH "NAME"

man/man1/papi_multiplex_cost.1

@@ -1,8 +1,8 @@
-.TH "papi_multiplex_cost" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_multiplex_cost" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-papi_multiplex_cost \- papi_multiplex_cost utility\&.
+papi_multiplex_cost \- papi_multiplex_cost utility\&.   
 .PP
 file papi_multiplex_cost\&.c 
 .SH "NAME"

man/man1/papi_native_avail.1

@@ -1,10 +1,10 @@
-.TH "papi_native_avail" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_native_avail" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
 papi_native_avail \- papi_native_avail utility\&.
 .PP
-file papi_native_avail\&.c
+file papi_native_avail\&.c   
 .SH "NAME"
 .PP
 papi_native_avail - provides detailed information for PAPI native events\&.
@@ -36,7 +36,6 @@ papi_native_avail is a PAPI utility program that reports information about the n
 .PP
 Processor-specific options 
 .PD 0
-
 .IP "\(bu" 2
 --darr display events supporting Data Address Range Restriction 
 .IP "\(bu" 2

man/man1/papi_version.1

@@ -1,8 +1,8 @@
-.TH "papi_version" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_version" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
-papi_version \- papi_version utility\&.
+papi_version \- papi_version utility\&.   
 .PP
 file papi_version\&.c 
 .SH "Name"

man/man1/papi_xml_event_info.1

@@ -1,10 +1,10 @@
-.TH "papi_xml_event_info" 1 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "papi_xml_event_info" 1 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
 papi_xml_event_info \- papi_xml_event_info utility\&.
 .PP
-file papi_xml_event_info\&.c
+file papi_xml_event_info\&.c   
 .SH "NAME"
 .PP
 papi_xml_event_info - provides detailed information for PAPI events in XML format

man/man3/PAPIF_accum.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_accum" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_accum" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_add_event.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_add_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_add_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_add_events.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_add_events" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_add_events" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_add_named_event.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_add_named_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_add_named_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_assign_eventset_component.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_assign_eventset_component" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_assign_eventset_component" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_cleanup_eventset.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_cleanup_eventset" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_cleanup_eventset" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_create_eventset.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_create_eventset" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_create_eventset" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_destroy_eventset.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_destroy_eventset" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_destroy_eventset" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_enum_dev_type.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_enum_dev_type" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_enum_dev_type" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_enum_event.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_enum_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_enum_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_epc.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_epc" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_epc" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
@@ -15,7 +15,7 @@ PAPIF_epc \- Get named events per cycle, real and processor time, reference and
 .RS 4
 #include 'fpapi\&.h' 
 .br
- \fBPAPIF_epc( C_STRING EventName, C_FLOAT real_time, C_FLOAT proc_time, C_LONG_LONG ref, C_LONG_LONG core, C_LONG_LONG evt, C_FLOAT epc, C_INT check )\fP
+ \fBPAPIF_epc( C_INT EventCode, C_FLOAT real_time, C_FLOAT proc_time, C_LONG_LONG ref, C_LONG_LONG core, C_LONG_LONG evt, C_FLOAT epc, C_INT check )\fP
 .RE
 .PP
 \fBSee also\fP

man/man3/PAPIF_event_code_to_name.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_event_code_to_name" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_event_code_to_name" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_event_name_to_code.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_event_name_to_code" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_event_name_to_code" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_flips_rate.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_flips_rate" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_flips_rate" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
@@ -15,7 +15,7 @@ PAPIF_flips_rate \- Simplified call to get Mflips/s (floating point instruction
 .RS 4
 #include 'fpapi\&.h' 
 .br
- \fBPAPIF_flips_rate\fP ( C_STRING EventName, C_FLOAT real_time, C_FLOAT proc_time, C_LONG_LONG flpins, C_FLOAT mflips, C_INT check )
+ \fBPAPIF_flips_rate\fP ( C_INT EventCode, C_FLOAT real_time, C_FLOAT proc_time, C_LONG_LONG flpins, C_FLOAT mflips, C_INT check )
 .RE
 .PP
 \fBSee also\fP

man/man3/PAPIF_flops_rate.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_flops_rate" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_flops_rate" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME
@@ -15,7 +15,7 @@ PAPIF_flops_rate \- Simplified call to get Mflops/s (floating point instruction
 .RS 4
 #include 'fpapi\&.h' 
 .br
- \fBPAPIF_flops_rate( C_STRING EventName, C_FLOAT real_time, C_FLOAT proc_time, C_LONG_LONG flpops, C_FLOAT mflops, C_INT check )\fP
+ \fBPAPIF_flops_rate( C_INT EventCode, C_FLOAT real_time, C_FLOAT proc_time, C_LONG_LONG flpops, C_FLOAT mflops, C_INT check )\fP
 .RE
 .PP
 \fBSee also\fP

man/man3/PAPIF_get_clockrate.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_get_clockrate" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_get_clockrate" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_get_dev_attr.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_get_dev_attr" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_get_dev_attr" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_get_dev_type_attr.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_get_dev_type_attr" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_get_dev_type_attr" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME

man/man3/PAPIF_get_dmem_info.3

@@ -1,4 +1,4 @@
-.TH "PAPIF_get_dmem_info" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*-
+.TH "PAPIF_get_dmem_info" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*-
 .ad l
 .nh
 .SH NAME