GCC Front-End For Rust

Alternative Rust Compiler for GCC

View the Project on GitHub

November 2024 Monthly report

Overview

Thanks again to Open Source Security, inc and Embecosm for their ongoing support for this project.

Project update

GCC development entered stage 3 this month, meaning that gccrs is no longer allowed to submit patches that affect the entire GCC framework until the project re-enters stage 1, after the release of GCC 15.1. This is not an issue for us, as we took special care to send the affected patches upstream back in June of this year, giving them plenty of time to get reviewed and merged before stage 3. In other GCC news, the baseline for building the compiler got bumped from GCC 4.8 to GCC 5.4 - this means that the oldest compiler that we are expected to target is newer and adds support for C++14. Thanks to Sam James and Marc Poulhiès, we have updated our CI to reflect this change. Thank you both!

Most of the pull-requests this month were focused on name resolution, with even more improvements made by Owen Avery. Owen has been a contributor to the project for two years, and has been extremely helpful recently with our name resolution rewrite (NR2.0), by working on integrating it to all areas of the compiler. We will thus be welcoming Owen to the core gccrs team of contributors.

An interesting technical change this month concerns the type-checking of match expressions. In one certain case, match expressions can resolve to the never type. This is interesting for empty ~enum~s, which can be used to represent invalid or impossible states. A well known type from the standard library is Infallible, whose definition is as follows:

enum Infallible {}

Since this enum does not contain any variants, matching on it looks a bit strange:

fn handle_infallible(x: Infallible) {
    let y = match x {};
}

In that case, what should the type of y be? Since we cannot extract any information from x, it doesn’t really make sense to give y a regular type. Furthermore, since we cannot instantiate a value of type Infallible in the first place, it does not make sense to do pattern-matching on it to extract information! But by making this pattern matching resolve to the never type, we can implement traits on Infallible in order to use it just like a regular error type - since never can always coerce to any target type, as it cannot exist in the first place. This makes empty pattern matching required for handling the Infallible type and its trait implementations, which is required for handling code that can never fail. The documentation of the enum gives an interesting example, in which the TryFrom<T> trait can be implemented for U when U already implements From<T>. Because we know the conversion can never fail, there is no need to expose a proper error type, as those errors will never show up.

The fix for this is quite simple - if the match we are type-checking is empty, then we can just resolve its type to never. If the match is not supposed to be empty (for example, if we are matching on an enum with one or more variants), then it’s up to the exhaustiveness checker to report an issue - not the type-checker!

If you are curious, you can see how this special case is handled in gccrs and in rustc.

In other technical news, Antoni Boucher, lead developer of the rustc_codegen_gcc project, contributed code to gccrs this month in order to improve target feature detection for both of our projects. This code concerns platform-specific information that the compilers needs to know about in order to produce correct assembly. By reusing the same code in both projects, we ensure that Rust code compiled using one of the GCC-based compilers will behave the same way on the users’ machines. This change also makes it easier to adapt our target configuration values for Rust if the need arises. Thank you Antoni!

Finally, a blogpost written in collaboration with the Rust project was also published on the official Rust blog: https://blog.rust-lang.org/2024/11/07/gccrs-an-alternative-compiler-for-rust.html. This blogpost outlines some of the decisions we’ve made for gccrs to make sure that the project does not threaten the Rust ecosystem and does not risk splitting it in two. The main discussion thread about it can be found here on Reddit, where it was really well-received.

Community call

We will have our next monthly community call on the 9th of December at 10am UTC. You can subscribe to our calendar to see when the next one will be held. The call is open to everyone, even if you would just like to sit-in and listen. You can also subscribe to our mailing-list or join our Zulip chat to be notified of upcoming events.

Call for contribution

There are no calls for contribution this month, as we do not have a lot of good first issues available. Still, feel free to take a look at them here and get in touch with us for some mentoring or help!

Completed Activities

Contributors this month

Overall Task Status

Category Last Month This Month Delta
TODO 327 316 -11
In Progress 75 80 +5
Completed 897 907 +10

Test Cases

TestCases Last Month This Month Delta
Passing 9212 9266 +54
Failed - - -
XFAIL 294 264 -30
XPASS - - -

Bugs

Category Last Month This Month Delta
TODO 119 112 -7
In Progress 48 40 -8
Completed 441 450 +9

Milestones Progress

