From Fedora Project Wiki
No edit summary
No edit summary
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<!-- The actual name of your proposed change page should look something like: Changes/Your_Change_Proposal_Name.  This keeps all change proposals in the same namespace -->
<!-- The actual name of your proposed change page should look something like: Changes/Your_Change_Proposal_Name.  This keeps all change proposals in the same namespace -->


= GNU Toolchain Update (glibc 2.36, binutils?, gdb?) <!-- The name of your change proposal --> =
= GNU Toolchain Update (glibc 2.36, binutils 2.38) <!-- The name of your change proposal --> =
 


== Summary ==
== Summary ==
<!-- A sentence or two summarizing what this change is and what it will do. This information is used for the overall changeset summary page for each release. Note that motivation for the change should be in the Benefit to Fedora section below, and this part should answer the question "What?" rather than "Why?". -->
<!-- A sentence or two summarizing what this change is and what it will do. This information is used for the overall changeset summary page for each release. Note that motivation for the change should be in the Benefit to Fedora section below, and this part should answer the question "What?" rather than "Why?". -->


Update the Fedora 37 GNU Toolchain to glibc 2.36, binutils? and gdb?.
Update the Fedora 37 GNU Toolchain to glibc 2.36, binutils 2.38.
 
The set of core GNU Toolchain packages for Fedora 37 are as follows:
 
* GNU C Compiler 12 (first released in Fedora 36)
** Associated runtimes for C++ (libstdc++), Go (gccgo), OpenMP (gomp), Fortran (gfortran), D (phobos), Objective C/C++.
* GNU Binary Utilities 2.38 (expected release in Fedora 37)
* GNU C Library 2.36 (expected release in Fedora 37)
* GNU Debugger 12 (immediately available in Fedora 35, 36, and 37)


The glibc 2.36 change will be tracked in this top-level GNU Toolchain system-wide update.
The glibc 2.36 change will be tracked in this top-level GNU Toolchain system-wide update.


The binutils 2.38 change will be tracked in this top-level GNU Toolchain system-wide update.


== Owner ==
== Owner ==
Line 26: Line 34:


