gcc/print-rtl.c

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