1 /* ELF support for BFD. 2 Copyright 1991, 1992, 1993, 1995, 1997, 1998, 1999, 2001, 2003, 2005, 3 2008 Free Software Foundation, Inc. 4 5 Written by Fred Fish @ Cygnus Support, from information published 6 in "UNIX System V Release 4, Programmers Guide: ANSI C and 7 Programming Support Tools". 8 9 This file is part of BFD, the Binary File Descriptor library. 10 11 This program is free software; you can redistribute it and/or modify 12 it under the terms of the GNU General Public License as published by 13 the Free Software Foundation; either version 2 of the License, or 14 (at your option) any later version. 15 16 This program is distributed in the hope that it will be useful, 17 but WITHOUT ANY WARRANTY; without even the implied warranty of 18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 19 GNU General Public License for more details. 20 21 You should have received a copy of the GNU General Public License 22 along with this program; if not, write to the Free Software 23 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA. */ 24 25 26 /* This file is part of ELF support for BFD, and contains the portions 27 that describe how ELF is represented externally by the BFD library. 28 I.E. it describes the in-file representation of ELF. It requires 29 the elf/common.h file which contains the portions that are common to 30 both the internal and external representations. */ 31 32 /* The 64-bit stuff is kind of random. Perhaps someone will publish a 33 spec someday. */ 34 35 #ifndef _ELF_EXTERNAL_H 36 #define _ELF_EXTERNAL_H 37 38 /* Special section indices, which may show up in st_shndx fields, among 39 other places. */ 40 41 #define SHN_LORESERVE 0xFF00 /* Begin range of reserved indices */ 42 #define SHN_LOPROC 0xFF00 /* Begin range of appl-specific */ 43 #define SHN_HIPROC 0xFF1F /* End range of appl-specific */ 44 #define SHN_LOOS 0xFF20 /* OS specific semantics, lo */ 45 #define SHN_HIOS 0xFF3F /* OS specific semantics, hi */ 46 #define SHN_ABS 0xFFF1 /* Associated symbol is absolute */ 47 #define SHN_COMMON 0xFFF2 /* Associated symbol is in common */ 48 #define SHN_XINDEX 0xFFFF /* Section index is held elsewhere */ 49 #define SHN_HIRESERVE 0xFFFF /* End range of reserved indices */ 50 51 /* ELF Header (32-bit implementations) */ 52 53 typedef struct { 54 unsigned char e_ident[16]; /* ELF "magic number" */ 55 unsigned char e_type[2]; /* Identifies object file type */ 56 unsigned char e_machine[2]; /* Specifies required architecture */ 57 unsigned char e_version[4]; /* Identifies object file version */ 58 unsigned char e_entry[4]; /* Entry point virtual address */ 59 unsigned char e_phoff[4]; /* Program header table file offset */ 60 unsigned char e_shoff[4]; /* Section header table file offset */ 61 unsigned char e_flags[4]; /* Processor-specific flags */ 62 unsigned char e_ehsize[2]; /* ELF header size in bytes */ 63 unsigned char e_phentsize[2]; /* Program header table entry size */ 64 unsigned char e_phnum[2]; /* Program header table entry count */ 65 unsigned char e_shentsize[2]; /* Section header table entry size */ 66 unsigned char e_shnum[2]; /* Section header table entry count */ 67 unsigned char e_shstrndx[2]; /* Section header string table index */ 68 } Elf32_External_Ehdr; 69 70 typedef struct { 71 unsigned char e_ident[16]; /* ELF "magic number" */ 72 unsigned char e_type[2]; /* Identifies object file type */ 73 unsigned char e_machine[2]; /* Specifies required architecture */ 74 unsigned char e_version[4]; /* Identifies object file version */ 75 unsigned char e_entry[8]; /* Entry point virtual address */ 76 unsigned char e_phoff[8]; /* Program header table file offset */ 77 unsigned char e_shoff[8]; /* Section header table file offset */ 78 unsigned char e_flags[4]; /* Processor-specific flags */ 79 unsigned char e_ehsize[2]; /* ELF header size in bytes */ 80 unsigned char e_phentsize[2]; /* Program header table entry size */ 81 unsigned char e_phnum[2]; /* Program header table entry count */ 82 unsigned char e_shentsize[2]; /* Section header table entry size */ 83 unsigned char e_shnum[2]; /* Section header table entry count */ 84 unsigned char e_shstrndx[2]; /* Section header string table index */ 85 } Elf64_External_Ehdr; 86 87 /* Program header */ 88 89 typedef struct { 90 unsigned char p_type[4]; /* Identifies program segment type */ 91 unsigned char p_offset[4]; /* Segment file offset */ 92 unsigned char p_vaddr[4]; /* Segment virtual address */ 93 unsigned char p_paddr[4]; /* Segment physical address */ 94 unsigned char p_filesz[4]; /* Segment size in file */ 95 unsigned char p_memsz[4]; /* Segment size in memory */ 96 unsigned char p_flags[4]; /* Segment flags */ 97 unsigned char p_align[4]; /* Segment alignment, file & memory */ 98 } Elf32_External_Phdr; 99 100 typedef struct { 101 unsigned char p_type[4]; /* Identifies program segment type */ 102 unsigned char p_flags[4]; /* Segment flags */ 103 unsigned char p_offset[8]; /* Segment file offset */ 104 unsigned char p_vaddr[8]; /* Segment virtual address */ 105 unsigned char p_paddr[8]; /* Segment physical address */ 106 unsigned char p_filesz[8]; /* Segment size in file */ 107 unsigned char p_memsz[8]; /* Segment size in memory */ 108 unsigned char p_align[8]; /* Segment alignment, file & memory */ 109 } Elf64_External_Phdr; 110 111 /* Section header */ 112 113 typedef struct { 114 unsigned char sh_name[4]; /* Section name, index in string tbl */ 115 unsigned char sh_type[4]; /* Type of section */ 116 unsigned char sh_flags[4]; /* Miscellaneous section attributes */ 117 unsigned char sh_addr[4]; /* Section virtual addr at execution */ 118 unsigned char sh_offset[4]; /* Section file offset */ 119 unsigned char sh_size[4]; /* Size of section in bytes */ 120 unsigned char sh_link[4]; /* Index of another section */ 121 unsigned char sh_info[4]; /* Additional section information */ 122 unsigned char sh_addralign[4]; /* Section alignment */ 123 unsigned char sh_entsize[4]; /* Entry size if section holds table */ 124 } Elf32_External_Shdr; 125 126 typedef struct { 127 unsigned char sh_name[4]; /* Section name, index in string tbl */ 128 unsigned char sh_type[4]; /* Type of section */ 129 unsigned char sh_flags[8]; /* Miscellaneous section attributes */ 130 unsigned char sh_addr[8]; /* Section virtual addr at execution */ 131 unsigned char sh_offset[8]; /* Section file offset */ 132 unsigned char sh_size[8]; /* Size of section in bytes */ 133 unsigned char sh_link[4]; /* Index of another section */ 134 unsigned char sh_info[4]; /* Additional section information */ 135 unsigned char sh_addralign[8]; /* Section alignment */ 136 unsigned char sh_entsize[8]; /* Entry size if section holds table */ 137 } Elf64_External_Shdr; 138 139 /* Symbol table entry */ 140 141 typedef struct { 142 unsigned char st_name[4]; /* Symbol name, index in string tbl */ 143 unsigned char st_value[4]; /* Value of the symbol */ 144 unsigned char st_size[4]; /* Associated symbol size */ 145 unsigned char st_info[1]; /* Type and binding attributes */ 146 unsigned char st_other[1]; /* No defined meaning, 0 */ 147 unsigned char st_shndx[2]; /* Associated section index */ 148 } Elf32_External_Sym; 149 150 typedef struct { 151 unsigned char st_name[4]; /* Symbol name, index in string tbl */ 152 unsigned char st_info[1]; /* Type and binding attributes */ 153 unsigned char st_other[1]; /* No defined meaning, 0 */ 154 unsigned char st_shndx[2]; /* Associated section index */ 155 unsigned char st_value[8]; /* Value of the symbol */ 156 unsigned char st_size[8]; /* Associated symbol size */ 157 } Elf64_External_Sym; 158 159 typedef struct { 160 unsigned char est_shndx[4]; /* Section index */ 161 } Elf_External_Sym_Shndx; 162 163 /* Note segments */ 164 165 typedef struct { 166 unsigned char namesz[4]; /* Size of entry's owner string */ 167 unsigned char descsz[4]; /* Size of the note descriptor */ 168 unsigned char type[4]; /* Interpretation of the descriptor */ 169 char name[1]; /* Start of the name+desc data */ 170 } Elf_External_Note; 171 172 /* Relocation Entries */ 173 typedef struct { 174 unsigned char r_offset[4]; /* Location at which to apply the action */ 175 unsigned char r_info[4]; /* index and type of relocation */ 176 } Elf32_External_Rel; 177 178 typedef struct { 179 unsigned char r_offset[4]; /* Location at which to apply the action */ 180 unsigned char r_info[4]; /* index and type of relocation */ 181 unsigned char r_addend[4]; /* Constant addend used to compute value */ 182 } Elf32_External_Rela; 183 184 typedef struct { 185 unsigned char r_offset[8]; /* Location at which to apply the action */ 186 unsigned char r_info[8]; /* index and type of relocation */ 187 } Elf64_External_Rel; 188 189 typedef struct { 190 unsigned char r_offset[8]; /* Location at which to apply the action */ 191 unsigned char r_info[8]; /* index and type of relocation */ 192 unsigned char r_addend[8]; /* Constant addend used to compute value */ 193 } Elf64_External_Rela; 194 195 /* dynamic section structure */ 196 197 typedef struct { 198 unsigned char d_tag[4]; /* entry tag value */ 199 union { 200 unsigned char d_val[4]; 201 unsigned char d_ptr[4]; 202 } d_un; 203 } Elf32_External_Dyn; 204 205 typedef struct { 206 unsigned char d_tag[8]; /* entry tag value */ 207 union { 208 unsigned char d_val[8]; 209 unsigned char d_ptr[8]; 210 } d_un; 211 } Elf64_External_Dyn; 212 213 /* The version structures are currently size independent. They are 214 named without a 32 or 64. If that ever changes, these structures 215 will need to be renamed. */ 216 217 /* This structure appears in a SHT_GNU_verdef section. */ 218 219 typedef struct { 220 unsigned char vd_version[2]; 221 unsigned char vd_flags[2]; 222 unsigned char vd_ndx[2]; 223 unsigned char vd_cnt[2]; 224 unsigned char vd_hash[4]; 225 unsigned char vd_aux[4]; 226 unsigned char vd_next[4]; 227 } Elf_External_Verdef; 228 229 /* This structure appears in a SHT_GNU_verdef section. */ 230 231 typedef struct { 232 unsigned char vda_name[4]; 233 unsigned char vda_next[4]; 234 } Elf_External_Verdaux; 235 236 /* This structure appears in a SHT_GNU_verneed section. */ 237 238 typedef struct { 239 unsigned char vn_version[2]; 240 unsigned char vn_cnt[2]; 241 unsigned char vn_file[4]; 242 unsigned char vn_aux[4]; 243 unsigned char vn_next[4]; 244 } Elf_External_Verneed; 245 246 /* This structure appears in a SHT_GNU_verneed section. */ 247 248 typedef struct { 249 unsigned char vna_hash[4]; 250 unsigned char vna_flags[2]; 251 unsigned char vna_other[2]; 252 unsigned char vna_name[4]; 253 unsigned char vna_next[4]; 254 } Elf_External_Vernaux; 255 256 /* This structure appears in a SHT_GNU_versym section. This is not a 257 standard ELF structure; ELF just uses Elf32_Half. */ 258 259 typedef struct { 260 unsigned char vs_vers[2]; 261 } ATTRIBUTE_PACKED Elf_External_Versym; 262 263 /* Structure for syminfo section. */ 264 typedef struct 265 { 266 unsigned char si_boundto[2]; 267 unsigned char si_flags[2]; 268 } Elf_External_Syminfo; 269 270 271 /* This structure appears on the stack and in NT_AUXV core file notes. */ 272 typedef struct 273 { 274 unsigned char a_type[4]; 275 unsigned char a_val[4]; 276 } Elf32_External_Auxv; 277 278 typedef struct 279 { 280 unsigned char a_type[8]; 281 unsigned char a_val[8]; 282 } Elf64_External_Auxv; 283 284 /* Size of SHT_GROUP section entry. */ 285 286 #define GRP_ENTRY_SIZE 4 287 288 #endif /* _ELF_EXTERNAL_H */ 289