Skip to content

README.md

Latest commit

 

History

History
79 lines (70 loc) · 2.7 KB

README.md

File metadata and controls

79 lines (70 loc) · 2.7 KB

Description

This repository is designed to be used with OpenELA ELValidated tools provided at repository. https://github.com/openela/ELValidated-abi

Tools, provided at https://github.com/openela/ELValidated-abi, are inteded to work with self-generated set of metadata and with reference metadata provided by OpenELA at https://github.com/openela/Compatibility

You can use provided reference metadata to validate your binaries for compatibility with OpenELA, and you can generate your own reference metadata by using tools, provided in ELValidated-abi repository, and use your self-generated set of metadata to run validation.

Reporting issues:

If you see any issues with reference metadata provided, please report issues by filing a github issue at https://github.com/openela/Compatibility/issues

If you see any issues with the tooling provided in ELValidated-abi repository, please report issues by filing a github issue at https://github.com/openela/ELValidated-abi

Sample usage

  • Prepare ELValidated tools, including libabigail >= 2.6 with CTF backend enabled
  • Clone repository with reference metadata or populate your own repository with your metadata, generated on your system.
  • prepare the rpm(s), you want to validate, and debuginfo rpm(s) for that rpm(s).
  • run

    elvalidated-abi /home/myuser/testrpms/glibc-2.34-100.el9_4.4.x86_64.rpm --dir /home/myuser/Compatibility/el9/

  • For more details please read https://github.com/openela/ELValidated-abi/blob/main/README.md .

List of packages we generate metadata for

We plan to expand the number of packages we generate metadata for. Current list of packages, for which we generate metadata is:

  • anaconda-widgets
  • autofs
  • binutils
  • compat-libgfortran-48
  • compat-openssl11
  • coreutils
  • expect
  • firefox
  • fwupd
  • galera
  • gcc
  • gcc-toolset-12-gcc
  • gcc-toolset-13-binutils
  • gdm
  • glibc
  • gstreamer1-rtsp-server
  • iscsi-initiator-utils
  • java-11-openjdk
  • java-17-openjdk
  • libblockdev
  • libdb
  • libdnf
  • libguestfs
  • libkcapi
  • libnbd
  • libreoffice-base
  • libreoffice-calc
  • libreoffice-impress
  • libreoffice-writer
  • libreport
  • libvirt-daemon-driver-interface
  • libvirt-daemon-driver-network
  • libvirt-daemon-driver-nodedev
  • libvirt-daemon-driver-nwfilter
  • libvirt-daemon-driver-qemu
  • libvirt-daemon-driver-secret
  • libvirt-libs
  • libxslt
  • mpich
  • NetworkManager
  • ocaml
  • open-vm-tools
  • openscap
  • PackageKit
  • pam
  • pcre2
  • procps-ng
  • systemd
  • systemtap-devel

Important notes

For some packages process of generation of metadata and comparison of metadata requires more binary and debug packages submitted to the tool. It may include multiple rpms and additional debuginfo or/and debugsource rpm packages. Please explore tools, report issues, submit examples!