Home | History | Annotate | Download | only in include
      1 /* Insn note definitions.
      2    Copyright (C) 2004-2013 Free Software Foundation, Inc.
      3 
      4 This file is part of GCC.
      5 
      6 GCC is free software; you can redistribute it and/or modify it under
      7 the terms of the GNU General Public License as published by the Free
      8 Software Foundation; either version 3, or (at your option) any later
      9 version.
     10 
     11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
     12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
     13 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
     14 for more details.
     15 
     16 You should have received a copy of the GNU General Public License
     17 along with GCC; see the file COPYING3.  If not see
     18 <http://www.gnu.org/licenses/>.  */
     19 
     20 /* This file defines all the codes that may appear in the
     21    NOTE_LINE_NUMBER field of a NOTE insn for kinds of notes that are
     22    not line numbers.  Source files define DEF_INSN_NOTE appropriately
     23    before including this file.
     24 
     25    We are slowly removing the concept of insn-chain notes from the
     26    compiler.  Adding new codes to this file is STRONGLY DISCOURAGED.
     27    If you think you need one, look for other ways to express what you
     28    mean, such as register notes or bits in the basic-block structure.  */
     29 
     30 /* Shorthand.  */
     31 #define INSN_NOTE(NAME) DEF_INSN_NOTE (NOTE_INSN_##NAME)
     32 
     33 /* This note is used to get rid of an insn when it isn't safe to patch
     34    the insn out of the chain.  */
     35 INSN_NOTE (DELETED)
     36 
     37 /* Generated in place of user-declared labels when they are deleted.  */
     38 INSN_NOTE (DELETED_LABEL)
     39 /* Similarly, but for labels that have been present in debug stmts
     40    earlier and thus will only appear with -g.  These must use different
     41    label namespace.  */
     42 INSN_NOTE (DELETED_DEBUG_LABEL)
     43 
     44 /* These are used to mark the beginning and end of a lexical block.
     45    See NOTE_BLOCK and reorder_blocks.  */
     46 INSN_NOTE (BLOCK_BEG)
     47 INSN_NOTE (BLOCK_END)
     48 
     49 /* This note indicates the start of the real body of the function,
     50    i.e. the point just after all of the parms have been moved into
     51    their homes, etc.  */
     52 INSN_NOTE (FUNCTION_BEG)
     53 
     54 /* This marks the point immediately after the last prologue insn.  */
     55 INSN_NOTE (PROLOGUE_END)
     56 
     57 /* This marks the point immediately prior to the first epilogue insn.  */
     58 INSN_NOTE (EPILOGUE_BEG)
     59 
     60 /* These note where exception handling regions begin and end.
     61    Uses NOTE_EH_HANDLER to identify the region in question.  */
     62 INSN_NOTE (EH_REGION_BEG)
     63 INSN_NOTE (EH_REGION_END)
     64 
     65 /* The location of a variable.  */
     66 INSN_NOTE (VAR_LOCATION)
     67 
     68 /* The values passed to callee.  */
     69 INSN_NOTE (CALL_ARG_LOCATION)
     70 
     71 /* Record the struct for the following basic block.  Uses
     72    NOTE_BASIC_BLOCK.  FIXME: Redundant with the basic block pointer
     73    now included in every insn.  NOTE: If there's no CFG anymore, in other words,
     74    if BLOCK_FOR_INSN () == NULL, NOTE_BASIC_BLOCK cannot be considered reliable
     75    anymore.  */
     76 INSN_NOTE (BASIC_BLOCK)
     77 
     78 /* Mark the inflection point in the instruction stream where we switch
     79    between hot and cold text sections.  */
     80 INSN_NOTE (SWITCH_TEXT_SECTIONS)
     81 
     82 /* When emitting dwarf2 frame information, contains a directive that
     83    should be emitted.  */
     84 INSN_NOTE (CFI)
     85 
     86 /* When emitting dwarf2 frame information, contains the number of a debug
     87    label that should be emitted.  */
     88 INSN_NOTE (CFI_LABEL)
     89 
     90 #undef INSN_NOTE
     91