]> git.lizzy.rs Git - rust.git/blob - compiler/rustc_codegen_llvm/src/builder.rs
Auto merge of #89633 - rhysd:issue-65230, r=petrochenkov
[rust.git] / compiler / rustc_codegen_llvm / src / builder.rs
1 use crate::common::Funclet;
2 use crate::context::CodegenCx;
3 use crate::llvm::{self, BasicBlock, False};
4 use crate::llvm::{AtomicOrdering, AtomicRmwBinOp, SynchronizationScope};
5 use crate::llvm_util;
6 use crate::type_::Type;
7 use crate::type_of::LayoutLlvmExt;
8 use crate::value::Value;
9 use cstr::cstr;
10 use libc::{c_char, c_uint};
11 use rustc_codegen_ssa::common::{IntPredicate, RealPredicate, TypeKind};
12 use rustc_codegen_ssa::mir::operand::{OperandRef, OperandValue};
13 use rustc_codegen_ssa::mir::place::PlaceRef;
14 use rustc_codegen_ssa::traits::*;
15 use rustc_codegen_ssa::MemFlags;
16 use rustc_data_structures::small_c_str::SmallCStr;
17 use rustc_hir::def_id::DefId;
18 use rustc_middle::ty::layout::{
19     FnAbiError, FnAbiOfHelpers, FnAbiRequest, LayoutError, LayoutOfHelpers, TyAndLayout,
20 };
21 use rustc_middle::ty::{self, Ty, TyCtxt};
22 use rustc_span::Span;
23 use rustc_target::abi::{self, call::FnAbi, Align, Size, WrappingRange};
24 use rustc_target::spec::{HasTargetSpec, Target};
25 use std::borrow::Cow;
26 use std::ffi::CStr;
27 use std::iter;
28 use std::ops::Deref;
29 use std::ptr;
30 use tracing::debug;
31
32 // All Builders must have an llfn associated with them
33 #[must_use]
34 pub struct Builder<'a, 'll, 'tcx> {
35     pub llbuilder: &'ll mut llvm::Builder<'ll>,
36     pub cx: &'a CodegenCx<'ll, 'tcx>,
37 }
38
39 impl Drop for Builder<'a, 'll, 'tcx> {
40     fn drop(&mut self) {
41         unsafe {
42             llvm::LLVMDisposeBuilder(&mut *(self.llbuilder as *mut _));
43         }
44     }
45 }
46
47 // FIXME(eddyb) use a checked constructor when they become `const fn`.
48 const EMPTY_C_STR: &CStr = unsafe { CStr::from_bytes_with_nul_unchecked(b"\0") };
49
50 /// Empty string, to be used where LLVM expects an instruction name, indicating
51 /// that the instruction is to be left unnamed (i.e. numbered, in textual IR).
52 // FIXME(eddyb) pass `&CStr` directly to FFI once it's a thin pointer.
53 const UNNAMED: *const c_char = EMPTY_C_STR.as_ptr();
54
55 impl BackendTypes for Builder<'_, 'll, 'tcx> {
56     type Value = <CodegenCx<'ll, 'tcx> as BackendTypes>::Value;
57     type Function = <CodegenCx<'ll, 'tcx> as BackendTypes>::Function;
58     type BasicBlock = <CodegenCx<'ll, 'tcx> as BackendTypes>::BasicBlock;
59     type Type = <CodegenCx<'ll, 'tcx> as BackendTypes>::Type;
60     type Funclet = <CodegenCx<'ll, 'tcx> as BackendTypes>::Funclet;
61
62     type DIScope = <CodegenCx<'ll, 'tcx> as BackendTypes>::DIScope;
63     type DILocation = <CodegenCx<'ll, 'tcx> as BackendTypes>::DILocation;
64     type DIVariable = <CodegenCx<'ll, 'tcx> as BackendTypes>::DIVariable;
65 }
66
67 impl abi::HasDataLayout for Builder<'_, '_, '_> {
68     fn data_layout(&self) -> &abi::TargetDataLayout {
69         self.cx.data_layout()
70     }
71 }
72
73 impl ty::layout::HasTyCtxt<'tcx> for Builder<'_, '_, 'tcx> {
74     #[inline]
75     fn tcx(&self) -> TyCtxt<'tcx> {
76         self.cx.tcx
77     }
78 }
79
80 impl ty::layout::HasParamEnv<'tcx> for Builder<'_, '_, 'tcx> {
81     fn param_env(&self) -> ty::ParamEnv<'tcx> {
82         self.cx.param_env()
83     }
84 }
85
86 impl HasTargetSpec for Builder<'_, '_, 'tcx> {
87     #[inline]
88     fn target_spec(&self) -> &Target {
89         self.cx.target_spec()
90     }
91 }
92
93 impl LayoutOfHelpers<'tcx> for Builder<'_, '_, 'tcx> {
94     type LayoutOfResult = TyAndLayout<'tcx>;
95
96     #[inline]
97     fn handle_layout_err(&self, err: LayoutError<'tcx>, span: Span, ty: Ty<'tcx>) -> ! {
98         self.cx.handle_layout_err(err, span, ty)
99     }
100 }
101
102 impl FnAbiOfHelpers<'tcx> for Builder<'_, '_, 'tcx> {
103     type FnAbiOfResult = &'tcx FnAbi<'tcx, Ty<'tcx>>;
104
105     #[inline]
106     fn handle_fn_abi_err(
107         &self,
108         err: FnAbiError<'tcx>,
109         span: Span,
110         fn_abi_request: FnAbiRequest<'tcx>,
111     ) -> ! {
112         self.cx.handle_fn_abi_err(err, span, fn_abi_request)
113     }
114 }
115
116 impl Deref for Builder<'_, 'll, 'tcx> {
117     type Target = CodegenCx<'ll, 'tcx>;
118
119     #[inline]
120     fn deref(&self) -> &Self::Target {
121         self.cx
122     }
123 }
124
125 impl HasCodegen<'tcx> for Builder<'_, 'll, 'tcx> {
126     type CodegenCx = CodegenCx<'ll, 'tcx>;
127 }
128
129 macro_rules! builder_methods_for_value_instructions {
130     ($($name:ident($($arg:ident),*) => $llvm_capi:ident),+ $(,)?) => {
131         $(fn $name(&mut self, $($arg: &'ll Value),*) -> &'ll Value {
132             unsafe {
133                 llvm::$llvm_capi(self.llbuilder, $($arg,)* UNNAMED)
134             }
135         })+
136     }
137 }
138
139 impl BuilderMethods<'a, 'tcx> for Builder<'a, 'll, 'tcx> {
140     fn build(cx: &'a CodegenCx<'ll, 'tcx>, llbb: &'ll BasicBlock) -> Self {
141         let bx = Builder::with_cx(cx);
142         unsafe {
143             llvm::LLVMPositionBuilderAtEnd(bx.llbuilder, llbb);
144         }
145         bx
146     }
147
148     fn cx(&self) -> &CodegenCx<'ll, 'tcx> {
149         self.cx
150     }
151
152     fn llbb(&self) -> &'ll BasicBlock {
153         unsafe { llvm::LLVMGetInsertBlock(self.llbuilder) }
154     }
155
156     fn set_span(&mut self, _span: Span) {}
157
158     fn append_block(cx: &'a CodegenCx<'ll, 'tcx>, llfn: &'ll Value, name: &str) -> &'ll BasicBlock {
159         unsafe {
160             let name = SmallCStr::new(name);
161             llvm::LLVMAppendBasicBlockInContext(cx.llcx, llfn, name.as_ptr())
162         }
163     }
164
165     fn append_sibling_block(&mut self, name: &str) -> &'ll BasicBlock {
166         Self::append_block(self.cx, self.llfn(), name)
167     }
168
169     fn build_sibling_block(&mut self, name: &str) -> Self {
170         let llbb = self.append_sibling_block(name);
171         Self::build(self.cx, llbb)
172     }
173
174     fn ret_void(&mut self) {
175         unsafe {
176             llvm::LLVMBuildRetVoid(self.llbuilder);
177         }
178     }
179
180     fn ret(&mut self, v: &'ll Value) {
181         unsafe {
182             llvm::LLVMBuildRet(self.llbuilder, v);
183         }
184     }
185
186     fn br(&mut self, dest: &'ll BasicBlock) {
187         unsafe {
188             llvm::LLVMBuildBr(self.llbuilder, dest);
189         }
190     }
191
192     fn cond_br(
193         &mut self,
194         cond: &'ll Value,
195         then_llbb: &'ll BasicBlock,
196         else_llbb: &'ll BasicBlock,
197     ) {
198         unsafe {
199             llvm::LLVMBuildCondBr(self.llbuilder, cond, then_llbb, else_llbb);
200         }
201     }
202
203     fn switch(
204         &mut self,
205         v: &'ll Value,
206         else_llbb: &'ll BasicBlock,
207         cases: impl ExactSizeIterator<Item = (u128, &'ll BasicBlock)>,
208     ) {
209         let switch =
210             unsafe { llvm::LLVMBuildSwitch(self.llbuilder, v, else_llbb, cases.len() as c_uint) };
211         for (on_val, dest) in cases {
212             let on_val = self.const_uint_big(self.val_ty(v), on_val);
213             unsafe { llvm::LLVMAddCase(switch, on_val, dest) }
214         }
215     }
216
217     fn invoke(
218         &mut self,
219         llty: &'ll Type,
220         llfn: &'ll Value,
221         args: &[&'ll Value],
222         then: &'ll BasicBlock,
223         catch: &'ll BasicBlock,
224         funclet: Option<&Funclet<'ll>>,
225     ) -> &'ll Value {
226         debug!("invoke {:?} with args ({:?})", llfn, args);
227
228         let args = self.check_call("invoke", llty, llfn, args);
229         let bundle = funclet.map(|funclet| funclet.bundle());
230         let bundle = bundle.as_ref().map(|b| &*b.raw);
231
232         unsafe {
233             llvm::LLVMRustBuildInvoke(
234                 self.llbuilder,
235                 llty,
236                 llfn,
237                 args.as_ptr(),
238                 args.len() as c_uint,
239                 then,
240                 catch,
241                 bundle,
242                 UNNAMED,
243             )
244         }
245     }
246
247     fn unreachable(&mut self) {
248         unsafe {
249             llvm::LLVMBuildUnreachable(self.llbuilder);
250         }
251     }
252
253     builder_methods_for_value_instructions! {
254         add(a, b) => LLVMBuildAdd,
255         fadd(a, b) => LLVMBuildFAdd,
256         sub(a, b) => LLVMBuildSub,
257         fsub(a, b) => LLVMBuildFSub,
258         mul(a, b) => LLVMBuildMul,
259         fmul(a, b) => LLVMBuildFMul,
260         udiv(a, b) => LLVMBuildUDiv,
261         exactudiv(a, b) => LLVMBuildExactUDiv,
262         sdiv(a, b) => LLVMBuildSDiv,
263         exactsdiv(a, b) => LLVMBuildExactSDiv,
264         fdiv(a, b) => LLVMBuildFDiv,
265         urem(a, b) => LLVMBuildURem,
266         srem(a, b) => LLVMBuildSRem,
267         frem(a, b) => LLVMBuildFRem,
268         shl(a, b) => LLVMBuildShl,
269         lshr(a, b) => LLVMBuildLShr,
270         ashr(a, b) => LLVMBuildAShr,
271         and(a, b) => LLVMBuildAnd,
272         or(a, b) => LLVMBuildOr,
273         xor(a, b) => LLVMBuildXor,
274         neg(x) => LLVMBuildNeg,
275         fneg(x) => LLVMBuildFNeg,
276         not(x) => LLVMBuildNot,
277         unchecked_sadd(x, y) => LLVMBuildNSWAdd,
278         unchecked_uadd(x, y) => LLVMBuildNUWAdd,
279         unchecked_ssub(x, y) => LLVMBuildNSWSub,
280         unchecked_usub(x, y) => LLVMBuildNUWSub,
281         unchecked_smul(x, y) => LLVMBuildNSWMul,
282         unchecked_umul(x, y) => LLVMBuildNUWMul,
283     }
284
285     fn fadd_fast(&mut self, lhs: &'ll Value, rhs: &'ll Value) -> &'ll Value {
286         unsafe {
287             let instr = llvm::LLVMBuildFAdd(self.llbuilder, lhs, rhs, UNNAMED);
288             llvm::LLVMRustSetFastMath(instr);
289             instr
290         }
291     }
292
293     fn fsub_fast(&mut self, lhs: &'ll Value, rhs: &'ll Value) -> &'ll Value {
294         unsafe {
295             let instr = llvm::LLVMBuildFSub(self.llbuilder, lhs, rhs, UNNAMED);
296             llvm::LLVMRustSetFastMath(instr);
297             instr
298         }
299     }
300
301     fn fmul_fast(&mut self, lhs: &'ll Value, rhs: &'ll Value) -> &'ll Value {
302         unsafe {
303             let instr = llvm::LLVMBuildFMul(self.llbuilder, lhs, rhs, UNNAMED);
304             llvm::LLVMRustSetFastMath(instr);
305             instr
306         }
307     }
308
309     fn fdiv_fast(&mut self, lhs: &'ll Value, rhs: &'ll Value) -> &'ll Value {
310         unsafe {
311             let instr = llvm::LLVMBuildFDiv(self.llbuilder, lhs, rhs, UNNAMED);
312             llvm::LLVMRustSetFastMath(instr);
313             instr
314         }
315     }
316
317     fn frem_fast(&mut self, lhs: &'ll Value, rhs: &'ll Value) -> &'ll Value {
318         unsafe {
319             let instr = llvm::LLVMBuildFRem(self.llbuilder, lhs, rhs, UNNAMED);
320             llvm::LLVMRustSetFastMath(instr);
321             instr
322         }
323     }
324
325     fn checked_binop(
326         &mut self,
327         oop: OverflowOp,
328         ty: Ty<'_>,
329         lhs: Self::Value,
330         rhs: Self::Value,
331     ) -> (Self::Value, Self::Value) {
332         use rustc_middle::ty::{Int, Uint};
333         use rustc_middle::ty::{IntTy::*, UintTy::*};
334
335         let new_kind = match ty.kind() {
336             Int(t @ Isize) => Int(t.normalize(self.tcx.sess.target.pointer_width)),
337             Uint(t @ Usize) => Uint(t.normalize(self.tcx.sess.target.pointer_width)),
338             t @ (Uint(_) | Int(_)) => t.clone(),
339             _ => panic!("tried to get overflow intrinsic for op applied to non-int type"),
340         };
341
342         let name = match oop {
343             OverflowOp::Add => match new_kind {
344                 Int(I8) => "llvm.sadd.with.overflow.i8",
345                 Int(I16) => "llvm.sadd.with.overflow.i16",
346                 Int(I32) => "llvm.sadd.with.overflow.i32",
347                 Int(I64) => "llvm.sadd.with.overflow.i64",
348                 Int(I128) => "llvm.sadd.with.overflow.i128",
349
350                 Uint(U8) => "llvm.uadd.with.overflow.i8",
351                 Uint(U16) => "llvm.uadd.with.overflow.i16",
352                 Uint(U32) => "llvm.uadd.with.overflow.i32",
353                 Uint(U64) => "llvm.uadd.with.overflow.i64",
354                 Uint(U128) => "llvm.uadd.with.overflow.i128",
355
356                 _ => unreachable!(),
357             },
358             OverflowOp::Sub => match new_kind {
359                 Int(I8) => "llvm.ssub.with.overflow.i8",
360                 Int(I16) => "llvm.ssub.with.overflow.i16",
361                 Int(I32) => "llvm.ssub.with.overflow.i32",
362                 Int(I64) => "llvm.ssub.with.overflow.i64",
363                 Int(I128) => "llvm.ssub.with.overflow.i128",
364
365                 Uint(U8) => "llvm.usub.with.overflow.i8",
366                 Uint(U16) => "llvm.usub.with.overflow.i16",
367                 Uint(U32) => "llvm.usub.with.overflow.i32",
368                 Uint(U64) => "llvm.usub.with.overflow.i64",
369                 Uint(U128) => "llvm.usub.with.overflow.i128",
370
371                 _ => unreachable!(),
372             },
373             OverflowOp::Mul => match new_kind {
374                 Int(I8) => "llvm.smul.with.overflow.i8",
375                 Int(I16) => "llvm.smul.with.overflow.i16",
376                 Int(I32) => "llvm.smul.with.overflow.i32",
377                 Int(I64) => "llvm.smul.with.overflow.i64",
378                 Int(I128) => "llvm.smul.with.overflow.i128",
379
380                 Uint(U8) => "llvm.umul.with.overflow.i8",
381                 Uint(U16) => "llvm.umul.with.overflow.i16",
382                 Uint(U32) => "llvm.umul.with.overflow.i32",
383                 Uint(U64) => "llvm.umul.with.overflow.i64",
384                 Uint(U128) => "llvm.umul.with.overflow.i128",
385
386                 _ => unreachable!(),
387             },
388         };
389
390         let res = self.call_intrinsic(name, &[lhs, rhs]);
391         (self.extract_value(res, 0), self.extract_value(res, 1))
392     }
393
394     fn from_immediate(&mut self, val: Self::Value) -> Self::Value {
395         if self.cx().val_ty(val) == self.cx().type_i1() {
396             self.zext(val, self.cx().type_i8())
397         } else {
398             val
399         }
400     }
401     fn to_immediate_scalar(&mut self, val: Self::Value, scalar: abi::Scalar) -> Self::Value {
402         if scalar.is_bool() {
403             return self.trunc(val, self.cx().type_i1());
404         }
405         val
406     }
407
408     fn alloca(&mut self, ty: &'ll Type, align: Align) -> &'ll Value {
409         let mut bx = Builder::with_cx(self.cx);
410         bx.position_at_start(unsafe { llvm::LLVMGetFirstBasicBlock(self.llfn()) });
411         bx.dynamic_alloca(ty, align)
412     }
413
414     fn dynamic_alloca(&mut self, ty: &'ll Type, align: Align) -> &'ll Value {
415         unsafe {
416             let alloca = llvm::LLVMBuildAlloca(self.llbuilder, ty, UNNAMED);
417             llvm::LLVMSetAlignment(alloca, align.bytes() as c_uint);
418             alloca
419         }
420     }
421
422     fn array_alloca(&mut self, ty: &'ll Type, len: &'ll Value, align: Align) -> &'ll Value {
423         unsafe {
424             let alloca = llvm::LLVMBuildArrayAlloca(self.llbuilder, ty, len, UNNAMED);
425             llvm::LLVMSetAlignment(alloca, align.bytes() as c_uint);
426             alloca
427         }
428     }
429
430     fn load(&mut self, ty: &'ll Type, ptr: &'ll Value, align: Align) -> &'ll Value {
431         unsafe {
432             let load = llvm::LLVMBuildLoad2(self.llbuilder, ty, ptr, UNNAMED);
433             llvm::LLVMSetAlignment(load, align.bytes() as c_uint);
434             load
435         }
436     }
437
438     fn volatile_load(&mut self, ty: &'ll Type, ptr: &'ll Value) -> &'ll Value {
439         unsafe {
440             let load = llvm::LLVMBuildLoad2(self.llbuilder, ty, ptr, UNNAMED);
441             llvm::LLVMSetVolatile(load, llvm::True);
442             load
443         }
444     }
445
446     fn atomic_load(
447         &mut self,
448         ty: &'ll Type,
449         ptr: &'ll Value,
450         order: rustc_codegen_ssa::common::AtomicOrdering,
451         size: Size,
452     ) -> &'ll Value {
453         unsafe {
454             let load = llvm::LLVMRustBuildAtomicLoad(
455                 self.llbuilder,
456                 ty,
457                 ptr,
458                 UNNAMED,
459                 AtomicOrdering::from_generic(order),
460             );
461             // LLVM requires the alignment of atomic loads to be at least the size of the type.
462             llvm::LLVMSetAlignment(load, size.bytes() as c_uint);
463             load
464         }
465     }
466
467     fn load_operand(&mut self, place: PlaceRef<'tcx, &'ll Value>) -> OperandRef<'tcx, &'ll Value> {
468         debug!("PlaceRef::load: {:?}", place);
469
470         assert_eq!(place.llextra.is_some(), place.layout.is_unsized());
471
472         if place.layout.is_zst() {
473             return OperandRef::new_zst(self, place.layout);
474         }
475
476         fn scalar_load_metadata<'a, 'll, 'tcx>(
477             bx: &mut Builder<'a, 'll, 'tcx>,
478             load: &'ll Value,
479             scalar: abi::Scalar,
480         ) {
481             match scalar.value {
482                 abi::Int(..) => {
483                     if !scalar.is_always_valid(bx) {
484                         bx.range_metadata(load, scalar.valid_range);
485                     }
486                 }
487                 abi::Pointer if !scalar.valid_range.contains(0) => {
488                     bx.nonnull_metadata(load);
489                 }
490                 _ => {}
491             }
492         }
493
494         let val = if let Some(llextra) = place.llextra {
495             OperandValue::Ref(place.llval, Some(llextra), place.align)
496         } else if place.layout.is_llvm_immediate() {
497             let mut const_llval = None;
498             unsafe {
499                 if let Some(global) = llvm::LLVMIsAGlobalVariable(place.llval) {
500                     if llvm::LLVMIsGlobalConstant(global) == llvm::True {
501                         const_llval = llvm::LLVMGetInitializer(global);
502                     }
503                 }
504             }
505             let llval = const_llval.unwrap_or_else(|| {
506                 let load = self.load(place.layout.llvm_type(self), place.llval, place.align);
507                 if let abi::Abi::Scalar(scalar) = place.layout.abi {
508                     scalar_load_metadata(self, load, scalar);
509                 }
510                 load
511             });
512             OperandValue::Immediate(self.to_immediate(llval, place.layout))
513         } else if let abi::Abi::ScalarPair(a, b) = place.layout.abi {
514             let b_offset = a.value.size(self).align_to(b.value.align(self).abi);
515             let pair_ty = place.layout.llvm_type(self);
516
517             let mut load = |i, scalar: abi::Scalar, align| {
518                 let llptr = self.struct_gep(pair_ty, place.llval, i as u64);
519                 let llty = place.layout.scalar_pair_element_llvm_type(self, i, false);
520                 let load = self.load(llty, llptr, align);
521                 scalar_load_metadata(self, load, scalar);
522                 self.to_immediate_scalar(load, scalar)
523             };
524
525             OperandValue::Pair(
526                 load(0, a, place.align),
527                 load(1, b, place.align.restrict_for_offset(b_offset)),
528             )
529         } else {
530             OperandValue::Ref(place.llval, None, place.align)
531         };
532
533         OperandRef { val, layout: place.layout }
534     }
535
536     fn write_operand_repeatedly(
537         mut self,
538         cg_elem: OperandRef<'tcx, &'ll Value>,
539         count: u64,
540         dest: PlaceRef<'tcx, &'ll Value>,
541     ) -> Self {
542         let zero = self.const_usize(0);
543         let count = self.const_usize(count);
544         let start = dest.project_index(&mut self, zero).llval;
545         let end = dest.project_index(&mut self, count).llval;
546
547         let mut header_bx = self.build_sibling_block("repeat_loop_header");
548         let mut body_bx = self.build_sibling_block("repeat_loop_body");
549         let next_bx = self.build_sibling_block("repeat_loop_next");
550
551         self.br(header_bx.llbb());
552         let current = header_bx.phi(self.val_ty(start), &[start], &[self.llbb()]);
553
554         let keep_going = header_bx.icmp(IntPredicate::IntNE, current, end);
555         header_bx.cond_br(keep_going, body_bx.llbb(), next_bx.llbb());
556
557         let align = dest.align.restrict_for_offset(dest.layout.field(self.cx(), 0).size);
558         cg_elem
559             .val
560             .store(&mut body_bx, PlaceRef::new_sized_aligned(current, cg_elem.layout, align));
561
562         let next = body_bx.inbounds_gep(
563             self.backend_type(cg_elem.layout),
564             current,
565             &[self.const_usize(1)],
566         );
567         body_bx.br(header_bx.llbb());
568         header_bx.add_incoming_to_phi(current, next, body_bx.llbb());
569
570         next_bx
571     }
572
573     fn range_metadata(&mut self, load: &'ll Value, range: WrappingRange) {
574         if self.sess().target.arch == "amdgpu" {
575             // amdgpu/LLVM does something weird and thinks an i64 value is
576             // split into a v2i32, halving the bitwidth LLVM expects,
577             // tripping an assertion. So, for now, just disable this
578             // optimization.
579             return;
580         }
581
582         unsafe {
583             let llty = self.cx.val_ty(load);
584             let v = [
585                 self.cx.const_uint_big(llty, range.start),
586                 self.cx.const_uint_big(llty, range.end.wrapping_add(1)),
587             ];
588
589             llvm::LLVMSetMetadata(
590                 load,
591                 llvm::MD_range as c_uint,
592                 llvm::LLVMMDNodeInContext(self.cx.llcx, v.as_ptr(), v.len() as c_uint),
593             );
594         }
595     }
596
597     fn nonnull_metadata(&mut self, load: &'ll Value) {
598         unsafe {
599             llvm::LLVMSetMetadata(
600                 load,
601                 llvm::MD_nonnull as c_uint,
602                 llvm::LLVMMDNodeInContext(self.cx.llcx, ptr::null(), 0),
603             );
604         }
605     }
606
607     fn store(&mut self, val: &'ll Value, ptr: &'ll Value, align: Align) -> &'ll Value {
608         self.store_with_flags(val, ptr, align, MemFlags::empty())
609     }
610
611     fn store_with_flags(
612         &mut self,
613         val: &'ll Value,
614         ptr: &'ll Value,
615         align: Align,
616         flags: MemFlags,
617     ) -> &'ll Value {
618         debug!("Store {:?} -> {:?} ({:?})", val, ptr, flags);
619         let ptr = self.check_store(val, ptr);
620         unsafe {
621             let store = llvm::LLVMBuildStore(self.llbuilder, val, ptr);
622             let align =
623                 if flags.contains(MemFlags::UNALIGNED) { 1 } else { align.bytes() as c_uint };
624             llvm::LLVMSetAlignment(store, align);
625             if flags.contains(MemFlags::VOLATILE) {
626                 llvm::LLVMSetVolatile(store, llvm::True);
627             }
628             if flags.contains(MemFlags::NONTEMPORAL) {
629                 // According to LLVM [1] building a nontemporal store must
630                 // *always* point to a metadata value of the integer 1.
631                 //
632                 // [1]: https://llvm.org/docs/LangRef.html#store-instruction
633                 let one = self.cx.const_i32(1);
634                 let node = llvm::LLVMMDNodeInContext(self.cx.llcx, &one, 1);
635                 llvm::LLVMSetMetadata(store, llvm::MD_nontemporal as c_uint, node);
636             }
637             store
638         }
639     }
640
641     fn atomic_store(
642         &mut self,
643         val: &'ll Value,
644         ptr: &'ll Value,
645         order: rustc_codegen_ssa::common::AtomicOrdering,
646         size: Size,
647     ) {
648         debug!("Store {:?} -> {:?}", val, ptr);
649         let ptr = self.check_store(val, ptr);
650         unsafe {
651             let store = llvm::LLVMRustBuildAtomicStore(
652                 self.llbuilder,
653                 val,
654                 ptr,
655                 AtomicOrdering::from_generic(order),
656             );
657             // LLVM requires the alignment of atomic stores to be at least the size of the type.
658             llvm::LLVMSetAlignment(store, size.bytes() as c_uint);
659         }
660     }
661
662     fn gep(&mut self, ty: &'ll Type, ptr: &'ll Value, indices: &[&'ll Value]) -> &'ll Value {
663         unsafe {
664             llvm::LLVMBuildGEP2(
665                 self.llbuilder,
666                 ty,
667                 ptr,
668                 indices.as_ptr(),
669                 indices.len() as c_uint,
670                 UNNAMED,
671             )
672         }
673     }
674
675     fn inbounds_gep(
676         &mut self,
677         ty: &'ll Type,
678         ptr: &'ll Value,
679         indices: &[&'ll Value],
680     ) -> &'ll Value {
681         unsafe {
682             llvm::LLVMBuildInBoundsGEP2(
683                 self.llbuilder,
684                 ty,
685                 ptr,
686                 indices.as_ptr(),
687                 indices.len() as c_uint,
688                 UNNAMED,
689             )
690         }
691     }
692
693     fn struct_gep(&mut self, ty: &'ll Type, ptr: &'ll Value, idx: u64) -> &'ll Value {
694         assert_eq!(idx as c_uint as u64, idx);
695         unsafe { llvm::LLVMBuildStructGEP2(self.llbuilder, ty, ptr, idx as c_uint, UNNAMED) }
696     }
697
698     /* Casts */
699     fn trunc(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
700         unsafe { llvm::LLVMBuildTrunc(self.llbuilder, val, dest_ty, UNNAMED) }
701     }
702
703     fn sext(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
704         unsafe { llvm::LLVMBuildSExt(self.llbuilder, val, dest_ty, UNNAMED) }
705     }
706
707     fn fptoui_sat(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> Option<&'ll Value> {
708         if llvm_util::get_version() >= (12, 0, 0) && !self.fptoint_sat_broken_in_llvm() {
709             let src_ty = self.cx.val_ty(val);
710             let float_width = self.cx.float_width(src_ty);
711             let int_width = self.cx.int_width(dest_ty);
712             let name = format!("llvm.fptoui.sat.i{}.f{}", int_width, float_width);
713             return Some(self.call_intrinsic(&name, &[val]));
714         }
715
716         None
717     }
718
719     fn fptosi_sat(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> Option<&'ll Value> {
720         if llvm_util::get_version() >= (12, 0, 0) && !self.fptoint_sat_broken_in_llvm() {
721             let src_ty = self.cx.val_ty(val);
722             let float_width = self.cx.float_width(src_ty);
723             let int_width = self.cx.int_width(dest_ty);
724             let name = format!("llvm.fptosi.sat.i{}.f{}", int_width, float_width);
725             return Some(self.call_intrinsic(&name, &[val]));
726         }
727
728         None
729     }
730
731     fn fptoui(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
732         // On WebAssembly the `fptoui` and `fptosi` instructions currently have
733         // poor codegen. The reason for this is that the corresponding wasm
734         // instructions, `i32.trunc_f32_s` for example, will trap when the float
735         // is out-of-bounds, infinity, or nan. This means that LLVM
736         // automatically inserts control flow around `fptoui` and `fptosi`
737         // because the LLVM instruction `fptoui` is defined as producing a
738         // poison value, not having UB on out-of-bounds values.
739         //
740         // This method, however, is only used with non-saturating casts that
741         // have UB on out-of-bounds values. This means that it's ok if we use
742         // the raw wasm instruction since out-of-bounds values can do whatever
743         // we like. To ensure that LLVM picks the right instruction we choose
744         // the raw wasm intrinsic functions which avoid LLVM inserting all the
745         // other control flow automatically.
746         if self.sess().target.arch == "wasm32" {
747             let src_ty = self.cx.val_ty(val);
748             if self.cx.type_kind(src_ty) != TypeKind::Vector {
749                 let float_width = self.cx.float_width(src_ty);
750                 let int_width = self.cx.int_width(dest_ty);
751                 let name = match (int_width, float_width) {
752                     (32, 32) => Some("llvm.wasm.trunc.unsigned.i32.f32"),
753                     (32, 64) => Some("llvm.wasm.trunc.unsigned.i32.f64"),
754                     (64, 32) => Some("llvm.wasm.trunc.unsigned.i64.f32"),
755                     (64, 64) => Some("llvm.wasm.trunc.unsigned.i64.f64"),
756                     _ => None,
757                 };
758                 if let Some(name) = name {
759                     return self.call_intrinsic(name, &[val]);
760                 }
761             }
762         }
763         unsafe { llvm::LLVMBuildFPToUI(self.llbuilder, val, dest_ty, UNNAMED) }
764     }
765
766     fn fptosi(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
767         // see `fptoui` above for why wasm is different here
768         if self.sess().target.arch == "wasm32" {
769             let src_ty = self.cx.val_ty(val);
770             if self.cx.type_kind(src_ty) != TypeKind::Vector {
771                 let float_width = self.cx.float_width(src_ty);
772                 let int_width = self.cx.int_width(dest_ty);
773                 let name = match (int_width, float_width) {
774                     (32, 32) => Some("llvm.wasm.trunc.signed.i32.f32"),
775                     (32, 64) => Some("llvm.wasm.trunc.signed.i32.f64"),
776                     (64, 32) => Some("llvm.wasm.trunc.signed.i64.f32"),
777                     (64, 64) => Some("llvm.wasm.trunc.signed.i64.f64"),
778                     _ => None,
779                 };
780                 if let Some(name) = name {
781                     return self.call_intrinsic(name, &[val]);
782                 }
783             }
784         }
785         unsafe { llvm::LLVMBuildFPToSI(self.llbuilder, val, dest_ty, UNNAMED) }
786     }
787
788     fn uitofp(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
789         unsafe { llvm::LLVMBuildUIToFP(self.llbuilder, val, dest_ty, UNNAMED) }
790     }
791
792     fn sitofp(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
793         unsafe { llvm::LLVMBuildSIToFP(self.llbuilder, val, dest_ty, UNNAMED) }
794     }
795
796     fn fptrunc(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
797         unsafe { llvm::LLVMBuildFPTrunc(self.llbuilder, val, dest_ty, UNNAMED) }
798     }
799
800     fn fpext(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
801         unsafe { llvm::LLVMBuildFPExt(self.llbuilder, val, dest_ty, UNNAMED) }
802     }
803
804     fn ptrtoint(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
805         unsafe { llvm::LLVMBuildPtrToInt(self.llbuilder, val, dest_ty, UNNAMED) }
806     }
807
808     fn inttoptr(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
809         unsafe { llvm::LLVMBuildIntToPtr(self.llbuilder, val, dest_ty, UNNAMED) }
810     }
811
812     fn bitcast(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
813         unsafe { llvm::LLVMBuildBitCast(self.llbuilder, val, dest_ty, UNNAMED) }
814     }
815
816     fn intcast(&mut self, val: &'ll Value, dest_ty: &'ll Type, is_signed: bool) -> &'ll Value {
817         unsafe { llvm::LLVMRustBuildIntCast(self.llbuilder, val, dest_ty, is_signed) }
818     }
819
820     fn pointercast(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
821         unsafe { llvm::LLVMBuildPointerCast(self.llbuilder, val, dest_ty, UNNAMED) }
822     }
823
824     /* Comparisons */
825     fn icmp(&mut self, op: IntPredicate, lhs: &'ll Value, rhs: &'ll Value) -> &'ll Value {
826         let op = llvm::IntPredicate::from_generic(op);
827         unsafe { llvm::LLVMBuildICmp(self.llbuilder, op as c_uint, lhs, rhs, UNNAMED) }
828     }
829
830     fn fcmp(&mut self, op: RealPredicate, lhs: &'ll Value, rhs: &'ll Value) -> &'ll Value {
831         unsafe { llvm::LLVMBuildFCmp(self.llbuilder, op as c_uint, lhs, rhs, UNNAMED) }
832     }
833
834     /* Miscellaneous instructions */
835     fn memcpy(
836         &mut self,
837         dst: &'ll Value,
838         dst_align: Align,
839         src: &'ll Value,
840         src_align: Align,
841         size: &'ll Value,
842         flags: MemFlags,
843     ) {
844         assert!(!flags.contains(MemFlags::NONTEMPORAL), "non-temporal memcpy not supported");
845         let size = self.intcast(size, self.type_isize(), false);
846         let is_volatile = flags.contains(MemFlags::VOLATILE);
847         let dst = self.pointercast(dst, self.type_i8p());
848         let src = self.pointercast(src, self.type_i8p());
849         unsafe {
850             llvm::LLVMRustBuildMemCpy(
851                 self.llbuilder,
852                 dst,
853                 dst_align.bytes() as c_uint,
854                 src,
855                 src_align.bytes() as c_uint,
856                 size,
857                 is_volatile,
858             );
859         }
860     }
861
862     fn memmove(
863         &mut self,
864         dst: &'ll Value,
865         dst_align: Align,
866         src: &'ll Value,
867         src_align: Align,
868         size: &'ll Value,
869         flags: MemFlags,
870     ) {
871         assert!(!flags.contains(MemFlags::NONTEMPORAL), "non-temporal memmove not supported");
872         let size = self.intcast(size, self.type_isize(), false);
873         let is_volatile = flags.contains(MemFlags::VOLATILE);
874         let dst = self.pointercast(dst, self.type_i8p());
875         let src = self.pointercast(src, self.type_i8p());
876         unsafe {
877             llvm::LLVMRustBuildMemMove(
878                 self.llbuilder,
879                 dst,
880                 dst_align.bytes() as c_uint,
881                 src,
882                 src_align.bytes() as c_uint,
883                 size,
884                 is_volatile,
885             );
886         }
887     }
888
889     fn memset(
890         &mut self,
891         ptr: &'ll Value,
892         fill_byte: &'ll Value,
893         size: &'ll Value,
894         align: Align,
895         flags: MemFlags,
896     ) {
897         let is_volatile = flags.contains(MemFlags::VOLATILE);
898         let ptr = self.pointercast(ptr, self.type_i8p());
899         unsafe {
900             llvm::LLVMRustBuildMemSet(
901                 self.llbuilder,
902                 ptr,
903                 align.bytes() as c_uint,
904                 fill_byte,
905                 size,
906                 is_volatile,
907             );
908         }
909     }
910
911     fn select(
912         &mut self,
913         cond: &'ll Value,
914         then_val: &'ll Value,
915         else_val: &'ll Value,
916     ) -> &'ll Value {
917         unsafe { llvm::LLVMBuildSelect(self.llbuilder, cond, then_val, else_val, UNNAMED) }
918     }
919
920     fn va_arg(&mut self, list: &'ll Value, ty: &'ll Type) -> &'ll Value {
921         unsafe { llvm::LLVMBuildVAArg(self.llbuilder, list, ty, UNNAMED) }
922     }
923
924     fn extract_element(&mut self, vec: &'ll Value, idx: &'ll Value) -> &'ll Value {
925         unsafe { llvm::LLVMBuildExtractElement(self.llbuilder, vec, idx, UNNAMED) }
926     }
927
928     fn vector_splat(&mut self, num_elts: usize, elt: &'ll Value) -> &'ll Value {
929         unsafe {
930             let elt_ty = self.cx.val_ty(elt);
931             let undef = llvm::LLVMGetUndef(self.type_vector(elt_ty, num_elts as u64));
932             let vec = self.insert_element(undef, elt, self.cx.const_i32(0));
933             let vec_i32_ty = self.type_vector(self.type_i32(), num_elts as u64);
934             self.shuffle_vector(vec, undef, self.const_null(vec_i32_ty))
935         }
936     }
937
938     fn extract_value(&mut self, agg_val: &'ll Value, idx: u64) -> &'ll Value {
939         assert_eq!(idx as c_uint as u64, idx);
940         unsafe { llvm::LLVMBuildExtractValue(self.llbuilder, agg_val, idx as c_uint, UNNAMED) }
941     }
942
943     fn insert_value(&mut self, agg_val: &'ll Value, elt: &'ll Value, idx: u64) -> &'ll Value {
944         assert_eq!(idx as c_uint as u64, idx);
945         unsafe { llvm::LLVMBuildInsertValue(self.llbuilder, agg_val, elt, idx as c_uint, UNNAMED) }
946     }
947
948     fn landing_pad(
949         &mut self,
950         ty: &'ll Type,
951         pers_fn: &'ll Value,
952         num_clauses: usize,
953     ) -> &'ll Value {
954         // Use LLVMSetPersonalityFn to set the personality. It supports arbitrary Consts while,
955         // LLVMBuildLandingPad requires the argument to be a Function (as of LLVM 12). The
956         // personality lives on the parent function anyway.
957         self.set_personality_fn(pers_fn);
958         unsafe {
959             llvm::LLVMBuildLandingPad(self.llbuilder, ty, None, num_clauses as c_uint, UNNAMED)
960         }
961     }
962
963     fn set_cleanup(&mut self, landing_pad: &'ll Value) {
964         unsafe {
965             llvm::LLVMSetCleanup(landing_pad, llvm::True);
966         }
967     }
968
969     fn resume(&mut self, exn: &'ll Value) -> &'ll Value {
970         unsafe { llvm::LLVMBuildResume(self.llbuilder, exn) }
971     }
972
973     fn cleanup_pad(&mut self, parent: Option<&'ll Value>, args: &[&'ll Value]) -> Funclet<'ll> {
974         let name = cstr!("cleanuppad");
975         let ret = unsafe {
976             llvm::LLVMRustBuildCleanupPad(
977                 self.llbuilder,
978                 parent,
979                 args.len() as c_uint,
980                 args.as_ptr(),
981                 name.as_ptr(),
982             )
983         };
984         Funclet::new(ret.expect("LLVM does not have support for cleanuppad"))
985     }
986
987     fn cleanup_ret(
988         &mut self,
989         funclet: &Funclet<'ll>,
990         unwind: Option<&'ll BasicBlock>,
991     ) -> &'ll Value {
992         let ret =
993             unsafe { llvm::LLVMRustBuildCleanupRet(self.llbuilder, funclet.cleanuppad(), unwind) };
994         ret.expect("LLVM does not have support for cleanupret")
995     }
996
997     fn catch_pad(&mut self, parent: &'ll Value, args: &[&'ll Value]) -> Funclet<'ll> {
998         let name = cstr!("catchpad");
999         let ret = unsafe {
1000             llvm::LLVMRustBuildCatchPad(
1001                 self.llbuilder,
1002                 parent,
1003                 args.len() as c_uint,
1004                 args.as_ptr(),
1005                 name.as_ptr(),
1006             )
1007         };
1008         Funclet::new(ret.expect("LLVM does not have support for catchpad"))
1009     }
1010
1011     fn catch_switch(
1012         &mut self,
1013         parent: Option<&'ll Value>,
1014         unwind: Option<&'ll BasicBlock>,
1015         num_handlers: usize,
1016     ) -> &'ll Value {
1017         let name = cstr!("catchswitch");
1018         let ret = unsafe {
1019             llvm::LLVMRustBuildCatchSwitch(
1020                 self.llbuilder,
1021                 parent,
1022                 unwind,
1023                 num_handlers as c_uint,
1024                 name.as_ptr(),
1025             )
1026         };
1027         ret.expect("LLVM does not have support for catchswitch")
1028     }
1029
1030     fn add_handler(&mut self, catch_switch: &'ll Value, handler: &'ll BasicBlock) {
1031         unsafe {
1032             llvm::LLVMRustAddHandler(catch_switch, handler);
1033         }
1034     }
1035
1036     fn set_personality_fn(&mut self, personality: &'ll Value) {
1037         unsafe {
1038             llvm::LLVMSetPersonalityFn(self.llfn(), personality);
1039         }
1040     }
1041
1042     // Atomic Operations
1043     fn atomic_cmpxchg(
1044         &mut self,
1045         dst: &'ll Value,
1046         cmp: &'ll Value,
1047         src: &'ll Value,
1048         order: rustc_codegen_ssa::common::AtomicOrdering,
1049         failure_order: rustc_codegen_ssa::common::AtomicOrdering,
1050         weak: bool,
1051     ) -> &'ll Value {
1052         let weak = if weak { llvm::True } else { llvm::False };
1053         unsafe {
1054             llvm::LLVMRustBuildAtomicCmpXchg(
1055                 self.llbuilder,
1056                 dst,
1057                 cmp,
1058                 src,
1059                 AtomicOrdering::from_generic(order),
1060                 AtomicOrdering::from_generic(failure_order),
1061                 weak,
1062             )
1063         }
1064     }
1065     fn atomic_rmw(
1066         &mut self,
1067         op: rustc_codegen_ssa::common::AtomicRmwBinOp,
1068         dst: &'ll Value,
1069         src: &'ll Value,
1070         order: rustc_codegen_ssa::common::AtomicOrdering,
1071     ) -> &'ll Value {
1072         unsafe {
1073             llvm::LLVMBuildAtomicRMW(
1074                 self.llbuilder,
1075                 AtomicRmwBinOp::from_generic(op),
1076                 dst,
1077                 src,
1078                 AtomicOrdering::from_generic(order),
1079                 False,
1080             )
1081         }
1082     }
1083
1084     fn atomic_fence(
1085         &mut self,
1086         order: rustc_codegen_ssa::common::AtomicOrdering,
1087         scope: rustc_codegen_ssa::common::SynchronizationScope,
1088     ) {
1089         unsafe {
1090             llvm::LLVMRustBuildAtomicFence(
1091                 self.llbuilder,
1092                 AtomicOrdering::from_generic(order),
1093                 SynchronizationScope::from_generic(scope),
1094             );
1095         }
1096     }
1097
1098     fn set_invariant_load(&mut self, load: &'ll Value) {
1099         unsafe {
1100             llvm::LLVMSetMetadata(
1101                 load,
1102                 llvm::MD_invariant_load as c_uint,
1103                 llvm::LLVMMDNodeInContext(self.cx.llcx, ptr::null(), 0),
1104             );
1105         }
1106     }
1107
1108     fn lifetime_start(&mut self, ptr: &'ll Value, size: Size) {
1109         self.call_lifetime_intrinsic("llvm.lifetime.start.p0i8", ptr, size);
1110     }
1111
1112     fn lifetime_end(&mut self, ptr: &'ll Value, size: Size) {
1113         self.call_lifetime_intrinsic("llvm.lifetime.end.p0i8", ptr, size);
1114     }
1115
1116     fn instrprof_increment(
1117         &mut self,
1118         fn_name: &'ll Value,
1119         hash: &'ll Value,
1120         num_counters: &'ll Value,
1121         index: &'ll Value,
1122     ) {
1123         debug!(
1124             "instrprof_increment() with args ({:?}, {:?}, {:?}, {:?})",
1125             fn_name, hash, num_counters, index
1126         );
1127
1128         let llfn = unsafe { llvm::LLVMRustGetInstrProfIncrementIntrinsic(self.cx().llmod) };
1129         let llty = self.cx.type_func(
1130             &[self.cx.type_i8p(), self.cx.type_i64(), self.cx.type_i32(), self.cx.type_i32()],
1131             self.cx.type_void(),
1132         );
1133         let args = &[fn_name, hash, num_counters, index];
1134         let args = self.check_call("call", llty, llfn, args);
1135
1136         unsafe {
1137             let _ = llvm::LLVMRustBuildCall(
1138                 self.llbuilder,
1139                 llty,
1140                 llfn,
1141                 args.as_ptr() as *const &llvm::Value,
1142                 args.len() as c_uint,
1143                 None,
1144             );
1145         }
1146     }
1147
1148     fn call(
1149         &mut self,
1150         llty: &'ll Type,
1151         llfn: &'ll Value,
1152         args: &[&'ll Value],
1153         funclet: Option<&Funclet<'ll>>,
1154     ) -> &'ll Value {
1155         debug!("call {:?} with args ({:?})", llfn, args);
1156
1157         let args = self.check_call("call", llty, llfn, args);
1158         let bundle = funclet.map(|funclet| funclet.bundle());
1159         let bundle = bundle.as_ref().map(|b| &*b.raw);
1160
1161         unsafe {
1162             llvm::LLVMRustBuildCall(
1163                 self.llbuilder,
1164                 llty,
1165                 llfn,
1166                 args.as_ptr() as *const &llvm::Value,
1167                 args.len() as c_uint,
1168                 bundle,
1169             )
1170         }
1171     }
1172
1173     fn zext(&mut self, val: &'ll Value, dest_ty: &'ll Type) -> &'ll Value {
1174         unsafe { llvm::LLVMBuildZExt(self.llbuilder, val, dest_ty, UNNAMED) }
1175     }
1176
1177     fn do_not_inline(&mut self, llret: &'ll Value) {
1178         llvm::Attribute::NoInline.apply_callsite(llvm::AttributePlace::Function, llret);
1179     }
1180 }
1181
1182 impl StaticBuilderMethods for Builder<'a, 'll, 'tcx> {
1183     fn get_static(&mut self, def_id: DefId) -> &'ll Value {
1184         // Forward to the `get_static` method of `CodegenCx`
1185         self.cx().get_static(def_id)
1186     }
1187 }
1188
1189 impl Builder<'a, 'll, 'tcx> {
1190     fn with_cx(cx: &'a CodegenCx<'ll, 'tcx>) -> Self {
1191         // Create a fresh builder from the crate context.
1192         let llbuilder = unsafe { llvm::LLVMCreateBuilderInContext(cx.llcx) };
1193         Builder { llbuilder, cx }
1194     }
1195
1196     pub fn llfn(&self) -> &'ll Value {
1197         unsafe { llvm::LLVMGetBasicBlockParent(self.llbb()) }
1198     }
1199
1200     fn position_at_start(&mut self, llbb: &'ll BasicBlock) {
1201         unsafe {
1202             llvm::LLVMRustPositionBuilderAtStart(self.llbuilder, llbb);
1203         }
1204     }
1205
1206     pub fn minnum(&mut self, lhs: &'ll Value, rhs: &'ll Value) -> &'ll Value {
1207         unsafe { llvm::LLVMRustBuildMinNum(self.llbuilder, lhs, rhs) }
1208     }
1209
1210     pub fn maxnum(&mut self, lhs: &'ll Value, rhs: &'ll Value) -> &'ll Value {
1211         unsafe { llvm::LLVMRustBuildMaxNum(self.llbuilder, lhs, rhs) }
1212     }
1213
1214     pub fn insert_element(
1215         &mut self,
1216         vec: &'ll Value,
1217         elt: &'ll Value,
1218         idx: &'ll Value,
1219     ) -> &'ll Value {
1220         unsafe { llvm::LLVMBuildInsertElement(self.llbuilder, vec, elt, idx, UNNAMED) }
1221     }
1222
1223     pub fn shuffle_vector(
1224         &mut self,
1225         v1: &'ll Value,
1226         v2: &'ll Value,
1227         mask: &'ll Value,
1228     ) -> &'ll Value {
1229         unsafe { llvm::LLVMBuildShuffleVector(self.llbuilder, v1, v2, mask, UNNAMED) }
1230     }
1231
1232     pub fn vector_reduce_fadd(&mut self, acc: &'ll Value, src: &'ll Value) -> &'ll Value {
1233         unsafe { llvm::LLVMRustBuildVectorReduceFAdd(self.llbuilder, acc, src) }
1234     }
1235     pub fn vector_reduce_fmul(&mut self, acc: &'ll Value, src: &'ll Value) -> &'ll Value {
1236         unsafe { llvm::LLVMRustBuildVectorReduceFMul(self.llbuilder, acc, src) }
1237     }
1238     pub fn vector_reduce_fadd_fast(&mut self, acc: &'ll Value, src: &'ll Value) -> &'ll Value {
1239         unsafe {
1240             let instr = llvm::LLVMRustBuildVectorReduceFAdd(self.llbuilder, acc, src);
1241             llvm::LLVMRustSetFastMath(instr);
1242             instr
1243         }
1244     }
1245     pub fn vector_reduce_fmul_fast(&mut self, acc: &'ll Value, src: &'ll Value) -> &'ll Value {
1246         unsafe {
1247             let instr = llvm::LLVMRustBuildVectorReduceFMul(self.llbuilder, acc, src);
1248             llvm::LLVMRustSetFastMath(instr);
1249             instr
1250         }
1251     }
1252     pub fn vector_reduce_add(&mut self, src: &'ll Value) -> &'ll Value {
1253         unsafe { llvm::LLVMRustBuildVectorReduceAdd(self.llbuilder, src) }
1254     }
1255     pub fn vector_reduce_mul(&mut self, src: &'ll Value) -> &'ll Value {
1256         unsafe { llvm::LLVMRustBuildVectorReduceMul(self.llbuilder, src) }
1257     }
1258     pub fn vector_reduce_and(&mut self, src: &'ll Value) -> &'ll Value {
1259         unsafe { llvm::LLVMRustBuildVectorReduceAnd(self.llbuilder, src) }
1260     }
1261     pub fn vector_reduce_or(&mut self, src: &'ll Value) -> &'ll Value {
1262         unsafe { llvm::LLVMRustBuildVectorReduceOr(self.llbuilder, src) }
1263     }
1264     pub fn vector_reduce_xor(&mut self, src: &'ll Value) -> &'ll Value {
1265         unsafe { llvm::LLVMRustBuildVectorReduceXor(self.llbuilder, src) }
1266     }
1267     pub fn vector_reduce_fmin(&mut self, src: &'ll Value) -> &'ll Value {
1268         unsafe {
1269             llvm::LLVMRustBuildVectorReduceFMin(self.llbuilder, src, /*NoNaNs:*/ false)
1270         }
1271     }
1272     pub fn vector_reduce_fmax(&mut self, src: &'ll Value) -> &'ll Value {
1273         unsafe {
1274             llvm::LLVMRustBuildVectorReduceFMax(self.llbuilder, src, /*NoNaNs:*/ false)
1275         }
1276     }
1277     pub fn vector_reduce_fmin_fast(&mut self, src: &'ll Value) -> &'ll Value {
1278         unsafe {
1279             let instr =
1280                 llvm::LLVMRustBuildVectorReduceFMin(self.llbuilder, src, /*NoNaNs:*/ true);
1281             llvm::LLVMRustSetFastMath(instr);
1282             instr
1283         }
1284     }
1285     pub fn vector_reduce_fmax_fast(&mut self, src: &'ll Value) -> &'ll Value {
1286         unsafe {
1287             let instr =
1288                 llvm::LLVMRustBuildVectorReduceFMax(self.llbuilder, src, /*NoNaNs:*/ true);
1289             llvm::LLVMRustSetFastMath(instr);
1290             instr
1291         }
1292     }
1293     pub fn vector_reduce_min(&mut self, src: &'ll Value, is_signed: bool) -> &'ll Value {
1294         unsafe { llvm::LLVMRustBuildVectorReduceMin(self.llbuilder, src, is_signed) }
1295     }
1296     pub fn vector_reduce_max(&mut self, src: &'ll Value, is_signed: bool) -> &'ll Value {
1297         unsafe { llvm::LLVMRustBuildVectorReduceMax(self.llbuilder, src, is_signed) }
1298     }
1299
1300     pub fn add_clause(&mut self, landing_pad: &'ll Value, clause: &'ll Value) {
1301         unsafe {
1302             llvm::LLVMAddClause(landing_pad, clause);
1303         }
1304     }
1305
1306     pub fn catch_ret(&mut self, funclet: &Funclet<'ll>, unwind: &'ll BasicBlock) -> &'ll Value {
1307         let ret =
1308             unsafe { llvm::LLVMRustBuildCatchRet(self.llbuilder, funclet.cleanuppad(), unwind) };
1309         ret.expect("LLVM does not have support for catchret")
1310     }
1311
1312     fn check_store(&mut self, val: &'ll Value, ptr: &'ll Value) -> &'ll Value {
1313         let dest_ptr_ty = self.cx.val_ty(ptr);
1314         let stored_ty = self.cx.val_ty(val);
1315         let stored_ptr_ty = self.cx.type_ptr_to(stored_ty);
1316
1317         assert_eq!(self.cx.type_kind(dest_ptr_ty), TypeKind::Pointer);
1318
1319         if dest_ptr_ty == stored_ptr_ty {
1320             ptr
1321         } else {
1322             debug!(
1323                 "type mismatch in store. \
1324                     Expected {:?}, got {:?}; inserting bitcast",
1325                 dest_ptr_ty, stored_ptr_ty
1326             );
1327             self.bitcast(ptr, stored_ptr_ty)
1328         }
1329     }
1330
1331     fn check_call<'b>(
1332         &mut self,
1333         typ: &str,
1334         fn_ty: &'ll Type,
1335         llfn: &'ll Value,
1336         args: &'b [&'ll Value],
1337     ) -> Cow<'b, [&'ll Value]> {
1338         assert!(
1339             self.cx.type_kind(fn_ty) == TypeKind::Function,
1340             "builder::{} not passed a function, but {:?}",
1341             typ,
1342             fn_ty
1343         );
1344
1345         let param_tys = self.cx.func_params_types(fn_ty);
1346
1347         let all_args_match = iter::zip(&param_tys, args.iter().map(|&v| self.val_ty(v)))
1348             .all(|(expected_ty, actual_ty)| *expected_ty == actual_ty);
1349
1350         if all_args_match {
1351             return Cow::Borrowed(args);
1352         }
1353
1354         let casted_args: Vec<_> = iter::zip(param_tys, args)
1355             .enumerate()
1356             .map(|(i, (expected_ty, &actual_val))| {
1357                 let actual_ty = self.val_ty(actual_val);
1358                 if expected_ty != actual_ty {
1359                     debug!(
1360                         "type mismatch in function call of {:?}. \
1361                             Expected {:?} for param {}, got {:?}; injecting bitcast",
1362                         llfn, expected_ty, i, actual_ty
1363                     );
1364                     self.bitcast(actual_val, expected_ty)
1365                 } else {
1366                     actual_val
1367                 }
1368             })
1369             .collect();
1370
1371         Cow::Owned(casted_args)
1372     }
1373
1374     pub fn va_arg(&mut self, list: &'ll Value, ty: &'ll Type) -> &'ll Value {
1375         unsafe { llvm::LLVMBuildVAArg(self.llbuilder, list, ty, UNNAMED) }
1376     }
1377
1378     crate fn call_intrinsic(&mut self, intrinsic: &str, args: &[&'ll Value]) -> &'ll Value {
1379         let (ty, f) = self.cx.get_intrinsic(intrinsic);
1380         self.call(ty, f, args, None)
1381     }
1382
1383     fn call_lifetime_intrinsic(&mut self, intrinsic: &str, ptr: &'ll Value, size: Size) {
1384         let size = size.bytes();
1385         if size == 0 {
1386             return;
1387         }
1388
1389         if !self.cx().sess().emit_lifetime_markers() {
1390             return;
1391         }
1392
1393         let ptr = self.pointercast(ptr, self.cx.type_i8p());
1394         self.call_intrinsic(intrinsic, &[self.cx.const_u64(size), ptr]);
1395     }
1396
1397     pub(crate) fn phi(
1398         &mut self,
1399         ty: &'ll Type,
1400         vals: &[&'ll Value],
1401         bbs: &[&'ll BasicBlock],
1402     ) -> &'ll Value {
1403         assert_eq!(vals.len(), bbs.len());
1404         let phi = unsafe { llvm::LLVMBuildPhi(self.llbuilder, ty, UNNAMED) };
1405         unsafe {
1406             llvm::LLVMAddIncoming(phi, vals.as_ptr(), bbs.as_ptr(), vals.len() as c_uint);
1407             phi
1408         }
1409     }
1410
1411     fn add_incoming_to_phi(&mut self, phi: &'ll Value, val: &'ll Value, bb: &'ll BasicBlock) {
1412         unsafe {
1413             llvm::LLVMAddIncoming(phi, &val, &bb, 1 as c_uint);
1414         }
1415     }
1416
1417     fn fptoint_sat_broken_in_llvm(&self) -> bool {
1418         match self.tcx.sess.target.arch.as_str() {
1419             // FIXME - https://bugs.llvm.org/show_bug.cgi?id=50083
1420             "riscv64" => llvm_util::get_version() < (13, 0, 0),
1421             _ => false,
1422         }
1423     }
1424 }