From b2b180e27ae7d2a5fa286dce9b7d1db32ff5097a Mon Sep 17 00:00:00 2001 From: Siddhesh Poyarekar Date: Tue, 6 May 2025 12:35:11 -0400 Subject: [PATCH] Add README and gts-annobin-plugin-select.sh to git Move it out of the lookaside cache so that changes can be tracked more easily. Related: RHEL-81745 Resolves: RHEL-88742 --- README | 29 +++++ gts-annobin-plugin-select.sh | 226 +++++++++++++++++++++++++++++++++++ sources | 2 - 3 files changed, 255 insertions(+), 2 deletions(-) create mode 100644 README create mode 100644 gts-annobin-plugin-select.sh diff --git a/README b/README new file mode 100644 index 0000000..df9ab42 --- /dev/null +++ b/README @@ -0,0 +1,29 @@ +Package %{scl_name} is the main package for Red Hat GCC +Toolset 15. By installing the %{scl_name} package, you will get +the working set of packages that are included in Red Hat GCC +Toolset 15, which includes development and debugging tools. + +Usage: scl enable %{scl} + +Red Hat GCC Toolset allows you to build and execute applications +which are not located in the filesystem root hierarchy, but are +stored in an alternative location, which is %{_scl_root} in case +of the %{scl_name} collection. + +Examples: +scl enable %{scl_name} 'command --arg' + Run a specific command with the argument --arg within the %{scl_name} + Red Hat GCC Toolset environment. + +scl enable %{scl_name} 'gcc' + Run GCC from the %{scl_name} Red Hat GCC Toolset. + +scl enable %{scl_name} 'bash' + Run an interactive shell wherein the %{scl_name} software collection + is enabled. + +scl enable %{scl_name} 'man gcc' + Show man pages for the gcc command, which is a part of the + %{scl_name} Red Hat GCC Toolset. + +Report bugs to . diff --git a/gts-annobin-plugin-select.sh b/gts-annobin-plugin-select.sh new file mode 100644 index 0000000..8beac82 --- /dev/null +++ b/gts-annobin-plugin-select.sh @@ -0,0 +1,226 @@ +#!/usr/bin/sh +# This is a script to switch the symlinks in a GTS gcc's plugin +# directory so that they select either the GTS-annobin provided +# plugin or the GTS-gcc provided plugin. + +# Author: Nick Clifton +# Copyright (c) 2021-2022 Red Hat. +# +# This is free software; you can redistribute it and/or modify it +# under the terms of the GNU General Public License as published +# by the Free Software Foundation; either version 2, or (at your +# option) any later version. + +# It is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# Usage: +# gts-annobin-plugin-select scl_root +# + +# Set this variable to non-zero to enable the generation of debugging +# messages. +debug=0 + +if test "x$1" = "x" ; +then + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Must provide a root directory" + fi + exit 1 +else + scl_root=$1 +fi + +# This script is similar to the redhat-annobin-plugin-select.sh script which +# is part of the redhat-rpm-config package. That scripts decides between two +# versions of the annobin plugin for the system compiler and stores it choice +# in a symlink in the /usr/lib/rpm/redhat directory. The choice eventually +# resolves into the system gcc attempting to load either a plugin called +# annobin.so or a plugin called gcc-annobin.so. + +# In a GTS environment the choice made by redhat-annobin-plugin-select.sh +# might not be appropriate (or even possible). The choice cannot be changed +# because the system compilation environment must remain instact. So instead +# the GTS versions of gcc and annobin install plugins called gts-annobin.so +# and gts-gcc-annobin.so (into the GTS gcc's plugin directory) and this script +# creates a pair of symlinks called annobin.so and gcc-annobin.so. In this +# way the decision made by redhat-annobin-plugin-select.sh is overridden +# without affecting any system files. + +# We cannot be sure that this script will run inside a GTS enabled shell, +# so we have to use absolute paths. +gts_gcc=$scl_root/usr/bin/gcc + +if [ ! -x $gts_gcc ] +then + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Could not find gcc. Expected: $gts_gcc" + fi + exit 0 +fi + +# This is where the annobin package stores the information on the version +# of gcc that built the annobin plugin. +aver=`$gts_gcc --print-file-name=plugin`/annobin-plugin-version-info + +# This is where the gcc package stores its version information. +gver=`$gts_gcc --print-file-name=rpmver` + +aplugin=`$gts_gcc --print-file-name=plugin`/gts-annobin.so.0.0.0 +gplugin=`$gts_gcc --print-file-name=plugin`/gts-gcc-annobin.so.0.0.0 + +install_annobin_version=0 +install_gcc_version=0 + +if [ -f $aplugin ] +then + if [ -f $gplugin ] + then + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Both plugins exist, checking version information" + fi + + if [ -f $gver ] + then + if [ -f $aver ] + then + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Both plugin version files exist - comparing..." + fi + + # Get the first line from the version info files. This is just in + # case there are extra lines in the files. + avers=`head --lines=1 $aver` + gvers=`head --lines=1 $gver` + + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Annobin plugin built by gcc $avers" + echo " gts-annobin-plugin-select: GCC plugin built by gcc $gvers" + fi + + # If both plugins were built by the same version of gcc then select + # the one from the annobin package (in case it is built from newer + # sources). If the plugin builder versions differ, select the gcc + # built version instead. This assumes that the gcc built version + # always matches the installed gcc, which should be true. + if [ $avers = $gvers ] + then + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Both plugins built by the same compiler - using annobin-built plugin" + fi + install_annobin_version=1 + else + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Versions differ - using gcc-built plugin" + fi + install_gcc_version=1 + fi + else + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Annobin version file does not exist, using gcc-built plugin" + fi + install_gcc_version=1 + fi + else + if [ -f $aver ] + then + # FIXME: This is suspicious. If the installed GCC does not supports plugins + # then enabling the annobin plugin will not work. + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: GCC plugin version file does not exist, using annobin-built plugin" + fi + install_annobin_version=1 + else + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Neither version file exists - playing safe and using gcc-built plugin" + echo " gts-annobin-plugin-select: Note: expected to find $aver and/or $gver" + fi + install_gcc_version=1 + fi + fi + else + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Only the annobin plugin exists - using that" + fi + install_annobin_version=1 + fi +else + if [ -f $gplugin ] + then + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Only the gcc plugin exists - using that" + fi + install_gcc_version=1 + else + aplugin=`$gts_gcc --print-file-name=plugin`/annobin.so.0.0.0 + + if [ -f $aplugin ] + then + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Original annobin plugin exists - renaming" + echo " gts-annobin-plugin-select: Using renamed original annobin plugin" + fi + pushd `$gts_gcc --print-file-name=plugin` > /dev/null + mv annobin.so.0.0.0 gts-annobin.so.0.0.0 + popd > /dev/null + install_annobin_version=1 + else + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Neither plugin exists - playing safe and not changing anything" + echo " gts-annobin-plugin-select: Note: expected to find $aplugin and/or $gplugin" + fi + fi + fi +fi + +if [ $install_annobin_version -eq 1 ] +then + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Setting symlinks for the annobin version of the plugin" + fi + pushd `$gts_gcc --print-file-name=plugin` > /dev/null + rm -f gcc-annobin.so.0.0.0 annobin.so.0.0.0 gcc-annobin.so annobin.so + ln -s gts-annobin.so.0.0.0 annobin.so + ln -s gts-annobin.so.0.0.0 gcc-annobin.so + ln -s gts-annobin.so.0.0.0 annobin.so.0.0.0 + ln -s gts-annobin.so.0.0.0 gcc-annobin.so.0.0.0 + popd > /dev/null + +else if [ $install_gcc_version -eq 1 ] +then + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: Setting symlinks for the gcc version of the plugin" + fi + pushd `$gts_gcc --print-file-name=plugin` > /dev/null + rm -f gcc-annobin.so.0.0.0 annobin.so.0.0.0 gcc-annobin.so annobin.so + ln -s gts-gcc-annobin.so.0.0.0 annobin.so + ln -s gts-gcc-annobin.so.0.0.0 gcc-annobin.so + ln -s gts-gcc-annobin.so.0.0.0 annobin.so.0.0.0 + ln -s gts-gcc-annobin.so.0.0.0 gcc-annobin.so.0.0.0 + popd > /dev/null +else + if [ $debug -eq 1 ] + then + echo " gts-annobin-plugin-select: NOT CHANGING SYMLINKS" + fi +fi +fi diff --git a/sources b/sources index 9e43e83..e69de29 100644 --- a/sources +++ b/sources @@ -1,2 +0,0 @@ -SHA512 (README) = 213f19a40aa61549f533414e1042ec9d079ec45923953c69bb84007cdba19e54d9baac44422cd6b991f8acacfb13329e4cb027ffd762505d35814603dbb4dcf2 -SHA512 (gts-annobin-plugin-select.sh) = f5e5f4dc054bdd09c6d185bc3c671376ff8b825c8fa3f2969e25e10358405aa105f74154c63b6dc025cbe7e09eb24693664048685aaf481cc2a65d12ad9476b8