compiler/rustc_mir_transform/src/shim.rs

   1 use rustc_hir as hir;
   2 use rustc_hir::def_id::DefId;
   3 use rustc_hir::lang_items::LangItem;
   4 use rustc_middle::mir::*;
   5 use rustc_middle::ty::query::Providers;
   6 use rustc_middle::ty::subst::{InternalSubsts, Subst};
   7 use rustc_middle::ty::{self, EarlyBinder, Ty, TyCtxt};
   8 use rustc_target::abi::VariantIdx;
   9
  10 use rustc_index::vec::{Idx, IndexVec};
  11
  12 use rustc_span::Span;
  13 use rustc_target::spec::abi::Abi;
  14
  15 use std::fmt;
  16 use std::iter;
  17
  18 use crate::util::expand_aggregate;
  19 use crate::{
  20     abort_unwinding_calls, add_call_guards, add_moves_for_packed_drops, marker, pass_manager as pm,
  21     remove_noop_landing_pads, simplify,
  22 };
  23 use rustc_middle::mir::patch::MirPatch;
  24 use rustc_mir_dataflow::elaborate_drops::{self, DropElaborator, DropFlagMode, DropStyle};
  25
  26 pub fn provide(providers: &mut Providers) {
  27     providers.mir_shims = make_shim;
  28 }
  29
  30 fn make_shim<'tcx>(tcx: TyCtxt<'tcx>, instance: ty::InstanceDef<'tcx>) -> Body<'tcx> {
  31     debug!("make_shim({:?})", instance);
  32
  33     let mut result = match instance {
  34         ty::InstanceDef::Item(..) => bug!("item {:?} passed to make_shim", instance),
  35         ty::InstanceDef::VtableShim(def_id) => {
  36             build_call_shim(tcx, instance, Some(Adjustment::Deref), CallKind::Direct(def_id))
  37         }
  38         ty::InstanceDef::FnPtrShim(def_id, ty) => {
  39             let trait_ = tcx.trait_of_item(def_id).unwrap();
  40             let adjustment = match tcx.fn_trait_kind_from_lang_item(trait_) {
  41                 Some(ty::ClosureKind::FnOnce) => Adjustment::Identity,
  42                 Some(ty::ClosureKind::FnMut | ty::ClosureKind::Fn) => Adjustment::Deref,
  43                 None => bug!("fn pointer {:?} is not an fn", ty),
  44             };
  45
  46             build_call_shim(tcx, instance, Some(adjustment), CallKind::Indirect(ty))
  47         }
  48         // We are generating a call back to our def-id, which the
  49         // codegen backend knows to turn to an actual call, be it
  50         // a virtual call, or a direct call to a function for which
  51         // indirect calls must be codegen'd differently than direct ones
  52         // (such as `#[track_caller]`).
  53         ty::InstanceDef::ReifyShim(def_id) => {
  54             build_call_shim(tcx, instance, None, CallKind::Direct(def_id))
  55         }
  56         ty::InstanceDef::ClosureOnceShim { call_once: _, track_caller: _ } => {
  57             let fn_mut = tcx.require_lang_item(LangItem::FnMut, None);
  58             let call_mut = tcx
  59                 .associated_items(fn_mut)
  60                 .in_definition_order()
  61                 .find(|it| it.kind == ty::AssocKind::Fn)
  62                 .unwrap()
  63                 .def_id;
  64
  65             build_call_shim(tcx, instance, Some(Adjustment::RefMut), CallKind::Direct(call_mut))
  66         }
  67
  68         ty::InstanceDef::DropGlue(def_id, ty) => {
  69             // FIXME(#91576): Drop shims for generators aren't subject to the MIR passes at the end
  70             // of this function. Is this intentional?
  71             if let Some(ty::Generator(gen_def_id, substs, _)) = ty.map(Ty::kind) {
  72                 let body = tcx.optimized_mir(*gen_def_id).generator_drop().unwrap();
  73                 let body = EarlyBinder(body.clone()).subst(tcx, substs);
  74                 debug!("make_shim({:?}) = {:?}", instance, body);
  75                 return body;
  76             }
  77
  78             build_drop_shim(tcx, def_id, ty)
  79         }
  80         ty::InstanceDef::CloneShim(def_id, ty) => build_clone_shim(tcx, def_id, ty),
  81         ty::InstanceDef::Virtual(..) => {
  82             bug!("InstanceDef::Virtual ({:?}) is for direct calls only", instance)
  83         }
  84         ty::InstanceDef::Intrinsic(_) => {
  85             bug!("creating shims from intrinsics ({:?}) is unsupported", instance)
  86         }
  87     };
  88     debug!("make_shim({:?}) = untransformed {:?}", instance, result);
  89
  90     pm::run_passes(
  91         tcx,
  92         &mut result,
  93         &[
  94             &add_moves_for_packed_drops::AddMovesForPackedDrops,
  95             &remove_noop_landing_pads::RemoveNoopLandingPads,
  96             &simplify::SimplifyCfg::new("make_shim"),
  97             &add_call_guards::CriticalCallEdges,
  98             &abort_unwinding_calls::AbortUnwindingCalls,
  99             &marker::PhaseChange(MirPhase::Const),
 100         ],
 101     );
 102
 103     debug!("make_shim({:?}) = {:?}", instance, result);
 104
 105     result
 106 }
 107
 108 #[derive(Copy, Clone, Debug, PartialEq)]
 109 enum Adjustment {
 110     /// Pass the receiver as-is.
 111     Identity,
 112
 113     /// We get passed `&[mut] self` and call the target with `*self`.
 114     ///
 115     /// This either copies `self` (if `Self: Copy`, eg. for function items), or moves out of it
 116     /// (for `VtableShim`, which effectively is passed `&own Self`).
 117     Deref,
 118
 119     /// We get passed `self: Self` and call the target with `&mut self`.
 120     ///
 121     /// In this case we need to ensure that the `Self` is dropped after the call, as the callee
 122     /// won't do it for us.
 123     RefMut,
 124 }
 125
 126 #[derive(Copy, Clone, Debug, PartialEq)]
 127 enum CallKind<'tcx> {
 128     /// Call the `FnPtr` that was passed as the receiver.
 129     Indirect(Ty<'tcx>),
 130
 131     /// Call a known `FnDef`.
 132     Direct(DefId),
 133 }
 134
 135 fn local_decls_for_sig<'tcx>(
 136     sig: &ty::FnSig<'tcx>,
 137     span: Span,
 138 ) -> IndexVec<Local, LocalDecl<'tcx>> {
 139     iter::once(LocalDecl::new(sig.output(), span))
 140         .chain(sig.inputs().iter().map(|ity| LocalDecl::new(*ity, span).immutable()))
 141         .collect()
 142 }
 143
 144 fn build_drop_shim<'tcx>(tcx: TyCtxt<'tcx>, def_id: DefId, ty: Option<Ty<'tcx>>) -> Body<'tcx> {
 145     debug!("build_drop_shim(def_id={:?}, ty={:?})", def_id, ty);
 146
 147     assert!(!matches!(ty, Some(ty) if ty.is_generator()));
 148
 149     let substs = if let Some(ty) = ty {
 150         tcx.intern_substs(&[ty.into()])
 151     } else {
 152         InternalSubsts::identity_for_item(tcx, def_id)
 153     };
 154     let sig = tcx.bound_fn_sig(def_id).subst(tcx, substs);
 155     let sig = tcx.erase_late_bound_regions(sig);
 156     let span = tcx.def_span(def_id);
 157
 158     let source_info = SourceInfo::outermost(span);
 159
 160     let return_block = BasicBlock::new(1);
 161     let mut blocks = IndexVec::with_capacity(2);
 162     let block = |blocks: &mut IndexVec<_, _>, kind| {
 163         blocks.push(BasicBlockData {
 164             statements: vec![],
 165             terminator: Some(Terminator { source_info, kind }),
 166             is_cleanup: false,
 167         })
 168     };
 169     block(&mut blocks, TerminatorKind::Goto { target: return_block });
 170     block(&mut blocks, TerminatorKind::Return);
 171
 172     let source = MirSource::from_instance(ty::InstanceDef::DropGlue(def_id, ty));
 173     let mut body =
 174         new_body(source, blocks, local_decls_for_sig(&sig, span), sig.inputs().len(), span);
 175
 176     if ty.is_some() {
 177         // The first argument (index 0), but add 1 for the return value.
 178         let dropee_ptr = Place::from(Local::new(1 + 0));
 179         if tcx.sess.opts.debugging_opts.mir_emit_retag {
 180             // Function arguments should be retagged, and we make this one raw.
 181             body.basic_blocks_mut()[START_BLOCK].statements.insert(
 182                 0,
 183                 Statement {
 184                     source_info,
 185                     kind: StatementKind::Retag(RetagKind::Raw, Box::new(dropee_ptr)),
 186                 },
 187             );
 188         }
 189         let patch = {
 190             let param_env = tcx.param_env_reveal_all_normalized(def_id);
 191             let mut elaborator =
 192                 DropShimElaborator { body: &body, patch: MirPatch::new(&body), tcx, param_env };
 193             let dropee = tcx.mk_place_deref(dropee_ptr);
 194             let resume_block = elaborator.patch.resume_block();
 195             elaborate_drops::elaborate_drop(
 196                 &mut elaborator,
 197                 source_info,
 198                 dropee,
 199                 (),
 200                 return_block,
 201                 elaborate_drops::Unwind::To(resume_block),
 202                 START_BLOCK,
 203             );
 204             elaborator.patch
 205         };
 206         patch.apply(&mut body);
 207     }
 208
 209     body
 210 }
 211
 212 fn new_body<'tcx>(
 213     source: MirSource<'tcx>,
 214     basic_blocks: IndexVec<BasicBlock, BasicBlockData<'tcx>>,
 215     local_decls: IndexVec<Local, LocalDecl<'tcx>>,
 216     arg_count: usize,
 217     span: Span,
 218 ) -> Body<'tcx> {
 219     Body::new(
 220         source,
 221         basic_blocks,
 222         IndexVec::from_elem_n(
 223             SourceScopeData {
 224                 span,
 225                 parent_scope: None,
 226                 inlined: None,
 227                 inlined_parent_scope: None,
 228                 local_data: ClearCrossCrate::Clear,
 229             },
 230             1,
 231         ),
 232         local_decls,
 233         IndexVec::new(),
 234         arg_count,
 235         vec![],
 236         span,
 237         None,
 238         // FIXME(compiler-errors): is this correct?
 239         None,
 240     )
 241 }
 242
 243 pub struct DropShimElaborator<'a, 'tcx> {
 244     pub body: &'a Body<'tcx>,
 245     pub patch: MirPatch<'tcx>,
 246     pub tcx: TyCtxt<'tcx>,
 247     pub param_env: ty::ParamEnv<'tcx>,
 248 }
 249
 250 impl fmt::Debug for DropShimElaborator<'_, '_> {
 251     fn fmt(&self, _f: &mut fmt::Formatter<'_>) -> Result<(), fmt::Error> {
 252         Ok(())
 253     }
 254 }
 255
 256 impl<'a, 'tcx> DropElaborator<'a, 'tcx> for DropShimElaborator<'a, 'tcx> {
 257     type Path = ();
 258
 259     fn patch(&mut self) -> &mut MirPatch<'tcx> {
 260         &mut self.patch
 261     }
 262     fn body(&self) -> &'a Body<'tcx> {
 263         self.body
 264     }
 265     fn tcx(&self) -> TyCtxt<'tcx> {
 266         self.tcx
 267     }
 268     fn param_env(&self) -> ty::ParamEnv<'tcx> {
 269         self.param_env
 270     }
 271
 272     fn drop_style(&self, _path: Self::Path, mode: DropFlagMode) -> DropStyle {
 273         match mode {
 274             DropFlagMode::Shallow => {
 275                 // Drops for the contained fields are "shallow" and "static" - they will simply call
 276                 // the field's own drop glue.
 277                 DropStyle::Static
 278             }
 279             DropFlagMode::Deep => {
 280                 // The top-level drop is "deep" and "open" - it will be elaborated to a drop ladder
 281                 // dropping each field contained in the value.
 282                 DropStyle::Open
 283             }
 284         }
 285     }
 286
 287     fn get_drop_flag(&mut self, _path: Self::Path) -> Option<Operand<'tcx>> {
 288         None
 289     }
 290
 291     fn clear_drop_flag(&mut self, _location: Location, _path: Self::Path, _mode: DropFlagMode) {}
 292
 293     fn field_subpath(&self, _path: Self::Path, _field: Field) -> Option<Self::Path> {
 294         None
 295     }
 296     fn deref_subpath(&self, _path: Self::Path) -> Option<Self::Path> {
 297         None
 298     }
 299     fn downcast_subpath(&self, _path: Self::Path, _variant: VariantIdx) -> Option<Self::Path> {
 300         Some(())
 301     }
 302     fn array_subpath(&self, _path: Self::Path, _index: u64, _size: u64) -> Option<Self::Path> {
 303         None
 304     }
 305 }
 306
 307 /// Builds a `Clone::clone` shim for `self_ty`. Here, `def_id` is `Clone::clone`.
 308 fn build_clone_shim<'tcx>(tcx: TyCtxt<'tcx>, def_id: DefId, self_ty: Ty<'tcx>) -> Body<'tcx> {
 309     debug!("build_clone_shim(def_id={:?})", def_id);
 310
 311     let param_env = tcx.param_env(def_id);
 312
 313     let mut builder = CloneShimBuilder::new(tcx, def_id, self_ty);
 314     let is_copy = self_ty.is_copy_modulo_regions(tcx.at(builder.span), param_env);
 315
 316     let dest = Place::return_place();
 317     let src = tcx.mk_place_deref(Place::from(Local::new(1 + 0)));
 318
 319     match self_ty.kind() {
 320         _ if is_copy => builder.copy_shim(),
 321         ty::Closure(_, substs) => {
 322             builder.tuple_like_shim(dest, src, substs.as_closure().upvar_tys())
 323         }
 324         ty::Tuple(..) => builder.tuple_like_shim(dest, src, self_ty.tuple_fields()),
 325         _ => bug!("clone shim for `{:?}` which is not `Copy` and is not an aggregate", self_ty),
 326     };
 327
 328     builder.into_mir()
 329 }
 330
 331 struct CloneShimBuilder<'tcx> {
 332     tcx: TyCtxt<'tcx>,
 333     def_id: DefId,
 334     local_decls: IndexVec<Local, LocalDecl<'tcx>>,
 335     blocks: IndexVec<BasicBlock, BasicBlockData<'tcx>>,
 336     span: Span,
 337     sig: ty::FnSig<'tcx>,
 338 }
 339
 340 impl<'tcx> CloneShimBuilder<'tcx> {
 341     fn new(tcx: TyCtxt<'tcx>, def_id: DefId, self_ty: Ty<'tcx>) -> Self {
 342         // we must subst the self_ty because it's
 343         // otherwise going to be TySelf and we can't index
 344         // or access fields of a Place of type TySelf.
 345         let substs = tcx.mk_substs_trait(self_ty, &[]);
 346         let sig = tcx.bound_fn_sig(def_id).subst(tcx, substs);
 347         let sig = tcx.erase_late_bound_regions(sig);
 348         let span = tcx.def_span(def_id);
 349
 350         CloneShimBuilder {
 351             tcx,
 352             def_id,
 353             local_decls: local_decls_for_sig(&sig, span),
 354             blocks: IndexVec::new(),
 355             span,
 356             sig,
 357         }
 358     }
 359
 360     fn into_mir(self) -> Body<'tcx> {
 361         let source = MirSource::from_instance(ty::InstanceDef::CloneShim(
 362             self.def_id,
 363             self.sig.inputs_and_output[0],
 364         ));
 365         new_body(source, self.blocks, self.local_decls, self.sig.inputs().len(), self.span)
 366     }
 367
 368     fn source_info(&self) -> SourceInfo {
 369         SourceInfo::outermost(self.span)
 370     }
 371
 372     fn block(
 373         &mut self,
 374         statements: Vec<Statement<'tcx>>,
 375         kind: TerminatorKind<'tcx>,
 376         is_cleanup: bool,
 377     ) -> BasicBlock {
 378         let source_info = self.source_info();
 379         self.blocks.push(BasicBlockData {
 380             statements,
 381             terminator: Some(Terminator { source_info, kind }),
 382             is_cleanup,
 383         })
 384     }
 385
 386     /// Gives the index of an upcoming BasicBlock, with an offset.
 387     /// offset=0 will give you the index of the next BasicBlock,
 388     /// offset=1 will give the index of the next-to-next block,
 389     /// offset=-1 will give you the index of the last-created block
 390     fn block_index_offset(&mut self, offset: usize) -> BasicBlock {
 391         BasicBlock::new(self.blocks.len() + offset)
 392     }
 393
 394     fn make_statement(&self, kind: StatementKind<'tcx>) -> Statement<'tcx> {
 395         Statement { source_info: self.source_info(), kind }
 396     }
 397
 398     fn copy_shim(&mut self) {
 399         let rcvr = self.tcx.mk_place_deref(Place::from(Local::new(1 + 0)));
 400         let ret_statement = self.make_statement(StatementKind::Assign(Box::new((
 401             Place::return_place(),
 402             Rvalue::Use(Operand::Copy(rcvr)),
 403         ))));
 404         self.block(vec![ret_statement], TerminatorKind::Return, false);
 405     }
 406
 407     fn make_place(&mut self, mutability: Mutability, ty: Ty<'tcx>) -> Place<'tcx> {
 408         let span = self.span;
 409         let mut local = LocalDecl::new(ty, span);
 410         if mutability == Mutability::Not {
 411             local = local.immutable();
 412         }
 413         Place::from(self.local_decls.push(local))
 414     }
 415
 416     fn make_clone_call(
 417         &mut self,
 418         dest: Place<'tcx>,
 419         src: Place<'tcx>,
 420         ty: Ty<'tcx>,
 421         next: BasicBlock,
 422         cleanup: BasicBlock,
 423     ) {
 424         let tcx = self.tcx;
 425
 426         let substs = tcx.mk_substs_trait(ty, &[]);
 427
 428         // `func == Clone::clone(&ty) -> ty`
 429         let func_ty = tcx.mk_fn_def(self.def_id, substs);
 430         let func = Operand::Constant(Box::new(Constant {
 431             span: self.span,
 432             user_ty: None,
 433             literal: ConstantKind::zero_sized(func_ty),
 434         }));
 435
 436         let ref_loc = self.make_place(
 437             Mutability::Not,
 438             tcx.mk_ref(tcx.lifetimes.re_erased, ty::TypeAndMut { ty, mutbl: hir::Mutability::Not }),
 439         );
 440
 441         // `let ref_loc: &ty = &src;`
 442         let statement = self.make_statement(StatementKind::Assign(Box::new((
 443             ref_loc,
 444             Rvalue::Ref(tcx.lifetimes.re_erased, BorrowKind::Shared, src),
 445         ))));
 446
 447         // `let loc = Clone::clone(ref_loc);`
 448         self.block(
 449             vec![statement],
 450             TerminatorKind::Call {
 451                 func,
 452                 args: vec![Operand::Move(ref_loc)],
 453                 destination: dest,
 454                 target: Some(next),
 455                 cleanup: Some(cleanup),
 456                 from_hir_call: true,
 457                 fn_span: self.span,
 458             },
 459             false,
 460         );
 461     }
 462
 463     fn tuple_like_shim<I>(&mut self, dest: Place<'tcx>, src: Place<'tcx>, tys: I)
 464     where
 465         I: IntoIterator<Item = Ty<'tcx>>,
 466     {
 467         let mut previous_field = None;
 468         for (i, ity) in tys.into_iter().enumerate() {
 469             let field = Field::new(i);
 470             let src_field = self.tcx.mk_place_field(src, field, ity);
 471
 472             let dest_field = self.tcx.mk_place_field(dest, field, ity);
 473
 474             // #(2i + 1) is the cleanup block for the previous clone operation
 475             let cleanup_block = self.block_index_offset(1);
 476             // #(2i + 2) is the next cloning block
 477             // (or the Return terminator if this is the last block)
 478             let next_block = self.block_index_offset(2);
 479
 480             // BB #(2i)
 481             // `dest.i = Clone::clone(&src.i);`
 482             // Goto #(2i + 2) if ok, #(2i + 1) if unwinding happens.
 483             self.make_clone_call(dest_field, src_field, ity, next_block, cleanup_block);
 484
 485             // BB #(2i + 1) (cleanup)
 486             if let Some((previous_field, previous_cleanup)) = previous_field.take() {
 487                 // Drop previous field and goto previous cleanup block.
 488                 self.block(
 489                     vec![],
 490                     TerminatorKind::Drop {
 491                         place: previous_field,
 492                         target: previous_cleanup,
 493                         unwind: None,
 494                     },
 495                     true,
 496                 );
 497             } else {
 498                 // Nothing to drop, just resume.
 499                 self.block(vec![], TerminatorKind::Resume, true);
 500             }
 501
 502             previous_field = Some((dest_field, cleanup_block));
 503         }
 504
 505         self.block(vec![], TerminatorKind::Return, false);
 506     }
 507 }
 508
 509 /// Builds a "call" shim for `instance`. The shim calls the function specified by `call_kind`,
 510 /// first adjusting its first argument according to `rcvr_adjustment`.
 511 fn build_call_shim<'tcx>(
 512     tcx: TyCtxt<'tcx>,
 513     instance: ty::InstanceDef<'tcx>,
 514     rcvr_adjustment: Option<Adjustment>,
 515     call_kind: CallKind<'tcx>,
 516 ) -> Body<'tcx> {
 517     debug!(
 518         "build_call_shim(instance={:?}, rcvr_adjustment={:?}, call_kind={:?})",
 519         instance, rcvr_adjustment, call_kind
 520     );
 521
 522     // `FnPtrShim` contains the fn pointer type that a call shim is being built for - this is used
 523     // to substitute into the signature of the shim. It is not necessary for users of this
 524     // MIR body to perform further substitutions (see `InstanceDef::has_polymorphic_mir_body`).
 525     let (sig_substs, untuple_args) = if let ty::InstanceDef::FnPtrShim(_, ty) = instance {
 526         let sig = tcx.erase_late_bound_regions(ty.fn_sig(tcx));
 527
 528         let untuple_args = sig.inputs();
 529
 530         // Create substitutions for the `Self` and `Args` generic parameters of the shim body.
 531         let arg_tup = tcx.mk_tup(untuple_args.iter());
 532         let sig_substs = tcx.mk_substs_trait(ty, &[ty::subst::GenericArg::from(arg_tup)]);
 533
 534         (Some(sig_substs), Some(untuple_args))
 535     } else {
 536         (None, None)
 537     };
 538
 539     let def_id = instance.def_id();
 540     let sig = tcx.fn_sig(def_id);
 541     let mut sig = tcx.erase_late_bound_regions(sig);
 542
 543     assert_eq!(sig_substs.is_some(), !instance.has_polymorphic_mir_body());
 544     if let Some(sig_substs) = sig_substs {
 545         sig = EarlyBinder(sig).subst(tcx, sig_substs);
 546     }
 547
 548     if let CallKind::Indirect(fnty) = call_kind {
 549         // `sig` determines our local decls, and thus the callee type in the `Call` terminator. This
 550         // can only be an `FnDef` or `FnPtr`, but currently will be `Self` since the types come from
 551         // the implemented `FnX` trait.
 552
 553         // Apply the opposite adjustment to the MIR input.
 554         let mut inputs_and_output = sig.inputs_and_output.to_vec();
 555
 556         // Initial signature is `fn(&? Self, Args) -> Self::Output` where `Args` is a tuple of the
 557         // fn arguments. `Self` may be passed via (im)mutable reference or by-value.
 558         assert_eq!(inputs_and_output.len(), 3);
 559
 560         // `Self` is always the original fn type `ty`. The MIR call terminator is only defined for
 561         // `FnDef` and `FnPtr` callees, not the `Self` type param.
 562         let self_arg = &mut inputs_and_output[0];
 563         *self_arg = match rcvr_adjustment.unwrap() {
 564             Adjustment::Identity => fnty,
 565             Adjustment::Deref => tcx.mk_imm_ptr(fnty),
 566             Adjustment::RefMut => tcx.mk_mut_ptr(fnty),
 567         };
 568         sig.inputs_and_output = tcx.intern_type_list(&inputs_and_output);
 569     }
 570
 571     // FIXME(eddyb) avoid having this snippet both here and in
 572     // `Instance::fn_sig` (introduce `InstanceDef::fn_sig`?).
 573     if let ty::InstanceDef::VtableShim(..) = instance {
 574         // Modify fn(self, ...) to fn(self: *mut Self, ...)
 575         let mut inputs_and_output = sig.inputs_and_output.to_vec();
 576         let self_arg = &mut inputs_and_output[0];
 577         debug_assert!(tcx.generics_of(def_id).has_self && *self_arg == tcx.types.self_param);
 578         *self_arg = tcx.mk_mut_ptr(*self_arg);
 579         sig.inputs_and_output = tcx.intern_type_list(&inputs_and_output);
 580     }
 581
 582     let span = tcx.def_span(def_id);
 583
 584     debug!("build_call_shim: sig={:?}", sig);
 585
 586     let mut local_decls = local_decls_for_sig(&sig, span);
 587     let source_info = SourceInfo::outermost(span);
 588
 589     let rcvr_place = || {
 590         assert!(rcvr_adjustment.is_some());
 591         Place::from(Local::new(1 + 0))
 592     };
 593     let mut statements = vec![];
 594
 595     let rcvr = rcvr_adjustment.map(|rcvr_adjustment| match rcvr_adjustment {
 596         Adjustment::Identity => Operand::Move(rcvr_place()),
 597         Adjustment::Deref => Operand::Move(tcx.mk_place_deref(rcvr_place())),
 598         Adjustment::RefMut => {
 599             // let rcvr = &mut rcvr;
 600             let ref_rcvr = local_decls.push(
 601                 LocalDecl::new(
 602                     tcx.mk_ref(
 603                         tcx.lifetimes.re_erased,
 604                         ty::TypeAndMut { ty: sig.inputs()[0], mutbl: hir::Mutability::Mut },
 605                     ),
 606                     span,
 607                 )
 608                 .immutable(),
 609             );
 610             let borrow_kind = BorrowKind::Mut { allow_two_phase_borrow: false };
 611             statements.push(Statement {
 612                 source_info,
 613                 kind: StatementKind::Assign(Box::new((
 614                     Place::from(ref_rcvr),
 615                     Rvalue::Ref(tcx.lifetimes.re_erased, borrow_kind, rcvr_place()),
 616                 ))),
 617             });
 618             Operand::Move(Place::from(ref_rcvr))
 619         }
 620     });
 621
 622     let (callee, mut args) = match call_kind {
 623         // `FnPtr` call has no receiver. Args are untupled below.
 624         CallKind::Indirect(_) => (rcvr.unwrap(), vec![]),
 625
 626         // `FnDef` call with optional receiver.
 627         CallKind::Direct(def_id) => {
 628             let ty = tcx.type_of(def_id);
 629             (
 630                 Operand::Constant(Box::new(Constant {
 631                     span,
 632                     user_ty: None,
 633                     literal: ConstantKind::zero_sized(ty),
 634                 })),
 635                 rcvr.into_iter().collect::<Vec<_>>(),
 636             )
 637         }
 638     };
 639
 640     let mut arg_range = 0..sig.inputs().len();
 641
 642     // Take the `self` ("receiver") argument out of the range (it's adjusted above).
 643     if rcvr_adjustment.is_some() {
 644         arg_range.start += 1;
 645     }
 646
 647     // Take the last argument, if we need to untuple it (handled below).
 648     if untuple_args.is_some() {
 649         arg_range.end -= 1;
 650     }
 651
 652     // Pass all of the non-special arguments directly.
 653     args.extend(arg_range.map(|i| Operand::Move(Place::from(Local::new(1 + i)))));
 654
 655     // Untuple the last argument, if we have to.
 656     if let Some(untuple_args) = untuple_args {
 657         let tuple_arg = Local::new(1 + (sig.inputs().len() - 1));
 658         args.extend(untuple_args.iter().enumerate().map(|(i, ity)| {
 659             Operand::Move(tcx.mk_place_field(Place::from(tuple_arg), Field::new(i), *ity))
 660         }));
 661     }
 662
 663     let n_blocks = if let Some(Adjustment::RefMut) = rcvr_adjustment { 5 } else { 2 };
 664     let mut blocks = IndexVec::with_capacity(n_blocks);
 665     let block = |blocks: &mut IndexVec<_, _>, statements, kind, is_cleanup| {
 666         blocks.push(BasicBlockData {
 667             statements,
 668             terminator: Some(Terminator { source_info, kind }),
 669             is_cleanup,
 670         })
 671     };
 672
 673     // BB #0
 674     block(
 675         &mut blocks,
 676         statements,
 677         TerminatorKind::Call {
 678             func: callee,
 679             args,
 680             destination: Place::return_place(),
 681             target: Some(BasicBlock::new(1)),
 682             cleanup: if let Some(Adjustment::RefMut) = rcvr_adjustment {
 683                 Some(BasicBlock::new(3))
 684             } else {
 685                 None
 686             },
 687             from_hir_call: true,
 688             fn_span: span,
 689         },
 690         false,
 691     );
 692
 693     if let Some(Adjustment::RefMut) = rcvr_adjustment {
 694         // BB #1 - drop for Self
 695         block(
 696             &mut blocks,
 697             vec![],
 698             TerminatorKind::Drop { place: rcvr_place(), target: BasicBlock::new(2), unwind: None },
 699             false,
 700         );
 701     }
 702     // BB #1/#2 - return
 703     block(&mut blocks, vec![], TerminatorKind::Return, false);
 704     if let Some(Adjustment::RefMut) = rcvr_adjustment {
 705         // BB #3 - drop if closure panics
 706         block(
 707             &mut blocks,
 708             vec![],
 709             TerminatorKind::Drop { place: rcvr_place(), target: BasicBlock::new(4), unwind: None },
 710             true,
 711         );
 712
 713         // BB #4 - resume
 714         block(&mut blocks, vec![], TerminatorKind::Resume, true);
 715     }
 716
 717     let mut body =
 718         new_body(MirSource::from_instance(instance), blocks, local_decls, sig.inputs().len(), span);
 719
 720     if let Abi::RustCall = sig.abi {
 721         body.spread_arg = Some(Local::new(sig.inputs().len()));
 722     }
 723
 724     body
 725 }
 726
 727 pub fn build_adt_ctor(tcx: TyCtxt<'_>, ctor_id: DefId) -> Body<'_> {
 728     debug_assert!(tcx.is_constructor(ctor_id));
 729
 730     let param_env = tcx.param_env(ctor_id);
 731
 732     // Normalize the sig.
 733     let sig = tcx.fn_sig(ctor_id).no_bound_vars().expect("LBR in ADT constructor signature");
 734     let sig = tcx.normalize_erasing_regions(param_env, sig);
 735
 736     let ty::Adt(adt_def, substs) = sig.output().kind() else {
 737         bug!("unexpected type for ADT ctor {:?}", sig.output());
 738     };
 739
 740     debug!("build_ctor: ctor_id={:?} sig={:?}", ctor_id, sig);
 741
 742     let span = tcx.def_span(ctor_id);
 743
 744     let local_decls = local_decls_for_sig(&sig, span);
 745
 746     let source_info = SourceInfo::outermost(span);
 747
 748     let variant_index = if adt_def.is_enum() {
 749         adt_def.variant_index_with_ctor_id(ctor_id)
 750     } else {
 751         VariantIdx::new(0)
 752     };
 753
 754     // Generate the following MIR:
 755     //
 756     // (return as Variant).field0 = arg0;
 757     // (return as Variant).field1 = arg1;
 758     //
 759     // return;
 760     debug!("build_ctor: variant_index={:?}", variant_index);
 761
 762     let statements = expand_aggregate(
 763         Place::return_place(),
 764         adt_def.variant(variant_index).fields.iter().enumerate().map(|(idx, field_def)| {
 765             (Operand::Move(Place::from(Local::new(idx + 1))), field_def.ty(tcx, substs))
 766         }),
 767         AggregateKind::Adt(adt_def.did(), variant_index, substs, None, None),
 768         source_info,
 769         tcx,
 770     )
 771     .collect();
 772
 773     let start_block = BasicBlockData {
 774         statements,
 775         terminator: Some(Terminator { source_info, kind: TerminatorKind::Return }),
 776         is_cleanup: false,
 777     };
 778
 779     let source = MirSource::item(ctor_id);
 780     let body = new_body(
 781         source,
 782         IndexVec::from_elem_n(start_block, 1),
 783         local_decls,
 784         sig.inputs().len(),
 785         span,
 786     );
 787
 788     rustc_middle::mir::dump_mir(tcx, None, "mir_map", &0, &body, |_, _| Ok(()));
 789
 790     body
 791 }