1 /* Xtensa ELF support for BFD. 2 Copyright (C) 2003-2026 Free Software Foundation, Inc. 3 Contributed by Bob Wilson (bwilson (at) tensilica.com) at Tensilica. 4 5 This file is part of BFD, the Binary File Descriptor library. 6 7 This program 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 of the License, or 10 (at your option) any later version. 11 12 This program 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 this program; if not, write to the Free Software 19 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, 20 USA. */ 21 22 /* This file holds definitions specific to the Xtensa ELF ABI. */ 23 24 #ifndef _ELF_XTENSA_H 25 #define _ELF_XTENSA_H 26 27 #include "elf/reloc-macros.h" 28 29 #ifdef __cplusplus 30 extern "C" { 31 #endif 32 33 /* Relocations. */ 34 START_RELOC_NUMBERS (elf_xtensa_reloc_type) 35 RELOC_NUMBER (R_XTENSA_NONE, 0) 36 RELOC_NUMBER (R_XTENSA_32, 1) 37 RELOC_NUMBER (R_XTENSA_RTLD, 2) 38 RELOC_NUMBER (R_XTENSA_GLOB_DAT, 3) 39 RELOC_NUMBER (R_XTENSA_JMP_SLOT, 4) 40 RELOC_NUMBER (R_XTENSA_RELATIVE, 5) 41 RELOC_NUMBER (R_XTENSA_PLT, 6) 42 RELOC_NUMBER (R_XTENSA_OP0, 8) 43 RELOC_NUMBER (R_XTENSA_OP1, 9) 44 RELOC_NUMBER (R_XTENSA_OP2, 10) 45 RELOC_NUMBER (R_XTENSA_ASM_EXPAND, 11) 46 RELOC_NUMBER (R_XTENSA_ASM_SIMPLIFY, 12) 47 RELOC_NUMBER (R_XTENSA_32_PCREL, 14) 48 RELOC_NUMBER (R_XTENSA_GNU_VTINHERIT, 15) 49 RELOC_NUMBER (R_XTENSA_GNU_VTENTRY, 16) 50 RELOC_NUMBER (R_XTENSA_DIFF8, 17) 51 RELOC_NUMBER (R_XTENSA_DIFF16, 18) 52 RELOC_NUMBER (R_XTENSA_DIFF32, 19) 53 RELOC_NUMBER (R_XTENSA_SLOT0_OP, 20) 54 RELOC_NUMBER (R_XTENSA_SLOT1_OP, 21) 55 RELOC_NUMBER (R_XTENSA_SLOT2_OP, 22) 56 RELOC_NUMBER (R_XTENSA_SLOT3_OP, 23) 57 RELOC_NUMBER (R_XTENSA_SLOT4_OP, 24) 58 RELOC_NUMBER (R_XTENSA_SLOT5_OP, 25) 59 RELOC_NUMBER (R_XTENSA_SLOT6_OP, 26) 60 RELOC_NUMBER (R_XTENSA_SLOT7_OP, 27) 61 RELOC_NUMBER (R_XTENSA_SLOT8_OP, 28) 62 RELOC_NUMBER (R_XTENSA_SLOT9_OP, 29) 63 RELOC_NUMBER (R_XTENSA_SLOT10_OP, 30) 64 RELOC_NUMBER (R_XTENSA_SLOT11_OP, 31) 65 RELOC_NUMBER (R_XTENSA_SLOT12_OP, 32) 66 RELOC_NUMBER (R_XTENSA_SLOT13_OP, 33) 67 RELOC_NUMBER (R_XTENSA_SLOT14_OP, 34) 68 RELOC_NUMBER (R_XTENSA_SLOT0_ALT, 35) 69 RELOC_NUMBER (R_XTENSA_SLOT1_ALT, 36) 70 RELOC_NUMBER (R_XTENSA_SLOT2_ALT, 37) 71 RELOC_NUMBER (R_XTENSA_SLOT3_ALT, 38) 72 RELOC_NUMBER (R_XTENSA_SLOT4_ALT, 39) 73 RELOC_NUMBER (R_XTENSA_SLOT5_ALT, 40) 74 RELOC_NUMBER (R_XTENSA_SLOT6_ALT, 41) 75 RELOC_NUMBER (R_XTENSA_SLOT7_ALT, 42) 76 RELOC_NUMBER (R_XTENSA_SLOT8_ALT, 43) 77 RELOC_NUMBER (R_XTENSA_SLOT9_ALT, 44) 78 RELOC_NUMBER (R_XTENSA_SLOT10_ALT, 45) 79 RELOC_NUMBER (R_XTENSA_SLOT11_ALT, 46) 80 RELOC_NUMBER (R_XTENSA_SLOT12_ALT, 47) 81 RELOC_NUMBER (R_XTENSA_SLOT13_ALT, 48) 82 RELOC_NUMBER (R_XTENSA_SLOT14_ALT, 49) 83 RELOC_NUMBER (R_XTENSA_TLSDESC_FN, 50) 84 RELOC_NUMBER (R_XTENSA_TLSDESC_ARG, 51) 85 RELOC_NUMBER (R_XTENSA_TLS_DTPOFF, 52) 86 RELOC_NUMBER (R_XTENSA_TLS_TPOFF, 53) 87 RELOC_NUMBER (R_XTENSA_TLS_FUNC, 54) 88 RELOC_NUMBER (R_XTENSA_TLS_ARG, 55) 89 RELOC_NUMBER (R_XTENSA_TLS_CALL, 56) 90 RELOC_NUMBER (R_XTENSA_PDIFF8, 57) 91 RELOC_NUMBER (R_XTENSA_PDIFF16, 58) 92 RELOC_NUMBER (R_XTENSA_PDIFF32, 59) 93 RELOC_NUMBER (R_XTENSA_NDIFF8, 60) 94 RELOC_NUMBER (R_XTENSA_NDIFF16, 61) 95 RELOC_NUMBER (R_XTENSA_NDIFF32, 62) 96 END_RELOC_NUMBERS (R_XTENSA_max) 97 98 /* Processor-specific flags for the ELF header e_flags field. */ 99 100 /* Four-bit Xtensa machine type field. */ 101 #define EF_XTENSA_MACH 0x0000000f 102 103 /* Various CPU types. */ 104 #define E_XTENSA_MACH 0x00000000 105 106 /* Leave bits 0xf0 alone in case we ever have more than 16 cpu types. 107 Highly unlikely, but what the heck. */ 108 109 #define EF_XTENSA_XT_INSN 0x00000100 110 #define EF_XTENSA_XT_LIT 0x00000200 111 112 113 /* Processor-specific dynamic array tags. */ 114 115 /* Offset of the table that records the GOT location(s). */ 116 #define DT_XTENSA_GOT_LOC_OFF 0x70000000 117 118 /* Number of entries in the GOT location table. */ 119 #define DT_XTENSA_GOT_LOC_SZ 0x70000001 120 121 122 /* Definitions for instruction and literal property tables. The 123 tables for ".gnu.linkonce.*" sections are placed in the following 124 sections: 125 126 instruction tables: .gnu.linkonce.x.* 127 literal tables: .gnu.linkonce.p.* 128 */ 129 130 #define XTENSA_INSN_SEC_NAME ".xt.insn" 131 #define XTENSA_LIT_SEC_NAME ".xt.lit" 132 #define XTENSA_PROP_SEC_NAME ".xt.prop" 133 134 typedef struct property_table_entry_t 135 { 136 bfd_vma address; 137 bfd_vma size; 138 flagword flags; 139 } property_table_entry; 140 141 /* Flags in the property tables to specify whether blocks of memory are 142 literals, instructions, data, or unreachable. For instructions, 143 blocks that begin loop targets and branch targets are designated. 144 Blocks that do not allow density instructions, instruction reordering 145 or transformation are also specified. Finally, for branch targets, 146 branch target alignment priority is included. Alignment of the next 147 block is specified in the current block and the size of the current 148 block does not include any fill required to align to the next 149 block. */ 150 151 #define XTENSA_PROP_LITERAL 0x00000001 152 #define XTENSA_PROP_INSN 0x00000002 153 #define XTENSA_PROP_DATA 0x00000004 154 #define XTENSA_PROP_UNREACHABLE 0x00000008 155 /* Instruction-only properties at beginning of code. */ 156 #define XTENSA_PROP_INSN_LOOP_TARGET 0x00000010 157 #define XTENSA_PROP_INSN_BRANCH_TARGET 0x00000020 158 /* Instruction-only properties about code. */ 159 #define XTENSA_PROP_INSN_NO_DENSITY 0x00000040 160 #define XTENSA_PROP_INSN_NO_REORDER 0x00000080 161 /* Historically, NO_TRANSFORM was a property of instructions, 162 but it should apply to literals under certain circumstances. */ 163 #define XTENSA_PROP_NO_TRANSFORM 0x00000100 164 165 /* Branch target alignment information. This transmits information 166 to the linker optimization about the priority of aligning a 167 particular block for branch target alignment: None, low priority, 168 high priority, or required. These only need to be checked in 169 instruction blocks marked as XTENSA_PROP_INSN_BRANCH_TARGET. 170 Common usage is: 171 172 switch (GET_XTENSA_PROP_BT_ALIGN(flags)) 173 case XTENSA_PROP_BT_ALIGN_NONE: 174 case XTENSA_PROP_BT_ALIGN_LOW: 175 case XTENSA_PROP_BT_ALIGN_HIGH: 176 case XTENSA_PROP_BT_ALIGN_REQUIRE: 177 */ 178 #define XTENSA_PROP_BT_ALIGN_MASK 0x00000600 179 180 /* No branch target alignment. */ 181 #define XTENSA_PROP_BT_ALIGN_NONE 0x0 182 /* Low priority branch target alignment. */ 183 #define XTENSA_PROP_BT_ALIGN_LOW 0x1 184 /* High priority branch target alignment. */ 185 #define XTENSA_PROP_BT_ALIGN_HIGH 0x2 186 /* Required branch target alignment. */ 187 #define XTENSA_PROP_BT_ALIGN_REQUIRE 0x3 188 189 #define GET_XTENSA_PROP_BT_ALIGN(flag) \ 190 (((unsigned)((flag) & (XTENSA_PROP_BT_ALIGN_MASK))) >> 9) 191 #define SET_XTENSA_PROP_BT_ALIGN(flag, align) \ 192 (((flag) & (~XTENSA_PROP_BT_ALIGN_MASK)) | \ 193 (((align) << 9) & XTENSA_PROP_BT_ALIGN_MASK)) 194 195 /* Alignment is specified in the block BEFORE the one that needs 196 alignment. Up to 5 bits. Use GET_XTENSA_PROP_ALIGNMENT(flags) to 197 get the required alignment specified as a power of 2. Use 198 SET_XTENSA_PROP_ALIGNMENT(flags, pow2) to set the required 199 alignment. Be careful of side effects since the SET will evaluate 200 flags twice. Also, note that the SIZE of a block in the property 201 table does not include the alignment size, so the alignment fill 202 must be calculated to determine if two blocks are contiguous. 203 TEXT_ALIGN is not currently implemented but is a placeholder for a 204 possible future implementation. */ 205 206 #define XTENSA_PROP_ALIGN 0x00000800 207 208 #define XTENSA_PROP_ALIGNMENT_MASK 0x0001f000 209 210 #define GET_XTENSA_PROP_ALIGNMENT(flag) \ 211 (((unsigned)((flag) & (XTENSA_PROP_ALIGNMENT_MASK))) >> 12) 212 #define SET_XTENSA_PROP_ALIGNMENT(flag, align) \ 213 (((flag) & (~XTENSA_PROP_ALIGNMENT_MASK)) | \ 214 (((align) << 12) & XTENSA_PROP_ALIGNMENT_MASK)) 215 216 #define XTENSA_PROP_INSN_ABSLIT 0x00020000 217 218 extern char *xtensa_property_section_name (asection *, const char *, bool); 219 extern int 220 xtensa_read_table_entries (bfd *abfd, 221 asection *section, 222 property_table_entry **table_p, 223 const char *sec_name, 224 bool output_addr); 225 extern int 226 xtensa_compute_fill_extra_space (property_table_entry *entry); 227 228 extern int 229 xtensa_abi_choice (void); 230 231 #ifdef __cplusplus 232 } 233 #endif 234 235 #endif /* _ELF_XTENSA_H */ 236
Indexes created Sat Feb 28 05:31:39 UTC 2026