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       fprintf (outfile, ".%s",
  92                IDENTIFIER_POINTER (DECL_NAME (TREE_OPERAND (expr, 1))));
  93     }
  94   else if (DECL_NAME (expr))
  95     fprintf (outfile, " %s", IDENTIFIER_POINTER (DECL_NAME (expr)));
  96   else if (TREE_CODE (expr) == RESULT_DECL)
  97     fputs (" <result>", outfile);
  98   else
  99     fputs (" <anonymous>", outfile);
 100 }
 101
 102 /* Print IN_RTX onto OUTFILE.  This is the recursive part of printing.  */
 103
 104 static void
 105 print_rtx (in_rtx)
 106      rtx in_rtx;
 107 {
 108   int i = 0;
 109   int j;
 110   const char *format_ptr;
 111   int is_insn;
 112   rtx tem;
 113
 114   if (sawclose)
 115     {
 116       if (flag_simple)
 117         fputc (' ', outfile);
 118       else
 119         fprintf (outfile, "\n%s%*s", print_rtx_head, indent * 2, "");
 120       sawclose = 0;
 121     }
 122
 123   if (in_rtx == 0)
 124     {
 125       fputs ("(nil)", outfile);
 126       sawclose = 1;
 127       return;
 128     }
 129   else if (GET_CODE (in_rtx) > NUM_RTX_CODE)
 130     {
 131        fprintf (outfile, "(??? bad code %d\n)", GET_CODE (in_rtx));
 132        sawclose = 1;
 133        return;
 134     }
 135
 136   is_insn = INSN_P (in_rtx);
 137
 138   /* When printing in VCG format we write INSNs, NOTE, LABEL, and BARRIER
 139      in separate nodes and therefore have to handle them special here.  */
 140   if (dump_for_graph
 141       && (is_insn || GET_CODE (in_rtx) == NOTE
 142           || GET_CODE (in_rtx) == CODE_LABEL || GET_CODE (in_rtx) == BARRIER))
 143     {
 144       i = 3;
 145       indent = 0;
 146     }
 147   else
 148     {
 149       /* Print name of expression code.  */
 150       if (flag_simple && GET_CODE (in_rtx) == CONST_INT)
 151         fputc ('(', outfile);
 152       else
 153         fprintf (outfile, "(%s", GET_RTX_NAME (GET_CODE (in_rtx)));
 154
 155       if (! flag_simple)
 156         {
 157           if (RTX_FLAG (in_rtx, in_struct))
 158             fputs ("/s", outfile);
 159
 160           if (RTX_FLAG (in_rtx, volatil))
 161             fputs ("/v", outfile);
 162
 163           if (RTX_FLAG (in_rtx, unchanging))
 164             fputs ("/u", outfile);
 165
 166           if (RTX_FLAG (in_rtx, integrated))
 167             fputs ("/i", outfile);
 168
 169           if (RTX_FLAG (in_rtx, frame_related))
 170             fputs ("/f", outfile);
 171
 172           if (RTX_FLAG (in_rtx, jump))
 173             fputs ("/j", outfile);
 174
 175           if (RTX_FLAG (in_rtx, call))
 176             fputs ("/c", outfile);
 177
 178           if (GET_MODE (in_rtx) != VOIDmode)
 179             {
 180               /* Print REG_NOTE names for EXPR_LIST and INSN_LIST.  */
 181               if (GET_CODE (in_rtx) == EXPR_LIST
 182                   || GET_CODE (in_rtx) == INSN_LIST)
 183                 fprintf (outfile, ":%s",
 184                          GET_REG_NOTE_NAME (GET_MODE (in_rtx)));
 185               else
 186                 fprintf (outfile, ":%s", GET_MODE_NAME (GET_MODE (in_rtx)));
 187             }
 188         }
 189     }
 190
 191   /* Get the format string and skip the first elements if we have handled
 192      them already.  */
 193   format_ptr = GET_RTX_FORMAT (GET_CODE (in_rtx)) + i;
 194   for (; i < GET_RTX_LENGTH (GET_CODE (in_rtx)); i++)
 195     switch (*format_ptr++)
 196       {
 197         const char *str;
 198
 199       case 'T':
 200         str = XTMPL (in_rtx, i);
 201         goto string;
 202
 203       case 'S':
 204       case 's':
 205         str = XSTR (in_rtx, i);
 206       string:
 207
 208         if (str == 0)
 209           fputs (dump_for_graph ? " \\\"\\\"" : " \"\"", outfile);
 210         else
 211           {
 212             if (dump_for_graph)
 213               fprintf (outfile, " (\\\"%s\\\")", str);
 214             else
 215               fprintf (outfile, " (\"%s\")", str);
 216           }
 217         sawclose = 1;
 218         break;
 219
 220         /* 0 indicates a field for internal use that should not be printed.
 221            An exception is the third field of a NOTE, where it indicates
 222            that the field has several different valid contents.  */
 223       case '0':
 224         if (i == 1 && GET_CODE (in_rtx) == REG)
 225           {
 226             if (REGNO (in_rtx) != ORIGINAL_REGNO (in_rtx))
 227               fprintf (outfile, " [%d]", ORIGINAL_REGNO (in_rtx));
 228             break;
 229           }
 230         if (i == 3 && GET_CODE (in_rtx) == NOTE)
 231           {
 232             switch (NOTE_LINE_NUMBER (in_rtx))
 233               {
 234               case NOTE_INSN_EH_REGION_BEG:
 235               case NOTE_INSN_EH_REGION_END:
 236                 if (flag_dump_unnumbered)
 237                   fprintf (outfile, " #");
 238                 else
 239                   fprintf (outfile, " %d", NOTE_EH_HANDLER (in_rtx));
 240                 sawclose = 1;
 241                 break;
 242
 243               case NOTE_INSN_BLOCK_BEG:
 244               case NOTE_INSN_BLOCK_END:
 245                 fprintf (outfile, " ");
 246                 if (flag_dump_unnumbered)
 247                   fprintf (outfile, "#");
 248                 else
 249                   fprintf (outfile, HOST_PTR_PRINTF,
 250                            (char *) NOTE_BLOCK (in_rtx));
 251                 sawclose = 1;
 252                 break;
 253
 254               case NOTE_INSN_RANGE_BEG:
 255               case NOTE_INSN_RANGE_END:
 256               case NOTE_INSN_LIVE:
 257                 indent += 2;
 258                 if (!sawclose)
 259                   fprintf (outfile, " ");
 260                 print_rtx (NOTE_RANGE_INFO (in_rtx));
 261                 indent -= 2;
 262                 break;
 263
 264               case NOTE_INSN_BASIC_BLOCK:
 265                 {
 266                   basic_block bb = NOTE_BASIC_BLOCK (in_rtx);
 267                   if (bb != 0)
 268                     fprintf (outfile, " [bb %d]", bb->index);
 269                   break;
 270                 }
 271
 272               case NOTE_INSN_EXPECTED_VALUE:
 273                 indent += 2;
 274                 if (!sawclose)
 275                   fprintf (outfile, " ");
 276                 print_rtx (NOTE_EXPECTED_VALUE (in_rtx));
 277                 indent -= 2;
 278                 break;
 279
 280               case NOTE_INSN_DELETED_LABEL:
 281                 if (NOTE_SOURCE_FILE (in_rtx))
 282                   fprintf (outfile, " (\"%s\")", NOTE_SOURCE_FILE (in_rtx));
 283                 else
 284                   fprintf (outfile, " \"\"");
 285                 break;
 286
 287               case NOTE_INSN_PREDICTION:
 288                 if (NOTE_PREDICTION (in_rtx))
 289                   fprintf (outfile, " [ %d %d ] ",
 290                            (int)NOTE_PREDICTION_ALG (in_rtx),
 291                            (int) NOTE_PREDICTION_FLAGS (in_rtx));
 292                 else
 293                   fprintf (outfile, " [ ERROR ]");
 294                 break;
 295
 296               default:
 297                 {
 298                   const char * const str = X0STR (in_rtx, i);
 299
 300                   if (NOTE_LINE_NUMBER (in_rtx) < 0)
 301                     ;
 302                   else if (str == 0)
 303                     fputs (dump_for_graph ? " \\\"\\\"" : " \"\"", outfile);
 304                   else
 305                     {
 306                       if (dump_for_graph)
 307                         fprintf (outfile, " (\\\"%s\\\")", str);
 308                       else
 309                         fprintf (outfile, " (\"%s\")", str);
 310                     }
 311                   break;
 312                 }
 313               }
 314           }
 315         break;
 316
 317       case 'e':
 318       do_e:
 319         indent += 2;
 320         if (!sawclose)
 321           fprintf (outfile, " ");
 322         print_rtx (XEXP (in_rtx, i));
 323         indent -= 2;
 324         break;
 325
 326       case 'E':
 327       case 'V':
 328         indent += 2;
 329         if (sawclose)
 330           {
 331             fprintf (outfile, "\n%s%*s",
 332                      print_rtx_head, indent * 2, "");
 333             sawclose = 0;
 334           }
 335         fputs ("[ ", outfile);
 336         if (NULL != XVEC (in_rtx, i))
 337           {
 338             indent += 2;
 339             if (XVECLEN (in_rtx, i))
 340               sawclose = 1;
 341
 342             for (j = 0; j < XVECLEN (in_rtx, i); j++)
 343               print_rtx (XVECEXP (in_rtx, i, j));
 344
 345             indent -= 2;
 346           }
 347         if (sawclose)
 348           fprintf (outfile, "\n%s%*s", print_rtx_head, indent * 2, "");
 349
 350         fputs ("] ", outfile);
 351         sawclose = 1;
 352         indent -= 2;
 353         break;
 354
 355       case 'w':
 356         if (! flag_simple)
 357           fprintf (outfile, " ");
 358         fprintf (outfile, HOST_WIDE_INT_PRINT_DEC, XWINT (in_rtx, i));
 359         if (! flag_simple)
 360           {
 361             fprintf (outfile, " [");
 362             fprintf (outfile, HOST_WIDE_INT_PRINT_HEX, XWINT (in_rtx, i));
 363             fprintf (outfile, "]");
 364           }
 365         break;
 366
 367       case 'i':
 368         if (i == 5 && GET_CODE (in_rtx) == NOTE)
 369           {
 370             /* This field is only used for NOTE_INSN_DELETED_LABEL, and
 371                other times often contains garbage from INSN->NOTE death.  */
 372             if (NOTE_LINE_NUMBER (in_rtx) == NOTE_INSN_DELETED_LABEL)
 373               fprintf (outfile, " %d",  XINT (in_rtx, i));
 374           }
 375         else
 376           {
 377             int value = XINT (in_rtx, i);
 378             const char *name;
 379
 380             if (GET_CODE (in_rtx) == REG && value < FIRST_PSEUDO_REGISTER)
 381               {
 382                 fputc (' ', outfile);
 383                 DEBUG_PRINT_REG (in_rtx, 0, outfile);
 384               }
 385             else if (GET_CODE (in_rtx) == REG
 386                      && value <= LAST_VIRTUAL_REGISTER)
 387               {
 388                 if (value == VIRTUAL_INCOMING_ARGS_REGNUM)
 389                   fprintf (outfile, " %d virtual-incoming-args", value);
 390                 else if (value == VIRTUAL_STACK_VARS_REGNUM)
 391                   fprintf (outfile, " %d virtual-stack-vars", value);
 392                 else if (value == VIRTUAL_STACK_DYNAMIC_REGNUM)
 393                   fprintf (outfile, " %d virtual-stack-dynamic", value);
 394                 else if (value == VIRTUAL_OUTGOING_ARGS_REGNUM)
 395                   fprintf (outfile, " %d virtual-outgoing-args", value);
 396                 else if (value == VIRTUAL_CFA_REGNUM)
 397                   fprintf (outfile, " %d virtual-cfa", value);
 398                 else
 399                   fprintf (outfile, " %d virtual-reg-%d", value,
 400                            value-FIRST_VIRTUAL_REGISTER);
 401               }
 402             else if (flag_dump_unnumbered
 403                      && (is_insn || GET_CODE (in_rtx) == NOTE))
 404               fputc ('#', outfile);
 405             else
 406               fprintf (outfile, " %d", value);
 407
 408             if (is_insn && &INSN_CODE (in_rtx) == &XINT (in_rtx, i)
 409                 && XINT (in_rtx, i) >= 0
 410                 && (name = get_insn_name (XINT (in_rtx, i))) != NULL)
 411               fprintf (outfile, " {%s}", name);
 412             sawclose = 0;
 413           }
 414         break;
 415
 416       /* Print NOTE_INSN names rather than integer codes.  */
 417
 418       case 'n':
 419         if (XINT (in_rtx, i) >= (int) NOTE_INSN_BIAS
 420             && XINT (in_rtx, i) < (int) NOTE_INSN_MAX)
 421           fprintf (outfile, " %s", GET_NOTE_INSN_NAME (XINT (in_rtx, i)));
 422         else
 423           fprintf (outfile, " %d", XINT (in_rtx, i));
 424         sawclose = 0;
 425         break;
 426
 427       case 'u':
 428         if (XEXP (in_rtx, i) != NULL)
 429           {
 430             rtx sub = XEXP (in_rtx, i);
 431             enum rtx_code subc = GET_CODE (sub);
 432
 433             if (GET_CODE (in_rtx) == LABEL_REF)
 434               {
 435                 if (subc == NOTE
 436                     && NOTE_LINE_NUMBER (sub) == NOTE_INSN_DELETED_LABEL)
 437                   {
 438                     if (flag_dump_unnumbered)
 439                       fprintf (outfile, " [# deleted]");
 440                     else
 441                       fprintf (outfile, " [%d deleted]", INSN_UID (sub));
 442                     sawclose = 0;
 443                     break;
 444                   }
 445
 446                 if (subc != CODE_LABEL)
 447                   goto do_e;
 448               }
 449
 450             if (flag_dump_unnumbered)
 451               fputs (" #", outfile);
 452             else
 453               fprintf (outfile, " %d", INSN_UID (sub));
 454           }
 455         else
 456           fputs (" 0", outfile);
 457         sawclose = 0;
 458         break;
 459
 460       case 'b':
 461         if (XBITMAP (in_rtx, i) == NULL)
 462           fputs (" {null}", outfile);
 463         else
 464           bitmap_print (outfile, XBITMAP (in_rtx, i), " {", "}");
 465         sawclose = 0;
 466         break;
 467
 468       case 't':
 469         putc (' ', outfile);
 470         fprintf (outfile, HOST_PTR_PRINTF, (char *) XTREE (in_rtx, i));
 471         break;
 472
 473       case '*':
 474         fputs (" Unknown", outfile);
 475         sawclose = 0;
 476         break;
 477
 478       case 'B':
 479         if (XBBDEF (in_rtx, i))
 480           fprintf (outfile, " %i", XBBDEF (in_rtx, i)->index);
 481         break;
 482
 483       default:
 484         fprintf (stderr,
 485                  "switch format wrong in rtl.print_rtx(). format was: %c.\n",
 486                  format_ptr[-1]);
 487         abort ();
 488       }
 489
 490   switch (GET_CODE (in_rtx))
 491     {
 492     case MEM:
 493       fputs (" [", outfile);
 494       fprintf (outfile, HOST_WIDE_INT_PRINT_DEC, MEM_ALIAS_SET (in_rtx));
 495
 496       if (MEM_EXPR (in_rtx))
 497         print_mem_expr (outfile, MEM_EXPR (in_rtx));
 498
 499       if (MEM_OFFSET (in_rtx))
 500         {
 501           fputc ('+', outfile);
 502           fprintf (outfile, HOST_WIDE_INT_PRINT_DEC,
 503                    INTVAL (MEM_OFFSET (in_rtx)));
 504         }
 505
 506       if (MEM_SIZE (in_rtx))
 507         {
 508           fputs (" S", outfile);
 509           fprintf (outfile, HOST_WIDE_INT_PRINT_DEC,
 510                    INTVAL (MEM_SIZE (in_rtx)));
 511         }
 512
 513       if (MEM_ALIGN (in_rtx) != 1)
 514         fprintf (outfile, " A%u", MEM_ALIGN (in_rtx));
 515
 516       fputc (']', outfile);
 517       break;
 518
 519 #if 0
 520     /* It would be nice to do this, but it would require real.o to
 521        be linked into the MD-generator programs.  Maybe we should
 522        do that.  -zw 2002-03-03  */
 523     case CONST_DOUBLE:
 524       if (FLOAT_MODE_P (GET_MODE (in_rtx)))
 525         {
 526           REAL_VALUE_TYPE val;
 527           char s[30];
 528
 529           REAL_VALUE_FROM_CONST_DOUBLE (val, in_rtx);
 530           REAL_VALUE_TO_DECIMAL (val, "%.16g", s);
 531           fprintf (outfile, " [%s]", s);
 532         }
 533       break;
 534 #endif
 535
 536     case CODE_LABEL:
 537       fprintf (outfile, " [%d uses]", LABEL_NUSES (in_rtx));
 538       if (LABEL_ALTERNATE_NAME (in_rtx))
 539         fprintf (outfile, " [alternate name: %s]",
 540                  LABEL_ALTERNATE_NAME (in_rtx));
 541       break;
 542
 543     case CALL_PLACEHOLDER:
 544       if (debug_call_placeholder_verbose)
 545         {
 546           fputs (" (cond [\n  (const_string \"normal\") (sequence [", outfile);
 547           for (tem = XEXP (in_rtx, 0); tem != 0; tem = NEXT_INSN (tem))
 548             {
 549               fputs ("\n    ", outfile);
 550               print_inline_rtx (outfile, tem, 4);
 551             }
 552
 553           tem = XEXP (in_rtx, 1);
 554           if (tem)
 555             fputs ("\n    ])\n  (const_string \"tail_call\") (sequence [",
 556                    outfile);
 557           for (; tem != 0; tem = NEXT_INSN (tem))
 558             {
 559               fputs ("\n    ", outfile);
 560               print_inline_rtx (outfile, tem, 4);
 561             }
 562
 563           tem = XEXP (in_rtx, 2);
 564           if (tem)
 565             fputs ("\n    ])\n  (const_string \"tail_recursion\") (sequence [",
 566                    outfile);
 567           for (; tem != 0; tem = NEXT_INSN (tem))
 568             {
 569               fputs ("\n    ", outfile);
 570               print_inline_rtx (outfile, tem, 4);
 571             }
 572
 573           fputs ("\n    ])\n  ])", outfile);
 574           break;
 575         }
 576
 577       for (tem = XEXP (in_rtx, 0); tem != 0; tem = NEXT_INSN (tem))
 578         if (GET_CODE (tem) == CALL_INSN)
 579           {
 580             fprintf (outfile, " ");
 581             print_rtx (tem);
 582             break;
 583           }
 584       break;
 585
 586     default:
 587       break;
 588     }
 589
 590   if (dump_for_graph
 591       && (is_insn || GET_CODE (in_rtx) == NOTE
 592           || GET_CODE (in_rtx) == CODE_LABEL || GET_CODE (in_rtx) == BARRIER))
 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 (outf, x, ind)
 606      FILE *outf;
 607      rtx x;
 608      int ind;
 609 {
 610   int oldsaw = sawclose;
 611   int oldindent = indent;
 612
 613   sawclose = 0;
 614   indent = ind;
 615   outfile = outf;
 616   print_rtx (x);
 617   sawclose = oldsaw;
 618   indent = oldindent;
 619 }
 620
 621 /* Call this function from the debugger to see what X looks like.  */
 622
 623 void
 624 debug_rtx (x)
 625      rtx x;
 626 {
 627   outfile = stderr;
 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     debug_rtx (insn);
 665 }
 666
 667 /* Call this function to print an rtx list from START to END inclusive.  */
 668
 669 void
 670 debug_rtx_range (start, end)
 671      rtx start, end;
 672 {
 673   while (1)
 674     {
 675       debug_rtx (start);
 676       if (!start || start == end)
 677         break;
 678       start = NEXT_INSN (start);
 679     }
 680 }
 681
 682 /* Call this function to search an rtx list to find one with insn uid UID,
 683    and then call debug_rtx_list to print it, using DEBUG_RTX_COUNT.
 684    The found insn is returned to enable further debugging analysis.  */
 685
 686 rtx
 687 debug_rtx_find (x, uid)
 688      rtx x;
 689      int uid;
 690 {
 691   while (x != 0 && INSN_UID (x) != uid)
 692     x = NEXT_INSN (x);
 693   if (x != 0)
 694     {
 695       debug_rtx_list (x, debug_rtx_count);
 696       return x;
 697     }
 698   else
 699     {
 700       fprintf (stderr, "insn uid %d not found\n", uid);
 701       return 0;
 702     }
 703 }
 704
 705 /* External entry point for printing a chain of insns
 706    starting with RTX_FIRST onto file OUTF.
 707    A blank line separates insns.
 708
 709    If RTX_FIRST is not an insn, then it alone is printed, with no newline.  */
 710
 711 void
 712 print_rtl (outf, rtx_first)
 713      FILE *outf;
 714      rtx rtx_first;
 715 {
 716   rtx tmp_rtx;
 717
 718   outfile = outf;
 719   sawclose = 0;
 720
 721   if (rtx_first == 0)
 722     {
 723       fputs (print_rtx_head, outf);
 724       fputs ("(nil)\n", outf);
 725     }
 726   else
 727     switch (GET_CODE (rtx_first))
 728       {
 729       case INSN:
 730       case JUMP_INSN:
 731       case CALL_INSN:
 732       case NOTE:
 733       case CODE_LABEL:
 734       case BARRIER:
 735         for (tmp_rtx = rtx_first; tmp_rtx != 0; tmp_rtx = NEXT_INSN (tmp_rtx))
 736           if (! flag_dump_unnumbered
 737               || GET_CODE (tmp_rtx) != NOTE || NOTE_LINE_NUMBER (tmp_rtx) < 0)
 738             {
 739               fputs (print_rtx_head, outfile);
 740               print_rtx (tmp_rtx);
 741               fprintf (outfile, "\n");
 742             }
 743         break;
 744
 745       default:
 746         fputs (print_rtx_head, outfile);
 747         print_rtx (rtx_first);
 748       }
 749 }
 750
 751 /* Like print_rtx, except specify a file.  */
 752 /* Return nonzero if we actually printed anything.  */
 753
 754 int
 755 print_rtl_single (outf, x)
 756      FILE *outf;
 757      rtx x;
 758 {
 759   outfile = outf;
 760   sawclose = 0;
 761   if (! flag_dump_unnumbered
 762       || GET_CODE (x) != NOTE || NOTE_LINE_NUMBER (x) < 0)
 763     {
 764       fputs (print_rtx_head, outfile);
 765       print_rtx (x);
 766       putc ('\n', outf);
 767       return 1;
 768     }
 769   return 0;
 770 }
 771
 772
 773 /* Like print_rtl except without all the detail; for example,
 774    if RTX is a CONST_INT then print in decimal format.  */
 775
 776 void
 777 print_simple_rtl (outf, x)
 778      FILE *outf;
 779      rtx x;
 780 {
 781   flag_simple = 1;
 782   print_rtl (outf, x);
 783   flag_simple = 0;
 784 }