gcc/print-rtl.c

   1 /* Print RTL for GCC.
   2    Copyright (C) 1987, 1988, 1992, 1997, 1998, 1999, 2000, 2002, 2003,
   3    2004, 2005
   4    Free Software Foundation, Inc.
   5
   6 This file is part of GCC.
   7
   8 GCC is free software; you can redistribute it and/or modify it under
   9 the terms of the GNU General Public License as published by the Free
  10 Software Foundation; either version 2, or (at your option) any later
  11 version.
  12
  13 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  15 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  16 for more details.
  17
  18 You should have received a copy of the GNU General Public License
  19 along with GCC; see the file COPYING.  If not, write to the Free
  20 Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA
  21 02110-1301, USA.  */
  22
  23 /* This file is compiled twice: once for the generator programs,
  24    once for the compiler.  */
  25 #ifdef GENERATOR_FILE
  26 #include "bconfig.h"
  27 #else
  28 #include "config.h"
  29 #endif
  30
  31 #include "system.h"
  32 #include "coretypes.h"
  33 #include "tm.h"
  34 #include "rtl.h"
  35
  36 /* These headers all define things which are not available in
  37    generator programs.  */
  38 #ifndef GENERATOR_FILE
  39 #include "tree.h"
  40 #include "real.h"
  41 #include "flags.h"
  42 #include "hard-reg-set.h"
  43 #include "basic-block.h"
  44 #endif
  45
  46 static FILE *outfile;
  47
  48 static int sawclose = 0;
  49
  50 static int indent;
  51
  52 static void print_rtx (rtx);
  53
  54 /* String printed at beginning of each RTL when it is dumped.
  55    This string is set to ASM_COMMENT_START when the RTL is dumped in
  56    the assembly output file.  */
  57 const char *print_rtx_head = "";
  58
  59 /* Nonzero means suppress output of instruction numbers
  60    in debugging dumps.
  61    This must be defined here so that programs like gencodes can be linked.  */
  62 int flag_dump_unnumbered = 0;
  63
  64 /* Nonzero means use simplified format without flags, modes, etc.  */
  65 int flag_simple = 0;
  66
  67 /* Nonzero if we are dumping graphical description.  */
  68 int dump_for_graph;
  69
  70 #ifndef GENERATOR_FILE
  71 static void
  72 print_decl_name (FILE *outfile, tree node)
  73 {
  74   if (DECL_NAME (node))
  75     fputs (IDENTIFIER_POINTER (DECL_NAME (node)), outfile);
  76   else
  77     {
  78       if (TREE_CODE (node) == LABEL_DECL && LABEL_DECL_UID (node) != -1)
  79         fprintf (outfile, "L." HOST_WIDE_INT_PRINT_DEC, LABEL_DECL_UID (node));
  80       else
  81         {
  82           char c = TREE_CODE (node) == CONST_DECL ? 'C' : 'D';
  83           fprintf (outfile, "%c.%u", c, DECL_UID (node));
  84         }
  85     }
  86 }
  87
  88 void
  89 print_mem_expr (FILE *outfile, tree expr)
  90 {
  91   if (TREE_CODE (expr) == COMPONENT_REF)
  92     {
  93       if (TREE_OPERAND (expr, 0))
  94         print_mem_expr (outfile, TREE_OPERAND (expr, 0));
  95       else
  96         fputs (" <variable>", outfile);
  97       fputc ('.', outfile);
  98       print_decl_name (outfile, TREE_OPERAND (expr, 1));
  99     }
 100   else if (TREE_CODE (expr) == INDIRECT_REF)
 101     {
 102       fputs (" (*", outfile);
 103       print_mem_expr (outfile, TREE_OPERAND (expr, 0));
 104       fputs (")", outfile);
 105     }
 106   else if (TREE_CODE (expr) == ALIGN_INDIRECT_REF)
 107     {
 108       fputs (" (A*", outfile);
 109       print_mem_expr (outfile, TREE_OPERAND (expr, 0));
 110       fputs (")", outfile);
 111     }
 112   else if (TREE_CODE (expr) == MISALIGNED_INDIRECT_REF)
 113     {
 114       fputs (" (M*", outfile);
 115       print_mem_expr (outfile, TREE_OPERAND (expr, 0));
 116       fputs (")", outfile);
 117     }
 118   else if (TREE_CODE (expr) == RESULT_DECL)
 119     fputs (" <result>", outfile);
 120   else
 121     {
 122       fputc (' ', outfile);
 123       print_decl_name (outfile, expr);
 124     }
 125 }
 126 #endif
 127
 128 /* Print IN_RTX onto OUTFILE.  This is the recursive part of printing.  */
 129
 130 static void
 131 print_rtx (rtx in_rtx)
 132 {
 133   int i = 0;
 134   int j;
 135   const char *format_ptr;
 136   int is_insn;
 137
 138   if (sawclose)
 139     {
 140       if (flag_simple)
 141         fputc (' ', outfile);
 142       else
 143         fprintf (outfile, "\n%s%*s", print_rtx_head, indent * 2, "");
 144       sawclose = 0;
 145     }
 146
 147   if (in_rtx == 0)
 148     {
 149       fputs ("(nil)", outfile);
 150       sawclose = 1;
 151       return;
 152     }
 153   else if (GET_CODE (in_rtx) > NUM_RTX_CODE)
 154     {
 155        fprintf (outfile, "(??? bad code %d\n)", GET_CODE (in_rtx));
 156        sawclose = 1;
 157        return;
 158     }
 159
 160   is_insn = INSN_P (in_rtx);
 161
 162   /* When printing in VCG format we write INSNs, NOTE, LABEL, and BARRIER
 163      in separate nodes and therefore have to handle them special here.  */
 164   if (dump_for_graph
 165       && (is_insn || NOTE_P (in_rtx)
 166           || LABEL_P (in_rtx) || BARRIER_P (in_rtx)))
 167     {
 168       i = 3;
 169       indent = 0;
 170     }
 171   else
 172     {
 173       /* Print name of expression code.  */
 174       if (flag_simple && GET_CODE (in_rtx) == CONST_INT)
 175         fputc ('(', outfile);
 176       else
 177         fprintf (outfile, "(%s", GET_RTX_NAME (GET_CODE (in_rtx)));
 178
 179       if (! flag_simple)
 180         {
 181           if (RTX_FLAG (in_rtx, in_struct))
 182             fputs ("/s", outfile);
 183
 184           if (RTX_FLAG (in_rtx, volatil))
 185             fputs ("/v", outfile);
 186
 187           if (RTX_FLAG (in_rtx, unchanging))
 188             fputs ("/u", outfile);
 189
 190           if (RTX_FLAG (in_rtx, frame_related))
 191             fputs ("/f", outfile);
 192
 193           if (RTX_FLAG (in_rtx, jump))
 194             fputs ("/j", outfile);
 195
 196           if (RTX_FLAG (in_rtx, call))
 197             fputs ("/c", outfile);
 198
 199           if (RTX_FLAG (in_rtx, return_val))
 200             fputs ("/i", outfile);
 201
 202           /* Print REG_NOTE names for EXPR_LIST and INSN_LIST.  */
 203           if (GET_CODE (in_rtx) == EXPR_LIST
 204               || GET_CODE (in_rtx) == INSN_LIST)
 205             fprintf (outfile, ":%s",
 206                      GET_REG_NOTE_NAME (GET_MODE (in_rtx)));
 207
 208           /* For other rtl, print the mode if it's not VOID.  */
 209           else if (GET_MODE (in_rtx) != VOIDmode)
 210             fprintf (outfile, ":%s", GET_MODE_NAME (GET_MODE (in_rtx)));
 211         }
 212     }
 213
 214 #ifndef GENERATOR_FILE
 215   if (GET_CODE (in_rtx) == CONST_DOUBLE && FLOAT_MODE_P (GET_MODE (in_rtx)))
 216     i = 5;
 217 #endif
 218
 219   /* Get the format string and skip the first elements if we have handled
 220      them already.  */
 221   format_ptr = GET_RTX_FORMAT (GET_CODE (in_rtx)) + i;
 222   for (; i < GET_RTX_LENGTH (GET_CODE (in_rtx)); i++)
 223     switch (*format_ptr++)
 224       {
 225         const char *str;
 226
 227       case 'T':
 228         str = XTMPL (in_rtx, i);
 229         goto string;
 230
 231       case 'S':
 232       case 's':
 233         str = XSTR (in_rtx, i);
 234       string:
 235
 236         if (str == 0)
 237           fputs (dump_for_graph ? " \\\"\\\"" : " \"\"", outfile);
 238         else
 239           {
 240             if (dump_for_graph)
 241               fprintf (outfile, " (\\\"%s\\\")", str);
 242             else
 243               fprintf (outfile, " (\"%s\")", str);
 244           }
 245         sawclose = 1;
 246         break;
 247
 248         /* 0 indicates a field for internal use that should not be printed.
 249            An exception is the third field of a NOTE, where it indicates
 250            that the field has several different valid contents.  */
 251       case '0':
 252         if (i == 1 && REG_P (in_rtx))
 253           {
 254             if (REGNO (in_rtx) != ORIGINAL_REGNO (in_rtx))
 255               fprintf (outfile, " [%d]", ORIGINAL_REGNO (in_rtx));
 256           }
 257 #ifndef GENERATOR_FILE
 258         else if (i == 1 && GET_CODE (in_rtx) == SYMBOL_REF)
 259           {
 260             int flags = SYMBOL_REF_FLAGS (in_rtx);
 261             if (flags)
 262               fprintf (outfile, " [flags 0x%x]", flags);
 263           }
 264         else if (i == 2 && GET_CODE (in_rtx) == SYMBOL_REF)
 265           {
 266             tree decl = SYMBOL_REF_DECL (in_rtx);
 267             if (decl)
 268               print_node_brief (outfile, "", decl, 0);
 269           }
 270 #endif
 271         else if (i == 4 && NOTE_P (in_rtx))
 272           {
 273             switch (NOTE_KIND (in_rtx))
 274               {
 275               case NOTE_INSN_EH_REGION_BEG:
 276               case NOTE_INSN_EH_REGION_END:
 277                 if (flag_dump_unnumbered)
 278                   fprintf (outfile, " #");
 279                 else
 280                   fprintf (outfile, " %d", NOTE_EH_HANDLER (in_rtx));
 281                 sawclose = 1;
 282                 break;
 283
 284               case NOTE_INSN_BLOCK_BEG:
 285               case NOTE_INSN_BLOCK_END:
 286 #ifndef GENERATOR_FILE
 287                 dump_addr (outfile, " ", NOTE_BLOCK (in_rtx));
 288 #endif
 289                 sawclose = 1;
 290                 break;
 291
 292               case NOTE_INSN_BASIC_BLOCK:
 293                 {
 294 #ifndef GENERATOR_FILE
 295                   basic_block bb = NOTE_BASIC_BLOCK (in_rtx);
 296                   if (bb != 0)
 297                     fprintf (outfile, " [bb %d]", bb->index);
 298 #endif
 299                   break;
 300                 }
 301
 302               case NOTE_INSN_DELETED_LABEL:
 303                 {
 304                   const char *label = NOTE_DELETED_LABEL_NAME (in_rtx);
 305                   if (label)
 306                     fprintf (outfile, " (\"%s\")", label);
 307                   else
 308                     fprintf (outfile, " \"\"");
 309                 }
 310                 break;
 311
 312               case NOTE_INSN_SWITCH_TEXT_SECTIONS:
 313                 {
 314 #ifndef GENERATOR_FILE
 315                   basic_block bb = NOTE_BASIC_BLOCK (in_rtx);
 316                   if (bb != 0)
 317                     fprintf (outfile, " [bb %d]", bb->index);
 318 #endif
 319                   break;
 320                 }
 321
 322               case NOTE_INSN_VAR_LOCATION:
 323 #ifndef GENERATOR_FILE
 324                 fprintf (outfile, " (");
 325                 print_mem_expr (outfile, NOTE_VAR_LOCATION_DECL (in_rtx));
 326                 fprintf (outfile, " ");
 327                 print_rtx (NOTE_VAR_LOCATION_LOC (in_rtx));
 328                 fprintf (outfile, ")");
 329 #endif
 330                 break;
 331
 332               default:
 333                 break;
 334               }
 335           }
 336         break;
 337
 338       case 'e':
 339       do_e:
 340         indent += 2;
 341         if (!sawclose)
 342           fprintf (outfile, " ");
 343         print_rtx (XEXP (in_rtx, i));
 344         indent -= 2;
 345         break;
 346
 347       case 'E':
 348       case 'V':
 349         indent += 2;
 350         if (sawclose)
 351           {
 352             fprintf (outfile, "\n%s%*s",
 353                      print_rtx_head, indent * 2, "");
 354             sawclose = 0;
 355           }
 356         fputs (" [", outfile);
 357         if (NULL != XVEC (in_rtx, i))
 358           {
 359             indent += 2;
 360             if (XVECLEN (in_rtx, i))
 361               sawclose = 1;
 362
 363             for (j = 0; j < XVECLEN (in_rtx, i); j++)
 364               print_rtx (XVECEXP (in_rtx, i, j));
 365
 366             indent -= 2;
 367           }
 368         if (sawclose)
 369           fprintf (outfile, "\n%s%*s", print_rtx_head, indent * 2, "");
 370
 371         fputs ("]", outfile);
 372         sawclose = 1;
 373         indent -= 2;
 374         break;
 375
 376       case 'w':
 377         if (! flag_simple)
 378           fprintf (outfile, " ");
 379         fprintf (outfile, HOST_WIDE_INT_PRINT_DEC, XWINT (in_rtx, i));
 380         if (! flag_simple)
 381           fprintf (outfile, " [" HOST_WIDE_INT_PRINT_HEX "]",
 382                    XWINT (in_rtx, i));
 383         break;
 384
 385       case 'i':
 386         if (i == 4 && INSN_P (in_rtx))
 387           {
 388 #ifndef GENERATOR_FILE
 389             /*  Pretty-print insn locators.  Ignore scoping as it is mostly
 390                 redundant with line number information and do not print anything
 391                 when there is no location information available.  */
 392             if (INSN_LOCATOR (in_rtx) && insn_file (in_rtx))
 393               fprintf(outfile, " %s:%i", insn_file (in_rtx), insn_line (in_rtx));
 394 #endif
 395           }
 396         else if (i == 6 && NOTE_P (in_rtx))
 397           {
 398             /* This field is only used for NOTE_INSN_DELETED_LABEL, and
 399                other times often contains garbage from INSN->NOTE death.  */
 400             if (NOTE_KIND (in_rtx) == NOTE_INSN_DELETED_LABEL)
 401               fprintf (outfile, " %d",  XINT (in_rtx, i));
 402           }
 403         else
 404           {
 405             int value = XINT (in_rtx, i);
 406             const char *name;
 407
 408 #ifndef GENERATOR_FILE
 409             if (REG_P (in_rtx) && value < FIRST_PSEUDO_REGISTER)
 410               fprintf (outfile, " %d %s", REGNO (in_rtx),
 411                        reg_names[REGNO (in_rtx)]);
 412             else if (REG_P (in_rtx)
 413                      && value <= LAST_VIRTUAL_REGISTER)
 414               {
 415                 if (value == VIRTUAL_INCOMING_ARGS_REGNUM)
 416                   fprintf (outfile, " %d virtual-incoming-args", value);
 417                 else if (value == VIRTUAL_STACK_VARS_REGNUM)
 418                   fprintf (outfile, " %d virtual-stack-vars", value);
 419                 else if (value == VIRTUAL_STACK_DYNAMIC_REGNUM)
 420                   fprintf (outfile, " %d virtual-stack-dynamic", value);
 421                 else if (value == VIRTUAL_OUTGOING_ARGS_REGNUM)
 422                   fprintf (outfile, " %d virtual-outgoing-args", value);
 423                 else if (value == VIRTUAL_CFA_REGNUM)
 424                   fprintf (outfile, " %d virtual-cfa", value);
 425                 else
 426                   fprintf (outfile, " %d virtual-reg-%d", value,
 427                            value-FIRST_VIRTUAL_REGISTER);
 428               }
 429             else
 430 #endif
 431               if (flag_dump_unnumbered
 432                      && (is_insn || NOTE_P (in_rtx)))
 433               fputc ('#', outfile);
 434             else
 435               fprintf (outfile, " %d", value);
 436
 437 #ifndef GENERATOR_FILE
 438             if (REG_P (in_rtx) && REG_ATTRS (in_rtx))
 439               {
 440                 fputs (" [", outfile);
 441                 if (ORIGINAL_REGNO (in_rtx) != REGNO (in_rtx))
 442                   fprintf (outfile, "orig:%i", ORIGINAL_REGNO (in_rtx));
 443                 if (REG_EXPR (in_rtx))
 444                   print_mem_expr (outfile, REG_EXPR (in_rtx));
 445
 446                 if (REG_OFFSET (in_rtx))
 447                   fprintf (outfile, "+" HOST_WIDE_INT_PRINT_DEC,
 448                            REG_OFFSET (in_rtx));
 449                 fputs (" ]", outfile);
 450               }
 451 #endif
 452
 453             if (is_insn && &INSN_CODE (in_rtx) == &XINT (in_rtx, i)
 454                 && XINT (in_rtx, i) >= 0
 455                 && (name = get_insn_name (XINT (in_rtx, i))) != NULL)
 456               fprintf (outfile, " {%s}", name);
 457             sawclose = 0;
 458           }
 459         break;
 460
 461       /* Print NOTE_INSN names rather than integer codes.  */
 462
 463       case 'n':
 464         fprintf (outfile, " %s", GET_NOTE_INSN_NAME (XINT (in_rtx, i)));
 465         sawclose = 0;
 466         break;
 467
 468       case 'u':
 469         if (XEXP (in_rtx, i) != NULL)
 470           {
 471             rtx sub = XEXP (in_rtx, i);
 472             enum rtx_code subc = GET_CODE (sub);
 473
 474             if (GET_CODE (in_rtx) == LABEL_REF)
 475               {
 476                 if (subc == NOTE
 477                     && NOTE_KIND (sub) == NOTE_INSN_DELETED_LABEL)
 478                   {
 479                     if (flag_dump_unnumbered)
 480                       fprintf (outfile, " [# deleted]");
 481                     else
 482                       fprintf (outfile, " [%d deleted]", INSN_UID (sub));
 483                     sawclose = 0;
 484                     break;
 485                   }
 486
 487                 if (subc != CODE_LABEL)
 488                   goto do_e;
 489               }
 490
 491             if (flag_dump_unnumbered)
 492               fputs (" #", outfile);
 493             else
 494               fprintf (outfile, " %d", INSN_UID (sub));
 495           }
 496         else
 497           fputs (" 0", outfile);
 498         sawclose = 0;
 499         break;
 500
 501       case 'b':
 502 #ifndef GENERATOR_FILE
 503         if (XBITMAP (in_rtx, i) == NULL)
 504           fputs (" {null}", outfile);
 505         else
 506           bitmap_print (outfile, XBITMAP (in_rtx, i), " {", "}");
 507 #endif
 508         sawclose = 0;
 509         break;
 510
 511       case 't':
 512 #ifndef GENERATOR_FILE
 513         dump_addr (outfile, " ", XTREE (in_rtx, i));
 514 #endif
 515         break;
 516
 517       case '*':
 518         fputs (" Unknown", outfile);
 519         sawclose = 0;
 520         break;
 521
 522       case 'B':
 523 #ifndef GENERATOR_FILE
 524         if (XBBDEF (in_rtx, i))
 525           fprintf (outfile, " %i", XBBDEF (in_rtx, i)->index);
 526 #endif
 527         break;
 528
 529       default:
 530         gcc_unreachable ();
 531       }
 532
 533   switch (GET_CODE (in_rtx))
 534     {
 535 #ifndef GENERATOR_FILE
 536     case MEM:
 537       fprintf (outfile, " [" HOST_WIDE_INT_PRINT_DEC, MEM_ALIAS_SET (in_rtx));
 538
 539       if (MEM_EXPR (in_rtx))
 540         print_mem_expr (outfile, MEM_EXPR (in_rtx));
 541
 542       if (MEM_OFFSET (in_rtx))
 543         fprintf (outfile, "+" HOST_WIDE_INT_PRINT_DEC,
 544                  INTVAL (MEM_OFFSET (in_rtx)));
 545
 546       if (MEM_SIZE (in_rtx))
 547         fprintf (outfile, " S" HOST_WIDE_INT_PRINT_DEC,
 548                  INTVAL (MEM_SIZE (in_rtx)));
 549
 550       if (MEM_ALIGN (in_rtx) != 1)
 551         fprintf (outfile, " A%u", MEM_ALIGN (in_rtx));
 552
 553       fputc (']', outfile);
 554       break;
 555
 556     case CONST_DOUBLE:
 557       if (FLOAT_MODE_P (GET_MODE (in_rtx)))
 558         {
 559           char s[60];
 560
 561           real_to_decimal (s, CONST_DOUBLE_REAL_VALUE (in_rtx),
 562                            sizeof (s), 0, 1);
 563           fprintf (outfile, " %s", s);
 564
 565           real_to_hexadecimal (s, CONST_DOUBLE_REAL_VALUE (in_rtx),
 566                                sizeof (s), 0, 1);
 567           fprintf (outfile, " [%s]", s);
 568         }
 569       break;
 570 #endif
 571
 572     case CODE_LABEL:
 573       fprintf (outfile, " [%d uses]", LABEL_NUSES (in_rtx));
 574       switch (LABEL_KIND (in_rtx))
 575         {
 576           case LABEL_NORMAL: break;
 577           case LABEL_STATIC_ENTRY: fputs (" [entry]", outfile); break;
 578           case LABEL_GLOBAL_ENTRY: fputs (" [global entry]", outfile); break;
 579           case LABEL_WEAK_ENTRY: fputs (" [weak entry]", outfile); break;
 580           default: gcc_unreachable ();
 581         }
 582       break;
 583
 584     default:
 585       break;
 586     }
 587
 588   if (dump_for_graph
 589       && (is_insn || NOTE_P (in_rtx)
 590           || LABEL_P (in_rtx) || BARRIER_P (in_rtx)))
 591     sawclose = 0;
 592   else
 593     {
 594       fputc (')', outfile);
 595       sawclose = 1;
 596     }
 597 }
 598
 599 /* Print an rtx on the current line of FILE.  Initially indent IND
 600    characters.  */
 601
 602 void
 603 print_inline_rtx (FILE *outf, rtx x, int ind)
 604 {
 605   int oldsaw = sawclose;
 606   int oldindent = indent;
 607
 608   sawclose = 0;
 609   indent = ind;
 610   outfile = outf;
 611   print_rtx (x);
 612   sawclose = oldsaw;
 613   indent = oldindent;
 614 }
 615
 616 /* Call this function from the debugger to see what X looks like.  */
 617
 618 void
 619 debug_rtx (rtx x)
 620 {
 621   outfile = stderr;
 622   sawclose = 0;
 623   print_rtx (x);
 624   fprintf (stderr, "\n");
 625 }
 626
 627 /* Count of rtx's to print with debug_rtx_list.
 628    This global exists because gdb user defined commands have no arguments.  */
 629
 630 int debug_rtx_count = 0;        /* 0 is treated as equivalent to 1 */
 631
 632 /* Call this function to print list from X on.
 633
 634    N is a count of the rtx's to print. Positive values print from the specified
 635    rtx on.  Negative values print a window around the rtx.
 636    EG: -5 prints 2 rtx's on either side (in addition to the specified rtx).  */
 637
 638 void
 639 debug_rtx_list (rtx x, int n)
 640 {
 641   int i,count;
 642   rtx insn;
 643
 644   count = n == 0 ? 1 : n < 0 ? -n : n;
 645
 646   /* If we are printing a window, back up to the start.  */
 647
 648   if (n < 0)
 649     for (i = count / 2; i > 0; i--)
 650       {
 651         if (PREV_INSN (x) == 0)
 652           break;
 653         x = PREV_INSN (x);
 654       }
 655
 656   for (i = count, insn = x; i > 0 && insn != 0; i--, insn = NEXT_INSN (insn))
 657     {
 658       debug_rtx (insn);
 659       fprintf (stderr, "\n");
 660     }
 661 }
 662
 663 /* Call this function to print an rtx list from START to END inclusive.  */
 664
 665 void
 666 debug_rtx_range (rtx start, rtx end)
 667 {
 668   while (1)
 669     {
 670       debug_rtx (start);
 671       fprintf (stderr, "\n");
 672       if (!start || start == end)
 673         break;
 674       start = NEXT_INSN (start);
 675     }
 676 }
 677
 678 /* Call this function to search an rtx list to find one with insn uid UID,
 679    and then call debug_rtx_list to print it, using DEBUG_RTX_COUNT.
 680    The found insn is returned to enable further debugging analysis.  */
 681
 682 rtx
 683 debug_rtx_find (rtx x, int uid)
 684 {
 685   while (x != 0 && INSN_UID (x) != uid)
 686     x = NEXT_INSN (x);
 687   if (x != 0)
 688     {
 689       debug_rtx_list (x, debug_rtx_count);
 690       return x;
 691     }
 692   else
 693     {
 694       fprintf (stderr, "insn uid %d not found\n", uid);
 695       return 0;
 696     }
 697 }
 698
 699 /* External entry point for printing a chain of insns
 700    starting with RTX_FIRST onto file OUTF.
 701    A blank line separates insns.
 702
 703    If RTX_FIRST is not an insn, then it alone is printed, with no newline.  */
 704
 705 void
 706 print_rtl (FILE *outf, rtx rtx_first)
 707 {
 708   rtx tmp_rtx;
 709
 710   outfile = outf;
 711   sawclose = 0;
 712
 713   if (rtx_first == 0)
 714     {
 715       fputs (print_rtx_head, outf);
 716       fputs ("(nil)\n", outf);
 717     }
 718   else
 719     switch (GET_CODE (rtx_first))
 720       {
 721       case INSN:
 722       case JUMP_INSN:
 723       case CALL_INSN:
 724       case NOTE:
 725       case CODE_LABEL:
 726       case BARRIER:
 727         for (tmp_rtx = rtx_first; tmp_rtx != 0; tmp_rtx = NEXT_INSN (tmp_rtx))
 728           {
 729             fputs (print_rtx_head, outfile);
 730             print_rtx (tmp_rtx);
 731             fprintf (outfile, "\n");
 732           }
 733         break;
 734
 735       default:
 736         fputs (print_rtx_head, outfile);
 737         print_rtx (rtx_first);
 738       }
 739 }
 740
 741 /* Like print_rtx, except specify a file.  */
 742 /* Return nonzero if we actually printed anything.  */
 743
 744 int
 745 print_rtl_single (FILE *outf, rtx x)
 746 {
 747   outfile = outf;
 748   sawclose = 0;
 749   if (! flag_dump_unnumbered)
 750     {
 751       fputs (print_rtx_head, outfile);
 752       print_rtx (x);
 753       putc ('\n', outf);
 754       return 1;
 755     }
 756   return 0;
 757 }
 758
 759
 760 /* Like print_rtl except without all the detail; for example,
 761    if RTX is a CONST_INT then print in decimal format.  */
 762
 763 void
 764 print_simple_rtl (FILE *outf, rtx x)
 765 {
 766   flag_simple = 1;
 767   print_rtl (outf, x);
 768   flag_simple = 0;
 769 }