Merge pull request #148 from gcongiu/2024.01.03_libpfm4-update

libpfm4: update to commit 90f61a0

src/libpfm4/docs/Makefile

@@ -114,7 +114,17 @@ ARCH_MAN=libpfm_intel_core.3	\
 	 libpfm_intel_skx_unc_m3upi.3 \
 	 libpfm_intel_skx_unc_pcu.3 \
 	 libpfm_intel_skx_unc_ubo.3 \
-	 libpfm_intel_skx_unc_upi.3
+	 libpfm_intel_skx_unc_upi.3 \
+	 libpfm_intel_icx_unc_cha.3 \
+	 libpfm_intel_icx_unc_imc.3 \
+	 libpfm_intel_icx_unc_m2m.3 \
+	 libpfm_intel_icx_unc_iio.3 \
+	 libpfm_intel_icx_unc_pcu.3 \
+	 libpfm_intel_icx_unc_upi.3 \
+	 libpfm_intel_icx_unc_m3upi.3 \
+	 libpfm_intel_icx_unc_ubox.3 \
+	 libpfm_intel_icx_unc_m2pcie.3 \
+	 libpfm_intel_icx_unc_irp.3
 
 
 ifeq ($(CONFIG_PFMLIB_ARCH_I386),y)

src/libpfm4/docs/man3/libpfm_intel_icx_unc_cha.3

@@ -0,0 +1,37 @@
+.TH LIBPFM 3  "November, 2023" "" "Linux Programmer's Manual"
+.SH NAME
+libpfm_intel_icx_unc_cha - support for Intel IcelakeX Server CHA uncore PMU
+.SH SYNOPSIS
+.nf
+.B #include <perfmon/pfmlib.h>
+.sp
+.B PMU name: icx_unc_cha[0-39]
+.B PMU desc: Intel IcelakeX CHA uncore PMU
+.sp
+.SH DESCRIPTION
+The library supports the Intel IcelakeX CHA (coherency and home agent) uncore PMU.
+There is one CHA-box PMU per physical core. Therefore there are up forty identical CHA
+PMU instances numbered from 0 up to possibly 39. On dual-socket systems, the number refers to the CHA
+PMUs on the socket where the program runs.
+
+Each CHA PMU implements 4 generic counters.
+
+.SH MODIFIERS
+The following modifiers are supported on Intel IcelakeX CHA uncore PMU:
+.TP
+.B e
+Enable edge detection, i.e., count only when there is a state transition from no occurrence of the event to at least one occurrence. This modifier must be combined with a threshold modifier (t) with a value greater or equal to one.  This is a boolean modifier.
+.TP
+.B t
+Set the threshold value. When set to a non-zero value, the counter counts the number
+of CHA clockticks in which the number of occurrences of the event is greater or equal to
+the threshold.  This is an integer modifier with values in the range [0:255].
+.TP
+.B i
+Invert the threshold (t) test from strictly greater than to less or equal to. This is a boolean modifier.
+
+.SH AUTHORS
+.nf
+Stephane Eranian <[email protected]>
+.if
+.PP

src/libpfm4/docs/man3/libpfm_intel_icx_unc_iio.3

@@ -0,0 +1,34 @@
+.TH LIBPFM 3  "November, 2023" "" "Linux Programmer's Manual"
+.SH NAME
+libpfm_intel_icx_unc_iio - support for Intel IcelakeX Server IIO uncore PMU
+.SH SYNOPSIS
+.nf
+.B #include <perfmon/pfmlib.h>
+.sp
+.B PMU name: icx_unc_iio[0-5]
+.B PMU desc: Intel IcelakeX IIO uncore PMU
+.sp
+.SH DESCRIPTION
+The library supports the Intel IcelakeX IIO (I/O controller) uncore PMU.
+Each IIO PMU implements 4 generic counters and free running counters (not yet supported by libpfm4).
+The current version of libpfm4 does not expose the \fBfc_mask\fR and \fBch_mask\fR filter because these are
+hardcoded in the events provided by the library.
+.SH MODIFIERS
+The following modifiers are supported on Intel IcelakeX IIO uncore PMU:
+.TP
+.B e
+Enable edge detection, i.e., count only when there is a state transition from no occurrence of the event to at least one occurrence. This modifier must be combined with a threshold modifier (t) with a value greater or equal to one.  This is a boolean modifier.
+.TP
+.B t
+Set the threshold value. When set to a non-zero value, the counter counts the number
+of IIO clockticks in which the number of occurrences of the event is greater or equal to
+the threshold.  This is an integer modifier with values in the range [0:255].
+.TP
+.B i
+Invert the threshold (t) test from strictly greater than to less or equal to. This is a boolean modifier.
+
+.SH AUTHORS
+.nf
+Stephane Eranian <[email protected]>
+.if
+.PP