Milestone Last Month This Month Delta Start Date Completion Date Target Target GCC
Name resolution 2.0 rework 6% 20% +14% 1st Jun 2024 - 1st Apr 2025 GCC 15.1
Macro expansion 29% 29% - 1st Jun 2024 - 1st Jan 2025 GCC 15.1
Lang items 66% 90% +24% 1st Jul 2024 - 21st Nov 2024 GCC 15.1
Indexing fixes 0% 0% - 21st Jul 2024 - 15th Nov 2024 GCC 15.1
Iterator fixes 0% 0% - 21st Jul 2024 - 15th Nov 2024 GCC 15.1
Auto traits improvements 0% 0% - 15th Sep 2024 - 21st Dec 2024 GCC 15.1
Remaining typecheck issues 85% 88% +3% 21st Oct 2024 - 1st Mar 2025 GCC 15.1
cfg-core 0% 0% - 1st Dec 2024 - 1st Mar 2025 GCC 15.1
Codegen fixes 0% 0% - 7th Oct 2024 - 1st Mar 2025 GCC 15.1
Upcoming Milestone Last Month This Month Delta Start Date Completion Date Target Target GCC
Question mark operator 0% 0% - 15th Dec 2024 - 21st Feb 2025 GCC 15.1
Specialization 0% 0% - 1st Jan 2025 - 1st Mar 2025 GCC 15.1
Inline assembly 100% 100% - 1st Jun 2024 26th Aug 2024 15th Sep 2024 GCC 15.1
Borrow checker improvements 100% 100% - 1st Jun 2024 26th Aug 2024 15th Sep 2024 GCC 15.1
Rustc Testsuite Adaptor 0% 0% - 1st Jun 2024 - 15th Sep 2024 GCC 15.1
blackbox intrinsic 0% 0% - 28th Oct 2024 - 28th Jan 2025 GCC 15.1
Unstable RfL features 0% 0% - 7th Jan 2025 - 1st Mar 2025 GCC 15.1
cfg-rfl 0% 0% - 7th Jan 2025 - 15th Feb 2025 GCC 15.1
alloc parser issues 100% 100% - 7th Jan 2025 31st Jun 2024 28th Jan 2025 GCC 15.1
let-else 0% 0% - 28th Jan 2025 - 28th Feb 2025 GCC 15.1
Explicit generics with impl Trait 0% 0% - 28th Feb 2025 - 28th Mar 2025 GCC 15.1
Downgrade to Rust 1.49 0% 0% - - - 1st Apr 2025 GCC 15.1
offsetof!() builtin macro 0% 0% - 15th Mar 2025 - 15th May 2025 GCC 15.1
Generic Associated Types 0% 0% - 15th Mar 2025 - 15th Jun 2025 GCC 16.1
RfL const generics 0% 0% - 1st May 2025 - 15th Jun 2025 GCC 16.1
frontend plugin hooks 0% 0% - 15th May 2025 - 7th Jul 2025 GCC 16.1
Handling the testsuite issues 0% 0% - 15th Sep 2024 - 15th Sep 2025 GCC 16.1
std parser issues 100% 100% - 7th Jan 2025 31st Jun 2024 28th Jan 2025 GCC 16.1
main shim 0% 0% - 28th Jul 2025 - 15th Sep 2025 GCC 16.1
Past Milestone Last Month This Month Delta Start Date Completion Date Target Target GCC
Data Structures 1 - Core 100% 100% - 30th Nov 2020 27th Jan 2021 29th Jan 2021 GCC 14.1
Control Flow 1 - Core 100% 100% - 28th Jan 2021 10th Feb 2021 26th Feb 2021 GCC 14.1
Data Structures 2 - Generics 100% 100% - 11th Feb 2021 14th May 2021 28th May 2021 GCC 14.1
Data Structures 3 - Traits 100% 100% - 20th May 2021 17th Sep 2021 27th Aug 2021 GCC 14.1
Control Flow 2 - Pattern Matching 100% 100% - 20th Sep 2021 9th Dec 2021 29th Nov 2021 GCC 14.1
Macros and cfg expansion 100% 100% - 1st Dec 2021 31st Mar 2022 28th Mar 2022 GCC 14.1
Imports and Visibility 100% 100% - 29th Mar 2022 13th Jul 2022 27th May 2022 GCC 14.1
Const Generics 100% 100% - 30th May 2022 10th Oct 2022 17th Oct 2022 GCC 14.1
Initial upstream patches 100% 100% - 10th Oct 2022 13th Nov 2022 13th Nov 2022 GCC 14.1
Upstream initial patchset 100% 100% - 13th Nov 2022 13th Dec 2022 19th Dec 2022 GCC 14.1
Update GCC’s master branch 100% 100% - 1st Jan 2023 21st Feb 2023 3rd Mar 2023 GCC 14.1
Final set of upstream patches 100% 100% - 16th Nov 2022 1st May 2023 30th Apr 2023 GCC 14.1
Borrow Checking 1 100% 100% - TBD 8th Jan 2024 15th Aug 2023 GCC 14.1
Procedural Macros 1 100% 100% - 13th Apr 2023 6th Aug 2023 6th Aug 2023 GCC 14.1
GCC 13.2 Release 100% 100% - 13th Apr 2023 22nd Jul 2023 15th Jul 2023 GCC 14.1
GCC 14 Stage 3 100% 100% - 1st Sep 2023 20th Sep 2023 1st Nov 2023 GCC 14.1
GCC 14.1 Release 100% 100% - 2nd Jan 2024 2nd Jun 2024 15th Apr 2024 GCC 14.1
formatargs!() support 100% 100% - 15th Feb 2024 - 1st Apr 2024 GCC 14.1
GCC 14.2 100% 100% - 7th Jun 2024 15th Jun 2024 15th Jun 2024 GCC 14.2
GCC 15.1 100% 100% - 21st Jun 2024 31st Jun 2024 1st Jul 2024 GCC 15.1
Unhandled attributes 100% 100% - 1st Jul 2024 15th Aug 2024 15th Aug 2024 GCC 15.1
Deref and DerefMut improvements 100% 100% - 28th Sep 2024 25th Oct 2024 28th Dec 2024 GCC 15.1

Planned Activities

Risks

We have now entered Stage 3 of GCC development, and all of the patches we needed to get upstreamed have been upstreamed. The risk present in this table is no longer present.

Risk Impact (1-3) Likelihood (0-10) Risk (I * L) Mitigation
Missing features for GCC 15.1 deadline 2 0 0 Start working on required features as early as July (6mo ahead)

Detailed changelog