MachineModuleInfo.cpp revision 251662
1//===-- llvm/CodeGen/MachineModuleInfo.cpp ----------------------*- C++ -*-===//
2//
3//                     The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9
10#include "llvm/CodeGen/MachineModuleInfo.h"
11#include "llvm/ADT/PointerUnion.h"
12#include "llvm/Analysis/ValueTracking.h"
13#include "llvm/CodeGen/MachineFunction.h"
14#include "llvm/CodeGen/MachineFunctionPass.h"
15#include "llvm/CodeGen/Passes.h"
16#include "llvm/IR/Constants.h"
17#include "llvm/IR/DerivedTypes.h"
18#include "llvm/IR/GlobalVariable.h"
19#include "llvm/IR/Module.h"
20#include "llvm/MC/MCObjectFileInfo.h"
21#include "llvm/MC/MCSymbol.h"
22#include "llvm/Support/Dwarf.h"
23#include "llvm/Support/ErrorHandling.h"
24using namespace llvm;
25using namespace llvm::dwarf;
26
27// Handle the Pass registration stuff necessary to use DataLayout's.
28INITIALIZE_PASS(MachineModuleInfo, "machinemoduleinfo",
29                "Machine Module Information", false, false)
30char MachineModuleInfo::ID = 0;
31
32// Out of line virtual method.
33MachineModuleInfoImpl::~MachineModuleInfoImpl() {}
34
35namespace llvm {
36class MMIAddrLabelMapCallbackPtr : CallbackVH {
37  MMIAddrLabelMap *Map;
38public:
39  MMIAddrLabelMapCallbackPtr() : Map(0) {}
40  MMIAddrLabelMapCallbackPtr(Value *V) : CallbackVH(V), Map(0) {}
41
42  void setPtr(BasicBlock *BB) {
43    ValueHandleBase::operator=(BB);
44  }
45
46  void setMap(MMIAddrLabelMap *map) { Map = map; }
47
48  virtual void deleted();
49  virtual void allUsesReplacedWith(Value *V2);
50};
51
52class MMIAddrLabelMap {
53  MCContext &Context;
54  struct AddrLabelSymEntry {
55    /// Symbols - The symbols for the label.  This is a pointer union that is
56    /// either one symbol (the common case) or a list of symbols.
57    PointerUnion<MCSymbol *, std::vector<MCSymbol*>*> Symbols;
58
59    Function *Fn;   // The containing function of the BasicBlock.
60    unsigned Index; // The index in BBCallbacks for the BasicBlock.
61  };
62
63  DenseMap<AssertingVH<BasicBlock>, AddrLabelSymEntry> AddrLabelSymbols;
64
65  /// BBCallbacks - Callbacks for the BasicBlock's that we have entries for.  We
66  /// use this so we get notified if a block is deleted or RAUWd.
67  std::vector<MMIAddrLabelMapCallbackPtr> BBCallbacks;
68
69  /// DeletedAddrLabelsNeedingEmission - This is a per-function list of symbols
70  /// whose corresponding BasicBlock got deleted.  These symbols need to be
71  /// emitted at some point in the file, so AsmPrinter emits them after the
72  /// function body.
73  DenseMap<AssertingVH<Function>, std::vector<MCSymbol*> >
74    DeletedAddrLabelsNeedingEmission;
75public:
76
77  MMIAddrLabelMap(MCContext &context) : Context(context) {}
78  ~MMIAddrLabelMap() {
79    assert(DeletedAddrLabelsNeedingEmission.empty() &&
80           "Some labels for deleted blocks never got emitted");
81
82    // Deallocate any of the 'list of symbols' case.
83    for (DenseMap<AssertingVH<BasicBlock>, AddrLabelSymEntry>::iterator
84         I = AddrLabelSymbols.begin(), E = AddrLabelSymbols.end(); I != E; ++I)
85      if (I->second.Symbols.is<std::vector<MCSymbol*>*>())
86        delete I->second.Symbols.get<std::vector<MCSymbol*>*>();
87  }
88
89  MCSymbol *getAddrLabelSymbol(BasicBlock *BB);
90  std::vector<MCSymbol*> getAddrLabelSymbolToEmit(BasicBlock *BB);
91
92  void takeDeletedSymbolsForFunction(Function *F,
93                                     std::vector<MCSymbol*> &Result);
94
95  void UpdateForDeletedBlock(BasicBlock *BB);
96  void UpdateForRAUWBlock(BasicBlock *Old, BasicBlock *New);
97};
98}
99
100MCSymbol *MMIAddrLabelMap::getAddrLabelSymbol(BasicBlock *BB) {
101  assert(BB->hasAddressTaken() &&
102         "Shouldn't get label for block without address taken");
103  AddrLabelSymEntry &Entry = AddrLabelSymbols[BB];
104
105  // If we already had an entry for this block, just return it.
106  if (!Entry.Symbols.isNull()) {
107    assert(BB->getParent() == Entry.Fn && "Parent changed");
108    if (Entry.Symbols.is<MCSymbol*>())
109      return Entry.Symbols.get<MCSymbol*>();
110    return (*Entry.Symbols.get<std::vector<MCSymbol*>*>())[0];
111  }
112
113  // Otherwise, this is a new entry, create a new symbol for it and add an
114  // entry to BBCallbacks so we can be notified if the BB is deleted or RAUWd.
115  BBCallbacks.push_back(BB);
116  BBCallbacks.back().setMap(this);
117  Entry.Index = BBCallbacks.size()-1;
118  Entry.Fn = BB->getParent();
119  MCSymbol *Result = Context.CreateTempSymbol();
120  Entry.Symbols = Result;
121  return Result;
122}
123
124std::vector<MCSymbol*>
125MMIAddrLabelMap::getAddrLabelSymbolToEmit(BasicBlock *BB) {
126  assert(BB->hasAddressTaken() &&
127         "Shouldn't get label for block without address taken");
128  AddrLabelSymEntry &Entry = AddrLabelSymbols[BB];
129
130  std::vector<MCSymbol*> Result;
131
132  // If we already had an entry for this block, just return it.
133  if (Entry.Symbols.isNull())
134    Result.push_back(getAddrLabelSymbol(BB));
135  else if (MCSymbol *Sym = Entry.Symbols.dyn_cast<MCSymbol*>())
136    Result.push_back(Sym);
137  else
138    Result = *Entry.Symbols.get<std::vector<MCSymbol*>*>();
139  return Result;
140}
141
142
143/// takeDeletedSymbolsForFunction - If we have any deleted symbols for F, return
144/// them.
145void MMIAddrLabelMap::
146takeDeletedSymbolsForFunction(Function *F, std::vector<MCSymbol*> &Result) {
147  DenseMap<AssertingVH<Function>, std::vector<MCSymbol*> >::iterator I =
148    DeletedAddrLabelsNeedingEmission.find(F);
149
150  // If there are no entries for the function, just return.
151  if (I == DeletedAddrLabelsNeedingEmission.end()) return;
152
153  // Otherwise, take the list.
154  std::swap(Result, I->second);
155  DeletedAddrLabelsNeedingEmission.erase(I);
156}
157
158
159void MMIAddrLabelMap::UpdateForDeletedBlock(BasicBlock *BB) {
160  // If the block got deleted, there is no need for the symbol.  If the symbol
161  // was already emitted, we can just forget about it, otherwise we need to
162  // queue it up for later emission when the function is output.
163  AddrLabelSymEntry Entry = AddrLabelSymbols[BB];
164  AddrLabelSymbols.erase(BB);
165  assert(!Entry.Symbols.isNull() && "Didn't have a symbol, why a callback?");
166  BBCallbacks[Entry.Index] = 0;  // Clear the callback.
167
168  assert((BB->getParent() == 0 || BB->getParent() == Entry.Fn) &&
169         "Block/parent mismatch");
170
171  // Handle both the single and the multiple symbols cases.
172  if (MCSymbol *Sym = Entry.Symbols.dyn_cast<MCSymbol*>()) {
173    if (Sym->isDefined())
174      return;
175
176    // If the block is not yet defined, we need to emit it at the end of the
177    // function.  Add the symbol to the DeletedAddrLabelsNeedingEmission list
178    // for the containing Function.  Since the block is being deleted, its
179    // parent may already be removed, we have to get the function from 'Entry'.
180    DeletedAddrLabelsNeedingEmission[Entry.Fn].push_back(Sym);
181  } else {
182    std::vector<MCSymbol*> *Syms = Entry.Symbols.get<std::vector<MCSymbol*>*>();
183
184    for (unsigned i = 0, e = Syms->size(); i != e; ++i) {
185      MCSymbol *Sym = (*Syms)[i];
186      if (Sym->isDefined()) continue;  // Ignore already emitted labels.
187
188      // If the block is not yet defined, we need to emit it at the end of the
189      // function.  Add the symbol to the DeletedAddrLabelsNeedingEmission list
190      // for the containing Function.  Since the block is being deleted, its
191      // parent may already be removed, we have to get the function from
192      // 'Entry'.
193      DeletedAddrLabelsNeedingEmission[Entry.Fn].push_back(Sym);
194    }
195
196    // The entry is deleted, free the memory associated with the symbol list.
197    delete Syms;
198  }
199}
200
201void MMIAddrLabelMap::UpdateForRAUWBlock(BasicBlock *Old, BasicBlock *New) {
202  // Get the entry for the RAUW'd block and remove it from our map.
203  AddrLabelSymEntry OldEntry = AddrLabelSymbols[Old];
204  AddrLabelSymbols.erase(Old);
205  assert(!OldEntry.Symbols.isNull() && "Didn't have a symbol, why a callback?");
206
207  AddrLabelSymEntry &NewEntry = AddrLabelSymbols[New];
208
209  // If New is not address taken, just move our symbol over to it.
210  if (NewEntry.Symbols.isNull()) {
211    BBCallbacks[OldEntry.Index].setPtr(New);    // Update the callback.
212    NewEntry = OldEntry;     // Set New's entry.
213    return;
214  }
215
216  BBCallbacks[OldEntry.Index] = 0;    // Update the callback.
217
218  // Otherwise, we need to add the old symbol to the new block's set.  If it is
219  // just a single entry, upgrade it to a symbol list.
220  if (MCSymbol *PrevSym = NewEntry.Symbols.dyn_cast<MCSymbol*>()) {
221    std::vector<MCSymbol*> *SymList = new std::vector<MCSymbol*>();
222    SymList->push_back(PrevSym);
223    NewEntry.Symbols = SymList;
224  }
225
226  std::vector<MCSymbol*> *SymList =
227    NewEntry.Symbols.get<std::vector<MCSymbol*>*>();
228
229  // If the old entry was a single symbol, add it.
230  if (MCSymbol *Sym = OldEntry.Symbols.dyn_cast<MCSymbol*>()) {
231    SymList->push_back(Sym);
232    return;
233  }
234
235  // Otherwise, concatenate the list.
236  std::vector<MCSymbol*> *Syms =OldEntry.Symbols.get<std::vector<MCSymbol*>*>();
237  SymList->insert(SymList->end(), Syms->begin(), Syms->end());
238  delete Syms;
239}
240
241
242void MMIAddrLabelMapCallbackPtr::deleted() {
243  Map->UpdateForDeletedBlock(cast<BasicBlock>(getValPtr()));
244}
245
246void MMIAddrLabelMapCallbackPtr::allUsesReplacedWith(Value *V2) {
247  Map->UpdateForRAUWBlock(cast<BasicBlock>(getValPtr()), cast<BasicBlock>(V2));
248}
249
250
251//===----------------------------------------------------------------------===//
252
253MachineModuleInfo::MachineModuleInfo(const MCAsmInfo &MAI,
254                                     const MCRegisterInfo &MRI,
255                                     const MCObjectFileInfo *MOFI)
256  : ImmutablePass(ID), Context(MAI, MRI, MOFI, 0, false) {
257  initializeMachineModuleInfoPass(*PassRegistry::getPassRegistry());
258}
259
260MachineModuleInfo::MachineModuleInfo()
261  : ImmutablePass(ID),
262    Context(*(MCAsmInfo*)0, *(MCRegisterInfo*)0, (MCObjectFileInfo*)0) {
263  llvm_unreachable("This MachineModuleInfo constructor should never be called, "
264                   "MMI should always be explicitly constructed by "
265                   "LLVMTargetMachine");
266}
267
268MachineModuleInfo::~MachineModuleInfo() {
269}
270
271bool MachineModuleInfo::doInitialization(Module &M) {
272
273  ObjFileMMI = 0;
274  CompactUnwindEncoding = 0;
275  CurCallSite = 0;
276  CallsEHReturn = 0;
277  CallsUnwindInit = 0;
278  DbgInfoAvailable = UsesVAFloatArgument = false;
279  // Always emit some info, by default "no personality" info.
280  Personalities.push_back(NULL);
281  AddrLabelSymbols = 0;
282  TheModule = 0;
283
284  return false;
285}
286
287bool MachineModuleInfo::doFinalization(Module &M) {
288
289  Personalities.clear();
290
291  delete AddrLabelSymbols;
292  AddrLabelSymbols = 0;
293
294  Context.reset();
295
296  delete ObjFileMMI;
297  ObjFileMMI = 0;
298
299  return false;
300}
301
302/// EndFunction - Discard function meta information.
303///
304void MachineModuleInfo::EndFunction() {
305  // Clean up frame info.
306  FrameMoves.clear();
307
308  // Clean up exception info.
309  LandingPads.clear();
310  CallSiteMap.clear();
311  TypeInfos.clear();
312  FilterIds.clear();
313  FilterEnds.clear();
314  CallsEHReturn = 0;
315  CallsUnwindInit = 0;
316  CompactUnwindEncoding = 0;
317  VariableDbgInfo.clear();
318}
319
320/// AnalyzeModule - Scan the module for global debug information.
321///
322void MachineModuleInfo::AnalyzeModule(const Module &M) {
323  // Insert functions in the llvm.used array (but not llvm.compiler.used) into
324  // UsedFunctions.
325  const GlobalVariable *GV = M.getGlobalVariable("llvm.used");
326  if (!GV || !GV->hasInitializer()) return;
327
328  // Should be an array of 'i8*'.
329  const ConstantArray *InitList = cast<ConstantArray>(GV->getInitializer());
330
331  for (unsigned i = 0, e = InitList->getNumOperands(); i != e; ++i)
332    if (const Function *F =
333          dyn_cast<Function>(InitList->getOperand(i)->stripPointerCasts()))
334      UsedFunctions.insert(F);
335}
336
337//===- Address of Block Management ----------------------------------------===//
338
339
340/// getAddrLabelSymbol - Return the symbol to be used for the specified basic
341/// block when its address is taken.  This cannot be its normal LBB label
342/// because the block may be accessed outside its containing function.
343MCSymbol *MachineModuleInfo::getAddrLabelSymbol(const BasicBlock *BB) {
344  // Lazily create AddrLabelSymbols.
345  if (AddrLabelSymbols == 0)
346    AddrLabelSymbols = new MMIAddrLabelMap(Context);
347  return AddrLabelSymbols->getAddrLabelSymbol(const_cast<BasicBlock*>(BB));
348}
349
350/// getAddrLabelSymbolToEmit - Return the symbol to be used for the specified
351/// basic block when its address is taken.  If other blocks were RAUW'd to
352/// this one, we may have to emit them as well, return the whole set.
353std::vector<MCSymbol*> MachineModuleInfo::
354getAddrLabelSymbolToEmit(const BasicBlock *BB) {
355  // Lazily create AddrLabelSymbols.
356  if (AddrLabelSymbols == 0)
357    AddrLabelSymbols = new MMIAddrLabelMap(Context);
358 return AddrLabelSymbols->getAddrLabelSymbolToEmit(const_cast<BasicBlock*>(BB));
359}
360
361
362/// takeDeletedSymbolsForFunction - If the specified function has had any
363/// references to address-taken blocks generated, but the block got deleted,
364/// return the symbol now so we can emit it.  This prevents emitting a
365/// reference to a symbol that has no definition.
366void MachineModuleInfo::
367takeDeletedSymbolsForFunction(const Function *F,
368                              std::vector<MCSymbol*> &Result) {
369  // If no blocks have had their addresses taken, we're done.
370  if (AddrLabelSymbols == 0) return;
371  return AddrLabelSymbols->
372     takeDeletedSymbolsForFunction(const_cast<Function*>(F), Result);
373}
374
375//===- EH -----------------------------------------------------------------===//
376
377/// getOrCreateLandingPadInfo - Find or create an LandingPadInfo for the
378/// specified MachineBasicBlock.
379LandingPadInfo &MachineModuleInfo::getOrCreateLandingPadInfo
380    (MachineBasicBlock *LandingPad) {
381  unsigned N = LandingPads.size();
382  for (unsigned i = 0; i < N; ++i) {
383    LandingPadInfo &LP = LandingPads[i];
384    if (LP.LandingPadBlock == LandingPad)
385      return LP;
386  }
387
388  LandingPads.push_back(LandingPadInfo(LandingPad));
389  return LandingPads[N];
390}
391
392/// addInvoke - Provide the begin and end labels of an invoke style call and
393/// associate it with a try landing pad block.
394void MachineModuleInfo::addInvoke(MachineBasicBlock *LandingPad,
395                                  MCSymbol *BeginLabel, MCSymbol *EndLabel) {
396  LandingPadInfo &LP = getOrCreateLandingPadInfo(LandingPad);
397  LP.BeginLabels.push_back(BeginLabel);
398  LP.EndLabels.push_back(EndLabel);
399}
400
401/// addLandingPad - Provide the label of a try LandingPad block.
402///
403MCSymbol *MachineModuleInfo::addLandingPad(MachineBasicBlock *LandingPad) {
404  MCSymbol *LandingPadLabel = Context.CreateTempSymbol();
405  LandingPadInfo &LP = getOrCreateLandingPadInfo(LandingPad);
406  LP.LandingPadLabel = LandingPadLabel;
407  return LandingPadLabel;
408}
409
410/// addPersonality - Provide the personality function for the exception
411/// information.
412void MachineModuleInfo::addPersonality(MachineBasicBlock *LandingPad,
413                                       const Function *Personality) {
414  LandingPadInfo &LP = getOrCreateLandingPadInfo(LandingPad);
415  LP.Personality = Personality;
416
417  for (unsigned i = 0; i < Personalities.size(); ++i)
418    if (Personalities[i] == Personality)
419      return;
420
421  // If this is the first personality we're adding go
422  // ahead and add it at the beginning.
423  if (Personalities[0] == NULL)
424    Personalities[0] = Personality;
425  else
426    Personalities.push_back(Personality);
427}
428
429/// addCatchTypeInfo - Provide the catch typeinfo for a landing pad.
430///
431void MachineModuleInfo::
432addCatchTypeInfo(MachineBasicBlock *LandingPad,
433                 ArrayRef<const GlobalVariable *> TyInfo) {
434  LandingPadInfo &LP = getOrCreateLandingPadInfo(LandingPad);
435  for (unsigned N = TyInfo.size(); N; --N)
436    LP.TypeIds.push_back(getTypeIDFor(TyInfo[N - 1]));
437}
438
439/// addFilterTypeInfo - Provide the filter typeinfo for a landing pad.
440///
441void MachineModuleInfo::
442addFilterTypeInfo(MachineBasicBlock *LandingPad,
443                  ArrayRef<const GlobalVariable *> TyInfo) {
444  LandingPadInfo &LP = getOrCreateLandingPadInfo(LandingPad);
445  std::vector<unsigned> IdsInFilter(TyInfo.size());
446  for (unsigned I = 0, E = TyInfo.size(); I != E; ++I)
447    IdsInFilter[I] = getTypeIDFor(TyInfo[I]);
448  LP.TypeIds.push_back(getFilterIDFor(IdsInFilter));
449}
450
451/// addCleanup - Add a cleanup action for a landing pad.
452///
453void MachineModuleInfo::addCleanup(MachineBasicBlock *LandingPad) {
454  LandingPadInfo &LP = getOrCreateLandingPadInfo(LandingPad);
455  LP.TypeIds.push_back(0);
456}
457
458/// TidyLandingPads - Remap landing pad labels and remove any deleted landing
459/// pads.
460void MachineModuleInfo::TidyLandingPads(DenseMap<MCSymbol*, uintptr_t> *LPMap) {
461  for (unsigned i = 0; i != LandingPads.size(); ) {
462    LandingPadInfo &LandingPad = LandingPads[i];
463    if (LandingPad.LandingPadLabel &&
464        !LandingPad.LandingPadLabel->isDefined() &&
465        (!LPMap || (*LPMap)[LandingPad.LandingPadLabel] == 0))
466      LandingPad.LandingPadLabel = 0;
467
468    // Special case: we *should* emit LPs with null LP MBB. This indicates
469    // "nounwind" case.
470    if (!LandingPad.LandingPadLabel && LandingPad.LandingPadBlock) {
471      LandingPads.erase(LandingPads.begin() + i);
472      continue;
473    }
474
475    for (unsigned j = 0, e = LandingPads[i].BeginLabels.size(); j != e; ++j) {
476      MCSymbol *BeginLabel = LandingPad.BeginLabels[j];
477      MCSymbol *EndLabel = LandingPad.EndLabels[j];
478      if ((BeginLabel->isDefined() ||
479           (LPMap && (*LPMap)[BeginLabel] != 0)) &&
480          (EndLabel->isDefined() ||
481           (LPMap && (*LPMap)[EndLabel] != 0))) continue;
482
483      LandingPad.BeginLabels.erase(LandingPad.BeginLabels.begin() + j);
484      LandingPad.EndLabels.erase(LandingPad.EndLabels.begin() + j);
485      --j, --e;
486    }
487
488    // Remove landing pads with no try-ranges.
489    if (LandingPads[i].BeginLabels.empty()) {
490      LandingPads.erase(LandingPads.begin() + i);
491      continue;
492    }
493
494    // If there is no landing pad, ensure that the list of typeids is empty.
495    // If the only typeid is a cleanup, this is the same as having no typeids.
496    if (!LandingPad.LandingPadBlock ||
497        (LandingPad.TypeIds.size() == 1 && !LandingPad.TypeIds[0]))
498      LandingPad.TypeIds.clear();
499    ++i;
500  }
501}
502
503/// setCallSiteLandingPad - Map the landing pad's EH symbol to the call site
504/// indexes.
505void MachineModuleInfo::setCallSiteLandingPad(MCSymbol *Sym,
506                                              ArrayRef<unsigned> Sites) {
507  LPadToCallSiteMap[Sym].append(Sites.begin(), Sites.end());
508}
509
510/// getTypeIDFor - Return the type id for the specified typeinfo.  This is
511/// function wide.
512unsigned MachineModuleInfo::getTypeIDFor(const GlobalVariable *TI) {
513  for (unsigned i = 0, N = TypeInfos.size(); i != N; ++i)
514    if (TypeInfos[i] == TI) return i + 1;
515
516  TypeInfos.push_back(TI);
517  return TypeInfos.size();
518}
519
520/// getFilterIDFor - Return the filter id for the specified typeinfos.  This is
521/// function wide.
522int MachineModuleInfo::getFilterIDFor(std::vector<unsigned> &TyIds) {
523  // If the new filter coincides with the tail of an existing filter, then
524  // re-use the existing filter.  Folding filters more than this requires
525  // re-ordering filters and/or their elements - probably not worth it.
526  for (std::vector<unsigned>::iterator I = FilterEnds.begin(),
527       E = FilterEnds.end(); I != E; ++I) {
528    unsigned i = *I, j = TyIds.size();
529
530    while (i && j)
531      if (FilterIds[--i] != TyIds[--j])
532        goto try_next;
533
534    if (!j)
535      // The new filter coincides with range [i, end) of the existing filter.
536      return -(1 + i);
537
538try_next:;
539  }
540
541  // Add the new filter.
542  int FilterID = -(1 + FilterIds.size());
543  FilterIds.reserve(FilterIds.size() + TyIds.size() + 1);
544  FilterIds.insert(FilterIds.end(), TyIds.begin(), TyIds.end());
545  FilterEnds.push_back(FilterIds.size());
546  FilterIds.push_back(0); // terminator
547  return FilterID;
548}
549
550/// getPersonality - Return the personality function for the current function.
551const Function *MachineModuleInfo::getPersonality() const {
552  // FIXME: Until PR1414 will be fixed, we're using 1 personality function per
553  // function
554  return !LandingPads.empty() ? LandingPads[0].Personality : NULL;
555}
556
557/// getPersonalityIndex - Return unique index for current personality
558/// function. NULL/first personality function should always get zero index.
559unsigned MachineModuleInfo::getPersonalityIndex() const {
560  const Function* Personality = NULL;
561
562  // Scan landing pads. If there is at least one non-NULL personality - use it.
563  for (unsigned i = 0, e = LandingPads.size(); i != e; ++i)
564    if (LandingPads[i].Personality) {
565      Personality = LandingPads[i].Personality;
566      break;
567    }
568
569  for (unsigned i = 0, e = Personalities.size(); i < e; ++i) {
570    if (Personalities[i] == Personality)
571      return i;
572  }
573
574  // This will happen if the current personality function is
575  // in the zero index.
576  return 0;
577}
578