Skip to content

Commit 7fc6cad

Browse files
committed
Auto merge of rust-lang#131211 - bjorn3:rust_abi_follow_c_rules, r=nikic
Return values larger than 2 registers using a return area pointer LLVM and Cranelift disagree about how to return values that don't fit in the registers designated for return values. LLVM will force the entire return value to be passed by return area pointer, while Cranelift will look at each IR level return value independently and decide to pass it in a register or not, which would result in the return value being passed partially in registers and partially through a return area pointer. While Cranelift may need to be fixed as the LLVM behavior is generally more correct with respect to the surface language, forcing this behavior in rustc itself makes it easier for other backends to conform to the Rust ABI and for the C ABI rustc already handles this behavior anyway. In addition LLVM's decision to pass the return value in registers or using a return area pointer depends on how exactly the return type is lowered to an LLVM IR type. For example `Option<u128>` can be lowered as `{ i128, i128 }` in which case the x86_64 backend would use a return area pointer, or it could be passed as `{ i32, i128 }` in which case the x86_64 backend would pass it in registers by taking advantage of an LLVM ABI extension that allows using 3 registers for the x86_64 sysv call conv rather than the officially specified 2 registers. This adjustment is only necessary for the Rust ABI as for other ABI's the calling convention implementations in rustc_target already ensure any return value which doesn't fit in the available amount of return registers is passed in the right way for the current target. Helps with rust-lang/rustc_codegen_cranelift#1525 cc bytecodealliance/wasmtime#9250
2 parents 52fd998 + ccd1bc2 commit 7fc6cad

File tree

3 files changed

+61
-22
lines changed

3 files changed

+61
-22
lines changed

compiler/rustc_ty_utils/src/abi.rs

+43
Original file line numberDiff line numberDiff line change
@@ -728,6 +728,49 @@ fn fn_abi_adjust_for_abi<'tcx>(
728728
};
729729
}
730730

