contrib/binutils/include/elf/common.h

   1 /* ELF support for BFD.
   2    Copyright (C) 1991, 92, 93, 94, 95, 96, 1997 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_PAD          7               /* Start of padding bytes */
  60
  61
  62 /* Values for e_type, which identifies the object file type */
  63
  64 #define ET_NONE         0               /* No file type */
  65 #define ET_REL          1               /* Relocatable file */
  66 #define ET_EXEC         2               /* Executable file */
  67 #define ET_DYN          3               /* Shared object file */
  68 #define ET_CORE         4               /* Core file */
  69 #define ET_LOPROC       0xFF00          /* Processor-specific */
  70 #define ET_HIPROC       0xFFFF          /* Processor-specific */
  71
  72 /* Values for e_machine, which identifies the architecture */
  73
  74 #define EM_NONE         0       /* No machine */
  75 #define EM_M32          1       /* AT&T WE 32100 */
  76 #define EM_SPARC        2       /* SUN SPARC */
  77 #define EM_386          3       /* Intel 80386 */
  78 #define EM_68K          4       /* Motorola m68k family */
  79 #define EM_88K          5       /* Motorola m88k family */
  80 #define EM_860          7       /* Intel 80860 */
  81 #define EM_MIPS         8       /* MIPS R3000 (officially, big-endian only) */
  82
  83 #define EM_MIPS_RS4_BE 10       /* MIPS R4000 big-endian */
  84
  85 #define EM_SPARC64     11       /* SPARC v9 (not official) 64-bit */
  86
  87 #define EM_PARISC      15       /* HPPA */
  88
  89 #define EM_SPARC32PLUS 18       /* Sun's "v8plus" */
  90
  91 #define EM_PPC         20       /* PowerPC */
  92
  93 #define EM_SH          42       /* Hitachi SH */
  94
  95 /* If it is necessary to assign new unofficial EM_* values, please pick large
  96    random numbers (0x8523, 0xa7f2, etc.) to minimize the chances of collision
  97    with official or non-GNU unofficial values.
  98
  99    NOTE: Do not just increment the most recent number by one.
 100    Somebody else somewhere will do exactly the same thing, and you
 101    will have a collision.  Instead, pick a random number.  */
 102
 103 /* Cygnus PowerPC ELF backend.  Written in the absence of an ABI.  */
 104 #define EM_CYGNUS_POWERPC 0x9025
 105
 106 /* Old version of PowerPC, this should be removed shortly. */
 107 #define EM_PPC_OLD      17
 108
 109
 110 /* Cygnus M32R ELF backend.  Written in the absence of an ABI.  */
 111 #define EM_CYGNUS_M32R 0x9041
 112
 113 /* Alpha backend magic number.  Written in the absence of an ABI.  */
 114 #define EM_ALPHA        0x9026
 115
 116 /* D10V backend magic number.  Written in the absence of an ABI.  */
 117 #define EM_CYGNUS_D10V  0x7650
 118
 119
 120
 121 /* mn10200 and mn10300 backend magic numbers.
 122    Written in the absense of an ABI.  */
 123 #define EM_CYGNUS_MN10200       0xdead
 124 #define EM_CYGNUS_MN10300       0xbeef
 125
 126 /* See the above comment before you add a new EM_* value here.  */
 127
 128 /* Values for e_version */
 129
 130 #define EV_NONE         0               /* Invalid ELF version */
 131 #define EV_CURRENT      1               /* Current version */
 132
 133 /* Values for program header, p_type field */
 134
 135 #define PT_NULL         0               /* Program header table entry unused */
 136 #define PT_LOAD         1               /* Loadable program segment */
 137 #define PT_DYNAMIC      2               /* Dynamic linking information */
 138 #define PT_INTERP       3               /* Program interpreter */
 139 #define PT_NOTE         4               /* Auxiliary information */
 140 #define PT_SHLIB        5               /* Reserved, unspecified semantics */
 141 #define PT_PHDR         6               /* Entry for header table itself */
 142 #define PT_LOPROC       0x70000000      /* Processor-specific */
 143 #define PT_HIPROC       0x7FFFFFFF      /* Processor-specific */
 144
 145 /* Program segment permissions, in program header p_flags field */
 146
 147 #define PF_X            (1 << 0)        /* Segment is executable */
 148 #define PF_W            (1 << 1)        /* Segment is writable */
 149 #define PF_R            (1 << 2)        /* Segment is readable */
 150 #define PF_MASKPROC     0xF0000000      /* Processor-specific reserved bits */
 151
 152 /* Values for section header, sh_type field */
 153
 154 #define SHT_NULL        0               /* Section header table entry unused */
 155 #define SHT_PROGBITS    1               /* Program specific (private) data */
 156 #define SHT_SYMTAB      2               /* Link editing symbol table */
 157 #define SHT_STRTAB      3               /* A string table */
 158 #define SHT_RELA        4               /* Relocation entries with addends */
 159 #define SHT_HASH        5               /* A symbol hash table */
 160 #define SHT_DYNAMIC     6               /* Information for dynamic linking */
 161 #define SHT_NOTE        7               /* Information that marks file */
 162 #define SHT_NOBITS      8               /* Section occupies no space in file */
 163 #define SHT_REL         9               /* Relocation entries, no addends */
 164 #define SHT_SHLIB       10              /* Reserved, unspecified semantics */
 165 #define SHT_DYNSYM      11              /* Dynamic linking symbol table */
 166
 167 /* The next three section types are defined by Solaris, and are named
 168    SHT_SUNW*.  We use them in GNU code, so we also define SHT_GNU*
 169    versions.  */
 170 #define SHT_SUNW_verdef 0x6ffffffd      /* Versions defined by file */
 171 #define SHT_SUNW_verneed 0x6ffffffe     /* Versions needed by file */
 172 #define SHT_SUNW_versym 0x6fffffff      /* Symbol versions */
 173
 174 #define SHT_GNU_verdef  SHT_SUNW_verdef
 175 #define SHT_GNU_verneed SHT_SUNW_verneed
 176 #define SHT_GNU_versym  SHT_SUNW_versym
 177
 178 #define SHT_LOPROC      0x70000000      /* Processor-specific semantics, lo */
 179 #define SHT_HIPROC      0x7FFFFFFF      /* Processor-specific semantics, hi */
 180 #define SHT_LOUSER      0x80000000      /* Application-specific semantics */
 181 #define SHT_HIUSER      0x8FFFFFFF      /* Application-specific semantics */
 182
 183 /* Values for section header, sh_flags field */
 184
 185 #define SHF_WRITE       (1 << 0)        /* Writable data during execution */
 186 #define SHF_ALLOC       (1 << 1)        /* Occupies memory during execution */
 187 #define SHF_EXECINSTR   (1 << 2)        /* Executable machine instructions */
 188 #define SHF_MASKPROC    0xF0000000      /* Processor-specific semantics */
 189
 190 /* Values of note segment descriptor types for core files. */
 191
 192 #define NT_PRSTATUS     1               /* Contains copy of prstatus struct */
 193 #define NT_FPREGSET     2               /* Contains copy of fpregset struct */
 194 #define NT_PRPSINFO     3               /* Contains copy of prpsinfo struct */
 195
 196 /* Values of note segment descriptor types for object files.  */
 197 /* (Only for hppa right now.  Should this be moved elsewhere?)  */
 198
 199 #define NT_VERSION      1               /* Contains a version string.  */
 200
 201 /* These three macros disassemble and assemble a symbol table st_info field,
 202    which contains the symbol binding and symbol type.  The STB_ and STT_
 203    defines identify the binding and type. */
 204
 205 #define ELF_ST_BIND(val)                (((unsigned int)(val)) >> 4)
 206 #define ELF_ST_TYPE(val)                ((val) & 0xF)
 207 #define ELF_ST_INFO(bind,type)          (((bind) << 4) + ((type) & 0xF))
 208
 209 #define STN_UNDEF       0               /* undefined symbol index */
 210
 211 #define STB_LOCAL       0               /* Symbol not visible outside obj */
 212 #define STB_GLOBAL      1               /* Symbol visible outside obj */
 213 #define STB_WEAK        2               /* Like globals, lower precedence */
 214 #define STB_LOPROC      13              /* Application-specific semantics */
 215 #define STB_HIPROC      15              /* Application-specific semantics */
 216
 217 #define STT_NOTYPE      0               /* Symbol type is unspecified */
 218 #define STT_OBJECT      1               /* Symbol is a data object */
 219 #define STT_FUNC        2               /* Symbol is a code object */
 220 #define STT_SECTION     3               /* Symbol associated with a section */
 221 #define STT_FILE        4               /* Symbol gives a file name */
 222 #define STT_LOPROC      13              /* Application-specific semantics */
 223 #define STT_HIPROC      15              /* Application-specific semantics */
 224
 225 /* Special section indices, which may show up in st_shndx fields, among
 226    other places. */
 227
 228 #define SHN_UNDEF       0               /* Undefined section reference */
 229 #define SHN_LORESERVE   0xFF00          /* Begin range of reserved indices */
 230 #define SHN_LOPROC      0xFF00          /* Begin range of appl-specific */
 231 #define SHN_HIPROC      0xFF1F          /* End range of appl-specific */
 232 #define SHN_ABS         0xFFF1          /* Associated symbol is absolute */
 233 #define SHN_COMMON      0xFFF2          /* Associated symbol is in common */
 234 #define SHN_HIRESERVE   0xFFFF          /* End range of reserved indices */
 235
 236 /* relocation info handling macros */
 237
 238 #define ELF32_R_SYM(i)          ((i) >> 8)
 239 #define ELF32_R_TYPE(i)         ((i) & 0xff)
 240 #define ELF32_R_INFO(s,t)       (((s) << 8) + ((t) & 0xff))
 241
 242 #define ELF64_R_SYM(i)          ((i) >> 32)
 243 #define ELF64_R_TYPE(i)         ((i) & 0xffffffff)
 244 #define ELF64_R_INFO(s,t)       (((bfd_vma) (s) << 32) + (bfd_vma) (t))
 245
 246 /* Dynamic section tags */
 247
 248 #define DT_NULL         0
 249 #define DT_NEEDED       1
 250 #define DT_PLTRELSZ     2
 251 #define DT_PLTGOT       3
 252 #define DT_HASH         4
 253 #define DT_STRTAB       5
 254 #define DT_SYMTAB       6
 255 #define DT_RELA         7
 256 #define DT_RELASZ       8
 257 #define DT_RELAENT      9
 258 #define DT_STRSZ        10
 259 #define DT_SYMENT       11
 260 #define DT_INIT         12
 261 #define DT_FINI         13
 262 #define DT_SONAME       14
 263 #define DT_RPATH        15
 264 #define DT_SYMBOLIC     16
 265 #define DT_REL          17
 266 #define DT_RELSZ        18
 267 #define DT_RELENT       19
 268 #define DT_PLTREL       20
 269 #define DT_DEBUG        21
 270 #define DT_TEXTREL      22
 271 #define DT_JMPREL       23
 272
 273 /* The next four dynamic tags are used on Solaris.  We support them
 274    everywhere.  */
 275 #define DT_VERDEF       0x6ffffffc
 276 #define DT_VERDEFNUM    0x6ffffffd
 277 #define DT_VERNEED      0x6ffffffe
 278 #define DT_VERNEEDNUM   0x6fffffff
 279
 280 /* This tag is a GNU extension to the Solaris version scheme.  */
 281 #define DT_VERSYM       0x6ffffff0
 282
 283 #define DT_LOPROC       0x70000000
 284 #define DT_HIPROC       0x7fffffff
 285
 286 /* These section tags are used on Solaris.  We support them
 287    everywhere, and hope they do not conflict.  */
 288
 289 #define DT_AUXILIARY    0x7ffffffd
 290 #define DT_FILTER       0x7fffffff
 291
 292 /* These constants are used for the version number of a Elf32_Verdef
 293    structure.  */
 294
 295 #define VER_DEF_NONE            0
 296 #define VER_DEF_CURRENT         1
 297
 298 /* These constants appear in the vd_flags field of a Elf32_Verdef
 299    structure.  */
 300
 301 #define VER_FLG_BASE            0x1
 302 #define VER_FLG_WEAK            0x2
 303
 304 /* These special constants can be found in an Elf32_Versym field.  */
 305
 306 #define VER_NDX_LOCAL           0
 307 #define VER_NDX_GLOBAL          1
 308
 309 /* These constants are used for the version number of a Elf32_Verneed
 310    structure.  */
 311
 312 #define VER_NEED_NONE           0
 313 #define VER_NEED_CURRENT        1
 314
 315 /* This flag appears in a Versym structure.  It means that the symbol
 316    is hidden, and is only visible with an explicit version number.
 317    This is a GNU extension.  */
 318
 319 #define VERSYM_HIDDEN           0x8000
 320
 321 /* This is the mask for the rest of the Versym information.  */
 322
 323 #define VERSYM_VERSION          0x7fff
 324
 325 /* This is a special token which appears as part of a symbol name.  It
 326    indictes that the rest of the name is actually the name of a
 327    version node, and is not part of the actual name.  This is a GNU
 328    extension.  For example, the symbol name `stat@ver2' is taken to
 329    mean the symbol `stat' in version `ver2'.  */
 330
 331 #define ELF_VER_CHR     '@'
 332
 333 #endif /* _ELF_COMMON_H */