== Current status ==
== Current status ==
[[Category:ChangePageIncomplete]]
[[Category:ChangeAcceptedF37]]
<!-- When your change proposal page is completed and ready for review and announcement -->
<!-- When your change proposal page is completed and ready for review and announcement -->
<!-- remove Category:ChangePageIncomplete and change it to Category:ChangeReadyForWrangler -->
<!-- remove Category:ChangePageIncomplete and change it to Category:ChangeReadyForWrangler -->
Line 44: Line 52:
ON_QA -> change is fully code complete
ON_QA -> change is fully code complete
-->
-->
* Notified Fedora Devel: [] (TODO: Notify Fedora Devel)
* [https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/thread/72MYJW4PQENMESOXB5QIIBSJU3GUVEDX/ devel thread]
* Updated redhat-rpm-config: [] (TODO: Check if redhat-rpm-config needs updating for the new toolchain)
* Updated redhat-rpm-config: [] (TODO: Check if redhat-rpm-config needs updating for the new toolchain)
** Are config.guess and config.sub up to date from upstream?
** Are config.guess and config.sub up to date from upstream?
* FESCo issue: [] (TODO: File FESCo ticket)
* FESCo issue: [https://pagure.io/fesco/issue/2831 #2831]
* Tracker bug: [] (TODO: Relase tracking bug)
* Tracker bug: [https://bugzilla.redhat.com/show_bug.cgi?id=2108675 #2108675]
* Release notes tracker: [] (TODO: Relase note tracker)
* Release notes tracker: [https://pagure.io/fedora-docs/release-notes/issue/862 #862]


== Detailed Description ==
== Detailed Description ==
Line 62: Line 70:
The GNU C Library version 2.36 is expected to be released in the beginning of August 2022; we have started closely tracking the glibc 2.36 development code in Fedora Rawhide and are addressing any issues as they arise. Given the present schedule Fedora 37 will branch after the release of glibc 2.36. However, the mass rebuild schedule means Fedora 37 will mass rebuild (if required) before the final release of glibc 2.36, but after the ABI is frozen.
The GNU C Library version 2.36 is expected to be released in the beginning of August 2022; we have started closely tracking the glibc 2.36 development code in Fedora Rawhide and are addressing any issues as they arise. Given the present schedule Fedora 37 will branch after the release of glibc 2.36. However, the mass rebuild schedule means Fedora 37 will mass rebuild (if required) before the final release of glibc 2.36, but after the ABI is frozen.


<!-- Use this text for a BINUTLS/GDB update: -->
<!-- Use this text for a BINUTILS update: -->
<!-- TODO: Update binutils and gdb text.  -->
The GNU Binutils version 2.38 was released in February 2022; and we have already been using this version of binutils in Fedora Rawhide successfully to build the distribution. Given the present schedule for Fedora 37 we will continue to use Binutils 2.38 for Fedora 37.
<!-- The GNU Binutils version 2.37 and GNU Debugger version 11.1 currently included in Fedora 35 will continue to be included in Fedora 36. There will be a GNU Binutils version 2.38 released at the end of January, but the inclusion will be scheduled for Fedora 37. -->
 
<!-- Use this text for a GDB update: -->
<!-- The GNU Debugger version 13 was released in February 2023; and we plan to include this release with Fedora 38. -->


== Benefit to Fedora ==
== Benefit to Fedora ==
Line 98: Line 108:


The goal is to track and transition to the latest components of the GNU Toolchain.
The goal is to track and transition to the latest components of the GNU Toolchain.


== Scope ==
== Scope ==
Line 105: Line 114:
* Other developers: Given that glibc is backwards compatible and we have been testing the new glibc in rawhide it should make very little impact when updated, except for the occasional deprecation warnings and removal of legacy interfaces from public header files. <!-- What work do other developers have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?-->
* Other developers: Given that glibc is backwards compatible and we have been testing the new glibc in rawhide it should make very little impact when updated, except for the occasional deprecation warnings and removal of legacy interfaces from public header files. <!-- What work do other developers have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?-->


* Release engineering: A mass rebuild is strongly encouraged; [] (TODO: releng ticket for mass rebuild)
* Release engineering: A mass rebuild is strongly encouraged; [https://pagure.io/releng/issue/10865 #10865]
<!-- Does this feature require coordination with release engineering (e.g. changes to installer image generation or update package delivery)?  Is a mass rebuild required?  include a link to the releng issue.  
<!-- Does this feature require coordination with release engineering (e.g. changes to installer image generation or update package delivery)?  Is a mass rebuild required?  include a link to the releng issue.  
The issue is required to be filed prior to feature submission, to ensure that someone is on board to do any process development work and testing and that all changes make it into the pipeline; a bullet point in a change is not sufficient communication -->
The issue is required to be filed prior to feature submission, to ensure that someone is on board to do any process development work and testing and that all changes make it into the pipeline; a bullet point in a change is not sufficient communication -->
Line 127: Line 136:


<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 
Any source level changes required for glibc 2.36 will be noted here: https://sourceware.org/glibc/wiki/Release/2.36#Packaging_Changes


== How To Test ==
== How To Test ==
Line 148: Line 157:


<!-- Use this text for a GLIBC update: -->
<!-- Use this text for a GLIBC update: -->
The GNU C Library has its own testsuite, which is run during the package build and examined by the glibc developers before being uploaded. This test suite has over 6200 tests that run to verify the correct operation of the library. In the future we may also run the microbenchmark to look for performance regressions.
The GNU C Library has its own testsuite which is run during the package build and examined by the glibc developers before being uploaded. This test suite has over 6200 tests that run to verify the correct operation of the library. In the future we may also run the microbenchmark to look for performance regressions.


<!-- Use this text for a BINUTILS update: -->
<!-- Use this text for a BINUTILS update: -->
The GNU Binutils has its own testsuite which is run during the package build and examined by binutils developers before being uploaded. The regression testsuite is run to verify the correct operation of the static linker and attendant utilities.


<!-- Use this text for a GDB update: -->
<!-- Use this text for a GDB update: -->
The GNU Debugger has its own testsuite which is run during the package build and examined by gdb developers before being uploaded. The regression testsuite is run to verify the correct operation of the debugger.




Line 172: Line 183:
<!-- What other packages (RPMs) depend on this package?  Are there changes outside the developers' control on which completion of this change depends?  In other words, completion of another change owned by someone else and might cause you to not be able to finish on time or that you would need to coordinate?  Other upstream projects like the kernel (if this is not a kernel change)? -->
<!-- What other packages (RPMs) depend on this package?  Are there changes outside the developers' control on which completion of this change depends?  In other words, completion of another change owned by someone else and might cause you to not be able to finish on time or that you would need to coordinate?  Other upstream projects like the kernel (if this is not a kernel change)? -->
All packages do not need to be rebuilt due to backwards compatibility. However, it is advantageous if a mass rebuild is performed during the Fedora 37 cycle. The mass rebuild would ensure all packages can be built with the newer compiler and core runtime.
All packages do not need to be rebuilt due to backwards compatibility. However, it is advantageous if a mass rebuild is performed during the Fedora 37 cycle. The mass rebuild would ensure all packages can be built with the newer compiler and core runtime.


== Contingency Plan ==
== Contingency Plan ==


<!-- If you cannot complete your feature by the final development freeze, what is the backup plan?  This might be as simple as "Revert the shipped configuration".  Or it might not (e.g. rebuilding a number of dependent packages).  If you feature is not completed in time we want to assure others that other parts of Fedora will not be in jeopardy.  -->
<!-- If you cannot complete your feature by the final development freeze, what is the backup plan?  This might be as simple as "Revert the shipped configuration".  Or it might not (e.g. rebuilding a number of dependent packages).  If you feature is not completed in time we want to assure others that other parts of Fedora will not be in jeopardy.  -->
* Contingency mechanism glibc: If glibc 2.36 proves too disruptive to compiling the distribution we could revert to 2.35, but given that Rawhide has started tracking glibc 2.36, no show-stopper problems are expected.  At this point, we can still revert to upstream version 2.35 if insurmountable problems appear, but to do so may require a mass rebuild to remove new symbols from the ABI/API.   
* Contingency mechanism glibc: If glibc 2.36 proves too disruptive to compiling the distribution we could revert to 2.35, but given that Rawhide has started tracking glibc 2.36, no show-stopper problems are expected.  At this point we can still revert to upstream version 2.35 if insurmountable problems appear, but to do so may require a mass rebuild to remove new symbols from the ABI/API.   
 
* Contingency mechanism binutils: If binutils 2.38 proves too distruptive to assembling and linking the distribution we could revert to 2.37, but given that Rawhide is using 2.38, no show-stopper problems are expected. At this point we can still revert if insurmountable problems appear, but to do so may require a mass rebuild if the defects involve generated binaries.


<!-- Use this text for a GCC update: -->
<!-- Use this text for a GCC update: -->
<!-- Not needed in F37 because GCC is not being updated. -->
<!-- Not needed in F37 because GCC is not being updated. -->
<!-- * Contingency mechanism for gcc: If gcc 12 proves too disruptive to compiling the distribution we could revert to gcc 11. -->
<!-- * Contingency mechanism for gcc: If gcc 12 proves too disruptive to compiling the distribution we could revert to gcc 11. -->
<!-- Use this text for a GDB update: -->
<!-- Not needed in F37 because GDB is not being updated. -->
<!-- * Contingency mechanism for gdb: If gdb 12 proves too disruptive to debugging the distribution we could revert to gdb 11. -->


<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- When is the last time the contingency mechanism can be put in place?  This will typically be the beta freeze. -->
<!-- When is the last time the contingency mechanism can be put in place?  This will typically be the beta freeze. -->
* Contingency deadline: Fedora mass rebuild on 2022-01-19. <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
* Contingency deadline: Fedora mass rebuild on 2022-07-20. <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- Does finishing this feature block the release, or can we ship with the feature in incomplete state? -->
<!-- Does finishing this feature block the release, or can we ship with the feature in incomplete state? -->
* Blocks release?
* Blocks release?
* Yes, upgrading to glibc 2.35 does block the release.
** Yes, upgrading to glibc 2.36 does block the release.
<!-- Use this text for gcc update: * Yes, upgrading to the gcc 12 release blocks the release. -->
<!-- Use this text for gcc update: * Yes, upgrading to the gcc 12 release blocks the release. -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->


== Documentation ==
== Documentation ==
<!-- Is there upstream documentation on this change, or notes you have written yourself?  Link to that material here so other interested developers can get involved. -->
<!-- Is there upstream documentation on this change, or notes you have written yourself?  Link to that material here so other interested developers can get involved. -->
The gcc manual contains the documentation for the release and doesn't need any more additional work.
The gcc manual contains the documentation for the release and doesn't need any more additional work.
The binutils manual contains the documentation for the release and doesn't need any more additional work.


The glibc manual contains the documentation for the release and doesn't need any more additional work.
The glibc manual contains the documentation for the release and doesn't need any more additional work.
The gdb manual contains the documentation for the release and doesn't need any more additional work.
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->


== Release Notes ==
== Release Notes ==
Line 213: Line 231:
<!-- Use this text for GLIBC updates: -->
<!-- Use this text for GLIBC updates: -->
The GNU C Library version 2.36 will be released at the beginning of August 2022. The current NEWS notes can be seen here as they are added: https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;hb=HEAD
The GNU C Library version 2.36 will be released at the beginning of August 2022. The current NEWS notes can be seen here as they are added: https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;hb=HEAD
The GNU Binary Utilities version 2.38 was released February 2022. The current release notes can be seen here: https://sourceware.org/pipermail/binutils/2022-February/119721.html
Created from the template here: https://fedoraproject.org/wiki/Changes/GNUToolchainFXX

Latest revision as of 20:59, 25 August 2022


GNU Toolchain Update (glibc 2.36, binutils 2.38)

Summary

Update the Fedora 37 GNU Toolchain to glibc 2.36, binutils 2.38.

The set of core GNU Toolchain packages for Fedora 37 are as follows:

  • GNU C Compiler 12 (first released in Fedora 36)
    • Associated runtimes for C++ (libstdc++), Go (gccgo), OpenMP (gomp), Fortran (gfortran), D (phobos), Objective C/C++.
  • GNU Binary Utilities 2.38 (expected release in Fedora 37)
  • GNU C Library 2.36 (expected release in Fedora 37)
  • GNU Debugger 12 (immediately available in Fedora 35, 36, and 37)

The glibc 2.36 change will be tracked in this top-level GNU Toolchain system-wide update.

The binutils 2.38 change will be tracked in this top-level GNU Toolchain system-wide update.

Owner


Current status

  • Targeted release: Fedora Linux 37
  • Last updated: 2022-08-25
  • devel thread
  • Updated redhat-rpm-config: [] (TODO: Check if redhat-rpm-config needs updating for the new toolchain)
    • Are config.guess and config.sub up to date from upstream?
  • FESCo issue: #2831
  • Tracker bug: #2108675
  • Release notes tracker: #862

Detailed Description

The GNU Compiler Collection, GNU C Library, GNU Debugger, and GNU Binary Utilities make up the core part of the GNU Toolchain and it is useful for our users to transition these components as a complete implementation when making a new release of Fedora.


The GNU C Library version 2.36 is expected to be released in the beginning of August 2022; we have started closely tracking the glibc 2.36 development code in Fedora Rawhide and are addressing any issues as they arise. Given the present schedule Fedora 37 will branch after the release of glibc 2.36. However, the mass rebuild schedule means Fedora 37 will mass rebuild (if required) before the final release of glibc 2.36, but after the ABI is frozen.

The GNU Binutils version 2.38 was released in February 2022; and we have already been using this version of binutils in Fedora Rawhide successfully to build the distribution. Given the present schedule for Fedora 37 we will continue to use Binutils 2.38 for Fedora 37.


Benefit to Fedora

Stays up to date with latest features, improvements, security and bug fixes from gcc, glibc, binutils, and gdb upstream.

The goal is to track and transition to the latest components of the GNU Toolchain.

Scope

  • Proposal owners: Fedora Toolchain Team (gcc, glibc, binutils, gdb, ...) developers need to ensure that gcc, glibc, binutils, and gdb in rawhide are stable and ready for the Fedora 37 branch.
  • Other developers: Given that glibc is backwards compatible and we have been testing the new glibc in rawhide it should make very little impact when updated, except for the occasional deprecation warnings and removal of legacy interfaces from public header files.
  • Release engineering: A mass rebuild is strongly encouraged; #10865
  • Policies and guidelines: N/A (not needed for this Change)
  • Trademark approval: N/A (not needed for this Change)
  • Alignment with Objectives: N/A


Upgrade/compatibility impact

The compiler, the static linker and the the library are backwards compatible with the previous version of Fedora.


Any source level changes required for glibc 2.36 will be noted here: https://sourceware.org/glibc/wiki/Release/2.36#Packaging_Changes

How To Test

The GNU Compiler Collection has its own testsuite which is run during the package build and examined by the gcc developers before being uploaded.

The GNU C Library has its own testsuite which is run during the package build and examined by the glibc developers before being uploaded. This test suite has over 6200 tests that run to verify the correct operation of the library. In the future we may also run the microbenchmark to look for performance regressions.

The GNU Binutils has its own testsuite which is run during the package build and examined by binutils developers before being uploaded. The regression testsuite is run to verify the correct operation of the static linker and attendant utilities.

The GNU Debugger has its own testsuite which is run during the package build and examined by gdb developers before being uploaded. The regression testsuite is run to verify the correct operation of the debugger.


User Experience

Dependencies

All packages do not need to be rebuilt due to backwards compatibility. However, it is advantageous if a mass rebuild is performed during the Fedora 37 cycle. The mass rebuild would ensure all packages can be built with the newer compiler and core runtime.

Contingency Plan

  • Contingency mechanism glibc: If glibc 2.36 proves too disruptive to compiling the distribution we could revert to 2.35, but given that Rawhide has started tracking glibc 2.36, no show-stopper problems are expected. At this point we can still revert to upstream version 2.35 if insurmountable problems appear, but to do so may require a mass rebuild to remove new symbols from the ABI/API.
  • Contingency mechanism binutils: If binutils 2.38 proves too distruptive to assembling and linking the distribution we could revert to 2.37, but given that Rawhide is using 2.38, no show-stopper problems are expected. At this point we can still revert if insurmountable problems appear, but to do so may require a mass rebuild if the defects involve generated binaries.


  • Contingency deadline: Fedora mass rebuild on 2022-07-20.
  • Blocks release?
    • Yes, upgrading to glibc 2.36 does block the release.

Documentation

The gcc manual contains the documentation for the release and doesn't need any more additional work.

The binutils manual contains the documentation for the release and doesn't need any more additional work.

The glibc manual contains the documentation for the release and doesn't need any more additional work.

The gdb manual contains the documentation for the release and doesn't need any more additional work.

Release Notes

The GNU C Library version 2.36 will be released at the beginning of August 2022. The current NEWS notes can be seen here as they are added: https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;hb=HEAD

The GNU Binary Utilities version 2.38 was released February 2022. The current release notes can be seen here: https://sourceware.org/pipermail/binutils/2022-February/119721.html

Created from the template here: https://fedoraproject.org/wiki/Changes/GNUToolchainFXX