gas/dw2gencfi.h

   1 /* dw2gencfi.h - Support for generating Dwarf2 CFI information.
   2    Copyright (C) 2003-2018 Free Software Foundation, Inc.
   3    Contributed by Michal Ludvig <mludvig@suse.cz>
   4
   5    This file is part of GAS, the GNU Assembler.
   6
   7    GAS is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 3, or (at your option)
  10    any later version.
  11
  12    GAS is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with GAS; see the file COPYING.  If not, write to the Free
  19    Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
  20    02110-1301, USA.  */
  21
  22 #ifndef DW2GENCFI_H
  23 #define DW2GENCFI_H
  24
  25 #include "dwarf2.h"
  26
  27 struct symbol;
  28
  29 extern const pseudo_typeS cfi_pseudo_table[];
  30
  31 /* cfi_finish() is called at the end of file. It will complain if
  32    the last CFI wasn't properly closed by .cfi_endproc.  */
  33 extern void cfi_finish (void);
  34
  35 /* Entry points for backends to add unwind information.  */
  36 extern void cfi_new_fde (struct symbol *);
  37 extern void cfi_end_fde (struct symbol *);
  38 extern void cfi_set_return_column (unsigned);
  39 extern void cfi_set_sections (void);
  40 extern void cfi_add_advance_loc (struct symbol *);
  41 extern void cfi_add_label (const char *);
  42
  43 extern void cfi_add_CFA_offset (unsigned, offsetT);
  44 extern void cfi_add_CFA_val_offset (unsigned, offsetT);
  45 extern void cfi_add_CFA_def_cfa (unsigned, offsetT);
  46 extern void cfi_add_CFA_register (unsigned, unsigned);
  47 extern void cfi_add_CFA_def_cfa_register (unsigned);
  48 extern void cfi_add_CFA_def_cfa_offset (offsetT);
  49 extern void cfi_add_CFA_restore (unsigned);
  50 extern void cfi_add_CFA_undefined (unsigned);
  51 extern void cfi_add_CFA_same_value (unsigned);
  52 extern void cfi_add_CFA_remember_state (void);
  53 extern void cfi_add_CFA_restore_state (void);
  54
  55 /* Structures for md_cfi_end.  */
  56
  57 #if defined (TE_PE) || defined (TE_PEP)
  58 #define SUPPORT_FRAME_LINKONCE 1
  59 #else
  60 #define SUPPORT_FRAME_LINKONCE 0
  61 #endif
  62
  63 #ifdef tc_cfi_reloc_for_encoding
  64 #define SUPPORT_COMPACT_EH 1
  65 #else
  66 #define SUPPORT_COMPACT_EH 0
  67 #endif
  68
  69 #define MULTIPLE_FRAME_SECTIONS (SUPPORT_FRAME_LINKONCE || SUPPORT_COMPACT_EH)
  70
  71 struct cfi_insn_data
  72 {
  73   struct cfi_insn_data *next;
  74 #if MULTIPLE_FRAME_SECTIONS
  75   segT cur_seg;
  76 #endif
  77   int insn;
  78   union
  79   {
  80     struct
  81     {
  82       unsigned reg;
  83       offsetT offset;
  84     } ri;
  85
  86     struct
  87     {
  88       unsigned reg1;
  89       unsigned reg2;
  90     } rr;
  91
  92     unsigned r;
  93     offsetT i;
  94
  95     struct
  96     {
  97       symbolS *lab1;
  98       symbolS *lab2;
  99     } ll;
 100
 101     struct cfi_escape_data *esc;
 102
 103     struct
 104     {
 105       unsigned reg, encoding;
 106       expressionS exp;
 107     } ea;
 108
 109     const char *sym_name;
 110   } u;
 111 };
 112
 113 /* An enumeration describing the Compact EH header format.  The least
 114    significant bit is used to distinguish the entries.
 115
 116    Inline Compact:                      Function offset [0]
 117                                         Four chars of unwind data.
 118    Out-of-line Compact:                 Function offset [1]
 119                                         Compact unwind data offset [0]
 120    Legacy:                              Function offset [1]
 121                                         Unwind data offset [1]
 122
 123    The header type is initialized to EH_COMPACT_UNKNOWN until the
 124    format is discovered by encountering a .fde_data entry.
 125    Failure to find a .fde_data entry will cause an EH_COMPACT_LEGACY
 126    header to be generated.  */
 127
 128 enum {
 129   EH_COMPACT_UNKNOWN,
 130   EH_COMPACT_LEGACY,
 131   EH_COMPACT_INLINE,
 132   EH_COMPACT_OUTLINE,
 133   EH_COMPACT_OUTLINE_DONE,
 134   /* Outline if .cfi_inline_lsda used, otherwise legacy FDE.  */
 135   EH_COMPACT_HAS_LSDA
 136 };
 137
 138 struct fde_entry
 139 {
 140   struct fde_entry *next;
 141 #if MULTIPLE_FRAME_SECTIONS
 142   segT cur_seg;
 143 #endif
 144   symbolS *start_address;
 145   symbolS *end_address;
 146   struct cfi_insn_data *data;
 147   struct cfi_insn_data **last;
 148   unsigned char per_encoding;
 149   unsigned char lsda_encoding;
 150   int personality_id;
 151   expressionS personality;
 152   expressionS lsda;
 153   unsigned int return_column;
 154   unsigned int signal_frame;
 155 #if MULTIPLE_FRAME_SECTIONS
 156   int handled;
 157 #endif
 158   int eh_header_type;
 159   /* Compact unwinding opcodes, not including the PR byte or LSDA.  */
 160   int eh_data_size;
 161   bfd_byte *eh_data;
 162   /* For out of line tables and FDEs.  */
 163   symbolS *eh_loc;
 164   int sections;
 165 };
 166
 167 /* The list of all FDEs that have been collected.  */
 168 extern struct fde_entry *all_fde_data;
 169
 170 /* Fake CFI type; outside the byte range of any real CFI insn.  */
 171 #define CFI_adjust_cfa_offset   0x100
 172 #define CFI_return_column       0x101
 173 #define CFI_rel_offset          0x102
 174 #define CFI_escape              0x103
 175 #define CFI_signal_frame        0x104
 176 #define CFI_val_encoded_addr    0x105
 177 #define CFI_label               0x106
 178
 179 /* By default emit .eh_frame only, not .debug_frame.  */
 180 #define CFI_EMIT_eh_frame               (1 << 0)
 181 #define CFI_EMIT_debug_frame            (1 << 1)
 182 #define CFI_EMIT_target                 (1 << 2)
 183 #define CFI_EMIT_eh_frame_compact       (1 << 3)
 184
 185 #endif /* DW2GENCFI_H */