731+
if arg_idx.is_none() && arg.layout.size > Pointer(AddressSpace::DATA).size(cx) * 2 {
732+
// Return values larger than 2 registers using a return area
733+
// pointer. LLVM and Cranelift disagree about how to return
734+
// values that don't fit in the registers designated for return
735+
// values. LLVM will force the entire return value to be passed
736+
// by return area pointer, while Cranelift will look at each IR level
737+
// return value independently and decide to pass it in a
738+
// register or not, which would result in the return value
739+
// being passed partially in registers and partially through a
740+
// return area pointer.
741+
//
742+
// While Cranelift may need to be fixed as the LLVM behavior is
743+
// generally more correct with respect to the surface language,
744+
// forcing this behavior in rustc itself makes it easier for
745+
// other backends to conform to the Rust ABI and for the C ABI
746+
// rustc already handles this behavior anyway.
747+
//
748+
// In addition LLVM's decision to pass the return value in
749+
// registers or using a return area pointer depends on how
750+
// exactly the return type is lowered to an LLVM IR type. For
751+
// example `Option<u128>` can be lowered as `{ i128, i128 }`
752+
// in which case the x86_64 backend would use a return area
753+
// pointer, or it could be passed as `{ i32, i128 }` in which
754+
// case the x86_64 backend would pass it in registers by taking
755+
// advantage of an LLVM ABI extension that allows using 3
756+
// registers for the x86_64 sysv call conv rather than the
757+
// officially specified 2 registers.
758+
//
759+
// FIXME: Technically we should look at the amount of available
760+
// return registers rather than guessing that there are 2
761+
// registers for return values. In practice only a couple of
762+
// architectures have less than 2 return registers. None of
763+
// which supported by Cranelift.
764+
//
765+
// NOTE: This adjustment is only necessary for the Rust ABI as
766+
// for other ABI's the calling convention implementations in
767+
// rustc_target already ensure any return value which doesn't
768+
// fit in the available amount of return registers is passed in
769+
// the right way for the current target.
770+
arg.make_indirect();
771+
return;
772+
}
773+
731774
match arg.layout.abi {
732775
Abi::Aggregate { .. } => {}
733776

tests/codegen/i128-x86-align.rs

+14-18
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,15 @@ pub struct ScalarPair {
1919
#[no_mangle]
2020
pub fn load(x: &ScalarPair) -> ScalarPair {
2121
// CHECK-LABEL: @load(
22+
// CHECK-SAME: sret([32 x i8]) align 16 dereferenceable(32) %_0,
2223
// CHECK-SAME: align 16 dereferenceable(32) %x
2324
// CHECK: [[A:%.*]] = load i32, ptr %x, align 16
2425
// CHECK-NEXT: [[GEP:%.*]] = getelementptr inbounds i8, ptr %x, i64 16
2526
// CHECK-NEXT: [[B:%.*]] = load i128, ptr [[GEP]], align 16
26-
// CHECK-NEXT: [[IV1:%.*]] = insertvalue { i32, i128 } poison, i32 [[A]], 0
27-
// CHECK-NEXT: [[IV2:%.*]] = insertvalue { i32, i128 } [[IV1]], i128 [[B]], 1
28-
// CHECK-NEXT: ret { i32, i128 } [[IV2]]
27+
// CHECK-NEXT: store i32 [[A]], ptr %_0, align 16
28+
// CHECK-NEXT: [[GEP:%.*]] = getelementptr inbounds i8, ptr %_0, i64 16
29+
// CHECK-NEXT: store i128 [[B]], ptr [[GEP]], align 16
30+
// CHECK-NEXT: ret void
2931
*x
3032
}
3133

@@ -53,29 +55,23 @@ pub fn alloca() {
5355
#[no_mangle]
5456
pub fn load_volatile(x: &ScalarPair) -> ScalarPair {
5557
// CHECK-LABEL: @load_volatile(
58+
// CHECK-SAME: sret([32 x i8]) align 16 dereferenceable(32) %_0,
5659
// CHECK-SAME: align 16 dereferenceable(32) %x
57-
// CHECK: [[TMP:%.*]] = alloca [32 x i8], align 16
5860
// CHECK: [[LOAD:%.*]] = load volatile %ScalarPair, ptr %x, align 16
59-
// CHECK-NEXT: store %ScalarPair [[LOAD]], ptr [[TMP]], align 16
60-
// CHECK-NEXT: [[A:%.*]] = load i32, ptr [[TMP]], align 16
61-
// CHECK-NEXT: [[GEP:%.*]] = getelementptr inbounds i8, ptr [[TMP]], i64 16
62-
// CHECK-NEXT: [[B:%.*]] = load i128, ptr [[GEP]], align 16
61+
// CHECK-NEXT: store %ScalarPair [[LOAD]], ptr %_0, align 16
62+
// CHECK-NEXT: ret void
6363
unsafe { std::intrinsics::volatile_load(x) }
6464
}
6565

6666
#[no_mangle]
6767
pub fn transmute(x: ScalarPair) -> (std::mem::MaybeUninit<i128>, i128) {
68-
// CHECK-LABEL: define { i128, i128 } @transmute(i32 noundef %x.0, i128 noundef %x.1)
69-
// CHECK: [[TMP:%.*]] = alloca [32 x i8], align 16
70-
// CHECK-NEXT: store i32 %x.0, ptr [[TMP]], align 16
71-
// CHECK-NEXT: [[GEP:%.*]] = getelementptr inbounds i8, ptr [[TMP]], i64 16
68+
// CHECK-LABEL: @transmute(
69+
// CHECK-SAME: sret([32 x i8]) align 16 dereferenceable(32) %_0,
70+
// CHECK-SAME: i32 noundef %x.0, i128 noundef %x.1
71+
// CHECK: store i32 %x.0, ptr %_0, align 16
72+
// CHECK-NEXT: [[GEP:%.*]] = getelementptr inbounds i8, ptr %_0, i64 16
7273
// CHECK-NEXT: store i128 %x.1, ptr [[GEP]], align 16
73-
// CHECK-NEXT: [[LOAD1:%.*]] = load i128, ptr %_0, align 16
74-
// CHECK-NEXT: [[GEP2:%.*]] = getelementptr inbounds i8, ptr [[TMP]], i64 16
75-
// CHECK-NEXT: [[LOAD2:%.*]] = load i128, ptr [[GEP2]], align 16
76-
// CHECK-NEXT: [[IV1:%.*]] = insertvalue { i128, i128 } poison, i128 [[LOAD1]], 0
77-
// CHECK-NEXT: [[IV2:%.*]] = insertvalue { i128, i128 } [[IV1]], i128 [[LOAD2]], 1
78-
// CHECK-NEXT: ret { i128, i128 } [[IV2]]
74+
// CHECK-NEXT: ret void
7975
unsafe { std::mem::transmute(x) }
8076
}
8177

tests/codegen/tuple-layout-opt.rs

+4-4
Original file line numberDiff line numberDiff line change
@@ -19,28 +19,28 @@ pub fn test_ScalarZstFirst(_: ScalarZstFirst) -> ScalarZstFirst {
1919
}
2020

2121
type ScalarPairZstLast = (u8, u128, ());
22-
// CHECK: define {{(dso_local )?}}{ i128, i8 } @test_ScalarPairZstLast(i128 %_1.0, i8 %_1.1)
22+
// CHECK: define {{(dso_local )?}}void @test_ScalarPairZstLast(ptr sret([32 x i8]) align 16 %_0, i128 %_1.0, i8 %_1.1)
2323
#[no_mangle]
2424
pub fn test_ScalarPairZstLast(_: ScalarPairZstLast) -> ScalarPairZstLast {
2525
loop {}
2626
}
2727

2828
type ScalarPairZstFirst = ((), u8, u128);
29-
// CHECK: define {{(dso_local )?}}{ i8, i128 } @test_ScalarPairZstFirst(i8 %_1.0, i128 %_1.1)
29+
// CHECK: define {{(dso_local )?}}void @test_ScalarPairZstFirst(ptr sret([32 x i8]) align 16 %_0, i8 %_1.0, i128 %_1.1)
3030
#[no_mangle]
3131
pub fn test_ScalarPairZstFirst(_: ScalarPairZstFirst) -> ScalarPairZstFirst {
3232
loop {}
3333
}
3434

3535
type ScalarPairLotsOfZsts = ((), u8, (), u128, ());
36-
// CHECK: define {{(dso_local )?}}{ i128, i8 } @test_ScalarPairLotsOfZsts(i128 %_1.0, i8 %_1.1)
36+
// CHECK: define {{(dso_local )?}}void @test_ScalarPairLotsOfZsts(ptr sret([32 x i8]) align 16 %_0, i128 %_1.0, i8 %_1.1)
3737
#[no_mangle]
3838
pub fn test_ScalarPairLotsOfZsts(_: ScalarPairLotsOfZsts) -> ScalarPairLotsOfZsts {
3939
loop {}
4040
}
4141

4242
type ScalarPairLottaNesting = (((), ((), u8, (), u128, ())), ());
43-
// CHECK: define {{(dso_local )?}}{ i128, i8 } @test_ScalarPairLottaNesting(i128 %_1.0, i8 %_1.1)
43+
// CHECK: define {{(dso_local )?}}void @test_ScalarPairLottaNesting(ptr sret([32 x i8]) align 16 %_0, i128 %_1.0, i8 %_1.1)
4444
#[no_mangle]
4545
pub fn test_ScalarPairLottaNesting(_: ScalarPairLottaNesting) -> ScalarPairLottaNesting {
4646
loop {}

0 commit comments

Comments
 (0)