@@ -3434,6 +3434,32 @@ fn add_lld_args(
3434
3434
// this, `wasm-component-ld`, which is overridden if this option is passed.
3435
3435
if !sess. target . is_like_wasm {
3436
3436
cmd. cc_arg ( "-fuse-ld=lld" ) ;
3437
+
3438
+ // GNU ld and LLD have opposite defaults on some section garbage-collection features. For
3439
+ // example, the somewhat popular `linkme` crate and its dependents rely in practice on this
3440
+ // difference: when using lld, they need `-z nostart-stop-gc` to prevent encapsulation
3441
+ // symbols and sections from being garbage-collected.
3442
+ //
3443
+ // More information about all this can be found in:
3444
+ // - https://maskray.me/blog/2021-01-31-metadata-sections-comdat-and-shf-link-order
3445
+ // - https://lld.llvm.org/ELF/start-stop-gc
3446
+ //
3447
+ // So when using lld, we restore, for now, the traditional behavior to help migration, but
3448
+ // will remove it in the future.
3449
+ // Since this only disables an optimization, it shouldn't create issues, but is in theory
3450
+ // slightly suboptimal. However, it:
3451
+ // - doesn't have any visible impact on our benchmarks
3452
+ // - reduces the need to disable lld for the crates that depend on this
3453
+ //
3454
+ // Note that lld can detect some cases where this difference is relied on, and emits a
3455
+ // dedicated error to add this link arg. We could make use of this error to emit an FCW. As
3456
+ // of writing this, we don't do it, because lld is already enabled by default on nightly
3457
+ // without this mitigation: no working project would see the FCW, so we do this to help
3458
+ // stabilization.
3459
+ //
3460
+ // FIXME: emit an FCW if linking fails due its absence, and then remove this link-arg in the
3461
+ // future.
3462
+ cmd. link_arg ( "-znostart-stop-gc" ) ;
3437
3463
}
3438
3464
3439
3465
if !flavor. is_gnu ( ) {
0 commit comments