]> git.lizzy.rs Git - rust.git/blob - src/librustc_mir/transform/inline.rs
Improve some compiletest documentation
[rust.git] / src / librustc_mir / transform / inline.rs
1 //! Inlining pass for MIR functions
2
3 use rustc::hir::CodegenFnAttrFlags;
4 use rustc::hir::def_id::DefId;
5
6 use rustc_data_structures::bit_set::BitSet;
7 use rustc_data_structures::indexed_vec::{Idx, IndexVec};
8
9 use rustc::mir::*;
10 use rustc::mir::visit::*;
11 use rustc::ty::{self, Instance, InstanceDef, ParamEnv, Ty, TyCtxt};
12 use rustc::ty::subst::{Subst, SubstsRef};
13
14 use std::collections::VecDeque;
15 use std::iter;
16 use crate::transform::{MirPass, MirSource};
17 use super::simplify::{remove_dead_blocks, CfgSimplifier};
18
19 use syntax::attr;
20 use rustc_target::spec::abi::Abi;
21
22 const DEFAULT_THRESHOLD: usize = 50;
23 const HINT_THRESHOLD: usize = 100;
24
25 const INSTR_COST: usize = 5;
26 const CALL_PENALTY: usize = 25;
27
28 const UNKNOWN_SIZE_COST: usize = 10;
29
30 pub struct Inline;
31
32 #[derive(Copy, Clone, Debug)]
33 struct CallSite<'tcx> {
34     callee: DefId,
35     substs: SubstsRef<'tcx>,
36     bb: BasicBlock,
37     location: SourceInfo,
38 }
39
40 impl MirPass for Inline {
41     fn run_pass<'a, 'tcx>(&self,
42                           tcx: TyCtxt<'a, 'tcx, 'tcx>,
43                           source: MirSource<'tcx>,
44                           mir: &mut Mir<'tcx>) {
45         if tcx.sess.opts.debugging_opts.mir_opt_level >= 2 {
46             Inliner { tcx, source }.run_pass(mir);
47         }
48     }
49 }
50
51 struct Inliner<'a, 'tcx: 'a> {
52     tcx: TyCtxt<'a, 'tcx, 'tcx>,
53     source: MirSource<'tcx>,
54 }
55
56 impl<'a, 'tcx> Inliner<'a, 'tcx> {
57     fn run_pass(&self, caller_mir: &mut Mir<'tcx>) {
58         // Keep a queue of callsites to try inlining on. We take
59         // advantage of the fact that queries detect cycles here to
60         // allow us to try and fetch the fully optimized MIR of a
61         // call; if it succeeds, we can inline it and we know that
62         // they do not call us.  Otherwise, we just don't try to
63         // inline.
64         //
65         // We use a queue so that we inline "broadly" before we inline
66         // in depth. It is unclear if this is the best heuristic,
67         // really, but that's true of all the heuristics in this
68         // file. =)
69
70         let mut callsites = VecDeque::new();
71
72         let param_env = self.tcx.param_env(self.source.def_id());
73
74         // Only do inlining into fn bodies.
75         let id = self.tcx.hir().as_local_hir_id(self.source.def_id()).unwrap();
76         if self.tcx.hir().body_owner_kind_by_hir_id(id).is_fn_or_closure()
77             && self.source.promoted.is_none()
78         {
79             for (bb, bb_data) in caller_mir.basic_blocks().iter_enumerated() {
80                 if let Some(callsite) = self.get_valid_function_call(bb,
81                                                                     bb_data,
82                                                                     caller_mir,
83                                                                     param_env) {
84                     callsites.push_back(callsite);
85                 }
86             }
87         } else {
88             return;
89         }
90
91         let mut local_change;
92         let mut changed = false;
93
94         loop {
95             local_change = false;
96             while let Some(callsite) = callsites.pop_front() {
97                 debug!("checking whether to inline callsite {:?}", callsite);
98                 if !self.tcx.is_mir_available(callsite.callee) {
99                     debug!("checking whether to inline callsite {:?} - MIR unavailable", callsite);
100                     continue;
101                 }
102
103                 let self_node_id = self.tcx.hir().as_local_node_id(self.source.def_id()).unwrap();
104                 let callee_node_id = self.tcx.hir().as_local_node_id(callsite.callee);
105
106                 let callee_mir = if let Some(callee_node_id) = callee_node_id {
107                     // Avoid a cycle here by only using `optimized_mir` only if we have
108                     // a lower node id than the callee. This ensures that the callee will
109                     // not inline us. This trick only works without incremental compilation.
110                     // So don't do it if that is enabled.
111                     if !self.tcx.dep_graph.is_fully_enabled()
112                         && self_node_id.as_u32() < callee_node_id.as_u32() {
113                         self.tcx.optimized_mir(callsite.callee)
114                     } else {
115                         continue;
116                     }
117                 } else {
118                     // This cannot result in a cycle since the callee MIR is from another crate
119                     // and is already optimized.
120                     self.tcx.optimized_mir(callsite.callee)
121                 };
122
123                 let callee_mir = if self.consider_optimizing(callsite, callee_mir) {
124                     self.tcx.subst_and_normalize_erasing_regions(
125                         &callsite.substs,
126                         param_env,
127                         callee_mir,
128                     )
129                 } else {
130                     continue;
131                 };
132
133                 let start = caller_mir.basic_blocks().len();
134                 debug!("attempting to inline callsite {:?} - mir={:?}", callsite, callee_mir);
135                 if !self.inline_call(callsite, caller_mir, callee_mir) {
136                     debug!("attempting to inline callsite {:?} - failure", callsite);
137                     continue;
138                 }
139                 debug!("attempting to inline callsite {:?} - success", callsite);
140
141                 // Add callsites from inlined function
142                 for (bb, bb_data) in caller_mir.basic_blocks().iter_enumerated().skip(start) {
143                     if let Some(new_callsite) = self.get_valid_function_call(bb,
144                                                                              bb_data,
145                                                                              caller_mir,
146                                                                              param_env) {
147                         // Don't inline the same function multiple times.
148                         if callsite.callee != new_callsite.callee {
149                             callsites.push_back(new_callsite);
150                         }
151                     }
152                 }
153
154                 local_change = true;
155                 changed = true;
156             }
157
158             if !local_change {
159                 break;
160             }
161         }
162
163         // Simplify if we inlined anything.
164         if changed {
165             debug!("Running simplify cfg on {:?}", self.source);
166             CfgSimplifier::new(caller_mir).simplify();
167             remove_dead_blocks(caller_mir);
168         }
169     }
170
171     fn get_valid_function_call(&self,
172                                bb: BasicBlock,
173                                bb_data: &BasicBlockData<'tcx>,
174                                caller_mir: &Mir<'tcx>,
175                                param_env: ParamEnv<'tcx>,
176     ) -> Option<CallSite<'tcx>> {
177         // Don't inline calls that are in cleanup blocks.
178         if bb_data.is_cleanup { return None; }
179
180         // Only consider direct calls to functions
181         let terminator = bb_data.terminator();
182         if let TerminatorKind::Call { func: ref op, .. } = terminator.kind {
183             if let ty::FnDef(callee_def_id, substs) = op.ty(caller_mir, self.tcx).sty {
184                 let instance = Instance::resolve(self.tcx,
185                                                  param_env,
186                                                  callee_def_id,
187                                                  substs)?;
188
189                 if let InstanceDef::Virtual(..) = instance.def {
190                     return None;
191                 }
192
193                 return Some(CallSite {
194                     callee: instance.def_id(),
195                     substs: instance.substs,
196                     bb,
197                     location: terminator.source_info
198                 });
199             }
200         }
201
202         None
203     }
204
205     fn consider_optimizing(&self,
206                            callsite: CallSite<'tcx>,
207                            callee_mir: &Mir<'tcx>)
208                            -> bool
209     {
210         debug!("consider_optimizing({:?})", callsite);
211         self.should_inline(callsite, callee_mir)
212             && self.tcx.consider_optimizing(|| format!("Inline {:?} into {:?}",
213                                                        callee_mir.span,
214                                                        callsite))
215     }
216
217     fn should_inline(&self,
218                      callsite: CallSite<'tcx>,
219                      callee_mir: &Mir<'tcx>)
220                      -> bool
221     {
222         debug!("should_inline({:?})", callsite);
223         let tcx = self.tcx;
224
225         // Don't inline closures that have captures
226         // FIXME: Handle closures better
227         if callee_mir.upvar_decls.len() > 0 {
228             debug!("    upvar decls present - not inlining");
229             return false;
230         }
231
232         // Cannot inline generators which haven't been transformed yet
233         if callee_mir.yield_ty.is_some() {
234             debug!("    yield ty present - not inlining");
235             return false;
236         }
237
238         // Do not inline {u,i}128 lang items, codegen const eval depends
239         // on detecting calls to these lang items and intercepting them
240         if tcx.is_binop_lang_item(callsite.callee).is_some() {
241             debug!("    not inlining 128bit integer lang item");
242             return false;
243         }
244
245         let codegen_fn_attrs = tcx.codegen_fn_attrs(callsite.callee);
246
247         let hinted = match codegen_fn_attrs.inline {
248             // Just treat inline(always) as a hint for now,
249             // there are cases that prevent inlining that we
250             // need to check for first.
251             attr::InlineAttr::Always => true,
252             attr::InlineAttr::Never => {
253                 debug!("#[inline(never)] present - not inlining");
254                 return false
255             }
256             attr::InlineAttr::Hint => true,
257             attr::InlineAttr::None => false,
258         };
259
260         // Only inline local functions if they would be eligible for cross-crate
261         // inlining. This is to ensure that the final crate doesn't have MIR that
262         // reference unexported symbols
263         if callsite.callee.is_local() {
264             if callsite.substs.non_erasable_generics().count() == 0 && !hinted {
265                 debug!("    callee is an exported function - not inlining");
266                 return false;
267             }
268         }
269
270         let mut threshold = if hinted {
271             HINT_THRESHOLD
272         } else {
273             DEFAULT_THRESHOLD
274         };
275
276         // Significantly lower the threshold for inlining cold functions
277         if codegen_fn_attrs.flags.contains(CodegenFnAttrFlags::COLD) {
278             threshold /= 5;
279         }
280
281         // Give a bonus functions with a small number of blocks,
282         // We normally have two or three blocks for even
283         // very small functions.
284         if callee_mir.basic_blocks().len() <= 3 {
285             threshold += threshold / 4;
286         }
287         debug!("    final inline threshold = {}", threshold);
288
289         // FIXME: Give a bonus to functions with only a single caller
290
291         let param_env = tcx.param_env(self.source.def_id());
292
293         let mut first_block = true;
294         let mut cost = 0;
295
296         // Traverse the MIR manually so we can account for the effects of
297         // inlining on the CFG.
298         let mut work_list = vec![START_BLOCK];
299         let mut visited = BitSet::new_empty(callee_mir.basic_blocks().len());
300         while let Some(bb) = work_list.pop() {
301             if !visited.insert(bb.index()) { continue; }
302             let blk = &callee_mir.basic_blocks()[bb];
303
304             for stmt in &blk.statements {
305                 // Don't count StorageLive/StorageDead in the inlining cost.
306                 match stmt.kind {
307                     StatementKind::StorageLive(_) |
308                     StatementKind::StorageDead(_) |
309                     StatementKind::Nop => {}
310                     _ => cost += INSTR_COST
311                 }
312             }
313             let term = blk.terminator();
314             let mut is_drop = false;
315             match term.kind {
316                 TerminatorKind::Drop { ref location, target, unwind } |
317                 TerminatorKind::DropAndReplace { ref location, target, unwind, .. } => {
318                     is_drop = true;
319                     work_list.push(target);
320                     // If the location doesn't actually need dropping, treat it like
321                     // a regular goto.
322                     let ty = location.ty(callee_mir, tcx).subst(tcx, callsite.substs);
323                     let ty = ty.to_ty(tcx);
324                     if ty.needs_drop(tcx, param_env) {
325                         cost += CALL_PENALTY;
326                         if let Some(unwind) = unwind {
327                             work_list.push(unwind);
328                         }
329                     } else {
330                         cost += INSTR_COST;
331                     }
332                 }
333
334                 TerminatorKind::Unreachable |
335                 TerminatorKind::Call { destination: None, .. } if first_block => {
336                     // If the function always diverges, don't inline
337                     // unless the cost is zero
338                     threshold = 0;
339                 }
340
341                 TerminatorKind::Call {func: Operand::Constant(ref f), .. } => {
342                     if let ty::FnDef(def_id, _) = f.ty.sty {
343                         // Don't give intrinsics the extra penalty for calls
344                         let f = tcx.fn_sig(def_id);
345                         if f.abi() == Abi::RustIntrinsic || f.abi() == Abi::PlatformIntrinsic {
346                             cost += INSTR_COST;
347                         } else {
348                             cost += CALL_PENALTY;
349                         }
350                     }
351                 }
352                 TerminatorKind::Assert { .. } => cost += CALL_PENALTY,
353                 _ => cost += INSTR_COST
354             }
355
356             if !is_drop {
357                 for &succ in term.successors() {
358                     work_list.push(succ);
359                 }
360             }
361
362             first_block = false;
363         }
364
365         // Count up the cost of local variables and temps, if we know the size
366         // use that, otherwise we use a moderately-large dummy cost.
367
368         let ptr_size = tcx.data_layout.pointer_size.bytes();
369
370         for v in callee_mir.vars_and_temps_iter() {
371             let v = &callee_mir.local_decls[v];
372             let ty = v.ty.subst(tcx, callsite.substs);
373             // Cost of the var is the size in machine-words, if we know
374             // it.
375             if let Some(size) = type_size_of(tcx, param_env.clone(), ty) {
376                 cost += (size / ptr_size) as usize;
377             } else {
378                 cost += UNKNOWN_SIZE_COST;
379             }
380         }
381
382         if let attr::InlineAttr::Always = codegen_fn_attrs.inline {
383             debug!("INLINING {:?} because inline(always) [cost={}]", callsite, cost);
384             true
385         } else {
386             if cost <= threshold {
387                 debug!("INLINING {:?} [cost={} <= threshold={}]", callsite, cost, threshold);
388                 true
389             } else {
390                 debug!("NOT inlining {:?} [cost={} > threshold={}]", callsite, cost, threshold);
391                 false
392             }
393         }
394     }
395
396     fn inline_call(&self,
397                    callsite: CallSite<'tcx>,
398                    caller_mir: &mut Mir<'tcx>,
399                    mut callee_mir: Mir<'tcx>) -> bool {
400         let terminator = caller_mir[callsite.bb].terminator.take().unwrap();
401         match terminator.kind {
402             // FIXME: Handle inlining of diverging calls
403             TerminatorKind::Call { args, destination: Some(destination), cleanup, .. } => {
404                 debug!("Inlined {:?} into {:?}", callsite.callee, self.source);
405
406                 let mut local_map = IndexVec::with_capacity(callee_mir.local_decls.len());
407                 let mut scope_map = IndexVec::with_capacity(callee_mir.source_scopes.len());
408                 let mut promoted_map = IndexVec::with_capacity(callee_mir.promoted.len());
409
410                 for mut scope in callee_mir.source_scopes.iter().cloned() {
411                     if scope.parent_scope.is_none() {
412                         scope.parent_scope = Some(callsite.location.scope);
413                         scope.span = callee_mir.span;
414                     }
415
416                     scope.span = callsite.location.span;
417
418                     let idx = caller_mir.source_scopes.push(scope);
419                     scope_map.push(idx);
420                 }
421
422                 for loc in callee_mir.vars_and_temps_iter() {
423                     let mut local = callee_mir.local_decls[loc].clone();
424
425                     local.source_info.scope =
426                         scope_map[local.source_info.scope];
427                     local.source_info.span = callsite.location.span;
428                     local.visibility_scope = scope_map[local.visibility_scope];
429
430                     let idx = caller_mir.local_decls.push(local);
431                     local_map.push(idx);
432                 }
433
434                 promoted_map.extend(
435                     callee_mir.promoted.iter().cloned().map(|p| caller_mir.promoted.push(p))
436                 );
437
438                 // If the call is something like `a[*i] = f(i)`, where
439                 // `i : &mut usize`, then just duplicating the `a[*i]`
440                 // Place could result in two different locations if `f`
441                 // writes to `i`. To prevent this we need to create a temporary
442                 // borrow of the place and pass the destination as `*temp` instead.
443                 fn dest_needs_borrow(place: &Place<'_>) -> bool {
444                     match *place {
445                         Place::Projection(ref p) => {
446                             match p.elem {
447                                 ProjectionElem::Deref |
448                                 ProjectionElem::Index(_) => true,
449                                 _ => dest_needs_borrow(&p.base)
450                             }
451                         }
452                         // Static variables need a borrow because the callee
453                         // might modify the same static.
454                         Place::Base(PlaceBase::Static(_)) => true,
455                         _ => false
456                     }
457                 }
458
459                 let dest = if dest_needs_borrow(&destination.0) {
460                     debug!("Creating temp for return destination");
461                     let dest = Rvalue::Ref(
462                         self.tcx.types.re_erased,
463                         BorrowKind::Mut { allow_two_phase_borrow: false },
464                         destination.0);
465
466                     let ty = dest.ty(caller_mir, self.tcx);
467
468                     let temp = LocalDecl::new_temp(ty, callsite.location.span);
469
470                     let tmp = caller_mir.local_decls.push(temp);
471                     let tmp = Place::Base(PlaceBase::Local(tmp));
472
473                     let stmt = Statement {
474                         source_info: callsite.location,
475                         kind: StatementKind::Assign(tmp.clone(), box dest)
476                     };
477                     caller_mir[callsite.bb]
478                         .statements.push(stmt);
479                     tmp.deref()
480                 } else {
481                     destination.0
482                 };
483
484                 let return_block = destination.1;
485
486                 // Copy the arguments if needed.
487                 let args: Vec<_> = self.make_call_args(args, &callsite, caller_mir);
488
489                 let bb_len = caller_mir.basic_blocks().len();
490                 let mut integrator = Integrator {
491                     block_idx: bb_len,
492                     args: &args,
493                     local_map,
494                     scope_map,
495                     promoted_map,
496                     _callsite: callsite,
497                     destination: dest,
498                     return_block,
499                     cleanup_block: cleanup,
500                     in_cleanup_block: false
501                 };
502
503
504                 for (bb, mut block) in callee_mir.basic_blocks_mut().drain_enumerated(..) {
505                     integrator.visit_basic_block_data(bb, &mut block);
506                     caller_mir.basic_blocks_mut().push(block);
507                 }
508
509                 let terminator = Terminator {
510                     source_info: callsite.location,
511                     kind: TerminatorKind::Goto { target: BasicBlock::new(bb_len) }
512                 };
513
514                 caller_mir[callsite.bb].terminator = Some(terminator);
515
516                 true
517             }
518             kind => {
519                 caller_mir[callsite.bb].terminator = Some(Terminator {
520                     source_info: terminator.source_info,
521                     kind,
522                 });
523                 false
524             }
525         }
526     }
527
528     fn make_call_args(
529         &self,
530         args: Vec<Operand<'tcx>>,
531         callsite: &CallSite<'tcx>,
532         caller_mir: &mut Mir<'tcx>,
533     ) -> Vec<Local> {
534         let tcx = self.tcx;
535
536         // There is a bit of a mismatch between the *caller* of a closure and the *callee*.
537         // The caller provides the arguments wrapped up in a tuple:
538         //
539         //     tuple_tmp = (a, b, c)
540         //     Fn::call(closure_ref, tuple_tmp)
541         //
542         // meanwhile the closure body expects the arguments (here, `a`, `b`, and `c`)
543         // as distinct arguments. (This is the "rust-call" ABI hack.) Normally, codegen has
544         // the job of unpacking this tuple. But here, we are codegen. =) So we want to create
545         // a vector like
546         //
547         //     [closure_ref, tuple_tmp.0, tuple_tmp.1, tuple_tmp.2]
548         //
549         // Except for one tiny wrinkle: we don't actually want `tuple_tmp.0`. It's more convenient
550         // if we "spill" that into *another* temporary, so that we can map the argument
551         // variable in the callee MIR directly to an argument variable on our side.
552         // So we introduce temporaries like:
553         //
554         //     tmp0 = tuple_tmp.0
555         //     tmp1 = tuple_tmp.1
556         //     tmp2 = tuple_tmp.2
557         //
558         // and the vector is `[closure_ref, tmp0, tmp1, tmp2]`.
559         if tcx.is_closure(callsite.callee) {
560             let mut args = args.into_iter();
561             let self_ = self.create_temp_if_necessary(args.next().unwrap(), callsite, caller_mir);
562             let tuple = self.create_temp_if_necessary(args.next().unwrap(), callsite, caller_mir);
563             assert!(args.next().is_none());
564
565             let tuple = Place::Base(PlaceBase::Local(tuple));
566             let tuple_tys = if let ty::Tuple(s) = tuple.ty(caller_mir, tcx).to_ty(tcx).sty {
567                 s
568             } else {
569                 bug!("Closure arguments are not passed as a tuple");
570             };
571
572             // The `closure_ref` in our example above.
573             let closure_ref_arg = iter::once(self_);
574
575             // The `tmp0`, `tmp1`, and `tmp2` in our example abonve.
576             let tuple_tmp_args =
577                 tuple_tys.iter().enumerate().map(|(i, ty)| {
578                     // This is e.g., `tuple_tmp.0` in our example above.
579                     let tuple_field = Operand::Move(tuple.clone().field(Field::new(i), ty));
580
581                     // Spill to a local to make e.g., `tmp0`.
582                     self.create_temp_if_necessary(tuple_field, callsite, caller_mir)
583                 });
584
585             closure_ref_arg.chain(tuple_tmp_args).collect()
586         } else {
587             args.into_iter()
588                 .map(|a| self.create_temp_if_necessary(a, callsite, caller_mir))
589                 .collect()
590         }
591     }
592
593     /// If `arg` is already a temporary, returns it. Otherwise, introduces a fresh
594     /// temporary `T` and an instruction `T = arg`, and returns `T`.
595     fn create_temp_if_necessary(
596         &self,
597         arg: Operand<'tcx>,
598         callsite: &CallSite<'tcx>,
599         caller_mir: &mut Mir<'tcx>,
600     ) -> Local {
601         // FIXME: Analysis of the usage of the arguments to avoid
602         // unnecessary temporaries.
603
604         if let Operand::Move(Place::Base(PlaceBase::Local(local))) = arg {
605             if caller_mir.local_kind(local) == LocalKind::Temp {
606                 // Reuse the operand if it's a temporary already
607                 return local;
608             }
609         }
610
611         debug!("Creating temp for argument {:?}", arg);
612         // Otherwise, create a temporary for the arg
613         let arg = Rvalue::Use(arg);
614
615         let ty = arg.ty(caller_mir, self.tcx);
616
617         let arg_tmp = LocalDecl::new_temp(ty, callsite.location.span);
618         let arg_tmp = caller_mir.local_decls.push(arg_tmp);
619
620         let stmt = Statement {
621             source_info: callsite.location,
622             kind: StatementKind::Assign(Place::Base(PlaceBase::Local(arg_tmp)), box arg),
623         };
624         caller_mir[callsite.bb].statements.push(stmt);
625         arg_tmp
626     }
627 }
628
629 fn type_size_of<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
630                           param_env: ty::ParamEnv<'tcx>,
631                           ty: Ty<'tcx>) -> Option<u64> {
632     tcx.layout_of(param_env.and(ty)).ok().map(|layout| layout.size.bytes())
633 }
634
635 /**
636  * Integrator.
637  *
638  * Integrates blocks from the callee function into the calling function.
639  * Updates block indices, references to locals and other control flow
640  * stuff.
641  */
642 struct Integrator<'a, 'tcx: 'a> {
643     block_idx: usize,
644     args: &'a [Local],
645     local_map: IndexVec<Local, Local>,
646     scope_map: IndexVec<SourceScope, SourceScope>,
647     promoted_map: IndexVec<Promoted, Promoted>,
648     _callsite: CallSite<'tcx>,
649     destination: Place<'tcx>,
650     return_block: BasicBlock,
651     cleanup_block: Option<BasicBlock>,
652     in_cleanup_block: bool,
653 }
654
655 impl<'a, 'tcx> Integrator<'a, 'tcx> {
656     fn update_target(&self, tgt: BasicBlock) -> BasicBlock {
657         let new = BasicBlock::new(tgt.index() + self.block_idx);
658         debug!("Updating target `{:?}`, new: `{:?}`", tgt, new);
659         new
660     }
661 }
662
663 impl<'a, 'tcx> MutVisitor<'tcx> for Integrator<'a, 'tcx> {
664     fn visit_local(&mut self,
665                    local: &mut Local,
666                    _ctxt: PlaceContext<'tcx>,
667                    _location: Location) {
668         if *local == RETURN_PLACE {
669             match self.destination {
670                 Place::Base(PlaceBase::Local(l)) => {
671                     *local = l;
672                     return;
673                 },
674                 ref place => bug!("Return place is {:?}, not local", place)
675             }
676         }
677         let idx = local.index() - 1;
678         if idx < self.args.len() {
679             *local = self.args[idx];
680             return;
681         }
682         *local = self.local_map[Local::new(idx - self.args.len())];
683     }
684
685     fn visit_place(&mut self,
686                     place: &mut Place<'tcx>,
687                     _ctxt: PlaceContext<'tcx>,
688                     _location: Location) {
689
690         match place {
691             Place::Base(PlaceBase::Local(RETURN_PLACE)) => {
692                 // Return pointer; update the place itself
693                 *place = self.destination.clone();
694             },
695             Place::Base(PlaceBase::Promoted(ref mut promoted)) => {
696                 if let Some(p) = self.promoted_map.get(promoted.0).cloned() {
697                     promoted.0 = p;
698                 }
699             },
700             _ => self.super_place(place, _ctxt, _location),
701         }
702     }
703
704     fn visit_basic_block_data(&mut self, block: BasicBlock, data: &mut BasicBlockData<'tcx>) {
705         self.in_cleanup_block = data.is_cleanup;
706         self.super_basic_block_data(block, data);
707         self.in_cleanup_block = false;
708     }
709
710     fn visit_retag(
711         &mut self,
712         kind: &mut RetagKind,
713         place: &mut Place<'tcx>,
714         loc: Location,
715     ) {
716         self.super_retag(kind, place, loc);
717
718         // We have to patch all inlined retags to be aware that they are no longer
719         // happening on function entry.
720         if *kind == RetagKind::FnEntry {
721             *kind = RetagKind::Default;
722         }
723     }
724
725     fn visit_terminator_kind(&mut self, block: BasicBlock,
726                              kind: &mut TerminatorKind<'tcx>, loc: Location) {
727         self.super_terminator_kind(block, kind, loc);
728
729         match *kind {
730             TerminatorKind::GeneratorDrop |
731             TerminatorKind::Yield { .. } => bug!(),
732             TerminatorKind::Goto { ref mut target} => {
733                 *target = self.update_target(*target);
734             }
735             TerminatorKind::SwitchInt { ref mut targets, .. } => {
736                 for tgt in targets {
737                     *tgt = self.update_target(*tgt);
738                 }
739             }
740             TerminatorKind::Drop { ref mut target, ref mut unwind, .. } |
741             TerminatorKind::DropAndReplace { ref mut target, ref mut unwind, .. } => {
742                 *target = self.update_target(*target);
743                 if let Some(tgt) = *unwind {
744                     *unwind = Some(self.update_target(tgt));
745                 } else if !self.in_cleanup_block {
746                     // Unless this drop is in a cleanup block, add an unwind edge to
747                     // the original call's cleanup block
748                     *unwind = self.cleanup_block;
749                 }
750             }
751             TerminatorKind::Call { ref mut destination, ref mut cleanup, .. } => {
752                 if let Some((_, ref mut tgt)) = *destination {
753                     *tgt = self.update_target(*tgt);
754                 }
755                 if let Some(tgt) = *cleanup {
756                     *cleanup = Some(self.update_target(tgt));
757                 } else if !self.in_cleanup_block {
758                     // Unless this call is in a cleanup block, add an unwind edge to
759                     // the original call's cleanup block
760                     *cleanup = self.cleanup_block;
761                 }
762             }
763             TerminatorKind::Assert { ref mut target, ref mut cleanup, .. } => {
764                 *target = self.update_target(*target);
765                 if let Some(tgt) = *cleanup {
766                     *cleanup = Some(self.update_target(tgt));
767                 } else if !self.in_cleanup_block {
768                     // Unless this assert is in a cleanup block, add an unwind edge to
769                     // the original call's cleanup block
770                     *cleanup = self.cleanup_block;
771                 }
772             }
773             TerminatorKind::Return => {
774                 *kind = TerminatorKind::Goto { target: self.return_block };
775             }
776             TerminatorKind::Resume => {
777                 if let Some(tgt) = self.cleanup_block {
778                     *kind = TerminatorKind::Goto { target: tgt }
779                 }
780             }
781             TerminatorKind::Abort => { }
782             TerminatorKind::Unreachable => { }
783             TerminatorKind::FalseEdges { ref mut real_target, ref mut imaginary_targets } => {
784                 *real_target = self.update_target(*real_target);
785                 for target in imaginary_targets {
786                     *target = self.update_target(*target);
787                 }
788             }
789             TerminatorKind::FalseUnwind { real_target: _ , unwind: _ } =>
790                 // see the ordering of passes in the optimized_mir query.
791                 bug!("False unwinds should have been removed before inlining")
792         }
793     }
794
795     fn visit_source_scope(&mut self, scope: &mut SourceScope) {
796         *scope = self.scope_map[*scope];
797     }
798 }