rustc_codegen_spirv/builder/
mod.rs

1mod builder_methods;
2mod byte_addressable_buffer;
3mod ext_inst;
4mod format_args_decompiler;
5mod intrinsics;
6pub mod libm_intrinsics;
7mod spirv_asm;
8
9pub use ext_inst::ExtInst;
10use rustc_span::DUMMY_SP;
11pub use spirv_asm::InstructionTable;
12
13// HACK(eddyb) avoids rewriting all of the imports (see `lib.rs` and `build.rs`).
14use crate::maybe_pqp_cg_ssa as rustc_codegen_ssa;
15
16use crate::builder_spirv::{SpirvValue, SpirvValueExt};
17use crate::codegen_cx::CodegenCx;
18use crate::spirv_type::SpirvType;
19use rspirv::spirv::Word;
20use rustc_abi::{HasDataLayout, Size, TargetDataLayout};
21use rustc_codegen_ssa::mir::operand::{OperandRef, OperandValue};
22use rustc_codegen_ssa::mir::place::PlaceRef;
23use rustc_codegen_ssa::traits::{
24    AbiBuilderMethods, ArgAbiBuilderMethods, BackendTypes, BuilderMethods,
25    CoverageInfoBuilderMethods, DebugInfoBuilderMethods, StaticBuilderMethods,
26    TypeMembershipCodegenMethods,
27};
28use rustc_errors::{Diag, DiagMessage};
29use rustc_middle::mir::coverage::CoverageKind;
30use rustc_middle::span_bug;
31use rustc_middle::ty::layout::{
32    FnAbiError, FnAbiOfHelpers, FnAbiRequest, HasTyCtxt, HasTypingEnv, LayoutError,
33    LayoutOfHelpers, TyAndLayout,
34};
35use rustc_middle::ty::{Instance, Ty, TyCtxt, TypingEnv};
36use rustc_span::Span;
37use rustc_span::def_id::DefId;
38use rustc_target::callconv::{ArgAbi, FnAbi, PassMode};
39use rustc_target::spec::{HasTargetSpec, Target};
40use std::ops::{Deref, Range};
41
42pub struct Builder<'a, 'tcx> {
43    cx: &'a CodegenCx<'tcx>,
44    current_block: <Self as BackendTypes>::BasicBlock,
45    current_span: Option<Span>,
46}
47
48impl<'a, 'tcx> Builder<'a, 'tcx> {
49    /// See comment on `BuilderCursor`
50    //
51    // FIXME(eddyb) take advantage of `&mut self` to avoid `RefCell` entirely
52    // (sadly it requires making `&CodegeCx`'s types/consts more like SPIR-T,
53    // and completely disjoint from mutably building functions).
54    pub fn emit(&mut self) -> std::cell::RefMut<'a, rspirv::dr::Builder> {
55        self.cx.builder.builder_for_block(self.current_block)
56    }
57
58    pub fn zombie(&self, word: Word, reason: &str) {
59        if let Some(current_span) = self.current_span {
60            self.zombie_with_span(word, current_span, reason);
61        } else {
62            self.zombie_no_span(word, reason);
63        }
64    }
65
66    pub fn undef_zombie(&self, word: Word, reason: &str) -> SpirvValue {
67        if let Some(current_span) = self.current_span {
68            self.undef_zombie_with_span(word, current_span, reason)
69        } else {
70            self.undef_zombie_no_span(word, reason)
71        }
72    }
73    pub fn undef_zombie_with_span(&self, ty: Word, span: Span, reason: &str) -> SpirvValue {
74        let undef = self.undef(ty);
75        self.zombie_with_span(undef.def(self), span, reason);
76        undef
77    }
78    pub fn undef_zombie_no_span(&self, ty: Word, reason: &str) -> SpirvValue {
79        let undef = self.undef(ty);
80        self.zombie_no_span(undef.def(self), reason);
81        undef
82    }
83
84    pub fn validate_atomic(&self, ty: Word, to_zombie: Word) {
85        if !self.i8_i16_atomics_allowed {
86            match self.lookup_type(ty) {
87                SpirvType::Integer(width, _) if width < 32 => {
88                    self.zombie(to_zombie, "atomic on i8 or i16 when disallowed by runtime");
89                }
90                _ => (),
91            }
92        }
93    }
94
95    #[track_caller]
96    pub fn struct_err(&self, msg: impl Into<DiagMessage>) -> Diag<'_> {
97        if let Some(current_span) = self.current_span {
98            self.tcx.dcx().struct_span_err(current_span, msg)
99        } else {
100            self.tcx.dcx().struct_err(msg)
101        }
102    }
103
104    #[track_caller]
105    pub fn err(&self, msg: impl Into<DiagMessage>) {
106        if let Some(current_span) = self.current_span {
107            self.tcx.dcx().span_err(current_span, msg);
108        } else {
109            self.tcx.dcx().err(msg);
110        }
111    }
112
113    #[track_caller]
114    pub fn fatal(&self, msg: impl Into<DiagMessage>) -> ! {
115        if let Some(current_span) = self.current_span {
116            self.tcx.dcx().span_fatal(current_span, msg)
117        } else {
118            self.tcx.dcx().fatal(msg)
119        }
120    }
121
122    pub fn span(&self) -> Span {
123        self.current_span.unwrap_or(DUMMY_SP)
124    }
125
126    // HACK(eddyb) like the `CodegenCx` method but with `self.span()` awareness.
127    pub fn type_ptr_to(&self, ty: Word) -> Word {
128        SpirvType::Pointer { pointee: ty }.def(self.span(), self)
129    }
130
131    // TODO: Definitely add tests to make sure this impl is right.
132    fn rotate(&mut self, value: SpirvValue, shift: SpirvValue, is_left: bool) -> SpirvValue {
133        let width = match self.lookup_type(shift.ty) {
134            SpirvType::Integer(width, _) => width,
135            other => self.fatal(format!(
136                "cannot rotate non-integer type: {}",
137                other.debug(shift.ty, self)
138            )),
139        };
140        let int_size = self.constant_int(shift.ty, width.into());
141        let mask = self.constant_int(shift.ty, (width - 1).into());
142        let zero = self.constant_int(shift.ty, 0);
143        let bool = SpirvType::Bool.def(self.span(), self);
144        // https://stackoverflow.com/a/10134877
145        let mask_shift = self.and(shift, mask);
146        let sub = self.sub(int_size, mask_shift);
147        let (lhs, rhs) = if is_left {
148            (self.shl(value, mask_shift), self.lshr(value, sub))
149        } else {
150            (self.lshr(value, mask_shift), self.shl(value, sub))
151        };
152        let or = self.or(lhs, rhs);
153        // "The result is undefined if Shift is greater than or equal to the bit width of the components of Base."
154        // So we need to check for zero shift, and don't use the shift result if it is.
155        let mask_is_zero = self
156            .emit()
157            .i_equal(bool, None, mask_shift.def(self), zero.def(self))
158            .unwrap()
159            .with_type(bool);
160        self.select(mask_is_zero, value, or)
161    }
162}
163
164// Important: This lets us use CodegenCx methods on Builder
165impl<'a, 'tcx> Deref for Builder<'a, 'tcx> {
166    type Target = CodegenCx<'tcx>;
167
168    fn deref(&self) -> &Self::Target {
169        self.cx
170    }
171}
172
173impl<'a, 'tcx> CoverageInfoBuilderMethods<'tcx> for Builder<'a, 'tcx> {
174    fn add_coverage(&mut self, _instance: Instance<'tcx>, _kind: &CoverageKind) {}
175}
176
177impl<'a, 'tcx> DebugInfoBuilderMethods<'_> for Builder<'a, 'tcx> {
178    fn dbg_var_addr(
179        &mut self,
180        _dbg_var: Self::DIVariable,
181        _scope_metadata: Self::DILocation,
182        _variable_alloca: Self::Value,
183        _direct_offset: Size,
184        // NB: each offset implies a deref (i.e. they're steps in a pointer chain).
185        _indirect_offsets: &[Size],
186        _fragment: &Option<Range<Size>>,
187    ) {
188        todo!()
189    }
190
191    fn set_dbg_loc(&mut self, _: Self::DILocation) {
192        todo!()
193    }
194
195    fn clear_dbg_loc(&mut self) {
196        todo!()
197    }
198
199    fn insert_reference_to_gdb_debug_scripts_section_global(&mut self) {
200        todo!()
201    }
202
203    fn set_var_name(&mut self, _value: Self::Value, _name: &str) {
204        todo!()
205    }
206
207    fn dbg_var_value(
208        &mut self,
209        _dbg_var: Self::DIVariable,
210        _dbg_loc: Self::DILocation,
211        _value: Self::Value,
212        _direct_offset: Size,
213        // NB: each offset implies a deref (i.e. they're steps in a pointer chain).
214        _indirect_offsets: &[Size],
215        // Byte range in the `dbg_var` covered by this fragment,
216        // if this is a fragment of a composite `DIVariable`.
217        _fragment: &Option<Range<Size>>,
218    ) {
219        todo!()
220    }
221}
222
223impl<'a, 'tcx> ArgAbiBuilderMethods<'tcx> for Builder<'a, 'tcx> {
224    fn store_fn_arg(
225        &mut self,
226        arg_abi: &ArgAbi<'tcx, Ty<'tcx>>,
227        idx: &mut usize,
228        dst: PlaceRef<'tcx, Self::Value>,
229    ) {
230        fn next(bx: &mut Builder<'_, '_>, idx: &mut usize) -> SpirvValue {
231            let val = bx.get_param(*idx);
232            *idx += 1;
233            val
234        }
235        match arg_abi.mode {
236            PassMode::Ignore => {}
237            PassMode::Direct(_) => {
238                let arg = next(self, idx);
239                self.store_arg(arg_abi, arg, dst);
240            }
241            PassMode::Pair(..) => {
242                OperandValue::Pair(next(self, idx), next(self, idx)).store(self, dst);
243            }
244            PassMode::Cast { .. } | PassMode::Indirect { .. } => span_bug!(
245                self.span(),
246                "query hooks should've made this `PassMode` impossible: {:#?}",
247                arg_abi
248            ),
249        }
250    }
251
252    fn store_arg(
253        &mut self,
254        arg_abi: &ArgAbi<'tcx, Ty<'tcx>>,
255        val: Self::Value,
256        dst: PlaceRef<'tcx, Self::Value>,
257    ) {
258        match arg_abi.mode {
259            PassMode::Ignore => {}
260            PassMode::Direct(_) | PassMode::Pair(..) => {
261                OperandRef::from_immediate_or_packed_pair(self, val, arg_abi.layout)
262                    .val
263                    .store(self, dst);
264            }
265            PassMode::Cast { .. } | PassMode::Indirect { .. } => span_bug!(
266                self.span(),
267                "query hooks should've made this `PassMode` impossible: {:#?}",
268                arg_abi
269            ),
270        }
271    }
272}
273
274impl AbiBuilderMethods for Builder<'_, '_> {
275    fn get_param(&mut self, index: usize) -> Self::Value {
276        let builder = self.emit();
277        let param =
278            &builder.module_ref().functions[builder.selected_function().unwrap()].parameters[index];
279        param
280            .result_id
281            .unwrap()
282            .with_type(param.result_type.unwrap())
283    }
284}
285
286impl<'a, 'tcx> StaticBuilderMethods for Builder<'a, 'tcx> {
287    fn get_static(&mut self, def_id: DefId) -> Self::Value {
288        self.cx.get_static(def_id)
289    }
290}
291
292impl<'a, 'tcx> BackendTypes for Builder<'a, 'tcx> {
293    type Value = <CodegenCx<'tcx> as BackendTypes>::Value;
294    type Metadata = <CodegenCx<'tcx> as BackendTypes>::Metadata;
295    type Function = <CodegenCx<'tcx> as BackendTypes>::Function;
296
297    type BasicBlock = <CodegenCx<'tcx> as BackendTypes>::BasicBlock;
298    type Type = <CodegenCx<'tcx> as BackendTypes>::Type;
299    type Funclet = <CodegenCx<'tcx> as BackendTypes>::Funclet;
300
301    type DIScope = <CodegenCx<'tcx> as BackendTypes>::DIScope;
302    type DIVariable = <CodegenCx<'tcx> as BackendTypes>::DIVariable;
303    type DILocation = <CodegenCx<'tcx> as BackendTypes>::DILocation;
304}
305
306impl<'a, 'tcx> HasTypingEnv<'tcx> for Builder<'a, 'tcx> {
307    fn typing_env(&self) -> TypingEnv<'tcx> {
308        self.cx.typing_env()
309    }
310}
311
312impl<'a, 'tcx> HasTargetSpec for Builder<'a, 'tcx> {
313    fn target_spec(&self) -> &Target {
314        self.cx.target_spec()
315    }
316}
317
318impl<'a, 'tcx> HasTyCtxt<'tcx> for Builder<'a, 'tcx> {
319    fn tcx(&self) -> TyCtxt<'tcx> {
320        self.cx.tcx
321    }
322}
323
324impl<'a, 'tcx> HasDataLayout for Builder<'a, 'tcx> {
325    fn data_layout(&self) -> &TargetDataLayout {
326        self.cx.data_layout()
327    }
328}
329
330impl<'tcx> LayoutOfHelpers<'tcx> for Builder<'_, 'tcx> {
331    type LayoutOfResult = TyAndLayout<'tcx>;
332
333    #[inline]
334    fn handle_layout_err(&self, err: LayoutError<'tcx>, span: Span, ty: Ty<'tcx>) -> ! {
335        self.cx.handle_layout_err(err, span, ty)
336    }
337}
338
339impl<'tcx> FnAbiOfHelpers<'tcx> for Builder<'_, 'tcx> {
340    type FnAbiOfResult = &'tcx FnAbi<'tcx, Ty<'tcx>>;
341
342    #[inline]
343    fn handle_fn_abi_err(
344        &self,
345        err: FnAbiError<'tcx>,
346        span: Span,
347        fn_abi_request: FnAbiRequest<'tcx>,
348    ) -> ! {
349        self.cx.handle_fn_abi_err(err, span, fn_abi_request)
350    }
351}
352
353impl<'tcx> TypeMembershipCodegenMethods<'tcx> for CodegenCx<'tcx> {}
rustc_codegen_spirv/builder/mod.rs

rustc_codegen_spirv/builder/
mod.rs
