libgo: add misc/cgo files
[official-gcc.git] / gcc / bb-reorder.c
blobc0386f4b37a504822a4f97afe715faa00ef1c02b
1 /* Basic block reordering routines for the GNU compiler.
2 Copyright (C) 2000-2017 Free Software Foundation, Inc.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify it
7 under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3, or (at your option)
9 any later version.
11 GCC is distributed in the hope that it will be useful, but WITHOUT
12 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
13 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
14 License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
20 /* This file contains the "reorder blocks" pass, which changes the control
21 flow of a function to encounter fewer branches; the "partition blocks"
22 pass, which divides the basic blocks into "hot" and "cold" partitions,
23 which are kept separate; and the "duplicate computed gotos" pass, which
24 duplicates blocks ending in an indirect jump.
26 There are two algorithms for "reorder blocks": the "simple" algorithm,
27 which just rearranges blocks, trying to minimize the number of executed
28 unconditional branches; and the "software trace cache" algorithm, which
29 also copies code, and in general tries a lot harder to have long linear
30 pieces of machine code executed. This algorithm is described next. */
32 /* This (greedy) algorithm constructs traces in several rounds.
33 The construction starts from "seeds". The seed for the first round
34 is the entry point of the function. When there are more than one seed,
35 the one with the lowest key in the heap is selected first (see bb_to_key).
36 Then the algorithm repeatedly adds the most probable successor to the end
37 of a trace. Finally it connects the traces.
39 There are two parameters: Branch Threshold and Exec Threshold.
40 If the probability of an edge to a successor of the current basic block is
41 lower than Branch Threshold or its frequency is lower than Exec Threshold,
42 then the successor will be the seed in one of the next rounds.
43 Each round has these parameters lower than the previous one.
44 The last round has to have these parameters set to zero so that the
45 remaining blocks are picked up.
47 The algorithm selects the most probable successor from all unvisited
48 successors and successors that have been added to this trace.
49 The other successors (that has not been "sent" to the next round) will be
50 other seeds for this round and the secondary traces will start from them.
51 If the successor has not been visited in this trace, it is added to the
52 trace (however, there is some heuristic for simple branches).
53 If the successor has been visited in this trace, a loop has been found.
54 If the loop has many iterations, the loop is rotated so that the source
55 block of the most probable edge going out of the loop is the last block
56 of the trace.
57 If the loop has few iterations and there is no edge from the last block of
58 the loop going out of the loop, the loop header is duplicated.
60 When connecting traces, the algorithm first checks whether there is an edge
61 from the last block of a trace to the first block of another trace.
62 When there are still some unconnected traces it checks whether there exists
63 a basic block BB such that BB is a successor of the last block of a trace
64 and BB is a predecessor of the first block of another trace. In this case,
65 BB is duplicated, added at the end of the first trace and the traces are
66 connected through it.
67 The rest of traces are simply connected so there will be a jump to the
68 beginning of the rest of traces.
70 The above description is for the full algorithm, which is used when the
71 function is optimized for speed. When the function is optimized for size,
72 in order to reduce long jumps and connect more fallthru edges, the
73 algorithm is modified as follows:
74 (1) Break long traces to short ones. A trace is broken at a block that has
75 multiple predecessors/ successors during trace discovery. When connecting
76 traces, only connect Trace n with Trace n + 1. This change reduces most
77 long jumps compared with the above algorithm.
78 (2) Ignore the edge probability and frequency for fallthru edges.
79 (3) Keep the original order of blocks when there is no chance to fall
80 through. We rely on the results of cfg_cleanup.
82 To implement the change for code size optimization, block's index is
83 selected as the key and all traces are found in one round.
85 References:
87 "Software Trace Cache"
88 A. Ramirez, J. Larriba-Pey, C. Navarro, J. Torrellas and M. Valero; 1999
89 http://citeseer.nj.nec.com/15361.html
93 #include "config.h"
94 #define INCLUDE_ALGORITHM /* stable_sort */
95 #include "system.h"
96 #include "coretypes.h"
97 #include "backend.h"
98 #include "target.h"
99 #include "rtl.h"
100 #include "tree.h"
101 #include "cfghooks.h"
102 #include "df.h"
103 #include "memmodel.h"
104 #include "optabs.h"
105 #include "regs.h"
106 #include "emit-rtl.h"
107 #include "output.h"
108 #include "expr.h"
109 #include "params.h"
110 #include "tree-pass.h"
111 #include "cfgrtl.h"
112 #include "cfganal.h"
113 #include "cfgbuild.h"
114 #include "cfgcleanup.h"
115 #include "bb-reorder.h"
116 #include "except.h"
117 #include "fibonacci_heap.h"
119 /* The number of rounds. In most cases there will only be 4 rounds, but
120 when partitioning hot and cold basic blocks into separate sections of
121 the object file there will be an extra round. */
122 #define N_ROUNDS 5
124 struct target_bb_reorder default_target_bb_reorder;
125 #if SWITCHABLE_TARGET
126 struct target_bb_reorder *this_target_bb_reorder = &default_target_bb_reorder;
127 #endif
129 #define uncond_jump_length \
130 (this_target_bb_reorder->x_uncond_jump_length)
132 /* Branch thresholds in thousandths (per mille) of the REG_BR_PROB_BASE. */
133 static const int branch_threshold[N_ROUNDS] = {400, 200, 100, 0, 0};
135 /* Exec thresholds in thousandths (per mille) of the frequency of bb 0. */
136 static const int exec_threshold[N_ROUNDS] = {500, 200, 50, 0, 0};
138 /* If edge frequency is lower than DUPLICATION_THRESHOLD per mille of entry
139 block the edge destination is not duplicated while connecting traces. */
140 #define DUPLICATION_THRESHOLD 100
142 typedef fibonacci_heap <long, basic_block_def> bb_heap_t;
143 typedef fibonacci_node <long, basic_block_def> bb_heap_node_t;
145 /* Structure to hold needed information for each basic block. */
146 struct bbro_basic_block_data
148 /* Which trace is the bb start of (-1 means it is not a start of any). */
149 int start_of_trace;
151 /* Which trace is the bb end of (-1 means it is not an end of any). */
152 int end_of_trace;
154 /* Which trace is the bb in? */
155 int in_trace;
157 /* Which trace was this bb visited in? */
158 int visited;
160 /* Cached maximum frequency of interesting incoming edges.
161 Minus one means not yet computed. */
162 int priority;
164 /* Which heap is BB in (if any)? */
165 bb_heap_t *heap;
167 /* Which heap node is BB in (if any)? */
168 bb_heap_node_t *node;
171 /* The current size of the following dynamic array. */
172 static int array_size;
174 /* The array which holds needed information for basic blocks. */
175 static bbro_basic_block_data *bbd;
177 /* To avoid frequent reallocation the size of arrays is greater than needed,
178 the number of elements is (not less than) 1.25 * size_wanted. */
179 #define GET_ARRAY_SIZE(X) ((((X) / 4) + 1) * 5)
181 /* Free the memory and set the pointer to NULL. */
182 #define FREE(P) (gcc_assert (P), free (P), P = 0)
184 /* Structure for holding information about a trace. */
185 struct trace
187 /* First and last basic block of the trace. */
188 basic_block first, last;
190 /* The round of the STC creation which this trace was found in. */
191 int round;
193 /* The length (i.e. the number of basic blocks) of the trace. */
194 int length;
197 /* Maximum frequency and count of one of the entry blocks. */
198 static int max_entry_frequency;
199 static profile_count max_entry_count;
201 /* Local function prototypes. */
202 static void find_traces (int *, struct trace *);
203 static basic_block rotate_loop (edge, struct trace *, int);
204 static void mark_bb_visited (basic_block, int);
205 static void find_traces_1_round (int, int, gcov_type, struct trace *, int *,
206 int, bb_heap_t **, int);
207 static basic_block copy_bb (basic_block, edge, basic_block, int);
208 static long bb_to_key (basic_block);
209 static bool better_edge_p (const_basic_block, const_edge, int, int, int, int,
210 const_edge);
211 static bool connect_better_edge_p (const_edge, bool, int, const_edge,
212 struct trace *);
213 static void connect_traces (int, struct trace *);
214 static bool copy_bb_p (const_basic_block, int);
215 static bool push_to_next_round_p (const_basic_block, int, int, int, gcov_type);
217 /* Return the trace number in which BB was visited. */
219 static int
220 bb_visited_trace (const_basic_block bb)
222 gcc_assert (bb->index < array_size);
223 return bbd[bb->index].visited;
226 /* This function marks BB that it was visited in trace number TRACE. */
228 static void
229 mark_bb_visited (basic_block bb, int trace)
231 bbd[bb->index].visited = trace;
232 if (bbd[bb->index].heap)
234 bbd[bb->index].heap->delete_node (bbd[bb->index].node);
235 bbd[bb->index].heap = NULL;
236 bbd[bb->index].node = NULL;
240 /* Check to see if bb should be pushed into the next round of trace
241 collections or not. Reasons for pushing the block forward are 1).
242 If the block is cold, we are doing partitioning, and there will be
243 another round (cold partition blocks are not supposed to be
244 collected into traces until the very last round); or 2). There will
245 be another round, and the basic block is not "hot enough" for the
246 current round of trace collection. */
248 static bool
249 push_to_next_round_p (const_basic_block bb, int round, int number_of_rounds,
250 int exec_th, gcov_type count_th)
252 bool there_exists_another_round;
253 bool block_not_hot_enough;
255 there_exists_another_round = round < number_of_rounds - 1;
257 block_not_hot_enough = (bb->frequency < exec_th
258 || bb->count < count_th
259 || probably_never_executed_bb_p (cfun, bb));
261 if (there_exists_another_round
262 && block_not_hot_enough)
263 return true;
264 else
265 return false;
268 /* Find the traces for Software Trace Cache. Chain each trace through
269 RBI()->next. Store the number of traces to N_TRACES and description of
270 traces to TRACES. */
272 static void
273 find_traces (int *n_traces, struct trace *traces)
275 int i;
276 int number_of_rounds;
277 edge e;
278 edge_iterator ei;
279 bb_heap_t *heap = new bb_heap_t (LONG_MIN);
281 /* Add one extra round of trace collection when partitioning hot/cold
282 basic blocks into separate sections. The last round is for all the
283 cold blocks (and ONLY the cold blocks). */
285 number_of_rounds = N_ROUNDS - 1;
287 /* Insert entry points of function into heap. */
288 max_entry_frequency = 0;
289 max_entry_count = profile_count::zero ();
290 FOR_EACH_EDGE (e, ei, ENTRY_BLOCK_PTR_FOR_FN (cfun)->succs)
292 bbd[e->dest->index].heap = heap;
293 bbd[e->dest->index].node = heap->insert (bb_to_key (e->dest), e->dest);
294 if (e->dest->frequency > max_entry_frequency)
295 max_entry_frequency = e->dest->frequency;
296 if (e->dest->count.initialized_p () && e->dest->count > max_entry_count)
297 max_entry_count = e->dest->count;
300 /* Find the traces. */
301 for (i = 0; i < number_of_rounds; i++)
303 gcov_type count_threshold;
305 if (dump_file)
306 fprintf (dump_file, "STC - round %d\n", i + 1);
308 if (max_entry_count < INT_MAX / 1000)
309 count_threshold = max_entry_count.to_gcov_type () * exec_threshold[i] / 1000;
310 else
311 count_threshold = max_entry_count.to_gcov_type () / 1000 * exec_threshold[i];
313 find_traces_1_round (REG_BR_PROB_BASE * branch_threshold[i] / 1000,
314 max_entry_frequency * exec_threshold[i] / 1000,
315 count_threshold, traces, n_traces, i, &heap,
316 number_of_rounds);
318 delete heap;
320 if (dump_file)
322 for (i = 0; i < *n_traces; i++)
324 basic_block bb;
325 fprintf (dump_file, "Trace %d (round %d): ", i + 1,
326 traces[i].round + 1);
327 for (bb = traces[i].first;
328 bb != traces[i].last;
329 bb = (basic_block) bb->aux)
330 fprintf (dump_file, "%d [%d] ", bb->index, bb->frequency);
331 fprintf (dump_file, "%d [%d]\n", bb->index, bb->frequency);
333 fflush (dump_file);
337 /* Rotate loop whose back edge is BACK_EDGE in the tail of trace TRACE
338 (with sequential number TRACE_N). */
340 static basic_block
341 rotate_loop (edge back_edge, struct trace *trace, int trace_n)
343 basic_block bb;
345 /* Information about the best end (end after rotation) of the loop. */
346 basic_block best_bb = NULL;
347 edge best_edge = NULL;
348 int best_freq = -1;
349 profile_count best_count = profile_count::uninitialized ();
350 /* The best edge is preferred when its destination is not visited yet
351 or is a start block of some trace. */
352 bool is_preferred = false;
354 /* Find the most frequent edge that goes out from current trace. */
355 bb = back_edge->dest;
358 edge e;
359 edge_iterator ei;
361 FOR_EACH_EDGE (e, ei, bb->succs)
362 if (e->dest != EXIT_BLOCK_PTR_FOR_FN (cfun)
363 && bb_visited_trace (e->dest) != trace_n
364 && (e->flags & EDGE_CAN_FALLTHRU)
365 && !(e->flags & EDGE_COMPLEX))
367 if (is_preferred)
369 /* The best edge is preferred. */
370 if (!bb_visited_trace (e->dest)
371 || bbd[e->dest->index].start_of_trace >= 0)
373 /* The current edge E is also preferred. */
374 int freq = EDGE_FREQUENCY (e);
375 if (freq > best_freq || e->count > best_count)
377 best_freq = freq;
378 if (e->count.initialized_p ())
379 best_count = e->count;
380 best_edge = e;
381 best_bb = bb;
385 else
387 if (!bb_visited_trace (e->dest)
388 || bbd[e->dest->index].start_of_trace >= 0)
390 /* The current edge E is preferred. */
391 is_preferred = true;
392 best_freq = EDGE_FREQUENCY (e);
393 best_count = e->count;
394 best_edge = e;
395 best_bb = bb;
397 else
399 int freq = EDGE_FREQUENCY (e);
400 if (!best_edge || freq > best_freq || e->count > best_count)
402 best_freq = freq;
403 best_count = e->count;
404 best_edge = e;
405 best_bb = bb;
410 bb = (basic_block) bb->aux;
412 while (bb != back_edge->dest);
414 if (best_bb)
416 /* Rotate the loop so that the BEST_EDGE goes out from the last block of
417 the trace. */
418 if (back_edge->dest == trace->first)
420 trace->first = (basic_block) best_bb->aux;
422 else
424 basic_block prev_bb;
426 for (prev_bb = trace->first;
427 prev_bb->aux != back_edge->dest;
428 prev_bb = (basic_block) prev_bb->aux)
430 prev_bb->aux = best_bb->aux;
432 /* Try to get rid of uncond jump to cond jump. */
433 if (single_succ_p (prev_bb))
435 basic_block header = single_succ (prev_bb);
437 /* Duplicate HEADER if it is a small block containing cond jump
438 in the end. */
439 if (any_condjump_p (BB_END (header)) && copy_bb_p (header, 0)
440 && !CROSSING_JUMP_P (BB_END (header)))
441 copy_bb (header, single_succ_edge (prev_bb), prev_bb, trace_n);
445 else
447 /* We have not found suitable loop tail so do no rotation. */
448 best_bb = back_edge->src;
450 best_bb->aux = NULL;
451 return best_bb;
454 /* One round of finding traces. Find traces for BRANCH_TH and EXEC_TH i.e. do
455 not include basic blocks whose probability is lower than BRANCH_TH or whose
456 frequency is lower than EXEC_TH into traces (or whose count is lower than
457 COUNT_TH). Store the new traces into TRACES and modify the number of
458 traces *N_TRACES. Set the round (which the trace belongs to) to ROUND.
459 The function expects starting basic blocks to be in *HEAP and will delete
460 *HEAP and store starting points for the next round into new *HEAP. */
462 static void
463 find_traces_1_round (int branch_th, int exec_th, gcov_type count_th,
464 struct trace *traces, int *n_traces, int round,
465 bb_heap_t **heap, int number_of_rounds)
467 /* Heap for discarded basic blocks which are possible starting points for
468 the next round. */
469 bb_heap_t *new_heap = new bb_heap_t (LONG_MIN);
470 bool for_size = optimize_function_for_size_p (cfun);
472 while (!(*heap)->empty ())
474 basic_block bb;
475 struct trace *trace;
476 edge best_edge, e;
477 long key;
478 edge_iterator ei;
480 bb = (*heap)->extract_min ();
481 bbd[bb->index].heap = NULL;
482 bbd[bb->index].node = NULL;
484 if (dump_file)
485 fprintf (dump_file, "Getting bb %d\n", bb->index);
487 /* If the BB's frequency is too low, send BB to the next round. When
488 partitioning hot/cold blocks into separate sections, make sure all
489 the cold blocks (and ONLY the cold blocks) go into the (extra) final
490 round. When optimizing for size, do not push to next round. */
492 if (!for_size
493 && push_to_next_round_p (bb, round, number_of_rounds, exec_th,
494 count_th))
496 int key = bb_to_key (bb);
497 bbd[bb->index].heap = new_heap;
498 bbd[bb->index].node = new_heap->insert (key, bb);
500 if (dump_file)
501 fprintf (dump_file,
502 " Possible start point of next round: %d (key: %d)\n",
503 bb->index, key);
504 continue;
507 trace = traces + *n_traces;
508 trace->first = bb;
509 trace->round = round;
510 trace->length = 0;
511 bbd[bb->index].in_trace = *n_traces;
512 (*n_traces)++;
516 int prob, freq;
517 bool ends_in_call;
519 /* The probability and frequency of the best edge. */
520 int best_prob = INT_MIN / 2;
521 int best_freq = INT_MIN / 2;
523 best_edge = NULL;
524 mark_bb_visited (bb, *n_traces);
525 trace->length++;
527 if (dump_file)
528 fprintf (dump_file, "Basic block %d was visited in trace %d\n",
529 bb->index, *n_traces - 1);
531 ends_in_call = block_ends_with_call_p (bb);
533 /* Select the successor that will be placed after BB. */
534 FOR_EACH_EDGE (e, ei, bb->succs)
536 gcc_assert (!(e->flags & EDGE_FAKE));
538 if (e->dest == EXIT_BLOCK_PTR_FOR_FN (cfun))
539 continue;
541 if (bb_visited_trace (e->dest)
542 && bb_visited_trace (e->dest) != *n_traces)
543 continue;
545 if (BB_PARTITION (e->dest) != BB_PARTITION (bb))
546 continue;
548 prob = e->probability;
549 freq = e->dest->frequency;
551 /* The only sensible preference for a call instruction is the
552 fallthru edge. Don't bother selecting anything else. */
553 if (ends_in_call)
555 if (e->flags & EDGE_CAN_FALLTHRU)
557 best_edge = e;
558 best_prob = prob;
559 best_freq = freq;
561 continue;
564 /* Edge that cannot be fallthru or improbable or infrequent
565 successor (i.e. it is unsuitable successor). When optimizing
566 for size, ignore the probability and frequency. */
567 if (!(e->flags & EDGE_CAN_FALLTHRU) || (e->flags & EDGE_COMPLEX)
568 || ((prob < branch_th || EDGE_FREQUENCY (e) < exec_th
569 || e->count < count_th) && (!for_size)))
570 continue;
572 /* If partitioning hot/cold basic blocks, don't consider edges
573 that cross section boundaries. */
575 if (better_edge_p (bb, e, prob, freq, best_prob, best_freq,
576 best_edge))
578 best_edge = e;
579 best_prob = prob;
580 best_freq = freq;
584 /* If the best destination has multiple predecessors, and can be
585 duplicated cheaper than a jump, don't allow it to be added
586 to a trace. We'll duplicate it when connecting traces. */
587 if (best_edge && EDGE_COUNT (best_edge->dest->preds) >= 2
588 && copy_bb_p (best_edge->dest, 0))
589 best_edge = NULL;
591 /* If the best destination has multiple successors or predecessors,
592 don't allow it to be added when optimizing for size. This makes
593 sure predecessors with smaller index are handled before the best
594 destinarion. It breaks long trace and reduces long jumps.
596 Take if-then-else as an example.
602 If we do not remove the best edge B->D/C->D, the final order might
603 be A B D ... C. C is at the end of the program. If D's successors
604 and D are complicated, might need long jumps for A->C and C->D.
605 Similar issue for order: A C D ... B.
607 After removing the best edge, the final result will be ABCD/ ACBD.
608 It does not add jump compared with the previous order. But it
609 reduces the possibility of long jumps. */
610 if (best_edge && for_size
611 && (EDGE_COUNT (best_edge->dest->succs) > 1
612 || EDGE_COUNT (best_edge->dest->preds) > 1))
613 best_edge = NULL;
615 /* Add all non-selected successors to the heaps. */
616 FOR_EACH_EDGE (e, ei, bb->succs)
618 if (e == best_edge
619 || e->dest == EXIT_BLOCK_PTR_FOR_FN (cfun)
620 || bb_visited_trace (e->dest))
621 continue;
623 key = bb_to_key (e->dest);
625 if (bbd[e->dest->index].heap)
627 /* E->DEST is already in some heap. */
628 if (key != bbd[e->dest->index].node->get_key ())
630 if (dump_file)
632 fprintf (dump_file,
633 "Changing key for bb %d from %ld to %ld.\n",
634 e->dest->index,
635 (long) bbd[e->dest->index].node->get_key (),
636 key);
638 bbd[e->dest->index].heap->replace_key
639 (bbd[e->dest->index].node, key);
642 else
644 bb_heap_t *which_heap = *heap;
646 prob = e->probability;
647 freq = EDGE_FREQUENCY (e);
649 if (!(e->flags & EDGE_CAN_FALLTHRU)
650 || (e->flags & EDGE_COMPLEX)
651 || prob < branch_th || freq < exec_th
652 || e->count < count_th)
654 /* When partitioning hot/cold basic blocks, make sure
655 the cold blocks (and only the cold blocks) all get
656 pushed to the last round of trace collection. When
657 optimizing for size, do not push to next round. */
659 if (!for_size && push_to_next_round_p (e->dest, round,
660 number_of_rounds,
661 exec_th, count_th))
662 which_heap = new_heap;
665 bbd[e->dest->index].heap = which_heap;
666 bbd[e->dest->index].node = which_heap->insert (key, e->dest);
668 if (dump_file)
670 fprintf (dump_file,
671 " Possible start of %s round: %d (key: %ld)\n",
672 (which_heap == new_heap) ? "next" : "this",
673 e->dest->index, (long) key);
679 if (best_edge) /* Suitable successor was found. */
681 if (bb_visited_trace (best_edge->dest) == *n_traces)
683 /* We do nothing with one basic block loops. */
684 if (best_edge->dest != bb)
686 if (EDGE_FREQUENCY (best_edge)
687 > 4 * best_edge->dest->frequency / 5)
689 /* The loop has at least 4 iterations. If the loop
690 header is not the first block of the function
691 we can rotate the loop. */
693 if (best_edge->dest
694 != ENTRY_BLOCK_PTR_FOR_FN (cfun)->next_bb)
696 if (dump_file)
698 fprintf (dump_file,
699 "Rotating loop %d - %d\n",
700 best_edge->dest->index, bb->index);
702 bb->aux = best_edge->dest;
703 bbd[best_edge->dest->index].in_trace =
704 (*n_traces) - 1;
705 bb = rotate_loop (best_edge, trace, *n_traces);
708 else
710 /* The loop has less than 4 iterations. */
712 if (single_succ_p (bb)
713 && copy_bb_p (best_edge->dest,
714 optimize_edge_for_speed_p
715 (best_edge)))
717 bb = copy_bb (best_edge->dest, best_edge, bb,
718 *n_traces);
719 trace->length++;
724 /* Terminate the trace. */
725 break;
727 else
729 /* Check for a situation
737 where
738 EDGE_FREQUENCY (AB) + EDGE_FREQUENCY (BC)
739 >= EDGE_FREQUENCY (AC).
740 (i.e. 2 * B->frequency >= EDGE_FREQUENCY (AC) )
741 Best ordering is then A B C.
743 When optimizing for size, A B C is always the best order.
745 This situation is created for example by:
747 if (A) B;
752 FOR_EACH_EDGE (e, ei, bb->succs)
753 if (e != best_edge
754 && (e->flags & EDGE_CAN_FALLTHRU)
755 && !(e->flags & EDGE_COMPLEX)
756 && !bb_visited_trace (e->dest)
757 && single_pred_p (e->dest)
758 && !(e->flags & EDGE_CROSSING)
759 && single_succ_p (e->dest)
760 && (single_succ_edge (e->dest)->flags
761 & EDGE_CAN_FALLTHRU)
762 && !(single_succ_edge (e->dest)->flags & EDGE_COMPLEX)
763 && single_succ (e->dest) == best_edge->dest
764 && (2 * e->dest->frequency >= EDGE_FREQUENCY (best_edge)
765 || for_size))
767 best_edge = e;
768 if (dump_file)
769 fprintf (dump_file, "Selecting BB %d\n",
770 best_edge->dest->index);
771 break;
774 bb->aux = best_edge->dest;
775 bbd[best_edge->dest->index].in_trace = (*n_traces) - 1;
776 bb = best_edge->dest;
780 while (best_edge);
781 trace->last = bb;
782 bbd[trace->first->index].start_of_trace = *n_traces - 1;
783 if (bbd[trace->last->index].end_of_trace != *n_traces - 1)
785 bbd[trace->last->index].end_of_trace = *n_traces - 1;
786 /* Update the cached maximum frequency for interesting predecessor
787 edges for successors of the new trace end. */
788 FOR_EACH_EDGE (e, ei, trace->last->succs)
789 if (EDGE_FREQUENCY (e) > bbd[e->dest->index].priority)
790 bbd[e->dest->index].priority = EDGE_FREQUENCY (e);
793 /* The trace is terminated so we have to recount the keys in heap
794 (some block can have a lower key because now one of its predecessors
795 is an end of the trace). */
796 FOR_EACH_EDGE (e, ei, bb->succs)
798 if (e->dest == EXIT_BLOCK_PTR_FOR_FN (cfun)
799 || bb_visited_trace (e->dest))
800 continue;
802 if (bbd[e->dest->index].heap)
804 key = bb_to_key (e->dest);
805 if (key != bbd[e->dest->index].node->get_key ())
807 if (dump_file)
809 fprintf (dump_file,
810 "Changing key for bb %d from %ld to %ld.\n",
811 e->dest->index,
812 (long) bbd[e->dest->index].node->get_key (), key);
814 bbd[e->dest->index].heap->replace_key
815 (bbd[e->dest->index].node, key);
821 delete (*heap);
823 /* "Return" the new heap. */
824 *heap = new_heap;
827 /* Create a duplicate of the basic block OLD_BB and redirect edge E to it, add
828 it to trace after BB, mark OLD_BB visited and update pass' data structures
829 (TRACE is a number of trace which OLD_BB is duplicated to). */
831 static basic_block
832 copy_bb (basic_block old_bb, edge e, basic_block bb, int trace)
834 basic_block new_bb;
836 new_bb = duplicate_block (old_bb, e, bb);
837 BB_COPY_PARTITION (new_bb, old_bb);
839 gcc_assert (e->dest == new_bb);
841 if (dump_file)
842 fprintf (dump_file,
843 "Duplicated bb %d (created bb %d)\n",
844 old_bb->index, new_bb->index);
846 if (new_bb->index >= array_size
847 || last_basic_block_for_fn (cfun) > array_size)
849 int i;
850 int new_size;
852 new_size = MAX (last_basic_block_for_fn (cfun), new_bb->index + 1);
853 new_size = GET_ARRAY_SIZE (new_size);
854 bbd = XRESIZEVEC (bbro_basic_block_data, bbd, new_size);
855 for (i = array_size; i < new_size; i++)
857 bbd[i].start_of_trace = -1;
858 bbd[i].end_of_trace = -1;
859 bbd[i].in_trace = -1;
860 bbd[i].visited = 0;
861 bbd[i].priority = -1;
862 bbd[i].heap = NULL;
863 bbd[i].node = NULL;
865 array_size = new_size;
867 if (dump_file)
869 fprintf (dump_file,
870 "Growing the dynamic array to %d elements.\n",
871 array_size);
875 gcc_assert (!bb_visited_trace (e->dest));
876 mark_bb_visited (new_bb, trace);
877 new_bb->aux = bb->aux;
878 bb->aux = new_bb;
880 bbd[new_bb->index].in_trace = trace;
882 return new_bb;
885 /* Compute and return the key (for the heap) of the basic block BB. */
887 static long
888 bb_to_key (basic_block bb)
890 edge e;
891 edge_iterator ei;
893 /* Use index as key to align with its original order. */
894 if (optimize_function_for_size_p (cfun))
895 return bb->index;
897 /* Do not start in probably never executed blocks. */
899 if (BB_PARTITION (bb) == BB_COLD_PARTITION
900 || probably_never_executed_bb_p (cfun, bb))
901 return BB_FREQ_MAX;
903 /* Prefer blocks whose predecessor is an end of some trace
904 or whose predecessor edge is EDGE_DFS_BACK. */
905 int priority = bbd[bb->index].priority;
906 if (priority == -1)
908 priority = 0;
909 FOR_EACH_EDGE (e, ei, bb->preds)
911 if ((e->src != ENTRY_BLOCK_PTR_FOR_FN (cfun)
912 && bbd[e->src->index].end_of_trace >= 0)
913 || (e->flags & EDGE_DFS_BACK))
915 int edge_freq = EDGE_FREQUENCY (e);
917 if (edge_freq > priority)
918 priority = edge_freq;
921 bbd[bb->index].priority = priority;
924 if (priority)
925 /* The block with priority should have significantly lower key. */
926 return -(100 * BB_FREQ_MAX + 100 * priority + bb->frequency);
928 return -bb->frequency;
931 /* Return true when the edge E from basic block BB is better than the temporary
932 best edge (details are in function). The probability of edge E is PROB. The
933 frequency of the successor is FREQ. The current best probability is
934 BEST_PROB, the best frequency is BEST_FREQ.
935 The edge is considered to be equivalent when PROB does not differ much from
936 BEST_PROB; similarly for frequency. */
938 static bool
939 better_edge_p (const_basic_block bb, const_edge e, int prob, int freq,
940 int best_prob, int best_freq, const_edge cur_best_edge)
942 bool is_better_edge;
944 /* The BEST_* values do not have to be best, but can be a bit smaller than
945 maximum values. */
946 int diff_prob = best_prob / 10;
947 int diff_freq = best_freq / 10;
949 /* The smaller one is better to keep the original order. */
950 if (optimize_function_for_size_p (cfun))
951 return !cur_best_edge
952 || cur_best_edge->dest->index > e->dest->index;
954 if (prob > best_prob + diff_prob)
955 /* The edge has higher probability than the temporary best edge. */
956 is_better_edge = true;
957 else if (prob < best_prob - diff_prob)
958 /* The edge has lower probability than the temporary best edge. */
959 is_better_edge = false;
960 else if (freq < best_freq - diff_freq)
961 /* The edge and the temporary best edge have almost equivalent
962 probabilities. The higher frequency of a successor now means
963 that there is another edge going into that successor.
964 This successor has lower frequency so it is better. */
965 is_better_edge = true;
966 else if (freq > best_freq + diff_freq)
967 /* This successor has higher frequency so it is worse. */
968 is_better_edge = false;
969 else if (e->dest->prev_bb == bb)
970 /* The edges have equivalent probabilities and the successors
971 have equivalent frequencies. Select the previous successor. */
972 is_better_edge = true;
973 else
974 is_better_edge = false;
976 /* If we are doing hot/cold partitioning, make sure that we always favor
977 non-crossing edges over crossing edges. */
979 if (!is_better_edge
980 && flag_reorder_blocks_and_partition
981 && cur_best_edge
982 && (cur_best_edge->flags & EDGE_CROSSING)
983 && !(e->flags & EDGE_CROSSING))
984 is_better_edge = true;
986 return is_better_edge;
989 /* Return true when the edge E is better than the temporary best edge
990 CUR_BEST_EDGE. If SRC_INDEX_P is true, the function compares the src bb of
991 E and CUR_BEST_EDGE; otherwise it will compare the dest bb.
992 BEST_LEN is the trace length of src (or dest) bb in CUR_BEST_EDGE.
993 TRACES record the information about traces.
994 When optimizing for size, the edge with smaller index is better.
995 When optimizing for speed, the edge with bigger probability or longer trace
996 is better. */
998 static bool
999 connect_better_edge_p (const_edge e, bool src_index_p, int best_len,
1000 const_edge cur_best_edge, struct trace *traces)
1002 int e_index;
1003 int b_index;
1004 bool is_better_edge;
1006 if (!cur_best_edge)
1007 return true;
1009 if (optimize_function_for_size_p (cfun))
1011 e_index = src_index_p ? e->src->index : e->dest->index;
1012 b_index = src_index_p ? cur_best_edge->src->index
1013 : cur_best_edge->dest->index;
1014 /* The smaller one is better to keep the original order. */
1015 return b_index > e_index;
1018 if (src_index_p)
1020 e_index = e->src->index;
1022 if (e->probability > cur_best_edge->probability)
1023 /* The edge has higher probability than the temporary best edge. */
1024 is_better_edge = true;
1025 else if (e->probability < cur_best_edge->probability)
1026 /* The edge has lower probability than the temporary best edge. */
1027 is_better_edge = false;
1028 else if (traces[bbd[e_index].end_of_trace].length > best_len)
1029 /* The edge and the temporary best edge have equivalent probabilities.
1030 The edge with longer trace is better. */
1031 is_better_edge = true;
1032 else
1033 is_better_edge = false;
1035 else
1037 e_index = e->dest->index;
1039 if (e->probability > cur_best_edge->probability)
1040 /* The edge has higher probability than the temporary best edge. */
1041 is_better_edge = true;
1042 else if (e->probability < cur_best_edge->probability)
1043 /* The edge has lower probability than the temporary best edge. */
1044 is_better_edge = false;
1045 else if (traces[bbd[e_index].start_of_trace].length > best_len)
1046 /* The edge and the temporary best edge have equivalent probabilities.
1047 The edge with longer trace is better. */
1048 is_better_edge = true;
1049 else
1050 is_better_edge = false;
1053 return is_better_edge;
1056 /* Connect traces in array TRACES, N_TRACES is the count of traces. */
1058 static void
1059 connect_traces (int n_traces, struct trace *traces)
1061 int i;
1062 bool *connected;
1063 bool two_passes;
1064 int last_trace;
1065 int current_pass;
1066 int current_partition;
1067 int freq_threshold;
1068 gcov_type count_threshold;
1069 bool for_size = optimize_function_for_size_p (cfun);
1071 freq_threshold = max_entry_frequency * DUPLICATION_THRESHOLD / 1000;
1072 if (max_entry_count.to_gcov_type () < INT_MAX / 1000)
1073 count_threshold = max_entry_count.to_gcov_type () * DUPLICATION_THRESHOLD / 1000;
1074 else
1075 count_threshold = max_entry_count.to_gcov_type () / 1000 * DUPLICATION_THRESHOLD;
1077 connected = XCNEWVEC (bool, n_traces);
1078 last_trace = -1;
1079 current_pass = 1;
1080 current_partition = BB_PARTITION (traces[0].first);
1081 two_passes = false;
1083 if (crtl->has_bb_partition)
1084 for (i = 0; i < n_traces && !two_passes; i++)
1085 if (BB_PARTITION (traces[0].first)
1086 != BB_PARTITION (traces[i].first))
1087 two_passes = true;
1089 for (i = 0; i < n_traces || (two_passes && current_pass == 1) ; i++)
1091 int t = i;
1092 int t2;
1093 edge e, best;
1094 int best_len;
1096 if (i >= n_traces)
1098 gcc_assert (two_passes && current_pass == 1);
1099 i = 0;
1100 t = i;
1101 current_pass = 2;
1102 if (current_partition == BB_HOT_PARTITION)
1103 current_partition = BB_COLD_PARTITION;
1104 else
1105 current_partition = BB_HOT_PARTITION;
1108 if (connected[t])
1109 continue;
1111 if (two_passes
1112 && BB_PARTITION (traces[t].first) != current_partition)
1113 continue;
1115 connected[t] = true;
1117 /* Find the predecessor traces. */
1118 for (t2 = t; t2 > 0;)
1120 edge_iterator ei;
1121 best = NULL;
1122 best_len = 0;
1123 FOR_EACH_EDGE (e, ei, traces[t2].first->preds)
1125 int si = e->src->index;
1127 if (e->src != ENTRY_BLOCK_PTR_FOR_FN (cfun)
1128 && (e->flags & EDGE_CAN_FALLTHRU)
1129 && !(e->flags & EDGE_COMPLEX)
1130 && bbd[si].end_of_trace >= 0
1131 && !connected[bbd[si].end_of_trace]
1132 && (BB_PARTITION (e->src) == current_partition)
1133 && connect_better_edge_p (e, true, best_len, best, traces))
1135 best = e;
1136 best_len = traces[bbd[si].end_of_trace].length;
1139 if (best)
1141 best->src->aux = best->dest;
1142 t2 = bbd[best->src->index].end_of_trace;
1143 connected[t2] = true;
1145 if (dump_file)
1147 fprintf (dump_file, "Connection: %d %d\n",
1148 best->src->index, best->dest->index);
1151 else
1152 break;
1155 if (last_trace >= 0)
1156 traces[last_trace].last->aux = traces[t2].first;
1157 last_trace = t;
1159 /* Find the successor traces. */
1160 while (1)
1162 /* Find the continuation of the chain. */
1163 edge_iterator ei;
1164 best = NULL;
1165 best_len = 0;
1166 FOR_EACH_EDGE (e, ei, traces[t].last->succs)
1168 int di = e->dest->index;
1170 if (e->dest != EXIT_BLOCK_PTR_FOR_FN (cfun)
1171 && (e->flags & EDGE_CAN_FALLTHRU)
1172 && !(e->flags & EDGE_COMPLEX)
1173 && bbd[di].start_of_trace >= 0
1174 && !connected[bbd[di].start_of_trace]
1175 && (BB_PARTITION (e->dest) == current_partition)
1176 && connect_better_edge_p (e, false, best_len, best, traces))
1178 best = e;
1179 best_len = traces[bbd[di].start_of_trace].length;
1183 if (for_size)
1185 if (!best)
1186 /* Stop finding the successor traces. */
1187 break;
1189 /* It is OK to connect block n with block n + 1 or a block
1190 before n. For others, only connect to the loop header. */
1191 if (best->dest->index > (traces[t].last->index + 1))
1193 int count = EDGE_COUNT (best->dest->preds);
1195 FOR_EACH_EDGE (e, ei, best->dest->preds)
1196 if (e->flags & EDGE_DFS_BACK)
1197 count--;
1199 /* If dest has multiple predecessors, skip it. We expect
1200 that one predecessor with smaller index connects with it
1201 later. */
1202 if (count != 1)
1203 break;
1206 /* Only connect Trace n with Trace n + 1. It is conservative
1207 to keep the order as close as possible to the original order.
1208 It also helps to reduce long jumps. */
1209 if (last_trace != bbd[best->dest->index].start_of_trace - 1)
1210 break;
1212 if (dump_file)
1213 fprintf (dump_file, "Connection: %d %d\n",
1214 best->src->index, best->dest->index);
1216 t = bbd[best->dest->index].start_of_trace;
1217 traces[last_trace].last->aux = traces[t].first;
1218 connected[t] = true;
1219 last_trace = t;
1221 else if (best)
1223 if (dump_file)
1225 fprintf (dump_file, "Connection: %d %d\n",
1226 best->src->index, best->dest->index);
1228 t = bbd[best->dest->index].start_of_trace;
1229 traces[last_trace].last->aux = traces[t].first;
1230 connected[t] = true;
1231 last_trace = t;
1233 else
1235 /* Try to connect the traces by duplication of 1 block. */
1236 edge e2;
1237 basic_block next_bb = NULL;
1238 bool try_copy = false;
1240 FOR_EACH_EDGE (e, ei, traces[t].last->succs)
1241 if (e->dest != EXIT_BLOCK_PTR_FOR_FN (cfun)
1242 && (e->flags & EDGE_CAN_FALLTHRU)
1243 && !(e->flags & EDGE_COMPLEX)
1244 && (!best || e->probability > best->probability))
1246 edge_iterator ei;
1247 edge best2 = NULL;
1248 int best2_len = 0;
1250 /* If the destination is a start of a trace which is only
1251 one block long, then no need to search the successor
1252 blocks of the trace. Accept it. */
1253 if (bbd[e->dest->index].start_of_trace >= 0
1254 && traces[bbd[e->dest->index].start_of_trace].length
1255 == 1)
1257 best = e;
1258 try_copy = true;
1259 continue;
1262 FOR_EACH_EDGE (e2, ei, e->dest->succs)
1264 int di = e2->dest->index;
1266 if (e2->dest == EXIT_BLOCK_PTR_FOR_FN (cfun)
1267 || ((e2->flags & EDGE_CAN_FALLTHRU)
1268 && !(e2->flags & EDGE_COMPLEX)
1269 && bbd[di].start_of_trace >= 0
1270 && !connected[bbd[di].start_of_trace]
1271 && BB_PARTITION (e2->dest) == current_partition
1272 && EDGE_FREQUENCY (e2) >= freq_threshold
1273 && e2->count >= count_threshold
1274 && (!best2
1275 || e2->probability > best2->probability
1276 || (e2->probability == best2->probability
1277 && traces[bbd[di].start_of_trace].length
1278 > best2_len))))
1280 best = e;
1281 best2 = e2;
1282 if (e2->dest != EXIT_BLOCK_PTR_FOR_FN (cfun))
1283 best2_len = traces[bbd[di].start_of_trace].length;
1284 else
1285 best2_len = INT_MAX;
1286 next_bb = e2->dest;
1287 try_copy = true;
1292 if (crtl->has_bb_partition)
1293 try_copy = false;
1295 /* Copy tiny blocks always; copy larger blocks only when the
1296 edge is traversed frequently enough. */
1297 if (try_copy
1298 && copy_bb_p (best->dest,
1299 optimize_edge_for_speed_p (best)
1300 && EDGE_FREQUENCY (best) >= freq_threshold
1301 && best->count >= count_threshold))
1303 basic_block new_bb;
1305 if (dump_file)
1307 fprintf (dump_file, "Connection: %d %d ",
1308 traces[t].last->index, best->dest->index);
1309 if (!next_bb)
1310 fputc ('\n', dump_file);
1311 else if (next_bb == EXIT_BLOCK_PTR_FOR_FN (cfun))
1312 fprintf (dump_file, "exit\n");
1313 else
1314 fprintf (dump_file, "%d\n", next_bb->index);
1317 new_bb = copy_bb (best->dest, best, traces[t].last, t);
1318 traces[t].last = new_bb;
1319 if (next_bb && next_bb != EXIT_BLOCK_PTR_FOR_FN (cfun))
1321 t = bbd[next_bb->index].start_of_trace;
1322 traces[last_trace].last->aux = traces[t].first;
1323 connected[t] = true;
1324 last_trace = t;
1326 else
1327 break; /* Stop finding the successor traces. */
1329 else
1330 break; /* Stop finding the successor traces. */
1335 if (dump_file)
1337 basic_block bb;
1339 fprintf (dump_file, "Final order:\n");
1340 for (bb = traces[0].first; bb; bb = (basic_block) bb->aux)
1341 fprintf (dump_file, "%d ", bb->index);
1342 fprintf (dump_file, "\n");
1343 fflush (dump_file);
1346 FREE (connected);
1349 /* Return true when BB can and should be copied. CODE_MAY_GROW is true
1350 when code size is allowed to grow by duplication. */
1352 static bool
1353 copy_bb_p (const_basic_block bb, int code_may_grow)
1355 int size = 0;
1356 int max_size = uncond_jump_length;
1357 rtx_insn *insn;
1359 if (!bb->frequency)
1360 return false;
1361 if (EDGE_COUNT (bb->preds) < 2)
1362 return false;
1363 if (!can_duplicate_block_p (bb))
1364 return false;
1366 /* Avoid duplicating blocks which have many successors (PR/13430). */
1367 if (EDGE_COUNT (bb->succs) > 8)
1368 return false;
1370 if (code_may_grow && optimize_bb_for_speed_p (bb))
1371 max_size *= PARAM_VALUE (PARAM_MAX_GROW_COPY_BB_INSNS);
1373 FOR_BB_INSNS (bb, insn)
1375 if (INSN_P (insn))
1376 size += get_attr_min_length (insn);
1379 if (size <= max_size)
1380 return true;
1382 if (dump_file)
1384 fprintf (dump_file,
1385 "Block %d can't be copied because its size = %d.\n",
1386 bb->index, size);
1389 return false;
1392 /* Return the length of unconditional jump instruction. */
1395 get_uncond_jump_length (void)
1397 int length;
1399 start_sequence ();
1400 rtx_code_label *label = emit_label (gen_label_rtx ());
1401 rtx_insn *jump = emit_jump_insn (targetm.gen_jump (label));
1402 length = get_attr_min_length (jump);
1403 end_sequence ();
1405 return length;
1408 /* The landing pad OLD_LP, in block OLD_BB, has edges from both partitions.
1409 Duplicate the landing pad and split the edges so that no EH edge
1410 crosses partitions. */
1412 static void
1413 fix_up_crossing_landing_pad (eh_landing_pad old_lp, basic_block old_bb)
1415 eh_landing_pad new_lp;
1416 basic_block new_bb, last_bb, post_bb;
1417 rtx_insn *jump;
1418 unsigned new_partition;
1419 edge_iterator ei;
1420 edge e;
1422 /* Generate the new landing-pad structure. */
1423 new_lp = gen_eh_landing_pad (old_lp->region);
1424 new_lp->post_landing_pad = old_lp->post_landing_pad;
1425 new_lp->landing_pad = gen_label_rtx ();
1426 LABEL_PRESERVE_P (new_lp->landing_pad) = 1;
1428 /* Put appropriate instructions in new bb. */
1429 rtx_code_label *new_label = emit_label (new_lp->landing_pad);
1431 expand_dw2_landing_pad_for_region (old_lp->region);
1433 post_bb = BLOCK_FOR_INSN (old_lp->landing_pad);
1434 post_bb = single_succ (post_bb);
1435 rtx_code_label *post_label = block_label (post_bb);
1436 jump = emit_jump_insn (targetm.gen_jump (post_label));
1437 JUMP_LABEL (jump) = post_label;
1439 /* Create new basic block to be dest for lp. */
1440 last_bb = EXIT_BLOCK_PTR_FOR_FN (cfun)->prev_bb;
1441 new_bb = create_basic_block (new_label, jump, last_bb);
1442 new_bb->aux = last_bb->aux;
1443 last_bb->aux = new_bb;
1445 emit_barrier_after_bb (new_bb);
1447 make_edge (new_bb, post_bb, 0);
1449 /* Make sure new bb is in the other partition. */
1450 new_partition = BB_PARTITION (old_bb);
1451 new_partition ^= BB_HOT_PARTITION | BB_COLD_PARTITION;
1452 BB_SET_PARTITION (new_bb, new_partition);
1454 /* Fix up the edges. */
1455 for (ei = ei_start (old_bb->preds); (e = ei_safe_edge (ei)) != NULL; )
1456 if (BB_PARTITION (e->src) == new_partition)
1458 rtx_insn *insn = BB_END (e->src);
1459 rtx note = find_reg_note (insn, REG_EH_REGION, NULL_RTX);
1461 gcc_assert (note != NULL);
1462 gcc_checking_assert (INTVAL (XEXP (note, 0)) == old_lp->index);
1463 XEXP (note, 0) = GEN_INT (new_lp->index);
1465 /* Adjust the edge to the new destination. */
1466 redirect_edge_succ (e, new_bb);
1468 else
1469 ei_next (&ei);
1473 /* Ensure that all hot bbs are included in a hot path through the
1474 procedure. This is done by calling this function twice, once
1475 with WALK_UP true (to look for paths from the entry to hot bbs) and
1476 once with WALK_UP false (to look for paths from hot bbs to the exit).
1477 Returns the updated value of COLD_BB_COUNT and adds newly-hot bbs
1478 to BBS_IN_HOT_PARTITION. */
1480 static unsigned int
1481 sanitize_hot_paths (bool walk_up, unsigned int cold_bb_count,
1482 vec<basic_block> *bbs_in_hot_partition)
1484 /* Callers check this. */
1485 gcc_checking_assert (cold_bb_count);
1487 /* Keep examining hot bbs while we still have some left to check
1488 and there are remaining cold bbs. */
1489 vec<basic_block> hot_bbs_to_check = bbs_in_hot_partition->copy ();
1490 while (! hot_bbs_to_check.is_empty ()
1491 && cold_bb_count)
1493 basic_block bb = hot_bbs_to_check.pop ();
1494 vec<edge, va_gc> *edges = walk_up ? bb->preds : bb->succs;
1495 edge e;
1496 edge_iterator ei;
1497 int highest_probability = 0;
1498 int highest_freq = 0;
1499 profile_count highest_count = profile_count::uninitialized ();
1500 bool found = false;
1502 /* Walk the preds/succs and check if there is at least one already
1503 marked hot. Keep track of the most frequent pred/succ so that we
1504 can mark it hot if we don't find one. */
1505 FOR_EACH_EDGE (e, ei, edges)
1507 basic_block reach_bb = walk_up ? e->src : e->dest;
1509 if (e->flags & EDGE_DFS_BACK)
1510 continue;
1512 if (BB_PARTITION (reach_bb) != BB_COLD_PARTITION)
1514 found = true;
1515 break;
1517 /* The following loop will look for the hottest edge via
1518 the edge count, if it is non-zero, then fallback to the edge
1519 frequency and finally the edge probability. */
1520 if (e->count > highest_count)
1521 highest_count = e->count;
1522 int edge_freq = EDGE_FREQUENCY (e);
1523 if (edge_freq > highest_freq)
1524 highest_freq = edge_freq;
1525 if (e->probability > highest_probability)
1526 highest_probability = e->probability;
1529 /* If bb is reached by (or reaches, in the case of !WALK_UP) another hot
1530 block (or unpartitioned, e.g. the entry block) then it is ok. If not,
1531 then the most frequent pred (or succ) needs to be adjusted. In the
1532 case where multiple preds/succs have the same frequency (e.g. a
1533 50-50 branch), then both will be adjusted. */
1534 if (found)
1535 continue;
1537 FOR_EACH_EDGE (e, ei, edges)
1539 if (e->flags & EDGE_DFS_BACK)
1540 continue;
1541 /* Select the hottest edge using the edge count, if it is non-zero,
1542 then fallback to the edge frequency and finally the edge
1543 probability. */
1544 if (highest_count > 0)
1546 if (e->count < highest_count)
1547 continue;
1549 else if (highest_freq)
1551 if (EDGE_FREQUENCY (e) < highest_freq)
1552 continue;
1554 else if (e->probability < highest_probability)
1555 continue;
1557 basic_block reach_bb = walk_up ? e->src : e->dest;
1559 /* We have a hot bb with an immediate dominator that is cold.
1560 The dominator needs to be re-marked hot. */
1561 BB_SET_PARTITION (reach_bb, BB_HOT_PARTITION);
1562 cold_bb_count--;
1564 /* Now we need to examine newly-hot reach_bb to see if it is also
1565 dominated by a cold bb. */
1566 bbs_in_hot_partition->safe_push (reach_bb);
1567 hot_bbs_to_check.safe_push (reach_bb);
1571 return cold_bb_count;
1575 /* Find the basic blocks that are rarely executed and need to be moved to
1576 a separate section of the .o file (to cut down on paging and improve
1577 cache locality). Return a vector of all edges that cross. */
1579 static vec<edge>
1580 find_rarely_executed_basic_blocks_and_crossing_edges (void)
1582 vec<edge> crossing_edges = vNULL;
1583 basic_block bb;
1584 edge e;
1585 edge_iterator ei;
1586 unsigned int cold_bb_count = 0;
1587 auto_vec<basic_block> bbs_in_hot_partition;
1589 /* Mark which partition (hot/cold) each basic block belongs in. */
1590 FOR_EACH_BB_FN (bb, cfun)
1592 bool cold_bb = false;
1594 if (probably_never_executed_bb_p (cfun, bb))
1596 /* Handle profile insanities created by upstream optimizations
1597 by also checking the incoming edge weights. If there is a non-cold
1598 incoming edge, conservatively prevent this block from being split
1599 into the cold section. */
1600 cold_bb = true;
1601 FOR_EACH_EDGE (e, ei, bb->preds)
1602 if (!probably_never_executed_edge_p (cfun, e))
1604 cold_bb = false;
1605 break;
1608 if (cold_bb)
1610 BB_SET_PARTITION (bb, BB_COLD_PARTITION);
1611 cold_bb_count++;
1613 else
1615 BB_SET_PARTITION (bb, BB_HOT_PARTITION);
1616 bbs_in_hot_partition.safe_push (bb);
1620 /* Ensure that hot bbs are included along a hot path from the entry to exit.
1621 Several different possibilities may include cold bbs along all paths
1622 to/from a hot bb. One is that there are edge weight insanities
1623 due to optimization phases that do not properly update basic block profile
1624 counts. The second is that the entry of the function may not be hot, because
1625 it is entered fewer times than the number of profile training runs, but there
1626 is a loop inside the function that causes blocks within the function to be
1627 above the threshold for hotness. This is fixed by walking up from hot bbs
1628 to the entry block, and then down from hot bbs to the exit, performing
1629 partitioning fixups as necessary. */
1630 if (cold_bb_count)
1632 mark_dfs_back_edges ();
1633 cold_bb_count = sanitize_hot_paths (true, cold_bb_count,
1634 &bbs_in_hot_partition);
1635 if (cold_bb_count)
1636 sanitize_hot_paths (false, cold_bb_count, &bbs_in_hot_partition);
1639 /* The format of .gcc_except_table does not allow landing pads to
1640 be in a different partition as the throw. Fix this by either
1641 moving or duplicating the landing pads. */
1642 if (cfun->eh->lp_array)
1644 unsigned i;
1645 eh_landing_pad lp;
1647 FOR_EACH_VEC_ELT (*cfun->eh->lp_array, i, lp)
1649 bool all_same, all_diff;
1651 if (lp == NULL
1652 || lp->landing_pad == NULL_RTX
1653 || !LABEL_P (lp->landing_pad))
1654 continue;
1656 all_same = all_diff = true;
1657 bb = BLOCK_FOR_INSN (lp->landing_pad);
1658 FOR_EACH_EDGE (e, ei, bb->preds)
1660 gcc_assert (e->flags & EDGE_EH);
1661 if (BB_PARTITION (bb) == BB_PARTITION (e->src))
1662 all_diff = false;
1663 else
1664 all_same = false;
1667 if (all_same)
1669 else if (all_diff)
1671 int which = BB_PARTITION (bb);
1672 which ^= BB_HOT_PARTITION | BB_COLD_PARTITION;
1673 BB_SET_PARTITION (bb, which);
1675 else
1676 fix_up_crossing_landing_pad (lp, bb);
1680 /* Mark every edge that crosses between sections. */
1682 FOR_EACH_BB_FN (bb, cfun)
1683 FOR_EACH_EDGE (e, ei, bb->succs)
1685 unsigned int flags = e->flags;
1687 /* We should never have EDGE_CROSSING set yet. */
1688 gcc_checking_assert ((flags & EDGE_CROSSING) == 0);
1690 if (e->src != ENTRY_BLOCK_PTR_FOR_FN (cfun)
1691 && e->dest != EXIT_BLOCK_PTR_FOR_FN (cfun)
1692 && BB_PARTITION (e->src) != BB_PARTITION (e->dest))
1694 crossing_edges.safe_push (e);
1695 flags |= EDGE_CROSSING;
1698 /* Now that we've split eh edges as appropriate, allow landing pads
1699 to be merged with the post-landing pads. */
1700 flags &= ~EDGE_PRESERVE;
1702 e->flags = flags;
1705 return crossing_edges;
1708 /* Set the flag EDGE_CAN_FALLTHRU for edges that can be fallthru. */
1710 static void
1711 set_edge_can_fallthru_flag (void)
1713 basic_block bb;
1715 FOR_EACH_BB_FN (bb, cfun)
1717 edge e;
1718 edge_iterator ei;
1720 FOR_EACH_EDGE (e, ei, bb->succs)
1722 e->flags &= ~EDGE_CAN_FALLTHRU;
1724 /* The FALLTHRU edge is also CAN_FALLTHRU edge. */
1725 if (e->flags & EDGE_FALLTHRU)
1726 e->flags |= EDGE_CAN_FALLTHRU;
1729 /* If the BB ends with an invertible condjump all (2) edges are
1730 CAN_FALLTHRU edges. */
1731 if (EDGE_COUNT (bb->succs) != 2)
1732 continue;
1733 if (!any_condjump_p (BB_END (bb)))
1734 continue;
1736 rtx_jump_insn *bb_end_jump = as_a <rtx_jump_insn *> (BB_END (bb));
1737 if (!invert_jump (bb_end_jump, JUMP_LABEL (bb_end_jump), 0))
1738 continue;
1739 invert_jump (bb_end_jump, JUMP_LABEL (bb_end_jump), 0);
1740 EDGE_SUCC (bb, 0)->flags |= EDGE_CAN_FALLTHRU;
1741 EDGE_SUCC (bb, 1)->flags |= EDGE_CAN_FALLTHRU;
1745 /* If any destination of a crossing edge does not have a label, add label;
1746 Convert any easy fall-through crossing edges to unconditional jumps. */
1748 static void
1749 add_labels_and_missing_jumps (vec<edge> crossing_edges)
1751 size_t i;
1752 edge e;
1754 FOR_EACH_VEC_ELT (crossing_edges, i, e)
1756 basic_block src = e->src;
1757 basic_block dest = e->dest;
1758 rtx_jump_insn *new_jump;
1760 if (dest == EXIT_BLOCK_PTR_FOR_FN (cfun))
1761 continue;
1763 /* Make sure dest has a label. */
1764 rtx_code_label *label = block_label (dest);
1766 /* Nothing to do for non-fallthru edges. */
1767 if (src == ENTRY_BLOCK_PTR_FOR_FN (cfun))
1768 continue;
1769 if ((e->flags & EDGE_FALLTHRU) == 0)
1770 continue;
1772 /* If the block does not end with a control flow insn, then we
1773 can trivially add a jump to the end to fixup the crossing.
1774 Otherwise the jump will have to go in a new bb, which will
1775 be handled by fix_up_fall_thru_edges function. */
1776 if (control_flow_insn_p (BB_END (src)))
1777 continue;
1779 /* Make sure there's only one successor. */
1780 gcc_assert (single_succ_p (src));
1782 new_jump = emit_jump_insn_after (targetm.gen_jump (label), BB_END (src));
1783 BB_END (src) = new_jump;
1784 JUMP_LABEL (new_jump) = label;
1785 LABEL_NUSES (label) += 1;
1787 emit_barrier_after_bb (src);
1789 /* Mark edge as non-fallthru. */
1790 e->flags &= ~EDGE_FALLTHRU;
1794 /* Find any bb's where the fall-through edge is a crossing edge (note that
1795 these bb's must also contain a conditional jump or end with a call
1796 instruction; we've already dealt with fall-through edges for blocks
1797 that didn't have a conditional jump or didn't end with call instruction
1798 in the call to add_labels_and_missing_jumps). Convert the fall-through
1799 edge to non-crossing edge by inserting a new bb to fall-through into.
1800 The new bb will contain an unconditional jump (crossing edge) to the
1801 original fall through destination. */
1803 static void
1804 fix_up_fall_thru_edges (void)
1806 basic_block cur_bb;
1807 basic_block new_bb;
1808 edge succ1;
1809 edge succ2;
1810 edge fall_thru;
1811 edge cond_jump = NULL;
1812 bool cond_jump_crosses;
1813 int invert_worked;
1814 rtx_insn *old_jump;
1815 rtx_code_label *fall_thru_label;
1817 FOR_EACH_BB_FN (cur_bb, cfun)
1819 fall_thru = NULL;
1820 if (EDGE_COUNT (cur_bb->succs) > 0)
1821 succ1 = EDGE_SUCC (cur_bb, 0);
1822 else
1823 succ1 = NULL;
1825 if (EDGE_COUNT (cur_bb->succs) > 1)
1826 succ2 = EDGE_SUCC (cur_bb, 1);
1827 else
1828 succ2 = NULL;
1830 /* Find the fall-through edge. */
1832 if (succ1
1833 && (succ1->flags & EDGE_FALLTHRU))
1835 fall_thru = succ1;
1836 cond_jump = succ2;
1838 else if (succ2
1839 && (succ2->flags & EDGE_FALLTHRU))
1841 fall_thru = succ2;
1842 cond_jump = succ1;
1844 else if (succ1
1845 && (block_ends_with_call_p (cur_bb)
1846 || can_throw_internal (BB_END (cur_bb))))
1848 edge e;
1849 edge_iterator ei;
1851 FOR_EACH_EDGE (e, ei, cur_bb->succs)
1852 if (e->flags & EDGE_FALLTHRU)
1854 fall_thru = e;
1855 break;
1859 if (fall_thru && (fall_thru->dest != EXIT_BLOCK_PTR_FOR_FN (cfun)))
1861 /* Check to see if the fall-thru edge is a crossing edge. */
1863 if (fall_thru->flags & EDGE_CROSSING)
1865 /* The fall_thru edge crosses; now check the cond jump edge, if
1866 it exists. */
1868 cond_jump_crosses = true;
1869 invert_worked = 0;
1870 old_jump = BB_END (cur_bb);
1872 /* Find the jump instruction, if there is one. */
1874 if (cond_jump)
1876 if (!(cond_jump->flags & EDGE_CROSSING))
1877 cond_jump_crosses = false;
1879 /* We know the fall-thru edge crosses; if the cond
1880 jump edge does NOT cross, and its destination is the
1881 next block in the bb order, invert the jump
1882 (i.e. fix it so the fall through does not cross and
1883 the cond jump does). */
1885 if (!cond_jump_crosses)
1887 /* Find label in fall_thru block. We've already added
1888 any missing labels, so there must be one. */
1890 fall_thru_label = block_label (fall_thru->dest);
1892 if (old_jump && fall_thru_label)
1894 rtx_jump_insn *old_jump_insn =
1895 dyn_cast <rtx_jump_insn *> (old_jump);
1896 if (old_jump_insn)
1897 invert_worked = invert_jump (old_jump_insn,
1898 fall_thru_label, 0);
1901 if (invert_worked)
1903 fall_thru->flags &= ~EDGE_FALLTHRU;
1904 cond_jump->flags |= EDGE_FALLTHRU;
1905 update_br_prob_note (cur_bb);
1906 std::swap (fall_thru, cond_jump);
1907 cond_jump->flags |= EDGE_CROSSING;
1908 fall_thru->flags &= ~EDGE_CROSSING;
1913 if (cond_jump_crosses || !invert_worked)
1915 /* This is the case where both edges out of the basic
1916 block are crossing edges. Here we will fix up the
1917 fall through edge. The jump edge will be taken care
1918 of later. The EDGE_CROSSING flag of fall_thru edge
1919 is unset before the call to force_nonfallthru
1920 function because if a new basic-block is created
1921 this edge remains in the current section boundary
1922 while the edge between new_bb and the fall_thru->dest
1923 becomes EDGE_CROSSING. */
1925 fall_thru->flags &= ~EDGE_CROSSING;
1926 new_bb = force_nonfallthru (fall_thru);
1928 if (new_bb)
1930 new_bb->aux = cur_bb->aux;
1931 cur_bb->aux = new_bb;
1933 /* This is done by force_nonfallthru_and_redirect. */
1934 gcc_assert (BB_PARTITION (new_bb)
1935 == BB_PARTITION (cur_bb));
1937 single_succ_edge (new_bb)->flags |= EDGE_CROSSING;
1939 else
1941 /* If a new basic-block was not created; restore
1942 the EDGE_CROSSING flag. */
1943 fall_thru->flags |= EDGE_CROSSING;
1946 /* Add barrier after new jump */
1947 emit_barrier_after_bb (new_bb ? new_bb : cur_bb);
1954 /* This function checks the destination block of a "crossing jump" to
1955 see if it has any crossing predecessors that begin with a code label
1956 and end with an unconditional jump. If so, it returns that predecessor
1957 block. (This is to avoid creating lots of new basic blocks that all
1958 contain unconditional jumps to the same destination). */
1960 static basic_block
1961 find_jump_block (basic_block jump_dest)
1963 basic_block source_bb = NULL;
1964 edge e;
1965 rtx_insn *insn;
1966 edge_iterator ei;
1968 FOR_EACH_EDGE (e, ei, jump_dest->preds)
1969 if (e->flags & EDGE_CROSSING)
1971 basic_block src = e->src;
1973 /* Check each predecessor to see if it has a label, and contains
1974 only one executable instruction, which is an unconditional jump.
1975 If so, we can use it. */
1977 if (LABEL_P (BB_HEAD (src)))
1978 for (insn = BB_HEAD (src);
1979 !INSN_P (insn) && insn != NEXT_INSN (BB_END (src));
1980 insn = NEXT_INSN (insn))
1982 if (INSN_P (insn)
1983 && insn == BB_END (src)
1984 && JUMP_P (insn)
1985 && !any_condjump_p (insn))
1987 source_bb = src;
1988 break;
1992 if (source_bb)
1993 break;
1996 return source_bb;
1999 /* Find all BB's with conditional jumps that are crossing edges;
2000 insert a new bb and make the conditional jump branch to the new
2001 bb instead (make the new bb same color so conditional branch won't
2002 be a 'crossing' edge). Insert an unconditional jump from the
2003 new bb to the original destination of the conditional jump. */
2005 static void
2006 fix_crossing_conditional_branches (void)
2008 basic_block cur_bb;
2009 basic_block new_bb;
2010 basic_block dest;
2011 edge succ1;
2012 edge succ2;
2013 edge crossing_edge;
2014 edge new_edge;
2015 rtx set_src;
2016 rtx old_label = NULL_RTX;
2017 rtx_code_label *new_label;
2019 FOR_EACH_BB_FN (cur_bb, cfun)
2021 crossing_edge = NULL;
2022 if (EDGE_COUNT (cur_bb->succs) > 0)
2023 succ1 = EDGE_SUCC (cur_bb, 0);
2024 else
2025 succ1 = NULL;
2027 if (EDGE_COUNT (cur_bb->succs) > 1)
2028 succ2 = EDGE_SUCC (cur_bb, 1);
2029 else
2030 succ2 = NULL;
2032 /* We already took care of fall-through edges, so only one successor
2033 can be a crossing edge. */
2035 if (succ1 && (succ1->flags & EDGE_CROSSING))
2036 crossing_edge = succ1;
2037 else if (succ2 && (succ2->flags & EDGE_CROSSING))
2038 crossing_edge = succ2;
2040 if (crossing_edge)
2042 rtx_insn *old_jump = BB_END (cur_bb);
2044 /* Check to make sure the jump instruction is a
2045 conditional jump. */
2047 set_src = NULL_RTX;
2049 if (any_condjump_p (old_jump))
2051 if (GET_CODE (PATTERN (old_jump)) == SET)
2052 set_src = SET_SRC (PATTERN (old_jump));
2053 else if (GET_CODE (PATTERN (old_jump)) == PARALLEL)
2055 set_src = XVECEXP (PATTERN (old_jump), 0,0);
2056 if (GET_CODE (set_src) == SET)
2057 set_src = SET_SRC (set_src);
2058 else
2059 set_src = NULL_RTX;
2063 if (set_src && (GET_CODE (set_src) == IF_THEN_ELSE))
2065 rtx_jump_insn *old_jump_insn =
2066 as_a <rtx_jump_insn *> (old_jump);
2068 if (GET_CODE (XEXP (set_src, 1)) == PC)
2069 old_label = XEXP (set_src, 2);
2070 else if (GET_CODE (XEXP (set_src, 2)) == PC)
2071 old_label = XEXP (set_src, 1);
2073 /* Check to see if new bb for jumping to that dest has
2074 already been created; if so, use it; if not, create
2075 a new one. */
2077 new_bb = find_jump_block (crossing_edge->dest);
2079 if (new_bb)
2080 new_label = block_label (new_bb);
2081 else
2083 basic_block last_bb;
2084 rtx_code_label *old_jump_target;
2085 rtx_jump_insn *new_jump;
2087 /* Create new basic block to be dest for
2088 conditional jump. */
2090 /* Put appropriate instructions in new bb. */
2092 new_label = gen_label_rtx ();
2093 emit_label (new_label);
2095 gcc_assert (GET_CODE (old_label) == LABEL_REF);
2096 old_jump_target = old_jump_insn->jump_target ();
2097 new_jump = as_a <rtx_jump_insn *>
2098 (emit_jump_insn (targetm.gen_jump (old_jump_target)));
2099 new_jump->set_jump_target (old_jump_target);
2101 last_bb = EXIT_BLOCK_PTR_FOR_FN (cfun)->prev_bb;
2102 new_bb = create_basic_block (new_label, new_jump, last_bb);
2103 new_bb->aux = last_bb->aux;
2104 last_bb->aux = new_bb;
2106 emit_barrier_after_bb (new_bb);
2108 /* Make sure new bb is in same partition as source
2109 of conditional branch. */
2110 BB_COPY_PARTITION (new_bb, cur_bb);
2113 /* Make old jump branch to new bb. */
2115 redirect_jump (old_jump_insn, new_label, 0);
2117 /* Remove crossing_edge as predecessor of 'dest'. */
2119 dest = crossing_edge->dest;
2121 redirect_edge_succ (crossing_edge, new_bb);
2123 /* Make a new edge from new_bb to old dest; new edge
2124 will be a successor for new_bb and a predecessor
2125 for 'dest'. */
2127 if (EDGE_COUNT (new_bb->succs) == 0)
2128 new_edge = make_edge (new_bb, dest, 0);
2129 else
2130 new_edge = EDGE_SUCC (new_bb, 0);
2132 crossing_edge->flags &= ~EDGE_CROSSING;
2133 new_edge->flags |= EDGE_CROSSING;
2139 /* Find any unconditional branches that cross between hot and cold
2140 sections. Convert them into indirect jumps instead. */
2142 static void
2143 fix_crossing_unconditional_branches (void)
2145 basic_block cur_bb;
2146 rtx_insn *last_insn;
2147 rtx label;
2148 rtx label_addr;
2149 rtx_insn *indirect_jump_sequence;
2150 rtx_insn *jump_insn = NULL;
2151 rtx new_reg;
2152 rtx_insn *cur_insn;
2153 edge succ;
2155 FOR_EACH_BB_FN (cur_bb, cfun)
2157 last_insn = BB_END (cur_bb);
2159 if (EDGE_COUNT (cur_bb->succs) < 1)
2160 continue;
2162 succ = EDGE_SUCC (cur_bb, 0);
2164 /* Check to see if bb ends in a crossing (unconditional) jump. At
2165 this point, no crossing jumps should be conditional. */
2167 if (JUMP_P (last_insn)
2168 && (succ->flags & EDGE_CROSSING))
2170 gcc_assert (!any_condjump_p (last_insn));
2172 /* Make sure the jump is not already an indirect or table jump. */
2174 if (!computed_jump_p (last_insn)
2175 && !tablejump_p (last_insn, NULL, NULL))
2177 /* We have found a "crossing" unconditional branch. Now
2178 we must convert it to an indirect jump. First create
2179 reference of label, as target for jump. */
2181 label = JUMP_LABEL (last_insn);
2182 label_addr = gen_rtx_LABEL_REF (Pmode, label);
2183 LABEL_NUSES (label) += 1;
2185 /* Get a register to use for the indirect jump. */
2187 new_reg = gen_reg_rtx (Pmode);
2189 /* Generate indirect the jump sequence. */
2191 start_sequence ();
2192 emit_move_insn (new_reg, label_addr);
2193 emit_indirect_jump (new_reg);
2194 indirect_jump_sequence = get_insns ();
2195 end_sequence ();
2197 /* Make sure every instruction in the new jump sequence has
2198 its basic block set to be cur_bb. */
2200 for (cur_insn = indirect_jump_sequence; cur_insn;
2201 cur_insn = NEXT_INSN (cur_insn))
2203 if (!BARRIER_P (cur_insn))
2204 BLOCK_FOR_INSN (cur_insn) = cur_bb;
2205 if (JUMP_P (cur_insn))
2206 jump_insn = cur_insn;
2209 /* Insert the new (indirect) jump sequence immediately before
2210 the unconditional jump, then delete the unconditional jump. */
2212 emit_insn_before (indirect_jump_sequence, last_insn);
2213 delete_insn (last_insn);
2215 JUMP_LABEL (jump_insn) = label;
2216 LABEL_NUSES (label)++;
2218 /* Make BB_END for cur_bb be the jump instruction (NOT the
2219 barrier instruction at the end of the sequence...). */
2221 BB_END (cur_bb) = jump_insn;
2227 /* Update CROSSING_JUMP_P flags on all jump insns. */
2229 static void
2230 update_crossing_jump_flags (void)
2232 basic_block bb;
2233 edge e;
2234 edge_iterator ei;
2236 FOR_EACH_BB_FN (bb, cfun)
2237 FOR_EACH_EDGE (e, ei, bb->succs)
2238 if (e->flags & EDGE_CROSSING)
2240 if (JUMP_P (BB_END (bb))
2241 /* Some flags were added during fix_up_fall_thru_edges, via
2242 force_nonfallthru_and_redirect. */
2243 && !CROSSING_JUMP_P (BB_END (bb)))
2244 CROSSING_JUMP_P (BB_END (bb)) = 1;
2245 break;
2249 /* Reorder basic blocks using the software trace cache (STC) algorithm. */
2251 static void
2252 reorder_basic_blocks_software_trace_cache (void)
2254 if (dump_file)
2255 fprintf (dump_file, "\nReordering with the STC algorithm.\n\n");
2257 int n_traces;
2258 int i;
2259 struct trace *traces;
2261 /* We are estimating the length of uncond jump insn only once since the code
2262 for getting the insn length always returns the minimal length now. */
2263 if (uncond_jump_length == 0)
2264 uncond_jump_length = get_uncond_jump_length ();
2266 /* We need to know some information for each basic block. */
2267 array_size = GET_ARRAY_SIZE (last_basic_block_for_fn (cfun));
2268 bbd = XNEWVEC (bbro_basic_block_data, array_size);
2269 for (i = 0; i < array_size; i++)
2271 bbd[i].start_of_trace = -1;
2272 bbd[i].end_of_trace = -1;
2273 bbd[i].in_trace = -1;
2274 bbd[i].visited = 0;
2275 bbd[i].priority = -1;
2276 bbd[i].heap = NULL;
2277 bbd[i].node = NULL;
2280 traces = XNEWVEC (struct trace, n_basic_blocks_for_fn (cfun));
2281 n_traces = 0;
2282 find_traces (&n_traces, traces);
2283 connect_traces (n_traces, traces);
2284 FREE (traces);
2285 FREE (bbd);
2288 /* Return true if edge E1 is more desirable as a fallthrough edge than
2289 edge E2 is. */
2291 static bool
2292 edge_order (edge e1, edge e2)
2294 return EDGE_FREQUENCY (e1) > EDGE_FREQUENCY (e2);
2297 /* Reorder basic blocks using the "simple" algorithm. This tries to
2298 maximize the dynamic number of branches that are fallthrough, without
2299 copying instructions. The algorithm is greedy, looking at the most
2300 frequently executed branch first. */
2302 static void
2303 reorder_basic_blocks_simple (void)
2305 if (dump_file)
2306 fprintf (dump_file, "\nReordering with the \"simple\" algorithm.\n\n");
2308 edge *edges = new edge[2 * n_basic_blocks_for_fn (cfun)];
2310 /* First, collect all edges that can be optimized by reordering blocks:
2311 simple jumps and conditional jumps, as well as the function entry edge. */
2313 int n = 0;
2314 edges[n++] = EDGE_SUCC (ENTRY_BLOCK_PTR_FOR_FN (cfun), 0);
2316 basic_block bb;
2317 FOR_EACH_BB_FN (bb, cfun)
2319 rtx_insn *end = BB_END (bb);
2321 if (computed_jump_p (end) || tablejump_p (end, NULL, NULL))
2322 continue;
2324 /* We cannot optimize asm goto. */
2325 if (JUMP_P (end) && extract_asm_operands (end))
2326 continue;
2328 if (single_succ_p (bb))
2329 edges[n++] = EDGE_SUCC (bb, 0);
2330 else if (any_condjump_p (end))
2332 edge e0 = EDGE_SUCC (bb, 0);
2333 edge e1 = EDGE_SUCC (bb, 1);
2334 /* When optimizing for size it is best to keep the original
2335 fallthrough edges. */
2336 if (e1->flags & EDGE_FALLTHRU)
2337 std::swap (e0, e1);
2338 edges[n++] = e0;
2339 edges[n++] = e1;
2343 /* Sort the edges, the most desirable first. When optimizing for size
2344 all edges are equally desirable. */
2346 if (optimize_function_for_speed_p (cfun))
2347 std::stable_sort (edges, edges + n, edge_order);
2349 /* Now decide which of those edges to make fallthrough edges. We set
2350 BB_VISITED if a block already has a fallthrough successor assigned
2351 to it. We make ->AUX of an endpoint point to the opposite endpoint
2352 of a sequence of blocks that fall through, and ->AUX will be NULL
2353 for a block that is in such a sequence but not an endpoint anymore.
2355 To start with, everything points to itself, nothing is assigned yet. */
2357 FOR_ALL_BB_FN (bb, cfun)
2359 bb->aux = bb;
2360 bb->flags &= ~BB_VISITED;
2363 EXIT_BLOCK_PTR_FOR_FN (cfun)->aux = 0;
2365 /* Now for all edges, the most desirable first, see if that edge can
2366 connect two sequences. If it can, update AUX and BB_VISITED; if it
2367 cannot, zero out the edge in the table. */
2369 for (int j = 0; j < n; j++)
2371 edge e = edges[j];
2373 basic_block tail_a = e->src;
2374 basic_block head_b = e->dest;
2375 basic_block head_a = (basic_block) tail_a->aux;
2376 basic_block tail_b = (basic_block) head_b->aux;
2378 /* An edge cannot connect two sequences if:
2379 - it crosses partitions;
2380 - its src is not a current endpoint;
2381 - its dest is not a current endpoint;
2382 - or, it would create a loop. */
2384 if (e->flags & EDGE_CROSSING
2385 || tail_a->flags & BB_VISITED
2386 || !tail_b
2387 || (!(head_b->flags & BB_VISITED) && head_b != tail_b)
2388 || tail_a == tail_b)
2390 edges[j] = 0;
2391 continue;
2394 tail_a->aux = 0;
2395 head_b->aux = 0;
2396 head_a->aux = tail_b;
2397 tail_b->aux = head_a;
2398 tail_a->flags |= BB_VISITED;
2401 /* Put the pieces together, in the same order that the start blocks of
2402 the sequences already had. The hot/cold partitioning gives a little
2403 complication: as a first pass only do this for blocks in the same
2404 partition as the start block, and (if there is anything left to do)
2405 in a second pass handle the other partition. */
2407 basic_block last_tail = (basic_block) ENTRY_BLOCK_PTR_FOR_FN (cfun)->aux;
2409 int current_partition = BB_PARTITION (last_tail);
2410 bool need_another_pass = true;
2412 for (int pass = 0; pass < 2 && need_another_pass; pass++)
2414 need_another_pass = false;
2416 FOR_EACH_BB_FN (bb, cfun)
2417 if ((bb->flags & BB_VISITED && bb->aux) || bb->aux == bb)
2419 if (BB_PARTITION (bb) != current_partition)
2421 need_another_pass = true;
2422 continue;
2425 last_tail->aux = bb;
2426 last_tail = (basic_block) bb->aux;
2429 current_partition ^= BB_HOT_PARTITION | BB_COLD_PARTITION;
2432 last_tail->aux = 0;
2434 /* Finally, link all the chosen fallthrough edges. */
2436 for (int j = 0; j < n; j++)
2437 if (edges[j])
2438 edges[j]->src->aux = edges[j]->dest;
2440 delete[] edges;
2442 /* If the entry edge no longer falls through we have to make a new
2443 block so it can do so again. */
2445 edge e = EDGE_SUCC (ENTRY_BLOCK_PTR_FOR_FN (cfun), 0);
2446 if (e->dest != ENTRY_BLOCK_PTR_FOR_FN (cfun)->aux)
2448 force_nonfallthru (e);
2449 e->src->aux = ENTRY_BLOCK_PTR_FOR_FN (cfun)->aux;
2450 BB_COPY_PARTITION (e->src, e->dest);
2454 /* Reorder basic blocks. The main entry point to this file. */
2456 static void
2457 reorder_basic_blocks (void)
2459 gcc_assert (current_ir_type () == IR_RTL_CFGLAYOUT);
2461 if (n_basic_blocks_for_fn (cfun) <= NUM_FIXED_BLOCKS + 1)
2462 return;
2464 set_edge_can_fallthru_flag ();
2465 mark_dfs_back_edges ();
2467 switch (flag_reorder_blocks_algorithm)
2469 case REORDER_BLOCKS_ALGORITHM_SIMPLE:
2470 reorder_basic_blocks_simple ();
2471 break;
2473 case REORDER_BLOCKS_ALGORITHM_STC:
2474 reorder_basic_blocks_software_trace_cache ();
2475 break;
2477 default:
2478 gcc_unreachable ();
2481 relink_block_chain (/*stay_in_cfglayout_mode=*/true);
2483 if (dump_file)
2485 if (dump_flags & TDF_DETAILS)
2486 dump_reg_info (dump_file);
2487 dump_flow_info (dump_file, dump_flags);
2490 /* Signal that rtl_verify_flow_info_1 can now verify that there
2491 is at most one switch between hot/cold sections. */
2492 crtl->bb_reorder_complete = true;
2495 /* Determine which partition the first basic block in the function
2496 belongs to, then find the first basic block in the current function
2497 that belongs to a different section, and insert a
2498 NOTE_INSN_SWITCH_TEXT_SECTIONS note immediately before it in the
2499 instruction stream. When writing out the assembly code,
2500 encountering this note will make the compiler switch between the
2501 hot and cold text sections. */
2503 void
2504 insert_section_boundary_note (void)
2506 basic_block bb;
2507 bool switched_sections = false;
2508 int current_partition = 0;
2510 if (!crtl->has_bb_partition)
2511 return;
2513 FOR_EACH_BB_FN (bb, cfun)
2515 if (!current_partition)
2516 current_partition = BB_PARTITION (bb);
2517 if (BB_PARTITION (bb) != current_partition)
2519 gcc_assert (!switched_sections);
2520 switched_sections = true;
2521 emit_note_before (NOTE_INSN_SWITCH_TEXT_SECTIONS, BB_HEAD (bb));
2522 current_partition = BB_PARTITION (bb);
2527 namespace {
2529 const pass_data pass_data_reorder_blocks =
2531 RTL_PASS, /* type */
2532 "bbro", /* name */
2533 OPTGROUP_NONE, /* optinfo_flags */
2534 TV_REORDER_BLOCKS, /* tv_id */
2535 0, /* properties_required */
2536 0, /* properties_provided */
2537 0, /* properties_destroyed */
2538 0, /* todo_flags_start */
2539 0, /* todo_flags_finish */
2542 class pass_reorder_blocks : public rtl_opt_pass
2544 public:
2545 pass_reorder_blocks (gcc::context *ctxt)
2546 : rtl_opt_pass (pass_data_reorder_blocks, ctxt)
2549 /* opt_pass methods: */
2550 virtual bool gate (function *)
2552 if (targetm.cannot_modify_jumps_p ())
2553 return false;
2554 return (optimize > 0
2555 && (flag_reorder_blocks || flag_reorder_blocks_and_partition));
2558 virtual unsigned int execute (function *);
2560 }; // class pass_reorder_blocks
2562 unsigned int
2563 pass_reorder_blocks::execute (function *fun)
2565 basic_block bb;
2567 /* Last attempt to optimize CFG, as scheduling, peepholing and insn
2568 splitting possibly introduced more crossjumping opportunities. */
2569 cfg_layout_initialize (CLEANUP_EXPENSIVE);
2571 reorder_basic_blocks ();
2572 cleanup_cfg (CLEANUP_EXPENSIVE);
2574 FOR_EACH_BB_FN (bb, fun)
2575 if (bb->next_bb != EXIT_BLOCK_PTR_FOR_FN (fun))
2576 bb->aux = bb->next_bb;
2577 cfg_layout_finalize ();
2579 return 0;
2582 } // anon namespace
2584 rtl_opt_pass *
2585 make_pass_reorder_blocks (gcc::context *ctxt)
2587 return new pass_reorder_blocks (ctxt);
2590 /* Duplicate a block (that we already know ends in a computed jump) into its
2591 predecessors, where possible. Return whether anything is changed. */
2592 static bool
2593 maybe_duplicate_computed_goto (basic_block bb, int max_size)
2595 if (single_pred_p (bb))
2596 return false;
2598 /* Make sure that the block is small enough. */
2599 rtx_insn *insn;
2600 FOR_BB_INSNS (bb, insn)
2601 if (INSN_P (insn))
2603 max_size -= get_attr_min_length (insn);
2604 if (max_size < 0)
2605 return false;
2608 bool changed = false;
2609 edge e;
2610 edge_iterator ei;
2611 for (ei = ei_start (bb->preds); (e = ei_safe_edge (ei)); )
2613 basic_block pred = e->src;
2615 /* Do not duplicate BB into PRED if that is the last predecessor, or if
2616 we cannot merge a copy of BB with PRED. */
2617 if (single_pred_p (bb)
2618 || !single_succ_p (pred)
2619 || e->flags & EDGE_COMPLEX
2620 || pred->index < NUM_FIXED_BLOCKS
2621 || (JUMP_P (BB_END (pred)) && !simplejump_p (BB_END (pred)))
2622 || (JUMP_P (BB_END (pred)) && CROSSING_JUMP_P (BB_END (pred))))
2624 ei_next (&ei);
2625 continue;
2628 if (dump_file)
2629 fprintf (dump_file, "Duplicating computed goto bb %d into bb %d\n",
2630 bb->index, e->src->index);
2632 /* Remember if PRED can be duplicated; if so, the copy of BB merged
2633 with PRED can be duplicated as well. */
2634 bool can_dup_more = can_duplicate_block_p (pred);
2636 /* Make a copy of BB, merge it into PRED. */
2637 basic_block copy = duplicate_block (bb, e, NULL);
2638 emit_barrier_after_bb (copy);
2639 reorder_insns_nobb (BB_HEAD (copy), BB_END (copy), BB_END (pred));
2640 merge_blocks (pred, copy);
2642 changed = true;
2644 /* Try to merge the resulting merged PRED into further predecessors. */
2645 if (can_dup_more)
2646 maybe_duplicate_computed_goto (pred, max_size);
2649 return changed;
2652 /* Duplicate the blocks containing computed gotos. This basically unfactors
2653 computed gotos that were factored early on in the compilation process to
2654 speed up edge based data flow. We used to not unfactor them again, which
2655 can seriously pessimize code with many computed jumps in the source code,
2656 such as interpreters. See e.g. PR15242. */
2657 static void
2658 duplicate_computed_gotos (function *fun)
2660 /* We are estimating the length of uncond jump insn only once
2661 since the code for getting the insn length always returns
2662 the minimal length now. */
2663 if (uncond_jump_length == 0)
2664 uncond_jump_length = get_uncond_jump_length ();
2666 /* Never copy a block larger than this. */
2667 int max_size
2668 = uncond_jump_length * PARAM_VALUE (PARAM_MAX_GOTO_DUPLICATION_INSNS);
2670 bool changed = false;
2672 /* Try to duplicate all blocks that end in a computed jump and that
2673 can be duplicated at all. */
2674 basic_block bb;
2675 FOR_EACH_BB_FN (bb, fun)
2676 if (computed_jump_p (BB_END (bb)) && can_duplicate_block_p (bb))
2677 changed |= maybe_duplicate_computed_goto (bb, max_size);
2679 /* Duplicating blocks will redirect edges and may cause hot blocks
2680 previously reached by both hot and cold blocks to become dominated
2681 only by cold blocks. */
2682 if (changed)
2683 fixup_partitions ();
2686 namespace {
2688 const pass_data pass_data_duplicate_computed_gotos =
2690 RTL_PASS, /* type */
2691 "compgotos", /* name */
2692 OPTGROUP_NONE, /* optinfo_flags */
2693 TV_REORDER_BLOCKS, /* tv_id */
2694 0, /* properties_required */
2695 0, /* properties_provided */
2696 0, /* properties_destroyed */
2697 0, /* todo_flags_start */
2698 0, /* todo_flags_finish */
2701 class pass_duplicate_computed_gotos : public rtl_opt_pass
2703 public:
2704 pass_duplicate_computed_gotos (gcc::context *ctxt)
2705 : rtl_opt_pass (pass_data_duplicate_computed_gotos, ctxt)
2708 /* opt_pass methods: */
2709 virtual bool gate (function *);
2710 virtual unsigned int execute (function *);
2712 }; // class pass_duplicate_computed_gotos
2714 bool
2715 pass_duplicate_computed_gotos::gate (function *fun)
2717 if (targetm.cannot_modify_jumps_p ())
2718 return false;
2719 return (optimize > 0
2720 && flag_expensive_optimizations
2721 && ! optimize_function_for_size_p (fun));
2724 unsigned int
2725 pass_duplicate_computed_gotos::execute (function *fun)
2727 duplicate_computed_gotos (fun);
2729 return 0;
2732 } // anon namespace
2734 rtl_opt_pass *
2735 make_pass_duplicate_computed_gotos (gcc::context *ctxt)
2737 return new pass_duplicate_computed_gotos (ctxt);
2740 /* This function is the main 'entrance' for the optimization that
2741 partitions hot and cold basic blocks into separate sections of the
2742 .o file (to improve performance and cache locality). Ideally it
2743 would be called after all optimizations that rearrange the CFG have
2744 been called. However part of this optimization may introduce new
2745 register usage, so it must be called before register allocation has
2746 occurred. This means that this optimization is actually called
2747 well before the optimization that reorders basic blocks (see
2748 function above).
2750 This optimization checks the feedback information to determine
2751 which basic blocks are hot/cold, updates flags on the basic blocks
2752 to indicate which section they belong in. This information is
2753 later used for writing out sections in the .o file. Because hot
2754 and cold sections can be arbitrarily large (within the bounds of
2755 memory), far beyond the size of a single function, it is necessary
2756 to fix up all edges that cross section boundaries, to make sure the
2757 instructions used can actually span the required distance. The
2758 fixes are described below.
2760 Fall-through edges must be changed into jumps; it is not safe or
2761 legal to fall through across a section boundary. Whenever a
2762 fall-through edge crossing a section boundary is encountered, a new
2763 basic block is inserted (in the same section as the fall-through
2764 source), and the fall through edge is redirected to the new basic
2765 block. The new basic block contains an unconditional jump to the
2766 original fall-through target. (If the unconditional jump is
2767 insufficient to cross section boundaries, that is dealt with a
2768 little later, see below).
2770 In order to deal with architectures that have short conditional
2771 branches (which cannot span all of memory) we take any conditional
2772 jump that attempts to cross a section boundary and add a level of
2773 indirection: it becomes a conditional jump to a new basic block, in
2774 the same section. The new basic block contains an unconditional
2775 jump to the original target, in the other section.
2777 For those architectures whose unconditional branch is also
2778 incapable of reaching all of memory, those unconditional jumps are
2779 converted into indirect jumps, through a register.
2781 IMPORTANT NOTE: This optimization causes some messy interactions
2782 with the cfg cleanup optimizations; those optimizations want to
2783 merge blocks wherever possible, and to collapse indirect jump
2784 sequences (change "A jumps to B jumps to C" directly into "A jumps
2785 to C"). Those optimizations can undo the jump fixes that
2786 partitioning is required to make (see above), in order to ensure
2787 that jumps attempting to cross section boundaries are really able
2788 to cover whatever distance the jump requires (on many architectures
2789 conditional or unconditional jumps are not able to reach all of
2790 memory). Therefore tests have to be inserted into each such
2791 optimization to make sure that it does not undo stuff necessary to
2792 cross partition boundaries. This would be much less of a problem
2793 if we could perform this optimization later in the compilation, but
2794 unfortunately the fact that we may need to create indirect jumps
2795 (through registers) requires that this optimization be performed
2796 before register allocation.
2798 Hot and cold basic blocks are partitioned and put in separate
2799 sections of the .o file, to reduce paging and improve cache
2800 performance (hopefully). This can result in bits of code from the
2801 same function being widely separated in the .o file. However this
2802 is not obvious to the current bb structure. Therefore we must take
2803 care to ensure that: 1). There are no fall_thru edges that cross
2804 between sections; 2). For those architectures which have "short"
2805 conditional branches, all conditional branches that attempt to
2806 cross between sections are converted to unconditional branches;
2807 and, 3). For those architectures which have "short" unconditional
2808 branches, all unconditional branches that attempt to cross between
2809 sections are converted to indirect jumps.
2811 The code for fixing up fall_thru edges that cross between hot and
2812 cold basic blocks does so by creating new basic blocks containing
2813 unconditional branches to the appropriate label in the "other"
2814 section. The new basic block is then put in the same (hot or cold)
2815 section as the original conditional branch, and the fall_thru edge
2816 is modified to fall into the new basic block instead. By adding
2817 this level of indirection we end up with only unconditional branches
2818 crossing between hot and cold sections.
2820 Conditional branches are dealt with by adding a level of indirection.
2821 A new basic block is added in the same (hot/cold) section as the
2822 conditional branch, and the conditional branch is retargeted to the
2823 new basic block. The new basic block contains an unconditional branch
2824 to the original target of the conditional branch (in the other section).
2826 Unconditional branches are dealt with by converting them into
2827 indirect jumps. */
2829 namespace {
2831 const pass_data pass_data_partition_blocks =
2833 RTL_PASS, /* type */
2834 "bbpart", /* name */
2835 OPTGROUP_NONE, /* optinfo_flags */
2836 TV_REORDER_BLOCKS, /* tv_id */
2837 PROP_cfglayout, /* properties_required */
2838 0, /* properties_provided */
2839 0, /* properties_destroyed */
2840 0, /* todo_flags_start */
2841 0, /* todo_flags_finish */
2844 class pass_partition_blocks : public rtl_opt_pass
2846 public:
2847 pass_partition_blocks (gcc::context *ctxt)
2848 : rtl_opt_pass (pass_data_partition_blocks, ctxt)
2851 /* opt_pass methods: */
2852 virtual bool gate (function *);
2853 virtual unsigned int execute (function *);
2855 }; // class pass_partition_blocks
2857 bool
2858 pass_partition_blocks::gate (function *fun)
2860 /* The optimization to partition hot/cold basic blocks into separate
2861 sections of the .o file does not work well with linkonce or with
2862 user defined section attributes. Don't call it if either case
2863 arises. */
2864 return (flag_reorder_blocks_and_partition
2865 && optimize
2866 /* See pass_reorder_blocks::gate. We should not partition if
2867 we are going to omit the reordering. */
2868 && optimize_function_for_speed_p (fun)
2869 && !DECL_COMDAT_GROUP (current_function_decl)
2870 && !lookup_attribute ("section", DECL_ATTRIBUTES (fun->decl)));
2873 unsigned
2874 pass_partition_blocks::execute (function *fun)
2876 vec<edge> crossing_edges;
2878 if (n_basic_blocks_for_fn (fun) <= NUM_FIXED_BLOCKS + 1)
2879 return 0;
2881 df_set_flags (DF_DEFER_INSN_RESCAN);
2883 crossing_edges = find_rarely_executed_basic_blocks_and_crossing_edges ();
2884 if (!crossing_edges.exists ())
2885 return 0;
2887 crtl->has_bb_partition = true;
2889 /* Make sure the source of any crossing edge ends in a jump and the
2890 destination of any crossing edge has a label. */
2891 add_labels_and_missing_jumps (crossing_edges);
2893 /* Convert all crossing fall_thru edges to non-crossing fall
2894 thrus to unconditional jumps (that jump to the original fall
2895 through dest). */
2896 fix_up_fall_thru_edges ();
2898 /* If the architecture does not have conditional branches that can
2899 span all of memory, convert crossing conditional branches into
2900 crossing unconditional branches. */
2901 if (!HAS_LONG_COND_BRANCH)
2902 fix_crossing_conditional_branches ();
2904 /* If the architecture does not have unconditional branches that
2905 can span all of memory, convert crossing unconditional branches
2906 into indirect jumps. Since adding an indirect jump also adds
2907 a new register usage, update the register usage information as
2908 well. */
2909 if (!HAS_LONG_UNCOND_BRANCH)
2910 fix_crossing_unconditional_branches ();
2912 update_crossing_jump_flags ();
2914 /* Clear bb->aux fields that the above routines were using. */
2915 clear_aux_for_blocks ();
2917 crossing_edges.release ();
2919 /* ??? FIXME: DF generates the bb info for a block immediately.
2920 And by immediately, I mean *during* creation of the block.
2922 #0 df_bb_refs_collect
2923 #1 in df_bb_refs_record
2924 #2 in create_basic_block_structure
2926 Which means that the bb_has_eh_pred test in df_bb_refs_collect
2927 will *always* fail, because no edges can have been added to the
2928 block yet. Which of course means we don't add the right
2929 artificial refs, which means we fail df_verify (much) later.
2931 Cleanest solution would seem to make DF_DEFER_INSN_RESCAN imply
2932 that we also shouldn't grab data from the new blocks those new
2933 insns are in either. In this way one can create the block, link
2934 it up properly, and have everything Just Work later, when deferred
2935 insns are processed.
2937 In the meantime, we have no other option but to throw away all
2938 of the DF data and recompute it all. */
2939 if (fun->eh->lp_array)
2941 df_finish_pass (true);
2942 df_scan_alloc (NULL);
2943 df_scan_blocks ();
2944 /* Not all post-landing pads use all of the EH_RETURN_DATA_REGNO
2945 data. We blindly generated all of them when creating the new
2946 landing pad. Delete those assignments we don't use. */
2947 df_set_flags (DF_LR_RUN_DCE);
2948 df_analyze ();
2951 return 0;
2954 } // anon namespace
2956 rtl_opt_pass *
2957 make_pass_partition_blocks (gcc::context *ctxt)
2959 return new pass_partition_blocks (ctxt);