From 1467d241751ac7202595621b064f178e689413e9 Mon Sep 17 00:00:00 2001 From: Anthony Danalis Date: Fri, 30 Aug 2024 19:06:05 +0000 Subject: [PATCH 1/4] Updated version number. --- doc/Doxyfile-common | 2 +- papi.spec | 2 +- src/configure.in | 2 +- src/papi.h | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/Doxyfile-common b/doc/Doxyfile-common index 4851cd7f2..3ab13a1de 100644 --- a/doc/Doxyfile-common +++ b/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 diff --git a/papi.spec b/papi.spec index 560157437..023de9bfc 100644 --- a/papi.spec +++ b/papi.spec @@ -1,6 +1,6 @@ Summary: Performance Application Programming Interface Name: papi -Version: 7.1.0.0 +Version: 7.2.0.0b1 Release: 1%{?dist} License: BSD Group: Development/System diff --git a/src/configure.in b/src/configure.in index 310b85cad..15ccf824b 100644 --- a/src/configure.in +++ b/src/configure.in @@ -6,7 +6,7 @@ # cross compiling should work differently... AC_PREREQ(2.59) -AC_INIT(PAPI, 7.1.0.0, ptools-perfapi@icl.utk.edu) +AC_INIT(PAPI, 7.2.0.0b1, ptools-perfapi@icl.utk.edu) AC_CONFIG_SRCDIR([papi.c]) AC_CONFIG_HEADER([config.h]) diff --git a/src/papi.h b/src/papi.h index 8daebbf3a..f9b60ad31 100644 --- a/src/papi.h +++ b/src/papi.h @@ -223,7 +223,7 @@ /* This is the official PAPI version */ /* The final digit represents the patch count */ -#define PAPI_VERSION PAPI_VERSION_NUMBER(7,1,0,0) +#define PAPI_VERSION PAPI_VERSION_NUMBER(7,2,0,0) #define PAPI_VER_CURRENT (PAPI_VERSION & 0xffff0000) /* Tests for checking event code type */ From a9ffc8f6d6d91d72120980371a9076425358e4f5 Mon Sep 17 00:00:00 2001 From: Anthony Danalis Date: Fri, 30 Aug 2024 19:11:03 +0000 Subject: [PATCH 2/4] Updated version in man pages. --- man/man1/PAPI_derived_event_files.1 | 2 +- man/man1/papi_avail.1 | 5 +- man/man1/papi_clockres.1 | 2 +- man/man1/papi_command_line.1 | 2 +- man/man1/papi_component_avail.1 | 4 +- man/man1/papi_cost.1 | 4 +- man/man1/papi_decode.1 | 4 +- man/man1/papi_error_codes.1 | 4 +- man/man1/papi_event_chooser.1 | 4 +- man/man1/papi_hardware_avail.1 | 4 +- man/man1/papi_hybrid_native_avail.1 | 5 +- man/man1/papi_mem_info.1 | 4 +- man/man1/papi_multiplex_cost.1 | 4 +- man/man1/papi_native_avail.1 | 5 +- man/man1/papi_version.1 | 4 +- man/man1/papi_xml_event_info.1 | 4 +- man/man3/PAPIF_accum.3 | 2 +- man/man3/PAPIF_add_event.3 | 2 +- man/man3/PAPIF_add_events.3 | 2 +- man/man3/PAPIF_add_named_event.3 | 2 +- man/man3/PAPIF_assign_eventset_component.3 | 2 +- man/man3/PAPIF_cleanup_eventset.3 | 2 +- man/man3/PAPIF_create_eventset.3 | 2 +- man/man3/PAPIF_destroy_eventset.3 | 2 +- man/man3/PAPIF_enum_dev_type.3 | 2 +- man/man3/PAPIF_enum_event.3 | 2 +- man/man3/PAPIF_epc.3 | 4 +- man/man3/PAPIF_event_code_to_name.3 | 2 +- man/man3/PAPIF_event_name_to_code.3 | 2 +- man/man3/PAPIF_flips_rate.3 | 4 +- man/man3/PAPIF_flops_rate.3 | 4 +- man/man3/PAPIF_get_clockrate.3 | 2 +- man/man3/PAPIF_get_dev_attr.3 | 2 +- man/man3/PAPIF_get_dev_type_attr.3 | 2 +- man/man3/PAPIF_get_dmem_info.3 | 2 +- man/man3/PAPIF_get_domain.3 | 2 +- man/man3/PAPIF_get_event_info.3 | 2 +- man/man3/PAPIF_get_exe_info.3 | 2 +- man/man3/PAPIF_get_granularity.3 | 2 +- man/man3/PAPIF_get_hardware_info.3 | 2 +- man/man3/PAPIF_get_multiplex.3 | 2 +- man/man3/PAPIF_get_preload.3 | 2 +- man/man3/PAPIF_get_real_cyc.3 | 2 +- man/man3/PAPIF_get_real_nsec.3 | 2 +- man/man3/PAPIF_get_real_usec.3 | 2 +- man/man3/PAPIF_get_virt_cyc.3 | 2 +- man/man3/PAPIF_get_virt_usec.3 | 2 +- man/man3/PAPIF_ipc.3 | 2 +- man/man3/PAPIF_is_initialized.3 | 2 +- man/man3/PAPIF_library_init.3 | 2 +- man/man3/PAPIF_lock.3 | 2 +- man/man3/PAPIF_multiplex_init.3 | 2 +- man/man3/PAPIF_num_cmp_hwctrs.3 | 2 +- man/man3/PAPIF_num_events.3 | 2 +- man/man3/PAPIF_num_hwctrs.3 | 2 +- man/man3/PAPIF_perror.3 | 2 +- man/man3/PAPIF_query_event.3 | 2 +- man/man3/PAPIF_query_named_event.3 | 2 +- man/man3/PAPIF_rate_stop.3 | 2 +- man/man3/PAPIF_read.3 | 2 +- man/man3/PAPIF_read_ts.3 | 2 +- man/man3/PAPIF_register_thread.3 | 2 +- man/man3/PAPIF_remove_event.3 | 2 +- man/man3/PAPIF_remove_events.3 | 2 +- man/man3/PAPIF_remove_named_event.3 | 2 +- man/man3/PAPIF_reset.3 | 2 +- man/man3/PAPIF_set_cmp_domain.3 | 2 +- man/man3/PAPIF_set_cmp_granularity.3 | 2 +- man/man3/PAPIF_set_debug.3 | 2 +- man/man3/PAPIF_set_domain.3 | 2 +- man/man3/PAPIF_set_event_domain.3 | 2 +- man/man3/PAPIF_set_granularity.3 | 2 +- man/man3/PAPIF_set_inherit.3 | 2 +- man/man3/PAPIF_set_multiplex.3 | 2 +- man/man3/PAPIF_shutdown.3 | 2 +- man/man3/PAPIF_start.3 | 2 +- man/man3/PAPIF_state.3 | 2 +- man/man3/PAPIF_stop.3 | 2 +- man/man3/PAPIF_thread_id.3 | 2 +- man/man3/PAPIF_thread_init.3 | 2 +- man/man3/PAPIF_unlock.3 | 2 +- man/man3/PAPIF_unregister_thread.3 | 2 +- man/man3/PAPIF_write.3 | 2 +- man/man3/PAPI_accum.3 | 6 ++- man/man3/PAPI_add_event.3 | 4 +- man/man3/PAPI_add_events.3 | 4 +- man/man3/PAPI_add_named_event.3 | 4 +- man/man3/PAPI_addr_range_option_t.3 | 4 +- man/man3/PAPI_address_map_t.3 | 4 +- man/man3/PAPI_all_thr_spec_t.3 | 2 +- man/man3/PAPI_assign_eventset_component.3 | 4 +- man/man3/PAPI_attach.3 | 4 +- man/man3/PAPI_attach_option_t.3 | 2 +- man/man3/PAPI_cleanup_eventset.3 | 4 +- man/man3/PAPI_component_info_t.3 | 2 +- man/man3/PAPI_cpu_option_t.3 | 2 +- man/man3/PAPI_create_eventset.3 | 4 +- man/man3/PAPI_debug_option_t.3 | 2 +- man/man3/PAPI_destroy_eventset.3 | 4 +- man/man3/PAPI_detach.3 | 2 +- man/man3/PAPI_disable_component.3 | 6 +-- man/man3/PAPI_disable_component_by_name.3 | 6 +-- man/man3/PAPI_dmem_info_t.3 | 6 +-- man/man3/PAPI_domain_option_t.3 | 2 +- man/man3/PAPI_enum_cmp_event.3 | 9 +--- man/man3/PAPI_enum_dev_type.3 | 4 +- man/man3/PAPI_enum_event.3 | 59 +--------------------- man/man3/PAPI_epc.3 | 20 ++++---- man/man3/PAPI_event_code_to_name.3 | 4 +- man/man3/PAPI_event_info_t.3 | 2 +- man/man3/PAPI_event_name_to_code.3 | 4 +- man/man3/PAPI_exe_info_t.3 | 4 +- man/man3/PAPI_flips_rate.3 | 18 +++---- man/man3/PAPI_flops_rate.3 | 18 +++---- man/man3/PAPI_get_cmp_opt.3 | 6 +-- man/man3/PAPI_get_component_index.3 | 4 +- man/man3/PAPI_get_component_info.3 | 2 +- man/man3/PAPI_get_dev_attr.3 | 4 +- man/man3/PAPI_get_dev_type_attr.3 | 4 +- man/man3/PAPI_get_dmem_info.3 | 4 +- man/man3/PAPI_get_event_component.3 | 4 +- man/man3/PAPI_get_event_info.3 | 2 +- man/man3/PAPI_get_eventset_component.3 | 4 +- man/man3/PAPI_get_executable_info.3 | 2 +- man/man3/PAPI_get_hardware_info.3 | 2 +- man/man3/PAPI_get_multiplex.3 | 4 +- man/man3/PAPI_get_opt.3 | 8 +-- man/man3/PAPI_get_overflow_event_index.3 | 2 +- man/man3/PAPI_get_real_cyc.3 | 2 +- man/man3/PAPI_get_real_nsec.3 | 2 +- man/man3/PAPI_get_real_usec.3 | 2 +- man/man3/PAPI_get_shared_lib_info.3 | 2 +- man/man3/PAPI_get_thr_specific.3 | 4 +- man/man3/PAPI_get_virt_cyc.3 | 2 +- man/man3/PAPI_get_virt_nsec.3 | 2 +- man/man3/PAPI_get_virt_usec.3 | 2 +- man/man3/PAPI_granularity_option_t.3 | 2 +- man/man3/PAPI_hl_read.3 | 4 +- man/man3/PAPI_hl_region_begin.3 | 4 +- man/man3/PAPI_hl_region_end.3 | 6 +-- man/man3/PAPI_hl_stop.3 | 4 +- man/man3/PAPI_hw_info_t.3 | 4 +- man/man3/PAPI_inherit_option_t.3 | 2 +- man/man3/PAPI_ipc.3 | 20 ++++---- man/man3/PAPI_is_initialized.3 | 4 +- man/man3/PAPI_itimer_option_t.3 | 2 +- man/man3/PAPI_library_init.3 | 4 +- man/man3/PAPI_list_events.3 | 5 +- man/man3/PAPI_list_threads.3 | 6 +-- man/man3/PAPI_lock.3 | 6 +-- man/man3/PAPI_mh_cache_info_t.3 | 2 +- man/man3/PAPI_mh_info_t.3 | 4 +- man/man3/PAPI_mh_level_t.3 | 2 +- man/man3/PAPI_mh_tlb_info_t.3 | 2 +- man/man3/PAPI_mpx_info_t.3 | 2 +- man/man3/PAPI_multiplex_init.3 | 4 +- man/man3/PAPI_multiplex_option_t.3 | 2 +- man/man3/PAPI_num_cmp_hwctrs.3 | 8 +-- man/man3/PAPI_num_components.3 | 2 +- man/man3/PAPI_num_events.3 | 6 +-- man/man3/PAPI_num_hwctrs.3 | 2 +- man/man3/PAPI_option_t.3 | 4 +- man/man3/PAPI_overflow.3 | 4 +- man/man3/PAPI_perror.3 | 6 +-- man/man3/PAPI_preload_info_t.3 | 2 +- man/man3/PAPI_profil.3 | 34 ++++++------- man/man3/PAPI_query_event.3 | 6 +-- man/man3/PAPI_query_named_event.3 | 6 +-- man/man3/PAPI_rate_stop.3 | 12 ++--- man/man3/PAPI_read.3 | 10 ++-- man/man3/PAPI_read_ts.3 | 10 ++-- man/man3/PAPI_register_thread.3 | 4 +- man/man3/PAPI_remove_event.3 | 4 +- man/man3/PAPI_remove_events.3 | 4 +- man/man3/PAPI_remove_named_event.3 | 4 +- man/man3/PAPI_reset.3 | 6 +-- man/man3/PAPI_set_cmp_domain.3 | 21 ++++---- man/man3/PAPI_set_cmp_granularity.3 | 19 ++++--- man/man3/PAPI_set_debug.3 | 13 +++-- man/man3/PAPI_set_domain.3 | 19 ++++--- man/man3/PAPI_set_granularity.3 | 19 ++++--- man/man3/PAPI_set_multiplex.3 | 6 +-- man/man3/PAPI_set_opt.3 | 6 +-- man/man3/PAPI_set_thr_specific.3 | 4 +- man/man3/PAPI_shlib_info_t.3 | 2 +- man/man3/PAPI_shutdown.3 | 6 +-- man/man3/PAPI_sprofil.3 | 19 ++++--- man/man3/PAPI_sprofil_t.3 | 2 +- man/man3/PAPI_start.3 | 4 +- man/man3/PAPI_state.3 | 25 +++++---- man/man3/PAPI_stop.3 | 4 +- man/man3/PAPI_strerror.3 | 8 +-- man/man3/PAPI_thread_id.3 | 4 +- man/man3/PAPI_thread_init.3 | 4 +- man/man3/PAPI_unlock.3 | 4 +- man/man3/PAPI_unregister_thread.3 | 2 +- man/man3/PAPI_write.3 | 6 +-- man/man3/PAPIf_hl_read.3 | 2 +- man/man3/PAPIf_hl_region_begin.3 | 2 +- man/man3/PAPIf_hl_region_end.3 | 2 +- man/man3/PAPIf_hl_stop.3 | 2 +- man/man3/RateInfo.3 | 2 +- man/man3/binary_tree_t.3 | 2 +- man/man3/components_t.3 | 2 +- man/man3/local_components_t.3 | 2 +- man/man3/reads_t.3 | 2 +- man/man3/regions_t.3 | 2 +- man/man3/threads_t.3 | 2 +- man/man3/value_t.3 | 2 +- 209 files changed, 433 insertions(+), 504 deletions(-) diff --git a/man/man1/PAPI_derived_event_files.1 b/man/man1/PAPI_derived_event_files.1 index 1d7cd0196..2cfd91d86 100644 --- a/man/man1/PAPI_derived_event_files.1 +++ b/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 diff --git a/man/man1/papi_avail.1 b/man/man1/papi_avail.1 index 04adeb2e0..00d50cdcd 100644 --- a/man/man1/papi_avail.1 +++ b/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 diff --git a/man/man1/papi_clockres.1 b/man/man1/papi_clockres.1 index bb83f879e..6f392ba04 100644 --- a/man/man1/papi_clockres.1 +++ b/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 diff --git a/man/man1/papi_command_line.1 b/man/man1/papi_command_line.1 index 89a6747b5..34d10cd43 100644 --- a/man/man1/papi_command_line.1 +++ b/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 diff --git a/man/man1/papi_component_avail.1 b/man/man1/papi_component_avail.1 index b7f27ccdc..a2cb1e39e 100644 --- a/man/man1/papi_component_avail.1 +++ b/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\&. diff --git a/man/man1/papi_cost.1 b/man/man1/papi_cost.1 index e0c46a40c..fc6eb68e0 100644 --- a/man/man1/papi_cost.1 +++ b/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" diff --git a/man/man1/papi_decode.1 b/man/man1/papi_decode.1 index 0699ef449..fa247f4e2 100644 --- a/man/man1/papi_decode.1 +++ b/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" diff --git a/man/man1/papi_error_codes.1 b/man/man1/papi_error_codes.1 index ecde79486..64173238e 100644 --- a/man/man1/papi_error_codes.1 +++ b/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" diff --git a/man/man1/papi_event_chooser.1 b/man/man1/papi_event_chooser.1 index cc113a110..ed5c493e1 100644 --- a/man/man1/papi_event_chooser.1 +++ b/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" diff --git a/man/man1/papi_hardware_avail.1 b/man/man1/papi_hardware_avail.1 index c1c2dced9..f43e0ae08 100644 --- a/man/man1/papi_hardware_avail.1 +++ b/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\&. diff --git a/man/man1/papi_hybrid_native_avail.1 b/man/man1/papi_hybrid_native_avail.1 index af455055f..ff70d73ed 100644 --- a/man/man1/papi_hybrid_native_avail.1 +++ b/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 diff --git a/man/man1/papi_mem_info.1 b/man/man1/papi_mem_info.1 index 8379f336d..e0c4922e6 100644 --- a/man/man1/papi_mem_info.1 +++ b/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" diff --git a/man/man1/papi_multiplex_cost.1 b/man/man1/papi_multiplex_cost.1 index a4ddde39e..8b434b627 100644 --- a/man/man1/papi_multiplex_cost.1 +++ b/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" diff --git a/man/man1/papi_native_avail.1 b/man/man1/papi_native_avail.1 index b718b8374..efeeb4449 100644 --- a/man/man1/papi_native_avail.1 +++ b/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 diff --git a/man/man1/papi_version.1 b/man/man1/papi_version.1 index ed9a5f2f0..6f50188eb 100644 --- a/man/man1/papi_version.1 +++ b/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" diff --git a/man/man1/papi_xml_event_info.1 b/man/man1/papi_xml_event_info.1 index 4e60f9c64..dd3b499f5 100644 --- a/man/man1/papi_xml_event_info.1 +++ b/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 diff --git a/man/man3/PAPIF_accum.3 b/man/man3/PAPIF_accum.3 index 2b2ace58b..68a283f1b 100644 --- a/man/man3/PAPIF_accum.3 +++ b/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 diff --git a/man/man3/PAPIF_add_event.3 b/man/man3/PAPIF_add_event.3 index f9a23dbea..447fd9908 100644 --- a/man/man3/PAPIF_add_event.3 +++ b/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 diff --git a/man/man3/PAPIF_add_events.3 b/man/man3/PAPIF_add_events.3 index 48a355db3..daa26dcff 100644 --- a/man/man3/PAPIF_add_events.3 +++ b/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 diff --git a/man/man3/PAPIF_add_named_event.3 b/man/man3/PAPIF_add_named_event.3 index 12266e2c7..5311fb89e 100644 --- a/man/man3/PAPIF_add_named_event.3 +++ b/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 diff --git a/man/man3/PAPIF_assign_eventset_component.3 b/man/man3/PAPIF_assign_eventset_component.3 index 636ddfd90..3136ade72 100644 --- a/man/man3/PAPIF_assign_eventset_component.3 +++ b/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 diff --git a/man/man3/PAPIF_cleanup_eventset.3 b/man/man3/PAPIF_cleanup_eventset.3 index 165bd4b48..e1c42bba3 100644 --- a/man/man3/PAPIF_cleanup_eventset.3 +++ b/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 diff --git a/man/man3/PAPIF_create_eventset.3 b/man/man3/PAPIF_create_eventset.3 index 73b84576a..e02b82340 100644 --- a/man/man3/PAPIF_create_eventset.3 +++ b/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 diff --git a/man/man3/PAPIF_destroy_eventset.3 b/man/man3/PAPIF_destroy_eventset.3 index a719e8d90..4b41b1ebc 100644 --- a/man/man3/PAPIF_destroy_eventset.3 +++ b/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 diff --git a/man/man3/PAPIF_enum_dev_type.3 b/man/man3/PAPIF_enum_dev_type.3 index 92493f780..ffe68b69b 100644 --- a/man/man3/PAPIF_enum_dev_type.3 +++ b/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 diff --git a/man/man3/PAPIF_enum_event.3 b/man/man3/PAPIF_enum_event.3 index 4722e4f66..3f63f5796 100644 --- a/man/man3/PAPIF_enum_event.3 +++ b/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 diff --git a/man/man3/PAPIF_epc.3 b/man/man3/PAPIF_epc.3 index b1da75cfc..216b10c92 100644 --- a/man/man3/PAPIF_epc.3 +++ b/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 diff --git a/man/man3/PAPIF_event_code_to_name.3 b/man/man3/PAPIF_event_code_to_name.3 index 771d8ba07..01cfdf10a 100644 --- a/man/man3/PAPIF_event_code_to_name.3 +++ b/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 diff --git a/man/man3/PAPIF_event_name_to_code.3 b/man/man3/PAPIF_event_name_to_code.3 index 3788660fa..378ea61a3 100644 --- a/man/man3/PAPIF_event_name_to_code.3 +++ b/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 diff --git a/man/man3/PAPIF_flips_rate.3 b/man/man3/PAPIF_flips_rate.3 index 7677c3a0c..426ff7563 100644 --- a/man/man3/PAPIF_flips_rate.3 +++ b/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 diff --git a/man/man3/PAPIF_flops_rate.3 b/man/man3/PAPIF_flops_rate.3 index 13a44e94d..82dfff988 100644 --- a/man/man3/PAPIF_flops_rate.3 +++ b/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 diff --git a/man/man3/PAPIF_get_clockrate.3 b/man/man3/PAPIF_get_clockrate.3 index 43c4f491e..7b28f8726 100644 --- a/man/man3/PAPIF_get_clockrate.3 +++ b/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 diff --git a/man/man3/PAPIF_get_dev_attr.3 b/man/man3/PAPIF_get_dev_attr.3 index 8fb5a97f4..aa479ec6a 100644 --- a/man/man3/PAPIF_get_dev_attr.3 +++ b/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 diff --git a/man/man3/PAPIF_get_dev_type_attr.3 b/man/man3/PAPIF_get_dev_type_attr.3 index 13ac10d33..186030eca 100644 --- a/man/man3/PAPIF_get_dev_type_attr.3 +++ b/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 diff --git a/man/man3/PAPIF_get_dmem_info.3 b/man/man3/PAPIF_get_dmem_info.3 index c01d071a7..208b7ea24 100644 --- a/man/man3/PAPIF_get_dmem_info.3 +++ b/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 diff --git a/man/man3/PAPIF_get_domain.3 b/man/man3/PAPIF_get_domain.3 index 7306d6d75..d02d3d147 100644 --- a/man/man3/PAPIF_get_domain.3 +++ b/man/man3/PAPIF_get_domain.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_get_domain" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_get_domain" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_get_event_info.3 b/man/man3/PAPIF_get_event_info.3 index b970ef7a7..be3775c59 100644 --- a/man/man3/PAPIF_get_event_info.3 +++ b/man/man3/PAPIF_get_event_info.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_get_event_info" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_get_event_info" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_get_exe_info.3 b/man/man3/PAPIF_get_exe_info.3 index 06442f8c2..597155309 100644 --- a/man/man3/PAPIF_get_exe_info.3 +++ b/man/man3/PAPIF_get_exe_info.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_get_exe_info" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_get_exe_info" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_get_granularity.3 b/man/man3/PAPIF_get_granularity.3 index 83a192ac0..1a7de1986 100644 --- a/man/man3/PAPIF_get_granularity.3 +++ b/man/man3/PAPIF_get_granularity.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_get_granularity" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_get_granularity" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_get_hardware_info.3 b/man/man3/PAPIF_get_hardware_info.3 index d0806dd22..f59118146 100644 --- a/man/man3/PAPIF_get_hardware_info.3 +++ b/man/man3/PAPIF_get_hardware_info.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_get_hardware_info" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_get_hardware_info" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_get_multiplex.3 b/man/man3/PAPIF_get_multiplex.3 index fa4dc162c..1397828a1 100644 --- a/man/man3/PAPIF_get_multiplex.3 +++ b/man/man3/PAPIF_get_multiplex.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_get_multiplex" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_get_multiplex" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_get_preload.3 b/man/man3/PAPIF_get_preload.3 index 7b278cd8f..a69aaf5fe 100644 --- a/man/man3/PAPIF_get_preload.3 +++ b/man/man3/PAPIF_get_preload.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_get_preload" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_get_preload" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_get_real_cyc.3 b/man/man3/PAPIF_get_real_cyc.3 index fdfb854d9..038e9de88 100644 --- a/man/man3/PAPIF_get_real_cyc.3 +++ b/man/man3/PAPIF_get_real_cyc.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_get_real_cyc" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_get_real_cyc" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_get_real_nsec.3 b/man/man3/PAPIF_get_real_nsec.3 index c4f0c5f15..bdaab3479 100644 --- a/man/man3/PAPIF_get_real_nsec.3 +++ b/man/man3/PAPIF_get_real_nsec.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_get_real_nsec" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_get_real_nsec" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_get_real_usec.3 b/man/man3/PAPIF_get_real_usec.3 index 3c1078e58..647ce34f8 100644 --- a/man/man3/PAPIF_get_real_usec.3 +++ b/man/man3/PAPIF_get_real_usec.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_get_real_usec" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_get_real_usec" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_get_virt_cyc.3 b/man/man3/PAPIF_get_virt_cyc.3 index f5ebfbcfa..bdafe0860 100644 --- a/man/man3/PAPIF_get_virt_cyc.3 +++ b/man/man3/PAPIF_get_virt_cyc.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_get_virt_cyc" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_get_virt_cyc" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_get_virt_usec.3 b/man/man3/PAPIF_get_virt_usec.3 index d86317533..966a19bb0 100644 --- a/man/man3/PAPIF_get_virt_usec.3 +++ b/man/man3/PAPIF_get_virt_usec.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_get_virt_usec" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_get_virt_usec" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_ipc.3 b/man/man3/PAPIF_ipc.3 index c503985bc..f00ddc5da 100644 --- a/man/man3/PAPIF_ipc.3 +++ b/man/man3/PAPIF_ipc.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_ipc" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_ipc" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_is_initialized.3 b/man/man3/PAPIF_is_initialized.3 index 1ef23cb41..916911f16 100644 --- a/man/man3/PAPIF_is_initialized.3 +++ b/man/man3/PAPIF_is_initialized.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_is_initialized" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_is_initialized" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_library_init.3 b/man/man3/PAPIF_library_init.3 index a502a801b..a9cf8f2e3 100644 --- a/man/man3/PAPIF_library_init.3 +++ b/man/man3/PAPIF_library_init.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_library_init" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_library_init" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_lock.3 b/man/man3/PAPIF_lock.3 index 67959758f..1503b6488 100644 --- a/man/man3/PAPIF_lock.3 +++ b/man/man3/PAPIF_lock.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_lock" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_lock" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_multiplex_init.3 b/man/man3/PAPIF_multiplex_init.3 index a8c6e3095..05197c5b0 100644 --- a/man/man3/PAPIF_multiplex_init.3 +++ b/man/man3/PAPIF_multiplex_init.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_multiplex_init" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_multiplex_init" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_num_cmp_hwctrs.3 b/man/man3/PAPIF_num_cmp_hwctrs.3 index 89533bed6..68178eade 100644 --- a/man/man3/PAPIF_num_cmp_hwctrs.3 +++ b/man/man3/PAPIF_num_cmp_hwctrs.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_num_cmp_hwctrs" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_num_cmp_hwctrs" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_num_events.3 b/man/man3/PAPIF_num_events.3 index 58c2c2721..3441b3915 100644 --- a/man/man3/PAPIF_num_events.3 +++ b/man/man3/PAPIF_num_events.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_num_events" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_num_events" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_num_hwctrs.3 b/man/man3/PAPIF_num_hwctrs.3 index 18bfa930d..04332e941 100644 --- a/man/man3/PAPIF_num_hwctrs.3 +++ b/man/man3/PAPIF_num_hwctrs.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_num_hwctrs" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_num_hwctrs" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_perror.3 b/man/man3/PAPIF_perror.3 index f3ca9dc7a..2bfc20f97 100644 --- a/man/man3/PAPIF_perror.3 +++ b/man/man3/PAPIF_perror.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_perror" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_perror" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_query_event.3 b/man/man3/PAPIF_query_event.3 index 66ab3d437..d90d00cc5 100644 --- a/man/man3/PAPIF_query_event.3 +++ b/man/man3/PAPIF_query_event.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_query_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_query_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_query_named_event.3 b/man/man3/PAPIF_query_named_event.3 index ec38a4957..2b7fdf3df 100644 --- a/man/man3/PAPIF_query_named_event.3 +++ b/man/man3/PAPIF_query_named_event.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_query_named_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_query_named_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_rate_stop.3 b/man/man3/PAPIF_rate_stop.3 index 6d6245217..af8923d94 100644 --- a/man/man3/PAPIF_rate_stop.3 +++ b/man/man3/PAPIF_rate_stop.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_rate_stop" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_rate_stop" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_read.3 b/man/man3/PAPIF_read.3 index 7d7ac236f..a7eb32522 100644 --- a/man/man3/PAPIF_read.3 +++ b/man/man3/PAPIF_read.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_read" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_read" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_read_ts.3 b/man/man3/PAPIF_read_ts.3 index 7665b2092..94be23887 100644 --- a/man/man3/PAPIF_read_ts.3 +++ b/man/man3/PAPIF_read_ts.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_read_ts" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_read_ts" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_register_thread.3 b/man/man3/PAPIF_register_thread.3 index 2f9a45ec3..5ce6a59dc 100644 --- a/man/man3/PAPIF_register_thread.3 +++ b/man/man3/PAPIF_register_thread.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_register_thread" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_register_thread" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_remove_event.3 b/man/man3/PAPIF_remove_event.3 index 70b9df04c..3acb9e79f 100644 --- a/man/man3/PAPIF_remove_event.3 +++ b/man/man3/PAPIF_remove_event.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_remove_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_remove_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_remove_events.3 b/man/man3/PAPIF_remove_events.3 index ddfd8816c..b98df098e 100644 --- a/man/man3/PAPIF_remove_events.3 +++ b/man/man3/PAPIF_remove_events.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_remove_events" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_remove_events" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_remove_named_event.3 b/man/man3/PAPIF_remove_named_event.3 index 1104af6e2..38bf1c6a3 100644 --- a/man/man3/PAPIF_remove_named_event.3 +++ b/man/man3/PAPIF_remove_named_event.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_remove_named_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_remove_named_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_reset.3 b/man/man3/PAPIF_reset.3 index 20125178d..8bc3f8744 100644 --- a/man/man3/PAPIF_reset.3 +++ b/man/man3/PAPIF_reset.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_reset" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_reset" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_set_cmp_domain.3 b/man/man3/PAPIF_set_cmp_domain.3 index 7c2595fb8..542cd7fc3 100644 --- a/man/man3/PAPIF_set_cmp_domain.3 +++ b/man/man3/PAPIF_set_cmp_domain.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_set_cmp_domain" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_set_cmp_domain" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_set_cmp_granularity.3 b/man/man3/PAPIF_set_cmp_granularity.3 index 426b1955e..063b7169c 100644 --- a/man/man3/PAPIF_set_cmp_granularity.3 +++ b/man/man3/PAPIF_set_cmp_granularity.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_set_cmp_granularity" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_set_cmp_granularity" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_set_debug.3 b/man/man3/PAPIF_set_debug.3 index 69027d315..e45878d56 100644 --- a/man/man3/PAPIF_set_debug.3 +++ b/man/man3/PAPIF_set_debug.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_set_debug" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_set_debug" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_set_domain.3 b/man/man3/PAPIF_set_domain.3 index 817ba7160..4573b73b9 100644 --- a/man/man3/PAPIF_set_domain.3 +++ b/man/man3/PAPIF_set_domain.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_set_domain" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_set_domain" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_set_event_domain.3 b/man/man3/PAPIF_set_event_domain.3 index 03c790ad8..22faf693b 100644 --- a/man/man3/PAPIF_set_event_domain.3 +++ b/man/man3/PAPIF_set_event_domain.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_set_event_domain" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_set_event_domain" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_set_granularity.3 b/man/man3/PAPIF_set_granularity.3 index 9efde2134..70def5133 100644 --- a/man/man3/PAPIF_set_granularity.3 +++ b/man/man3/PAPIF_set_granularity.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_set_granularity" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_set_granularity" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_set_inherit.3 b/man/man3/PAPIF_set_inherit.3 index 81da31093..64b502c41 100644 --- a/man/man3/PAPIF_set_inherit.3 +++ b/man/man3/PAPIF_set_inherit.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_set_inherit" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_set_inherit" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_set_multiplex.3 b/man/man3/PAPIF_set_multiplex.3 index 99877791b..332746919 100644 --- a/man/man3/PAPIF_set_multiplex.3 +++ b/man/man3/PAPIF_set_multiplex.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_set_multiplex" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_set_multiplex" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_shutdown.3 b/man/man3/PAPIF_shutdown.3 index f0daa1517..1a0b1c19b 100644 --- a/man/man3/PAPIF_shutdown.3 +++ b/man/man3/PAPIF_shutdown.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_shutdown" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_shutdown" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_start.3 b/man/man3/PAPIF_start.3 index 5b52c63f0..9ca005db7 100644 --- a/man/man3/PAPIF_start.3 +++ b/man/man3/PAPIF_start.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_start" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_start" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_state.3 b/man/man3/PAPIF_state.3 index 0ac40d455..2d0390391 100644 --- a/man/man3/PAPIF_state.3 +++ b/man/man3/PAPIF_state.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_state" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_state" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_stop.3 b/man/man3/PAPIF_stop.3 index 729886322..18b4b2b9a 100644 --- a/man/man3/PAPIF_stop.3 +++ b/man/man3/PAPIF_stop.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_stop" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_stop" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_thread_id.3 b/man/man3/PAPIF_thread_id.3 index a96da62a0..fcbfc2c55 100644 --- a/man/man3/PAPIF_thread_id.3 +++ b/man/man3/PAPIF_thread_id.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_thread_id" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_thread_id" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_thread_init.3 b/man/man3/PAPIF_thread_init.3 index 409a6f49c..5e309fd05 100644 --- a/man/man3/PAPIF_thread_init.3 +++ b/man/man3/PAPIF_thread_init.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_thread_init" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_thread_init" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_unlock.3 b/man/man3/PAPIF_unlock.3 index 3a8174bba..b876fb1be 100644 --- a/man/man3/PAPIF_unlock.3 +++ b/man/man3/PAPIF_unlock.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_unlock" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_unlock" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_unregister_thread.3 b/man/man3/PAPIF_unregister_thread.3 index 4cf3ff8c8..74546bf5d 100644 --- a/man/man3/PAPIF_unregister_thread.3 +++ b/man/man3/PAPIF_unregister_thread.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_unregister_thread" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_unregister_thread" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIF_write.3 b/man/man3/PAPIF_write.3 index 4d84b413e..17dac469a 100644 --- a/man/man3/PAPIF_write.3 +++ b/man/man3/PAPIF_write.3 @@ -1,4 +1,4 @@ -.TH "PAPIF_write" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIF_write" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_accum.3 b/man/man3/PAPI_accum.3 index ceff3be06..b2582e648 100644 --- a/man/man3/PAPI_accum.3 +++ b/man/man3/PAPI_accum.3 @@ -1,4 +1,4 @@ -.TH "PAPI_accum" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_accum" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -18,7 +18,9 @@ PAPI_accum \- Accumulate and reset counters in an EventSet\&. int \fBPAPI_accum( int EventSet, long_long * values )\fP; .RE .PP -These calls assume an initialized PAPI library and a properly added event set\&. \fBPAPI_accum\fP adds the counters of the indicated event set into the array values\&. The counters are zeroed and continue counting after the operation\&. Note the differences between \fBPAPI_read\fP and \fBPAPI_accum\fP, specifically that \fBPAPI_accum\fP resets the values array to zero\&. +These calls assume an initialized PAPI library and a properly added event set\&. \fBPAPI_accum\fP adds the counters of the indicated event set into the array values\&. The counters are zeroed and continue counting after the operation\&. Note the differences between PAPI_read() and PAPI_accum()\&. Specifically, PAPI_accum() adds the values of the counters to the values stored in the array (the second parameter in PAPI_accum()) and then resets the counters to zero\&. +.PP +Note: The provided array (second parameter in \fBPAPI_accum\fP) must be initialized for \fBPAPI_accum\fP because its values are read inside the function\&. .PP \fBParameters\fP .RS 4 diff --git a/man/man3/PAPI_add_event.3 b/man/man3/PAPI_add_event.3 index 4bae1f14c..e3dfcaf21 100644 --- a/man/man3/PAPI_add_event.3 +++ b/man/man3/PAPI_add_event.3 @@ -1,4 +1,4 @@ -.TH "PAPI_add_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_add_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_add_event \- add PAPI preset or native hardware event to an event set .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_add_event( int EventSet, int EventCode )\fP; +int PAPI_add_event( int EventSet, int EventCode ); .RE .PP \fBPAPI_add_event\fP adds one event to a PAPI Event Set\&. diff --git a/man/man3/PAPI_add_events.3 b/man/man3/PAPI_add_events.3 index 0b4662ffd..af3ddf2ab 100644 --- a/man/man3/PAPI_add_events.3 +++ b/man/man3/PAPI_add_events.3 @@ -1,4 +1,4 @@ -.TH "PAPI_add_events" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_add_events" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_add_events \- add multiple PAPI presets or native hardware events to an eve .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_add_events( int EventSet, int * EventCodes, int number )\fP; +int PAPI_add_events( int EventSet, int * EventCodes, int number ); .RE .PP \fBPAPI_add_event\fP adds one event to a PAPI Event Set\&. \fBPAPI_add_events\fP does the same, but for an array of events\&. diff --git a/man/man3/PAPI_add_named_event.3 b/man/man3/PAPI_add_named_event.3 index 1071dfd7c..527a7ccb6 100644 --- a/man/man3/PAPI_add_named_event.3 +++ b/man/man3/PAPI_add_named_event.3 @@ -1,4 +1,4 @@ -.TH "PAPI_add_named_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_add_named_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_add_named_event \- add PAPI preset or native hardware event by name to an E .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_add_named_event( int EventSet, const char *EventName )\fP; +int PAPI_add_named_event( int EventSet, const char *EventName ); .RE .PP \fBPAPI_add_named_event\fP adds one event to a PAPI EventSet\&. diff --git a/man/man3/PAPI_addr_range_option_t.3 b/man/man3/PAPI_addr_range_option_t.3 index 49251bd7e..9546fd470 100644 --- a/man/man3/PAPI_addr_range_option_t.3 +++ b/man/man3/PAPI_addr_range_option_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_addr_range_option_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_addr_range_option_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -10,7 +10,7 @@ PAPI_addr_range_option_t \- address range specification for range restricted cou .br .PP .PP -\fC#include \fP +\fR#include \fP .SS "Data Fields" .in +1c diff --git a/man/man3/PAPI_address_map_t.3 b/man/man3/PAPI_address_map_t.3 index 6c040f23f..91f203f93 100644 --- a/man/man3/PAPI_address_map_t.3 +++ b/man/man3/PAPI_address_map_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_address_map_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_address_map_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -8,7 +8,7 @@ PAPI_address_map_t \- get the executable's address space info .br .PP .PP -\fC#include \fP +\fR#include \fP .SS "Data Fields" .in +1c diff --git a/man/man3/PAPI_all_thr_spec_t.3 b/man/man3/PAPI_all_thr_spec_t.3 index 67e6283a7..0fff1a8c1 100644 --- a/man/man3/PAPI_all_thr_spec_t.3 +++ b/man/man3/PAPI_all_thr_spec_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_all_thr_spec_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_all_thr_spec_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_assign_eventset_component.3 b/man/man3/PAPI_assign_eventset_component.3 index e2d289e1c..d4f3d7bd1 100644 --- a/man/man3/PAPI_assign_eventset_component.3 +++ b/man/man3/PAPI_assign_eventset_component.3 @@ -1,4 +1,4 @@ -.TH "PAPI_assign_eventset_component" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_assign_eventset_component" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_assign_eventset_component \- Assign a component index to an existing but em .RS 4 #include <\fBpapi\&.h\fP> .br -\fBPAPI_assign_eventset_component( int EventSet, int cidx )\fP; +PAPI_assign_eventset_component( int EventSet, int cidx ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_attach.3 b/man/man3/PAPI_attach.3 index 48f6f6db0..afc6f500f 100644 --- a/man/man3/PAPI_attach.3 +++ b/man/man3/PAPI_attach.3 @@ -1,4 +1,4 @@ -.TH "PAPI_attach" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_attach" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_attach \- Attach PAPI event set to the specified thread id\&. .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_attach( int EventSet, unsigned long tid )\fP; +int PAPI_attach( int EventSet, unsigned long tid ); .RE .PP \fBPAPI_attach\fP is a wrapper function that calls \fBPAPI_set_opt\fP to allow PAPI to monitor performance counts on a thread other than the one currently executing\&. This is sometimes referred to as third party monitoring\&. \fBPAPI_attach\fP connects the specified EventSet to the specified thread; \fBPAPI_detach\fP breaks that connection and restores the EventSet to the original executing thread\&. diff --git a/man/man3/PAPI_attach_option_t.3 b/man/man3/PAPI_attach_option_t.3 index 381202676..f1372b04d 100644 --- a/man/man3/PAPI_attach_option_t.3 +++ b/man/man3/PAPI_attach_option_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_attach_option_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_attach_option_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_cleanup_eventset.3 b/man/man3/PAPI_cleanup_eventset.3 index 3df4ebc5d..4497dee81 100644 --- a/man/man3/PAPI_cleanup_eventset.3 +++ b/man/man3/PAPI_cleanup_eventset.3 @@ -1,4 +1,4 @@ -.TH "PAPI_cleanup_eventset" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_cleanup_eventset" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_cleanup_eventset \- Empty and destroy an EventSet\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_cleanup_eventset( int EventSet )\fP; + int PAPI_cleanup_eventset( int EventSet ); .RE .PP \fBPAPI_cleanup_eventset\fP removes all events from a PAPI event set and turns off profiling and overflow for all events in the EventSet\&. This can not be called if the EventSet is not stopped\&. diff --git a/man/man3/PAPI_component_info_t.3 b/man/man3/PAPI_component_info_t.3 index 692c6a8e2..74c2189aa 100644 --- a/man/man3/PAPI_component_info_t.3 +++ b/man/man3/PAPI_component_info_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_component_info_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_component_info_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_cpu_option_t.3 b/man/man3/PAPI_cpu_option_t.3 index 9c233611d..5561efa7c 100644 --- a/man/man3/PAPI_cpu_option_t.3 +++ b/man/man3/PAPI_cpu_option_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_cpu_option_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_cpu_option_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_create_eventset.3 b/man/man3/PAPI_create_eventset.3 index 1570e37ab..c398aba29 100644 --- a/man/man3/PAPI_create_eventset.3 +++ b/man/man3/PAPI_create_eventset.3 @@ -1,4 +1,4 @@ -.TH "PAPI_create_eventset" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_create_eventset" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_create_eventset \- Create a new empty PAPI EventSet\&. .RS 4 #include <\fBpapi\&.h\fP> .br -\fBPAPI_create_eventset( int * EventSet )\fP; +PAPI_create_eventset( int * EventSet ); .RE .PP \fBPAPI_create_eventset\fP creates a new EventSet pointed to by EventSet, which must be initialized to PAPI_NULL before calling this routine\&. The user may then add hardware events to the event set by calling \fBPAPI_add_event\fP or similar routines\&. diff --git a/man/man3/PAPI_debug_option_t.3 b/man/man3/PAPI_debug_option_t.3 index 54d4b0b3b..bf19c83bc 100644 --- a/man/man3/PAPI_debug_option_t.3 +++ b/man/man3/PAPI_debug_option_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_debug_option_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_debug_option_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_destroy_eventset.3 b/man/man3/PAPI_destroy_eventset.3 index ed98705c2..64590b422 100644 --- a/man/man3/PAPI_destroy_eventset.3 +++ b/man/man3/PAPI_destroy_eventset.3 @@ -1,4 +1,4 @@ -.TH "PAPI_destroy_eventset" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_destroy_eventset" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_destroy_eventset \- Empty and destroy an EventSet\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_destroy_eventset( int * EventSet )\fP; + int PAPI_destroy_eventset( int * EventSet ); .RE .PP \fBPAPI_destroy_eventset\fP deallocates the memory associated with an empty PAPI EventSet\&. diff --git a/man/man3/PAPI_detach.3 b/man/man3/PAPI_detach.3 index 551fca1d9..beb0abcfd 100644 --- a/man/man3/PAPI_detach.3 +++ b/man/man3/PAPI_detach.3 @@ -1,4 +1,4 @@ -.TH "PAPI_detach" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_detach" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_disable_component.3 b/man/man3/PAPI_disable_component.3 index 90cb1ac7b..70a2f84dd 100644 --- a/man/man3/PAPI_disable_component.3 +++ b/man/man3/PAPI_disable_component.3 @@ -1,4 +1,4 @@ -.TH "PAPI_disable_component" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_disable_component" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -42,10 +42,10 @@ PAPI_library_init(); .fi .PP - \fBPAPI_disable_component()\fP allows the user to disable components before \fBPAPI_library_init()\fP time\&. This is useful if the user knows they do not wish to use events from that component and want to reduce the PAPI library overhead\&. + PAPI_disable_component() allows the user to disable components before PAPI_library_init() time\&. This is useful if the user knows they do not wish to use events from that component and want to reduce the PAPI library overhead\&. .RE .PP -\fBPAPI_disable_component()\fP must be called before \fBPAPI_library_init()\fP\&. +PAPI_disable_component() must be called before PAPI_library_init()\&. .PP \fBSee also\fP .RS 4 diff --git a/man/man3/PAPI_disable_component_by_name.3 b/man/man3/PAPI_disable_component_by_name.3 index 0b55fde51..63f820369 100644 --- a/man/man3/PAPI_disable_component_by_name.3 +++ b/man/man3/PAPI_disable_component_by_name.3 @@ -1,4 +1,4 @@ -.TH "PAPI_disable_component_by_name" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_disable_component_by_name" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -37,10 +37,10 @@ PAPI_library_init(PAPI_VER_CURRENT); .fi .PP - \fBPAPI_disable_component_by_name()\fP allows the user to disable a component before \fBPAPI_library_init()\fP time\&. This is useful if the user knows they do not with to use events from that component and want to reduce the PAPI library overhead\&. + PAPI_disable_component_by_name() allows the user to disable a component before PAPI_library_init() time\&. This is useful if the user knows they do not with to use events from that component and want to reduce the PAPI library overhead\&. .RE .PP -\fBPAPI_disable_component_by_name()\fP must be called before \fBPAPI_library_init()\fP\&. +PAPI_disable_component_by_name() must be called before PAPI_library_init()\&. .PP \fBSee also\fP .RS 4 diff --git a/man/man3/PAPI_dmem_info_t.3 b/man/man3/PAPI_dmem_info_t.3 index 5da741089..03d0bd7ee 100644 --- a/man/man3/PAPI_dmem_info_t.3 +++ b/man/man3/PAPI_dmem_info_t.3 @@ -1,14 +1,14 @@ -.TH "PAPI_dmem_info_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_dmem_info_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME -PAPI_dmem_info_t \- A pointer to the following is passed to \fBPAPI_get_dmem_info()\fP +PAPI_dmem_info_t \- A pointer to the following is passed to PAPI_get_dmem_info() .SH SYNOPSIS .br .PP .PP -\fC#include \fP +\fR#include \fP .SS "Data Fields" .in +1c diff --git a/man/man3/PAPI_domain_option_t.3 b/man/man3/PAPI_domain_option_t.3 index f30ea2a0e..b96a9878c 100644 --- a/man/man3/PAPI_domain_option_t.3 +++ b/man/man3/PAPI_domain_option_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_domain_option_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_domain_option_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_enum_cmp_event.3 b/man/man3/PAPI_enum_cmp_event.3 index ed1dc8670..358c9c148 100644 --- a/man/man3/PAPI_enum_cmp_event.3 +++ b/man/man3/PAPI_enum_cmp_event.3 @@ -1,4 +1,4 @@ -.TH "PAPI_enum_cmp_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_enum_cmp_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_enum_cmp_event \- Enumerate PAPI preset or native events for a given compon .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_enum_cmp_event( int *EventCode, int modifer, int cidx )\fP; +int PAPI_enum_cmp_event( int *EventCode, int modifer, int cidx ); .RE .PP Given an event code, \fBPAPI_enum_event\fP replaces the event code with the next available event\&. @@ -63,7 +63,6 @@ do { .PP The following values are implemented for preset events .PD 0 - .IP "\(bu" 2 PAPI_ENUM_EVENTS -- Enumerate all (default) .IP "\(bu" 2 @@ -76,7 +75,6 @@ PAPI_ENUM_FIRST -- Enumerate first event (preset or native) preset/native chosen .PP The following values are implemented for native events .PD 0 - .IP "\(bu" 2 PAPI_NTV_ENUM_UMASKS -- Given an event, iterate through possible umasks one at a time .IP "\(bu" 2 @@ -88,7 +86,6 @@ PAPI_NTV_ENUM_UMASK_COMBOS -- Given an event, iterate through all possible combi .RS 4 The following values are implemented for preset events .PD 0 - .IP "\(bu" 2 PAPI_PRESET_ENUM_AVAIL -- enumerate only available presets .IP "\(bu" 2 @@ -122,7 +119,6 @@ PAPI_PRESET_ENUM_FP -- Floating Point related preset events .RS 4 The following values are implemented for modifier on Itanium: .PD 0 - .IP "\(bu" 2 PAPI_NTV_ENUM_IARR - Enumerate IAR (instruction address ranging) events .IP "\(bu" 2 @@ -140,7 +136,6 @@ PAPI_NTV_ENUM_DEAR - Enumerate DEAR (data event address register) events .RS 4 The following values are implemented for POWER .PD 0 - .IP "\(bu" 2 PAPI_NTV_ENUM_GROUPS - Enumerate groups to which an event belongs .PP diff --git a/man/man3/PAPI_enum_dev_type.3 b/man/man3/PAPI_enum_dev_type.3 index 868b1be59..d6da1eff0 100644 --- a/man/man3/PAPI_enum_dev_type.3 +++ b/man/man3/PAPI_enum_dev_type.3 @@ -1,4 +1,4 @@ -.TH "PAPI_enum_dev_type" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_enum_dev_type" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -46,7 +46,7 @@ while (PAPI_OK == PAPI_enum_dev_type(enum_modifier, &handle)) { .fi .PP - \fBPAPI_enum_dev_type()\fP allows the user to access all device types in the system\&. It takes an enumerator modifier that allows users to enumerate only devices of a predefined type and it returns an opaque handler that users can pass to other functions in order to query device type attributes\&. + PAPI_enum_dev_type() allows the user to access all device types in the system\&. It takes an enumerator modifier that allows users to enumerate only devices of a predefined type and it returns an opaque handler that users can pass to other functions in order to query device type attributes\&. .RE .PP \fBSee also\fP diff --git a/man/man3/PAPI_enum_event.3 b/man/man3/PAPI_enum_event.3 index 49c9b9183..af36f1f6d 100644 --- a/man/man3/PAPI_enum_event.3 +++ b/man/man3/PAPI_enum_event.3 @@ -1,4 +1,4 @@ -.TH "PAPI_enum_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_enum_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_enum_event \- Enumerate PAPI preset or native events\&. .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_enum_event( int * EventCode, int modifer )\fP; +int PAPI_enum_event( int * EventCode, int modifer ); .RE .PP Given a preset or native event code, \fBPAPI_enum_event\fP replaces the event code with the next available event in either the preset or native table\&. The modifier argument affects which events are returned\&. For all platforms and event types, a value of PAPI_ENUM_ALL (zero) directs the function to return all possible events\&. @@ -59,7 +59,6 @@ do { .PP The following values are implemented for preset events .PD 0 - .IP "\(bu" 2 PAPI_ENUM_EVENTS -- Enumerate all (default) .IP "\(bu" 2 @@ -72,7 +71,6 @@ PAPI_ENUM_FIRST -- Enumerate first event (preset or native) preset/native chosen .PP The following values are implemented for native events .PD 0 - .IP "\(bu" 2 PAPI_NTV_ENUM_UMASKS -- Given an event, iterate through possible umasks one at a time .IP "\(bu" 2 @@ -84,61 +82,8 @@ PAPI_NTV_ENUM_UMASK_COMBOS -- Given an event, iterate through all possible combi .RS 4 The following values are implemented for preset events .PD 0 - .IP "\(bu" 2 PAPI_PRESET_ENUM_AVAIL -- enumerate only available presets -.IP "\(bu" 2 -PAPI_PRESET_ENUM_MSC -- Miscellaneous preset events -.IP "\(bu" 2 -PAPI_PRESET_ENUM_INS -- Instruction related preset events -.IP "\(bu" 2 -PAPI_PRESET_ENUM_IDL -- Stalled or Idle preset events -.IP "\(bu" 2 -PAPI_PRESET_ENUM_BR -- Branch related preset events -.IP "\(bu" 2 -PAPI_PRESET_ENUM_CND -- Conditional preset events -.IP "\(bu" 2 -PAPI_PRESET_ENUM_MEM -- Memory related preset events -.IP "\(bu" 2 -PAPI_PRESET_ENUM_CACH -- Cache related preset events -.IP "\(bu" 2 -PAPI_PRESET_ENUM_L1 -- L1 cache related preset events -.IP "\(bu" 2 -PAPI_PRESET_ENUM_L2 -- L2 cache related preset events -.IP "\(bu" 2 -PAPI_PRESET_ENUM_L3 -- L3 cache related preset events -.IP "\(bu" 2 -PAPI_PRESET_ENUM_TLB -- Translation Lookaside Buffer events -.IP "\(bu" 2 -PAPI_PRESET_ENUM_FP -- Floating Point related preset events -.PP -.RE -.PP -\fBITANIUM Modifiers\fP -.RS 4 -The following values are implemented for modifier on Itanium: -.PD 0 - -.IP "\(bu" 2 -PAPI_NTV_ENUM_IARR - Enumerate IAR (instruction address ranging) events -.IP "\(bu" 2 -PAPI_NTV_ENUM_DARR - Enumerate DAR (data address ranging) events -.IP "\(bu" 2 -PAPI_NTV_ENUM_OPCM - Enumerate OPC (opcode matching) events -.IP "\(bu" 2 -PAPI_NTV_ENUM_IEAR - Enumerate IEAR (instr event address register) events -.IP "\(bu" 2 -PAPI_NTV_ENUM_DEAR - Enumerate DEAR (data event address register) events -.PP -.RE -.PP -\fBPOWER Modifiers\fP -.RS 4 -The following values are implemented for POWER -.PD 0 - -.IP "\(bu" 2 -PAPI_NTV_ENUM_GROUPS - Enumerate groups to which an event belongs .PP .RE .PP diff --git a/man/man3/PAPI_epc.3 b/man/man3/PAPI_epc.3 index c589ac89e..adb3f2e32 100644 --- a/man/man3/PAPI_epc.3 +++ b/man/man3/PAPI_epc.3 @@ -1,4 +1,4 @@ -.TH "PAPI_epc" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_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 @@ PAPI_epc \- Simplified call to get arbitrary events per cycle, real and processo .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_epc( int event, float *rtime, float *ptime, long long *ref, long long *core, long long *evt, float *epc )\fP; +int PAPI_epc( int event, float *rtime, float *ptime, long long *ref, long long *core, long long *evt, float *epc ); .RE .PP \fBParameters\fP @@ -37,28 +37,28 @@ int \fBPAPI_epc( int event, float *rtime, float *ptime, long long *ref, long lon .PP \fBReturn values\fP .RS 4 -\fIPAPI_EINVAL\fP The counters were already started by something other than \fBPAPI_epc()\fP\&. +\fIPAPI_EINVAL\fP The counters were already started by something other than PAPI_epc()\&. .br \fIPAPI_ENOEVNT\fP One of the requested events does not exist\&. .br \fIPAPI_ENOMEM\fP Insufficient memory to complete the operation\&. .RE .PP -The first call to \fBPAPI_epc()\fP will initialize the PAPI interface, set up the counters to monitor the user specified event, PAPI_TOT_CYC, and PAPI_REF_CYC (if it exists) and start the counters\&. +The first call to PAPI_epc() will initialize the PAPI interface, set up the counters to monitor the user specified event, PAPI_TOT_CYC, and PAPI_REF_CYC (if it exists) and start the counters\&. .PP -Subsequent calls will read the counters and return real time, process time, event counts, the core and reference cycle count and EPC rate since the latest call to \fBPAPI_epc()\fP\&. +Subsequent calls will read the counters and return real time, process time, event counts, the core and reference cycle count and EPC rate since the latest call to PAPI_epc()\&. .PP -\fBPAPI_epc()\fP can provide a more detailed look at algorithm efficiency in light of clock variability in modern cpus\&. MFLOPS is no longer an adequate description of peak performance if clock rates can arbitrarily speed up or slow down\&. By allowing a user specified event and reporting reference cycles, core cycles and real time, \fBPAPI_epc\fP provides the information to compute an accurate effective clock rate, and an accurate measure of computational throughput\&. Note that \fBPAPI_epc()\fP is thread-safe and can therefore be called by multiple threads\&. +PAPI_epc() can provide a more detailed look at algorithm efficiency in light of clock variability in modern cpus\&. MFLOPS is no longer an adequate description of peak performance if clock rates can arbitrarily speed up or slow down\&. By allowing a user specified event and reporting reference cycles, core cycles and real time, \fBPAPI_epc\fP provides the information to compute an accurate effective clock rate, and an accurate measure of computational throughput\&. Note that PAPI_epc() is thread-safe and can therefore be called by multiple threads\&. .PP \fBSee also\fP .RS 4 -\fBPAPI_flips_rate()\fP +PAPI_flips_rate() .PP -\fBPAPI_flops_rate()\fP +PAPI_flops_rate() .PP -\fBPAPI_ipc()\fP +PAPI_ipc() .PP -\fBPAPI_rate_stop()\fP +PAPI_rate_stop() .RE .PP diff --git a/man/man3/PAPI_event_code_to_name.3 b/man/man3/PAPI_event_code_to_name.3 index 9ffd8e13c..5c57e8cb1 100644 --- a/man/man3/PAPI_event_code_to_name.3 +++ b/man/man3/PAPI_event_code_to_name.3 @@ -1,4 +1,4 @@ -.TH "PAPI_event_code_to_name" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_event_code_to_name" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_event_code_to_name \- Convert a numeric hardware event code to a name\&. .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_event_code_to_name( int EventCode, char * EventName )\fP; +int PAPI_event_code_to_name( int EventCode, char * EventName ); .RE .PP \fBPAPI_event_code_to_name\fP is used to translate a 32-bit integer PAPI event code into an ASCII PAPI event name\&. Either Preset event codes or Native event codes can be passed to this routine\&. Native event codes and names differ from platform to platform\&. diff --git a/man/man3/PAPI_event_info_t.3 b/man/man3/PAPI_event_info_t.3 index 3e4d93832..58c21f303 100644 --- a/man/man3/PAPI_event_info_t.3 +++ b/man/man3/PAPI_event_info_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_event_info_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_event_info_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_event_name_to_code.3 b/man/man3/PAPI_event_name_to_code.3 index 55d777fb7..346dcefdf 100644 --- a/man/man3/PAPI_event_name_to_code.3 +++ b/man/man3/PAPI_event_name_to_code.3 @@ -1,4 +1,4 @@ -.TH "PAPI_event_name_to_code" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_event_name_to_code" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_event_name_to_code \- Convert a name to a numeric hardware event code\&. .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_event_name_to_code( const char * EventName, int * EventCode )\fP; +int PAPI_event_name_to_code( const char * EventName, int * EventCode ); .RE .PP \fBPAPI_event_name_to_code\fP is used to translate an ASCII PAPI event name into an integer PAPI event code\&. diff --git a/man/man3/PAPI_exe_info_t.3 b/man/man3/PAPI_exe_info_t.3 index 5be853173..340682023 100644 --- a/man/man3/PAPI_exe_info_t.3 +++ b/man/man3/PAPI_exe_info_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_exe_info_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_exe_info_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -8,7 +8,7 @@ PAPI_exe_info_t \- get the executable's info .br .PP .PP -\fC#include \fP +\fR#include \fP .SS "Data Fields" .in +1c diff --git a/man/man3/PAPI_flips_rate.3 b/man/man3/PAPI_flips_rate.3 index 0ca2e1833..a82dddcdb 100644 --- a/man/man3/PAPI_flips_rate.3 +++ b/man/man3/PAPI_flips_rate.3 @@ -1,4 +1,4 @@ -.TH "PAPI_flips_rate" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_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 @@ PAPI_flips_rate \- Simplified call to get Mflips/s (floating point instruction r .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_flips_rate( int event, float *rtime, float *ptime, long long *flpins, float *mflips )\fP; +int PAPI_flips_rate( int event, float *rtime, float *ptime, long long *flpins, float *mflips ); .RE .PP \fBParameters\fP @@ -33,26 +33,26 @@ int \fBPAPI_flips_rate( int event, float *rtime, float *ptime, long long *flpins .PP \fBReturn values\fP .RS 4 -\fIPAPI_EINVAL\fP The counters were already started by something other than \fBPAPI_flips_rate()\fP\&. +\fIPAPI_EINVAL\fP The counters were already started by something other than PAPI_flips_rate()\&. .br \fIPAPI_ENOEVNT\fP The floating point instructions event does not exist\&. .br \fIPAPI_ENOMEM\fP Insufficient memory to complete the operation\&. .RE .PP -The first call to \fBPAPI_flips_rate()\fP will initialize the PAPI interface, set up the counters to monitor the floating point instructions event and start the counters\&. +The first call to PAPI_flips_rate() will initialize the PAPI interface, set up the counters to monitor the floating point instructions event and start the counters\&. .PP -Subsequent calls will read the counters and return real time, process time, floating point instructions and the Mflip/s rate since the latest call to \fBPAPI_flips_rate()\fP\&. +Subsequent calls will read the counters and return real time, process time, floating point instructions and the Mflip/s rate since the latest call to PAPI_flips_rate()\&. .PP -\fBPAPI_flips_rate()\fP returns information related to floating point instructions using the floating point instructions event\&. This is intended to measure instruction rate through the floating point pipe with no massaging\&. Note that \fBPAPI_flips_rate()\fP is thread-safe and can therefore be called by multiple threads\&. +PAPI_flips_rate() returns information related to floating point instructions using the floating point instructions event\&. This is intended to measure instruction rate through the floating point pipe with no massaging\&. Note that PAPI_flips_rate() is thread-safe and can therefore be called by multiple threads\&. .PP \fBSee also\fP .RS 4 -\fBPAPI_flops_rate()\fP +PAPI_flops_rate() .PP -\fBPAPI_ipc()\fP +PAPI_ipc() .PP -\fBPAPI_epc()\fP +PAPI_epc() .RE .PP diff --git a/man/man3/PAPI_flops_rate.3 b/man/man3/PAPI_flops_rate.3 index 719466b02..08af61342 100644 --- a/man/man3/PAPI_flops_rate.3 +++ b/man/man3/PAPI_flops_rate.3 @@ -1,4 +1,4 @@ -.TH "PAPI_flops_rate" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_flops_rate" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -33,28 +33,28 @@ int \fBPAPI_flops_rate\fP ( int event, float *rtime, float *ptime, long long *fl .PP \fBReturn values\fP .RS 4 -\fIPAPI_EINVAL\fP The counters were already started by something other than \fBPAPI_flops_rate()\fP\&. +\fIPAPI_EINVAL\fP The counters were already started by something other than PAPI_flops_rate()\&. .br \fIPAPI_ENOEVNT\fP The floating point operations event does not exist\&. .br \fIPAPI_ENOMEM\fP Insufficient memory to complete the operation\&. .RE .PP -The first call to \fBPAPI_flops_rate()\fP will initialize the PAPI interface, set up the counters to monitor the floating point operations event and start the counters\&. +The first call to PAPI_flops_rate() will initialize the PAPI interface, set up the counters to monitor the floating point operations event and start the counters\&. .PP -Subsequent calls will read the counters and return real time, process time, floating point operations and the Mflop/s rate since the latest call to \fBPAPI_flops_rate()\fP\&. +Subsequent calls will read the counters and return real time, process time, floating point operations and the Mflop/s rate since the latest call to PAPI_flops_rate()\&. .PP -\fBPAPI_flops_rate()\fP returns information related to theoretical floating point operations rather than simple instructions\&. It uses the floating point operations event which attempts to 'correctly' account for, e\&.g\&., FMA undercounts and FP Store overcounts\&. Note that \fBPAPI_flops_rate()\fP is thread-safe and can therefore be called by multiple threads\&. +PAPI_flops_rate() returns information related to theoretical floating point operations rather than simple instructions\&. It uses the floating point operations event which attempts to 'correctly' account for, e\&.g\&., FMA undercounts and FP Store overcounts\&. Note that PAPI_flops_rate() is thread-safe and can therefore be called by multiple threads\&. .PP \fBSee also\fP .RS 4 -\fBPAPI_flips_rate()\fP +PAPI_flips_rate() .PP -\fBPAPI_ipc()\fP +PAPI_ipc() .PP -\fBPAPI_epc()\fP +PAPI_epc() .PP -\fBPAPI_rate_stop()\fP +PAPI_rate_stop() .RE .PP diff --git a/man/man3/PAPI_get_cmp_opt.3 b/man/man3/PAPI_get_cmp_opt.3 index 30d599b86..6c0045f38 100644 --- a/man/man3/PAPI_get_cmp_opt.3 +++ b/man/man3/PAPI_get_cmp_opt.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_cmp_opt" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_cmp_opt" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -25,9 +25,9 @@ PAPI_get_cmp_opt \- Get component specific PAPI options\&. \fIPAPI_EINVAL\fP One or more of the arguments is invalid\&. .RE .PP -\fBPAPI_get_opt()\fP and \fBPAPI_set_opt()\fP query or change the options of the PAPI library or a specific event set created by \fBPAPI_create_eventset\fP \&. Some options may require that the eventset be bound to a component before they can execute successfully\&. This can be done either by adding an event or by explicitly calling \fBPAPI_assign_eventset_component\fP \&. +PAPI_get_opt() and PAPI_set_opt() query or change the options of the PAPI library or a specific event set created by \fBPAPI_create_eventset\fP \&. Some options may require that the eventset be bound to a component before they can execute successfully\&. This can be done either by adding an event or by explicitly calling \fBPAPI_assign_eventset_component\fP \&. .PP -The C interface for these functions passes a pointer to the \fBPAPI_option_t\fP structure\&. Not all options require or return information in this structure, and not all options are implemented for both get and set\&. Some options require a component index to be provided\&. These options are handled explicitly by the \fBPAPI_get_cmp_opt()\fP call for 'get' and implicitly through the option structure for 'set'\&. The Fortran interface is a series of calls implementing various subsets of the C interface\&. Not all options in C are available in Fortran\&. +The C interface for these functions passes a pointer to the \fBPAPI_option_t\fP structure\&. Not all options require or return information in this structure, and not all options are implemented for both get and set\&. Some options require a component index to be provided\&. These options are handled explicitly by the PAPI_get_cmp_opt() call for 'get' and implicitly through the option structure for 'set'\&. The Fortran interface is a series of calls implementing various subsets of the C interface\&. Not all options in C are available in Fortran\&. .PP \fBNote\fP .RS 4 diff --git a/man/man3/PAPI_get_component_index.3 b/man/man3/PAPI_get_component_index.3 index 1aaec7a04..8338b4ccb 100644 --- a/man/man3/PAPI_get_component_index.3 +++ b/man/man3/PAPI_get_component_index.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_component_index" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_component_index" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -34,7 +34,7 @@ if (cidx==PAPI_OK) { .fi .PP - \fBPAPI_get_component_index()\fP returns the component index of the named component\&. This is useful for finding out if a specified component exists\&. + PAPI_get_component_index() returns the component index of the named component\&. This is useful for finding out if a specified component exists\&. .RE .PP \fBSee also\fP diff --git a/man/man3/PAPI_get_component_info.3 b/man/man3/PAPI_get_component_info.3 index e7edbd905..913adb4e5 100644 --- a/man/man3/PAPI_get_component_info.3 +++ b/man/man3/PAPI_get_component_info.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_component_info" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_component_info" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_get_dev_attr.3 b/man/man3/PAPI_get_dev_attr.3 index 3c0bcdd07..929c3af48 100644 --- a/man/man3/PAPI_get_dev_attr.3 +++ b/man/man3/PAPI_get_dev_attr.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_dev_attr" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_dev_attr" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -120,7 +120,7 @@ while (PAPI_OK == PAPI_enum_dev_type(enum_modifier, &handle)) { .fi .PP - \fBPAPI_get_dev_type_attr()\fP allows the user to query all device type attributes\&. It takes a device type handle, returned by \fBPAPI_enum_dev_type\fP, the device sequential id and an attribute to be queried for the device and returns the attribute value\&. + PAPI_get_dev_type_attr() allows the user to query all device type attributes\&. It takes a device type handle, returned by \fBPAPI_enum_dev_type\fP, the device sequential id and an attribute to be queried for the device and returns the attribute value\&. .RE .PP \fBSee also\fP diff --git a/man/man3/PAPI_get_dev_type_attr.3 b/man/man3/PAPI_get_dev_type_attr.3 index 9e3d804de..f07257c42 100644 --- a/man/man3/PAPI_get_dev_type_attr.3 +++ b/man/man3/PAPI_get_dev_type_attr.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_dev_type_attr" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_dev_type_attr" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -65,7 +65,7 @@ while (PAPI_OK == PAPI_enum_dev_type(enum_modifier, &handle)) { .fi .PP - \fBPAPI_get_dev_type_attr()\fP allows the user to query all device type attributes\&. It takes a device type handle, returned by \fBPAPI_enum_dev_type\fP, and an attribute to be queried for the device type and returns the attribute value\&. + PAPI_get_dev_type_attr() allows the user to query all device type attributes\&. It takes a device type handle, returned by \fBPAPI_enum_dev_type\fP, and an attribute to be queried for the device type and returns the attribute value\&. .RE .PP \fBSee also\fP diff --git a/man/man3/PAPI_get_dmem_info.3 b/man/man3/PAPI_get_dmem_info.3 index eff542307..377ea203f 100644 --- a/man/man3/PAPI_get_dmem_info.3 +++ b/man/man3/PAPI_get_dmem_info.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_dmem_info" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_dmem_info" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_get_dmem_info \- Get information about the dynamic memory usage of the curr .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_get_dmem_info( PAPI_dmem_info_t *dest )\fP; + int PAPI_get_dmem_info( PAPI_dmem_info_t *dest ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_get_event_component.3 b/man/man3/PAPI_get_event_component.3 index 71bb737ed..df664f730 100644 --- a/man/man3/PAPI_get_event_component.3 +++ b/man/man3/PAPI_get_event_component.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_event_component" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_event_component" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -31,7 +31,7 @@ cidx = PAPI_get_event_component(eventcode); .fi .PP - \fBPAPI_get_event_component()\fP returns the component an event belongs to\&. + PAPI_get_event_component() returns the component an event belongs to\&. .RE .PP \fBSee also\fP diff --git a/man/man3/PAPI_get_event_info.3 b/man/man3/PAPI_get_event_info.3 index 2f68fac59..8edad1939 100644 --- a/man/man3/PAPI_get_event_info.3 +++ b/man/man3/PAPI_get_event_info.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_event_info" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_event_info" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_get_eventset_component.3 b/man/man3/PAPI_get_eventset_component.3 index b4ab139fa..f59e43eb2 100644 --- a/man/man3/PAPI_get_eventset_component.3 +++ b/man/man3/PAPI_get_eventset_component.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_eventset_component" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_eventset_component" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -35,7 +35,7 @@ cidx = PAPI_get_eventset_component(eventset); .fi .PP - \fBPAPI_get_eventset_component()\fP returns the component an event belongs to\&. + PAPI_get_eventset_component() returns the component an event belongs to\&. .RE .PP \fBSee also\fP diff --git a/man/man3/PAPI_get_executable_info.3 b/man/man3/PAPI_get_executable_info.3 index 44220c907..169ddd64f 100644 --- a/man/man3/PAPI_get_executable_info.3 +++ b/man/man3/PAPI_get_executable_info.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_executable_info" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_executable_info" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_get_hardware_info.3 b/man/man3/PAPI_get_hardware_info.3 index 1089d1daa..02f40ef79 100644 --- a/man/man3/PAPI_get_hardware_info.3 +++ b/man/man3/PAPI_get_hardware_info.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_hardware_info" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_hardware_info" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_get_multiplex.3 b/man/man3/PAPI_get_multiplex.3 index df28a3630..940d0a62e 100644 --- a/man/man3/PAPI_get_multiplex.3 +++ b/man/man3/PAPI_get_multiplex.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_multiplex" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_multiplex" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_get_multiplex \- Get the multiplexing status of specified event set\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_get_multiplex( int EventSet )\fP; + int PAPI_get_multiplex( int EventSet ); .RE .PP \fBFortran Interface:\fP diff --git a/man/man3/PAPI_get_opt.3 b/man/man3/PAPI_get_opt.3 index b41b0754c..ecb6bf68d 100644 --- a/man/man3/PAPI_get_opt.3 +++ b/man/man3/PAPI_get_opt.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_opt" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_opt" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_get_opt \- Get PAPI library or event set options\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_get_opt( int option, PAPI_option_t * ptr )\fP; + int PAPI_get_opt( int option, PAPI_option_t * ptr ); .RE .PP \fBParameters\fP @@ -38,9 +38,9 @@ PAPI_get_opt \- Get PAPI library or event set options\&. \fIPAPI_ENOINIT\fP specified option requires PAPI to be initialized first\&. .RE .PP -\fBPAPI_get_opt()\fP queries the options of the PAPI library or a specific event set created by \fBPAPI_create_eventset\fP\&. Some options may require that the eventset be bound to a component before they can execute successfully\&. This can be done either by adding an event or by explicitly calling \fBPAPI_assign_eventset_component\fP\&. +PAPI_get_opt() queries the options of the PAPI library or a specific event set created by \fBPAPI_create_eventset\fP\&. Some options may require that the eventset be bound to a component before they can execute successfully\&. This can be done either by adding an event or by explicitly calling \fBPAPI_assign_eventset_component\fP\&. .PP -Ptr is a pointer to the \fBPAPI_option_t\fP structure, which is actually a union of different structures for different options\&. Not all options require or return information in these structures\&. Each returns different values in the structure\&. Some options require a component index to be provided\&. These options are handled explicitly by the \fBPAPI_get_cmp_opt()\fP call\&. +Ptr is a pointer to the \fBPAPI_option_t\fP structure, which is actually a union of different structures for different options\&. Not all options require or return information in these structures\&. Each returns different values in the structure\&. Some options require a component index to be provided\&. These options are handled explicitly by the PAPI_get_cmp_opt() call\&. .PP \fBNote\fP .RS 4 diff --git a/man/man3/PAPI_get_overflow_event_index.3 b/man/man3/PAPI_get_overflow_event_index.3 index be8484b71..eea6c009c 100644 --- a/man/man3/PAPI_get_overflow_event_index.3 +++ b/man/man3/PAPI_get_overflow_event_index.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_overflow_event_index" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_overflow_event_index" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_get_real_cyc.3 b/man/man3/PAPI_get_real_cyc.3 index 8dc0132f5..decd39a3c 100644 --- a/man/man3/PAPI_get_real_cyc.3 +++ b/man/man3/PAPI_get_real_cyc.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_real_cyc" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_real_cyc" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_get_real_nsec.3 b/man/man3/PAPI_get_real_nsec.3 index a9a37df0a..e388b7988 100644 --- a/man/man3/PAPI_get_real_nsec.3 +++ b/man/man3/PAPI_get_real_nsec.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_real_nsec" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_real_nsec" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_get_real_usec.3 b/man/man3/PAPI_get_real_usec.3 index be22f9335..fcda30cd1 100644 --- a/man/man3/PAPI_get_real_usec.3 +++ b/man/man3/PAPI_get_real_usec.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_real_usec" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_real_usec" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_get_shared_lib_info.3 b/man/man3/PAPI_get_shared_lib_info.3 index 0ed9c12c2..f521e2683 100644 --- a/man/man3/PAPI_get_shared_lib_info.3 +++ b/man/man3/PAPI_get_shared_lib_info.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_shared_lib_info" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_shared_lib_info" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_get_thr_specific.3 b/man/man3/PAPI_get_thr_specific.3 index 421faf71e..4718c44ea 100644 --- a/man/man3/PAPI_get_thr_specific.3 +++ b/man/man3/PAPI_get_thr_specific.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_thr_specific" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_thr_specific" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_get_thr_specific \- Retrieve a pointer to a thread specific data structure\ .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_get_thr_specific( int tag, void **ptr )\fP; + int PAPI_get_thr_specific( int tag, void **ptr ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_get_virt_cyc.3 b/man/man3/PAPI_get_virt_cyc.3 index 623f98e17..e62132967 100644 --- a/man/man3/PAPI_get_virt_cyc.3 +++ b/man/man3/PAPI_get_virt_cyc.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_virt_cyc" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_virt_cyc" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_get_virt_nsec.3 b/man/man3/PAPI_get_virt_nsec.3 index 0b07a1a28..91d87e0f5 100644 --- a/man/man3/PAPI_get_virt_nsec.3 +++ b/man/man3/PAPI_get_virt_nsec.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_virt_nsec" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_virt_nsec" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_get_virt_usec.3 b/man/man3/PAPI_get_virt_usec.3 index b7201af03..47d01a037 100644 --- a/man/man3/PAPI_get_virt_usec.3 +++ b/man/man3/PAPI_get_virt_usec.3 @@ -1,4 +1,4 @@ -.TH "PAPI_get_virt_usec" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_get_virt_usec" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_granularity_option_t.3 b/man/man3/PAPI_granularity_option_t.3 index 47849ad7f..0a4ade917 100644 --- a/man/man3/PAPI_granularity_option_t.3 +++ b/man/man3/PAPI_granularity_option_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_granularity_option_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_granularity_option_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_hl_read.3 b/man/man3/PAPI_hl_read.3 index 7b99e9717..471c3a73e 100644 --- a/man/man3/PAPI_hl_read.3 +++ b/man/man3/PAPI_hl_read.3 @@ -1,4 +1,4 @@ -.TH "PAPI_hl_read" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_hl_read" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_hl_read \- Read performance events inside of a region and store the differe .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_hl_read( const char* region )\fP; +int PAPI_hl_read( const char* region ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_hl_region_begin.3 b/man/man3/PAPI_hl_region_begin.3 index 789bca37c..1fde4d78b 100644 --- a/man/man3/PAPI_hl_region_begin.3 +++ b/man/man3/PAPI_hl_region_begin.3 @@ -1,4 +1,4 @@ -.TH "PAPI_hl_region_begin" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_hl_region_begin" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_hl_region_begin \- Read performance events at the beginning of a region\&. .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_hl_region_begin( const char* region )\fP; +int PAPI_hl_region_begin( const char* region ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_hl_region_end.3 b/man/man3/PAPI_hl_region_end.3 index 8ad8a1fd4..4bea57ab7 100644 --- a/man/man3/PAPI_hl_region_end.3 +++ b/man/man3/PAPI_hl_region_end.3 @@ -1,4 +1,4 @@ -.TH "PAPI_hl_region_end" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_hl_region_end" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_hl_region_end \- Read performance events at the end of a region and store t .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_hl_region_end( const char* region )\fP; +int PAPI_hl_region_end( const char* region ); .RE .PP \fBParameters\fP @@ -40,7 +40,7 @@ int \fBPAPI_hl_region_end( const char* region )\fP; .PP Assumes that \fBPAPI_hl_region_begin\fP was called before\&. .PP -Note that \fBPAPI_hl_region_end\fP does not stop counting the performance events\&. Counting continues until the application terminates\&. Therefore, the programmer can also create nested regions if required\&. To stop a running high-level event set, the programmer must call \fBPAPI_hl_stop()\fP\&. It should also be noted, that a marked region is thread-local and therefore has to be in the same thread\&. +Note that \fBPAPI_hl_region_end\fP does not stop counting the performance events\&. Counting continues until the application terminates\&. Therefore, the programmer can also create nested regions if required\&. To stop a running high-level event set, the programmer must call PAPI_hl_stop()\&. It should also be noted, that a marked region is thread-local and therefore has to be in the same thread\&. .PP An output of the measured events is created automatically after the application exits\&. In the case of a serial, or a thread-parallel application there is only one output file\&. MPI applications would be saved in multiple files, one per MPI rank\&. The output is generated in the current directory by default\&. However, it is recommended to specify an output directory for larger measurements, especially for MPI applications via the environment variable PAPI_OUTPUT_DIRECTORY\&. In the case where measurements are performed, while there are old measurements in the same directory, PAPI will not overwrite or delete the old measurement directories\&. Instead, timestamps are added to the old directories\&. .PP diff --git a/man/man3/PAPI_hl_stop.3 b/man/man3/PAPI_hl_stop.3 index 8c2a7a676..adabbed92 100644 --- a/man/man3/PAPI_hl_stop.3 +++ b/man/man3/PAPI_hl_stop.3 @@ -1,4 +1,4 @@ -.TH "PAPI_hl_stop" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_hl_stop" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_hl_stop \- Stop a running high-level event set\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_hl_stop()\fP; + int PAPI_hl_stop(); .RE .PP \fBReturn values\fP diff --git a/man/man3/PAPI_hw_info_t.3 b/man/man3/PAPI_hw_info_t.3 index 9e1105b54..7e80925cc 100644 --- a/man/man3/PAPI_hw_info_t.3 +++ b/man/man3/PAPI_hw_info_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_hw_info_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_hw_info_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -8,7 +8,7 @@ PAPI_hw_info_t \- Hardware info structure\&. .br .PP .PP -\fC#include \fP +\fR#include \fP .SS "Data Fields" .in +1c diff --git a/man/man3/PAPI_inherit_option_t.3 b/man/man3/PAPI_inherit_option_t.3 index 541dfd66c..00b2126b1 100644 --- a/man/man3/PAPI_inherit_option_t.3 +++ b/man/man3/PAPI_inherit_option_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_inherit_option_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_inherit_option_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_ipc.3 b/man/man3/PAPI_ipc.3 index bdcbc490a..297f4a200 100644 --- a/man/man3/PAPI_ipc.3 +++ b/man/man3/PAPI_ipc.3 @@ -1,4 +1,4 @@ -.TH "PAPI_ipc" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_ipc" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_ipc \- Simplified call to get instructions per cycle, real and processor ti .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_ipc( float *rtime, float *ptime, long long *ins, float *ipc )\fP; +int PAPI_ipc( float *rtime, float *ptime, long long *ins, float *ipc ); .RE .PP \fBParameters\fP @@ -31,28 +31,28 @@ int \fBPAPI_ipc( float *rtime, float *ptime, long long *ins, float *ipc )\fP; .PP \fBReturn values\fP .RS 4 -\fIPAPI_EINVAL\fP The counters were already started by something other than \fBPAPI_ipc()\fP\&. +\fIPAPI_EINVAL\fP The counters were already started by something other than PAPI_ipc()\&. .br \fIPAPI_ENOEVNT\fP The events PAPI_TOT_INS and PAPI_TOT_CYC are not supported\&. .br \fIPAPI_ENOMEM\fP Insufficient memory to complete the operation\&. .RE .PP -The first call to \fBPAPI_ipc()\fP will initialize the PAPI interface, set up the counters to monitor PAPI_TOT_INS and PAPI_TOT_CYC events and start the counters\&. +The first call to PAPI_ipc() will initialize the PAPI interface, set up the counters to monitor PAPI_TOT_INS and PAPI_TOT_CYC events and start the counters\&. .PP -Subsequent calls will read the counters and return real time, process time, instructions and the IPC rate since the latest call to \fBPAPI_ipc()\fP\&. +Subsequent calls will read the counters and return real time, process time, instructions and the IPC rate since the latest call to PAPI_ipc()\&. .PP -\fBPAPI_ipc()\fP should return a ratio greater than 1\&.0, indicating instruction level parallelism within the chip\&. The larger this ratio the more effeciently the program is running\&. Note that \fBPAPI_ipc()\fP is thread-safe and can therefore be called by multiple threads\&. +PAPI_ipc() should return a ratio greater than 1\&.0, indicating instruction level parallelism within the chip\&. The larger this ratio the more effeciently the program is running\&. Note that PAPI_ipc() is thread-safe and can therefore be called by multiple threads\&. .PP \fBSee also\fP .RS 4 -\fBPAPI_flips_rate()\fP +PAPI_flips_rate() .PP -\fBPAPI_flops_rate()\fP +PAPI_flops_rate() .PP -\fBPAPI_epc()\fP +PAPI_epc() .PP -\fBPAPI_rate_stop()\fP +PAPI_rate_stop() .RE .PP diff --git a/man/man3/PAPI_is_initialized.3 b/man/man3/PAPI_is_initialized.3 index 17fc0c5e0..f34292a69 100644 --- a/man/man3/PAPI_is_initialized.3 +++ b/man/man3/PAPI_is_initialized.3 @@ -1,4 +1,4 @@ -.TH "PAPI_is_initialized" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_is_initialized" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -47,7 +47,7 @@ handle_error(retval); .fi .PP - \fBPAPI_is_initialized()\fP returns the status of the PAPI library\&. The PAPI library can be in one of four states, as described under RETURN VALUES\&. + PAPI_is_initialized() returns the status of the PAPI library\&. The PAPI library can be in one of four states, as described under RETURN VALUES\&. .RE .PP \fBSee also\fP diff --git a/man/man3/PAPI_itimer_option_t.3 b/man/man3/PAPI_itimer_option_t.3 index 217b15b14..d65bd6c25 100644 --- a/man/man3/PAPI_itimer_option_t.3 +++ b/man/man3/PAPI_itimer_option_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_itimer_option_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_itimer_option_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_library_init.3 b/man/man3/PAPI_library_init.3 index 38aa75249..d7bc04ac9 100644 --- a/man/man3/PAPI_library_init.3 +++ b/man/man3/PAPI_library_init.3 @@ -1,4 +1,4 @@ -.TH "PAPI_library_init" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_library_init" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -27,7 +27,7 @@ PAPI_library_init \- initialize the PAPI library\&. \fIPAPI_ESYS\fP A system or C library call failed inside PAPI, see the errno variable\&. .RE .PP -\fBPAPI_library_init()\fP initializes the PAPI library\&. \fBPAPI_is_initialized()\fP check for initialization\&. It must be called before any low level PAPI functions can be used\&. If your application is making use of threads \fBPAPI_thread_init\fP must also be called prior to making any calls to the library other than \fBPAPI_library_init()\fP \&. +PAPI_library_init() initializes the PAPI library\&. PAPI_is_initialized() check for initialization\&. It must be called before any low level PAPI functions can be used\&. If your application is making use of threads \fBPAPI_thread_init\fP must also be called prior to making any calls to the library other than PAPI_library_init() \&. .PP \fBExamples:\fP .RS 4 diff --git a/man/man3/PAPI_list_events.3 b/man/man3/PAPI_list_events.3 index 470f5b93a..e0ed17eb3 100644 --- a/man/man3/PAPI_list_events.3 +++ b/man/man3/PAPI_list_events.3 @@ -1,4 +1,4 @@ -.TH "PAPI_list_events" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_list_events" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -11,7 +11,7 @@ PAPI_list_events \- list the events in an event set .PP List the events in an event set\&. .PP -\fBPAPI_list_events()\fP returns an array of events and a count of the total number of events in an event set\&. This call assumes an initialized PAPI library and a successfully created event set\&. +PAPI_list_events() returns an array of events and a count of the total number of events in an event set\&. This call assumes an initialized PAPI library and a successfully created event set\&. .PP \fBC Interface\fP .RS 4 @@ -74,7 +74,6 @@ exit(1); \fBPAPI_create_eventset\fP .RE .PP -.PP \fBFortran Interface:\fP .RS 4 #include 'fpapi\&.h' diff --git a/man/man3/PAPI_list_threads.3 b/man/man3/PAPI_list_threads.3 index 34934ebb9..1046387a9 100644 --- a/man/man3/PAPI_list_threads.3 +++ b/man/man3/PAPI_list_threads.3 @@ -1,4 +1,4 @@ -.TH "PAPI_list_threads" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_list_threads" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -9,7 +9,7 @@ PAPI_list_threads \- List the registered thread ids\&. .PP .SH "Detailed Description" .PP -\fBPAPI_list_threads()\fP returns to the caller a list of all thread IDs known to PAPI\&. +PAPI_list_threads() returns to the caller a list of all thread IDs known to PAPI\&. .PP This call assumes an initialized PAPI library\&. .PP @@ -17,7 +17,7 @@ This call assumes an initialized PAPI library\&. .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_list_threads(PAPI_thread_id_t *tids, int * number )\fP; +int PAPI_list_threads(PAPI_thread_id_t *tids, int * number ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_lock.3 b/man/man3/PAPI_lock.3 index 44b75ddf7..241439d39 100644 --- a/man/man3/PAPI_lock.3 +++ b/man/man3/PAPI_lock.3 @@ -1,4 +1,4 @@ -.TH "PAPI_lock" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_lock" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -9,13 +9,13 @@ PAPI_lock \- Lock one of two mutex variables defined in \fBpapi\&.h\fP\&. .PP .SH "Detailed Description" .PP -\fBPAPI_lock()\fP grabs access to one of the two PAPI mutex variables\&. This function is provided to the user to have a platform independent call to a (hopefully) efficiently implemented mutex\&. +PAPI_lock() grabs access to one of the two PAPI mutex variables\&. This function is provided to the user to have a platform independent call to a (hopefully) efficiently implemented mutex\&. .PP \fBC Interface:\fP .RS 4 #include <\fBpapi\&.h\fP> .br -void \fBPAPI_lock(int lock)\fP; +void PAPI_lock(int lock); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_mh_cache_info_t.3 b/man/man3/PAPI_mh_cache_info_t.3 index 0b07b18be..ee97b7097 100644 --- a/man/man3/PAPI_mh_cache_info_t.3 +++ b/man/man3/PAPI_mh_cache_info_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_mh_cache_info_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_mh_cache_info_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_mh_info_t.3 b/man/man3/PAPI_mh_info_t.3 index 659669b79..dd7baa94f 100644 --- a/man/man3/PAPI_mh_info_t.3 +++ b/man/man3/PAPI_mh_info_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_mh_info_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_mh_info_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -8,7 +8,7 @@ PAPI_mh_info_t \- mh for mem hierarchy maybe? .br .PP .PP -\fC#include \fP +\fR#include \fP .SS "Data Fields" .in +1c diff --git a/man/man3/PAPI_mh_level_t.3 b/man/man3/PAPI_mh_level_t.3 index 8cc8938ed..b8b94b8b4 100644 --- a/man/man3/PAPI_mh_level_t.3 +++ b/man/man3/PAPI_mh_level_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_mh_level_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_mh_level_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_mh_tlb_info_t.3 b/man/man3/PAPI_mh_tlb_info_t.3 index 3294e3d8f..687c3932d 100644 --- a/man/man3/PAPI_mh_tlb_info_t.3 +++ b/man/man3/PAPI_mh_tlb_info_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_mh_tlb_info_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_mh_tlb_info_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_mpx_info_t.3 b/man/man3/PAPI_mpx_info_t.3 index b58154706..4717d3714 100644 --- a/man/man3/PAPI_mpx_info_t.3 +++ b/man/man3/PAPI_mpx_info_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_mpx_info_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_mpx_info_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_multiplex_init.3 b/man/man3/PAPI_multiplex_init.3 index 77084429d..44a765920 100644 --- a/man/man3/PAPI_multiplex_init.3 +++ b/man/man3/PAPI_multiplex_init.3 @@ -1,4 +1,4 @@ -.TH "PAPI_multiplex_init" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_multiplex_init" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -9,7 +9,7 @@ PAPI_multiplex_init \- Initialize multiplex support in the PAPI library\&. .PP .SH "Detailed Description" .PP -\fBPAPI_multiplex_init()\fP enables and initializes multiplex support in the PAPI library\&. Multiplexing allows a user to count more events than total physical counters by time sharing the existing counters at some loss in precision\&. Applications that make no use of multiplexing do not need to call this routine\&. +PAPI_multiplex_init() enables and initializes multiplex support in the PAPI library\&. Multiplexing allows a user to count more events than total physical counters by time sharing the existing counters at some loss in precision\&. Applications that make no use of multiplexing do not need to call this routine\&. .PP \fBC Interface:\fP .RS 4 diff --git a/man/man3/PAPI_multiplex_option_t.3 b/man/man3/PAPI_multiplex_option_t.3 index 1e92054ce..314f6ea42 100644 --- a/man/man3/PAPI_multiplex_option_t.3 +++ b/man/man3/PAPI_multiplex_option_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_multiplex_option_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_multiplex_option_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_num_cmp_hwctrs.3 b/man/man3/PAPI_num_cmp_hwctrs.3 index 91fd29cb4..2665d2b9a 100644 --- a/man/man3/PAPI_num_cmp_hwctrs.3 +++ b/man/man3/PAPI_num_cmp_hwctrs.3 @@ -1,4 +1,4 @@ -.TH "PAPI_num_cmp_hwctrs" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_num_cmp_hwctrs" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -9,17 +9,17 @@ PAPI_num_cmp_hwctrs \- Return the number of hardware counters for the specified .PP .SH "Detailed Description" .PP -\fBPAPI_num_cmp_hwctrs()\fP returns the number of counters present in the specified component\&. By convention, component 0 is always the cpu\&. +PAPI_num_cmp_hwctrs() returns the number of counters present in the specified component\&. By convention, component 0 is always the cpu\&. .PP On some components, especially for CPUs, the value returned is a theoretical maximum for estimation purposes only\&. It might not be possible to easily create an EventSet that contains the full number of events\&. This can be due to a variety of reasons: 1)\&. Some CPUs (especially Intel and POWER) have the notion of fixed counters that can only measure one thing, usually cycles\&. 2)\&. Some CPUs have very explicit rules about which event can run in which counter\&. In this case it might not be possible to add a wanted event even if counters are free\&. 3)\&. Some CPUs halve the number of counters available when running with SMT (multiple CPU threads) enabled\&. 4)\&. Some operating systems 'steal' a counter to use for things such as NMI Watchdog timers\&. The only sure way to see if events will fit is to attempt adding events to an EventSet, and doing something sensible if an error is generated\&. .PP -\fBPAPI_library_init()\fP must be called in order for this function to return anything greater than 0\&. +PAPI_library_init() must be called in order for this function to return anything greater than 0\&. .PP \fBC Interface:\fP .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_num_cmp_hwctrs(int cidx )\fP; +int PAPI_num_cmp_hwctrs(int cidx ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_num_components.3 b/man/man3/PAPI_num_components.3 index f54c067c3..9e109c5c5 100644 --- a/man/man3/PAPI_num_components.3 +++ b/man/man3/PAPI_num_components.3 @@ -1,4 +1,4 @@ -.TH "PAPI_num_components" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_num_components" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_num_events.3 b/man/man3/PAPI_num_events.3 index 4bc0e3432..a4e4c38e0 100644 --- a/man/man3/PAPI_num_events.3 +++ b/man/man3/PAPI_num_events.3 @@ -1,4 +1,4 @@ -.TH "PAPI_num_events" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_num_events" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -9,13 +9,13 @@ PAPI_num_events \- Return the number of events in an event set\&. .PP .SH "Detailed Description" .PP -\fBPAPI_num_events()\fP returns the number of preset and/or native events contained in an event set\&. The event set should be created by \fBPAPI_create_eventset\fP \&. +PAPI_num_events() returns the number of preset and/or native events contained in an event set\&. The event set should be created by \fBPAPI_create_eventset\fP \&. .PP \fBC Interface:\fP .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_num_events(int EventSet )\fP; +int PAPI_num_events(int EventSet ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_num_hwctrs.3 b/man/man3/PAPI_num_hwctrs.3 index 02dc8a7ad..4a7c72b15 100644 --- a/man/man3/PAPI_num_hwctrs.3 +++ b/man/man3/PAPI_num_hwctrs.3 @@ -1,4 +1,4 @@ -.TH "PAPI_num_hwctrs" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_num_hwctrs" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_option_t.3 b/man/man3/PAPI_option_t.3 index 345138339..0dfb90618 100644 --- a/man/man3/PAPI_option_t.3 +++ b/man/man3/PAPI_option_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_option_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_option_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -8,7 +8,7 @@ PAPI_option_t \- A pointer to the following is passed to PAPI_set/get_opt() .br .PP .PP -\fC#include \fP +\fR#include \fP .SS "Data Fields" .in +1c diff --git a/man/man3/PAPI_overflow.3 b/man/man3/PAPI_overflow.3 index 3ce01408a..0f73baa01 100644 --- a/man/man3/PAPI_overflow.3 +++ b/man/man3/PAPI_overflow.3 @@ -1,4 +1,4 @@ -.TH "PAPI_overflow" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_overflow" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -9,7 +9,7 @@ PAPI_overflow \- Set up an event set to begin registering overflows\&. .PP .SH "Detailed Description" .PP -\fBPAPI_overflow()\fP marks a specific EventCode in an EventSet to generate an overflow signal after every threshold events are counted\&. More than one event in an event set can be used to trigger overflows\&. In such cases, the user must call this function once for each overflowing event\&. To turn off overflow on a specified event, call this function with a threshold value of 0\&. +PAPI_overflow() marks a specific EventCode in an EventSet to generate an overflow signal after every threshold events are counted\&. More than one event in an event set can be used to trigger overflows\&. In such cases, the user must call this function once for each overflowing event\&. To turn off overflow on a specified event, call this function with a threshold value of 0\&. .PP Overflows can be implemented in either software or hardware, but the scope is the entire event set\&. PAPI defaults to hardware overflow if it is available\&. In the case of software overflow, a periodic timer interrupt causes PAPI to compare the event counts against the threshold values and call the overflow handler if one or more events have exceeded their threshold\&. In the case of hardware overflow, the counters are typically set to the negative of the threshold value and count up to 0\&. This zero-crossing triggers a hardware interrupt that calls the overflow handler\&. Because of this counter interrupt, the counter values for overflowing counters may be very small or even negative numbers, and cannot be relied upon as accurate\&. In such cases the overflow handler can approximate the counts by supplying the threshold value whenever an overflow occurs\&. .PP diff --git a/man/man3/PAPI_perror.3 b/man/man3/PAPI_perror.3 index 3ed38bcd2..eea46ec4f 100644 --- a/man/man3/PAPI_perror.3 +++ b/man/man3/PAPI_perror.3 @@ -1,4 +1,4 @@ -.TH "PAPI_perror" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_perror" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_perror \- Produces a string on standard error, describing the last library .RS 4 #include <\fBpapi\&.h\fP> .br - void \fBPAPI_perror( const char *s )\fP; + void PAPI_perror( const char *s ); .RE .PP \fBParameters\fP @@ -23,7 +23,7 @@ PAPI_perror \- Produces a string on standard error, describing the last library \fIs\fP -- Optional message to print before the string describing the last error message\&. .RE .PP -The routine \fBPAPI_perror()\fP produces a message on the standard error output, describing the last error encountered during a call to PAPI\&. If s is not NULL, s is printed, followed by a colon and a space\&. Then the error message and a new-line are printed\&. +The routine PAPI_perror() produces a message on the standard error output, describing the last error encountered during a call to PAPI\&. If s is not NULL, s is printed, followed by a colon and a space\&. Then the error message and a new-line are printed\&. .PP \fBExample:\fP .RS 4 diff --git a/man/man3/PAPI_preload_info_t.3 b/man/man3/PAPI_preload_info_t.3 index 4d9c79c9e..94754b73e 100644 --- a/man/man3/PAPI_preload_info_t.3 +++ b/man/man3/PAPI_preload_info_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_preload_info_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_preload_info_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_profil.3 b/man/man3/PAPI_profil.3 index e95973919..58323280f 100644 --- a/man/man3/PAPI_profil.3 +++ b/man/man3/PAPI_profil.3 @@ -1,4 +1,4 @@ -.TH "PAPI_profil" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_profil" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -34,7 +34,7 @@ The profiling routines have no Fortran interface\&. .br \fIscale\fP -- broadly and historically speaking, a contraction factor that indicates how much smaller the histogram buffer is than the region to be profiled\&. More precisely, scale is interpreted as an unsigned 16-bit fixed-point fraction with the decimal point implied on the left\&. Its value is the reciprocal of the number of addresses in a subdivision, per counter of histogram buffer\&. Below is a table of representative values for scale\&. .br -\fIEventSet\fP -- The PAPI EventSet to profile\&. This EventSet is marked as profiling-ready, but profiling doesn't actually start until a \fBPAPI_start()\fP call is issued\&. +\fIEventSet\fP -- The PAPI EventSet to profile\&. This EventSet is marked as profiling-ready, but profiling doesn't actually start until a PAPI_start() call is issued\&. .br \fIEventCode\fP -- Code of the Event in the EventSet to profile\&. This event must already be a member of the EventSet\&. .br @@ -60,7 +60,7 @@ The profiling routines have no Fortran interface\&. \fIPAPI_ENOEVNT\fP The PAPI preset is not available on the underlying hardware\&. .RE .PP -\fBPAPI_profil()\fP provides hardware event statistics by profiling the occurrence of specified hardware counter events\&. It is designed to mimic the UNIX SVR4 profil call\&. +PAPI_profil() provides hardware event statistics by profiling the occurrence of specified hardware counter events\&. It is designed to mimic the UNIX SVR4 profil call\&. .PP The statistics are generated by creating a histogram of hardware counter event overflows vs\&. program counter addresses for the current process\&. The histogram is defined for a specific region of program code to be profiled, and the identified region is logically broken up into a set of equal size subdivisions, each of which corresponds to a count in the histogram\&. .PP @@ -68,7 +68,7 @@ With each hardware event overflow, the current subdivision is identified and its .PP The resulting histogram counts for a profiled region can be used to identify those program addresses that generate a disproportionately high percentage of the event of interest\&. .PP -Events to be profiled are specified with the EventSet and EventCode parameters\&. More than one event can be simultaneously profiled by calling \fBPAPI_profil()\fP several times with different EventCode values\&. Profiling can be turned off for a given event by calling \fBPAPI_profil()\fP with a threshold value of 0\&. +Events to be profiled are specified with the EventSet and EventCode parameters\&. More than one event can be simultaneously profiled by calling PAPI_profil() several times with different EventCode values\&. Profiling can be turned off for a given event by calling PAPI_profil() with a threshold value of 0\&. .PP \fBRepresentative values for the scale variable\fP .RS 4 @@ -85,54 +85,52 @@ HEX DECIMAL DEFININTION .RE .PP -Historically, the scale factor was introduced to allow the allocation of buffers smaller than the code size to be profiled\&. Data and instruction sizes were assumed to be multiples of 16-bits\&. These assumptions are no longer necessarily true\&. \fBPAPI_profil()\fP has preserved the traditional definition of scale where appropriate, but deprecated the definitions for 0 and 1 (disable scaling) and extended the range of scale to include 65536 and 131072 to allow for exactly two addresses and exactly one address per profiling bucket\&. +Historically, the scale factor was introduced to allow the allocation of buffers smaller than the code size to be profiled\&. Data and instruction sizes were assumed to be multiples of 16-bits\&. These assumptions are no longer necessarily true\&. PAPI_profil() has preserved the traditional definition of scale where appropriate, but deprecated the definitions for 0 and 1 (disable scaling) and extended the range of scale to include 65536 and 131072 to allow for exactly two addresses and exactly one address per profiling bucket\&. .PP The value of bufsiz is computed as follows: .PP bufsiz = (end - start)*(bucket_size/2)*(scale/65536) where .PD 0 - -.IP "\(bu" 2 +.IP "\(bu" 1 bufsiz - the size of the buffer in bytes -.IP "\(bu" 2 +.IP "\(bu" 1 end, start - the ending and starting addresses of the profiled region -.IP "\(bu" 2 +.IP "\(bu" 1 bucket_size - the size of each bucket in bytes; 2, 4, or 8 as defined in flags .PP \fBDefined bits for the flags variable:\fP .RS 4 .PD 0 - -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_PROFIL_POSIX Default type of profiling, similar to profil (3)\&. .br -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_PROFIL_RANDOM Drop a random 25% of the samples\&. .br -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_PROFIL_WEIGHTED Weight the samples by their value\&. .br -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_PROFIL_COMPRESS Ignore samples as values in the hash buckets get big\&. .br -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_PROFIL_BUCKET_16 Use unsigned short (16 bit) buckets, This is the default bucket\&. .br -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_PROFIL_BUCKET_32 Use unsigned int (32 bit) buckets\&. .br -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_PROFIL_BUCKET_64 Use unsigned long long (64 bit) buckets\&. .br -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_PROFIL_FORCE_SW Force software overflow in profiling\&. .br diff --git a/man/man3/PAPI_query_event.3 b/man/man3/PAPI_query_event.3 index f63e08b89..783bf39c0 100644 --- a/man/man3/PAPI_query_event.3 +++ b/man/man3/PAPI_query_event.3 @@ -1,4 +1,4 @@ -.TH "PAPI_query_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_query_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,10 +15,10 @@ PAPI_query_event \- Query if PAPI event exists\&. .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_query_event(int EventCode)\fP; +int PAPI_query_event(int EventCode); .RE .PP -\fBPAPI_query_event()\fP asks the PAPI library if the PAPI Preset event can be counted on this architecture\&. If the event CAN be counted, the function returns PAPI_OK\&. If the event CANNOT be counted, the function returns an error code\&. This function also can be used to check the syntax of native and user events\&. +PAPI_query_event() asks the PAPI library if the PAPI Preset event can be counted on this architecture\&. If the event CAN be counted, the function returns PAPI_OK\&. If the event CANNOT be counted, the function returns an error code\&. This function also can be used to check the syntax of native and user events\&. .PP \fBParameters\fP .RS 4 diff --git a/man/man3/PAPI_query_named_event.3 b/man/man3/PAPI_query_named_event.3 index 0832a2327..02464e6e5 100644 --- a/man/man3/PAPI_query_named_event.3 +++ b/man/man3/PAPI_query_named_event.3 @@ -1,4 +1,4 @@ -.TH "PAPI_query_named_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_query_named_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,10 +15,10 @@ PAPI_query_named_event \- Query if a named PAPI event exists\&. .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_query_named_event(const char *EventName)\fP; +int PAPI_query_named_event(const char *EventName); .RE .PP -\fBPAPI_query_named_event()\fP asks the PAPI library if the PAPI named event can be counted on this architecture\&. If the event CAN be counted, the function returns PAPI_OK\&. If the event CANNOT be counted, the function returns an error code\&. This function also can be used to check the syntax of native and user events\&. +PAPI_query_named_event() asks the PAPI library if the PAPI named event can be counted on this architecture\&. If the event CAN be counted, the function returns PAPI_OK\&. If the event CANNOT be counted, the function returns an error code\&. This function also can be used to check the syntax of native and user events\&. .PP \fBParameters\fP .RS 4 diff --git a/man/man3/PAPI_rate_stop.3 b/man/man3/PAPI_rate_stop.3 index 29bf3b6d7..3a98143b7 100644 --- a/man/man3/PAPI_rate_stop.3 +++ b/man/man3/PAPI_rate_stop.3 @@ -1,4 +1,4 @@ -.TH "PAPI_rate_stop" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_rate_stop" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_rate_stop \- Stop a running event set of a rate function\&. .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_rate_stop()\fP; +int PAPI_rate_stop(); .RE .PP \fBReturn values\fP @@ -29,13 +29,13 @@ int \fBPAPI_rate_stop()\fP; .PP \fBSee also\fP .RS 4 -\fBPAPI_flips_rate()\fP +PAPI_flips_rate() .PP -\fBPAPI_flops_rate()\fP +PAPI_flops_rate() .PP -\fBPAPI_ipc()\fP +PAPI_ipc() .PP -\fBPAPI_epc()\fP +PAPI_epc() .RE .PP diff --git a/man/man3/PAPI_read.3 b/man/man3/PAPI_read.3 index d0a12ef49..d88eaff09 100644 --- a/man/man3/PAPI_read.3 +++ b/man/man3/PAPI_read.3 @@ -1,4 +1,4 @@ -.TH "PAPI_read" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_read" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -18,17 +18,17 @@ PAPI_read \- Read hardware counters from an event set\&. int \fBPAPI_read(int EventSet, long_long * values )\fP; .RE .PP -\fBPAPI_read()\fP copies the counters of the indicated event set into the provided array\&. +PAPI_read() copies the counters of the indicated event set into the provided array\&. .PP The counters continue counting after the read\&. .PP -Note the differences between \fBPAPI_read()\fP and \fBPAPI_accum()\fP, specifically that \fBPAPI_accum()\fP resets the values array to zero\&. +Note the differences between PAPI_read() and PAPI_accum()\&. Specifically, PAPI_accum() adds the values of the counters to the values stored in the array (the second parameter in PAPI_accum()) and then resets the counters to zero\&. .PP -\fBPAPI_read()\fP assumes an initialized PAPI library and a properly added event set\&. +PAPI_read() assumes an initialized PAPI library and a properly added event set\&. .PP \fBParameters\fP .RS 4 -\fIEventSet\fP -- an integer handle for a PAPI Event Set as created by \fBPAPI_create_eventset()\fP +\fIEventSet\fP -- an integer handle for a PAPI Event Set as created by PAPI_create_eventset() .br \fI*values\fP -- an array to hold the counter values of the counting events .RE diff --git a/man/man3/PAPI_read_ts.3 b/man/man3/PAPI_read_ts.3 index 01f1ca649..a2bb158cb 100644 --- a/man/man3/PAPI_read_ts.3 +++ b/man/man3/PAPI_read_ts.3 @@ -1,4 +1,4 @@ -.TH "PAPI_read_ts" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_read_ts" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,18 +15,18 @@ PAPI_read_ts \- Read hardware counters with a timestamp\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_read_ts(int EventSet, long long *values, long long *cycles )\fP; + int PAPI_read_ts(int EventSet, long long *values, long long *cycles ); .RE .PP -\fBPAPI_read_ts()\fP copies the counters of the indicated event set into the provided array\&. It also places a real-time cycle timestamp into the cycles array\&. +PAPI_read_ts() copies the counters of the indicated event set into the provided array\&. It also places a real-time cycle timestamp into the cycles array\&. .PP The counters continue counting after the read\&. .PP -\fBPAPI_read_ts()\fP assumes an initialized PAPI library and a properly added event set\&. +PAPI_read_ts() assumes an initialized PAPI library and a properly added event set\&. .PP \fBParameters\fP .RS 4 -\fIEventSet\fP -- an integer handle for a PAPI Event Set as created by \fBPAPI_create_eventset()\fP +\fIEventSet\fP -- an integer handle for a PAPI Event Set as created by PAPI_create_eventset() .br \fI*values\fP -- an array to hold the counter values of the counting events .br diff --git a/man/man3/PAPI_register_thread.3 b/man/man3/PAPI_register_thread.3 index 2f3cdf98d..f63160b38 100644 --- a/man/man3/PAPI_register_thread.3 +++ b/man/man3/PAPI_register_thread.3 @@ -1,4 +1,4 @@ -.TH "PAPI_register_thread" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_register_thread" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -18,7 +18,7 @@ PAPI_register_thread \- Notify PAPI that a thread has 'appeared'\&. int \fBPAPI_register_thread\fP (void); .RE .PP -\fBPAPI_register_thread()\fP should be called when the user wants to force PAPI to initialize a thread that PAPI has not seen before\&. +PAPI_register_thread() should be called when the user wants to force PAPI to initialize a thread that PAPI has not seen before\&. .PP Usually this is not necessary as PAPI implicitly detects the thread when an eventset is created or other thread local PAPI functions are called\&. However, it can be useful for debugging and performance enhancements in the run-time systems of performance tools\&. .PP diff --git a/man/man3/PAPI_remove_event.3 b/man/man3/PAPI_remove_event.3 index 379337838..80b3bd160 100644 --- a/man/man3/PAPI_remove_event.3 +++ b/man/man3/PAPI_remove_event.3 @@ -1,4 +1,4 @@ -.TH "PAPI_remove_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_remove_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ A hardware event can be either a PAPI Preset or a native hardware event code\&. .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_remove_event( int EventSet, int EventCode )\fP; +int PAPI_remove_event( int EventSet, int EventCode ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_remove_events.3 b/man/man3/PAPI_remove_events.3 index 60c04245b..ad80738c9 100644 --- a/man/man3/PAPI_remove_events.3 +++ b/man/man3/PAPI_remove_events.3 @@ -1,4 +1,4 @@ -.TH "PAPI_remove_events" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_remove_events" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ A hardware event can be either a PAPI Preset or a native hardware event code\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_remove_events( int EventSet, int * EventCode, int number )\fP; + int PAPI_remove_events( int EventSet, int * EventCode, int number ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_remove_named_event.3 b/man/man3/PAPI_remove_named_event.3 index acf7a697f..2c9ad7635 100644 --- a/man/man3/PAPI_remove_named_event.3 +++ b/man/man3/PAPI_remove_named_event.3 @@ -1,4 +1,4 @@ -.TH "PAPI_remove_named_event" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_remove_named_event" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ A hardware event can be either a PAPI Preset or a native hardware event code\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_remove_named_event( int EventSet, const char *EventName )\fP; + int PAPI_remove_named_event( int EventSet, const char *EventName ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_reset.3 b/man/man3/PAPI_reset.3 index 6cd9f92d3..db96ca918 100644 --- a/man/man3/PAPI_reset.3 +++ b/man/man3/PAPI_reset.3 @@ -1,4 +1,4 @@ -.TH "PAPI_reset" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_reset" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_reset \- Reset the hardware event counts in an event set\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_reset( int EventSet )\fP; + int PAPI_reset( int EventSet ); .RE .PP \fBParameters\fP @@ -32,7 +32,7 @@ PAPI_reset \- Reset the hardware event counts in an event set\&. \fIPAPI_ENOEVST\fP The EventSet specified does not exist\&. .RE .PP -\fBPAPI_reset()\fP zeroes the values of the counters contained in EventSet\&. This call assumes an initialized PAPI library and a properly added event set +PAPI_reset() zeroes the values of the counters contained in EventSet\&. This call assumes an initialized PAPI library and a properly added event set .PP \fBExample:\fP .RS 4 diff --git a/man/man3/PAPI_set_cmp_domain.3 b/man/man3/PAPI_set_cmp_domain.3 index 2829c842d..76429afef 100644 --- a/man/man3/PAPI_set_cmp_domain.3 +++ b/man/man3/PAPI_set_cmp_domain.3 @@ -1,4 +1,4 @@ -.TH "PAPI_set_cmp_domain" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_set_cmp_domain" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,29 +15,28 @@ PAPI_set_cmp_domain \- Set the default counting domain for new event sets bound .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_set_cmp_domain( int domain, int cidx )\fP; + int PAPI_set_cmp_domain( int domain, int cidx ); .RE .PP \fBParameters\fP .RS 4 \fIdomain\fP one of the following constants as defined in the \fBpapi\&.h\fP header file .PD 0 - -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_USER User context counted -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_KERNEL Kernel/OS context counted -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_OTHER Exception/transient mode counted -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_SUPERVISOR Supervisor/hypervisor context counted -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_ALL All above contexts counted -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_MIN The smallest available context -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_MAX The largest available context -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_HWSPEC Something other than CPU like stuff\&. Individual components can decode low order bits for more meaning .PP .br diff --git a/man/man3/PAPI_set_cmp_granularity.3 b/man/man3/PAPI_set_cmp_granularity.3 index 4275eca41..d7cf746ab 100644 --- a/man/man3/PAPI_set_cmp_granularity.3 +++ b/man/man3/PAPI_set_cmp_granularity.3 @@ -1,4 +1,4 @@ -.TH "PAPI_set_cmp_granularity" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_set_cmp_granularity" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,27 +15,26 @@ PAPI_set_cmp_granularity \- Set the default counting granularity for eventsets b .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_set_cmp_granularity( int granularity, int cidx )\fP; + int PAPI_set_cmp_granularity( int granularity, int cidx ); .RE .PP \fBParameters\fP .RS 4 \fIgranularity\fP one of the following constants as defined in the \fBpapi\&.h\fP header file .PD 0 - -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_THR Count each individual thread -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_PROC Count each individual process -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_PROCG Count each individual process group -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_SYS Count the current CPU -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_SYS_CPU Count all CPUs individually -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_MIN The finest available granularity -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_MAX The coarsest available granularity .PP .br diff --git a/man/man3/PAPI_set_debug.3 b/man/man3/PAPI_set_debug.3 index 1b871ddb4..00a3dd639 100644 --- a/man/man3/PAPI_set_debug.3 +++ b/man/man3/PAPI_set_debug.3 @@ -1,4 +1,4 @@ -.TH "PAPI_set_debug" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_set_debug" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_set_debug \- Set the current debug level for error output from PAPI\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_set_debug( int level )\fP; + int PAPI_set_debug( int level ); .RE .PP \fBParameters\fP @@ -24,12 +24,11 @@ PAPI_set_debug \- Set the current debug level for error output from PAPI\&. .br The possible debug levels for debugging are shown below\&. .PD 0 - -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_QUIET Do not print anything, just return the error code -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_VERB_ECONT Print error message and continue -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_VERB_ESTOP Print error message and exit .br @@ -67,7 +66,7 @@ The PAPI error handler prints out messages in the following form: .PP \fBNote\fP .RS 4 -This is the ONLY function that may be called BEFORE \fBPAPI_library_init()\fP\&. +This is the ONLY function that may be called BEFORE PAPI_library_init()\&. .br .RE diff --git a/man/man3/PAPI_set_domain.3 b/man/man3/PAPI_set_domain.3 index 1dabe6379..1a8d85a9e 100644 --- a/man/man3/PAPI_set_domain.3 +++ b/man/man3/PAPI_set_domain.3 @@ -1,4 +1,4 @@ -.TH "PAPI_set_domain" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_set_domain" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,27 +15,26 @@ PAPI_set_domain \- Set the default counting domain for new event sets bound to t .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_set_domain( int domain )\fP; + int PAPI_set_domain( int domain ); .RE .PP \fBParameters\fP .RS 4 \fIdomain\fP one of the following constants as defined in the \fBpapi\&.h\fP header file .PD 0 - -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_USER User context counted -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_KERNEL Kernel/OS context counted -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_OTHER Exception/transient mode counted -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_SUPERVISOR Supervisor/hypervisor context counted -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_ALL All above contexts counted -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_MIN The smallest available context -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_DOM_MAX The largest available context .PP diff --git a/man/man3/PAPI_set_granularity.3 b/man/man3/PAPI_set_granularity.3 index 2cfbf9d7b..f2c4fdf21 100644 --- a/man/man3/PAPI_set_granularity.3 +++ b/man/man3/PAPI_set_granularity.3 @@ -1,4 +1,4 @@ -.TH "PAPI_set_granularity" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_set_granularity" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,27 +15,26 @@ PAPI_set_granularity \- Set the default counting granularity for eventsets bound .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_set_granularity( int granularity )\fP; + int PAPI_set_granularity( int granularity ); .RE .PP \fBParameters\fP .RS 4 \fI--\fP granularity one of the following constants as defined in the \fBpapi\&.h\fP header file .PD 0 - -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_THR -- Count each individual thread -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_PROC -- Count each individual process -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_PROCG -- Count each individual process group -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_SYS -- Count the current CPU -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_SYS_CPU -- Count all CPUs individually -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_MIN -- The finest available granularity -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_GRN_MAX -- The coarsest available granularity .PP diff --git a/man/man3/PAPI_set_multiplex.3 b/man/man3/PAPI_set_multiplex.3 index 2f9479023..2b4d8bd5b 100644 --- a/man/man3/PAPI_set_multiplex.3 +++ b/man/man3/PAPI_set_multiplex.3 @@ -1,4 +1,4 @@ -.TH "PAPI_set_multiplex" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_set_multiplex" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_set_multiplex \- Convert a standard event set to a multiplexed event set\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_set_multiplex( int EventSet )\fP; + int PAPI_set_multiplex( int EventSet ); .RE .PP \fBParameters\fP @@ -38,7 +38,7 @@ PAPI_set_multiplex \- Convert a standard event set to a multiplexed event set\&. \fIPAPI_ENOMEM\fP -- Insufficient memory to complete the operation\&. .RE .PP -\fBPAPI_set_multiplex\fP converts a standard PAPI event set created by a call to \fBPAPI_create_eventset\fP into an event set capable of handling multiplexed events\&. This must be done after calling \fBPAPI_multiplex_init\fP, and either \fBPAPI_add_event\fP or \fBPAPI_assign_eventset_component\fP, but prior to calling \fBPAPI_start()\fP\&. +\fBPAPI_set_multiplex\fP converts a standard PAPI event set created by a call to \fBPAPI_create_eventset\fP into an event set capable of handling multiplexed events\&. This must be done after calling \fBPAPI_multiplex_init\fP, and either \fBPAPI_add_event\fP or \fBPAPI_assign_eventset_component\fP, but prior to calling PAPI_start()\&. .PP Events can be added to an event set either before or after converting it into a multiplexed set, but the conversion must be done prior to using it as a multiplexed set\&. .PP diff --git a/man/man3/PAPI_set_opt.3 b/man/man3/PAPI_set_opt.3 index dd1f0cc9a..cb9d7bd23 100644 --- a/man/man3/PAPI_set_opt.3 +++ b/man/man3/PAPI_set_opt.3 @@ -1,4 +1,4 @@ -.TH "PAPI_set_opt" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_set_opt" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_set_opt \- Set PAPI library or event set options\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_set_opt( int option, PAPI_option_t * ptr )\fP; + int PAPI_set_opt( int option, PAPI_option_t * ptr ); .RE .PP \fBParameters\fP @@ -42,7 +42,7 @@ PAPI_set_opt \- Set PAPI library or event set options\&. \fIPAPI_EINVAL_DOM\fP Invalid domain has been requested\&. .RE .PP -\fBPAPI_set_opt()\fP changes the options of the PAPI library or a specific EventSet created by \fBPAPI_create_eventset\fP\&. Some options may require that the EventSet be bound to a component before they can execute successfully\&. This can be done either by adding an event or by explicitly calling \fBPAPI_assign_eventset_component\fP\&. +PAPI_set_opt() changes the options of the PAPI library or a specific EventSet created by \fBPAPI_create_eventset\fP\&. Some options may require that the EventSet be bound to a component before they can execute successfully\&. This can be done either by adding an event or by explicitly calling \fBPAPI_assign_eventset_component\fP\&. .PP Ptr is a pointer to the \fBPAPI_option_t\fP structure, which is actually a union of different structures for different options\&. Not all options require or return information in these structures\&. Each requires different values to be set\&. Some options require a component index to be provided\&. These options are handled implicitly through the option structures\&. .PP diff --git a/man/man3/PAPI_set_thr_specific.3 b/man/man3/PAPI_set_thr_specific.3 index b09dce510..f2014c121 100644 --- a/man/man3/PAPI_set_thr_specific.3 +++ b/man/man3/PAPI_set_thr_specific.3 @@ -1,4 +1,4 @@ -.TH "PAPI_set_thr_specific" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_set_thr_specific" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_set_thr_specific \- Store a pointer to a thread specific data structure\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_set_thr_specific( int tag, void *ptr )\fP; + int PAPI_set_thr_specific( int tag, void *ptr ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_shlib_info_t.3 b/man/man3/PAPI_shlib_info_t.3 index 75da11e97..221130d8d 100644 --- a/man/man3/PAPI_shlib_info_t.3 +++ b/man/man3/PAPI_shlib_info_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_shlib_info_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_shlib_info_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_shutdown.3 b/man/man3/PAPI_shutdown.3 index ee7256a02..0cd843f4b 100644 --- a/man/man3/PAPI_shutdown.3 +++ b/man/man3/PAPI_shutdown.3 @@ -1,4 +1,4 @@ -.TH "PAPI_shutdown" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_shutdown" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,10 +15,10 @@ PAPI_shutdown \- Finish using PAPI and free all related resources\&. .RS 4 #include <\fBpapi\&.h\fP> .br - void \fBPAPI_shutdown( void )\fP; + void PAPI_shutdown( void ); .RE .PP -\fBPAPI_shutdown()\fP is an exit function used by the PAPI Library to free resources and shut down when certain error conditions arise\&. It is not necessary for the user to call this function, but doing so allows the user to have the capability to free memory and resources used by the PAPI Library\&. +PAPI_shutdown() is an exit function used by the PAPI Library to free resources and shut down when certain error conditions arise\&. It is not necessary for the user to call this function, but doing so allows the user to have the capability to free memory and resources used by the PAPI Library\&. .PP \fBSee also\fP .RS 4 diff --git a/man/man3/PAPI_sprofil.3 b/man/man3/PAPI_sprofil.3 index 86de398af..a0622ff37 100644 --- a/man/man3/PAPI_sprofil.3 +++ b/man/man3/PAPI_sprofil.3 @@ -1,4 +1,4 @@ -.TH "PAPI_sprofil" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_sprofil" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,27 +15,26 @@ PAPI_sprofil \- Generate PC histogram data from multiple code regions where hard .RS 4 #include <\fBpapi\&.h\fP> .br -int \fBPAPI_sprofil( PAPI_sprofil_t * prof, int profcnt, int EventSet, int EventCode, int threshold, int flags )\fP; +int PAPI_sprofil( PAPI_sprofil_t * prof, int profcnt, int EventSet, int EventCode, int threshold, int flags ); .RE .PP \fBParameters\fP .RS 4 \fI*prof\fP pointer to an array of \fBPAPI_sprofil_t\fP structures\&. Each copy of the structure contains the following: .PD 0 - -.IP "\(bu" 2 +.IP "\(bu" 1 buf -- pointer to a buffer of bufsiz bytes in which the histogram counts are stored in an array of unsigned short, unsigned int, or unsigned long long values, or 'buckets'\&. The size of the buckets is determined by values in the flags argument\&. -.IP "\(bu" 2 +.IP "\(bu" 1 bufsiz -- the size of the histogram buffer in bytes\&. It is computed from the length of the code region to be profiled, the size of the buckets, and the scale factor as discussed below\&. -.IP "\(bu" 2 +.IP "\(bu" 1 offset -- the start address of the region to be profiled\&. -.IP "\(bu" 2 +.IP "\(bu" 1 scale -- broadly and historically speaking, a contraction factor that indicates how much smaller the histogram buffer is than the region to be profiled\&. More precisely, scale is interpreted as an unsigned 16-bit fixed-point fraction with the decimal point implied on the left\&. Its value is the reciprocal of the number of addresses in a subdivision, per counter of histogram buffer\&. .PP .br \fIprofcnt\fP number of structures in the prof array for hardware profiling\&. .br -\fIEventSet\fP The PAPI EventSet to profile\&. This EventSet is marked as profiling-ready, but profiling doesn't actually start until a \fBPAPI_start()\fP call is issued\&. +\fIEventSet\fP The PAPI EventSet to profile\&. This EventSet is marked as profiling-ready, but profiling doesn't actually start until a PAPI_start() call is issued\&. .br \fIEventCode\fP Code of the Event in the EventSet to profile\&. This event must already be a member of the EventSet\&. .br @@ -48,12 +47,12 @@ scale -- broadly and historically speaking, a contraction factor that indicates .PP \fBReturn values\fP .RS 4 -\fIReturn\fP values for \fBPAPI_sprofil()\fP are identical to those for \fBPAPI_profil\fP\&. Please refer to that page for further details\&. +\fIReturn\fP values for PAPI_sprofil() are identical to those for \fBPAPI_profil\fP\&. Please refer to that page for further details\&. .RE .PP -\fBPAPI_sprofil()\fP is a structure driven profiler that profiles one or more disjoint regions of code in a single call\&. It accepts a pointer to a preinitialized array of sprofil structures, and initiates profiling based on the values contained in the array\&. Each structure in the array defines the profiling parameters that are normally passed to \fBPAPI_profil()\fP\&. For more information on profiling, \fBPAPI_profil\fP +PAPI_sprofil() is a structure driven profiler that profiles one or more disjoint regions of code in a single call\&. It accepts a pointer to a preinitialized array of sprofil structures, and initiates profiling based on the values contained in the array\&. Each structure in the array defines the profiling parameters that are normally passed to PAPI_profil()\&. For more information on profiling, \fBPAPI_profil\fP .PP diff --git a/man/man3/PAPI_sprofil_t.3 b/man/man3/PAPI_sprofil_t.3 index 4f8a39d8c..89dcdaec3 100644 --- a/man/man3/PAPI_sprofil_t.3 +++ b/man/man3/PAPI_sprofil_t.3 @@ -1,4 +1,4 @@ -.TH "PAPI_sprofil_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_sprofil_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_start.3 b/man/man3/PAPI_start.3 index 51ea1ac80..67367a875 100644 --- a/man/man3/PAPI_start.3 +++ b/man/man3/PAPI_start.3 @@ -1,4 +1,4 @@ -.TH "PAPI_start" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_start" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_start \- Start counting hardware events in an event set\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_start( int EventSet )\fP; + int PAPI_start( int EventSet ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_state.3 b/man/man3/PAPI_state.3 index 68f7626ea..f0730ee60 100644 --- a/man/man3/PAPI_state.3 +++ b/man/man3/PAPI_state.3 @@ -1,4 +1,4 @@ -.TH "PAPI_state" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_state" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_state \- Return the counting state of an EventSet\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_state( int EventSet, int * status )\fP; + int PAPI_state( int EventSet, int * status ); .RE .PP \fBParameters\fP @@ -24,24 +24,23 @@ PAPI_state \- Return the counting state of an EventSet\&. .br \fIstatus\fP -- an integer containing a boolean combination of one or more of the following nonzero constants as defined in the PAPI header file \fBpapi\&.h\fP: .PD 0 - -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_STOPPED -- EventSet is stopped -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_RUNNING -- EventSet is running -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_PAUSED -- EventSet temporarily disabled by the library -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_NOT_INIT -- EventSet defined, but not initialized -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_OVERFLOWING -- EventSet has overflowing enabled -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_PROFILING -- EventSet has profiling enabled -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_MULTIPLEXING -- EventSet has multiplexing enabled -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_ACCUMULATING -- reserved for future use -.IP "\(bu" 2 +.IP "\(bu" 1 PAPI_HWPROFILING -- reserved for future use .PP @@ -57,7 +56,7 @@ PAPI_HWPROFILING -- reserved for future use .RE .PP -\fBPAPI_state()\fP returns the counting state of the specified event set\&. +PAPI_state() returns the counting state of the specified event set\&. .PP \fBExample:\fP diff --git a/man/man3/PAPI_stop.3 b/man/man3/PAPI_stop.3 index c62b2e3de..b48ce75da 100644 --- a/man/man3/PAPI_stop.3 +++ b/man/man3/PAPI_stop.3 @@ -1,4 +1,4 @@ -.TH "PAPI_stop" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_stop" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_stop \- Stop counting hardware events in an event set\&. .RS 4 #include <\fBpapi\&.h\fP> .br - int \fBPAPI_stop( int EventSet, long long * values )\fP; + int PAPI_stop( int EventSet, long long * values ); .RE .PP \fBParameters\fP diff --git a/man/man3/PAPI_strerror.3 b/man/man3/PAPI_strerror.3 index e805691a2..74f32b6e2 100644 --- a/man/man3/PAPI_strerror.3 +++ b/man/man3/PAPI_strerror.3 @@ -1,4 +1,4 @@ -.TH "PAPI_strerror" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_strerror" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -15,7 +15,7 @@ PAPI_strerror \- Returns a string describing the PAPI error code\&. .RS 4 #include <\fBpapi\&.h\fP> .br - char * \fBPAPI_strerror( int errorCode )\fP; + char * PAPI_strerror( int errorCode ); .RE .PP \fBParameters\fP @@ -29,10 +29,10 @@ PAPI_strerror \- Returns a string describing the PAPI error code\&. .RS 4 \fI*error\fP -- a pointer to the error string\&. .br -\fINULL\fP -- the input error code to \fBPAPI_strerror()\fP is invalid\&. +\fINULL\fP -- the input error code to PAPI_strerror() is invalid\&. .RE .PP -\fBPAPI_strerror()\fP returns a pointer to the error message corresponding to the error code code\&. If the call fails the function returns the NULL pointer\&. This function is not implemented in Fortran\&. +PAPI_strerror() returns a pointer to the error message corresponding to the error code code\&. If the call fails the function returns the NULL pointer\&. This function is not implemented in Fortran\&. .PP \fBExample:\fP .RS 4 diff --git a/man/man3/PAPI_thread_id.3 b/man/man3/PAPI_thread_id.3 index c78cdc696..a1741eb62 100644 --- a/man/man3/PAPI_thread_id.3 +++ b/man/man3/PAPI_thread_id.3 @@ -1,4 +1,4 @@ -.TH "PAPI_thread_id" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_thread_id" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -18,7 +18,7 @@ PAPI_thread_id \- Get the thread identifier of the current thread\&. \fI-1\fP is returned if the thread id function returns an error\&. .RE .PP -This function returns a valid thread identifier\&. It calls the function registered with PAPI through a call to \fBPAPI_thread_init()\fP\&. +This function returns a valid thread identifier\&. It calls the function registered with PAPI through a call to PAPI_thread_init()\&. .PP .PP .nf diff --git a/man/man3/PAPI_thread_init.3 b/man/man3/PAPI_thread_init.3 index 73b43a9ff..d8184ae6c 100644 --- a/man/man3/PAPI_thread_init.3 +++ b/man/man3/PAPI_thread_init.3 @@ -1,4 +1,4 @@ -.TH "PAPI_thread_init" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_thread_init" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -16,7 +16,7 @@ PAPI_thread_init \- Initialize thread support in the PAPI library\&. \fI*id_fn\fP Pointer to a function that returns current thread ID\&. .RE .PP -\fBPAPI_thread_init\fP initializes thread support in the PAPI library\&. Applications that make no use of threads do not need to call this routine\&. This function MUST return a UNIQUE thread ID for every new thread/LWP created\&. The OpenMP call omp_get_thread_num() violates this rule, as the underlying LWPs may have been killed off by the run-time system or by a call to omp_set_num_threads() \&. In that case, it may still possible to use omp_get_thread_num() in conjunction with \fBPAPI_unregister_thread()\fP when the OpenMP thread has finished\&. However it is much better to use the underlying thread subsystem's call, which is pthread_self() on Linux platforms\&. +\fBPAPI_thread_init\fP initializes thread support in the PAPI library\&. Applications that make no use of threads do not need to call this routine\&. This function MUST return a UNIQUE thread ID for every new thread/LWP created\&. The OpenMP call omp_get_thread_num() violates this rule, as the underlying LWPs may have been killed off by the run-time system or by a call to omp_set_num_threads() \&. In that case, it may still possible to use omp_get_thread_num() in conjunction with PAPI_unregister_thread() when the OpenMP thread has finished\&. However it is much better to use the underlying thread subsystem's call, which is pthread_self() on Linux platforms\&. .PP .PP .nf diff --git a/man/man3/PAPI_unlock.3 b/man/man3/PAPI_unlock.3 index 947f7d163..31bf968a7 100644 --- a/man/man3/PAPI_unlock.3 +++ b/man/man3/PAPI_unlock.3 @@ -1,4 +1,4 @@ -.TH "PAPI_unlock" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_unlock" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -16,7 +16,7 @@ PAPI_unlock \- Unlock one of the mutex variables defined in \fBpapi\&.h\fP\&. \fIlck\fP an integer value specifying one of the two user locks: PAPI_USR1_LOCK or PAPI_USR2_LOCK .RE .PP -\fBPAPI_unlock()\fP unlocks the mutex acquired by a call to \fBPAPI_lock\fP \&. +PAPI_unlock() unlocks the mutex acquired by a call to \fBPAPI_lock\fP \&. .PP \fBSee also\fP .RS 4 diff --git a/man/man3/PAPI_unregister_thread.3 b/man/man3/PAPI_unregister_thread.3 index bfc2b830d..72c79bba2 100644 --- a/man/man3/PAPI_unregister_thread.3 +++ b/man/man3/PAPI_unregister_thread.3 @@ -1,4 +1,4 @@ -.TH "PAPI_unregister_thread" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_unregister_thread" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPI_write.3 b/man/man3/PAPI_write.3 index 33c2cc757..5e1c91d98 100644 --- a/man/man3/PAPI_write.3 +++ b/man/man3/PAPI_write.3 @@ -1,4 +1,4 @@ -.TH "PAPI_write" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPI_write" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME @@ -22,12 +22,12 @@ PAPI_write \- Write counter values into counters\&. .RS 4 \fIPAPI_ENOEVST\fP The EventSet specified does not exist\&. .br -\fIPAPI_ECMP\fP \fBPAPI_write()\fP is not implemented for this architecture\&. +\fIPAPI_ECMP\fP PAPI_write() is not implemented for this architecture\&. .br \fIPAPI_ESYS\fP The EventSet is currently counting events and the component could not change the values of the running counters\&. .RE .PP -\fBPAPI_write()\fP writes the counter values provided in the array values into the event set EventSet\&. The virtual counters managed by the PAPI library will be set to the values provided\&. If the event set is running, an attempt will be made to write the values to the running counters\&. This operation is not permitted by all components and may result in a run-time error\&. +PAPI_write() writes the counter values provided in the array values into the event set EventSet\&. The virtual counters managed by the PAPI library will be set to the values provided\&. If the event set is running, an attempt will be made to write the values to the running counters\&. This operation is not permitted by all components and may result in a run-time error\&. .PP \fBSee also\fP .RS 4 diff --git a/man/man3/PAPIf_hl_read.3 b/man/man3/PAPIf_hl_read.3 index ada02d38a..5dc0d72a1 100644 --- a/man/man3/PAPIf_hl_read.3 +++ b/man/man3/PAPIf_hl_read.3 @@ -1,4 +1,4 @@ -.TH "PAPIf_hl_read" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIf_hl_read" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIf_hl_region_begin.3 b/man/man3/PAPIf_hl_region_begin.3 index 66dc636fd..e12c37d1e 100644 --- a/man/man3/PAPIf_hl_region_begin.3 +++ b/man/man3/PAPIf_hl_region_begin.3 @@ -1,4 +1,4 @@ -.TH "PAPIf_hl_region_begin" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIf_hl_region_begin" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIf_hl_region_end.3 b/man/man3/PAPIf_hl_region_end.3 index 31d1c5377..50e8857a9 100644 --- a/man/man3/PAPIf_hl_region_end.3 +++ b/man/man3/PAPIf_hl_region_end.3 @@ -1,4 +1,4 @@ -.TH "PAPIf_hl_region_end" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIf_hl_region_end" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/PAPIf_hl_stop.3 b/man/man3/PAPIf_hl_stop.3 index 1ac68af97..e5d5b0c74 100644 --- a/man/man3/PAPIf_hl_stop.3 +++ b/man/man3/PAPIf_hl_stop.3 @@ -1,4 +1,4 @@ -.TH "PAPIf_hl_stop" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "PAPIf_hl_stop" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/RateInfo.3 b/man/man3/RateInfo.3 index 2f6372cd8..b2c674a9a 100644 --- a/man/man3/RateInfo.3 +++ b/man/man3/RateInfo.3 @@ -1,4 +1,4 @@ -.TH "RateInfo" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "RateInfo" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/binary_tree_t.3 b/man/man3/binary_tree_t.3 index 5ed6dbf42..744f7ef36 100644 --- a/man/man3/binary_tree_t.3 +++ b/man/man3/binary_tree_t.3 @@ -1,4 +1,4 @@ -.TH "binary_tree_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "binary_tree_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/components_t.3 b/man/man3/components_t.3 index c24799b98..e3364a109 100644 --- a/man/man3/components_t.3 +++ b/man/man3/components_t.3 @@ -1,4 +1,4 @@ -.TH "components_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "components_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/local_components_t.3 b/man/man3/local_components_t.3 index 328b35aab..3ed4999ff 100644 --- a/man/man3/local_components_t.3 +++ b/man/man3/local_components_t.3 @@ -1,4 +1,4 @@ -.TH "local_components_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "local_components_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/reads_t.3 b/man/man3/reads_t.3 index c6a9a6319..6e41a3407 100644 --- a/man/man3/reads_t.3 +++ b/man/man3/reads_t.3 @@ -1,4 +1,4 @@ -.TH "reads_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "reads_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/regions_t.3 b/man/man3/regions_t.3 index ff2b4e19a..b6797ee75 100644 --- a/man/man3/regions_t.3 +++ b/man/man3/regions_t.3 @@ -1,4 +1,4 @@ -.TH "regions_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "regions_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/threads_t.3 b/man/man3/threads_t.3 index b9d223713..fc2f89dd0 100644 --- a/man/man3/threads_t.3 +++ b/man/man3/threads_t.3 @@ -1,4 +1,4 @@ -.TH "threads_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "threads_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME diff --git a/man/man3/value_t.3 b/man/man3/value_t.3 index b5ff72c7b..4a72c6ade 100644 --- a/man/man3/value_t.3 +++ b/man/man3/value_t.3 @@ -1,4 +1,4 @@ -.TH "value_t" 3 "Thu Dec 14 2023" "Version 7.1.0.0" "PAPI" \" -*- nroff -*- +.TH "value_t" 3 "Fri Aug 30 2024 19:06:49" "Version 7.2.0.0b1" "PAPI" \" -*- nroff -*- .ad l .nh .SH NAME From d6aac46e9a6168be93e7c4d29ff2dcbf0e4c8d3c Mon Sep 17 00:00:00 2001 From: Anthony Danalis Date: Fri, 30 Aug 2024 19:33:19 +0000 Subject: [PATCH 3/4] Updated version in configure. --- src/configure | 20 ++++++++++---------- src/configure.in | 4 ++-- 2 files changed, 12 insertions(+), 12 deletions(-) diff --git a/src/configure b/src/configure index d23f10e5b..7b2f712ae 100755 --- a/src/configure +++ b/src/configure @@ -1,6 +1,6 @@ #! /bin/sh # Guess values for system-dependent variables and create Makefiles. -# Generated by GNU Autoconf 2.69 for PAPI 7.1.0.0. +# Generated by GNU Autoconf 2.69 for PAPI 7.2.0.0b1. # # Report bugs to . # @@ -580,8 +580,8 @@ MAKEFLAGS= # Identity of this package. PACKAGE_NAME='PAPI' PACKAGE_TARNAME='papi' -PACKAGE_VERSION='7.1.0.0' -PACKAGE_STRING='PAPI 7.1.0.0' +PACKAGE_VERSION='7.2.0.0b1' +PACKAGE_STRING='PAPI 7.2.0.0b1' PACKAGE_BUGREPORT='ptools-perfapi@icl.utk.edu' PACKAGE_URL='' @@ -1363,7 +1363,7 @@ if test "$ac_init_help" = "long"; then # Omit some internal or obsolete options to make the list less imposing. # This message is too long to be a string in the A/UX 3.1 sh. cat <<_ACEOF -\`configure' configures PAPI 7.1.0.0 to adapt to many kinds of systems. +\`configure' configures PAPI 7.2.0.0b1 to adapt to many kinds of systems. Usage: $0 [OPTION]... [VAR=VALUE]... @@ -1425,7 +1425,7 @@ fi if test -n "$ac_init_help"; then case $ac_init_help in - short | recursive ) echo "Configuration of PAPI 7.1.0.0:";; + short | recursive ) echo "Configuration of PAPI 7.2.0.0b1:";; esac cat <<\_ACEOF @@ -1582,7 +1582,7 @@ fi test -n "$ac_init_help" && exit $ac_status if $ac_init_version; then cat <<\_ACEOF -PAPI configure 7.1.0.0 +PAPI configure 7.2.0.0b1 generated by GNU Autoconf 2.69 Copyright (C) 2012 Free Software Foundation, Inc. @@ -2100,7 +2100,7 @@ cat >config.log <<_ACEOF This file contains any messages produced by compilers while running configure, to aid debugging if configure makes a mistake. -It was created by PAPI $as_me 7.1.0.0, which was +It was created by PAPI $as_me 7.2.0.0b1, which was generated by GNU Autoconf 2.69. Invocation command line was $ $0 $@ @@ -6356,7 +6356,7 @@ SHOW_CONF=showconf CTEST_TARGETS="all" FTEST_TARGETS="all" LIBRARY=libpapi.a -SHLIB='libpapi.so.7.1.0.0' +SHLIB='libpapi.so.7.2.0.0b1' PAPISOVER='$(PAPIVER).$(PAPIREV)' VLIB='libpapi.so.$(PAPISOVER)' OMPCFLGS=-fopenmp @@ -7508,7 +7508,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1 # report actual input values of CONFIG_FILES etc. instead of their # values after options handling. ac_log=" -This file was extended by PAPI $as_me 7.1.0.0, which was +This file was extended by PAPI $as_me 7.2.0.0b1, which was generated by GNU Autoconf 2.69. Invocation command line was CONFIG_FILES = $CONFIG_FILES @@ -7574,7 +7574,7 @@ _ACEOF cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1 ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`" ac_cs_version="\\ -PAPI config.status 7.1.0.0 +PAPI config.status 7.2.0.0b1 configured by $0, generated by GNU Autoconf 2.69, with options \\"\$ac_cs_config\\" diff --git a/src/configure.in b/src/configure.in index 15ccf824b..7736565da 100644 --- a/src/configure.in +++ b/src/configure.in @@ -1862,8 +1862,8 @@ for comp in $components; do fi fi - # check for intel_gpu or rocpsdk component to determine if we need -lstdc++ in LDFLAGS - if (test "x$comp" = "xintel_gpu" || test "x$comp" = "xrocpsdk"); then + # check for intel_gpu or rocp_sdk component to determine if we need -lstdc++ in LDFLAGS + if (test "x$comp" = "xintel_gpu" || test "x$comp" = "xrocp_sdk"); then LDFLAGS="$LDFLAGS -lstdc++" fi From 1fb65d27d9f15f236658a822033d79e0e01620ed Mon Sep 17 00:00:00 2001 From: Anthony Danalis Date: Fri, 30 Aug 2024 20:14:57 +0000 Subject: [PATCH 4/4] Added Changelog and updated release notes. --- ChangeLogP720b1.txt | 1389 +++++++++++++++++++++++++++++++++++++++++++ RELEASENOTES.txt | 43 ++ 2 files changed, 1432 insertions(+) create mode 100644 ChangeLogP720b1.txt diff --git a/ChangeLogP720b1.txt b/ChangeLogP720b1.txt new file mode 100644 index 000000000..1076c8371 --- /dev/null +++ b/ChangeLogP720b1.txt @@ -0,0 +1,1389 @@ +2024-08-30 Anthony Danalis + + * src/components/rocp_sdk/Rules.rocp_sdk, + src/components/rocp_sdk/rocp_sdk.c, + src/components/rocp_sdk/sdk_class.cpp, + src/components/rocp_sdk/sdk_class.h, + src/components/rocp_sdk/sdk_class.hpp, + src/components/rocp_sdk/tests/Makefile, + src/components/rocp_sdk/tests/advanced.c, + src/components/rocp_sdk/tests/kernel.cpp, + src/components/rocp_sdk/tests/simple.c, src/configure, + src/configure.in: Beta support for AMD ROCprofiler-SDK events. + +Mon Jul 22 16:59:06 2024 +0900 jdeokkim + + * src/libpfm4/docs/man3/pfm_get_os_event_encoding.3, + .../docs/man3/pfm_get_perf_event_encoding.3, + src/libpfm4/docs/man3/pfm_initialize.3, + src/libpfm4/lib/events/arm_neoverse_n1_events.h, + src/libpfm4/lib/events/arm_neoverse_n2_events.h, + src/libpfm4/lib/events/arm_neoverse_v1_events.h, + src/libpfm4/lib/events/intel_spr_events.h, + src/libpfm4/lib/pfmlib_arm.c: Update libpfm4 Current with commit + 3abda5bc6c1af7f1b620dc594a806b3b5a4134cb Optimize pfm_detect() for + ARM processors Avoid calling pfmlib_getcpuinfo_attr() 3 times for + each ARM PMU to detect. For a given processor, the function will + always return the same information. Use the pfm_arm_cfg structure + as a cache on subsequent calls. Note: this overall logic does not + handle ARM hybrids right now. commit + b8b7d69e774c38618aa440f49d69814d109629f5 add L2D_CACHE and make + L2D_CACHE_ACCESS alias for ARM Neoverse N1,N2,V2 To match kernel + and documentation. Patch provides an alias to avoid breaking + existing scripts. commit 0d216ee4082aef2d8cabfa9816cdb6d6560d1d3f + update Intel SapphireRapids core PMU to 1.24 Updates the Intel + SapphireRapids core PMU event table to latest Intel released + version: Date : 07/18/2024 Version: 1.24" From + gitub.com/Intel/perfmon commit + 874ed7cff57271c5d4e530650eadce76e3dcaa14 Fix typos in + docs/man3/pfm_get_perf_event_encoding.3 commit + ffbfc5970897de87471e7cba64737dc13e2369cf Fix typos in + docs/man3/pfm_get_os_event_encoding.3 Note: The PAPI team does not + have access to a machine with ARM and ARM Neoverse to test building + PAPI with updated libpfm4 changes. Built PAPI successfully on a + machine with an Intel Sapphire Rapids (Intel(R) Xeon(R) Gold 6430) + CPU and output from papi_native_avail shows updated names and + descriptions. + +2024-08-02 Treece Burgess + + * src/components/rocm/roc_dispatch.c, + src/components/rocm/roc_dispatch.h, + src/components/rocm/roc_profiler.c, + src/components/rocm/roc_profiler.h, src/components/rocm/rocm.c: + Revert changes to ROCm component to only count the basename for + papi_component_avail. This will be the default choice for + components with qualifiers. + +2024-08-01 Treece Burgess + + * src/components/cuda/README.md: Updating format of export + LD_LIBRARY_PATH= in Cuda component README. + +2024-07-29 Heike Jagode + + * README.md: Updated license. + +2024-07-25 William Cohen + + * src/components/cuda/tests/Makefile: cuda: When making the cuda + tests do not assume nvcc on $PATH is one being used A check in the + Makefile for the cuda tests assumed the nvcc found on $PATH and the + one referred to by $(NVCC) were the same. It is possible to have + multiple versions of cuda installed on the system and the one being + used for $(NVCC) may not be the same as the one found on the + default path. Should always be use $(NVCC) in the Makefile to + ensure getting the same version of nvcc. + * src/components/cuda/linux-cuda.c: cuda: Eliminate -Werror=format- + security error in cuda_init_private() Using a "%s" format in the + sprintf to avoid the following error when compiling the cuda + component with -Werror=format-security : components/cuda/linux- + cuda.c: In function ‘cuda_init_private’: components/cuda/linux- + cuda.c:158:9: error: format not a string literal and no format + arguments [-Werror=format-security] 158 | + sprintf(_cuda_vector.cmp_info.disabled_reason, disabled_reason); | + ^~~~~~~ cc1: some warnings being treated as errors + +2024-07-24 Daniel Barry + + * src/papi_events.csv: add presets for Zen5 These changes include + all available preset events for the Zen4 architecture, and they + were validated using the Counter Analysis Toolkit. These changes + have been tested on the AMD Zen5 architecture. + +2024-07-16 Treece Burgess + + * src/components/cuda/papi_cupti_common.c, + src/components/cuda/papi_cupti_common.h: Adding papi_cupti_common.c + and papi_cupti_common.h + * src/components/cuda/Rules.cuda, src/components/cuda/cupti_common.c, + src/components/cuda/cupti_common.h, + src/components/cuda/cupti_dispatch.c, + src/components/cuda/cupti_events.c, + src/components/cuda/cupti_profiler.c: Renaming cupti_common.* to + papi_cupti_common.* to avoid file name collision with NVIDIA. Fixes + build issues in Cuda >= 12.4. + +2024-07-23 Heike Jagode + + * src/components/cuda/tests/Makefile: Fixed issue with building CUDA + tests when linked with shared PAPI library If CUDA tests are + linked with the PAPI shared library (via the configure option + --with-shlib-tools), the tests don't build because nvcc doesn't + accept the -Wl,-rpath linker option. To fix this issue, instead of + linking with nvcc, we can link with the PAPI-chosen C compiler via + the CC macro (or CXX macro for tests with C++ code). Additionally, + this PR cleans up other issues with tests (e.g., cudaOpenMP.cu and + cudaOpenMP_noCuCtx.cu) by removing redundant explicit compilations, + as the Makefile already includes a compilation rule. + +2024-07-09 Daniel Barry + + * src/components/rocm/roc_dispatch.c, + src/components/rocm/roc_dispatch.h, + src/components/rocm/roc_profiler.c, + src/components/rocm/roc_profiler.h, src/components/rocm/rocm.c: + rocm: fix event count to include qualifiers The event count + previously only counted basenames. This has been changed to + include all qualified event names. These changes have been tested + on the Frontier supercomputer (AMD MI250X GPU architecture) with + ROCm version 5.3.0. + +Wed Jul 3 23:50:15 2024 -0700 Swarup Sahoo + + * src/libpfm4/README, src/libpfm4/docs/Makefile, + src/libpfm4/docs/man3/libpfm_amd64_fam1ah_zen5.3, + .../docs/man3/libpfm_amd64_fam1ah_zen5_l3.3, + src/libpfm4/include/perfmon/pfmlib.h, src/libpfm4/lib/Makefile, + src/libpfm4/lib/events/amd64_events_fam1ah_zen5.h, + .../lib/events/amd64_events_fam1ah_zen5_l3.h, + src/libpfm4/lib/pfmlib_amd64.c, + src/libpfm4/lib/pfmlib_amd64_fam19h_l3.c, + src/libpfm4/lib/pfmlib_amd64_fam1ah.c, + src/libpfm4/lib/pfmlib_amd64_fam1ah_l3.c, + src/libpfm4/lib/pfmlib_amd64_priv.h, + src/libpfm4/lib/pfmlib_common.c, src/libpfm4/lib/pfmlib_priv.h, + src/libpfm4/tests/validate_x86.c: Update libpfm4 Current with + commit 18f2a3e0541cc438094bbf65ebbed2b6742bf0d4 Add AMD Zen5 L3 + PMU support This patch implements support for AMD Zen5 processor + L3 cache PMU. The implementation is based on "Performance Monitor + Counters for AMD Family A0h Model 00h- 0Fh Processors, rev 0.02", + available at - + https://www.amd.com/content/dam/amd/en/documents/epyc-technical- + docs/programmer-references/58550-0.01.pdf commit + e50b6a47c9f9f1386805bbce3d2a634782f8c30e Add AMD Zen5 core PMU + support This patch implements support for AMD Zen5 core PMU + support. The implementation is based on "Performance Monitor + Counters for AMD Family A0h Model 00h- 0Fh Processors, rev 0.02", + available at - + https://www.amd.com/content/dam/amd/en/documents/epyc-technical- + docs/programmer-references/58550-0.01.pdf Note: The PAPI team + does not have access to AMD Zen5 architecture to test additions as + of now. + +2024-06-07 Vince Weaver + + * src/papi_internal.c: papi_internal: don't segfault if event missing + from derived event definition this shouldn't be possible with a + correctly configured papi_event.csv but it is still good to be + robust here so that we don't segfault and also print useful debug + messages + +2024-06-03 Vince Weaver + + * src/components/perf_event/pe_libpfm4_events.c: + perf_event/libpfm4_events: add initial heterogenous CPU support + Alderlake and Raptorlake should now be able to properly enumerate + events for both Power and Efficiency cores on heterogeneous + systems. We're still testing if PAPI properly handles measurements + where applications end up running on both types of cores. The + detection of E-cores is currently a bit of a hack, we're going to + discuss with upstream libpfm4 to see if we can get a cleaner + interface for this. + * src/components/perf_event/pe_libpfm4_events.c: + perf_event/libpfm4_events: add some code comments to + _pe_libpfm4_init() this should not change the behavior of the + code, just adding some comments and whitespace to clear up what the + code is actually doing to prepare for improved heterogeneous CPU + support + +2024-06-16 William Cohen + + * src/Rules.perfctr, src/Rules.perfctr-pfm, + src/components/perfctr/Rules.perfctr, + src/components/perfctr/perfctr-x86.c, + src/components/perfctr/perfctr-x86.h, + src/components/perfctr/perfctr.c, + src/components/perfctr_ppc/Rules.perfctr_ppc, + src/components/perfctr_ppc/linux-ppc64.h, + src/components/perfctr_ppc/perfctr-ppc64.c, + src/components/perfctr_ppc/perfctr-ppc64.h, + src/components/perfctr_ppc/power5+_events.h, + src/components/perfctr_ppc/power5+_events_map.c, + src/components/perfctr_ppc/power5_events.h, + src/components/perfctr_ppc/power5_events_map.c, + src/components/perfctr_ppc/power6_events.h, + src/components/perfctr_ppc/power6_events_map.c, + src/components/perfctr_ppc/power7_events.h, + src/components/perfctr_ppc/ppc64_events.c, + src/components/perfctr_ppc/ppc64_events.h, + src/components/perfctr_ppc/ppc970_events.h, + src/components/perfctr_ppc/ppc970_events_map.c, src/configure, + src/configure.in, src/libpfm-3.y/COPYRIGHT, + src/libpfm-3.y/ChangeLog, src/libpfm-3.y/Makefile, + src/libpfm-3.y/README, src/libpfm-3.y/TODO, + src/libpfm-3.y/config.mk, src/libpfm-3.y/docs/Makefile, + src/libpfm-3.y/docs/man3/libpfm.3, + src/libpfm-3.y/docs/man3/libpfm_amd64.3, + src/libpfm-3.y/docs/man3/libpfm_atom.3, + src/libpfm-3.y/docs/man3/libpfm_core.3, + src/libpfm-3.y/docs/man3/libpfm_itanium.3, + src/libpfm-3.y/docs/man3/libpfm_itanium2.3, + src/libpfm-3.y/docs/man3/libpfm_montecito.3, + src/libpfm-3.y/docs/man3/libpfm_nehalem.3, + src/libpfm-3.y/docs/man3/libpfm_p6.3, + src/libpfm-3.y/docs/man3/libpfm_powerpc.3, + src/libpfm-3.y/docs/man3/libpfm_westmere.3, + src/libpfm-3.y/docs/man3/pfm_dispatch_events.3, + src/libpfm-3.y/docs/man3/pfm_find_event.3, + src/libpfm-3.y/docs/man3/pfm_find_event_bycode.3, + .../docs/man3/pfm_find_event_bycode_next.3, + src/libpfm-3.y/docs/man3/pfm_find_event_mask.3, + src/libpfm-3.y/docs/man3/pfm_find_full_event.3, + src/libpfm-3.y/docs/man3/pfm_force_pmu.3, + src/libpfm-3.y/docs/man3/pfm_get_cycle_event.3, + src/libpfm-3.y/docs/man3/pfm_get_event_code.3, + .../docs/man3/pfm_get_event_code_counter.3, + src/libpfm-3.y/docs/man3/pfm_get_event_counters.3, + .../docs/man3/pfm_get_event_description.3, + src/libpfm-3.y/docs/man3/pfm_get_event_mask_code.3, + .../docs/man3/pfm_get_event_mask_description.3, + src/libpfm-3.y/docs/man3/pfm_get_event_mask_name.3, + src/libpfm-3.y/docs/man3/pfm_get_event_name.3, + src/libpfm-3.y/docs/man3/pfm_get_full_event_name.3, + .../docs/man3/pfm_get_hw_counter_width.3, + src/libpfm-3.y/docs/man3/pfm_get_impl_counters.3, + src/libpfm-3.y/docs/man3/pfm_get_impl_pmcs.3, + src/libpfm-3.y/docs/man3/pfm_get_impl_pmds.3, + src/libpfm-3.y/docs/man3/pfm_get_inst_retired.3, + .../docs/man3/pfm_get_max_event_name_len.3, + src/libpfm-3.y/docs/man3/pfm_get_num_counters.3, + src/libpfm-3.y/docs/man3/pfm_get_num_events.3, + src/libpfm-3.y/docs/man3/pfm_get_num_pmcs.3, + src/libpfm-3.y/docs/man3/pfm_get_num_pmds.3, + src/libpfm-3.y/docs/man3/pfm_get_pmu_name.3, + src/libpfm-3.y/docs/man3/pfm_get_pmu_name_bytype.3, + src/libpfm-3.y/docs/man3/pfm_get_pmu_type.3, + src/libpfm-3.y/docs/man3/pfm_get_version.3, + src/libpfm-3.y/docs/man3/pfm_initialize.3, + src/libpfm-3.y/docs/man3/pfm_list_supported_pmus.3, + src/libpfm-3.y/docs/man3/pfm_pmu_is_supported.3, + src/libpfm-3.y/docs/man3/pfm_regmask_and.3, + src/libpfm-3.y/docs/man3/pfm_regmask_clr.3, + src/libpfm-3.y/docs/man3/pfm_regmask_copy.3, + src/libpfm-3.y/docs/man3/pfm_regmask_eq.3, + src/libpfm-3.y/docs/man3/pfm_regmask_isset.3, + src/libpfm-3.y/docs/man3/pfm_regmask_or.3, + src/libpfm-3.y/docs/man3/pfm_regmask_set.3, + src/libpfm-3.y/docs/man3/pfm_regmask_weight.3, + src/libpfm-3.y/docs/man3/pfm_set_options.3, + src/libpfm-3.y/docs/man3/pfm_strerror.3, + src/libpfm-3.y/examples_ia64_v2.0/Makefile, + src/libpfm-3.y/examples_ia64_v2.0/ita2_btb.c, + src/libpfm-3.y/examples_ia64_v2.0/ita2_dear.c, + src/libpfm-3.y/examples_ia64_v2.0/ita2_irr.c, + src/libpfm-3.y/examples_ia64_v2.0/ita2_opcode.c, + src/libpfm-3.y/examples_ia64_v2.0/ita2_rr.c, + src/libpfm-3.y/examples_ia64_v2.0/ita_btb.c, + src/libpfm-3.y/examples_ia64_v2.0/ita_dear.c, + src/libpfm-3.y/examples_ia64_v2.0/ita_irr.c, + src/libpfm-3.y/examples_ia64_v2.0/ita_opcode.c, + src/libpfm-3.y/examples_ia64_v2.0/ita_rr.c, + src/libpfm-3.y/examples_ia64_v2.0/mont_dear.c, + src/libpfm-3.y/examples_ia64_v2.0/mont_etb.c, + src/libpfm-3.y/examples_ia64_v2.0/mont_irr.c, + src/libpfm-3.y/examples_ia64_v2.0/mont_opcode.c, + src/libpfm-3.y/examples_ia64_v2.0/mont_rr.c, + src/libpfm-3.y/examples_ia64_v2.0/multiplex.c, + src/libpfm-3.y/examples_ia64_v2.0/notify_self.c, + src/libpfm-3.y/examples_ia64_v2.0/notify_self2.c, + src/libpfm-3.y/examples_ia64_v2.0/notify_self3.c, + .../examples_ia64_v2.0/notify_self_fork.c, + src/libpfm-3.y/examples_ia64_v2.0/self.c, + src/libpfm-3.y/examples_ia64_v2.0/showreset.c, + src/libpfm-3.y/examples_ia64_v2.0/syst.c, + src/libpfm-3.y/examples_ia64_v2.0/task.c, + src/libpfm-3.y/examples_ia64_v2.0/task_attach.c, + .../examples_ia64_v2.0/task_attach_timeout.c, + src/libpfm-3.y/examples_ia64_v2.0/task_smpl.c, + src/libpfm-3.y/examples_ia64_v2.0/whichpmu.c, + src/libpfm-3.y/examples_v2.x/Makefile, + src/libpfm-3.y/examples_v2.x/check_events.c, + src/libpfm-3.y/examples_v2.x/detect_pmcs.c, + src/libpfm-3.y/examples_v2.x/detect_pmcs.h, + src/libpfm-3.y/examples_v2.x/ia64/Makefile, + src/libpfm-3.y/examples_v2.x/ia64/ita2_btb.c, + src/libpfm-3.y/examples_v2.x/ia64/ita2_dear.c, + src/libpfm-3.y/examples_v2.x/ia64/ita2_irr.c, + src/libpfm-3.y/examples_v2.x/ia64/ita2_opcode.c, + src/libpfm-3.y/examples_v2.x/ia64/ita2_rr.c, + src/libpfm-3.y/examples_v2.x/ia64/ita_btb.c, + src/libpfm-3.y/examples_v2.x/ia64/ita_dear.c, + src/libpfm-3.y/examples_v2.x/ia64/ita_irr.c, + src/libpfm-3.y/examples_v2.x/ia64/ita_opcode.c, + src/libpfm-3.y/examples_v2.x/ia64/ita_rr.c, + src/libpfm-3.y/examples_v2.x/ia64/mont_dear.c, + src/libpfm-3.y/examples_v2.x/ia64/mont_etb.c, + src/libpfm-3.y/examples_v2.x/ia64/mont_irr.c, + src/libpfm-3.y/examples_v2.x/ia64/mont_opcode.c, + src/libpfm-3.y/examples_v2.x/ia64/mont_rr.c, + src/libpfm-3.y/examples_v2.x/multiplex.c, + src/libpfm-3.y/examples_v2.x/multiplex2.c, + src/libpfm-3.y/examples_v2.x/notify_self.c, + src/libpfm-3.y/examples_v2.x/notify_self2.c, + src/libpfm-3.y/examples_v2.x/notify_self3.c, + src/libpfm-3.y/examples_v2.x/notify_self_fork.c, + src/libpfm-3.y/examples_v2.x/pfmsetup.c, + src/libpfm-3.y/examples_v2.x/rtop.c, + src/libpfm-3.y/examples_v2.x/self.c, + src/libpfm-3.y/examples_v2.x/self_pipe.c, + src/libpfm-3.y/examples_v2.x/self_smpl.c, + src/libpfm-3.y/examples_v2.x/self_smpl_multi.c, + src/libpfm-3.y/examples_v2.x/self_view.c, + src/libpfm-3.y/examples_v2.x/set_notify.c, + src/libpfm-3.y/examples_v2.x/showevtinfo.c, + src/libpfm-3.y/examples_v2.x/showreginfo.c, + src/libpfm-3.y/examples_v2.x/syst.c, + src/libpfm-3.y/examples_v2.x/syst_multi_np.c, + src/libpfm-3.y/examples_v2.x/syst_np.c, + src/libpfm-3.y/examples_v2.x/task.c, + src/libpfm-3.y/examples_v2.x/task_attach.c, + src/libpfm-3.y/examples_v2.x/task_attach_timeout.c, + .../examples_v2.x/task_attach_timeout_np.c, + src/libpfm-3.y/examples_v2.x/task_smpl.c, + src/libpfm-3.y/examples_v2.x/task_smpl_user.c, + src/libpfm-3.y/examples_v2.x/whichpmu.c, + src/libpfm-3.y/examples_v2.x/x86/Makefile, + src/libpfm-3.y/examples_v2.x/x86/smpl_amd64_ibs.c, + src/libpfm-3.y/examples_v2.x/x86/smpl_core_pebs.c, + src/libpfm-3.y/examples_v2.x/x86/smpl_nhm_lbr.c, + src/libpfm-3.y/examples_v2.x/x86/smpl_p4_pebs.c, + src/libpfm-3.y/examples_v2.x/x86/smpl_pebs.c, + src/libpfm-3.y/examples_v3.x/Makefile, + src/libpfm-3.y/examples_v3.x/check_events.c, + src/libpfm-3.y/examples_v3.x/detect_pmcs.c, + src/libpfm-3.y/examples_v3.x/detect_pmcs.h, + src/libpfm-3.y/examples_v3.x/ia64/Makefile, + src/libpfm-3.y/examples_v3.x/ia64/ita2_btb.c, + src/libpfm-3.y/examples_v3.x/ia64/ita2_dear.c, + src/libpfm-3.y/examples_v3.x/ia64/ita2_irr.c, + src/libpfm-3.y/examples_v3.x/ia64/ita2_opcode.c, + src/libpfm-3.y/examples_v3.x/ia64/ita2_rr.c, + src/libpfm-3.y/examples_v3.x/ia64/ita_btb.c, + src/libpfm-3.y/examples_v3.x/ia64/ita_dear.c, + src/libpfm-3.y/examples_v3.x/ia64/ita_irr.c, + src/libpfm-3.y/examples_v3.x/ia64/ita_opcode.c, + src/libpfm-3.y/examples_v3.x/ia64/ita_rr.c, + src/libpfm-3.y/examples_v3.x/ia64/mont_dear.c, + src/libpfm-3.y/examples_v3.x/ia64/mont_etb.c, + src/libpfm-3.y/examples_v3.x/ia64/mont_irr.c, + src/libpfm-3.y/examples_v3.x/ia64/mont_opcode.c, + src/libpfm-3.y/examples_v3.x/ia64/mont_rr.c, + src/libpfm-3.y/examples_v3.x/multiplex.c, + src/libpfm-3.y/examples_v3.x/multiplex2.c, + src/libpfm-3.y/examples_v3.x/notify_self.c, + src/libpfm-3.y/examples_v3.x/notify_self2.c, + src/libpfm-3.y/examples_v3.x/notify_self3.c, + src/libpfm-3.y/examples_v3.x/notify_self_fork.c, + src/libpfm-3.y/examples_v3.x/pfmsetup.c, + src/libpfm-3.y/examples_v3.x/rtop.c, + src/libpfm-3.y/examples_v3.x/self.c, + src/libpfm-3.y/examples_v3.x/self_pipe.c, + src/libpfm-3.y/examples_v3.x/self_smpl_multi.c, + src/libpfm-3.y/examples_v3.x/set_notify.c, + src/libpfm-3.y/examples_v3.x/showevtinfo.c, + src/libpfm-3.y/examples_v3.x/showreginfo.c, + src/libpfm-3.y/examples_v3.x/syst.c, + src/libpfm-3.y/examples_v3.x/task.c, + src/libpfm-3.y/examples_v3.x/task_attach.c, + src/libpfm-3.y/examples_v3.x/task_attach_timeout.c, + src/libpfm-3.y/examples_v3.x/task_smpl.c, + src/libpfm-3.y/examples_v3.x/task_smpl_user.c, + src/libpfm-3.y/examples_v3.x/whichpmu.c, + src/libpfm-3.y/examples_v3.x/x86/Makefile, + src/libpfm-3.y/examples_v3.x/x86/smpl_amd64_ibs.c, + src/libpfm-3.y/examples_v3.x/x86/smpl_core_pebs.c, + .../examples_v3.x/x86/smpl_core_pebs_sys.c, + src/libpfm-3.y/examples_v3.x/x86/smpl_p4_pebs.c, + src/libpfm-3.y/include/Makefile, + src/libpfm-3.y/include/perfmon/perfmon.h, + src/libpfm-3.y/include/perfmon/perfmon_compat.h, + src/libpfm-3.y/include/perfmon/perfmon_crayx2.h, + .../include/perfmon/perfmon_default_smpl.h, + src/libpfm-3.y/include/perfmon/perfmon_dfl_smpl.h, + src/libpfm-3.y/include/perfmon/perfmon_i386.h, + src/libpfm-3.y/include/perfmon/perfmon_ia64.h, + src/libpfm-3.y/include/perfmon/perfmon_mips64.h, + .../include/perfmon/perfmon_pebs_core_smpl.h, + .../include/perfmon/perfmon_pebs_p4_smpl.h, + src/libpfm-3.y/include/perfmon/perfmon_pebs_smpl.h, + src/libpfm-3.y/include/perfmon/perfmon_powerpc.h, + src/libpfm-3.y/include/perfmon/perfmon_sparc.h, + src/libpfm-3.y/include/perfmon/perfmon_v2.h, + src/libpfm-3.y/include/perfmon/perfmon_x86_64.h, + src/libpfm-3.y/include/perfmon/pfmlib.h, + src/libpfm-3.y/include/perfmon/pfmlib_amd64.h, + src/libpfm-3.y/include/perfmon/pfmlib_cell.h, + src/libpfm-3.y/include/perfmon/pfmlib_comp.h, + .../include/perfmon/pfmlib_comp_crayx2.h, + src/libpfm-3.y/include/perfmon/pfmlib_comp_i386.h, + src/libpfm-3.y/include/perfmon/pfmlib_comp_ia64.h, + .../include/perfmon/pfmlib_comp_mips64.h, + .../include/perfmon/pfmlib_comp_powerpc.h, + src/libpfm-3.y/include/perfmon/pfmlib_comp_sparc.h, + .../include/perfmon/pfmlib_comp_x86_64.h, + src/libpfm-3.y/include/perfmon/pfmlib_core.h, + src/libpfm-3.y/include/perfmon/pfmlib_coreduo.h, + src/libpfm-3.y/include/perfmon/pfmlib_crayx2.h, + src/libpfm-3.y/include/perfmon/pfmlib_gen_ia32.h, + src/libpfm-3.y/include/perfmon/pfmlib_gen_ia64.h, + src/libpfm-3.y/include/perfmon/pfmlib_gen_mips64.h, + src/libpfm-3.y/include/perfmon/pfmlib_i386_p6.h, + src/libpfm-3.y/include/perfmon/pfmlib_intel_atom.h, + src/libpfm-3.y/include/perfmon/pfmlib_intel_nhm.h, + src/libpfm-3.y/include/perfmon/pfmlib_itanium.h, + src/libpfm-3.y/include/perfmon/pfmlib_itanium2.h, + src/libpfm-3.y/include/perfmon/pfmlib_montecito.h, + src/libpfm-3.y/include/perfmon/pfmlib_os.h, + src/libpfm-3.y/include/perfmon/pfmlib_os_crayx2.h, + src/libpfm-3.y/include/perfmon/pfmlib_os_i386.h, + src/libpfm-3.y/include/perfmon/pfmlib_os_ia64.h, + src/libpfm-3.y/include/perfmon/pfmlib_os_mips64.h, + src/libpfm-3.y/include/perfmon/pfmlib_os_powerpc.h, + src/libpfm-3.y/include/perfmon/pfmlib_os_sparc.h, + src/libpfm-3.y/include/perfmon/pfmlib_os_x86_64.h, + src/libpfm-3.y/include/perfmon/pfmlib_pentium4.h, + src/libpfm-3.y/include/perfmon/pfmlib_powerpc.h, + src/libpfm-3.y/include/perfmon/pfmlib_sicortex.h, + src/libpfm-3.y/include/perfmon/pfmlib_sparc.h, + src/libpfm-3.y/lib/Makefile, src/libpfm-3.y/lib/amd64_events.h, + src/libpfm-3.y/lib/amd64_events_fam10h.h, + src/libpfm-3.y/lib/amd64_events_fam15h.h, + src/libpfm-3.y/lib/amd64_events_k7.h, + src/libpfm-3.y/lib/amd64_events_k8.h, + src/libpfm-3.y/lib/cell_events.h, src/libpfm-3.y/lib/core_events.h, + src/libpfm-3.y/lib/coreduo_events.h, + src/libpfm-3.y/lib/crayx2_events.h, + src/libpfm-3.y/lib/gen_ia32_events.h, + src/libpfm-3.y/lib/gen_mips64_events.h, + src/libpfm-3.y/lib/i386_p6_events.h, + src/libpfm-3.y/lib/intel_atom_events.h, + src/libpfm-3.y/lib/intel_corei7_events.h, + src/libpfm-3.y/lib/intel_corei7_unc_events.h, + src/libpfm-3.y/lib/intel_wsm_events.h, + src/libpfm-3.y/lib/intel_wsm_unc_events.h, + src/libpfm-3.y/lib/itanium2_events.h, + src/libpfm-3.y/lib/itanium_events.h, + src/libpfm-3.y/lib/montecito_events.h, + src/libpfm-3.y/lib/niagara1_events.h, + src/libpfm-3.y/lib/niagara2_events.h, + src/libpfm-3.y/lib/pentium4_events.h, + src/libpfm-3.y/lib/pfmlib_amd64.c, + src/libpfm-3.y/lib/pfmlib_amd64_priv.h, + src/libpfm-3.y/lib/pfmlib_cell.c, + src/libpfm-3.y/lib/pfmlib_cell_priv.h, + src/libpfm-3.y/lib/pfmlib_common.c, + src/libpfm-3.y/lib/pfmlib_core.c, + src/libpfm-3.y/lib/pfmlib_core_priv.h, + src/libpfm-3.y/lib/pfmlib_coreduo.c, + src/libpfm-3.y/lib/pfmlib_coreduo_priv.h, + src/libpfm-3.y/lib/pfmlib_crayx2.c, + src/libpfm-3.y/lib/pfmlib_crayx2_priv.h, + src/libpfm-3.y/lib/pfmlib_gen_ia32.c, + src/libpfm-3.y/lib/pfmlib_gen_ia32_priv.h, + src/libpfm-3.y/lib/pfmlib_gen_ia64.c, + src/libpfm-3.y/lib/pfmlib_gen_mips64.c, + src/libpfm-3.y/lib/pfmlib_gen_mips64_priv.h, + src/libpfm-3.y/lib/pfmlib_gen_powerpc.c, + src/libpfm-3.y/lib/pfmlib_i386_p6.c, + src/libpfm-3.y/lib/pfmlib_i386_p6_priv.h, + src/libpfm-3.y/lib/pfmlib_intel_atom.c, + src/libpfm-3.y/lib/pfmlib_intel_atom_priv.h, + src/libpfm-3.y/lib/pfmlib_intel_nhm.c, + src/libpfm-3.y/lib/pfmlib_intel_nhm_priv.h, + src/libpfm-3.y/lib/pfmlib_itanium.c, + src/libpfm-3.y/lib/pfmlib_itanium2.c, + src/libpfm-3.y/lib/pfmlib_itanium2_priv.h, + src/libpfm-3.y/lib/pfmlib_itanium_priv.h, + src/libpfm-3.y/lib/pfmlib_montecito.c, + src/libpfm-3.y/lib/pfmlib_montecito_priv.h, + src/libpfm-3.y/lib/pfmlib_os_linux.c, + src/libpfm-3.y/lib/pfmlib_os_linux_v2.c, + src/libpfm-3.y/lib/pfmlib_os_linux_v3.c, + src/libpfm-3.y/lib/pfmlib_os_macos.c, + src/libpfm-3.y/lib/pfmlib_pentium4.c, + src/libpfm-3.y/lib/pfmlib_pentium4_priv.h, + src/libpfm-3.y/lib/pfmlib_power4_priv.h, + src/libpfm-3.y/lib/pfmlib_power5+_priv.h, + src/libpfm-3.y/lib/pfmlib_power5_priv.h, + src/libpfm-3.y/lib/pfmlib_power6_priv.h, + src/libpfm-3.y/lib/pfmlib_power7_priv.h, + src/libpfm-3.y/lib/pfmlib_power_priv.h, + src/libpfm-3.y/lib/pfmlib_powerpc_priv.h, + src/libpfm-3.y/lib/pfmlib_ppc970_priv.h, + src/libpfm-3.y/lib/pfmlib_ppc970mp_priv.h, + src/libpfm-3.y/lib/pfmlib_priv.c, src/libpfm-3.y/lib/pfmlib_priv.h, + src/libpfm-3.y/lib/pfmlib_priv_comp.h, + src/libpfm-3.y/lib/pfmlib_priv_comp_ia64.h, + src/libpfm-3.y/lib/pfmlib_priv_ia64.h, + src/libpfm-3.y/lib/pfmlib_sicortex.c, + src/libpfm-3.y/lib/pfmlib_sicortex_priv.h, + src/libpfm-3.y/lib/pfmlib_sparc.c, + src/libpfm-3.y/lib/pfmlib_sparc_priv.h, + src/libpfm-3.y/lib/power4_events.h, + src/libpfm-3.y/lib/power5+_events.h, + src/libpfm-3.y/lib/power5_events.h, + src/libpfm-3.y/lib/power6_events.h, + src/libpfm-3.y/lib/power7_events.h, + src/libpfm-3.y/lib/powerpc_events.h, + src/libpfm-3.y/lib/powerpc_reg.h, + src/libpfm-3.y/lib/ppc970_events.h, + src/libpfm-3.y/lib/ppc970mp_events.h, + src/libpfm-3.y/lib/ultra12_events.h, + src/libpfm-3.y/lib/ultra3_events.h, + src/libpfm-3.y/lib/ultra3i_events.h, + src/libpfm-3.y/lib/ultra3plus_events.h, + src/libpfm-3.y/lib/ultra4plus_events.h, + src/libpfm-3.y/libpfms/Makefile, + src/libpfm-3.y/libpfms/include/libpfms.h, + src/libpfm-3.y/libpfms/lib/Makefile, + src/libpfm-3.y/libpfms/lib/libpfms.c, + src/libpfm-3.y/libpfms/syst_smp.c, src/libpfm-3.y/python/Makefile, + src/libpfm-3.y/python/README, src/libpfm-3.y/python/self.py, + src/libpfm-3.y/python/setup.py, + src/libpfm-3.y/python/src/__init__.py, + src/libpfm-3.y/python/src/perfmon_int.i, + src/libpfm-3.y/python/src/pmu.py, + src/libpfm-3.y/python/src/session.py, src/libpfm-3.y/python/sys.py, + src/libpfm-3.y/rules.mk, src/perfctr-2.6.x/CHANGES, + src/perfctr-2.6.x/COPYING, src/perfctr-2.6.x/INSTALL, + src/perfctr-2.6.x/Makefile, src/perfctr-2.6.x/OTHER, + src/perfctr-2.6.x/README, src/perfctr-2.6.x/TODO, + src/perfctr-2.6.x/etc/Makefile, + src/perfctr-2.6.x/etc/costs/Athlon-1.2, + src/perfctr-2.6.x/etc/costs/Athlon-1.46, + src/perfctr-2.6.x/etc/costs/Athlon-1.66, + src/perfctr-2.6.x/etc/costs/Athlon-1000, + src/perfctr-2.6.x/etc/costs/Athlon-500, + src/perfctr-2.6.x/etc/costs/Athlon-700, + src/perfctr-2.6.x/etc/costs/Athlon-850, + src/perfctr-2.6.x/etc/costs/Athlon64-2.0, + src/perfctr-2.6.x/etc/costs/Core-i7-920-2.66, + src/perfctr-2.6.x/etc/costs/Core2-2.4, + src/perfctr-2.6.x/etc/costs/Core2-E8400-3.0, + src/perfctr-2.6.x/etc/costs/Duron-750, + src/perfctr-2.6.x/etc/costs/K6-III-400, + src/perfctr-2.6.x/etc/costs/MPC7400-400, + src/perfctr-2.6.x/etc/costs/MPC7447A-1.25, + src/perfctr-2.6.x/etc/costs/MPC7455-1.0, + src/perfctr-2.6.x/etc/costs/Opteron-1.4, + src/perfctr-2.6.x/etc/costs/Opteron-2.4, + src/perfctr-2.6.x/etc/costs/Opteron-2352-2.1, + src/perfctr-2.6.x/etc/costs/Opteron-8354-2.2, + src/perfctr-2.6.x/etc/costs/Opteron-8384-2.7, + src/perfctr-2.6.x/etc/costs/PPC750-300, + src/perfctr-2.6.x/etc/costs/Pentium-133, + src/perfctr-2.6.x/etc/costs/Pentium4-1.5, + src/perfctr-2.6.x/etc/costs/Pentium4-1.6, + src/perfctr-2.6.x/etc/costs/Pentium4-1.7, + src/perfctr-2.6.x/etc/costs/Pentium4-2.0, + src/perfctr-2.6.x/etc/costs/Pentium4-2.26, + src/perfctr-2.6.x/etc/costs/Pentium4-3.0, + src/perfctr-2.6.x/etc/costs/Pentium4Xeon-2.2, + src/perfctr-2.6.x/etc/costs/Pentium4Xeon-2.4, + src/perfctr-2.6.x/etc/costs/Pentium4Xeon-2.8, + src/perfctr-2.6.x/etc/costs/Pentium4Xeon-3.0, + src/perfctr-2.6.x/etc/costs/PentiumII-266a, + src/perfctr-2.6.x/etc/costs/PentiumII-266b, + src/perfctr-2.6.x/etc/costs/PentiumII-300, + src/perfctr-2.6.x/etc/costs/PentiumII-350, + src/perfctr-2.6.x/etc/costs/PentiumIII-1.0, + src/perfctr-2.6.x/etc/costs/PentiumIII-1.4, + src/perfctr-2.6.x/etc/costs/PentiumIII-450, + src/perfctr-2.6.x/etc/costs/PentiumIII-800, + src/perfctr-2.6.x/etc/costs/PentiumIII-933, + src/perfctr-2.6.x/etc/costs/PentiumIIIXeon-700, + src/perfctr-2.6.x/etc/costs/PentiumM-2.0, + src/perfctr-2.6.x/etc/costs/PentiumMMX-166, + src/perfctr-2.6.x/etc/costs/PentiumMMX-233, + src/perfctr-2.6.x/etc/costs/PentiumPro-200, + src/perfctr-2.6.x/etc/install.sh, src/perfctr-2.6.x/etc/p4.c, + src/perfctr-2.6.x/etc/perfctr.rc, + src/perfctr-2.6.x/etc/perfctr.rules, + src/perfctr-2.6.x/examples/Makefile, + src/perfctr-2.6.x/examples/README, + src/perfctr-2.6.x/examples/global/Makefile, + src/perfctr-2.6.x/examples/global/arch.h, + src/perfctr-2.6.x/examples/global/arm.c, + src/perfctr-2.6.x/examples/global/global.c, + src/perfctr-2.6.x/examples/global/ppc.c, + src/perfctr-2.6.x/examples/global/x86.c, + src/perfctr-2.6.x/examples/perfex/Makefile, + src/perfctr-2.6.x/examples/perfex/arch.h, + src/perfctr-2.6.x/examples/perfex/arm.c, + src/perfctr-2.6.x/examples/perfex/arm.h, + src/perfctr-2.6.x/examples/perfex/perfex.c, + src/perfctr-2.6.x/examples/perfex/ppc.c, + src/perfctr-2.6.x/examples/perfex/ppc.h, + src/perfctr-2.6.x/examples/perfex/x86.c, + src/perfctr-2.6.x/examples/perfex/x86.h, + src/perfctr-2.6.x/examples/self/Makefile, + src/perfctr-2.6.x/examples/self/arch.h, + src/perfctr-2.6.x/examples/self/arm.c, + src/perfctr-2.6.x/examples/self/ppc.c, + src/perfctr-2.6.x/examples/self/self.c, + src/perfctr-2.6.x/examples/self/x86.c, + src/perfctr-2.6.x/examples/signal/Makefile, + src/perfctr-2.6.x/examples/signal/arch.h, + src/perfctr-2.6.x/examples/signal/ppc.c, + src/perfctr-2.6.x/examples/signal/signal.c, + src/perfctr-2.6.x/examples/signal/x86.c, + src/perfctr-2.6.x/linux/drivers/perfctr/Kconfig, + src/perfctr-2.6.x/linux/drivers/perfctr/Makefile, + .../linux/drivers/perfctr/RELEASE-NOTES, + src/perfctr-2.6.x/linux/drivers/perfctr/arm.c, + .../linux/drivers/perfctr/arm_setup.c, + src/perfctr-2.6.x/linux/drivers/perfctr/compat.h, + src/perfctr-2.6.x/linux/drivers/perfctr/cpumask.h, + src/perfctr-2.6.x/linux/drivers/perfctr/global.c, + src/perfctr-2.6.x/linux/drivers/perfctr/global.h, + src/perfctr-2.6.x/linux/drivers/perfctr/init.c, + src/perfctr-2.6.x/linux/drivers/perfctr/marshal.c, + src/perfctr-2.6.x/linux/drivers/perfctr/marshal.h, + src/perfctr-2.6.x/linux/drivers/perfctr/ppc.c, + .../linux/drivers/perfctr/ppc_compat.h, + .../linux/drivers/perfctr/ppc_setup.c, + .../linux/drivers/perfctr/ppc_tests.c, + .../linux/drivers/perfctr/ppc_tests.h, + src/perfctr-2.6.x/linux/drivers/perfctr/version.h, + src/perfctr-2.6.x/linux/drivers/perfctr/virtual.c, + src/perfctr-2.6.x/linux/drivers/perfctr/virtual.h, + .../linux/drivers/perfctr/virtual_stub.c, + src/perfctr-2.6.x/linux/drivers/perfctr/x86.c, + .../linux/drivers/perfctr/x86_compat.h, + .../linux/drivers/perfctr/x86_setup.c, + .../linux/drivers/perfctr/x86_tests.c, + .../linux/drivers/perfctr/x86_tests.h, + src/perfctr-2.6.x/linux/include/asm-arm/perfctr.h, + src/perfctr-2.6.x/linux/include/asm-i386/perfctr.h, + .../linux/include/asm-powerpc/perfctr.h, + src/perfctr-2.6.x/linux/include/asm-ppc/perfctr.h, + src/perfctr-2.6.x/linux/include/asm-x86/perfctr.h, + .../linux/include/asm-x86_64/perfctr.h, + src/perfctr-2.6.x/linux/include/linux/perfctr.h, + src/perfctr-2.6.x/patches/aliases, src/perfctr-2.6.x/patches/patch- + kernel-2.6.10, src/perfctr-2.6.x/patches/patch-kernel-2.6.11, + src/perfctr-2.6.x/patches/patch-kernel-2.6.12, + src/perfctr-2.6.x/patches/patch-kernel-2.6.13, + src/perfctr-2.6.x/patches/patch-kernel-2.6.14, + src/perfctr-2.6.x/patches/patch-kernel-2.6.15, + src/perfctr-2.6.x/patches/patch-kernel-2.6.16, .../patches/patch- + kernel-2.6.16.46-0.12-suse, src/perfctr-2.6.x/patches/patch- + kernel-2.6.17, src/perfctr-2.6.x/patches/patch-kernel-2.6.18, + .../patches/patch-kernel-2.6.18-128.el5-redhat, .../patches/patch- + kernel-2.6.18-164.el5-redhat, .../patches/patch- + kernel-2.6.18-194.el5-redhat, .../patches/patch- + kernel-2.6.18-53.el5-redhat, .../patches/patch- + kernel-2.6.18-8.1.1.el5-redhat, .../patches/patch- + kernel-2.6.18-92.el5-redhat, src/perfctr-2.6.x/patches/patch- + kernel-2.6.19, src/perfctr-2.6.x/patches/patch-kernel-2.6.20, + src/perfctr-2.6.x/patches/patch-kernel-2.6.21, + src/perfctr-2.6.x/patches/patch-kernel-2.6.22, + src/perfctr-2.6.x/patches/patch-kernel-2.6.23, + src/perfctr-2.6.x/patches/patch-kernel-2.6.24, + src/perfctr-2.6.x/patches/patch-kernel-2.6.25, + src/perfctr-2.6.x/patches/patch-kernel-2.6.26, + src/perfctr-2.6.x/patches/patch-kernel-2.6.27, + src/perfctr-2.6.x/patches/patch-kernel-2.6.28, + src/perfctr-2.6.x/patches/patch-kernel-2.6.29, + src/perfctr-2.6.x/patches/patch-kernel-2.6.30, + src/perfctr-2.6.x/patches/patch-kernel-2.6.31, + src/perfctr-2.6.x/patches/patch-kernel-2.6.32, + src/perfctr-2.6.x/patches/patch-kernel-2.6.5, .../patches/patch- + kernel-2.6.5-7.276-suse, src/perfctr-2.6.x/patches/patch- + kernel-2.6.6, src/perfctr-2.6.x/patches/patch-kernel-2.6.7, + src/perfctr-2.6.x/patches/patch-kernel-2.6.8.1, + src/perfctr-2.6.x/patches/patch-kernel-2.6.9, .../patches/patch- + kernel-2.6.9-55.EL-redhat, .../patches/patch-kernel-2.6.9-67.EL- + redhat, .../patches/patch-kernel-2.6.9-78.EL-redhat, + .../patches/patch-kernel-2.6.9-89.EL-redhat, + src/perfctr-2.6.x/perfctr.spec, src/perfctr-2.6.x/update-kernel, + src/perfctr-2.6.x/usr.lib/Makefile, + src/perfctr-2.6.x/usr.lib/arch.h, src/perfctr-2.6.x/usr.lib/arm.c, + src/perfctr-2.6.x/usr.lib/arm.h, + src/perfctr-2.6.x/usr.lib/event_set.h, + src/perfctr-2.6.x/usr.lib/event_set_amd.c, + src/perfctr-2.6.x/usr.lib/event_set_arm.c, + src/perfctr-2.6.x/usr.lib/event_set_centaur.c, + src/perfctr-2.6.x/usr.lib/event_set_p4.c, + src/perfctr-2.6.x/usr.lib/event_set_p5.c, + src/perfctr-2.6.x/usr.lib/event_set_p6.c, + src/perfctr-2.6.x/usr.lib/event_set_ppc.c, + src/perfctr-2.6.x/usr.lib/event_set_x86.c, + src/perfctr-2.6.x/usr.lib/gen-event-codes.c, + src/perfctr-2.6.x/usr.lib/global.c, + src/perfctr-2.6.x/usr.lib/libperfctr.h, + src/perfctr-2.6.x/usr.lib/misc.c, src/perfctr-2.6.x/usr.lib/ppc.c, + src/perfctr-2.6.x/usr.lib/ppc.h, + src/perfctr-2.6.x/usr.lib/virtual.c, + src/perfctr-2.6.x/usr.lib/x86.c, src/perfctr-2.6.x/usr.lib/x86.h, + src/perfctr-2.7.x/CHANGES, src/perfctr-2.7.x/COPYING, + src/perfctr-2.7.x/INSTALL, src/perfctr-2.7.x/Makefile, + src/perfctr-2.7.x/OTHER, src/perfctr-2.7.x/README, + src/perfctr-2.7.x/TODO, src/perfctr-2.7.x/etc/costs/Athlon-1.1, + src/perfctr-2.7.x/etc/costs/Athlon-1.133, + src/perfctr-2.7.x/etc/costs/Athlon-1.2, + src/perfctr-2.7.x/etc/costs/Athlon-1.3, + src/perfctr-2.7.x/etc/costs/Athlon-1.33, + src/perfctr-2.7.x/etc/costs/Athlon-1.46, + src/perfctr-2.7.x/etc/costs/Athlon-1.53, + src/perfctr-2.7.x/etc/costs/Athlon-1.64, + src/perfctr-2.7.x/etc/costs/Athlon-1.66, + src/perfctr-2.7.x/etc/costs/Athlon-1.75, + src/perfctr-2.7.x/etc/costs/Athlon-1.8, + src/perfctr-2.7.x/etc/costs/Athlon-1000, + src/perfctr-2.7.x/etc/costs/Athlon-2.0, + src/perfctr-2.7.x/etc/costs/Athlon-500, + src/perfctr-2.7.x/etc/costs/Athlon-700, + src/perfctr-2.7.x/etc/costs/Athlon-800, + src/perfctr-2.7.x/etc/costs/Athlon-850, + src/perfctr-2.7.x/etc/costs/Athlon64-2.0, + src/perfctr-2.7.x/etc/costs/Athlon64-2.2, + src/perfctr-2.7.x/etc/costs/Athlon64FX-2.2, + src/perfctr-2.7.x/etc/costs/AthlonXP-1800, + src/perfctr-2.7.x/etc/costs/AthlonXPM-2500, + src/perfctr-2.7.x/etc/costs/C3-1.2, + src/perfctr-2.7.x/etc/costs/Celeron-466, + src/perfctr-2.7.x/etc/costs/Celeron-500, + src/perfctr-2.7.x/etc/costs/CyrixMII-233, + src/perfctr-2.7.x/etc/costs/Duron-1.0, + src/perfctr-2.7.x/etc/costs/Duron-600, + src/perfctr-2.7.x/etc/costs/Duron-700, + src/perfctr-2.7.x/etc/costs/Duron-750, + src/perfctr-2.7.x/etc/costs/K6-III-400, + src/perfctr-2.7.x/etc/costs/MPC7400-400, + src/perfctr-2.7.x/etc/costs/MPC7447A-1.35, + src/perfctr-2.7.x/etc/costs/Opteron-1.4, + src/perfctr-2.7.x/etc/costs/Opteron-1.6, + src/perfctr-2.7.x/etc/costs/Opteron-2.0, + src/perfctr-2.7.x/etc/costs/PPC750-300, + src/perfctr-2.7.x/etc/costs/Pentium-133, + src/perfctr-2.7.x/etc/costs/Pentium4-1.5, + src/perfctr-2.7.x/etc/costs/Pentium4-1.6, + src/perfctr-2.7.x/etc/costs/Pentium4-1.7, + src/perfctr-2.7.x/etc/costs/Pentium4-1.8, + src/perfctr-2.7.x/etc/costs/Pentium4-2.2, + src/perfctr-2.7.x/etc/costs/Pentium4-2.26, + src/perfctr-2.7.x/etc/costs/Pentium4-2.66, + src/perfctr-2.7.x/etc/costs/Pentium4-2.8, + src/perfctr-2.7.x/etc/costs/Pentium4-3.0, + src/perfctr-2.7.x/etc/costs/Pentium4-3.4, + src/perfctr-2.7.x/etc/costs/Pentium4M-1.8, + src/perfctr-2.7.x/etc/costs/Pentium4Xeon-2.2, + src/perfctr-2.7.x/etc/costs/Pentium4Xeon-2.4, + src/perfctr-2.7.x/etc/costs/Pentium4Xeon-2.8, + src/perfctr-2.7.x/etc/costs/Pentium4Xeon-3.4, + src/perfctr-2.7.x/etc/costs/PentiumII-266a, + src/perfctr-2.7.x/etc/costs/PentiumII-266b, + src/perfctr-2.7.x/etc/costs/PentiumII-300, + src/perfctr-2.7.x/etc/costs/PentiumII-350, + src/perfctr-2.7.x/etc/costs/PentiumIII-1.0, + src/perfctr-2.7.x/etc/costs/PentiumIII-1.4, + src/perfctr-2.7.x/etc/costs/PentiumIII-450, + src/perfctr-2.7.x/etc/costs/PentiumIII-500, + src/perfctr-2.7.x/etc/costs/PentiumIII-700, + src/perfctr-2.7.x/etc/costs/PentiumIII-733, + src/perfctr-2.7.x/etc/costs/PentiumIII-800, + src/perfctr-2.7.x/etc/costs/PentiumIII-866, + src/perfctr-2.7.x/etc/costs/PentiumIII-900, + src/perfctr-2.7.x/etc/costs/PentiumIII-933, + src/perfctr-2.7.x/etc/costs/PentiumM-1.3, + src/perfctr-2.7.x/etc/costs/PentiumM-1.4, + src/perfctr-2.7.x/etc/costs/PentiumM-1.5, + src/perfctr-2.7.x/etc/costs/PentiumM-1.6, + src/perfctr-2.7.x/etc/costs/PentiumM-1.7, + src/perfctr-2.7.x/etc/costs/PentiumMMX-150, + src/perfctr-2.7.x/etc/costs/PentiumMMX-166, + src/perfctr-2.7.x/etc/costs/PentiumMMX-233, + src/perfctr-2.7.x/etc/costs/PentiumPro-200, + src/perfctr-2.7.x/etc/costs/Sempron-3100+, + src/perfctr-2.7.x/etc/install.sh, src/perfctr-2.7.x/etc/p4.c, + src/perfctr-2.7.x/examples/Makefile, + src/perfctr-2.7.x/examples/README, + src/perfctr-2.7.x/examples/global/Makefile, + src/perfctr-2.7.x/examples/global/arch.h, + src/perfctr-2.7.x/examples/global/global.c, + src/perfctr-2.7.x/examples/global/ppc.c, + src/perfctr-2.7.x/examples/global/x86.c, + src/perfctr-2.7.x/examples/perfex/Makefile, + src/perfctr-2.7.x/examples/perfex/arch.h, + src/perfctr-2.7.x/examples/perfex/perfex.c, + src/perfctr-2.7.x/examples/perfex/ppc.c, + src/perfctr-2.7.x/examples/perfex/ppc.h, + src/perfctr-2.7.x/examples/perfex/ppc64.c, + src/perfctr-2.7.x/examples/perfex/ppc64.h, + src/perfctr-2.7.x/examples/perfex/x86.c, + src/perfctr-2.7.x/examples/perfex/x86.h, + src/perfctr-2.7.x/examples/self/Makefile, + src/perfctr-2.7.x/examples/self/arch.h, + src/perfctr-2.7.x/examples/self/ppc.c, + src/perfctr-2.7.x/examples/self/ppc64.c, + src/perfctr-2.7.x/examples/self/self.c, + src/perfctr-2.7.x/examples/self/x86.c, + src/perfctr-2.7.x/examples/signal/Makefile, + src/perfctr-2.7.x/examples/signal/arch.h, + src/perfctr-2.7.x/examples/signal/ppc.c, + src/perfctr-2.7.x/examples/signal/ppc64.c, + src/perfctr-2.7.x/examples/signal/signal.c, + src/perfctr-2.7.x/examples/signal/x86.c, + .../linux/Documentation/perfctr/low-level-api.txt, + .../Documentation/perfctr/low-level-ppc32.txt, + .../linux/Documentation/perfctr/low-level-x86.txt, + .../linux/Documentation/perfctr/overview.txt, + .../linux/Documentation/perfctr/virtual.txt, + src/perfctr-2.7.x/linux/drivers/perfctr/Kconfig, + src/perfctr-2.7.x/linux/drivers/perfctr/Makefile, + .../linux/drivers/perfctr/RELEASE-NOTES, + src/perfctr-2.7.x/linux/drivers/perfctr/cpumask.h, + src/perfctr-2.7.x/linux/drivers/perfctr/init.c, + src/perfctr-2.7.x/linux/drivers/perfctr/ppc.c, + src/perfctr-2.7.x/linux/drivers/perfctr/ppc64.c, + .../linux/drivers/perfctr/ppc64_tests.c, + .../linux/drivers/perfctr/ppc64_tests.h, + .../linux/drivers/perfctr/ppc_tests.c, + .../linux/drivers/perfctr/ppc_tests.h, + src/perfctr-2.7.x/linux/drivers/perfctr/version.h, + src/perfctr-2.7.x/linux/drivers/perfctr/virtual.c, + src/perfctr-2.7.x/linux/drivers/perfctr/virtual.h, + src/perfctr-2.7.x/linux/drivers/perfctr/x86.c, + .../linux/drivers/perfctr/x86_tests.c, + .../linux/drivers/perfctr/x86_tests.h, + src/perfctr-2.7.x/linux/include/asm-i386/perfctr.h, + src/perfctr-2.7.x/linux/include/asm-ppc/perfctr.h, + .../linux/include/asm-ppc64/perfctr.h, + .../linux/include/asm-x86_64/perfctr.h, + src/perfctr-2.7.x/linux/include/linux/perfctr.h, + src/perfctr-2.7.x/patches/patch-kernel-2.6.11, + src/perfctr-2.7.x/patches/patch-kernel-2.6.12-rc1, + .../patches/patch-kernel-2.6.12-rc1-mm1, .../patches/patch- + kernel-2.6.12-rc1-mm3, .../patches/patch-kernel-2.6.12-rc1-mm4, + src/perfctr-2.7.x/patches/patch-kernel-2.6.12-rc2, + src/perfctr-2.7.x/patches/patch-kernel-2.6.12-rc5, + src/perfctr-2.7.x/patches/patch-kernel-2.6.14, + src/perfctr-2.7.x/patches/patch-kernel-2.6.14-mm1, + .../patches/patch-kernel-2.6.14-rc5-mm1, + src/perfctr-2.7.x/patches/patch-kernel-2.6.16, .../patches/patch- + kernel-2.6.16.21-SLES10, src/perfctr-2.7.x/patches/patch- + kernel-2.6.17, src/perfctr-2.7.x/patches/patch-kernel-2.6.18, + src/perfctr-2.7.x/patches/patch-kernel-2.6.18-rc4, + src/perfctr-2.7.x/patches/patch-kernel-2.6.19, + src/perfctr-2.7.x/patches/patch-kernel-2.6.20, + src/perfctr-2.7.x/patches/patch-kernel-2.6.21, + src/perfctr-2.7.x/patches/patch-kernel-2.6.22, + src/perfctr-2.7.x/perfctr.spec, src/perfctr-2.7.x/update-kernel, + src/perfctr-2.7.x/usr.lib/Makefile, + src/perfctr-2.7.x/usr.lib/arch.h, + src/perfctr-2.7.x/usr.lib/event_set.h, + src/perfctr-2.7.x/usr.lib/event_set_amd.c, + src/perfctr-2.7.x/usr.lib/event_set_centaur.c, + src/perfctr-2.7.x/usr.lib/event_set_p4.c, + src/perfctr-2.7.x/usr.lib/event_set_p5.c, + src/perfctr-2.7.x/usr.lib/event_set_p6.c, + src/perfctr-2.7.x/usr.lib/event_set_ppc.c, + src/perfctr-2.7.x/usr.lib/event_set_ppc64.c, + src/perfctr-2.7.x/usr.lib/event_set_x86.c, + src/perfctr-2.7.x/usr.lib/gen-event-codes.c, + src/perfctr-2.7.x/usr.lib/global.c, + src/perfctr-2.7.x/usr.lib/libperfctr.h, + src/perfctr-2.7.x/usr.lib/misc.c, src/perfctr-2.7.x/usr.lib/ppc.c, + src/perfctr-2.7.x/usr.lib/ppc.h, src/perfctr-2.7.x/usr.lib/ppc64.c, + src/perfctr-2.7.x/usr.lib/ppc64.h, + src/perfctr-2.7.x/usr.lib/virtual.c, + src/perfctr-2.7.x/usr.lib/x86.c, src/perfctr-2.7.x/usr.lib/x86.h, + src/perfctr-2.7.x/usr.lib/x86_cpuid.S, + src/perfctr-2.7.x/usr.lib/x86_cpuinfo.c, + src/perfctr-2.7.x/usr.lib/x86_cpuinfo.h: perfctr: Remove the + obsolete bundled perfctr and libpfm-3.y code perfctr was an + earlier project that provided access to a processor's performance + monitoring hardware on Linux. Over time Linux has developed its + own infrastructure to access the performance monitoring hardware + via the perf_event_open syscall. The perfctr kernel patches and + user-space code has not been updated to work with current kernels. + PAPI has included bundled perfctr and libpfm-3.y code to make use + of the perfctr interface, but it is no longer useful. In the + interest of making the PAPI code more compact the obsolete bundled + perfctr and libpfm-3.y code have been removed. + +2024-06-27 Treece Burgess + + * src/papi.c: Updating documentation for PAPI_read and PAPI_accum + based off feedback. + * src/papi.c: Update doxygen documentation to make note of the + differences between PAPI_read and PAPI_accum. Specifically the + second parameter in PAPI_accum must be initialized. + +2024-02-29 Daniel Barry + + * src/components/sysdetect/arm_cpu_utils.c: sysdetect: add support + for ARM Neoverse V2 Add cache information for ARM Neoverse V2, per + the Reference Manual: + https://developer.arm.com/documentation/102375/0002?lang=en These + changes have been tested on the ARM Neoverse V2 architecture. + +Wed Jun 19 23:32:25 2024 -0700 Stephane Eranian + + * src/libpfm4/README, src/libpfm4/docs/Makefile, + src/libpfm4/docs/man3/libpfm_intel_gnr.3, + src/libpfm4/include/perfmon/pfmlib.h, src/libpfm4/lib/Makefile, + src/libpfm4/lib/events/intel_gnr_events.h, + src/libpfm4/lib/events/intel_spr_events.h, + src/libpfm4/lib/pfmlib_common.c, + src/libpfm4/lib/pfmlib_intel_gnr.c, src/libpfm4/lib/pfmlib_priv.h, + src/libpfm4/lib/pfmlib_s390x_cpumf.c, + src/libpfm4/tests/validate_x86.c: Update libpfm4 Current with + commit 92c52017d7395c4040ec22949ee8c7f17bc5b4f7 add missing + pfmlib_intel_gnr.c file To complete the Intel GraniteRapids + support. Was missing from commit 23d0b7c47c2e ("add Intel + GraniteRapids core PMU support") Sorry about that. commit + 44a55dd97c929087b4ca93540f6bbb2d2efffd15 s390: Fix calloc compiler + error for gcc14 The definition of calloc is as follows: void + *calloc(size_t nmemb, size_t size); number of members is in the + first parameter and the size is in the second parameter. Fix error + message on the gcc 14 20240102: error: 'calloc' sizes specified + with 'sizeof' in the earlier argument and not in the later argument + ... by adhering to the calloc() calling convention. Output before: + # make Entering directory '/root/perfmon2-libpfm4/lib' cc -g -Wall + -Werror -Wextra -Wno-unused-parameter -I. \ + -I/root/perfmon2-libpfm4/lib/../include -DCONFIG_PFMLIB_DEBUG \ + -DCONFIG_PFMLIB_OS_LINUX -DCONFIG_PFMLIB_NOTRACEPOINT \ + -DHAS_OPENAT -D_REENTRANT -I. -fvisibility=hidden \ + -DCONFIG_PFMLIB_ARCH_S390X -I. -c pfmlib_s390x_cpumf.c + pfmlib_s390x_cpumf.c: In function ‘pfm_cpumcf_init’: + pfmlib_s390x_cpumf.c:221:26: error: ‘calloc’ sizes specified with \ + ‘sizeof’ in the earlier argument and not in the later argument \ + [-Werror=calloc-transposed-args] 221 | cpumcf_pe = + calloc(sizeof(*cpumcf_pe), cfvn_set_count): | + ^ pfmlib_s390x_cpumf.c:221:26: note: earlier argument should + specify number of elements, later size of each element Acked-by: + Sumanth Korikkar commit + 23d0b7c47c2ec06334b3eb378bfc3568b08e0042 add Intel GraniteRapids + core PMU support Based on JSON event files published on + github.com/Intel/perfmon version 1.02, dated 05/10/2024 commit + 489a940be48980956b27dda89de1eb91b01f185d fix Intel SPR + inst_retired umask flags Were missing PEBS and fixed event code + umask (ANY) was not encoded properly. inst_retired.any -> fixed + counter 0 encoding 0x100 inst_retired.any_p -> generic counter + encoding 0x00c0 commit ace21560113100f4ab5032e99753459ed9da7049 + fix validate_x86.c Intel SPR/EMR inst_retired tests They were not + using the proper event codes for the different versions of + inst_retired. Note: Built PAPI with Intel Xeon Gold 6430 (SPR) + with GCC 14. No errors occured during build. Unable to test Granite + Rapids support due to the PAPI team not having access to a machine + with Granite Rapids. Unable to test instr_retired fixes due to no + access to Emerald Rapids and events not available on Sapphire + Rapids machine we have access to. + +2024-06-25 Daniel Barry + + * README.md: readme: updated FAQ page Edit to the README to point to + the new live FAQ webpage. + +2024-06-21 Daniel Barry + + * PAPI_FAQ.html: FAQ: update outdated links Replace outdated links + with newer equivalents. + * INSTALL.txt: install: remove outdated instructions Remove outdated + and incorrect instructions from the INSTALL.txt file. + +2024-06-20 Daniel Barry + + * PAPI_FAQ.html: FAQ: Update to address MacOS question A common + question raised in issues and on the mailing list is whether or not + PAPI supports MacOS. + +Fri Jun 14 22:14:05 2024 -0700 Stephane Eranian + + * src/libpfm4/lib/events/intel_adl_grt_events.h: Update libpfm4 + Current with commit 4bdeb7e067363013257460bdb6c3dbae778b5634 Fix + encoding of inst_retired.* on Alderlake E-core Was returning event + code 0x0 for both .any and .any_p umasks. any_p refers to the + generic counter encoding which uses event code 0xc0. Note: Unable + to test due to the PAPI team not having access to a machine with + Alderlake as of now. + +2024-05-13 Treece Burgess + + * src/papi.c: Restructuring conditional check to check for allowed + modifiers. + +Wed Apr 24 18:01:23 2024 -0700 Stephane Eranian + + * src/libpfm4/lib/events/intel_icx_unc_cha_events.h: Update libpfm4 + Current with commit 7c486cf96f9eab7019023d40f9c568486f696c44 + remove Intel IcelakeX UNC_CHA_PIPE_REJECT event Encodings of + umasks is invalid and fails to pass tests with perf as it sets bits + the kernel does not know about. Note: Tested on ICL system + Hexane, with Linux 6.1.81-1.el9.elrepo.x86_64 and Intel(R) Xeon(R) + Silver 4309Y CPU @ 2.80GHz as CPU architecture. + +2024-04-22 Treece Burgess + + * src/utils/papi_avail.c: Adding extra check within conditional + statement to avoid entering with the options of --cache or --cnd. + +Mon Apr 15 17:27:33 2024 -0700 Stephane Eranian + + * src/libpfm4/perf_examples/task.c: Update libpfm4 Current with + commit 1c0cdb91bc79eb1bc827e022f0a3738f124796a2 fix uninitialized + variable in perf_examples/task.c Commit 9410619f922f ("update + task.c example to handle hybrid") Introduced a bug by not + initializing group_fd which could generate a compiler warning and a + bug. Fix this by initializing group_fd to -1. Reported-by: William + Cohen + +Thu Apr 11 08:36:50 2024 -0700 Stephane Eranian + + * src/libpfm4/lib/events/intel_spr_events.h: Update libpfm4 Current + with commit 72866cbc2666820d87ebc0af3b1a16d1d5db6965 fix duplicate + event code for Intel SPR TOPDOWN.BAD_SPEC_SLOTS Was using same + encoding as TOPDOWN.SLOTS. Fix by adding the proper event code + (0xa4) and code override flag. Reported-by: + +2024-04-25 William Cohen + + * src/sde_lib/Makefile: SDE_LIB: Build libsde.so.1.0 with the CFLAGS + and LDFLAGS passed in A recent annocheck of the papi RPMS showed + that libsde.so.1.0 was not built with the expected flags passed + into the RPM build. Minor changes were made to + src/sde_lib/Makefile to use the CFLAGS and LDFLAGS passed in. + +2024-04-17 Treece Burgess + + * src/utils/papi_avail.c: Adding PAPI_PRESET_BIT_MEM for correct else + if conditional check. + +2024-03-28 Anthony + + * src/sde_lib/sde_lib_misc.c, src/sde_lib/sde_lib_ti.c: SDE_LIB: + Allow PAPI_reset() to reset a CountingSet. + +2024-04-02 Anthony + + * src/components/sde/sde.c: SDE: Adding ntv_code_to_info + functionality. + +2024-03-26 Anthony + + * src/components/sde/tests/Counting_Set/CountingSet_Lib.c: SDE tests: + Add more randomness to the test. By varying the pressure on + different buckets we increase the chance of catching hash table + bugs. + +2024-03-22 Anthony + + * src/sde_lib/sde_lib_datastructures.c: sde_lib: Improved bucket + utilization of hash table. The previous check would put elements + in the overflow list, even in cases where there was room in the + bucket that the hash function points to. The updated code gives + priority to the bucket. This was a potential performance issue, not + a correctness bug. + +Fri Jan 12 21:55:04 2024 -0800 Stephane Eranian + + * src/libpfm4/docs/Makefile, + src/libpfm4/docs/man3/libpfm_intel_spr_unc_cha.3, + src/libpfm4/docs/man3/libpfm_intel_spr_unc_imc.3, + src/libpfm4/docs/man3/libpfm_intel_spr_unc_upi.3, + src/libpfm4/include/perfmon/pfmlib.h, src/libpfm4/lib/Makefile, + src/libpfm4/lib/events/intel_spr_unc_cha_events.h, + src/libpfm4/lib/events/intel_spr_unc_imc_events.h, + src/libpfm4/lib/events/intel_spr_unc_upi_events.h, + src/libpfm4/lib/pfmlib_common.c, + src/libpfm4/lib/pfmlib_intel_snbep_unc.c, + src/libpfm4/lib/pfmlib_intel_snbep_unc_priv.h, + src/libpfm4/lib/pfmlib_intel_spr_unc_cha.c, + src/libpfm4/lib/pfmlib_intel_spr_unc_imc.c, + src/libpfm4/lib/pfmlib_intel_spr_unc_upi.c, + src/libpfm4/lib/pfmlib_priv.h, src/libpfm4/tests/validate_x86.c: + Update libpfm4 Current with commit + 33513ef78f0d81edb277e0d0fd16411abb161297 Add Intel SapphireRapids + uncore PMU support for CHA Adds the Coherence and Home Agent (CHA) + for Intel SapphireRapids. Based on Intel JSON events v1.17 + published from github.com/intel/perfmon/SPR commit + e943f891e9f1d63c4b55bac051ca7b2b3979b25f Add Intel SapphireRapids + uncore PMU support for UPI Adds the Ultra Path Interconnect PMU + (UPI) for Intel SapphireRapids. Based on Intel JSON events v1.17 + published from github.com/intel/perfmon/SPR commit + 10b8044a90ba512be2b10e9425330e989cc22d01 Add Intel SapphireRapids + uncore PMU support for IMC Adds the memory controller PMU (IMC) + for SapphireRapids. Based on Intel JSON events v1.17 published from + github.com/intel/perfmon/SPR + +2024-03-12 Masahiko, Yamada + + * src/components/sysdetect/linux_cpu_utils.c, src/linux-memory.c: + Update:Use fgets in place of fscanf functions to avoid possible + buffer overflows There was a bug in the buffer overflow fix below. + Use fgets in place of fscanf functions to avoid possible buffer + overflows https://github.com/icl-utk- + edu/papi/commit/ec2aa022fee2a1d0decf1d5b2e7e28a4ca2cf794 The + buffer overflow fix rewrites fscanf() to fgets(), but there is a + difference in the specifications between fscanf() and fgets(): in + fscanf(), "\n" is not read, but in fgets(), "\n" is also read, so + it seems necessary to remove the unnecessary "\n" to do the same. + For this reason, generic_get_memory_info() could not obtain cache + information strings from allocation_policy, type, and write_policy + under the /sys/devices/system/cpu/cpu0/cache/index[012] directory + as expected. The buffer overflow update fix allows us to do the + same thing as fscanf() by rewriting fscanf() to fgets()+sscanf(). + +Thu Feb 29 23:07:21 2024 -0800 Stephane Eranian + + * src/libpfm4/config.mk, src/libpfm4/lib/pfmlib_perf_event_pmu.c: + Update libpfm4 Current with commit + f517f1ec8038de00ce8f5fefeeef704e24aa08ae add + CONFIG_PFMLIB_NOTRACEPOINT to speedup libpfm4 initialization When + pfmlib_initialize() is run as root and if the debugs is mounted, + then the library parses all the tracepoints to add them to the perf + PMU. Depending on the number of tracepoints, this can take a + significant amount of time even though this may not be needed if no + tracepoints is passed. In order to speedup pfm_initialize(), the + patch adds a compile-time option to disable support for tracepoint + in the perf PMU. To deactivate tracepoint support: make + CONFIG_PFMLIB_NOTRACEPOINT=y The default build is unchanged with + tracepoints enabled. This patch adds an opt-out option. + +Tue Feb 13 21:58:11 2024 -0800 Stephane Eranian + + * src/libpfm4/README, src/libpfm4/docs/Makefile, + src/libpfm4/docs/man3/libpfm_intel_adl_glc.3, + src/libpfm4/docs/man3/libpfm_intel_adl_grt.3, + src/libpfm4/docs/man3/libpfm_intel_icx_unc_pcu.3, + src/libpfm4/include/perfmon/pfmlib.h, src/libpfm4/lib/Makefile, + src/libpfm4/lib/events/intel_adl_glc_events.h, + src/libpfm4/lib/events/intel_adl_grt_events.h, + src/libpfm4/lib/pfmlib_common.c, + src/libpfm4/lib/pfmlib_intel_adl.c, + src/libpfm4/lib/pfmlib_intel_x86.c, + src/libpfm4/lib/pfmlib_intel_x86_priv.h, + src/libpfm4/lib/pfmlib_priv.h, src/libpfm4/perf_examples/task.c, + src/libpfm4/tests/validate_x86.c: Update libpfm4 Current with + commit 816bb547f8997b84f7ef70bb99420f40dc8a984d add Intel + Raptorlake PMU support Enables support for Raptorlake, Raptorlake + P, Raptorlake S. commit 8fa4467ffa7014ed8f1525783b5919b80117beca + Add Intel AlderLake Gracemont (E-Core) core PMU support Adds core + PMU support for Alderlake E-core (gracemont). Based on Intel JSON + events v1.24 published from github.com/intel/perfmon/ADL commit + e84a9563f4c93dc6e530dfa55d61b150fbf51510 Add Intel AlderLake + Goldencove (P-Core) core PMU support Adds core PMU support for + Alderlake P-core (goldencove). Based on Intel JSON events v1.24 + published from github.com/intel/perfmon/ADL commit + 9410619f922facca7dab2406c58fe41a8dd61529 update task.c example to + handle hybrid Cannot group event if they do not belong to the same + hardware PMU. commit 2441b263f6f28c0fe80f8cee62cd2e64d75cd433 + add INTEL_X86_CODE_DUP event flag for Intel PMUs To handle the + case where two events shared the same code and none is because of + deprecation. In order to pass validation both events with the same + code must have that flag set. commit + 9669e0d696a98b8b5655186dda8b457113cb0ba2 Add support for + deprecated events for Intel X86 PMUs Adds INTEL_X86_DEPRECATED + flag to Intel X86 events. Deprecated in this context means there is + a newer event monitoring the same condition. This is used to mark + events as deprecated and avoid detecting duplicate event codes. + commit b7307408ddb1548271983d1fd7c4f17287d2dc0e fix Intel IcelakeX + uncore PCU PMU man page typo Was referring to eRP clockticks + instead of PCU clockticks. + +2024-02-19 Daniel Barry + + * src/papi_events.csv: presets: add support for Ice Lake ICL Add + various preset definitions for architectures containing the ICL + PMU. These changes have been tested on the Intel Ice Lake + architecture. + +2024-02-16 Treece Burgess + + * src/counter_analysis_toolkit/Makefile: Updating CAT Makefile to use + PAPI_DIR, to be more inline with the PAPI WIKI documentation. + +2024-02-08 Treece Burgess + + * src/high-level/scripts/papi_hl_output_writer.py: Changing --source + flag to --source_dir and update to error output messages. Removed + Python doc string and will address docs in another PR. + +2024-02-06 Treece Burgess + + * src/high-level/scripts/papi_hl_output_writer.py: Fixing small typo + in parse_source_file docstring. + * src/high-level/scripts/papi_hl_output_writer.py: Updating error + handling, with updated output messages. + * src/high-level/scripts/papi_hl_output_writer.py: Adding support for + optional individual file flag to papi_hl_output_writer.py script. + +2024-02-01 Anthony + + * .../sde/tests/Minimal/Minimal_Test++.cpp, + .../sde/tests/Simple2/Simple2_Driver++.cpp, + src/components/sde/tests/Simple2/Simple2_Lib++.cpp, + src/components/sde/tests/Simple2/simple2.hpp: SDE: Updated the C++ + version of test Simple2. + +2024-01-30 Anthony + + * .../sde/tests/Minimal/Minimal_Test++.cpp: SDE: Updated the C++ + version of the minimal test. The updated version of the example + uses classes and looks like proper C++ much more than the previous + version. However, the functionality has remained the same. + +Fri Feb 2 15:32:27 2024 -0800 Stephane Eranian + + * src/libpfm4/lib/events/intel_spr_events.h, + src/libpfm4/lib/pfmlib_intel_icx_unc_irp.c, + src/libpfm4/tests/validate_x86.c: Update libpfm4 Current with + commit 0d4ed0e7b09338e1bb1ab9153beab030c52570fe fix missing PEBS + flag on Intel SPR MEM_LOAD_L3_MISS_RETIRED commit 769b239ee314 + ("add PEBS support to Intel SPR MEM_LOAD_L3_MISS_RETIRED") added + the PEBS flag to the event but to none of the umasks causing a + validation issue. Add missing PEBS flags to the umasks commit + 769b239ee31465f030f63d8dd16c6be006bfcb55 add PEBS support to Intel + SPR MEM_LOAD_L3_MISS_RETIRED Was missing PEBS flag. + +2024-01-29 Treece Burgess + + * src/papi_fwrappers.c: Updating first argument for PAPIF_flops_rate, + PAPIF_flips_rate, and PAPIF_epc to use a int * instead of just int. + +2024-01-22 Treece Burgess + + * src/components/net/README.md, src/components/rocm/README.md: + Updating net README to remove unwanted links and rocm README to add + correct link for GPU isolation. + +2024-01-19 Treece Burgess + + * src/components/appio/README.md, src/components/bgpm/README.md, + src/components/coretemp/README.md, + src/components/coretemp_freebsd/README.md, + src/components/cuda/README.md, src/components/emon/README.md, + src/components/example/README.md, + src/components/host_micpower/README.md, + src/components/infiniband/README.md, src/components/io/README.md, + src/components/libmsr/README.md, + src/components/lmsensors/README.md, + src/components/lustre/README.md, src/components/micpower/README.md, + src/components/mx/README.md, src/components/net/README.md, + src/components/nvml/README.md, src/components/pcp/README.md, + src/components/perf_event/README.md, + src/components/perf_event_uncore/README.md, + src/components/powercap/README.md, + src/components/powercap_ppc/README.md, + src/components/rapl/README.md, src/components/rocm/README.md, + src/components/rocm_smi/README.md, src/components/sde/README.md, + src/components/sensors_ppc/README.md, + src/components/stealtime/README.md, + src/components/sysdetect/README.md, + src/components/vmware/README.md: Updates to individual component + README's to fix markdown links. + +2024-01-12 Daniel Barry + + * src/counter_analysis_toolkit/dcache.c, + src/counter_analysis_toolkit/dcache.h, + src/counter_analysis_toolkit/main.c: cat: improve progress + indicator in d-cache tests Make the progress indicator finer- + grained to visualize when each successive buffer size is proved. + These changes have been tested on the Intel Sapphire Rapids + architecture. + * src/counter_analysis_toolkit/dcache.c, + src/counter_analysis_toolkit/timing_kernels.c, + src/counter_analysis_toolkit/timing_kernels.h: cat: optimize data + cache benchmarks Traverse the pointer chain fewer times for larger + buffers and do a warm-up traversal closer to PAPI_start() to + prevent cache pollution and compulsory misses. These changes have + been tested on the Intel Sapphire Rapids architecture. + +2024-01-09 Vince Weaver + + * src/linux-context.h, src/linux-timer.c, src/mb.h: add initial riscv + support This adds basic support for the RISC-V architecture After + this PAPI will compile and the tools will run, however no events + will work because of missing libpfm4 support. Tested on a BeagleV- + Ahead board + +Fri Dec 8 22:25:25 2023 -0800 Stephane Eranian + + * src/libpfm4/docs/Makefile, + src/libpfm4/docs/man3/libpfm_intel_icx_unc_cha.3, + src/libpfm4/docs/man3/libpfm_intel_icx_unc_iio.3, + src/libpfm4/docs/man3/libpfm_intel_icx_unc_imc.3, + src/libpfm4/docs/man3/libpfm_intel_icx_unc_irp.3, + src/libpfm4/docs/man3/libpfm_intel_icx_unc_m2m.3, + .../docs/man3/libpfm_intel_icx_unc_m2pcie.3, + src/libpfm4/docs/man3/libpfm_intel_icx_unc_m3upi.3, + src/libpfm4/docs/man3/libpfm_intel_icx_unc_pcu.3, + src/libpfm4/docs/man3/libpfm_intel_icx_unc_ubox.3, + src/libpfm4/docs/man3/libpfm_intel_icx_unc_upi.3, + src/libpfm4/include/perfmon/pfmlib.h, src/libpfm4/lib/Makefile, + src/libpfm4/lib/events/intel_icx_unc_cha_events.h, + src/libpfm4/lib/events/intel_icx_unc_iio_events.h, + src/libpfm4/lib/events/intel_icx_unc_imc_events.h, + src/libpfm4/lib/events/intel_icx_unc_irp_events.h, + src/libpfm4/lib/events/intel_icx_unc_m2m_events.h, + .../lib/events/intel_icx_unc_m2pcie_events.h, + .../lib/events/intel_icx_unc_m3upi_events.h, + src/libpfm4/lib/events/intel_icx_unc_pcu_events.h, + src/libpfm4/lib/events/intel_icx_unc_ubox_events.h, + src/libpfm4/lib/events/intel_icx_unc_upi_events.h, + src/libpfm4/lib/pfmlib_amd64_rapl.c, + src/libpfm4/lib/pfmlib_common.c, + src/libpfm4/lib/pfmlib_intel_icx_unc_cha.c, + src/libpfm4/lib/pfmlib_intel_icx_unc_iio.c, + src/libpfm4/lib/pfmlib_intel_icx_unc_imc.c, + src/libpfm4/lib/pfmlib_intel_icx_unc_irp.c, + src/libpfm4/lib/pfmlib_intel_icx_unc_m2m.c, + src/libpfm4/lib/pfmlib_intel_icx_unc_m2pcie.c, + src/libpfm4/lib/pfmlib_intel_icx_unc_m3upi.c, + src/libpfm4/lib/pfmlib_intel_icx_unc_pcu.c, + src/libpfm4/lib/pfmlib_intel_icx_unc_ubox.c, + src/libpfm4/lib/pfmlib_intel_icx_unc_upi.c, + src/libpfm4/lib/pfmlib_intel_snbep_unc.c, + src/libpfm4/lib/pfmlib_intel_snbep_unc_priv.h, + src/libpfm4/lib/pfmlib_intel_x86_priv.h, + src/libpfm4/lib/pfmlib_priv.h, src/libpfm4/tests/validate_x86.c: + libpfm4: update to commit 90f61a0 Original commits: commit + 90f61a008cdee50d085b5041414df55e16e045fe Add Intel IcelakeX uncore + PMU support for M2PCIE Adds the Mesh to IIO PMU (M2PCIE) for Intel + IcelakeX. Based on Intel JSON events v1.21 published from + github.com/intel/perfmon/ICX commit + 22afed4c1020b579205ac8e8f9d6e8599307b9ee Add Intel IcelakeX uncore + PMU support for UBOX Adds the UBOX PMU (UBOX) for Intel IcelakeX. + Based on Intel JSON events v1.21 published from + github.com/intel/perfmon/ICX commit + cdbe2eed7bdcf5d45086d6730033defc1939a722 Add Intel IcelakeX uncore + PMU support for M3UPI Adds the Mesh to UPI PMU (M3UPI) for Intel + IcelakeX. Based on Intel JSON events v1.21 published from + github.com/intel/perfmon/ICX commit + 17dddc2f4cde87f37f041f40586654190da5a8c2 Add Intel IcelakeX uncore + PMU support for UPI Adds the Ultra Path Interconnect PMU support + (UPI) for Intel IcelakeX. Based on Intel JSON events v1.21 + published from github.com/intel/perfmon/ICX commit + 32fcf6fe2eaf2f2bf105f7543dcc0b07c097baaf Add Intel IcelakeX uncore + PMU support for PCU Adds the Power Control unit PMU support (PCU) + for Intel IcelakeX. Based on Intel JSON events v1.21 published from + github.com/intel/perfmon/ICX commit + 20ff7523ffaae04f6762d51e32fe35e04fa70cad Add Intel IcelakeX uncore + PMU support for M2M Adds the Mesh to Memory PMU support (M2M) for + Intel IcelakeX. Based on Intel JSON events v1.21 published from + github.com/intel/perfmon/ICX commit + d5ed0e03686c051f5311fc1993824245eb10e1d2 Add Intel IcelakeX uncore + PMU support for IRP Adds the PCIe IIO Ring Port PMU support (IRP) + for Intel IcelakeX. Based on Intel JSON events v1.21 published from + github.com/intel/perfmon/ICX commit + 30afdce909bcc7313af7599cfbf6484ae4b1fc3e Add Intel IcelakeX uncore + PMU support for IIO Adds the PCIe I/O controller PMU support (IIO) + for Intel IcelakeX. Based on Intel JSON events v1.21 published from + github.com/intel/perfmon/ICX commit + 6237022aa77bc9c845b1c48d741e54bdc22ac077 Add Intel IcelakeX uncore + PMU support for IMC Adds the memory controller PMU support (IMC) + for Intel IcelakeX. Based on Intel JSON events v1.21 published from + github.com/intel/perfmon/ICX commit + 05f04adec932cd2cd28e83f718e4e0ae6ba2eab4 Add Intel IcelakeX uncore + PMU support for CHA Adds Intel IcelakeX CHA (Coherency and Home + Agent) uncore PMU support. Based on Intel published uncore JSON + events v1.21 from github.com/intel/perfmon/ICX. commit + 94e82e27c02ef01f288a1b40904d72b2954d3f31 check umasks[] bounds in + intel_x86_uflag() Otherwise may run into SEGFAULT for some events. + commit d058479bd048d2742df298097da86bc86dd1a5ce Enable RAPL + support on AMD Zen4 Just like other AMD EPYC processors, only + ENERGY_PKG is supported. diff --git a/RELEASENOTES.txt b/RELEASENOTES.txt index 8a2fba98f..c82b4d9d3 100644 --- a/RELEASENOTES.txt +++ b/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