src/libpfm4/docs/man3/libpfm_intel_icx_unc_imc.3

@@ -0,0 +1,30 @@
+.TH LIBPFM 3  "November, 2023" "" "Linux Programmer's Manual"
+.SH NAME
+libpfm_intel_icx_unc_imc - support for Intel Icelake X Server Integrated Memory Controller (IMC)  uncore PMU
+.SH SYNOPSIS
+.nf
+.B #include <perfmon/pfmlib.h>
+.sp
+.B PMU name: icx_unc_imc[0-11]
+.B PMU desc: Intel Icelake X Server IMC uncore PMU
+.sp
+.SH DESCRIPTION
+The library supports the Intel Icelake X Server Integrated Memory Controller (IMC) uncore PMU.
+
+.SH MODIFIERS
+The following modifiers are supported on Intel Icelake X server IMC uncore PMU:
+.TP
+.B e
+Enable edge detection, i.e., count only when there is a state transition from no occurrence of the event to at least one occurrence. This modifier must be combined with a threshold modifier (t) with a value greater or equal to one.  This is a boolean modifier.
+.TP
+.B t
+Set the threshold value. When set to a non-zero value, the counter counts the number
+of IMC cycles in which the number of occurrences of the event is greater or equal to
+the threshold.  This is an integer modifier with values in the range [0:255].
+.B i
+Invert the threshold (t) test from strictly greater than to less or equal to. This is a boolean modifier.
+.SH AUTHORS
+.nf
+Stephane Eranian <[email protected]>
+.if
+.PP

src/libpfm4/docs/man3/libpfm_intel_icx_unc_irp.3

@@ -0,0 +1,33 @@
+.TH LIBPFM 3  "November, 2023" "" "Linux Programmer's Manual"
+.SH NAME
+libpfm_intel_icx_unc_irp - support for Intel IcelakeX Server IRP uncore PMU
+.SH SYNOPSIS
+.nf
+.B #include <perfmon/pfmlib.h>
+.sp
+.B PMU name: icx_unc_irp[0-5]
+.B PMU desc: Intel IcelakeX IRP uncore PMU
+.sp
+.SH DESCRIPTION
+The library supports the Intel IcelakeX IRP (IIO Ring Port) uncore PMU. There is one IRP per IIO.
+Each IRP PMU implements 4 generic counters.
+
+.SH MODIFIERS
+The following modifiers are supported on Intel IcelakeX IRP uncore PMU:
+.TP
+.B e
+Enable edge detection, i.e., count only when there is a state transition from no occurrence of the event to at least one occurrence. This modifier must be combined with a threshold modifier (t) with a value greater or equal to one.  This is a boolean modifier.
+.TP
+.B t
+Set the threshold value. When set to a non-zero value, the counter counts the number
+of IRP clockticks in which the number of occurrences of the event is greater or equal to
+the threshold.  This is an integer modifier with values in the range [0:255].
+.TP
+.B i
+Invert the threshold (t) test from strictly greater than to less or equal to. This is a boolean modifier.
+
+.SH AUTHORS
+.nf
+Stephane Eranian <[email protected]>
+.if
+.PP

src/libpfm4/docs/man3/libpfm_intel_icx_unc_m2m.3

@@ -0,0 +1,30 @@
+.TH LIBPFM 3  "November, 2023" "" "Linux Programmer's Manual"
+.SH NAME
+libpfm_intel_icx_unc_m2m - support for Intel Icelake X Server Mesh to Memory (M2M)  uncore PMU
+.SH SYNOPSIS
+.nf
+.B #include <perfmon/pfmlib.h>
+.sp
+.B PMU name: icx_unc_m2m[0-1]
+.B PMU desc: Intel Icelake X Server M2M uncore PMU
+.sp
+.SH DESCRIPTION
+The library supports the Intel Icelake X Server Mesh to Memory (M2M) uncore PMU.
+
+.SH MODIFIERS
+The following modifiers are supported on Intel Icelake X server M2M uncore PMU:
+.TP
+.B e
+Enable edge detection, i.e., count only when there is a state transition from no occurrence of the event to at least one occurrence. This modifier must be combined with a threshold modifier (t) with a value greater or equal to one.  This is a boolean modifier.
+.TP
+.B t
+Set the threshold value. When set to a non-zero value, the counter counts the number
+of M2M cycles in which the number of occurrences of the event is greater or equal to
+the threshold.  This is an integer modifier with values in the range [0:255].
+.B i
+Invert the threshold (t) test from strictly greater than to less or equal to. This is a boolean modifier.
+.SH AUTHORS
+.nf
+Stephane Eranian <[email protected]>
+.if
+.PP

