include/elf/common.h

   1 /* ELF support for BFD.
   2    Copyright (C) 1991,92,93,94,95,96,97,98,1999 Free Software Foundation, Inc.
   3
   4    Written by Fred Fish @ Cygnus Support, from information published
   5    in "UNIX System V Release 4, Programmers Guide: ANSI C and
   6    Programming Support Tools".
   7
   8 This file is part of BFD, the Binary File Descriptor library.
   9
  10 This program is free software; you can redistribute it and/or modify
  11 it under the terms of the GNU General Public License as published by
  12 the Free Software Foundation; either version 2 of the License, or
  13 (at your option) any later version.
  14
  15 This program is distributed in the hope that it will be useful,
  16 but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18 GNU General Public License for more details.
  19
  20 You should have received a copy of the GNU General Public License
  21 along with this program; if not, write to the Free Software
  22 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
  23
  24
  25 /* This file is part of ELF support for BFD, and contains the portions
  26    that are common to both the internal and external representations.
  27    For example, ELFMAG0 is the byte 0x7F in both the internal (in-memory)
  28    and external (in-file) representations. */
  29
  30 #ifndef _ELF_COMMON_H
  31 #define _ELF_COMMON_H
  32
  33 /* Fields in e_ident[] */
  34
  35 #define EI_MAG0         0       /* File identification byte 0 index */
  36 #define ELFMAG0         0x7F    /* Magic number byte 0 */
  37
  38 #define EI_MAG1         1       /* File identification byte 1 index */
  39 #define ELFMAG1         'E'     /* Magic number byte 1 */
  40
  41 #define EI_MAG2         2       /* File identification byte 2 index */
  42 #define ELFMAG2         'L'     /* Magic number byte 2 */
  43
  44 #define EI_MAG3         3       /* File identification byte 3 index */
  45 #define ELFMAG3         'F'     /* Magic number byte 3 */
  46
  47 #define EI_CLASS        4       /* File class */
  48 #define ELFCLASSNONE    0       /* Invalid class */
  49 #define ELFCLASS32      1       /* 32-bit objects */
  50 #define ELFCLASS64      2       /* 64-bit objects */
  51
  52 #define EI_DATA         5       /* Data encoding */
  53 #define ELFDATANONE     0       /* Invalid data encoding */
  54 #define ELFDATA2LSB     1       /* 2's complement, little endian */
  55 #define ELFDATA2MSB     2       /* 2's complement, big endian */
  56
  57 #define EI_VERSION      6       /* File version */
  58
  59 #define EI_OSABI        7       /* Operating System/ABI indication */
  60 #define ELFOSABI_SYSV   0       /* UNIX System V ABI */
  61 #define ELFOSABI_HPUX   1       /* HP-UX operating system */
  62 #define ELFOSABI_STANDALONE 255 /* Standalone (embedded) application */
  63 #define ELFOSABI_ARM   97               /* ARM */
  64
  65 #define EI_ABIVERSION   8       /* ABI version */
  66
  67 #define EI_PAD          9       /* Start of padding bytes */
  68
  69
  70 /* Values for e_type, which identifies the object file type */
  71
  72 #define ET_NONE         0       /* No file type */
  73 #define ET_REL          1       /* Relocatable file */
  74 #define ET_EXEC         2       /* Executable file */
  75 #define ET_DYN          3       /* Shared object file */
  76 #define ET_CORE         4       /* Core file */
  77 #define ET_LOOS         0xFE00  /* Operating system-specific */
  78 #define ET_HIOS         0xFEFF  /* Operating system-specific */
  79 #define ET_LOPROC       0xFF00  /* Processor-specific */
  80 #define ET_HIPROC       0xFFFF  /* Processor-specific */
  81
  82 /* Values for e_machine, which identifies the architecture */
  83
  84 #define EM_NONE         0       /* No machine */
  85 #define EM_M32          1       /* AT&T WE 32100 */
  86 #define EM_SPARC        2       /* SUN SPARC */
  87 #define EM_386          3       /* Intel 80386 */
  88 #define EM_68K          4       /* Motorola m68k family */
  89 #define EM_88K          5       /* Motorola m88k family */
  90 #define EM_486          6       /* Intel 80486 */
  91 #define EM_860          7       /* Intel 80860 */
  92 #define EM_MIPS         8       /* MIPS R3000 (officially, big-endian only) */
  93 #define EM_S370         9       /* Amdahl */
  94 #define EM_MIPS_RS4_BE 10       /* MIPS R4000 big-endian */
  95
  96 #define EM_PARISC      15       /* HPPA */
  97 #define EM_VPP550      17       /* Fujitsu VPP500 */
  98 #define EM_SPARC32PLUS 18       /* Sun's "v8plus" */
  99 #define EM_960         19       /* Intel 80960 */
 100 #define EM_PPC         20       /* PowerPC */
 101 #define EM_PPC64       21       /* 64-bit PowerPC */
 102
 103 #define EM_V800        36       /* NEC V800 series */
 104 #define EM_FR20        37       /* Fujitsu FR20 */
 105 #define EM_RH32        38       /* TRW RH32 */
 106 #define EM_MCORE       39       /* Motorolla MCore */ /* May also be taken by Fujitsu MMA */
 107 #define EM_ARM         40       /* ARM */
 108 #define EM_OLD_ALPHA   41       /* Digital Alpha */
 109 #define EM_SH          42       /* Hitachi SH */
 110 #define EM_SPARCV9     43       /* SPARC v9 64-bit */
 111 #define EM_TRICORE     44       /* Siemens Tricore embedded processor */
 112 #define EM_ARC         45       /* Argonaut RISC Core, Argonaut Technologies Inc. */
 113 #define EM_H8_300      46       /* Hitachi H8/300 */
 114 #define EM_H8_300H     47       /* Hitachi H8/300H */
 115 #define EM_H8S         48       /* Hitachi H8S */
 116 #define EM_H8_500      49       /* Hitachi H8/500 */
 117 #define EM_IA_64       50       /* Intel MercedTM Processor */
 118 #define EM_MIPS_X      51       /* Stanford MIPS-X */
 119 #define EM_COLDFIRE    52       /* Motorola Coldfire */
 120 #define EM_68HC12      53       /* Motorola M68HC12 */
 121
 122 #define EM_PJ          99       /* picoJava */
 123
 124 /* If it is necessary to assign new unofficial EM_* values, please pick large
 125    random numbers (0x8523, 0xa7f2, etc.) to minimize the chances of collision
 126    with official or non-GNU unofficial values.
 127
 128    NOTE: Do not just increment the most recent number by one.
 129    Somebody else somewhere will do exactly the same thing, and you
 130    will have a collision.  Instead, pick a random number.  */
 131
 132 /* Cygnus PowerPC ELF backend.  Written in the absence of an ABI.  */
 133 #define EM_CYGNUS_POWERPC 0x9025
 134
 135 /* Old version of Sparc v9, from before the ABI; this should be
 136    removed shortly.  */
 137 #define EM_OLD_SPARCV9  11
 138
 139 /* Old version of PowerPC, this should be removed shortly. */
 140 #define EM_PPC_OLD      17
 141
 142 /* Cygnus ARC ELF backend.  Written in the absence of an ABI.  */
 143 #define EM_CYGNUS_ARC 0x9040
 144
 145 /* Cygnus M32R ELF backend.  Written in the absence of an ABI.  */
 146 #define EM_CYGNUS_M32R 0x9041
 147
 148 /* Alpha backend magic number.  Written in the absence of an ABI.  */
 149 #define EM_ALPHA        0x9026
 150
 151 /* D10V backend magic number.  Written in the absence of an ABI.  */
 152 #define EM_CYGNUS_D10V  0x7650
 153
 154 /* D30V backend magic number.  Written in the absence of an ABI.  */
 155 #define EM_CYGNUS_D30V  0x7676
 156
 157 /* V850 backend magic number.  Written in the absense of an ABI.  */
 158 #define EM_CYGNUS_V850  0x9080
 159
 160 /* mn10200 and mn10300 backend magic numbers.
 161    Written in the absense of an ABI.  */
 162 #define EM_CYGNUS_MN10200       0xdead
 163 #define EM_CYGNUS_MN10300       0xbeef
 164
 165 /* FR30 magic number - no EABI available.  */
 166 #define EM_CYGNUS_FR30          0x3330
 167
 168 /* See the above comment before you add a new EM_* value here.  */
 169
 170 /* Values for e_version */
 171
 172 #define EV_NONE         0               /* Invalid ELF version */
 173 #define EV_CURRENT      1               /* Current version */
 174
 175 /* Values for program header, p_type field */
 176
 177 #define PT_NULL         0               /* Program header table entry unused */
 178 #define PT_LOAD         1               /* Loadable program segment */
 179 #define PT_DYNAMIC      2               /* Dynamic linking information */
 180 #define PT_INTERP       3               /* Program interpreter */
 181 #define PT_NOTE         4               /* Auxiliary information */
 182 #define PT_SHLIB        5               /* Reserved, unspecified semantics */
 183 #define PT_PHDR         6               /* Entry for header table itself */
 184 #define PT_LOOS         0x60000000      /* OS-specific */
 185 #define PT_HIOS         0x6fffffff      /* OS-specific */
 186 #define PT_LOPROC       0x70000000      /* Processor-specific */
 187 #define PT_HIPROC       0x7FFFFFFF      /* Processor-specific */
 188
 189 /* Program segment permissions, in program header p_flags field */
 190
 191 #define PF_X            (1 << 0)        /* Segment is executable */
 192 #define PF_W            (1 << 1)        /* Segment is writable */
 193 #define PF_R            (1 << 2)        /* Segment is readable */
 194 #define PF_MASKOS       0x0F000000      /* OS-specific reserved bits */
 195 #define PF_MASKPROC     0xF0000000      /* Processor-specific reserved bits */
 196
 197 /* Values for section header, sh_type field */
 198
 199 #define SHT_NULL        0               /* Section header table entry unused */
 200 #define SHT_PROGBITS    1               /* Program specific (private) data */
 201 #define SHT_SYMTAB      2               /* Link editing symbol table */
 202 #define SHT_STRTAB      3               /* A string table */
 203 #define SHT_RELA        4               /* Relocation entries with addends */
 204 #define SHT_HASH        5               /* A symbol hash table */
 205 #define SHT_DYNAMIC     6               /* Information for dynamic linking */
 206 #define SHT_NOTE        7               /* Information that marks file */
 207 #define SHT_NOBITS      8               /* Section occupies no space in file */
 208 #define SHT_REL         9               /* Relocation entries, no addends */
 209 #define SHT_SHLIB       10              /* Reserved, unspecified semantics */
 210 #define SHT_DYNSYM      11              /* Dynamic linking symbol table */
 211
 212 #define SHT_LOOS        0x60000000      /* Operating system specific semantics, lo */
 213 #define SHT_HIOS        0x6fffffff      /* Operating system specific semantics, hi */
 214
 215 /* The next three section types are defined by Solaris, and are named
 216    SHT_SUNW*.  We use them in GNU code, so we also define SHT_GNU*
 217    versions.  */
 218 #define SHT_SUNW_verdef 0x6ffffffd      /* Versions defined by file */
 219 #define SHT_SUNW_verneed 0x6ffffffe     /* Versions needed by file */
 220 #define SHT_SUNW_versym 0x6fffffff      /* Symbol versions */
 221
 222 #define SHT_GNU_verdef  SHT_SUNW_verdef
 223 #define SHT_GNU_verneed SHT_SUNW_verneed
 224 #define SHT_GNU_versym  SHT_SUNW_versym
 225
 226 #define SHT_LOPROC      0x70000000      /* Processor-specific semantics, lo */
 227 #define SHT_HIPROC      0x7FFFFFFF      /* Processor-specific semantics, hi */
 228 #define SHT_LOUSER      0x80000000      /* Application-specific semantics */
 229 #define SHT_HIUSER      0x8FFFFFFF      /* Application-specific semantics */
 230
 231 /* Values for section header, sh_flags field */
 232
 233 #define SHF_WRITE       (1 << 0)        /* Writable data during execution */
 234 #define SHF_ALLOC       (1 << 1)        /* Occupies memory during execution */
 235 #define SHF_EXECINSTR   (1 << 2)        /* Executable machine instructions */
 236 #define SHF_MASKOS      0x0F000000      /* OS-specific semantics */
 237 #define SHF_MASKPROC    0xF0000000      /* Processor-specific semantics */
 238
 239 /* Values of note segment descriptor types for core files. */
 240
 241 #define NT_PRSTATUS     1               /* Contains copy of prstatus struct */
 242 #define NT_FPREGSET     2               /* Contains copy of fpregset struct */
 243 #define NT_PRPSINFO     3               /* Contains copy of prpsinfo struct */
 244 #define NT_TASKSTRUCT   4               /* Contains copy of task struct */
 245
 246 /* Note segments for core files on dir-style procfs systems. */
 247
 248 #define NT_PSTATUS      10              /* Has a struct pstatus */
 249 #define NT_FPREGS       12              /* Has a struct fpregset */
 250 #define NT_PSINFO       13              /* Has a struct psinfo */
 251 #define NT_LWPSTATUS    16              /* Has a struct lwpstatus_t */
 252 #define NT_LWPSINFO     17              /* Has a struct lwpsinfo_t */
 253
 254 /* Values of note segment descriptor types for object files.  */
 255 /* (Only for hppa right now.  Should this be moved elsewhere?)  */
 256
 257 #define NT_VERSION      1               /* Contains a version string.  */
 258
 259 /* These three macros disassemble and assemble a symbol table st_info field,
 260    which contains the symbol binding and symbol type.  The STB_ and STT_
 261    defines identify the binding and type. */
 262
 263 #define ELF_ST_BIND(val)                (((unsigned int)(val)) >> 4)
 264 #define ELF_ST_TYPE(val)                ((val) & 0xF)
 265 #define ELF_ST_INFO(bind,type)          (((bind) << 4) + ((type) & 0xF))
 266
 267 #define STN_UNDEF       0               /* undefined symbol index */
 268
 269 #define STB_LOCAL       0               /* Symbol not visible outside obj */
 270 #define STB_GLOBAL      1               /* Symbol visible outside obj */
 271 #define STB_WEAK        2               /* Like globals, lower precedence */
 272 #define STB_LOOS        10              /* OS-specific semantics */
 273 #define STB_HIOS        12              /* OS-specific semantics */
 274 #define STB_LOPROC      13              /* Application-specific semantics */
 275 #define STB_HIPROC      15              /* Application-specific semantics */
 276
 277 #define STT_NOTYPE      0               /* Symbol type is unspecified */
 278 #define STT_OBJECT      1               /* Symbol is a data object */
 279 #define STT_FUNC        2               /* Symbol is a code object */
 280 #define STT_SECTION     3               /* Symbol associated with a section */
 281 #define STT_FILE        4               /* Symbol gives a file name */
 282 #define STT_LOOS        10              /* OS-specific semantics */
 283 #define STT_HIOS        12              /* OS-specific semantics */
 284 #define STT_LOPROC      13              /* Application-specific semantics */
 285 #define STT_HIPROC      15              /* Application-specific semantics */
 286
 287 /* Special section indices, which may show up in st_shndx fields, among
 288    other places. */
 289
 290 #define SHN_UNDEF       0               /* Undefined section reference */
 291 #define SHN_LORESERVE   0xFF00          /* Begin range of reserved indices */
 292 #define SHN_LOPROC      0xFF00          /* Begin range of appl-specific */
 293 #define SHN_HIPROC      0xFF1F          /* End range of appl-specific */
 294 #define SHN_LOOS        0xFF20          /* OS specific semantics, lo */
 295 #define SHN_HIOS        0xFF3F          /* OS specific semantics, hi */
 296 #define SHN_ABS         0xFFF1          /* Associated symbol is absolute */
 297 #define SHN_COMMON      0xFFF2          /* Associated symbol is in common */
 298 #define SHN_HIRESERVE   0xFFFF          /* End range of reserved indices */
 299
 300 /* relocation info handling macros */
 301
 302 #define ELF32_R_SYM(i)          ((i) >> 8)
 303 #define ELF32_R_TYPE(i)         ((i) & 0xff)
 304 #define ELF32_R_INFO(s,t)       (((s) << 8) + ((t) & 0xff))
 305
 306 #define ELF64_R_SYM(i)          ((i) >> 32)
 307 #define ELF64_R_TYPE(i)         ((i) & 0xffffffff)
 308 #define ELF64_R_INFO(s,t)       (((bfd_vma) (s) << 32) + (bfd_vma) (t))
 309
 310 /* Dynamic section tags */
 311
 312 #define DT_NULL         0
 313 #define DT_NEEDED       1
 314 #define DT_PLTRELSZ     2
 315 #define DT_PLTGOT       3
 316 #define DT_HASH         4
 317 #define DT_STRTAB       5
 318 #define DT_SYMTAB       6
 319 #define DT_RELA         7
 320 #define DT_RELASZ       8
 321 #define DT_RELAENT      9
 322 #define DT_STRSZ        10
 323 #define DT_SYMENT       11
 324 #define DT_INIT         12
 325 #define DT_FINI         13
 326 #define DT_SONAME       14
 327 #define DT_RPATH        15
 328 #define DT_SYMBOLIC     16
 329 #define DT_REL          17
 330 #define DT_RELSZ        18
 331 #define DT_RELENT       19
 332 #define DT_PLTREL       20
 333 #define DT_DEBUG        21
 334 #define DT_TEXTREL      22
 335 #define DT_JMPREL       23
 336 #define DT_BIND_NOW     24
 337 #define DT_INIT_ARRAY   25
 338 #define DT_FINI_ARRAY   26
 339 #define DT_INIT_ARRAYSZ 27
 340 #define DT_FINI_ARRAYSZ 28
 341
 342 #define DT_LOOS         0x60000000
 343 #define DT_HIOS         0x6fffffff
 344
 345 /* The next four dynamic tags are used on Solaris.  We support them
 346    everywhere.  */
 347 #define DT_VALRNGLO     0x6ffffd00
 348 #define DT_PLTPADSZ     0x6ffffdf9
 349 #define DT_MOVEENT      0x6ffffdfa
 350 #define DT_MOVESZ       0x6ffffdfb
 351 #define DT_FEATURE_1    0x6ffffdfc
 352 #define DT_POSFLAG_1    0x6ffffdfd
 353 #define DT_SYMINSZ      0x6ffffdfe
 354 #define DT_SYMINENT     0x6ffffdff
 355 #define DT_VALRNGHI     0x6ffffdff
 356
 357 #define DT_ADDRRNGLO    0x6ffffe00
 358 #define DT_SYMINFO      0x6ffffeff
 359 #define DT_ADDRRNGHI    0x6ffffeff
 360
 361 #define DT_RELACOUNT    0x6ffffff9
 362 #define DT_RELCOUNT     0x6ffffffa
 363 #define DT_FLAGS_1      0x6ffffffb
 364 #define DT_VERDEF       0x6ffffffc
 365 #define DT_VERDEFNUM    0x6ffffffd
 366 #define DT_VERNEED      0x6ffffffe
 367 #define DT_VERNEEDNUM   0x6fffffff
 368
 369 /* This tag is a GNU extension to the Solaris version scheme.  */
 370 #define DT_VERSYM       0x6ffffff0
 371
 372 #define DT_LOPROC       0x70000000
 373 #define DT_HIPROC       0x7fffffff
 374
 375 /* These section tags are used on Solaris.  We support them
 376    everywhere, and hope they do not conflict.  */
 377
 378 #define DT_AUXILIARY    0x7ffffffd
 379 #define DT_USED         0x7ffffffe
 380 #define DT_FILTER       0x7fffffff
 381
 382 /* Values used in DT_FEATURE_1 .dynamic entry.  */
 383 #define DTF_1_PARINIT   0x00000001
 384
 385 /* Flag values used in the DT_POSFLAG_1 .dynamic entry.  */
 386 #define DF_P1_LAZYLOAD  0x00000001
 387 #define DF_P1_GROUPPERM 0x00000002
 388
 389 /* Flag value in in the DT_1_FLAGS .dynamic entry.  */
 390 #define DF_1_NOW        0x00000001
 391 #define DF_1_GLOBAL     0x00000002
 392 #define DF_1_GROUP      0x00000004
 393 #define DF_1_NODELETE   0x00000008
 394 #define DF_1_LOADFLTR   0x00000010
 395 #define DF_1_INITFIRST  0x00000020
 396 #define DF_1_NOOPEN     0x00000040
 397 #define DF_1_ORIGIN     0x00000080
 398 #define DF_1_DIRECT     0x00000100
 399 #define DF_1_TRANS      0x00000200
 400 #define DF_1_INTERPOSE  0x00000400
 401
 402 /* These constants are used for the version number of a Elf32_Verdef
 403    structure.  */
 404
 405 #define VER_DEF_NONE            0
 406 #define VER_DEF_CURRENT         1
 407
 408 /* These constants appear in the vd_flags field of a Elf32_Verdef
 409    structure.  */
 410
 411 #define VER_FLG_BASE            0x1
 412 #define VER_FLG_WEAK            0x2
 413
 414 /* These special constants can be found in an Elf32_Versym field.  */
 415
 416 #define VER_NDX_LOCAL           0
 417 #define VER_NDX_GLOBAL          1
 418
 419 /* These constants are used for the version number of a Elf32_Verneed
 420    structure.  */
 421
 422 #define VER_NEED_NONE           0
 423 #define VER_NEED_CURRENT        1
 424
 425 /* This flag appears in a Versym structure.  It means that the symbol
 426    is hidden, and is only visible with an explicit version number.
 427    This is a GNU extension.  */
 428
 429 #define VERSYM_HIDDEN           0x8000
 430
 431 /* This is the mask for the rest of the Versym information.  */
 432
 433 #define VERSYM_VERSION          0x7fff
 434
 435 /* This is a special token which appears as part of a symbol name.  It
 436    indictes that the rest of the name is actually the name of a
 437    version node, and is not part of the actual name.  This is a GNU
 438    extension.  For example, the symbol name `stat@ver2' is taken to
 439    mean the symbol `stat' in version `ver2'.  */
 440
 441 #define ELF_VER_CHR     '@'
 442
 443 /* Possible values for si_boundto.  */
 444 #define SYMINFO_BT_SELF         0xffff  /* Symbol bound to self */
 445 #define SYMINFO_BT_PARENT       0xfffe  /* Symbol bound to parent */
 446 #define SYMINFO_BT_LOWRESERVE   0xff00  /* Beginning of reserved entries */
 447
 448 /* Possible bitmasks for si_flags.  */
 449 #define SYMINFO_FLG_DIRECT      0x0001  /* Direct bound symbol */
 450 #define SYMINFO_FLG_PASSTHRU    0x0002  /* Pass-thru symbol for translator */
 451 #define SYMINFO_FLG_COPY        0x0004  /* Symbol is a copy-reloc */
 452 #define SYMINFO_FLG_LAZYLOAD    0x0008  /* Symbol bound to object to be lazy
 453                                            loaded */
 454 /* Syminfo version values.  */
 455 #define SYMINFO_NONE            0
 456 #define SYMINFO_CURRENT         1
 457 #define SYMINFO_NUM             2
 458
 459 #endif /* _ELF_COMMON_H */