gcc/print-rtl.c

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