src/libpfm4/docs/man3/libpfm_intel_icx_unc_m2pcie.3

@@ -0,0 +1,33 @@
+.TH LIBPFM 3  "November, 2023" "" "Linux Programmer's Manual"
+.SH NAME
+libpfm_intel_icx_unc_m2pcie - support for Intel IcelakeX Server M2PCIE uncore PMU
+.SH SYNOPSIS
+.nf
+.B #include <perfmon/pfmlib.h>
+.sp
+.B PMU name: icx_unc_m2pcie[0-2]
+.B PMU desc: Intel IcelakeX M2PCIE uncore PMU
+.sp
+.SH DESCRIPTION
+The library supports the Intel IcelakeX M2PCIE (Mesh to IIO) uncore PMU.
+Each M2PCIE PMU implements 4 generic counters.
+
+.SH MODIFIERS
+The following modifiers are supported on Intel IcelakeX M2PCIE uncore PMU:
+.TP
+.B e
+Enable edge detection, i.e., count only when there is a state transition from no occurrence of the event to at least one occurrence. This modifier must be combined with a threshold modifier (t) with a value greater or equal to one.  This is a boolean modifier.
+.TP
+.B t
+Set the threshold value. When set to a non-zero value, the counter counts the number
+of M2PCIE clockticks in which the number of occurrences of the event is greater or equal to
+the threshold.  This is an integer modifier with values in the range [0:255].
+.TP
+.B i
+Invert the threshold (t) test from strictly greater than to less or equal to. This is a boolean modifier.
+
+.SH AUTHORS
+.nf
+Stephane Eranian <[email protected]>
+.if
+.PP

src/libpfm4/docs/man3/libpfm_intel_icx_unc_m3upi.3

@@ -0,0 +1,31 @@
+.TH LIBPFM 3  "November, 2023" "" "Linux Programmer's Manual"
+.SH NAME
+libpfm_intel_icx_unc_m3upi - support for Intel IcelakeX Server M3UPI uncore PMU
+.SH SYNOPSIS
+.nf
+.B #include <perfmon/pfmlib.h>
+.sp
+.B PMU name: icx_unc_m3upi[0-3]
+.B PMU desc: Intel IcelakeX M3UPI uncore PMU
+.sp
+.SH DESCRIPTION
+The library supports the Intel IcelakeX M3UPI (Mesh to UPI) uncore PMU.
+Each M3UPI PMU implements 4 generic counters.
+
+.SH MODIFIERS
+The following modifiers are supported on Intel IcelakeX M3UPI uncore PMU:
+.TP
+.B e
+Enable edge detection, i.e., count only when there is a state transition from no occurrence of the event to at least one occurrence. This modifier must be combined with a threshold modifier (t) with a value greater or equal to one.  This is a boolean modifier.
+.TP
+.B t
+Set the threshold value. When set to a non-zero value, the counter counts the number
+of IRP clockticks in which the number of occurrences of the event is greater or equal to
+the threshold.  This is an integer modifier with values in the range [0:255].
+.B i
+Invert the threshold (t) test from strictly greater than to less or equal to. This is a boolean modifier.
+.SH AUTHORS
+.nf
+Stephane Eranian <[email protected]>
+.if
+.PP

src/libpfm4/docs/man3/libpfm_intel_icx_unc_pcu.3

