3.24.0-4 - Split main valgrind package into several subpackages

Resolves: #RHEL-75470
valgrind python dependency - Split off the gdb integration and
python3.11 scripts into a separate subpackage [rhel-10]

- Split main valgrind package into several subpackages:
  - valgrind now contains just the core tools.
  - valgrind-scripts contains the post-processing scripts for callgrind,
    cachegrind, massif and dhat which depend on perl and python.
  - valgrind-gdb contains the debuginfo client/server and (v)gdb support.
  - valgrind-docs contains the man pages, html and pdf manual.
- Adjust Requires/Recommends to subpackages can be installed independently.
  - valgrind-devel now Recommends, instead of Requires, valgrind.
  - valgrind-gdb Requires valgrind
  - valgrind-scripts Recommends valgrind-gdb
  - valgrind-gdb Recommends gdb

valgrind.spec

@@ -3,7 +3,7 @@
 Summary: Dynamic analysis tools to detect memory or thread bugs and profile
 Name: %{?scl_prefix}valgrind
 Version: 3.24.0
-Release: 3%{?dist}
+Release: 4%{?dist}
 Epoch: 1
 
 # This ignores licenses that are only found in the test or perf sources
@@ -139,6 +139,11 @@ BuildRequires: elfutils-debuginfod-client
 Recommends: elfutils-debuginfod-client
 %endif
 
+# Optional subpackages
+Recommends: %{?scl_prefix}valgrind-docs = %{epoch}:%{version}-%{release}
+Recommends: %{?scl_prefix}valgrind-scripts = %{epoch}:%{version}-%{release}
+Recommends: %{?scl_prefix}valgrind-gdb = %{epoch}:%{version}-%{release}
+
 # For running the testsuite.
 # Some of the python scripts require python 3.9+
 BuildRequires: python3-devel
@@ -203,11 +208,43 @@ Summary: Development files for valgrind aware programs
 # But that doesnt have a SPDX identifier yet
 # https://gitlab.com/fedora/legal/fedora-license-data/-/issues/422
 License: bzip2-1.0.6
-Requires: %{?scl_prefix}valgrind = %{epoch}:%{version}-%{release}
+# These are just the header files, so strictly speaking you don't
+# need valgrind itself unless you are testing your builds. This used
+# to be a Requires, so people might depend on the package pulling in
+# the core valgrind package, so make it at least a weak dependency.
+Recommends: %{?scl_prefix}valgrind = %{epoch}:%{version}-%{release}
 
 %description devel
 Header files and libraries for development of valgrind aware programs.
 
+%package docs
+Summary: Documentation for valgrind tools, scripts and gdb integration
+License: GFDL-1.2-or-later
+
+%description docs
+Documentation in html and pdf, plus man pages for valgrind tools and scripts.
+
+%package scripts
+Summary: Scripts for post-processing valgrind tool output
+License: GPL-2.0-or-later
+# Most scripts can be used as is for post-processing a valgrind tool run.
+# But callgrind_control uses vgdb.
+Recommends: %{?scl_prefix}valgrind-gdb = %{epoch}:%{version}-%{release}
+
+%description scripts
+Perl and Python scripts for post-processing valgrind tool output.
+
+%package gdb
+Summary: Tools for integrating valgrind and gdb
+License: GPL-2.0-or-later
+Requires: %{?scl_prefix}valgrind = %{epoch}:%{version}-%{release}
+# vgdb can be used without gdb, just to control valgrind.
+# But normally you use it together with both valgrind and gdb.
+Recommends: gdb
+
+%description gdb
+Tools and support files for integrating valgrind and gdb.
+
 %if %{build_tools_devel}
 %package tools-devel
 Summary: Development files for building valgrind tools.
@@ -424,18 +461,41 @@ echo ===============END TESTING===============
 %{!?_licensedir:%global license %%doc}
 
 %files
-%license COPYING COPYING.DOCS
+%license COPYING
-%doc NEWS README_*
+%{_bindir}/valgrind
-%doc docs/installed/html docs/installed/*.pdf
-%{_bindir}/*
 %dir %{_libexecdir}/valgrind
-# Install everything in the libdir except the .so.
+# Install just the core tools, default suppression and vgpreload libraries.
-# The vgpreload so files might need file mode adjustment.
+%{_libexecdir}/valgrind/default.supp
-%{_libexecdir}/valgrind/*[^o]
+%{_libexecdir}/valgrind/*-*-linux
 # Turn on executable bit again for vgpreload libraries.
 # Was disabled in %%install to prevent debuginfo stripping.
-%attr(0755,root,root) %{_libexecdir}/valgrind/vgpreload*-%{valarch}-*so
+%attr(0755,root,root) %{_libexecdir}/valgrind/vgpreload_*-%{valarch}-linux.so
+
+%files docs
+%license COPYING.DOCS
+%doc NEWS README_*
+%doc docs/installed/html docs/installed/*.pdf
 %{_mandir}/man1/*
+
+%files scripts
+%license COPYING
+%{_bindir}/callgrind_annotate
+%{_bindir}/callgrind_control
+%{_bindir}/cg_annotate
+%{_bindir}/cg_diff
+%{_bindir}/cg_merge
+%{_bindir}/ms_print
+%{_libexecdir}/valgrind/dh_view.css
+%{_libexecdir}/valgrind/dh_view.html
+%{_libexecdir}/valgrind/dh_view.js
+
+%files gdb
+%license COPYING
+%{_bindir}/valgrind-di-server
+%{_bindir}/valgrind-listener
+%{_bindir}/vgdb
+# gdb register descriptions
+%{_libexecdir}/valgrind/*.xml
 %{_datadir}/gdb/auto-load/valgrind-monitor.py
 %{_datadir}/gdb/auto-load/valgrind-monitor-def.py
 
@@ -469,11 +529,25 @@ echo ===============END TESTING===============
 %endif
 
 %changelog
+* Wed Feb 26 2025 Mark Wielaard <mjw@redhat.com> - 3.24.0-4
+- Split main valgrind package into several subpackages:
+  - valgrind now contains just the core tools.
+  - valgrind-scripts contains the post-processing scripts for callgrind,
+    cachegrind, massif and dhat which depend on perl and python.
+  - valgrind-gdb contains the debuginfo client/server and (v)gdb support.
+  - valgrind-docs contains the man pages, html and pdf manual.
+- Adjust Requires/Recommends to subpackages can be installed independently.
+  - valgrind-devel now Recommends, instead of Requires, valgrind.
+  - valgrind-gdb Requires valgrind
+  - valgrind-scripts Recommends valgrind-gdb
+  - valgrind-gdb Recommends gdb
+
 * Tue Jan 14 2025 Mark Wielaard <mjw@redhat.com> - 3.24.0-3
 - Add more VALGRIND_3_24_BRANCH patches
   0012-Recognize-new-DWARF5-DW_LANG-constants.patch
   0013-Bug-498317-FdBadUse-is-not-a-valid-CoreError-type-in.patch
   0014-linux-support-EVIOCGRAB-ioctl.patch
+
 * Tue Nov 26 2024 Mark Wielaard <mjw@redhat.com> - 3.24.0-2
 - Add VALGRIND_3_24_BRANCH patches
   0001-Prepare-NEWS-for-branch-3.24-fixes.patch