You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Beginning with Rust 1.90 (slated for stable release on 2025-09-18), the various `*-linux-musl` targets will [ship](https://github.com/rust-lang/rust/pull/142682) with musl 1.2.5. These targets currently use musl 1.2.3. This update comes with [several fixes and improvements](https://musl.libc.org/releases.html), and a breaking change that affects the Rust ecosystem.
14
+
Beginning with Rust 1.93 (slated for stable release on 2026-01-22), the various `*-linux-musl` targets will all [ship](https://github.com/rust-lang/rust/pull/142682) with musl 1.2.5. This primarily affects static musl builds for `x86_64`, `aarch64`, and `powerpc64le` which bundled musl 1.2.3. This update comes with [several fixes and improvements](https://musl.libc.org/releases.html), and a breaking change that affects the Rust ecosystem.
15
15
16
16
For the Rust ecosystem, the primary motivation for this update is to receive major improvements to musl's DNS resolver which shipped in 1.2.4 and received bug fixes in 1.2.5. When using `musl` targets for static linking, this should make portable linux binaries that do networking more reliable, particularly in the face of large DNS records and recursive nameservers.
17
17
18
18
However, 1.2.4 also comes with a breaking change: [the removal of several legacy compatibility symbols that the Rust libc crate was using](https://github.com/rust-lang/libc/issues/2934). A fix for this [was shipped in libc 0.2.146 in June 2023 (2 years ago)](https://github.com/rust-lang/libc/pull/2935), and we have been waiting for newer versions of the libc crate to propagate throughout the ecosystem before shipping the musl update.
19
19
20
-
A crater run in July 2024 (a year ago) [found only about 2% of rust projects were still affected](https://github.com/rust-lang/rust/pull/125692#issuecomment-2245182085). At this point we expect there will be minimal breakage, and most breakage should be resolved by a `cargo update`. We believe this update shouldn't be held back any longer, as it contains critical fixes for the musl target.
20
+
A crater run in July 2024 found only about 2.4% of Rust projects were still affected. [A crater run in June 2025 found 1.5% of Rust projects were affected](https://github.com/rust-lang/rust/pull/142682#issuecomment-3002514461). Most of that change is from crater analyzing More Rust Projects. The absolute amount of broken projects went down by 15% while the absolute amount of analyzed projects went up by 35%.
21
+
22
+
At this point we expect there will be minimal breakage, and most breakage should be resolved by a `cargo update`. We believe this update shouldn't be held back any longer, as it contains critical fixes for the musl target.
23
+
24
+
Manual inspection of some of the affected projects indicates they largely haven't run `cargo update` in 2 years, often because they haven't had any changes in 2 years. Analysis suggests this Rust release will be a devastating blow to the thriving ecosystem of Rust gamedev projects that you started 3 years ago and will definitely get back to this year.
25
+
26
+
Build failures from this change will typically look like "some \`extern\` functions couldn't be found; some native libraries may need to be installed or have their path specified", often specifically for "undefined reference to \`open64'", often while trying to build very old versions of the `getrandom` crate (hence the decimation of abandoned gamedev projects in particular):
[INFO] [stdout] = note: some arguments are omitted. use `--verbose` to show all linker arguments
36
+
[INFO] [stdout] = note: /usr/bin/ld: /opt/rustwide/target/x86_64-unknown-linux-musl/debug/deps/libgetrandom-dc7f0d82f4cb384d.rlib(getrandom-dc7f0d82f4cb384d.getrandom.828c5c30a8428cf4-cgu.0.rcgu.o): in function `getrandom::util_libc::open_readonly':
37
+
[INFO] [stdout] /opt/rustwide/cargo-home/registry/src/index.crates.io-1949cf8c6b5b557f/getrandom-0.2.8/src/util_libc.rs:150:(.text._ZN9getrandom9util_libc13open_readonly17hdc55d6ead142a889E+0xbc): undefined reference to `open64'
38
+
[INFO] [stdout] collect2: error: ld returned 1 exit status
39
+
[INFO] [stdout]
40
+
[INFO] [stdout] = note: some `extern` functions couldn't be found; some native libraries may need to be installed or have their path specified
41
+
[INFO] [stdout] = note: use the `-l` flag to specify native libraries to link
42
+
[INFO] [stdout] = note: use the `cargo:rustc-link-lib` directive to specify the native libraries to link with Cargo (see https://doc.rust-lang.org/cargo/reference/build-scripts.html#rustc-link-lib)
43
+
[INFO] [stdout]
44
+
[INFO] [stdout]
45
+
[INFO] [stderr] error: could not compile `guess_the_number` (bin "guess_the_number") due to 1 previous error
46
+
```
47
+
48
+
</details>
49
+
50
+
21
51
22
52
# Updated targets
23
53
24
-
The following targets will be updated (this is just "all musl targets except [`loongarch64-unknown-linux-musl`](https://doc.rust-lang.org/rustc/platform-support/loongarch-linux.html) which already was on 1.2.5, and [WALI](https://github.com/arjunr2/WALI) which doesn't use our bundled musl"):
54
+
All Rust musl targets that bundle a copy of musl now bundle 1.2.5. All Rust musl targets now require musl 1.2.5 at a minimum.
55
+
56
+
The mostly only actually impacts the three "Tier 2 With Host Tools" musl targets which were pinned to musl 1.2.3:
57
+
*`aarch64-unknown-linux-musl`
58
+
*`x86_64-unknown-linux-musl`
59
+
*`powerpc64le-unknown-linux-musl`
60
+
61
+
The fourth target at this level of support, `loongarch64-unknown-linux-musl`, is so new that it was always on musl 1.2.5.
62
+
63
+
[Due to an apparent configuration oversight with `crosstool-ng`](https://github.com/rust-lang/rust/pull/142682#issuecomment-3358724267), all other targets were already bundling musl 1.2.5. These targets were [silently upgraded to musl 1.2.4 in Rust 1.74.0](https://github.com/rust-lang/rust/commit/f99fdac3df5f97287857786bcce9660250009cbf) and [silently upgraded to musl 1.2.5 in Rust 1.86](https://github.com/rust-lang/rust/commit/ed2823c6efec9845d6e35ee7717f2e65099ab1c2). This oversight has been rectified and all targets have been pinned to musl 1.2.5 to prevent future silent upgrades (but hey, no one noticing bodes well for the ecosystem impact of this change). Their documentation has now been updated to reflect the fact that bundling 1.2.5 is actually intentional, and that 1.2.5 is now considered a minimum requirement.
25
64
65
+
Here are all the updated definitions:
26
66
27
67
## Tier 2 with Host Tools
28
68
29
69
target | notes
30
70
-------|-------
31
-
`aarch64-unknown-linux-musl` | ARM64 Linux with musl 1.2.3
32
-
[`powerpc64le-unknown-linux-musl`](https://doc.rust-lang.org/rustc/platform-support/powerpc64le-unknown-linux-musl.html) | PPC64LE Linux (kernel 4.19, musl 1.2.3)
33
-
[`riscv64gc-unknown-linux-musl`](https://doc.rust-lang.org/rustc/platform-support/riscv64gc-unknown-linux-musl.html) | RISC-V Linux (kernel 4.20, musl 1.2.3)
34
-
`x86_64-unknown-linux-musl` | 64-bit Linux with musl 1.2.3
71
+
[`aarch64-unknown-linux-musl`](https://doc.rust-lang.org/rustc/platform-support/aarch64-unknown-linux-musl.html) | ARM64 Linux with musl 1.2.5
72
+
[`powerpc64le-unknown-linux-musl`](https://doc.rust-lang.org/rustc/platform-support/powerpc64le-unknown-linux-musl.html) | PPC64LE Linux (kernel 4.19, musl 1.2.5)
73
+
`x86_64-unknown-linux-musl` | 64-bit Linux with musl 1.2.5
35
74
36
75
37
76
## Tier 2 without Host Tools
38
77
39
78
40
79
target | std | notes
41
80
-------|:---:|-------
42
-
`arm-unknown-linux-musleabi` | ✓ | Armv6 Linux with musl 1.2.3
43
-
`arm-unknown-linux-musleabihf` | ✓ | Armv6 Linux with musl 1.2.3, hardfloat
44
-
`armv5te-unknown-linux-musleabi` | ✓ | Armv5TE Linux with musl 1.2.3
45
-
`armv7-unknown-linux-musleabi` | ✓ | Armv7-A Linux with musl 1.2.3
46
-
`armv7-unknown-linux-musleabihf` | ✓ | Armv7-A Linux with musl 1.2.3, hardfloat
47
-
`i586-unknown-linux-musl` | ✓ | 32-bit Linux (musl 1.2.3, original Pentium)
48
-
`i686-unknown-linux-musl` | ✓ | 32-bit Linux with musl 1.2.3 (Pentium 4)
81
+
`arm-unknown-linux-musleabi` | ✓ | Armv6 Linux with musl 1.2.5
82
+
`arm-unknown-linux-musleabihf` | ✓ | Armv6 Linux with musl 1.2.5, hardfloat
83
+
`armv5te-unknown-linux-musleabi` | ✓ | Armv5TE Linux with musl 1.2.5
84
+
`armv7-unknown-linux-musleabi` | ✓ | Armv7-A Linux with musl 1.2.5
85
+
`armv7-unknown-linux-musleabihf` | ✓ | Armv7-A Linux with musl 1.2.5, hardfloat
86
+
`i586-unknown-linux-musl` | ✓ | 32-bit Linux (musl 1.2.5, original Pentium)
87
+
`i686-unknown-linux-musl` | ✓ | 32-bit Linux with musl 1.2.5 (Pentium 4)
88
+
[`riscv64gc-unknown-linux-musl`](https://doc.rust-lang.org/rustc/platform-support/riscv64gc-unknown-linux-musl.html) | RISC-V Linux (kernel 4.20+, musl 1.2.5)
49
89
50
90
## Tier 3
51
91
52
92
53
93
target | std | host | notes
54
94
-------|:---:|:----:|-------
55
-
[`hexagon-unknown-linux-musl`](https://doc.rust-lang.org/rustc/platform-support/hexagon-unknown-linux-musl.html) | ✓ | | Hexagon Linux with musl 1.2.3
56
-
`mips-unknown-linux-musl` | ✓ | | MIPS Linux with musl 1.2.3
57
-
[`mips64-openwrt-linux-musl`](https://doc.rust-lang.org/rustc/platform-support/mips64-openwrt-linux-musl.html) | ? | | MIPS64 for OpenWrt Linux musl 1.2.3
0 commit comments