@@ -0,0 +1,40 @@
+.TH LIBPFM 3  "November, 2023" "" "Linux Programmer's Manual"
+.SH NAME
+libpfm_intel_icx_unc_pcu - support for Intel IcelakeX Server PCU uncore PMU
+.SH SYNOPSIS
+.nf
+.B #include <perfmon/pfmlib.h>
+.sp
+.B PMU name: icx_unc_pcu
+.B PMU desc: Intel IcelakeX PCU uncore PMU
+.sp
+.SH DESCRIPTION
+The library supports the Intel IcelakeX PCU (Power Control Unit) uncore PMU. There is one PCU per system.
+Each PCU PMU implements 4 generic counters.
+
+.SH MODIFIERS
+The following modifiers are supported on Intel IcelakeX PCU uncore PMU:
+.TP
+.B e
+Enable edge detection, i.e., count only when there is a state transition from no occurrence of the event to at least one occurrence. This modifier must be combined with a threshold modifier (t) with a value greater or equal to one.  This is a boolean modifier.
+.TP
+.B t
+Set the threshold value. When set to a non-zero value, the counter counts the number
+of IRP clockticks in which the number of occurrences of the event is greater or equal to
+the threshold.  This is an integer modifier with values in the range [0:63].
+.TP
+.B i
+Invert the threshold (t) test from strictly greater than to less or equal to. This is a boolean modifier.
+.TP
+.B occ_i
+Invert the threshold (t) for occupancy events \fBPOWER_STATE_OCCUPANY\fR test from strictly greater than to less or equal to. This is a boolean modifier.
+.TP
+.B occ_e
+Enable edge detection for occupancy events \fBPOWER_STATE_OCCUPANCY\fR, i.e., count only when there is a state transition from no occurrence of the event to at least one occurrence. This modifier must be combined with a threshold modifier (t) with a value greater or equal to one.  This is a boolean modifier.
+.TP
+
+.SH AUTHORS
+.nf
+Stephane Eranian <[email protected]>
+.if
+.PP

src/libpfm4/docs/man3/libpfm_intel_icx_unc_ubox.3

@@ -0,0 +1,33 @@
+.TH LIBPFM 3  "November, 2023" "" "Linux Programmer's Manual"
+.SH NAME
+libpfm_intel_icx_unc_ubox - support for Intel IcelakeX Server UBOX uncore PMU
+.SH SYNOPSIS
+.nf
+.B #include <perfmon/pfmlib.h>
+.sp
+.B PMU name: icx_unc_ubox
+.B PMU desc: Intel IcelakeX UBOX uncore PMU
+.sp
+.SH DESCRIPTION
+The library supports the Intel IcelakeX UBOX (System configuration controller) uncore PMU. There is one UBOX per processor.
+Each UBOX PMU implements 4 generic counters.
+
+.SH MODIFIERS
+The following modifiers are supported on Intel IcelakeX UBOX uncore PMU:
+.TP
+.B e
+Enable edge detection, i.e., count only when there is a state transition from no occurrence of the event to at least one occurrence. This modifier must be combined with a threshold modifier (t) with a value greater or equal to one.  This is a boolean modifier.
+.TP
+.B t
+Set the threshold value. When set to a non-zero value, the counter counts the number
+of UBOX clockticks in which the number of occurrences of the event is greater or equal to
+the threshold.  This is an integer modifier with values in the range [0:255].
+.TP
+.B i
+Invert the threshold (t) test from strictly greater than to less or equal to. This is a boolean modifier.
+
+.SH AUTHORS
+.nf
+Stephane Eranian <[email protected]>
+.if
+.PP

src/libpfm4/docs/man3/libpfm_intel_icx_unc_upi.3

@@ -0,0 +1,31 @@
+.TH LIBPFM 3  "November, 2023" "" "Linux Programmer's Manual"
+.SH NAME
+libpfm_intel_icx_unc_upi - support for Intel IcelakeX Server UPI uncore PMU
+.SH SYNOPSIS
+.nf
+.B #include <perfmon/pfmlib.h>
+.sp
+.B PMU name: icx_unc_upi[0-3]
+.B PMU desc: Intel IcelakeX UPI uncore PMU
+.sp
+.SH DESCRIPTION
+The library supports the Intel IcelakeX UPI (Ultra Path Interconnect) uncore PMU.
+Each UPI PMU implements 4 generic counters.
+
+.SH MODIFIERS
+The following modifiers are supported on Intel IcelakeX UPI uncore PMU:
+.TP
+.B e
+Enable edge detection, i.e., count only when there is a state transition from no occurrence of the event to at least one occurrence. This modifier must be combined with a threshold modifier (t) with a value greater or equal to one.  This is a boolean modifier.
+.TP
+.B t
+Set the threshold value. When set to a non-zero value, the counter counts the number
+of IRP clockticks in which the number of occurrences of the event is greater or equal to
+the threshold.  This is an integer modifier with values in the range [0:255].
+.B i
+Invert the threshold (t) test from strictly greater than to less or equal to. This is a boolean modifier.
+.SH AUTHORS
+.nf
+Stephane Eranian <[email protected]>
+.if
+.PP