The page source contains comments providing guidance to fill out each section. They are invisible when viewing this page. To read it, choose the "view source" link.
Copy the source to a new page before making changes! DO NOT EDIT THIS TEMPLATE FOR YOUR CHANGE PROPOSAL.
For details on how to fill out this form, see the documentation.
To report an issue with this template, file an issue in the pgm_docs repo.
LLVM 18
This document represents a proposed Change. As part of the Changes process, proposals are publicly announced in order to receive community feedback. This proposal will only be implemented if approved by the Fedora Engineering Steering Committee.
Summary
Update all llvm sub-projects in Fedora Linux to version 17.
Owner
- Name: Tom Stellard
- Email: <tstellar@redhat.com>
Current status
- Targeted release: Fedora Linux 40
- Last updated: 2023-12-15
- [<will be assigned by the Wrangler> devel thread]
- FESCo issue: <will be assigned by the Wrangler>
- Tracker bug: <will be assigned by the Wrangler>
- Release notes tracker: <will be assigned by the Wrangler>
Detailed Description
All llvm sub-projects in Fedora will be updated to version 18, and there will be a soname version change for the llvm libraries. Compatibility packages clang17, llvm17, and lld17 will be added to ensure that packages that currently depend on clang and llvm version 17 libraries will continue to work. These older compatibility packages will be orphaned:
- llvm14
- llvm15
- llvm16
- clang14
- clang15
- clang16
- lld14
- lld15
- lld16
Other notable changes:
- clang will emit DWARF-5 by default instead of DWARF-4. This matches the upstream default. We have been using DWARF-4 as the default for the last few releases due to: https://bugzilla.redhat.com/show_bug.cgi?id=2064052
- [UNCONFIRMED] The compatibility packages will now include the same content as the main package. In previous releases, the compat packages contained only libraries and headers. The binaries and other content was stripped out.
- [UNCONFIRMED] We will be adding an llvm19 package to rawhide which will be used to package periodic snapshots from upstream LLVM. We are also investigating switching to python-like parallel versions for Fedora 41, and if we decided to do this, then llvm19 will become the 'main' llvm package in Fedora 41.
- [UNCONFIRMED] We will be enabling the FAT LTO feature.
LLVM Build Schedule
Important Dates
- Jan 27: Upstream: 18.0.0-rc1 Release
- Feb 6: Fedora: f40 branch created
- Feb 6: Upstream: 18.0.0-rc2 Release
- Feb 20: Fedora: f40 Beta Freeze
- Feb 20: Upstream: 18.0.0-rc3 Release
- Mar 5: Upstream: 18.0.0 Release
- Apr 2: Fedora: f40 Final Freeze
Plan
- Build LLVM 18.0.0-rc1 in COPR.
- Build LLVM 18.0.0-rc1 into a rawhide side-tag in Koji.
- Build LLVM 18.0.0-rc1 into a f39 side-tag in Koji.
- Build LLVM 18.0.0-rc2 into a rawhide side-tag in Koji.
- Build LLVM 18.0.0-rc2 into a f39 side-tag in Koji.
- Build LLVM 18.0.0-rc3 into a rawhide side-tag in Koji
- Build LLVM 18.0.0-rc3 into a f39 side-tag in Koji
- Push F39 Bodhi Update with 18.0.0-rc3 (or 17.0.0-rc2 if -rc3 is not ready) as a Beta Freeze exception.
- Continue building new release candidates and pushing them to stable until the Final Freeze.
We are not planning to push 18.0.0-rc1 into rawhide because the library ABI is not stabilized at that point. Typically, the ABI stabilizes after -rc3, but there are no guarantees from upstream about this. Given the history of minimal ABI changes after -rc3, we feel like it's safe to push -rc3 into rawhide. The worst case scenario would be an ABI change -rc4 or the fianl release that we force us to patch LLVM to maintain compatibility with the -rc3 ABI. This scenario would not require rebuilding LLVM library users in Fedora, so this would not require much extra work from our team.
Updates after 17.0.0-rc3 will generally be very small and can be done after the Final Freeze is over. If we are late packaging release candidates after -rc3 or the final release, we will not ask for a Final Freeze exception, unless they contain a fix for a critical release blocking bug.
Feedback
Benefit to Fedora
New features and bug fixes provided by the latest version of LLVM.
Scope
- Proposal owners:
- Review existing llvm and clang compatibility packages and orphan any packages that are no longer used.
- Do scratch builds of Fedora packages that depend on llvm and report issues to package maintainer.
- Other developers:
- Fix build issues found with LLVM-18 or switch their package to use the llvm16 compat libs. The LLVM team no longer plans to block Bodhi updates on dependent packages that fail to build or run with LLVM-18. There should be around 6-8 weeks between when -rc1 lands in koji and the Final Freeze for package maintainers to fix issues uncovered with the LLVM-18 update.
- Release engineering: #Releng issue number
- Policies and guidelines: N/A (not needed for this Change)
- Trademark approval: N/A (not needed for this Change)
- Alignment with Community Initiatives:
Upgrade/compatibility impact
This change should not impact upgrades.
How To Test
User Experience
Dependencies
Contingency Plan
- Contingency mechanism: (What to do? Who will do it?) N/A (not a System Wide Change)
- Contingency deadline: N/A (not a System Wide Change)
- Blocks release? N/A (not a System Wide Change), Yes/No
Documentation
N/A (not a System Wide Change)