Skip to main content

rustc_target/callconv/
mips64.rs

1use arrayvec::ArrayVec;
2use rustc_abi::{
3    BackendRepr, FieldsShape, Float, HasDataLayout, Integer, Numeric, Primitive, Reg, RegKind,
4    Size, TyAbiInterface,
5};
6
7use crate::callconv::{ArgAbi, ArgAttribute, ArgExtension, CastTarget, FnAbi, PassMode, Uniform};
8
9fn extend_integer_width_mips<Ty>(arg: &mut ArgAbi<'_, Ty>, bits: u64) {
10    // Always sign extend u32 values on 64-bit mips
11    if let BackendRepr::Scalar(scalar) = arg.layout.backend_repr
12        && let Primitive::Int(i, signed) = scalar.primitive()
13        && !signed
14        && i.size().bits() == 32
15        && let PassMode::Direct(ref mut attrs) = arg.mode
16    {
17        attrs.ext(ArgExtension::Sext);
18        return;
19    }
20
21    arg.extend_integer_width_to(bits);
22}
23
24fn float_reg<'a, Ty, C>(cx: &C, ret: &ArgAbi<'a, Ty>, i: usize) -> Option<Reg>
25where
26    Ty: TyAbiInterface<'a, C> + Copy,
27    C: HasDataLayout,
28{
29    match ret.layout.field(cx, i).backend_repr {
30        BackendRepr::Scalar(scalar) => match scalar.primitive() {
31            Primitive::Float(float) => {
32                match float {
33                    // C does not have the f16 type
34                    Float::F16 => None,
35                    Float::F32 => Some(Reg::f32()),
36                    Float::F64 => Some(Reg::f64()),
37                    Float::F128 => Some(Reg::f128()),
38                    Float::F16B => {
    ::core::panicking::panic_fmt(format_args!("internal error: entered unreachable code: {0}",
            format_args!("`f16b` unsupported on mips64")));
}unreachable!("`f16b` unsupported on mips64"),
39                    Float::PpcF128 => {
    ::core::panicking::panic_fmt(format_args!("internal error: entered unreachable code: {0}",
            format_args!("`ppcf128` unsupported on mips64")));
}unreachable!("`ppcf128` unsupported on mips64"),
40                }
41            }
42            _ => None,
43        },
44        _ => None,
45    }
46}
47
48fn classify_ret<'a, Ty, C>(cx: &C, ret: &mut ArgAbi<'a, Ty>, offset: &mut Size)
49where
50    Ty: TyAbiInterface<'a, C> + Copy,
51    C: HasDataLayout,
52{
53    if !ret.layout.is_aggregate() {
54        extend_integer_width_mips(ret, 64);
55        return;
56    }
57
58    let size = ret.layout.size;
59    let bits = size.bits();
60    if bits <= 128 {
61        // NOTE: Complex<f128> is returned indirectly.
62        if let Some(component) = ret.layout.complex_number(cx) {
63            match component {
64                Numeric::Int(Integer::I8 | Integer::I16 | Integer::I32, _) => {
65                    // Return a Complex<{integer}> packed into a single register when that fits.
66                    ret.cast_to(Reg { kind: RegKind::Integer, size });
67                }
68                _ => {
69                    // Otherwise pass in 2 registers.
70                    let reg = Reg { kind: component.reg_kind(), size: component.size() };
71                    ret.cast_to(CastTarget::pair(reg, reg));
72                }
73            }
74            return;
75        }
76
77        // Unlike other architectures which return aggregates in registers, MIPS n64 limits the
78        // use of float registers to structures (not unions) containing exactly one or two
79        // float fields.
80
81        if let FieldsShape::Arbitrary { .. } = ret.layout.fields {
82            if ret.layout.fields.count() == 1 {
83                if let Some(reg) = float_reg(cx, ret, 0) {
84                    // The inreg attribute forces LLVM to return a struct containing a f128 in
85                    // $f0 and $f1 rather than $f0 and $f2, see:
86                    // https://github.com/llvm/llvm-project/blob/a81db64570f94c2ca8ac0f598c0b5bba1a7ae59e/llvm/lib/Target/Mips/MipsCallingConv.td#L48-L51
87                    ret.cast_to_with_attrs(reg, ArgAttribute::InReg.into());
88                    return;
89                }
90            } else if ret.layout.fields.count() == 2
91                && let Some(reg0) = float_reg(cx, ret, 0)
92                && let Some(reg1) = float_reg(cx, ret, 1)
93            {
94                ret.cast_to_with_attrs(CastTarget::pair(reg0, reg1), ArgAttribute::InReg.into());
95                return;
96            }
97        }
98
99        // Cast to a uniform int structure
100        ret.cast_to(Uniform::new(Reg::i64(), size));
101    } else {
102        ret.make_indirect();
103        *offset += cx.data_layout().pointer_size();
104    }
105}
106
107fn classify_arg<'a, Ty, C>(cx: &C, arg: &mut ArgAbi<'a, Ty>, offset: &mut Size)
108where
109    Ty: TyAbiInterface<'a, C> + Copy,
110    C: HasDataLayout,
111{
112    let dl = cx.data_layout();
113    let size = arg.layout.size;
114    let mut prefix = ArrayVec::new();
115
116    // Detect need for padding
117    let align = Ord::clamp(arg.layout.align.abi, dl.i64_align, dl.i128_align);
118    let pad_i32 = u8::from(!offset.is_aligned(align));
119
120    if !arg.layout.is_aggregate() {
121        extend_integer_width_mips(arg, 64);
122
123        // We always pad with an integer, even if the primitive is a float. This
124        // is because the N64 ABI puts the n-th argument in the n-th register
125        // starting from $4 if it belongs in a GPR and in the n-th register
126        // starting from $f12 if it belongs in a FPR.
127        // Therefore padding with an integer results in skipping a FPR for the
128        // next floating point parameter.
129        if let BackendRepr::Scalar(scalar) = arg.layout.backend_repr {
130            let kind = RegKind::from_primitive(scalar.primitive());
131            arg.cast_to_and_pad_i32(CastTarget::from(Reg { kind, size }), pad_i32);
132        }
133    } else if arg.layout.pass_indirectly_in_non_rustic_abis(cx) {
134        arg.make_indirect();
135    } else if let Some(component) = arg.layout.complex_number(cx)
136        && !#[allow(non_exhaustive_omitted_patterns)] match component {
    Numeric::Float(Float::F16) => true,
    _ => false,
}matches!(component, Numeric::Float(Float::F16))
137    {
138        let slot = dl.pointer_size();
139        let curr_offset = offset.align_to(align);
140
141        const NUM_ARG_SLOTS: u64 = 8;
142
143        match component {
144            Numeric::Float(Float::F16B) => {
    ::core::panicking::panic_fmt(format_args!("internal error: entered unreachable code: {0}",
            format_args!("Complex<f16b> is not C-compatible")));
}unreachable!("Complex<f16b> is not C-compatible"),
145            Numeric::Float(Float::F16) => {
    ::core::panicking::panic_fmt(format_args!("internal error: entered unreachable code: {0}",
            format_args!("not supported on mips64")));
}unreachable!("not supported on mips64"),
146            Numeric::Float(Float::PpcF128) => {
    ::core::panicking::panic_fmt(format_args!("internal error: entered unreachable code: {0}",
            format_args!("not supported on mips64")));
}unreachable!("not supported on mips64"),
147            Numeric::Float(Float::F32 | Float::F64) => {
148                // Only pass a Complex<f32>/Complex<f64> in FPRs when two argument slots are free.
149                if curr_offset.bytes() / slot.bytes() + 2 <= NUM_ARG_SLOTS {
150                    // Both components claim a slot, even a Complex<f32> which could fit in one
151                    // slot.
152                    //
153                    // FIXME(complex_numbers): c-variadic arguments are passed in GPRs, so need a
154                    // special carve-out here and Complex<f32> is bitpacked into one 64-bit GPR.
155                    *offset = curr_offset + slot * 2;
156                    let unit = Reg { kind: RegKind::Float, size: component.size() };
157                    let cast_target = CastTarget::from(Uniform::new(unit, size));
158                    arg.cast_to(cast_target);
159                    return;
160                }
161
162                // Otherwise pack it into GPRs (or the stack) like an integer of the same size.
163                arg.cast_to_and_pad_i32(Uniform::new(Reg::i64(), size), pad_i32);
164            }
165            Numeric::Float(Float::F128) => {
166                // Complex<f128> is passed in 4 FPRs, but aligned to 16 so may need padding.
167                let reg = Reg { kind: RegKind::Float, size: arg.layout.field(cx, 0).size };
168                arg.cast_to_and_pad_i32(CastTarget::pair(reg, reg), pad_i32);
169            }
170            Numeric::Int(Integer::I8 | Integer::I16 | Integer::I32, _) => {
171                // Cast Complex<i8> into i16, Complex<i16> to i32, etc.
172                let cast_target = CastTarget::from(Reg { kind: RegKind::Integer, size });
173                // The inreg attribute makes the bits land in the right (upper) bits on BE targets.
174                arg.cast_to(cast_target.with_attrs(ArgAttribute::InReg.into()));
175            }
176            Numeric::Int(Integer::I64 | Integer::I128, _) => {
177                // Complex<i64> and Complex<i128> are passed as 2 separate arguments.
178                let cast_target = CastTarget::from(Reg { kind: RegKind::Integer, size });
179                arg.cast_to(cast_target);
180            }
181        }
182    } else {
183        match arg.layout.fields {
184            FieldsShape::Primitive => ::core::panicking::panic("internal error: entered unreachable code")unreachable!(),
185            FieldsShape::Array { .. } => {
186                // Arrays are passed indirectly
187                arg.make_indirect();
188            }
189            FieldsShape::Union(_) => {
190                // Unions and are always treated as a series of 64-bit integer chunks
191            }
192            FieldsShape::Arbitrary { .. } => {
193                // Structures are split up into a series of 64-bit integer chunks, but any aligned
194                // doubles not part of another aggregate are passed as floats.
195                let mut last_offset = Size::ZERO;
196
197                'outer: for i in 0..arg.layout.fields.count() {
198                    let field = arg.layout.field(cx, i);
199                    let offset = arg.layout.fields.offset(i);
200
201                    // We only care about aligned doubles
202                    if let BackendRepr::Scalar(scalar) = field.backend_repr {
203                        if scalar.primitive() == Primitive::Float(Float::F64) {
204                            if offset.is_aligned(dl.f64_align) {
205                                // Insert enough integers to cover [last_offset, offset)
206                                if !last_offset.is_aligned(dl.f64_align) {
    ::core::panicking::panic("assertion failed: last_offset.is_aligned(dl.f64_align)")
};assert!(last_offset.is_aligned(dl.f64_align));
207                                for _ in 0..((offset - last_offset).bits() / 64) {
208                                    if prefix.try_push(Reg::i64()).is_err() {
209                                        break 'outer;
210                                    }
211                                }
212
213                                if prefix.try_push(Reg::f64()).is_err() {
214                                    break;
215                                }
216                                last_offset = offset + Reg::f64().size;
217                            }
218                        }
219                    }
220                }
221            }
222        };
223
224        // Extract first 8 chunks as the prefix
225        let rest_size = size - Size::from_bytes(8) * prefix.len() as u64;
226        arg.cast_to_and_pad_i32(
227            CastTarget::prefixed(prefix, Uniform::new(Reg::i64(), rest_size)),
228            pad_i32,
229        );
230    }
231    *offset = offset.align_to(align) + size.align_to(align);
232}
233
234pub(crate) fn compute_abi_info<'a, Ty, C>(cx: &C, fn_abi: &mut FnAbi<'a, Ty>)
235where
236    Ty: TyAbiInterface<'a, C> + Copy,
237    C: HasDataLayout,
238{
239    // mips64 argument passing is also affected by the alignment of aggregates.
240    // see mips.rs for how the offset is used
241    let mut offset = Size::ZERO;
242
243    if !fn_abi.ret.is_ignore() && fn_abi.ret.layout.is_sized() {
244        classify_ret(cx, &mut fn_abi.ret, &mut offset);
245    }
246
247    for arg in fn_abi.args.iter_mut() {
248        if arg.is_ignore() || !arg.layout.is_sized() {
249            continue;
250        }
251        classify_arg(cx, arg, &mut offset);
252    }
253}