1 /* Print RTL for GNU C Compiler.
2 Copyright (C) 1987, 1988, 1992, 1997, 1998, 1999, 2000
3 Free Software Foundation, Inc.
5 This file is part of GCC.
7 GCC is free software; you can redistribute it and/or modify it under
8 the terms of the GNU General Public License as published by the Free
9 Software Foundation; either version 2, or (at your option) any later
12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING. If not, write to the Free
19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
28 #include "hard-reg-set.h"
29 #include "basic-block.h"
31 /* How to print out a register name.
32 We don't use PRINT_REG because some definitions of PRINT_REG
34 #ifndef DEBUG_PRINT_REG
35 #define DEBUG_PRINT_REG(RTX, CODE, FILE) \
36 fprintf ((FILE), "%d %s", REGNO (RTX), reg_names[REGNO (RTX)])
39 /* Array containing all of the register names */
41 #ifdef DEBUG_REGISTER_NAMES
42 static const char * const debug_reg_names[] = DEBUG_REGISTER_NAMES;
43 #define reg_names debug_reg_names
45 const char * reg_names[] = REGISTER_NAMES;
50 static int sawclose = 0;
54 static void print_rtx PARAMS ((rtx));
56 /* String printed at beginning of each RTL when it is dumped.
57 This string is set to ASM_COMMENT_START when the RTL is dumped in
58 the assembly output file. */
59 const char *print_rtx_head = "";
61 /* Nonzero means suppress output of instruction numbers and line number
62 notes in debugging dumps.
63 This must be defined here so that programs like gencodes can be linked. */
64 int flag_dump_unnumbered = 0;
66 /* Nonzero means use simplified format without flags, modes, etc. */
69 /* Nonzero if we are dumping graphical description. */
72 /* Nonzero to dump all call_placeholder alternatives. */
73 static int debug_call_placeholder_verbose;
75 /* Print IN_RTX onto OUTFILE. This is the recursive part of printing. */
83 const char *format_ptr;
92 fprintf (outfile, "\n%s%*s",
93 print_rtx_head, indent * 2, "");
99 fputs ("(nil)", outfile);
104 is_insn = (INSN_P (in_rtx));
106 /* When printing in VCG format we write INSNs, NOTE, LABEL, and BARRIER
107 in separate nodes and therefore have to handle them special here. */
108 if (dump_for_graph &&
109 (is_insn || GET_CODE (in_rtx) == NOTE || GET_CODE (in_rtx) == CODE_LABEL
110 || GET_CODE (in_rtx) == BARRIER))
117 /* print name of expression code */
118 if (flag_simple && GET_CODE (in_rtx) == CONST_INT)
119 fputc ('(', outfile);
121 fprintf (outfile, "(%s", GET_RTX_NAME (GET_CODE (in_rtx)));
125 if (in_rtx->in_struct)
126 fputs ("/s", outfile);
129 fputs ("/v", outfile);
131 if (in_rtx->unchanging)
132 fputs ("/u", outfile);
134 if (in_rtx->integrated)
135 fputs ("/i", outfile);
137 if (in_rtx->frame_related)
138 fputs ("/f", outfile);
141 fputs ("/j", outfile);
144 fputs ("/c", outfile);
146 if (GET_MODE (in_rtx) != VOIDmode)
148 /* Print REG_NOTE names for EXPR_LIST and INSN_LIST. */
149 if (GET_CODE (in_rtx) == EXPR_LIST
150 || GET_CODE (in_rtx) == INSN_LIST)
151 fprintf (outfile, ":%s",
152 GET_REG_NOTE_NAME (GET_MODE (in_rtx)));
154 fprintf (outfile, ":%s", GET_MODE_NAME (GET_MODE (in_rtx)));
159 /* Get the format string and skip the first elements if we have handled
161 format_ptr = GET_RTX_FORMAT (GET_CODE (in_rtx)) + i;
163 for (; i < GET_RTX_LENGTH (GET_CODE (in_rtx)); i++)
164 switch (*format_ptr++)
169 str = XTMPL (in_rtx, i);
174 str = XSTR (in_rtx, i);
178 fputs (dump_for_graph ? " \\\"\\\"" : " \"\"", outfile);
182 fprintf (outfile, " (\\\"%s\\\")", str);
184 fprintf (outfile, " (\"%s\")", str);
189 /* 0 indicates a field for internal use that should not be printed.
190 An exception is the third field of a NOTE, where it indicates
191 that the field has several different valid contents. */
193 if (i == 1 && GET_CODE (in_rtx) == REG)
195 if (REGNO (in_rtx) != ORIGINAL_REGNO (in_rtx))
196 fprintf (outfile, " [%d]", ORIGINAL_REGNO (in_rtx));
199 if (i == 3 && GET_CODE (in_rtx) == NOTE)
201 switch (NOTE_LINE_NUMBER (in_rtx))
203 case NOTE_INSN_EH_REGION_BEG:
204 case NOTE_INSN_EH_REGION_END:
205 if (flag_dump_unnumbered)
206 fprintf (outfile, " #");
208 fprintf (outfile, " %d", NOTE_EH_HANDLER (in_rtx));
212 case NOTE_INSN_BLOCK_BEG:
213 case NOTE_INSN_BLOCK_END:
214 fprintf (outfile, " ");
215 if (flag_dump_unnumbered)
216 fprintf (outfile, "#");
218 fprintf (outfile, HOST_PTR_PRINTF,
219 (char *) NOTE_BLOCK (in_rtx));
223 case NOTE_INSN_RANGE_BEG:
224 case NOTE_INSN_RANGE_END:
228 fprintf (outfile, " ");
229 print_rtx (NOTE_RANGE_INFO (in_rtx));
233 case NOTE_INSN_BASIC_BLOCK:
235 basic_block bb = NOTE_BASIC_BLOCK (in_rtx);
237 fprintf (outfile, " [bb %d]", bb->index);
241 case NOTE_INSN_EXPECTED_VALUE:
244 fprintf (outfile, " ");
245 print_rtx (NOTE_EXPECTED_VALUE (in_rtx));
249 case NOTE_INSN_DELETED_LABEL:
250 if (NOTE_SOURCE_FILE (in_rtx))
251 fprintf (outfile, " (\"%s\")", NOTE_SOURCE_FILE (in_rtx));
253 fprintf (outfile, " \"\"");
258 const char * const str = X0STR (in_rtx, i);
260 if (NOTE_LINE_NUMBER (in_rtx) < 0)
263 fputs (dump_for_graph ? " \\\"\\\"" : " \"\"", outfile);
267 fprintf (outfile, " (\\\"%s\\\")", str);
269 fprintf (outfile, " (\"%s\")", str);
281 fprintf (outfile, " ");
282 print_rtx (XEXP (in_rtx, i));
291 fprintf (outfile, "\n%s%*s",
292 print_rtx_head, indent * 2, "");
295 fputs ("[ ", outfile);
296 if (NULL != XVEC (in_rtx, i))
299 if (XVECLEN (in_rtx, i))
302 for (j = 0; j < XVECLEN (in_rtx, i); j++)
303 print_rtx (XVECEXP (in_rtx, i, j));
308 fprintf (outfile, "\n%s%*s",
309 print_rtx_head, indent * 2, "");
311 fputs ("] ", outfile);
318 fprintf (outfile, " ");
319 fprintf (outfile, HOST_WIDE_INT_PRINT_DEC, XWINT (in_rtx, i));
322 fprintf (outfile, " [");
323 fprintf (outfile, HOST_WIDE_INT_PRINT_HEX, XWINT (in_rtx, i));
324 fprintf (outfile, "]");
329 if (i == 5 && GET_CODE (in_rtx) == NOTE)
331 /* This field is only used for NOTE_INSN_DELETED_LABEL, and
332 other times often contains garbage from INSN->NOTE death. */
333 if (NOTE_LINE_NUMBER (in_rtx) == NOTE_INSN_DELETED_LABEL)
334 fprintf (outfile, " %d", XINT (in_rtx, i));
338 int value = XINT (in_rtx, i);
341 if (GET_CODE (in_rtx) == REG && value < FIRST_PSEUDO_REGISTER)
343 fputc (' ', outfile);
344 DEBUG_PRINT_REG (in_rtx, 0, outfile);
346 else if (GET_CODE (in_rtx) == REG
347 && value <= LAST_VIRTUAL_REGISTER)
349 if (value == VIRTUAL_INCOMING_ARGS_REGNUM)
350 fprintf (outfile, " %d virtual-incoming-args", value);
351 else if (value == VIRTUAL_STACK_VARS_REGNUM)
352 fprintf (outfile, " %d virtual-stack-vars", value);
353 else if (value == VIRTUAL_STACK_DYNAMIC_REGNUM)
354 fprintf (outfile, " %d virtual-stack-dynamic", value);
355 else if (value == VIRTUAL_OUTGOING_ARGS_REGNUM)
356 fprintf (outfile, " %d virtual-outgoing-args", value);
357 else if (value == VIRTUAL_CFA_REGNUM)
358 fprintf (outfile, " %d virtual-cfa", value);
360 fprintf (outfile, " %d virtual-reg-%d", value,
361 value-FIRST_VIRTUAL_REGISTER);
363 else if (flag_dump_unnumbered
364 && (is_insn || GET_CODE (in_rtx) == NOTE))
365 fputc ('#', outfile);
367 fprintf (outfile, " %d", value);
369 if (is_insn && &INSN_CODE (in_rtx) == &XINT (in_rtx, i)
370 && XINT (in_rtx, i) >= 0
371 && (name = get_insn_name (XINT (in_rtx, i))) != NULL)
372 fprintf (outfile, " {%s}", name);
377 /* Print NOTE_INSN names rather than integer codes. */
380 if (XINT (in_rtx, i) >= (int) NOTE_INSN_BIAS
381 && XINT (in_rtx, i) < (int) NOTE_INSN_MAX)
382 fprintf (outfile, " %s", GET_NOTE_INSN_NAME (XINT (in_rtx, i)));
384 fprintf (outfile, " %d", XINT (in_rtx, i));
389 if (XEXP (in_rtx, i) != NULL)
391 rtx sub = XEXP (in_rtx, i);
392 enum rtx_code subc = GET_CODE (sub);
394 if (GET_CODE (in_rtx) == LABEL_REF)
397 && NOTE_LINE_NUMBER (sub) == NOTE_INSN_DELETED_LABEL)
399 if (flag_dump_unnumbered)
400 fprintf (outfile, " [# deleted]");
402 fprintf (outfile, " [%d deleted]", INSN_UID (sub));
407 if (subc != CODE_LABEL)
411 if (flag_dump_unnumbered)
412 fputs (" #", outfile);
414 fprintf (outfile, " %d", INSN_UID (sub));
417 fputs (" 0", outfile);
422 if (XBITMAP (in_rtx, i) == NULL)
423 fputs (" {null}", outfile);
425 bitmap_print (outfile, XBITMAP (in_rtx, i), " {", "}");
431 fprintf (outfile, HOST_PTR_PRINTF, (char *) XTREE (in_rtx, i));
435 fputs (" Unknown", outfile);
441 "switch format wrong in rtl.print_rtx(). format was: %c.\n",
446 switch (GET_CODE (in_rtx))
449 fputc (' ', outfile);
450 fprintf (outfile, HOST_WIDE_INT_PRINT_DEC, MEM_ALIAS_SET (in_rtx));
453 #if HOST_FLOAT_FORMAT == TARGET_FLOAT_FORMAT && MAX_LONG_DOUBLE_TYPE_SIZE == 64
455 if (FLOAT_MODE_P (GET_MODE (in_rtx)))
458 REAL_VALUE_FROM_CONST_DOUBLE (val, in_rtx);
459 fprintf (outfile, " [%.16g]", val);
465 fprintf (outfile, " [%d uses]", LABEL_NUSES (in_rtx));
466 if (LABEL_ALTERNATE_NAME (in_rtx))
467 fprintf (outfile, " [alternate name: %s]",
468 LABEL_ALTERNATE_NAME (in_rtx));
471 case CALL_PLACEHOLDER:
472 if (debug_call_placeholder_verbose)
474 fputs (" (cond [\n (const_string \"normal\") (sequence [", outfile);
475 for (tem = XEXP (in_rtx, 0); tem != 0; tem = NEXT_INSN (tem))
477 fputs ("\n ", outfile);
478 print_inline_rtx (outfile, tem, 4);
481 tem = XEXP (in_rtx, 1);
483 fputs ("\n ])\n (const_string \"tail_call\") (sequence [", outfile);
484 for (; tem != 0; tem = NEXT_INSN (tem))
486 fputs ("\n ", outfile);
487 print_inline_rtx (outfile, tem, 4);
490 tem = XEXP (in_rtx, 2);
492 fputs ("\n ])\n (const_string \"tail_recursion\") (sequence [", outfile);
493 for (; tem != 0; tem = NEXT_INSN (tem))
495 fputs ("\n ", outfile);
496 print_inline_rtx (outfile, tem, 4);
499 fputs ("\n ])\n ])", outfile);
503 for (tem = XEXP (in_rtx, 0); tem != 0; tem = NEXT_INSN (tem))
504 if (GET_CODE (tem) == CALL_INSN)
506 fprintf (outfile, " ");
517 && (is_insn || GET_CODE (in_rtx) == NOTE
518 || GET_CODE (in_rtx) == CODE_LABEL || GET_CODE (in_rtx) == BARRIER))
522 fputc (')', outfile);
527 /* Print an rtx on the current line of FILE. Initially indent IND
531 print_inline_rtx (outf, x, ind)
536 int oldsaw = sawclose;
537 int oldindent = indent;
547 /* Call this function from the debugger to see what X looks like. */
555 fprintf (stderr, "\n");
558 /* Count of rtx's to print with debug_rtx_list.
559 This global exists because gdb user defined commands have no arguments. */
561 int debug_rtx_count = 0; /* 0 is treated as equivalent to 1 */
563 /* Call this function to print list from X on.
565 N is a count of the rtx's to print. Positive values print from the specified
566 rtx on. Negative values print a window around the rtx.
567 EG: -5 prints 2 rtx's on either side (in addition to the specified rtx). */
570 debug_rtx_list (x, n)
577 count = n == 0 ? 1 : n < 0 ? -n : n;
579 /* If we are printing a window, back up to the start. */
582 for (i = count / 2; i > 0; i--)
584 if (PREV_INSN (x) == 0)
589 for (i = count, insn = x; i > 0 && insn != 0; i--, insn = NEXT_INSN (insn))
593 /* Call this function to print an rtx list from START to END inclusive. */
596 debug_rtx_range (start, end)
602 if (!start || start == end)
604 start = NEXT_INSN (start);
608 /* Call this function to search an rtx list to find one with insn uid UID,
609 and then call debug_rtx_list to print it, using DEBUG_RTX_COUNT.
610 The found insn is returned to enable further debugging analysis. */
613 debug_rtx_find (x, uid)
617 while (x != 0 && INSN_UID (x) != uid)
621 debug_rtx_list (x, debug_rtx_count);
626 fprintf (stderr, "insn uid %d not found\n", uid);
631 /* External entry point for printing a chain of insns
632 starting with RTX_FIRST onto file OUTF.
633 A blank line separates insns.
635 If RTX_FIRST is not an insn, then it alone is printed, with no newline. */
638 print_rtl (outf, rtx_first)
649 fputs (print_rtx_head, outf);
650 fputs ("(nil)\n", outf);
653 switch (GET_CODE (rtx_first))
661 for (tmp_rtx = rtx_first; tmp_rtx != 0; tmp_rtx = NEXT_INSN (tmp_rtx))
662 if (! flag_dump_unnumbered
663 || GET_CODE (tmp_rtx) != NOTE || NOTE_LINE_NUMBER (tmp_rtx) < 0)
665 fputs (print_rtx_head, outfile);
667 fprintf (outfile, "\n");
672 fputs (print_rtx_head, outfile);
673 print_rtx (rtx_first);
677 /* Like print_rtx, except specify a file. */
678 /* Return nonzero if we actually printed anything. */
681 print_rtl_single (outf, x)
687 if (! flag_dump_unnumbered
688 || GET_CODE (x) != NOTE || NOTE_LINE_NUMBER (x) < 0)
690 fputs (print_rtx_head, outfile);
699 /* Like print_rtl except without all the detail; for example,
700 if RTX is a CONST_INT then print in decimal format. */
703 print_simple_rtl (outf, x)