[Bug 1960118] Re: [22.04 FEAT] Add new CPU-MF Counters for new IBM Z Hardware - libpfm part

[Frank Heimes]

A test build in PPA, done for all major architectures,
completed successfully and is available here:
https://launchpad.net/~fheimes/+archive/ubuntu/lp1960118

Please see attached the debdiff for jammy...

** Description changed:

+ SRU Justification:
+ ------------------
+ 
+ [Impact]
+ 
+  * This is an hardware enablement SRU,
+    that adds support for the new IBM zSystems hardware in libpfm4.
+ 
+  * It's in particular to add new CPU-MF Counters
+    for new the IBM z16 hardware.
+ 
+  * Otherwise z16-specific CPU performance measurement facility
+    counters cannot be used with libpfm4.
+ 
+ [Fix]
+ 
+  * b03a81 b03a81ea006658b3aa478e22f4d0b7741cf7346f "s390: Update counter
+ definition for IBM z16"
+ 
+ [Test Plan]
+ 
+  * Since libpfm4 is a library, the best was to test it is with the
+    help of a brief test program.
+ 
+  * Install libpfm4-dev_4.11.1+git32-gd0b85fb-1ubuntu0.1_s390x.deb
+    and libpfm4_4.11.1+git32-gd0b85fb-1ubuntu0.1_s390x.deb
+    on an IBM z16 system (with hardware counters enabled).
+    and navigate to /usr/share/doc/libpfm4-dev/examples/ to find the
+    two example programs 'check_events' and 'showevtinfo'
+    and build or compile them.
+ 
+  * Alternatively do this based on the raw project sources:
+    git clone git://perfmon2.git.sourceforge.net/gitroot/perfmon2/libpfm4
+    cd libpfm4
+    make
+ 
+  * Now run the 'showevtinfo' program (in examples subdirectory)
+    to get a list of all available events,
+    masks and modifiers that are supported
+    and look (grep) for z16 related events
+    as they are listed in the commit above.
+ 
+ [Where problems could occur]
+ 
+  * There is not much that can go wrong, other than:
+ 
+  * syntactical errors (will be identified by a test compile)
+ 
+  * making use of 'LIBPFM_ARRAY_SIZE(cpumcf_z16_counters)' for
+    the wrong machine types (but 3931 and 3932 are z16)
+ 
+  * or someone added/assigned the wrong set of counters for
+    the z16 hardware and machine types.
+ 
+  * A test package was build for all major architectures
+    and is available via this PPA:
+    https://launchpad.net/~fheimes/+archive/ubuntu/lp1960118
+ 
+ [Other Info]
+  
+  * Version libpfm4 4.11.1+git74-g5140ce5 in kinetic has the commit/patch
+    already included, since it's a snapshot that was taken after b03a81
+    was brought upstream.
+ __________
+ 
  Add new CPU-MF Counters for new IBM Z Hardware - libpfm part
  
  Description:
  Add new CPU-MF Counters for new IBM Z Hardware.
  
  Has a kernel, s390utils/s390-tools and libpfm part.
  
  Request Type: Package - Update Version
  Upstream Acceptance: In Progress

** Patch added: "debdiff_libpfm4_jammy_from_libpfm4_4.11.1+git32-gd0b85fb-1_to_libpfm4_4.11.1+git32-gd0b85fb-1ubuntu0.1.diff"
   https://bugs.launchpad.net/ubuntu/+source/libpfm4/+bug/1960118/+attachment/5612359/+files/debdiff_libpfm4_jammy_from_libpfm4_4.11.1+git32-gd0b85fb-1_to_libpfm4_4.11.1+git32-gd0b85fb-1ubuntu0.1.diff

** Changed in: libpfm4 (Ubuntu Jammy)
       Status: New => In Progress

** Information type changed from Private to Public

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to libpfm4 in Ubuntu.
https://bugs.launchpad.net/bugs/1960118

Title:
  [22.04 FEAT] Add new CPU-MF Counters for new IBM Z Hardware - libpfm
  part

Status in Ubuntu on IBM z Systems:
  In Progress
Status in libpfm4 package in Ubuntu:
  Fix Released
Status in libpfm4 source package in Jammy:
  In Progress
Status in libpfm4 source package in Kinetic:
  Fix Released

Bug description:
  SRU Justification:
  ------------------

  [Impact]

   * This is an hardware enablement SRU,
     that adds support for the new IBM zSystems hardware in libpfm4.

   * It's in particular to add new CPU-MF Counters
     for new the IBM z16 hardware.

   * Otherwise z16-specific CPU performance measurement facility
     counters cannot be used with libpfm4.

  [Fix]

   * b03a81 b03a81ea006658b3aa478e22f4d0b7741cf7346f "s390: Update
  counter definition for IBM z16"

  [Test Plan]

   * Since libpfm4 is a library, the best was to test it is with the
     help of a brief test program.

   * Install libpfm4-dev_4.11.1+git32-gd0b85fb-1ubuntu0.1_s390x.deb
     and libpfm4_4.11.1+git32-gd0b85fb-1ubuntu0.1_s390x.deb
     on an IBM z16 system (with hardware counters enabled).
     and navigate to /usr/share/doc/libpfm4-dev/examples/ to find the
     two example programs 'check_events' and 'showevtinfo'
     and build or compile them.

   * Alternatively do this based on the raw project sources:
     git clone git://perfmon2.git.sourceforge.net/gitroot/perfmon2/libpfm4
     cd libpfm4
     make

   * Now run the 'showevtinfo' program (in examples subdirectory)
     to get a list of all available events,
     masks and modifiers that are supported
     and look (grep) for z16 related events
     as they are listed in the commit above.

  [Where problems could occur]

   * There is not much that can go wrong, other than:

   * syntactical errors (will be identified by a test compile)

   * making use of 'LIBPFM_ARRAY_SIZE(cpumcf_z16_counters)' for
     the wrong machine types (but 3931 and 3932 are z16)

   * or someone added/assigned the wrong set of counters for
     the z16 hardware and machine types.

   * A test package was build for all major architectures
     and is available via this PPA:
     https://launchpad.net/~fheimes/+archive/ubuntu/lp1960118

  [Other Info]
   
   * Version libpfm4 4.11.1+git74-g5140ce5 in kinetic has the commit/patch
     already included, since it's a snapshot that was taken after b03a81
     was brought upstream.
  __________

  Add new CPU-MF Counters for new IBM Z Hardware - libpfm part

  Description:
  Add new CPU-MF Counters for new IBM Z Hardware.

  Has a kernel, s390utils/s390-tools and libpfm part.

  Request Type: Package - Update Version
  Upstream Acceptance: In Progress

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu-z-systems/+bug/1960118/+subscriptions