1 //===--- ScheduleDAGSDNodes.cpp - Implement the ScheduleDAGSDNodes class --===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This implements the ScheduleDAG class, which is a base class used by
10 // scheduling implementation classes.
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #include "ScheduleDAGSDNodes.h"
15 #include "InstrEmitter.h"
16 #include "SDNodeDbgValue.h"
17 #include "llvm/ADT/DenseMap.h"
18 #include "llvm/ADT/SmallPtrSet.h"
19 #include "llvm/ADT/SmallSet.h"
20 #include "llvm/ADT/SmallVector.h"
21 #include "llvm/ADT/Statistic.h"
22 #include "llvm/CodeGen/MachineInstrBuilder.h"
23 #include "llvm/CodeGen/MachineRegisterInfo.h"
24 #include "llvm/CodeGen/SelectionDAG.h"
25 #include "llvm/CodeGen/TargetInstrInfo.h"
26 #include "llvm/CodeGen/TargetLowering.h"
27 #include "llvm/CodeGen/TargetRegisterInfo.h"
28 #include "llvm/CodeGen/TargetSubtargetInfo.h"
29 #include "llvm/Config/llvm-config.h"
30 #include "llvm/MC/MCInstrItineraries.h"
31 #include "llvm/Support/CommandLine.h"
32 #include "llvm/Support/Debug.h"
33 #include "llvm/Support/raw_ostream.h"
34 using namespace llvm;
35 
36 #define DEBUG_TYPE "pre-RA-sched"
37 
38 STATISTIC(LoadsClustered, "Number of loads clustered together");
39 
40 // This allows the latency-based scheduler to notice high latency instructions
41 // without a target itinerary. The choice of number here has more to do with
42 // balancing scheduler heuristics than with the actual machine latency.
43 static cl::opt<int> HighLatencyCycles(
44   "sched-high-latency-cycles", cl::Hidden, cl::init(10),
45   cl::desc("Roughly estimate the number of cycles that 'long latency'"
46            "instructions take for targets with no itinerary"));
47 
48 ScheduleDAGSDNodes::ScheduleDAGSDNodes(MachineFunction &mf)
49     : ScheduleDAG(mf), BB(nullptr), DAG(nullptr),
50       InstrItins(mf.getSubtarget().getInstrItineraryData()) {}
51 
52 /// Run - perform scheduling.
53 ///
54 void ScheduleDAGSDNodes::Run(SelectionDAG *dag, MachineBasicBlock *bb) {
55   BB = bb;
56   DAG = dag;
57 
58   // Clear the scheduler's SUnit DAG.
59   ScheduleDAG::clearDAG();
60   Sequence.clear();
61 
62   // Invoke the target's selection of scheduler.
63   Schedule();
64 }
65 
66 /// NewSUnit - Creates a new SUnit and return a ptr to it.
67 ///
68 SUnit *ScheduleDAGSDNodes::newSUnit(SDNode *N) {
69 #ifndef NDEBUG
70   const SUnit *Addr = nullptr;
71   if (!SUnits.empty())
72     Addr = &SUnits[0];
73 #endif
74   SUnits.emplace_back(N, (unsigned)SUnits.size());
75   assert((Addr == nullptr || Addr == &SUnits[0]) &&
76          "SUnits std::vector reallocated on the fly!");
77   SUnits.back().OrigNode = &SUnits.back();
78   SUnit *SU = &SUnits.back();
79   const TargetLowering &TLI = DAG->getTargetLoweringInfo();
80   if (!N ||
81       (N->isMachineOpcode() &&
82        N->getMachineOpcode() == TargetOpcode::IMPLICIT_DEF))
83     SU->SchedulingPref = Sched::None;
84   else
85     SU->SchedulingPref = TLI.getSchedulingPreference(N);
86   return SU;
87 }
88 
89 SUnit *ScheduleDAGSDNodes::Clone(SUnit *Old) {
90   SUnit *SU = newSUnit(Old->getNode());
91   SU->OrigNode = Old->OrigNode;
92   SU->Latency = Old->Latency;
93   SU->isVRegCycle = Old->isVRegCycle;
94   SU->isCall = Old->isCall;
95   SU->isCallOp = Old->isCallOp;
96   SU->isTwoAddress = Old->isTwoAddress;
97   SU->isCommutable = Old->isCommutable;
98   SU->hasPhysRegDefs = Old->hasPhysRegDefs;
99   SU->hasPhysRegClobbers = Old->hasPhysRegClobbers;
100   SU->isScheduleHigh = Old->isScheduleHigh;
101   SU->isScheduleLow = Old->isScheduleLow;
102   SU->SchedulingPref = Old->SchedulingPref;
103   Old->isCloned = true;
104   return SU;
105 }
106 
107 /// CheckForPhysRegDependency - Check if the dependency between def and use of
108 /// a specified operand is a physical register dependency. If so, returns the
109 /// register and the cost of copying the register.
110 static void CheckForPhysRegDependency(SDNode *Def, SDNode *User, unsigned Op,
111                                       const TargetRegisterInfo *TRI,
112                                       const TargetInstrInfo *TII,
113                                       unsigned &PhysReg, int &Cost) {
114   if (Op != 2 || User->getOpcode() != ISD::CopyToReg)
115     return;
116 
117   unsigned Reg = cast<RegisterSDNode>(User->getOperand(1))->getReg();
118   if (Register::isVirtualRegister(Reg))
119     return;
120 
121   unsigned ResNo = User->getOperand(2).getResNo();
122   if (Def->getOpcode() == ISD::CopyFromReg &&
123       cast<RegisterSDNode>(Def->getOperand(1))->getReg() == Reg) {
124     PhysReg = Reg;
125   } else if (Def->isMachineOpcode()) {
126     const MCInstrDesc &II = TII->get(Def->getMachineOpcode());
127     if (ResNo >= II.getNumDefs() &&
128         II.ImplicitDefs[ResNo - II.getNumDefs()] == Reg)
129       PhysReg = Reg;
130   }
131 
132   if (PhysReg != 0) {
133     const TargetRegisterClass *RC =
134         TRI->getMinimalPhysRegClass(Reg, Def->getSimpleValueType(ResNo));
135     Cost = RC->getCopyCost();
136   }
137 }
138 
139 // Helper for AddGlue to clone node operands.
140 static void CloneNodeWithValues(SDNode *N, SelectionDAG *DAG, ArrayRef<EVT> VTs,
141                                 SDValue ExtraOper = SDValue()) {
142   SmallVector<SDValue, 8> Ops(N->op_begin(), N->op_end());
143   if (ExtraOper.getNode())
144     Ops.push_back(ExtraOper);
145 
146   SDVTList VTList = DAG->getVTList(VTs);
147   MachineSDNode *MN = dyn_cast<MachineSDNode>(N);
148 
149   // Store memory references.
150   SmallVector<MachineMemOperand *, 2> MMOs;
151   if (MN)
152     MMOs.assign(MN->memoperands_begin(), MN->memoperands_end());
153 
154   DAG->MorphNodeTo(N, N->getOpcode(), VTList, Ops);
155 
156   // Reset the memory references
157   if (MN)
158     DAG->setNodeMemRefs(MN, MMOs);
159 }
160 
161 static bool AddGlue(SDNode *N, SDValue Glue, bool AddGlue, SelectionDAG *DAG) {
162   SDNode *GlueDestNode = Glue.getNode();
163 
164   // Don't add glue from a node to itself.
165   if (GlueDestNode == N) return false;
166 
167   // Don't add a glue operand to something that already uses glue.
168   if (GlueDestNode &&
169       N->getOperand(N->getNumOperands()-1).getValueType() == MVT::Glue) {
170     return false;
171   }
172   // Don't add glue to something that already has a glue value.
173   if (N->getValueType(N->getNumValues() - 1) == MVT::Glue) return false;
174 
175   SmallVector<EVT, 4> VTs(N->value_begin(), N->value_end());
176   if (AddGlue)
177     VTs.push_back(MVT::Glue);
178 
179   CloneNodeWithValues(N, DAG, VTs, Glue);
180 
181   return true;
182 }
183 
184 // Cleanup after unsuccessful AddGlue. Use the standard method of morphing the
185 // node even though simply shrinking the value list is sufficient.
186 static void RemoveUnusedGlue(SDNode *N, SelectionDAG *DAG) {
187   assert((N->getValueType(N->getNumValues() - 1) == MVT::Glue &&
188           !N->hasAnyUseOfValue(N->getNumValues() - 1)) &&
189          "expected an unused glue value");
190 
191   CloneNodeWithValues(N, DAG,
192                       makeArrayRef(N->value_begin(), N->getNumValues() - 1));
193 }
194 
195 /// ClusterNeighboringLoads - Force nearby loads together by "gluing" them.
196 /// This function finds loads of the same base and different offsets. If the
197 /// offsets are not far apart (target specific), it add MVT::Glue inputs and
198 /// outputs to ensure they are scheduled together and in order. This
199 /// optimization may benefit some targets by improving cache locality.
200 void ScheduleDAGSDNodes::ClusterNeighboringLoads(SDNode *Node) {
201   SDValue Chain;
202   unsigned NumOps = Node->getNumOperands();
203   if (Node->getOperand(NumOps-1).getValueType() == MVT::Other)
204     Chain = Node->getOperand(NumOps-1);
205   if (!Chain)
206     return;
207 
208   // Skip any load instruction that has a tied input. There may be an additional
209   // dependency requiring a different order than by increasing offsets, and the
210   // added glue may introduce a cycle.
211   auto hasTiedInput = [this](const SDNode *N) {
212     const MCInstrDesc &MCID = TII->get(N->getMachineOpcode());
213     for (unsigned I = 0; I != MCID.getNumOperands(); ++I) {
214       if (MCID.getOperandConstraint(I, MCOI::TIED_TO) != -1)
215         return true;
216     }
217 
218     return false;
219   };
220 
221   // Look for other loads of the same chain. Find loads that are loading from
222   // the same base pointer and different offsets.
223   SmallPtrSet<SDNode*, 16> Visited;
224   SmallVector<int64_t, 4> Offsets;
225   DenseMap<long long, SDNode*> O2SMap;  // Map from offset to SDNode.
226   bool Cluster = false;
227   SDNode *Base = Node;
228 
229   if (hasTiedInput(Base))
230     return;
231 
232   // This algorithm requires a reasonably low use count before finding a match
233   // to avoid uselessly blowing up compile time in large blocks.
234   unsigned UseCount = 0;
235   for (SDNode::use_iterator I = Chain->use_begin(), E = Chain->use_end();
236        I != E && UseCount < 100; ++I, ++UseCount) {
237     if (I.getUse().getResNo() != Chain.getResNo())
238       continue;
239 
240     SDNode *User = *I;
241     if (User == Node || !Visited.insert(User).second)
242       continue;
243     int64_t Offset1, Offset2;
244     if (!TII->areLoadsFromSameBasePtr(Base, User, Offset1, Offset2) ||
245         Offset1 == Offset2 ||
246         hasTiedInput(User)) {
247       // FIXME: Should be ok if they addresses are identical. But earlier
248       // optimizations really should have eliminated one of the loads.
249       continue;
250     }
251     if (O2SMap.insert(std::make_pair(Offset1, Base)).second)
252       Offsets.push_back(Offset1);
253     O2SMap.insert(std::make_pair(Offset2, User));
254     Offsets.push_back(Offset2);
255     if (Offset2 < Offset1)
256       Base = User;
257     Cluster = true;
258     // Reset UseCount to allow more matches.
259     UseCount = 0;
260   }
261 
262   if (!Cluster)
263     return;
264 
265   // Sort them in increasing order.
266   llvm::sort(Offsets);
267 
268   // Check if the loads are close enough.
269   SmallVector<SDNode*, 4> Loads;
270   unsigned NumLoads = 0;
271   int64_t BaseOff = Offsets[0];
272   SDNode *BaseLoad = O2SMap[BaseOff];
273   Loads.push_back(BaseLoad);
274   for (unsigned i = 1, e = Offsets.size(); i != e; ++i) {
275     int64_t Offset = Offsets[i];
276     SDNode *Load = O2SMap[Offset];
277     if (!TII->shouldScheduleLoadsNear(BaseLoad, Load, BaseOff, Offset,NumLoads))
278       break; // Stop right here. Ignore loads that are further away.
279     Loads.push_back(Load);
280     ++NumLoads;
281   }
282 
283   if (NumLoads == 0)
284     return;
285 
286   // Cluster loads by adding MVT::Glue outputs and inputs. This also
287   // ensure they are scheduled in order of increasing addresses.
288   SDNode *Lead = Loads[0];
289   SDValue InGlue = SDValue(nullptr, 0);
290   if (AddGlue(Lead, InGlue, true, DAG))
291     InGlue = SDValue(Lead, Lead->getNumValues() - 1);
292   for (unsigned I = 1, E = Loads.size(); I != E; ++I) {
293     bool OutGlue = I < E - 1;
294     SDNode *Load = Loads[I];
295 
296     // If AddGlue fails, we could leave an unsused glue value. This should not
297     // cause any
298     if (AddGlue(Load, InGlue, OutGlue, DAG)) {
299       if (OutGlue)
300         InGlue = SDValue(Load, Load->getNumValues() - 1);
301 
302       ++LoadsClustered;
303     }
304     else if (!OutGlue && InGlue.getNode())
305       RemoveUnusedGlue(InGlue.getNode(), DAG);
306   }
307 }
308 
309 /// ClusterNodes - Cluster certain nodes which should be scheduled together.
310 ///
311 void ScheduleDAGSDNodes::ClusterNodes() {
312   for (SDNode &NI : DAG->allnodes()) {
313     SDNode *Node = &NI;
314     if (!Node || !Node->isMachineOpcode())
315       continue;
316 
317     unsigned Opc = Node->getMachineOpcode();
318     const MCInstrDesc &MCID = TII->get(Opc);
319     if (MCID.mayLoad())
320       // Cluster loads from "near" addresses into combined SUnits.
321       ClusterNeighboringLoads(Node);
322   }
323 }
324 
325 void ScheduleDAGSDNodes::BuildSchedUnits() {
326   // During scheduling, the NodeId field of SDNode is used to map SDNodes
327   // to their associated SUnits by holding SUnits table indices. A value
328   // of -1 means the SDNode does not yet have an associated SUnit.
329   unsigned NumNodes = 0;
330   for (SDNode &NI : DAG->allnodes()) {
331     NI.setNodeId(-1);
332     ++NumNodes;
333   }
334 
335   // Reserve entries in the vector for each of the SUnits we are creating.  This
336   // ensure that reallocation of the vector won't happen, so SUnit*'s won't get
337   // invalidated.
338   // FIXME: Multiply by 2 because we may clone nodes during scheduling.
339   // This is a temporary workaround.
340   SUnits.reserve(NumNodes * 2);
341 
342   // Add all nodes in depth first order.
343   SmallVector<SDNode*, 64> Worklist;
344   SmallPtrSet<SDNode*, 32> Visited;
345   Worklist.push_back(DAG->getRoot().getNode());
346   Visited.insert(DAG->getRoot().getNode());
347 
348   SmallVector<SUnit*, 8> CallSUnits;
349   while (!Worklist.empty()) {
350     SDNode *NI = Worklist.pop_back_val();
351 
352     // Add all operands to the worklist unless they've already been added.
353     for (const SDValue &Op : NI->op_values())
354       if (Visited.insert(Op.getNode()).second)
355         Worklist.push_back(Op.getNode());
356 
357     if (isPassiveNode(NI))  // Leaf node, e.g. a TargetImmediate.
358       continue;
359 
360     // If this node has already been processed, stop now.
361     if (NI->getNodeId() != -1) continue;
362 
363     SUnit *NodeSUnit = newSUnit(NI);
364 
365     // See if anything is glued to this node, if so, add them to glued
366     // nodes.  Nodes can have at most one glue input and one glue output.  Glue
367     // is required to be the last operand and result of a node.
368 
369     // Scan up to find glued preds.
370     SDNode *N = NI;
371     while (N->getNumOperands() &&
372            N->getOperand(N->getNumOperands()-1).getValueType() == MVT::Glue) {
373       N = N->getOperand(N->getNumOperands()-1).getNode();
374       assert(N->getNodeId() == -1 && "Node already inserted!");
375       N->setNodeId(NodeSUnit->NodeNum);
376       if (N->isMachineOpcode() && TII->get(N->getMachineOpcode()).isCall())
377         NodeSUnit->isCall = true;
378     }
379 
380     // Scan down to find any glued succs.
381     N = NI;
382     while (N->getValueType(N->getNumValues()-1) == MVT::Glue) {
383       SDValue GlueVal(N, N->getNumValues()-1);
384 
385       // There are either zero or one users of the Glue result.
386       bool HasGlueUse = false;
387       for (SDNode::use_iterator UI = N->use_begin(), E = N->use_end();
388            UI != E; ++UI)
389         if (GlueVal.isOperandOf(*UI)) {
390           HasGlueUse = true;
391           assert(N->getNodeId() == -1 && "Node already inserted!");
392           N->setNodeId(NodeSUnit->NodeNum);
393           N = *UI;
394           if (N->isMachineOpcode() && TII->get(N->getMachineOpcode()).isCall())
395             NodeSUnit->isCall = true;
396           break;
397         }
398       if (!HasGlueUse) break;
399     }
400 
401     if (NodeSUnit->isCall)
402       CallSUnits.push_back(NodeSUnit);
403 
404     // Schedule zero-latency TokenFactor below any nodes that may increase the
405     // schedule height. Otherwise, ancestors of the TokenFactor may appear to
406     // have false stalls.
407     if (NI->getOpcode() == ISD::TokenFactor)
408       NodeSUnit->isScheduleLow = true;
409 
410     // If there are glue operands involved, N is now the bottom-most node
411     // of the sequence of nodes that are glued together.
412     // Update the SUnit.
413     NodeSUnit->setNode(N);
414     assert(N->getNodeId() == -1 && "Node already inserted!");
415     N->setNodeId(NodeSUnit->NodeNum);
416 
417     // Compute NumRegDefsLeft. This must be done before AddSchedEdges.
418     InitNumRegDefsLeft(NodeSUnit);
419 
420     // Assign the Latency field of NodeSUnit using target-provided information.
421     computeLatency(NodeSUnit);
422   }
423 
424   // Find all call operands.
425   while (!CallSUnits.empty()) {
426     SUnit *SU = CallSUnits.pop_back_val();
427     for (const SDNode *SUNode = SU->getNode(); SUNode;
428          SUNode = SUNode->getGluedNode()) {
429       if (SUNode->getOpcode() != ISD::CopyToReg)
430         continue;
431       SDNode *SrcN = SUNode->getOperand(2).getNode();
432       if (isPassiveNode(SrcN)) continue;   // Not scheduled.
433       SUnit *SrcSU = &SUnits[SrcN->getNodeId()];
434       SrcSU->isCallOp = true;
435     }
436   }
437 }
438 
439 void ScheduleDAGSDNodes::AddSchedEdges() {
440   const TargetSubtargetInfo &ST = MF.getSubtarget();
441 
442   // Check to see if the scheduler cares about latencies.
443   bool UnitLatencies = forceUnitLatencies();
444 
445   // Pass 2: add the preds, succs, etc.
446   for (unsigned su = 0, e = SUnits.size(); su != e; ++su) {
447     SUnit *SU = &SUnits[su];
448     SDNode *MainNode = SU->getNode();
449 
450     if (MainNode->isMachineOpcode()) {
451       unsigned Opc = MainNode->getMachineOpcode();
452       const MCInstrDesc &MCID = TII->get(Opc);
453       for (unsigned i = 0; i != MCID.getNumOperands(); ++i) {
454         if (MCID.getOperandConstraint(i, MCOI::TIED_TO) != -1) {
455           SU->isTwoAddress = true;
456           break;
457         }
458       }
459       if (MCID.isCommutable())
460         SU->isCommutable = true;
461     }
462 
463     // Find all predecessors and successors of the group.
464     for (SDNode *N = SU->getNode(); N; N = N->getGluedNode()) {
465       if (N->isMachineOpcode() &&
466           TII->get(N->getMachineOpcode()).getImplicitDefs()) {
467         SU->hasPhysRegClobbers = true;
468         unsigned NumUsed = InstrEmitter::CountResults(N);
469         while (NumUsed != 0 && !N->hasAnyUseOfValue(NumUsed - 1))
470           --NumUsed;    // Skip over unused values at the end.
471         if (NumUsed > TII->get(N->getMachineOpcode()).getNumDefs())
472           SU->hasPhysRegDefs = true;
473       }
474 
475       for (unsigned i = 0, e = N->getNumOperands(); i != e; ++i) {
476         SDNode *OpN = N->getOperand(i).getNode();
477         if (isPassiveNode(OpN)) continue;   // Not scheduled.
478         SUnit *OpSU = &SUnits[OpN->getNodeId()];
479         assert(OpSU && "Node has no SUnit!");
480         if (OpSU == SU) continue;           // In the same group.
481 
482         EVT OpVT = N->getOperand(i).getValueType();
483         assert(OpVT != MVT::Glue && "Glued nodes should be in same sunit!");
484         bool isChain = OpVT == MVT::Other;
485 
486         unsigned PhysReg = 0;
487         int Cost = 1;
488         // Determine if this is a physical register dependency.
489         CheckForPhysRegDependency(OpN, N, i, TRI, TII, PhysReg, Cost);
490         assert((PhysReg == 0 || !isChain) &&
491                "Chain dependence via physreg data?");
492         // FIXME: See ScheduleDAGSDNodes::EmitCopyFromReg. For now, scheduler
493         // emits a copy from the physical register to a virtual register unless
494         // it requires a cross class copy (cost < 0). That means we are only
495         // treating "expensive to copy" register dependency as physical register
496         // dependency. This may change in the future though.
497         if (Cost >= 0 && !StressSched)
498           PhysReg = 0;
499 
500         // If this is a ctrl dep, latency is 1.
501         unsigned OpLatency = isChain ? 1 : OpSU->Latency;
502         // Special-case TokenFactor chains as zero-latency.
503         if(isChain && OpN->getOpcode() == ISD::TokenFactor)
504           OpLatency = 0;
505 
506         SDep Dep = isChain ? SDep(OpSU, SDep::Barrier)
507           : SDep(OpSU, SDep::Data, PhysReg);
508         Dep.setLatency(OpLatency);
509         if (!isChain && !UnitLatencies) {
510           computeOperandLatency(OpN, N, i, Dep);
511           ST.adjustSchedDependency(OpSU, SU, Dep);
512         }
513 
514         if (!SU->addPred(Dep) && !Dep.isCtrl() && OpSU->NumRegDefsLeft > 1) {
515           // Multiple register uses are combined in the same SUnit. For example,
516           // we could have a set of glued nodes with all their defs consumed by
517           // another set of glued nodes. Register pressure tracking sees this as
518           // a single use, so to keep pressure balanced we reduce the defs.
519           //
520           // We can't tell (without more book-keeping) if this results from
521           // glued nodes or duplicate operands. As long as we don't reduce
522           // NumRegDefsLeft to zero, we handle the common cases well.
523           --OpSU->NumRegDefsLeft;
524         }
525       }
526     }
527   }
528 }
529 
530 /// BuildSchedGraph - Build the SUnit graph from the selection dag that we
531 /// are input.  This SUnit graph is similar to the SelectionDAG, but
532 /// excludes nodes that aren't interesting to scheduling, and represents
533 /// glued together nodes with a single SUnit.
534 void ScheduleDAGSDNodes::BuildSchedGraph(AAResults *AA) {
535   // Cluster certain nodes which should be scheduled together.
536   ClusterNodes();
537   // Populate the SUnits array.
538   BuildSchedUnits();
539   // Compute all the scheduling dependencies between nodes.
540   AddSchedEdges();
541 }
542 
543 // Initialize NumNodeDefs for the current Node's opcode.
544 void ScheduleDAGSDNodes::RegDefIter::InitNodeNumDefs() {
545   // Check for phys reg copy.
546   if (!Node)
547     return;
548 
549   if (!Node->isMachineOpcode()) {
550     if (Node->getOpcode() == ISD::CopyFromReg)
551       NodeNumDefs = 1;
552     else
553       NodeNumDefs = 0;
554     return;
555   }
556   unsigned POpc = Node->getMachineOpcode();
557   if (POpc == TargetOpcode::IMPLICIT_DEF) {
558     // No register need be allocated for this.
559     NodeNumDefs = 0;
560     return;
561   }
562   if (POpc == TargetOpcode::PATCHPOINT &&
563       Node->getValueType(0) == MVT::Other) {
564     // PATCHPOINT is defined to have one result, but it might really have none
565     // if we're not using CallingConv::AnyReg. Don't mistake the chain for a
566     // real definition.
567     NodeNumDefs = 0;
568     return;
569   }
570   unsigned NRegDefs = SchedDAG->TII->get(Node->getMachineOpcode()).getNumDefs();
571   // Some instructions define regs that are not represented in the selection DAG
572   // (e.g. unused flags). See tMOVi8. Make sure we don't access past NumValues.
573   NodeNumDefs = std::min(Node->getNumValues(), NRegDefs);
574   DefIdx = 0;
575 }
576 
577 // Construct a RegDefIter for this SUnit and find the first valid value.
578 ScheduleDAGSDNodes::RegDefIter::RegDefIter(const SUnit *SU,
579                                            const ScheduleDAGSDNodes *SD)
580   : SchedDAG(SD), Node(SU->getNode()), DefIdx(0), NodeNumDefs(0) {
581   InitNodeNumDefs();
582   Advance();
583 }
584 
585 // Advance to the next valid value defined by the SUnit.
586 void ScheduleDAGSDNodes::RegDefIter::Advance() {
587   for (;Node;) { // Visit all glued nodes.
588     for (;DefIdx < NodeNumDefs; ++DefIdx) {
589       if (!Node->hasAnyUseOfValue(DefIdx))
590         continue;
591       ValueType = Node->getSimpleValueType(DefIdx);
592       ++DefIdx;
593       return; // Found a normal regdef.
594     }
595     Node = Node->getGluedNode();
596     if (!Node) {
597       return; // No values left to visit.
598     }
599     InitNodeNumDefs();
600   }
601 }
602 
603 void ScheduleDAGSDNodes::InitNumRegDefsLeft(SUnit *SU) {
604   assert(SU->NumRegDefsLeft == 0 && "expect a new node");
605   for (RegDefIter I(SU, this); I.IsValid(); I.Advance()) {
606     assert(SU->NumRegDefsLeft < USHRT_MAX && "overflow is ok but unexpected");
607     ++SU->NumRegDefsLeft;
608   }
609 }
610 
611 void ScheduleDAGSDNodes::computeLatency(SUnit *SU) {
612   SDNode *N = SU->getNode();
613 
614   // TokenFactor operands are considered zero latency, and some schedulers
615   // (e.g. Top-Down list) may rely on the fact that operand latency is nonzero
616   // whenever node latency is nonzero.
617   if (N && N->getOpcode() == ISD::TokenFactor) {
618     SU->Latency = 0;
619     return;
620   }
621 
622   // Check to see if the scheduler cares about latencies.
623   if (forceUnitLatencies()) {
624     SU->Latency = 1;
625     return;
626   }
627 
628   if (!InstrItins || InstrItins->isEmpty()) {
629     if (N && N->isMachineOpcode() &&
630         TII->isHighLatencyDef(N->getMachineOpcode()))
631       SU->Latency = HighLatencyCycles;
632     else
633       SU->Latency = 1;
634     return;
635   }
636 
637   // Compute the latency for the node.  We use the sum of the latencies for
638   // all nodes glued together into this SUnit.
639   SU->Latency = 0;
640   for (SDNode *N = SU->getNode(); N; N = N->getGluedNode())
641     if (N->isMachineOpcode())
642       SU->Latency += TII->getInstrLatency(InstrItins, N);
643 }
644 
645 void ScheduleDAGSDNodes::computeOperandLatency(SDNode *Def, SDNode *Use,
646                                                unsigned OpIdx, SDep& dep) const{
647   // Check to see if the scheduler cares about latencies.
648   if (forceUnitLatencies())
649     return;
650 
651   if (dep.getKind() != SDep::Data)
652     return;
653 
654   unsigned DefIdx = Use->getOperand(OpIdx).getResNo();
655   if (Use->isMachineOpcode())
656     // Adjust the use operand index by num of defs.
657     OpIdx += TII->get(Use->getMachineOpcode()).getNumDefs();
658   int Latency = TII->getOperandLatency(InstrItins, Def, DefIdx, Use, OpIdx);
659   if (Latency > 1 && Use->getOpcode() == ISD::CopyToReg &&
660       !BB->succ_empty()) {
661     unsigned Reg = cast<RegisterSDNode>(Use->getOperand(1))->getReg();
662     if (Register::isVirtualRegister(Reg))
663       // This copy is a liveout value. It is likely coalesced, so reduce the
664       // latency so not to penalize the def.
665       // FIXME: need target specific adjustment here?
666       Latency = (Latency > 1) ? Latency - 1 : 1;
667   }
668   if (Latency >= 0)
669     dep.setLatency(Latency);
670 }
671 
672 void ScheduleDAGSDNodes::dumpNode(const SUnit &SU) const {
673 #if !defined(NDEBUG) || defined(LLVM_ENABLE_DUMP)
674   dumpNodeName(SU);
675   dbgs() << ": ";
676 
677   if (!SU.getNode()) {
678     dbgs() << "PHYS REG COPY\n";
679     return;
680   }
681 
682   SU.getNode()->dump(DAG);
683   dbgs() << "\n";
684   SmallVector<SDNode *, 4> GluedNodes;
685   for (SDNode *N = SU.getNode()->getGluedNode(); N; N = N->getGluedNode())
686     GluedNodes.push_back(N);
687   while (!GluedNodes.empty()) {
688     dbgs() << "    ";
689     GluedNodes.back()->dump(DAG);
690     dbgs() << "\n";
691     GluedNodes.pop_back();
692   }
693 #endif
694 }
695 
696 void ScheduleDAGSDNodes::dump() const {
697 #if !defined(NDEBUG) || defined(LLVM_ENABLE_DUMP)
698   if (EntrySU.getNode() != nullptr)
699     dumpNodeAll(EntrySU);
700   for (const SUnit &SU : SUnits)
701     dumpNodeAll(SU);
702   if (ExitSU.getNode() != nullptr)
703     dumpNodeAll(ExitSU);
704 #endif
705 }
706 
707 #if !defined(NDEBUG) || defined(LLVM_ENABLE_DUMP)
708 void ScheduleDAGSDNodes::dumpSchedule() const {
709   for (unsigned i = 0, e = Sequence.size(); i != e; i++) {
710     if (SUnit *SU = Sequence[i])
711       dumpNode(*SU);
712     else
713       dbgs() << "**** NOOP ****\n";
714   }
715 }
716 #endif
717 
718 #ifndef NDEBUG
719 /// VerifyScheduledSequence - Verify that all SUnits were scheduled and that
720 /// their state is consistent with the nodes listed in Sequence.
721 ///
722 void ScheduleDAGSDNodes::VerifyScheduledSequence(bool isBottomUp) {
723   unsigned ScheduledNodes = ScheduleDAG::VerifyScheduledDAG(isBottomUp);
724   unsigned Noops = 0;
725   for (unsigned i = 0, e = Sequence.size(); i != e; ++i)
726     if (!Sequence[i])
727       ++Noops;
728   assert(Sequence.size() - Noops == ScheduledNodes &&
729          "The number of nodes scheduled doesn't match the expected number!");
730 }
731 #endif // NDEBUG
732 
733 /// ProcessSDDbgValues - Process SDDbgValues associated with this node.
734 static void
735 ProcessSDDbgValues(SDNode *N, SelectionDAG *DAG, InstrEmitter &Emitter,
736                    SmallVectorImpl<std::pair<unsigned, MachineInstr*> > &Orders,
737                    DenseMap<SDValue, Register> &VRBaseMap, unsigned Order) {
738   if (!N->getHasDebugValue())
739     return;
740 
741   // Opportunistically insert immediate dbg_value uses, i.e. those with the same
742   // source order number as N.
743   MachineBasicBlock *BB = Emitter.getBlock();
744   MachineBasicBlock::iterator InsertPos = Emitter.getInsertPos();
745   for (auto DV : DAG->GetDbgValues(N)) {
746     if (DV->isEmitted())
747       continue;
748     unsigned DVOrder = DV->getOrder();
749     if (!Order || DVOrder == Order) {
750       MachineInstr *DbgMI = Emitter.EmitDbgValue(DV, VRBaseMap);
751       if (DbgMI) {
752         Orders.push_back({DVOrder, DbgMI});
753         BB->insert(InsertPos, DbgMI);
754       }
755     }
756   }
757 }
758 
759 // ProcessSourceNode - Process nodes with source order numbers. These are added
760 // to a vector which EmitSchedule uses to determine how to insert dbg_value
761 // instructions in the right order.
762 static void
763 ProcessSourceNode(SDNode *N, SelectionDAG *DAG, InstrEmitter &Emitter,
764                   DenseMap<SDValue, Register> &VRBaseMap,
765                   SmallVectorImpl<std::pair<unsigned, MachineInstr *>> &Orders,
766                   SmallSet<Register, 8> &Seen, MachineInstr *NewInsn) {
767   unsigned Order = N->getIROrder();
768   if (!Order || Seen.count(Order)) {
769     // Process any valid SDDbgValues even if node does not have any order
770     // assigned.
771     ProcessSDDbgValues(N, DAG, Emitter, Orders, VRBaseMap, 0);
772     return;
773   }
774 
775   // If a new instruction was generated for this Order number, record it.
776   // Otherwise, leave this order number unseen: we will either find later
777   // instructions for it, or leave it unseen if there were no instructions at
778   // all.
779   if (NewInsn) {
780     Seen.insert(Order);
781     Orders.push_back({Order, NewInsn});
782   }
783 
784   // Even if no instruction was generated, a Value may have become defined via
785   // earlier nodes. Try to process them now.
786   ProcessSDDbgValues(N, DAG, Emitter, Orders, VRBaseMap, Order);
787 }
788 
789 void ScheduleDAGSDNodes::
790 EmitPhysRegCopy(SUnit *SU, DenseMap<SUnit*, Register> &VRBaseMap,
791                 MachineBasicBlock::iterator InsertPos) {
792   for (SUnit::const_pred_iterator I = SU->Preds.begin(), E = SU->Preds.end();
793        I != E; ++I) {
794     if (I->isCtrl()) continue;  // ignore chain preds
795     if (I->getSUnit()->CopyDstRC) {
796       // Copy to physical register.
797       DenseMap<SUnit*, Register>::iterator VRI = VRBaseMap.find(I->getSUnit());
798       assert(VRI != VRBaseMap.end() && "Node emitted out of order - late");
799       // Find the destination physical register.
800       Register Reg;
801       for (SUnit::const_succ_iterator II = SU->Succs.begin(),
802              EE = SU->Succs.end(); II != EE; ++II) {
803         if (II->isCtrl()) continue;  // ignore chain preds
804         if (II->getReg()) {
805           Reg = II->getReg();
806           break;
807         }
808       }
809       BuildMI(*BB, InsertPos, DebugLoc(), TII->get(TargetOpcode::COPY), Reg)
810         .addReg(VRI->second);
811     } else {
812       // Copy from physical register.
813       assert(I->getReg() && "Unknown physical register!");
814       Register VRBase = MRI.createVirtualRegister(SU->CopyDstRC);
815       bool isNew = VRBaseMap.insert(std::make_pair(SU, VRBase)).second;
816       (void)isNew; // Silence compiler warning.
817       assert(isNew && "Node emitted out of order - early");
818       BuildMI(*BB, InsertPos, DebugLoc(), TII->get(TargetOpcode::COPY), VRBase)
819         .addReg(I->getReg());
820     }
821     break;
822   }
823 }
824 
825 /// EmitSchedule - Emit the machine code in scheduled order. Return the new
826 /// InsertPos and MachineBasicBlock that contains this insertion
827 /// point. ScheduleDAGSDNodes holds a BB pointer for convenience, but this does
828 /// not necessarily refer to returned BB. The emitter may split blocks.
829 MachineBasicBlock *ScheduleDAGSDNodes::
830 EmitSchedule(MachineBasicBlock::iterator &InsertPos) {
831   InstrEmitter Emitter(BB, InsertPos);
832   DenseMap<SDValue, Register> VRBaseMap;
833   DenseMap<SUnit*, Register> CopyVRBaseMap;
834   SmallVector<std::pair<unsigned, MachineInstr*>, 32> Orders;
835   SmallSet<Register, 8> Seen;
836   bool HasDbg = DAG->hasDebugValues();
837 
838   // Emit a node, and determine where its first instruction is for debuginfo.
839   // Zero, one, or multiple instructions can be created when emitting a node.
840   auto EmitNode =
841       [&](SDNode *Node, bool IsClone, bool IsCloned,
842           DenseMap<SDValue, Register> &VRBaseMap) -> MachineInstr * {
843     // Fetch instruction prior to this, or end() if nonexistant.
844     auto GetPrevInsn = [&](MachineBasicBlock::iterator I) {
845       if (I == BB->begin())
846         return BB->end();
847       else
848         return std::prev(Emitter.getInsertPos());
849     };
850 
851     MachineBasicBlock::iterator Before = GetPrevInsn(Emitter.getInsertPos());
852     Emitter.EmitNode(Node, IsClone, IsCloned, VRBaseMap);
853     MachineBasicBlock::iterator After = GetPrevInsn(Emitter.getInsertPos());
854 
855     // If the iterator did not change, no instructions were inserted.
856     if (Before == After)
857       return nullptr;
858 
859     MachineInstr *MI;
860     if (Before == BB->end()) {
861       // There were no prior instructions; the new ones must start at the
862       // beginning of the block.
863       MI = &Emitter.getBlock()->instr_front();
864     } else {
865       // Return first instruction after the pre-existing instructions.
866       MI = &*std::next(Before);
867     }
868 
869     if (MI->isCandidateForCallSiteEntry() &&
870         DAG->getTarget().Options.EmitCallSiteInfo)
871       MF.addCallArgsForwardingRegs(MI, DAG->getSDCallSiteInfo(Node));
872 
873     return MI;
874   };
875 
876   // If this is the first BB, emit byval parameter dbg_value's.
877   if (HasDbg && BB->getParent()->begin() == MachineFunction::iterator(BB)) {
878     SDDbgInfo::DbgIterator PDI = DAG->ByvalParmDbgBegin();
879     SDDbgInfo::DbgIterator PDE = DAG->ByvalParmDbgEnd();
880     for (; PDI != PDE; ++PDI) {
881       MachineInstr *DbgMI= Emitter.EmitDbgValue(*PDI, VRBaseMap);
882       if (DbgMI) {
883         BB->insert(InsertPos, DbgMI);
884         // We re-emit the dbg_value closer to its use, too, after instructions
885         // are emitted to the BB.
886         (*PDI)->clearIsEmitted();
887       }
888     }
889   }
890 
891   for (unsigned i = 0, e = Sequence.size(); i != e; i++) {
892     SUnit *SU = Sequence[i];
893     if (!SU) {
894       // Null SUnit* is a noop.
895       TII->insertNoop(*Emitter.getBlock(), InsertPos);
896       continue;
897     }
898 
899     // For pre-regalloc scheduling, create instructions corresponding to the
900     // SDNode and any glued SDNodes and append them to the block.
901     if (!SU->getNode()) {
902       // Emit a copy.
903       EmitPhysRegCopy(SU, CopyVRBaseMap, InsertPos);
904       continue;
905     }
906 
907     SmallVector<SDNode *, 4> GluedNodes;
908     for (SDNode *N = SU->getNode()->getGluedNode(); N; N = N->getGluedNode())
909       GluedNodes.push_back(N);
910     while (!GluedNodes.empty()) {
911       SDNode *N = GluedNodes.back();
912       auto NewInsn = EmitNode(N, SU->OrigNode != SU, SU->isCloned, VRBaseMap);
913       // Remember the source order of the inserted instruction.
914       if (HasDbg)
915         ProcessSourceNode(N, DAG, Emitter, VRBaseMap, Orders, Seen, NewInsn);
916 
917       if (MDNode *MD = DAG->getHeapAllocSite(N))
918         if (NewInsn && NewInsn->isCall())
919           NewInsn->setHeapAllocMarker(MF, MD);
920 
921       GluedNodes.pop_back();
922     }
923     auto NewInsn =
924         EmitNode(SU->getNode(), SU->OrigNode != SU, SU->isCloned, VRBaseMap);
925     // Remember the source order of the inserted instruction.
926     if (HasDbg)
927       ProcessSourceNode(SU->getNode(), DAG, Emitter, VRBaseMap, Orders, Seen,
928                         NewInsn);
929 
930     if (MDNode *MD = DAG->getHeapAllocSite(SU->getNode())) {
931       if (NewInsn && NewInsn->isCall())
932         NewInsn->setHeapAllocMarker(MF, MD);
933     }
934   }
935 
936   // Insert all the dbg_values which have not already been inserted in source
937   // order sequence.
938   if (HasDbg) {
939     MachineBasicBlock::iterator BBBegin = BB->getFirstNonPHI();
940 
941     // Sort the source order instructions and use the order to insert debug
942     // values. Use stable_sort so that DBG_VALUEs are inserted in the same order
943     // regardless of the host's implementation fo std::sort.
944     llvm::stable_sort(Orders, less_first());
945     std::stable_sort(DAG->DbgBegin(), DAG->DbgEnd(),
946                      [](const SDDbgValue *LHS, const SDDbgValue *RHS) {
947                        return LHS->getOrder() < RHS->getOrder();
948                      });
949 
950     SDDbgInfo::DbgIterator DI = DAG->DbgBegin();
951     SDDbgInfo::DbgIterator DE = DAG->DbgEnd();
952     // Now emit the rest according to source order.
953     unsigned LastOrder = 0;
954     for (unsigned i = 0, e = Orders.size(); i != e && DI != DE; ++i) {
955       unsigned Order = Orders[i].first;
956       MachineInstr *MI = Orders[i].second;
957       // Insert all SDDbgValue's whose order(s) are before "Order".
958       assert(MI);
959       for (; DI != DE; ++DI) {
960         if ((*DI)->getOrder() < LastOrder || (*DI)->getOrder() >= Order)
961           break;
962         if ((*DI)->isEmitted())
963           continue;
964 
965         MachineInstr *DbgMI = Emitter.EmitDbgValue(*DI, VRBaseMap);
966         if (DbgMI) {
967           if (!LastOrder)
968             // Insert to start of the BB (after PHIs).
969             BB->insert(BBBegin, DbgMI);
970           else {
971             // Insert at the instruction, which may be in a different
972             // block, if the block was split by a custom inserter.
973             MachineBasicBlock::iterator Pos = MI;
974             MI->getParent()->insert(Pos, DbgMI);
975           }
976         }
977       }
978       LastOrder = Order;
979     }
980     // Add trailing DbgValue's before the terminator. FIXME: May want to add
981     // some of them before one or more conditional branches?
982     SmallVector<MachineInstr*, 8> DbgMIs;
983     for (; DI != DE; ++DI) {
984       if ((*DI)->isEmitted())
985         continue;
986       assert((*DI)->getOrder() >= LastOrder &&
987              "emitting DBG_VALUE out of order");
988       if (MachineInstr *DbgMI = Emitter.EmitDbgValue(*DI, VRBaseMap))
989         DbgMIs.push_back(DbgMI);
990     }
991 
992     MachineBasicBlock *InsertBB = Emitter.getBlock();
993     MachineBasicBlock::iterator Pos = InsertBB->getFirstTerminator();
994     InsertBB->insert(Pos, DbgMIs.begin(), DbgMIs.end());
995 
996     SDDbgInfo::DbgLabelIterator DLI = DAG->DbgLabelBegin();
997     SDDbgInfo::DbgLabelIterator DLE = DAG->DbgLabelEnd();
998     // Now emit the rest according to source order.
999     LastOrder = 0;
1000     for (const auto &InstrOrder : Orders) {
1001       unsigned Order = InstrOrder.first;
1002       MachineInstr *MI = InstrOrder.second;
1003       if (!MI)
1004         continue;
1005 
1006       // Insert all SDDbgLabel's whose order(s) are before "Order".
1007       for (; DLI != DLE &&
1008              (*DLI)->getOrder() >= LastOrder && (*DLI)->getOrder() < Order;
1009              ++DLI) {
1010         MachineInstr *DbgMI = Emitter.EmitDbgLabel(*DLI);
1011         if (DbgMI) {
1012           if (!LastOrder)
1013             // Insert to start of the BB (after PHIs).
1014             BB->insert(BBBegin, DbgMI);
1015           else {
1016             // Insert at the instruction, which may be in a different
1017             // block, if the block was split by a custom inserter.
1018             MachineBasicBlock::iterator Pos = MI;
1019             MI->getParent()->insert(Pos, DbgMI);
1020           }
1021         }
1022       }
1023       if (DLI == DLE)
1024         break;
1025 
1026       LastOrder = Order;
1027     }
1028   }
1029 
1030   // Split after an INLINEASM_BR block with outputs. This allows us to keep the
1031   // copy to/from register instructions from being between two terminator
1032   // instructions, which causes the machine instruction verifier agita.
1033   auto TI = llvm::find_if(*BB, [](const MachineInstr &MI){
1034     return MI.getOpcode() == TargetOpcode::INLINEASM_BR;
1035   });
1036   auto SplicePt = TI != BB->end() ? std::next(TI) : BB->end();
1037   if (TI != BB->end() && SplicePt != BB->end() &&
1038       TI->getOpcode() == TargetOpcode::INLINEASM_BR &&
1039       SplicePt->getOpcode() == TargetOpcode::COPY) {
1040     MachineBasicBlock *FallThrough = BB->getFallThrough();
1041     if (!FallThrough)
1042       for (const MachineOperand &MO : BB->back().operands())
1043         if (MO.isMBB()) {
1044           FallThrough = MO.getMBB();
1045           break;
1046         }
1047     assert(FallThrough && "Cannot find default dest block for callbr!");
1048 
1049     MachineBasicBlock *CopyBB = MF.CreateMachineBasicBlock(BB->getBasicBlock());
1050     MachineFunction::iterator BBI(*BB);
1051     MF.insert(++BBI, CopyBB);
1052 
1053     CopyBB->splice(CopyBB->begin(), BB, SplicePt, BB->end());
1054     CopyBB->setInlineAsmBrDefaultTarget();
1055 
1056     CopyBB->addSuccessor(FallThrough, BranchProbability::getOne());
1057     BB->removeSuccessor(FallThrough);
1058     BB->addSuccessor(CopyBB, BranchProbability::getOne());
1059 
1060     // Mark all physical registers defined in the original block as being live
1061     // on entry to the copy block.
1062     for (const auto &MI : *CopyBB)
1063       for (const MachineOperand &MO : MI.operands())
1064         if (MO.isReg()) {
1065           Register reg = MO.getReg();
1066           if (Register::isPhysicalRegister(reg)) {
1067             CopyBB->addLiveIn(reg);
1068             break;
1069           }
1070         }
1071 
1072     CopyBB->normalizeSuccProbs();
1073     BB->normalizeSuccProbs();
1074 
1075     BB->transferInlineAsmBrIndirectTargets(CopyBB);
1076 
1077     InsertPos = CopyBB->end();
1078     return CopyBB;
1079   }
1080 
1081   InsertPos = Emitter.getInsertPos();
1082   return Emitter.getBlock();
1083 }
1084 
1085 /// Return the basic block label.
1086 std::string ScheduleDAGSDNodes::getDAGName() const {
1087   return "sunit-dag." + BB->getFullName();
1088 }
1089