Home | History | Annotate | Download | only in Support
      1 //===-- llvm/Support/ELF.h - ELF constants and data structures --*- C++ -*-===//
      2 //
      3 //                     The LLVM Compiler Infrastructure
      4 //
      5 // This file is distributed under the University of Illinois Open Source
      6 // License. See LICENSE.TXT for details.
      7 //
      8 //===----------------------------------------------------------------------===//
      9 //
     10 // This header contains common, non-processor-specific data structures and
     11 // constants for the ELF file format.
     12 //
     13 // The details of the ELF32 bits in this file are largely based on the Tool
     14 // Interface Standard (TIS) Executable and Linking Format (ELF) Specification
     15 // Version 1.2, May 1995. The ELF64 stuff is based on ELF-64 Object File Format
     16 // Version 1.5, Draft 2, May 1998 as well as OpenBSD header files.
     17 //
     18 //===----------------------------------------------------------------------===//
     19 
     20 #ifndef LLVM_SUPPORT_ELF_H
     21 #define LLVM_SUPPORT_ELF_H
     22 
     23 #include "llvm/Support/Compiler.h"
     24 #include "llvm/Support/DataTypes.h"
     25 #include <cstring>
     26 
     27 namespace llvm {
     28 
     29 namespace ELF {
     30 
     31 typedef uint32_t Elf32_Addr; // Program address
     32 typedef uint32_t Elf32_Off;  // File offset
     33 typedef uint16_t Elf32_Half;
     34 typedef uint32_t Elf32_Word;
     35 typedef int32_t  Elf32_Sword;
     36 
     37 typedef uint64_t Elf64_Addr;
     38 typedef uint64_t Elf64_Off;
     39 typedef uint16_t Elf64_Half;
     40 typedef uint32_t Elf64_Word;
     41 typedef int32_t  Elf64_Sword;
     42 typedef uint64_t Elf64_Xword;
     43 typedef int64_t  Elf64_Sxword;
     44 
     45 // Object file magic string.
     46 static const char ElfMagic[] = { 0x7f, 'E', 'L', 'F', '\0' };
     47 
     48 // e_ident size and indices.
     49 enum {
     50   EI_MAG0       = 0,          // File identification index.
     51   EI_MAG1       = 1,          // File identification index.
     52   EI_MAG2       = 2,          // File identification index.
     53   EI_MAG3       = 3,          // File identification index.
     54   EI_CLASS      = 4,          // File class.
     55   EI_DATA       = 5,          // Data encoding.
     56   EI_VERSION    = 6,          // File version.
     57   EI_OSABI      = 7,          // OS/ABI identification.
     58   EI_ABIVERSION = 8,          // ABI version.
     59   EI_PAD        = 9,          // Start of padding bytes.
     60   EI_NIDENT     = 16          // Number of bytes in e_ident.
     61 };
     62 
     63 struct Elf32_Ehdr {
     64   unsigned char e_ident[EI_NIDENT]; // ELF Identification bytes
     65   Elf32_Half    e_type;      // Type of file (see ET_* below)
     66   Elf32_Half    e_machine;   // Required architecture for this file (see EM_*)
     67   Elf32_Word    e_version;   // Must be equal to 1
     68   Elf32_Addr    e_entry;     // Address to jump to in order to start program
     69   Elf32_Off     e_phoff;     // Program header table's file offset, in bytes
     70   Elf32_Off     e_shoff;     // Section header table's file offset, in bytes
     71   Elf32_Word    e_flags;     // Processor-specific flags
     72   Elf32_Half    e_ehsize;    // Size of ELF header, in bytes
     73   Elf32_Half    e_phentsize; // Size of an entry in the program header table
     74   Elf32_Half    e_phnum;     // Number of entries in the program header table
     75   Elf32_Half    e_shentsize; // Size of an entry in the section header table
     76   Elf32_Half    e_shnum;     // Number of entries in the section header table
     77   Elf32_Half    e_shstrndx;  // Sect hdr table index of sect name string table
     78   bool checkMagic() const {
     79     return (memcmp(e_ident, ElfMagic, strlen(ElfMagic))) == 0;
     80   }
     81   unsigned char getFileClass() const { return e_ident[EI_CLASS]; }
     82   unsigned char getDataEncoding() const { return e_ident[EI_DATA]; }
     83 };
     84 
     85 // 64-bit ELF header. Fields are the same as for ELF32, but with different
     86 // types (see above).
     87 struct Elf64_Ehdr {
     88   unsigned char e_ident[EI_NIDENT];
     89   Elf64_Half    e_type;
     90   Elf64_Half    e_machine;
     91   Elf64_Word    e_version;
     92   Elf64_Addr    e_entry;
     93   Elf64_Off     e_phoff;
     94   Elf64_Off     e_shoff;
     95   Elf64_Word    e_flags;
     96   Elf64_Half    e_ehsize;
     97   Elf64_Half    e_phentsize;
     98   Elf64_Half    e_phnum;
     99   Elf64_Half    e_shentsize;
    100   Elf64_Half    e_shnum;
    101   Elf64_Half    e_shstrndx;
    102   bool checkMagic() const {
    103     return (memcmp(e_ident, ElfMagic, strlen(ElfMagic))) == 0;
    104   }
    105   unsigned char getFileClass() const { return e_ident[EI_CLASS]; }
    106   unsigned char getDataEncoding() const { return e_ident[EI_DATA]; }
    107 };
    108 
    109 // File types
    110 enum {
    111   ET_NONE   = 0,      // No file type
    112   ET_REL    = 1,      // Relocatable file
    113   ET_EXEC   = 2,      // Executable file
    114   ET_DYN    = 3,      // Shared object file
    115   ET_CORE   = 4,      // Core file
    116   ET_LOPROC = 0xff00, // Beginning of processor-specific codes
    117   ET_HIPROC = 0xffff  // Processor-specific
    118 };
    119 
    120 // Versioning
    121 enum {
    122   EV_NONE = 0,
    123   EV_CURRENT = 1
    124 };
    125 
    126 // Machine architectures
    127 // See current registered ELF machine architectures at:
    128 //    http://www.uxsglobal.com/developers/gabi/latest/ch4.eheader.html
    129 enum {
    130   EM_NONE          = 0, // No machine
    131   EM_M32           = 1, // AT&T WE 32100
    132   EM_SPARC         = 2, // SPARC
    133   EM_386           = 3, // Intel 386
    134   EM_68K           = 4, // Motorola 68000
    135   EM_88K           = 5, // Motorola 88000
    136   EM_IAMCU         = 6, // Intel MCU
    137   EM_860           = 7, // Intel 80860
    138   EM_MIPS          = 8, // MIPS R3000
    139   EM_S370          = 9, // IBM System/370
    140   EM_MIPS_RS3_LE   = 10, // MIPS RS3000 Little-endian
    141   EM_PARISC        = 15, // Hewlett-Packard PA-RISC
    142   EM_VPP500        = 17, // Fujitsu VPP500
    143   EM_SPARC32PLUS   = 18, // Enhanced instruction set SPARC
    144   EM_960           = 19, // Intel 80960
    145   EM_PPC           = 20, // PowerPC
    146   EM_PPC64         = 21, // PowerPC64
    147   EM_S390          = 22, // IBM System/390
    148   EM_SPU           = 23, // IBM SPU/SPC
    149   EM_V800          = 36, // NEC V800
    150   EM_FR20          = 37, // Fujitsu FR20
    151   EM_RH32          = 38, // TRW RH-32
    152   EM_RCE           = 39, // Motorola RCE
    153   EM_ARM           = 40, // ARM
    154   EM_ALPHA         = 41, // DEC Alpha
    155   EM_SH            = 42, // Hitachi SH
    156   EM_SPARCV9       = 43, // SPARC V9
    157   EM_TRICORE       = 44, // Siemens TriCore
    158   EM_ARC           = 45, // Argonaut RISC Core
    159   EM_H8_300        = 46, // Hitachi H8/300
    160   EM_H8_300H       = 47, // Hitachi H8/300H
    161   EM_H8S           = 48, // Hitachi H8S
    162   EM_H8_500        = 49, // Hitachi H8/500
    163   EM_IA_64         = 50, // Intel IA-64 processor architecture
    164   EM_MIPS_X        = 51, // Stanford MIPS-X
    165   EM_COLDFIRE      = 52, // Motorola ColdFire
    166   EM_68HC12        = 53, // Motorola M68HC12
    167   EM_MMA           = 54, // Fujitsu MMA Multimedia Accelerator
    168   EM_PCP           = 55, // Siemens PCP
    169   EM_NCPU          = 56, // Sony nCPU embedded RISC processor
    170   EM_NDR1          = 57, // Denso NDR1 microprocessor
    171   EM_STARCORE      = 58, // Motorola Star*Core processor
    172   EM_ME16          = 59, // Toyota ME16 processor
    173   EM_ST100         = 60, // STMicroelectronics ST100 processor
    174   EM_TINYJ         = 61, // Advanced Logic Corp. TinyJ embedded processor family
    175   EM_X86_64        = 62, // AMD x86-64 architecture
    176   EM_PDSP          = 63, // Sony DSP Processor
    177   EM_PDP10         = 64, // Digital Equipment Corp. PDP-10
    178   EM_PDP11         = 65, // Digital Equipment Corp. PDP-11
    179   EM_FX66          = 66, // Siemens FX66 microcontroller
    180   EM_ST9PLUS       = 67, // STMicroelectronics ST9+ 8/16 bit microcontroller
    181   EM_ST7           = 68, // STMicroelectronics ST7 8-bit microcontroller
    182   EM_68HC16        = 69, // Motorola MC68HC16 Microcontroller
    183   EM_68HC11        = 70, // Motorola MC68HC11 Microcontroller
    184   EM_68HC08        = 71, // Motorola MC68HC08 Microcontroller
    185   EM_68HC05        = 72, // Motorola MC68HC05 Microcontroller
    186   EM_SVX           = 73, // Silicon Graphics SVx
    187   EM_ST19          = 74, // STMicroelectronics ST19 8-bit microcontroller
    188   EM_VAX           = 75, // Digital VAX
    189   EM_CRIS          = 76, // Axis Communications 32-bit embedded processor
    190   EM_JAVELIN       = 77, // Infineon Technologies 32-bit embedded processor
    191   EM_FIREPATH      = 78, // Element 14 64-bit DSP Processor
    192   EM_ZSP           = 79, // LSI Logic 16-bit DSP Processor
    193   EM_MMIX          = 80, // Donald Knuth's educational 64-bit processor
    194   EM_HUANY         = 81, // Harvard University machine-independent object files
    195   EM_PRISM         = 82, // SiTera Prism
    196   EM_AVR           = 83, // Atmel AVR 8-bit microcontroller
    197   EM_FR30          = 84, // Fujitsu FR30
    198   EM_D10V          = 85, // Mitsubishi D10V
    199   EM_D30V          = 86, // Mitsubishi D30V
    200   EM_V850          = 87, // NEC v850
    201   EM_M32R          = 88, // Mitsubishi M32R
    202   EM_MN10300       = 89, // Matsushita MN10300
    203   EM_MN10200       = 90, // Matsushita MN10200
    204   EM_PJ            = 91, // picoJava
    205   EM_OPENRISC      = 92, // OpenRISC 32-bit embedded processor
    206   EM_ARC_COMPACT   = 93, // ARC International ARCompact processor (old
    207                          // spelling/synonym: EM_ARC_A5)
    208   EM_XTENSA        = 94, // Tensilica Xtensa Architecture
    209   EM_VIDEOCORE     = 95, // Alphamosaic VideoCore processor
    210   EM_TMM_GPP       = 96, // Thompson Multimedia General Purpose Processor
    211   EM_NS32K         = 97, // National Semiconductor 32000 series
    212   EM_TPC           = 98, // Tenor Network TPC processor
    213   EM_SNP1K         = 99, // Trebia SNP 1000 processor
    214   EM_ST200         = 100, // STMicroelectronics (www.st.com) ST200
    215   EM_IP2K          = 101, // Ubicom IP2xxx microcontroller family
    216   EM_MAX           = 102, // MAX Processor
    217   EM_CR            = 103, // National Semiconductor CompactRISC microprocessor
    218   EM_F2MC16        = 104, // Fujitsu F2MC16
    219   EM_MSP430        = 105, // Texas Instruments embedded microcontroller msp430
    220   EM_BLACKFIN      = 106, // Analog Devices Blackfin (DSP) processor
    221   EM_SE_C33        = 107, // S1C33 Family of Seiko Epson processors
    222   EM_SEP           = 108, // Sharp embedded microprocessor
    223   EM_ARCA          = 109, // Arca RISC Microprocessor
    224   EM_UNICORE       = 110, // Microprocessor series from PKU-Unity Ltd. and MPRC
    225                           // of Peking University
    226   EM_EXCESS        = 111, // eXcess: 16/32/64-bit configurable embedded CPU
    227   EM_DXP           = 112, // Icera Semiconductor Inc. Deep Execution Processor
    228   EM_ALTERA_NIOS2  = 113, // Altera Nios II soft-core processor
    229   EM_CRX           = 114, // National Semiconductor CompactRISC CRX
    230   EM_XGATE         = 115, // Motorola XGATE embedded processor
    231   EM_C166          = 116, // Infineon C16x/XC16x processor
    232   EM_M16C          = 117, // Renesas M16C series microprocessors
    233   EM_DSPIC30F      = 118, // Microchip Technology dsPIC30F Digital Signal
    234                           // Controller
    235   EM_CE            = 119, // Freescale Communication Engine RISC core
    236   EM_M32C          = 120, // Renesas M32C series microprocessors
    237   EM_TSK3000       = 131, // Altium TSK3000 core
    238   EM_RS08          = 132, // Freescale RS08 embedded processor
    239   EM_SHARC         = 133, // Analog Devices SHARC family of 32-bit DSP
    240                           // processors
    241   EM_ECOG2         = 134, // Cyan Technology eCOG2 microprocessor
    242   EM_SCORE7        = 135, // Sunplus S+core7 RISC processor
    243   EM_DSP24         = 136, // New Japan Radio (NJR) 24-bit DSP Processor
    244   EM_VIDEOCORE3    = 137, // Broadcom VideoCore III processor
    245   EM_LATTICEMICO32 = 138, // RISC processor for Lattice FPGA architecture
    246   EM_SE_C17        = 139, // Seiko Epson C17 family
    247   EM_TI_C6000      = 140, // The Texas Instruments TMS320C6000 DSP family
    248   EM_TI_C2000      = 141, // The Texas Instruments TMS320C2000 DSP family
    249   EM_TI_C5500      = 142, // The Texas Instruments TMS320C55x DSP family
    250   EM_MMDSP_PLUS    = 160, // STMicroelectronics 64bit VLIW Data Signal Processor
    251   EM_CYPRESS_M8C   = 161, // Cypress M8C microprocessor
    252   EM_R32C          = 162, // Renesas R32C series microprocessors
    253   EM_TRIMEDIA      = 163, // NXP Semiconductors TriMedia architecture family
    254   EM_HEXAGON       = 164, // Qualcomm Hexagon processor
    255   EM_8051          = 165, // Intel 8051 and variants
    256   EM_STXP7X        = 166, // STMicroelectronics STxP7x family of configurable
    257                           // and extensible RISC processors
    258   EM_NDS32         = 167, // Andes Technology compact code size embedded RISC
    259                           // processor family
    260   EM_ECOG1         = 168, // Cyan Technology eCOG1X family
    261   EM_ECOG1X        = 168, // Cyan Technology eCOG1X family
    262   EM_MAXQ30        = 169, // Dallas Semiconductor MAXQ30 Core Micro-controllers
    263   EM_XIMO16        = 170, // New Japan Radio (NJR) 16-bit DSP Processor
    264   EM_MANIK         = 171, // M2000 Reconfigurable RISC Microprocessor
    265   EM_CRAYNV2       = 172, // Cray Inc. NV2 vector architecture
    266   EM_RX            = 173, // Renesas RX family
    267   EM_METAG         = 174, // Imagination Technologies META processor
    268                           // architecture
    269   EM_MCST_ELBRUS   = 175, // MCST Elbrus general purpose hardware architecture
    270   EM_ECOG16        = 176, // Cyan Technology eCOG16 family
    271   EM_CR16          = 177, // National Semiconductor CompactRISC CR16 16-bit
    272                           // microprocessor
    273   EM_ETPU          = 178, // Freescale Extended Time Processing Unit
    274   EM_SLE9X         = 179, // Infineon Technologies SLE9X core
    275   EM_L10M          = 180, // Intel L10M
    276   EM_K10M          = 181, // Intel K10M
    277   EM_AARCH64       = 183, // ARM AArch64
    278   EM_AVR32         = 185, // Atmel Corporation 32-bit microprocessor family
    279   EM_STM8          = 186, // STMicroeletronics STM8 8-bit microcontroller
    280   EM_TILE64        = 187, // Tilera TILE64 multicore architecture family
    281   EM_TILEPRO       = 188, // Tilera TILEPro multicore architecture family
    282   EM_CUDA          = 190, // NVIDIA CUDA architecture
    283   EM_TILEGX        = 191, // Tilera TILE-Gx multicore architecture family
    284   EM_CLOUDSHIELD   = 192, // CloudShield architecture family
    285   EM_COREA_1ST     = 193, // KIPO-KAIST Core-A 1st generation processor family
    286   EM_COREA_2ND     = 194, // KIPO-KAIST Core-A 2nd generation processor family
    287   EM_ARC_COMPACT2  = 195, // Synopsys ARCompact V2
    288   EM_OPEN8         = 196, // Open8 8-bit RISC soft processor core
    289   EM_RL78          = 197, // Renesas RL78 family
    290   EM_VIDEOCORE5    = 198, // Broadcom VideoCore V processor
    291   EM_78KOR         = 199, // Renesas 78KOR family
    292   EM_56800EX       = 200, // Freescale 56800EX Digital Signal Controller (DSC)
    293   EM_BA1           = 201, // Beyond BA1 CPU architecture
    294   EM_BA2           = 202, // Beyond BA2 CPU architecture
    295   EM_XCORE         = 203, // XMOS xCORE processor family
    296   EM_MCHP_PIC      = 204, // Microchip 8-bit PIC(r) family
    297   EM_INTEL205      = 205, // Reserved by Intel
    298   EM_INTEL206      = 206, // Reserved by Intel
    299   EM_INTEL207      = 207, // Reserved by Intel
    300   EM_INTEL208      = 208, // Reserved by Intel
    301   EM_INTEL209      = 209, // Reserved by Intel
    302   EM_KM32          = 210, // KM211 KM32 32-bit processor
    303   EM_KMX32         = 211, // KM211 KMX32 32-bit processor
    304   EM_KMX16         = 212, // KM211 KMX16 16-bit processor
    305   EM_KMX8          = 213, // KM211 KMX8 8-bit processor
    306   EM_KVARC         = 214, // KM211 KVARC processor
    307   EM_CDP           = 215, // Paneve CDP architecture family
    308   EM_COGE          = 216, // Cognitive Smart Memory Processor
    309   EM_COOL          = 217, // iCelero CoolEngine
    310   EM_NORC          = 218, // Nanoradio Optimized RISC
    311   EM_CSR_KALIMBA   = 219, // CSR Kalimba architecture family
    312   EM_AMDGPU        = 224  // AMD GPU architecture
    313 };
    314 
    315 // Object file classes.
    316 enum {
    317   ELFCLASSNONE = 0,
    318   ELFCLASS32 = 1, // 32-bit object file
    319   ELFCLASS64 = 2  // 64-bit object file
    320 };
    321 
    322 // Object file byte orderings.
    323 enum {
    324   ELFDATANONE = 0, // Invalid data encoding.
    325   ELFDATA2LSB = 1, // Little-endian object file
    326   ELFDATA2MSB = 2  // Big-endian object file
    327 };
    328 
    329 // OS ABI identification.
    330 enum {
    331   ELFOSABI_NONE = 0,          // UNIX System V ABI
    332   ELFOSABI_HPUX = 1,          // HP-UX operating system
    333   ELFOSABI_NETBSD = 2,        // NetBSD
    334   ELFOSABI_GNU = 3,           // GNU/Linux
    335   ELFOSABI_LINUX = 3,         // Historical alias for ELFOSABI_GNU.
    336   ELFOSABI_HURD = 4,          // GNU/Hurd
    337   ELFOSABI_SOLARIS = 6,       // Solaris
    338   ELFOSABI_AIX = 7,           // AIX
    339   ELFOSABI_IRIX = 8,          // IRIX
    340   ELFOSABI_FREEBSD = 9,       // FreeBSD
    341   ELFOSABI_TRU64 = 10,        // TRU64 UNIX
    342   ELFOSABI_MODESTO = 11,      // Novell Modesto
    343   ELFOSABI_OPENBSD = 12,      // OpenBSD
    344   ELFOSABI_OPENVMS = 13,      // OpenVMS
    345   ELFOSABI_NSK = 14,          // Hewlett-Packard Non-Stop Kernel
    346   ELFOSABI_AROS = 15,         // AROS
    347   ELFOSABI_FENIXOS = 16,      // FenixOS
    348   ELFOSABI_CLOUDABI = 17,     // Nuxi CloudABI
    349   ELFOSABI_C6000_ELFABI = 64, // Bare-metal TMS320C6000
    350   ELFOSABI_AMDGPU_HSA = 64,   // AMD HSA runtime
    351   ELFOSABI_C6000_LINUX = 65,  // Linux TMS320C6000
    352   ELFOSABI_ARM = 97,          // ARM
    353   ELFOSABI_STANDALONE = 255   // Standalone (embedded) application
    354 };
    355 
    356 #define ELF_RELOC(name, value) name = value,
    357 
    358 // X86_64 relocations.
    359 enum {
    360 #include "ELFRelocs/x86_64.def"
    361 };
    362 
    363 // i386 relocations.
    364 enum {
    365 #include "ELFRelocs/i386.def"
    366 };
    367 
    368 // ELF Relocation types for PPC32
    369 enum {
    370 #include "ELFRelocs/PowerPC.def"
    371 };
    372 
    373 // Specific e_flags for PPC64
    374 enum {
    375   // e_flags bits specifying ABI:
    376   // 1 for original ABI using function descriptors,
    377   // 2 for revised ABI without function descriptors,
    378   // 0 for unspecified or not using any features affected by the differences.
    379   EF_PPC64_ABI = 3
    380 };
    381 
    382 // Special values for the st_other field in the symbol table entry for PPC64.
    383 enum {
    384   STO_PPC64_LOCAL_BIT = 5,
    385   STO_PPC64_LOCAL_MASK = (7 << STO_PPC64_LOCAL_BIT)
    386 };
    387 static inline int64_t
    388 decodePPC64LocalEntryOffset(unsigned Other) {
    389   unsigned Val = (Other & STO_PPC64_LOCAL_MASK) >> STO_PPC64_LOCAL_BIT;
    390   return ((1 << Val) >> 2) << 2;
    391 }
    392 static inline unsigned
    393 encodePPC64LocalEntryOffset(int64_t Offset) {
    394   unsigned Val = (Offset >= 4 * 4
    395                   ? (Offset >= 8 * 4
    396                      ? (Offset >= 16 * 4 ? 6 : 5)
    397                      : 4)
    398                   : (Offset >= 2 * 4
    399                      ? 3
    400                      : (Offset >= 1 * 4 ? 2 : 0)));
    401   return Val << STO_PPC64_LOCAL_BIT;
    402 }
    403 
    404 // ELF Relocation types for PPC64
    405 enum {
    406 #include "ELFRelocs/PowerPC64.def"
    407 };
    408 
    409 // ELF Relocation types for AArch64
    410 enum {
    411 #include "ELFRelocs/AArch64.def"
    412 };
    413 
    414 // ARM Specific e_flags
    415 enum : unsigned {
    416   EF_ARM_SOFT_FLOAT =     0x00000200U,
    417   EF_ARM_VFP_FLOAT =      0x00000400U,
    418   EF_ARM_EABI_UNKNOWN =   0x00000000U,
    419   EF_ARM_EABI_VER1 =      0x01000000U,
    420   EF_ARM_EABI_VER2 =      0x02000000U,
    421   EF_ARM_EABI_VER3 =      0x03000000U,
    422   EF_ARM_EABI_VER4 =      0x04000000U,
    423   EF_ARM_EABI_VER5 =      0x05000000U,
    424   EF_ARM_EABIMASK =       0xFF000000U
    425 };
    426 
    427 // ELF Relocation types for ARM
    428 enum {
    429 #include "ELFRelocs/ARM.def"
    430 };
    431 
    432 // AVR specific e_flags
    433 enum : unsigned {
    434   EF_AVR_ARCH_AVR1    = 1,
    435   EF_AVR_ARCH_AVR2    = 2,
    436   EF_AVR_ARCH_AVR25   = 25,
    437   EF_AVR_ARCH_AVR3    = 3,
    438   EF_AVR_ARCH_AVR31   = 31,
    439   EF_AVR_ARCH_AVR35   = 35,
    440   EF_AVR_ARCH_AVR4    = 4,
    441   EF_AVR_ARCH_AVR5    = 5,
    442   EF_AVR_ARCH_AVR51   = 51,
    443   EF_AVR_ARCH_AVR6    = 6,
    444   EF_AVR_ARCH_AVRTINY = 100,
    445   EF_AVR_ARCH_XMEGA1  = 101,
    446   EF_AVR_ARCH_XMEGA2  = 102,
    447   EF_AVR_ARCH_XMEGA3  = 103,
    448   EF_AVR_ARCH_XMEGA4  = 104,
    449   EF_AVR_ARCH_XMEGA5  = 105,
    450   EF_AVR_ARCH_XMEGA6  = 106,
    451   EF_AVR_ARCH_XMEGA7  = 107
    452 };
    453 
    454 // ELF Relocation types for AVR
    455 enum {
    456 #include "ELFRelocs/AVR.def"
    457 };
    458 
    459 // Mips Specific e_flags
    460 enum : unsigned {
    461   EF_MIPS_NOREORDER = 0x00000001, // Don't reorder instructions
    462   EF_MIPS_PIC       = 0x00000002, // Position independent code
    463   EF_MIPS_CPIC      = 0x00000004, // Call object with Position independent code
    464   EF_MIPS_ABI2      = 0x00000020, // File uses N32 ABI
    465   EF_MIPS_32BITMODE = 0x00000100, // Code compiled for a 64-bit machine
    466                                   // in 32-bit mode
    467   EF_MIPS_FP64      = 0x00000200, // Code compiled for a 32-bit machine
    468                                   // but uses 64-bit FP registers
    469   EF_MIPS_NAN2008   = 0x00000400, // Uses IEE 754-2008 NaN encoding
    470 
    471   // ABI flags
    472   EF_MIPS_ABI_O32    = 0x00001000, // This file follows the first MIPS 32 bit ABI
    473   EF_MIPS_ABI_O64    = 0x00002000, // O32 ABI extended for 64-bit architecture.
    474   EF_MIPS_ABI_EABI32 = 0x00003000, // EABI in 32 bit mode.
    475   EF_MIPS_ABI_EABI64 = 0x00004000, // EABI in 64 bit mode.
    476   EF_MIPS_ABI        = 0x0000f000, // Mask for selecting EF_MIPS_ABI_ variant.
    477 
    478   // MIPS machine variant
    479   EF_MIPS_MACH_3900    = 0x00810000, // Toshiba R3900
    480   EF_MIPS_MACH_4010    = 0x00820000, // LSI R4010
    481   EF_MIPS_MACH_4100    = 0x00830000, // NEC VR4100
    482   EF_MIPS_MACH_4650    = 0x00850000, // MIPS R4650
    483   EF_MIPS_MACH_4120    = 0x00870000, // NEC VR4120
    484   EF_MIPS_MACH_4111    = 0x00880000, // NEC VR4111/VR4181
    485   EF_MIPS_MACH_SB1     = 0x008a0000, // Broadcom SB-1
    486   EF_MIPS_MACH_OCTEON  = 0x008b0000, // Cavium Networks Octeon
    487   EF_MIPS_MACH_XLR     = 0x008c0000, // RMI Xlr
    488   EF_MIPS_MACH_OCTEON2 = 0x008d0000, // Cavium Networks Octeon2
    489   EF_MIPS_MACH_OCTEON3 = 0x008e0000, // Cavium Networks Octeon3
    490   EF_MIPS_MACH_5400    = 0x00910000, // NEC VR5400
    491   EF_MIPS_MACH_5900    = 0x00920000, // MIPS R5900
    492   EF_MIPS_MACH_5500    = 0x00980000, // NEC VR5500
    493   EF_MIPS_MACH_9000    = 0x00990000, // Unknown
    494   EF_MIPS_MACH_LS2E    = 0x00a00000, // ST Microelectronics Loongson 2E
    495   EF_MIPS_MACH_LS2F    = 0x00a10000, // ST Microelectronics Loongson 2F
    496   EF_MIPS_MACH_LS3A    = 0x00a20000, // Loongson 3A
    497   EF_MIPS_MACH         = 0x00ff0000, // EF_MIPS_MACH_xxx selection mask
    498 
    499   // ARCH_ASE
    500   EF_MIPS_MICROMIPS = 0x02000000, // microMIPS
    501   EF_MIPS_ARCH_ASE_M16 =
    502                       0x04000000, // Has Mips-16 ISA extensions
    503   EF_MIPS_ARCH_ASE_MDMX =
    504                       0x08000000, // Has MDMX multimedia extensions
    505   EF_MIPS_ARCH_ASE  = 0x0f000000, // Mask for EF_MIPS_ARCH_ASE_xxx flags
    506 
    507   // ARCH
    508   EF_MIPS_ARCH_1    = 0x00000000, // MIPS1 instruction set
    509   EF_MIPS_ARCH_2    = 0x10000000, // MIPS2 instruction set
    510   EF_MIPS_ARCH_3    = 0x20000000, // MIPS3 instruction set
    511   EF_MIPS_ARCH_4    = 0x30000000, // MIPS4 instruction set
    512   EF_MIPS_ARCH_5    = 0x40000000, // MIPS5 instruction set
    513   EF_MIPS_ARCH_32   = 0x50000000, // MIPS32 instruction set per linux not elf.h
    514   EF_MIPS_ARCH_64   = 0x60000000, // MIPS64 instruction set per linux not elf.h
    515   EF_MIPS_ARCH_32R2 = 0x70000000, // mips32r2, mips32r3, mips32r5
    516   EF_MIPS_ARCH_64R2 = 0x80000000, // mips64r2, mips64r3, mips64r5
    517   EF_MIPS_ARCH_32R6 = 0x90000000, // mips32r6
    518   EF_MIPS_ARCH_64R6 = 0xa0000000, // mips64r6
    519   EF_MIPS_ARCH      = 0xf0000000  // Mask for applying EF_MIPS_ARCH_ variant
    520 };
    521 
    522 // ELF Relocation types for Mips
    523 enum {
    524 #include "ELFRelocs/Mips.def"
    525 };
    526 
    527 // Special values for the st_other field in the symbol table entry for MIPS.
    528 enum {
    529   STO_MIPS_OPTIONAL        = 0x04,  // Symbol whose definition is optional
    530   STO_MIPS_PLT             = 0x08,  // PLT entry related dynamic table record
    531   STO_MIPS_PIC             = 0x20,  // PIC func in an object mixes PIC/non-PIC
    532   STO_MIPS_MICROMIPS       = 0x80,  // MIPS Specific ISA for MicroMips
    533   STO_MIPS_MIPS16          = 0xf0   // MIPS Specific ISA for Mips16
    534 };
    535 
    536 // .MIPS.options section descriptor kinds
    537 enum {
    538   ODK_NULL       = 0,   // Undefined
    539   ODK_REGINFO    = 1,   // Register usage information
    540   ODK_EXCEPTIONS = 2,   // Exception processing options
    541   ODK_PAD        = 3,   // Section padding options
    542   ODK_HWPATCH    = 4,   // Hardware patches applied
    543   ODK_FILL       = 5,   // Linker fill value
    544   ODK_TAGS       = 6,   // Space for tool identification
    545   ODK_HWAND      = 7,   // Hardware AND patches applied
    546   ODK_HWOR       = 8,   // Hardware OR patches applied
    547   ODK_GP_GROUP   = 9,   // GP group to use for text/data sections
    548   ODK_IDENT      = 10,  // ID information
    549   ODK_PAGESIZE   = 11   // Page size information
    550 };
    551 
    552 // Hexagon-specific e_flags
    553 enum {
    554   // Object processor version flags, bits[11:0]
    555   EF_HEXAGON_MACH_V2      = 0x00000001,   // Hexagon V2
    556   EF_HEXAGON_MACH_V3      = 0x00000002,   // Hexagon V3
    557   EF_HEXAGON_MACH_V4      = 0x00000003,   // Hexagon V4
    558   EF_HEXAGON_MACH_V5      = 0x00000004,   // Hexagon V5
    559   EF_HEXAGON_MACH_V55     = 0x00000005,   // Hexagon V55
    560   EF_HEXAGON_MACH_V60     = 0x00000060,   // Hexagon V60
    561 
    562   // Highest ISA version flags
    563   EF_HEXAGON_ISA_MACH     = 0x00000000,   // Same as specified in bits[11:0]
    564                                           // of e_flags
    565   EF_HEXAGON_ISA_V2       = 0x00000010,   // Hexagon V2 ISA
    566   EF_HEXAGON_ISA_V3       = 0x00000020,   // Hexagon V3 ISA
    567   EF_HEXAGON_ISA_V4       = 0x00000030,   // Hexagon V4 ISA
    568   EF_HEXAGON_ISA_V5       = 0x00000040,   // Hexagon V5 ISA
    569   EF_HEXAGON_ISA_V55      = 0x00000050,   // Hexagon V55 ISA
    570   EF_HEXAGON_ISA_V60      = 0x00000060,   // Hexagon V60 ISA
    571 };
    572 
    573 // Hexagon-specific section indexes for common small data
    574 enum {
    575   SHN_HEXAGON_SCOMMON     = 0xff00,       // Other access sizes
    576   SHN_HEXAGON_SCOMMON_1   = 0xff01,       // Byte-sized access
    577   SHN_HEXAGON_SCOMMON_2   = 0xff02,       // Half-word-sized access
    578   SHN_HEXAGON_SCOMMON_4   = 0xff03,       // Word-sized access
    579   SHN_HEXAGON_SCOMMON_8   = 0xff04        // Double-word-size access
    580 };
    581 
    582 // ELF Relocation types for Hexagon
    583 enum {
    584 #include "ELFRelocs/Hexagon.def"
    585 };
    586 
    587 // ELF Relocation types for S390/zSeries
    588 enum {
    589 #include "ELFRelocs/SystemZ.def"
    590 };
    591 
    592 // ELF Relocation type for Sparc.
    593 enum {
    594 #include "ELFRelocs/Sparc.def"
    595 };
    596 
    597 #undef ELF_RELOC
    598 
    599 // Section header.
    600 struct Elf32_Shdr {
    601   Elf32_Word sh_name;      // Section name (index into string table)
    602   Elf32_Word sh_type;      // Section type (SHT_*)
    603   Elf32_Word sh_flags;     // Section flags (SHF_*)
    604   Elf32_Addr sh_addr;      // Address where section is to be loaded
    605   Elf32_Off  sh_offset;    // File offset of section data, in bytes
    606   Elf32_Word sh_size;      // Size of section, in bytes
    607   Elf32_Word sh_link;      // Section type-specific header table index link
    608   Elf32_Word sh_info;      // Section type-specific extra information
    609   Elf32_Word sh_addralign; // Section address alignment
    610   Elf32_Word sh_entsize;   // Size of records contained within the section
    611 };
    612 
    613 // Section header for ELF64 - same fields as ELF32, different types.
    614 struct Elf64_Shdr {
    615   Elf64_Word  sh_name;
    616   Elf64_Word  sh_type;
    617   Elf64_Xword sh_flags;
    618   Elf64_Addr  sh_addr;
    619   Elf64_Off   sh_offset;
    620   Elf64_Xword sh_size;
    621   Elf64_Word  sh_link;
    622   Elf64_Word  sh_info;
    623   Elf64_Xword sh_addralign;
    624   Elf64_Xword sh_entsize;
    625 };
    626 
    627 // Special section indices.
    628 enum {
    629   SHN_UNDEF     = 0,      // Undefined, missing, irrelevant, or meaningless
    630   SHN_LORESERVE = 0xff00, // Lowest reserved index
    631   SHN_LOPROC    = 0xff00, // Lowest processor-specific index
    632   SHN_HIPROC    = 0xff1f, // Highest processor-specific index
    633   SHN_LOOS      = 0xff20, // Lowest operating system-specific index
    634   SHN_HIOS      = 0xff3f, // Highest operating system-specific index
    635   SHN_ABS       = 0xfff1, // Symbol has absolute value; does not need relocation
    636   SHN_COMMON    = 0xfff2, // FORTRAN COMMON or C external global variables
    637   SHN_XINDEX    = 0xffff, // Mark that the index is >= SHN_LORESERVE
    638   SHN_HIRESERVE = 0xffff  // Highest reserved index
    639 };
    640 
    641 // Section types.
    642 enum : unsigned {
    643   SHT_NULL          = 0,  // No associated section (inactive entry).
    644   SHT_PROGBITS      = 1,  // Program-defined contents.
    645   SHT_SYMTAB        = 2,  // Symbol table.
    646   SHT_STRTAB        = 3,  // String table.
    647   SHT_RELA          = 4,  // Relocation entries; explicit addends.
    648   SHT_HASH          = 5,  // Symbol hash table.
    649   SHT_DYNAMIC       = 6,  // Information for dynamic linking.
    650   SHT_NOTE          = 7,  // Information about the file.
    651   SHT_NOBITS        = 8,  // Data occupies no space in the file.
    652   SHT_REL           = 9,  // Relocation entries; no explicit addends.
    653   SHT_SHLIB         = 10, // Reserved.
    654   SHT_DYNSYM        = 11, // Symbol table.
    655   SHT_INIT_ARRAY    = 14, // Pointers to initialization functions.
    656   SHT_FINI_ARRAY    = 15, // Pointers to termination functions.
    657   SHT_PREINIT_ARRAY = 16, // Pointers to pre-init functions.
    658   SHT_GROUP         = 17, // Section group.
    659   SHT_SYMTAB_SHNDX  = 18, // Indices for SHN_XINDEX entries.
    660   SHT_LOOS          = 0x60000000, // Lowest operating system-specific type.
    661   SHT_GNU_ATTRIBUTES= 0x6ffffff5, // Object attributes.
    662   SHT_GNU_HASH      = 0x6ffffff6, // GNU-style hash table.
    663   SHT_GNU_verdef    = 0x6ffffffd, // GNU version definitions.
    664   SHT_GNU_verneed   = 0x6ffffffe, // GNU version references.
    665   SHT_GNU_versym    = 0x6fffffff, // GNU symbol versions table.
    666   SHT_HIOS          = 0x6fffffff, // Highest operating system-specific type.
    667   SHT_LOPROC        = 0x70000000, // Lowest processor arch-specific type.
    668   // Fixme: All this is duplicated in MCSectionELF. Why??
    669   // Exception Index table
    670   SHT_ARM_EXIDX           = 0x70000001U,
    671   // BPABI DLL dynamic linking pre-emption map
    672   SHT_ARM_PREEMPTMAP      = 0x70000002U,
    673   //  Object file compatibility attributes
    674   SHT_ARM_ATTRIBUTES      = 0x70000003U,
    675   SHT_ARM_DEBUGOVERLAY    = 0x70000004U,
    676   SHT_ARM_OVERLAYSECTION  = 0x70000005U,
    677   SHT_HEX_ORDERED         = 0x70000000, // Link editor is to sort the entries in
    678                                         // this section based on their sizes
    679   SHT_X86_64_UNWIND       = 0x70000001, // Unwind information
    680 
    681   SHT_MIPS_REGINFO        = 0x70000006, // Register usage information
    682   SHT_MIPS_OPTIONS        = 0x7000000d, // General options
    683   SHT_MIPS_ABIFLAGS       = 0x7000002a, // ABI information.
    684 
    685   SHT_HIPROC        = 0x7fffffff, // Highest processor arch-specific type.
    686   SHT_LOUSER        = 0x80000000, // Lowest type reserved for applications.
    687   SHT_HIUSER        = 0xffffffff  // Highest type reserved for applications.
    688 };
    689 
    690 // Section flags.
    691 enum : unsigned {
    692   // Section data should be writable during execution.
    693   SHF_WRITE = 0x1,
    694 
    695   // Section occupies memory during program execution.
    696   SHF_ALLOC = 0x2,
    697 
    698   // Section contains executable machine instructions.
    699   SHF_EXECINSTR = 0x4,
    700 
    701   // The data in this section may be merged.
    702   SHF_MERGE = 0x10,
    703 
    704   // The data in this section is null-terminated strings.
    705   SHF_STRINGS = 0x20,
    706 
    707   // A field in this section holds a section header table index.
    708   SHF_INFO_LINK = 0x40U,
    709 
    710   // Adds special ordering requirements for link editors.
    711   SHF_LINK_ORDER = 0x80U,
    712 
    713   // This section requires special OS-specific processing to avoid incorrect
    714   // behavior.
    715   SHF_OS_NONCONFORMING = 0x100U,
    716 
    717   // This section is a member of a section group.
    718   SHF_GROUP = 0x200U,
    719 
    720   // This section holds Thread-Local Storage.
    721   SHF_TLS = 0x400U,
    722 
    723   // This section is excluded from the final executable or shared library.
    724   SHF_EXCLUDE = 0x80000000U,
    725 
    726   // Start of target-specific flags.
    727 
    728   /// XCORE_SHF_CP_SECTION - All sections with the "c" flag are grouped
    729   /// together by the linker to form the constant pool and the cp register is
    730   /// set to the start of the constant pool by the boot code.
    731   XCORE_SHF_CP_SECTION = 0x800U,
    732 
    733   /// XCORE_SHF_DP_SECTION - All sections with the "d" flag are grouped
    734   /// together by the linker to form the data section and the dp register is
    735   /// set to the start of the section by the boot code.
    736   XCORE_SHF_DP_SECTION = 0x1000U,
    737 
    738   SHF_MASKOS   = 0x0ff00000,
    739 
    740   // Bits indicating processor-specific flags.
    741   SHF_MASKPROC = 0xf0000000,
    742 
    743   // If an object file section does not have this flag set, then it may not hold
    744   // more than 2GB and can be freely referred to in objects using smaller code
    745   // models. Otherwise, only objects using larger code models can refer to them.
    746   // For example, a medium code model object can refer to data in a section that
    747   // sets this flag besides being able to refer to data in a section that does
    748   // not set it; likewise, a small code model object can refer only to code in a
    749   // section that does not set this flag.
    750   SHF_X86_64_LARGE = 0x10000000,
    751 
    752   // All sections with the GPREL flag are grouped into a global data area
    753   // for faster accesses
    754   SHF_HEX_GPREL = 0x10000000,
    755 
    756   // Section contains text/data which may be replicated in other sections.
    757   // Linker must retain only one copy.
    758   SHF_MIPS_NODUPES = 0x01000000,
    759 
    760   // Linker must generate implicit hidden weak names.
    761   SHF_MIPS_NAMES   = 0x02000000,
    762 
    763   // Section data local to process.
    764   SHF_MIPS_LOCAL   = 0x04000000,
    765 
    766   // Do not strip this section.
    767   SHF_MIPS_NOSTRIP = 0x08000000,
    768 
    769   // Section must be part of global data area.
    770   SHF_MIPS_GPREL   = 0x10000000,
    771 
    772   // This section should be merged.
    773   SHF_MIPS_MERGE   = 0x20000000,
    774 
    775   // Address size to be inferred from section entry size.
    776   SHF_MIPS_ADDR    = 0x40000000,
    777 
    778   // Section data is string data by default.
    779   SHF_MIPS_STRING  = 0x80000000,
    780 
    781   SHF_AMDGPU_HSA_GLOBAL   = 0x00100000,
    782   SHF_AMDGPU_HSA_READONLY = 0x00200000,
    783   SHF_AMDGPU_HSA_CODE     = 0x00400000,
    784   SHF_AMDGPU_HSA_AGENT    = 0x00800000
    785 };
    786 
    787 // Section Group Flags
    788 enum : unsigned {
    789   GRP_COMDAT = 0x1,
    790   GRP_MASKOS = 0x0ff00000,
    791   GRP_MASKPROC = 0xf0000000
    792 };
    793 
    794 // Symbol table entries for ELF32.
    795 struct Elf32_Sym {
    796   Elf32_Word    st_name;  // Symbol name (index into string table)
    797   Elf32_Addr    st_value; // Value or address associated with the symbol
    798   Elf32_Word    st_size;  // Size of the symbol
    799   unsigned char st_info;  // Symbol's type and binding attributes
    800   unsigned char st_other; // Must be zero; reserved
    801   Elf32_Half    st_shndx; // Which section (header table index) it's defined in
    802 
    803   // These accessors and mutators correspond to the ELF32_ST_BIND,
    804   // ELF32_ST_TYPE, and ELF32_ST_INFO macros defined in the ELF specification:
    805   unsigned char getBinding() const { return st_info >> 4; }
    806   unsigned char getType() const { return st_info & 0x0f; }
    807   void setBinding(unsigned char b) { setBindingAndType(b, getType()); }
    808   void setType(unsigned char t) { setBindingAndType(getBinding(), t); }
    809   void setBindingAndType(unsigned char b, unsigned char t) {
    810     st_info = (b << 4) + (t & 0x0f);
    811   }
    812 };
    813 
    814 // Symbol table entries for ELF64.
    815 struct Elf64_Sym {
    816   Elf64_Word      st_name;  // Symbol name (index into string table)
    817   unsigned char   st_info;  // Symbol's type and binding attributes
    818   unsigned char   st_other; // Must be zero; reserved
    819   Elf64_Half      st_shndx; // Which section (header tbl index) it's defined in
    820   Elf64_Addr      st_value; // Value or address associated with the symbol
    821   Elf64_Xword     st_size;  // Size of the symbol
    822 
    823   // These accessors and mutators are identical to those defined for ELF32
    824   // symbol table entries.
    825   unsigned char getBinding() const { return st_info >> 4; }
    826   unsigned char getType() const { return st_info & 0x0f; }
    827   void setBinding(unsigned char b) { setBindingAndType(b, getType()); }
    828   void setType(unsigned char t) { setBindingAndType(getBinding(), t); }
    829   void setBindingAndType(unsigned char b, unsigned char t) {
    830     st_info = (b << 4) + (t & 0x0f);
    831   }
    832 };
    833 
    834 // The size (in bytes) of symbol table entries.
    835 enum {
    836   SYMENTRY_SIZE32 = 16, // 32-bit symbol entry size
    837   SYMENTRY_SIZE64 = 24  // 64-bit symbol entry size.
    838 };
    839 
    840 // Symbol bindings.
    841 enum {
    842   STB_LOCAL = 0,   // Local symbol, not visible outside obj file containing def
    843   STB_GLOBAL = 1,  // Global symbol, visible to all object files being combined
    844   STB_WEAK = 2,    // Weak symbol, like global but lower-precedence
    845   STB_GNU_UNIQUE = 10,
    846   STB_LOOS   = 10, // Lowest operating system-specific binding type
    847   STB_HIOS   = 12, // Highest operating system-specific binding type
    848   STB_LOPROC = 13, // Lowest processor-specific binding type
    849   STB_HIPROC = 15  // Highest processor-specific binding type
    850 };
    851 
    852 // Symbol types.
    853 enum {
    854   STT_NOTYPE  = 0,   // Symbol's type is not specified
    855   STT_OBJECT  = 1,   // Symbol is a data object (variable, array, etc.)
    856   STT_FUNC    = 2,   // Symbol is executable code (function, etc.)
    857   STT_SECTION = 3,   // Symbol refers to a section
    858   STT_FILE    = 4,   // Local, absolute symbol that refers to a file
    859   STT_COMMON  = 5,   // An uninitialized common block
    860   STT_TLS     = 6,   // Thread local data object
    861   STT_GNU_IFUNC = 10, // GNU indirect function
    862   STT_LOOS    = 10,  // Lowest operating system-specific symbol type
    863   STT_HIOS    = 12,  // Highest operating system-specific symbol type
    864   STT_LOPROC  = 13,  // Lowest processor-specific symbol type
    865   STT_HIPROC  = 15,  // Highest processor-specific symbol type
    866 
    867   // AMDGPU symbol types
    868   STT_AMDGPU_HSA_KERNEL            = 10,
    869   STT_AMDGPU_HSA_INDIRECT_FUNCTION = 11,
    870   STT_AMDGPU_HSA_METADATA          = 12
    871 };
    872 
    873 enum {
    874   STV_DEFAULT   = 0,  // Visibility is specified by binding type
    875   STV_INTERNAL  = 1,  // Defined by processor supplements
    876   STV_HIDDEN    = 2,  // Not visible to other components
    877   STV_PROTECTED = 3   // Visible in other components but not preemptable
    878 };
    879 
    880 // Symbol number.
    881 enum {
    882   STN_UNDEF = 0
    883 };
    884 
    885 // Special relocation symbols used in the MIPS64 ELF relocation entries
    886 enum {
    887   RSS_UNDEF = 0, // None
    888   RSS_GP = 1,    // Value of gp
    889   RSS_GP0 = 2,   // Value of gp used to create object being relocated
    890   RSS_LOC = 3    // Address of location being relocated
    891 };
    892 
    893 // Relocation entry, without explicit addend.
    894 struct Elf32_Rel {
    895   Elf32_Addr r_offset; // Location (file byte offset, or program virtual addr)
    896   Elf32_Word r_info;   // Symbol table index and type of relocation to apply
    897 
    898   // These accessors and mutators correspond to the ELF32_R_SYM, ELF32_R_TYPE,
    899   // and ELF32_R_INFO macros defined in the ELF specification:
    900   Elf32_Word getSymbol() const { return (r_info >> 8); }
    901   unsigned char getType() const { return (unsigned char) (r_info & 0x0ff); }
    902   void setSymbol(Elf32_Word s) { setSymbolAndType(s, getType()); }
    903   void setType(unsigned char t) { setSymbolAndType(getSymbol(), t); }
    904   void setSymbolAndType(Elf32_Word s, unsigned char t) {
    905     r_info = (s << 8) + t;
    906   }
    907 };
    908 
    909 // Relocation entry with explicit addend.
    910 struct Elf32_Rela {
    911   Elf32_Addr  r_offset; // Location (file byte offset, or program virtual addr)
    912   Elf32_Word  r_info;   // Symbol table index and type of relocation to apply
    913   Elf32_Sword r_addend; // Compute value for relocatable field by adding this
    914 
    915   // These accessors and mutators correspond to the ELF32_R_SYM, ELF32_R_TYPE,
    916   // and ELF32_R_INFO macros defined in the ELF specification:
    917   Elf32_Word getSymbol() const { return (r_info >> 8); }
    918   unsigned char getType() const { return (unsigned char) (r_info & 0x0ff); }
    919   void setSymbol(Elf32_Word s) { setSymbolAndType(s, getType()); }
    920   void setType(unsigned char t) { setSymbolAndType(getSymbol(), t); }
    921   void setSymbolAndType(Elf32_Word s, unsigned char t) {
    922     r_info = (s << 8) + t;
    923   }
    924 };
    925 
    926 // Relocation entry, without explicit addend.
    927 struct Elf64_Rel {
    928   Elf64_Addr r_offset; // Location (file byte offset, or program virtual addr).
    929   Elf64_Xword r_info;   // Symbol table index and type of relocation to apply.
    930 
    931   // These accessors and mutators correspond to the ELF64_R_SYM, ELF64_R_TYPE,
    932   // and ELF64_R_INFO macros defined in the ELF specification:
    933   Elf64_Word getSymbol() const { return (r_info >> 32); }
    934   Elf64_Word getType() const {
    935     return (Elf64_Word) (r_info & 0xffffffffL);
    936   }
    937   void setSymbol(Elf64_Word s) { setSymbolAndType(s, getType()); }
    938   void setType(Elf64_Word t) { setSymbolAndType(getSymbol(), t); }
    939   void setSymbolAndType(Elf64_Word s, Elf64_Word t) {
    940     r_info = ((Elf64_Xword)s << 32) + (t&0xffffffffL);
    941   }
    942 };
    943 
    944 // Relocation entry with explicit addend.
    945 struct Elf64_Rela {
    946   Elf64_Addr  r_offset; // Location (file byte offset, or program virtual addr).
    947   Elf64_Xword  r_info;   // Symbol table index and type of relocation to apply.
    948   Elf64_Sxword r_addend; // Compute value for relocatable field by adding this.
    949 
    950   // These accessors and mutators correspond to the ELF64_R_SYM, ELF64_R_TYPE,
    951   // and ELF64_R_INFO macros defined in the ELF specification:
    952   Elf64_Word getSymbol() const { return (r_info >> 32); }
    953   Elf64_Word getType() const {
    954     return (Elf64_Word) (r_info & 0xffffffffL);
    955   }
    956   void setSymbol(Elf64_Word s) { setSymbolAndType(s, getType()); }
    957   void setType(Elf64_Word t) { setSymbolAndType(getSymbol(), t); }
    958   void setSymbolAndType(Elf64_Word s, Elf64_Word t) {
    959     r_info = ((Elf64_Xword)s << 32) + (t&0xffffffffL);
    960   }
    961 };
    962 
    963 // Program header for ELF32.
    964 struct Elf32_Phdr {
    965   Elf32_Word p_type;   // Type of segment
    966   Elf32_Off  p_offset; // File offset where segment is located, in bytes
    967   Elf32_Addr p_vaddr;  // Virtual address of beginning of segment
    968   Elf32_Addr p_paddr;  // Physical address of beginning of segment (OS-specific)
    969   Elf32_Word p_filesz; // Num. of bytes in file image of segment (may be zero)
    970   Elf32_Word p_memsz;  // Num. of bytes in mem image of segment (may be zero)
    971   Elf32_Word p_flags;  // Segment flags
    972   Elf32_Word p_align;  // Segment alignment constraint
    973 };
    974 
    975 // Program header for ELF64.
    976 struct Elf64_Phdr {
    977   Elf64_Word   p_type;   // Type of segment
    978   Elf64_Word   p_flags;  // Segment flags
    979   Elf64_Off    p_offset; // File offset where segment is located, in bytes
    980   Elf64_Addr   p_vaddr;  // Virtual address of beginning of segment
    981   Elf64_Addr   p_paddr;  // Physical addr of beginning of segment (OS-specific)
    982   Elf64_Xword  p_filesz; // Num. of bytes in file image of segment (may be zero)
    983   Elf64_Xword  p_memsz;  // Num. of bytes in mem image of segment (may be zero)
    984   Elf64_Xword  p_align;  // Segment alignment constraint
    985 };
    986 
    987 // Segment types.
    988 enum {
    989   PT_NULL    = 0, // Unused segment.
    990   PT_LOAD    = 1, // Loadable segment.
    991   PT_DYNAMIC = 2, // Dynamic linking information.
    992   PT_INTERP  = 3, // Interpreter pathname.
    993   PT_NOTE    = 4, // Auxiliary information.
    994   PT_SHLIB   = 5, // Reserved.
    995   PT_PHDR    = 6, // The program header table itself.
    996   PT_TLS     = 7, // The thread-local storage template.
    997   PT_LOOS    = 0x60000000, // Lowest operating system-specific pt entry type.
    998   PT_HIOS    = 0x6fffffff, // Highest operating system-specific pt entry type.
    999   PT_LOPROC  = 0x70000000, // Lowest processor-specific program hdr entry type.
   1000   PT_HIPROC  = 0x7fffffff, // Highest processor-specific program hdr entry type.
   1001 
   1002   // x86-64 program header types.
   1003   // These all contain stack unwind tables.
   1004   PT_GNU_EH_FRAME  = 0x6474e550,
   1005   PT_SUNW_EH_FRAME = 0x6474e550,
   1006   PT_SUNW_UNWIND   = 0x6464e550,
   1007 
   1008   PT_GNU_STACK  = 0x6474e551, // Indicates stack executability.
   1009   PT_GNU_RELRO  = 0x6474e552, // Read-only after relocation.
   1010 
   1011   // ARM program header types.
   1012   PT_ARM_ARCHEXT = 0x70000000, // Platform architecture compatibility info
   1013   // These all contain stack unwind tables.
   1014   PT_ARM_EXIDX   = 0x70000001,
   1015   PT_ARM_UNWIND  = 0x70000001,
   1016 
   1017   // MIPS program header types.
   1018   PT_MIPS_REGINFO  = 0x70000000,  // Register usage information.
   1019   PT_MIPS_RTPROC   = 0x70000001,  // Runtime procedure table.
   1020   PT_MIPS_OPTIONS  = 0x70000002,  // Options segment.
   1021   PT_MIPS_ABIFLAGS = 0x70000003,  // Abiflags segment.
   1022 
   1023   // AMDGPU program header types.
   1024   PT_AMDGPU_HSA_LOAD_GLOBAL_PROGRAM = 0x60000000,
   1025   PT_AMDGPU_HSA_LOAD_GLOBAL_AGENT   = 0x60000001,
   1026   PT_AMDGPU_HSA_LOAD_READONLY_AGENT = 0x60000002,
   1027   PT_AMDGPU_HSA_LOAD_CODE_AGENT     = 0x60000003
   1028 };
   1029 
   1030 // Segment flag bits.
   1031 enum : unsigned {
   1032   PF_X        = 1,         // Execute
   1033   PF_W        = 2,         // Write
   1034   PF_R        = 4,         // Read
   1035   PF_MASKOS   = 0x0ff00000,// Bits for operating system-specific semantics.
   1036   PF_MASKPROC = 0xf0000000 // Bits for processor-specific semantics.
   1037 };
   1038 
   1039 // Dynamic table entry for ELF32.
   1040 struct Elf32_Dyn
   1041 {
   1042   Elf32_Sword d_tag;            // Type of dynamic table entry.
   1043   union
   1044   {
   1045       Elf32_Word d_val;         // Integer value of entry.
   1046       Elf32_Addr d_ptr;         // Pointer value of entry.
   1047   } d_un;
   1048 };
   1049 
   1050 // Dynamic table entry for ELF64.
   1051 struct Elf64_Dyn
   1052 {
   1053   Elf64_Sxword d_tag;           // Type of dynamic table entry.
   1054   union
   1055   {
   1056       Elf64_Xword d_val;        // Integer value of entry.
   1057       Elf64_Addr  d_ptr;        // Pointer value of entry.
   1058   } d_un;
   1059 };
   1060 
   1061 // Dynamic table entry tags.
   1062 enum {
   1063   DT_NULL         = 0,        // Marks end of dynamic array.
   1064   DT_NEEDED       = 1,        // String table offset of needed library.
   1065   DT_PLTRELSZ     = 2,        // Size of relocation entries in PLT.
   1066   DT_PLTGOT       = 3,        // Address associated with linkage table.
   1067   DT_HASH         = 4,        // Address of symbolic hash table.
   1068   DT_STRTAB       = 5,        // Address of dynamic string table.
   1069   DT_SYMTAB       = 6,        // Address of dynamic symbol table.
   1070   DT_RELA         = 7,        // Address of relocation table (Rela entries).
   1071   DT_RELASZ       = 8,        // Size of Rela relocation table.
   1072   DT_RELAENT      = 9,        // Size of a Rela relocation entry.
   1073   DT_STRSZ        = 10,       // Total size of the string table.
   1074   DT_SYMENT       = 11,       // Size of a symbol table entry.
   1075   DT_INIT         = 12,       // Address of initialization function.
   1076   DT_FINI         = 13,       // Address of termination function.
   1077   DT_SONAME       = 14,       // String table offset of a shared objects name.
   1078   DT_RPATH        = 15,       // String table offset of library search path.
   1079   DT_SYMBOLIC     = 16,       // Changes symbol resolution algorithm.
   1080   DT_REL          = 17,       // Address of relocation table (Rel entries).
   1081   DT_RELSZ        = 18,       // Size of Rel relocation table.
   1082   DT_RELENT       = 19,       // Size of a Rel relocation entry.
   1083   DT_PLTREL       = 20,       // Type of relocation entry used for linking.
   1084   DT_DEBUG        = 21,       // Reserved for debugger.
   1085   DT_TEXTREL      = 22,       // Relocations exist for non-writable segments.
   1086   DT_JMPREL       = 23,       // Address of relocations associated with PLT.
   1087   DT_BIND_NOW     = 24,       // Process all relocations before execution.
   1088   DT_INIT_ARRAY   = 25,       // Pointer to array of initialization functions.
   1089   DT_FINI_ARRAY   = 26,       // Pointer to array of termination functions.
   1090   DT_INIT_ARRAYSZ = 27,       // Size of DT_INIT_ARRAY.
   1091   DT_FINI_ARRAYSZ = 28,       // Size of DT_FINI_ARRAY.
   1092   DT_RUNPATH      = 29,       // String table offset of lib search path.
   1093   DT_FLAGS        = 30,       // Flags.
   1094   DT_ENCODING     = 32,       // Values from here to DT_LOOS follow the rules
   1095                               // for the interpretation of the d_un union.
   1096 
   1097   DT_PREINIT_ARRAY = 32,      // Pointer to array of preinit functions.
   1098   DT_PREINIT_ARRAYSZ = 33,    // Size of the DT_PREINIT_ARRAY array.
   1099 
   1100   DT_LOOS         = 0x60000000, // Start of environment specific tags.
   1101   DT_HIOS         = 0x6FFFFFFF, // End of environment specific tags.
   1102   DT_LOPROC       = 0x70000000, // Start of processor specific tags.
   1103   DT_HIPROC       = 0x7FFFFFFF, // End of processor specific tags.
   1104 
   1105   DT_GNU_HASH     = 0x6FFFFEF5, // Reference to the GNU hash table.
   1106   DT_RELACOUNT    = 0x6FFFFFF9, // ELF32_Rela count.
   1107   DT_RELCOUNT     = 0x6FFFFFFA, // ELF32_Rel count.
   1108 
   1109   DT_FLAGS_1      = 0X6FFFFFFB, // Flags_1.
   1110   DT_VERSYM       = 0x6FFFFFF0, // The address of .gnu.version section.
   1111   DT_VERDEF       = 0X6FFFFFFC, // The address of the version definition table.
   1112   DT_VERDEFNUM    = 0X6FFFFFFD, // The number of entries in DT_VERDEF.
   1113   DT_VERNEED      = 0X6FFFFFFE, // The address of the version Dependency table.
   1114   DT_VERNEEDNUM   = 0X6FFFFFFF, // The number of entries in DT_VERNEED.
   1115 
   1116   // Mips specific dynamic table entry tags.
   1117   DT_MIPS_RLD_VERSION   = 0x70000001, // 32 bit version number for runtime
   1118                                       // linker interface.
   1119   DT_MIPS_TIME_STAMP    = 0x70000002, // Time stamp.
   1120   DT_MIPS_ICHECKSUM     = 0x70000003, // Checksum of external strings
   1121                                       // and common sizes.
   1122   DT_MIPS_IVERSION      = 0x70000004, // Index of version string
   1123                                       // in string table.
   1124   DT_MIPS_FLAGS         = 0x70000005, // 32 bits of flags.
   1125   DT_MIPS_BASE_ADDRESS  = 0x70000006, // Base address of the segment.
   1126   DT_MIPS_MSYM          = 0x70000007, // Address of .msym section.
   1127   DT_MIPS_CONFLICT      = 0x70000008, // Address of .conflict section.
   1128   DT_MIPS_LIBLIST       = 0x70000009, // Address of .liblist section.
   1129   DT_MIPS_LOCAL_GOTNO   = 0x7000000a, // Number of local global offset
   1130                                       // table entries.
   1131   DT_MIPS_CONFLICTNO    = 0x7000000b, // Number of entries
   1132                                       // in the .conflict section.
   1133   DT_MIPS_LIBLISTNO     = 0x70000010, // Number of entries
   1134                                       // in the .liblist section.
   1135   DT_MIPS_SYMTABNO      = 0x70000011, // Number of entries
   1136                                       // in the .dynsym section.
   1137   DT_MIPS_UNREFEXTNO    = 0x70000012, // Index of first external dynamic symbol
   1138                                       // not referenced locally.
   1139   DT_MIPS_GOTSYM        = 0x70000013, // Index of first dynamic symbol
   1140                                       // in global offset table.
   1141   DT_MIPS_HIPAGENO      = 0x70000014, // Number of page table entries
   1142                                       // in global offset table.
   1143   DT_MIPS_RLD_MAP       = 0x70000016, // Address of run time loader map,
   1144                                       // used for debugging.
   1145   DT_MIPS_DELTA_CLASS       = 0x70000017, // Delta C++ class definition.
   1146   DT_MIPS_DELTA_CLASS_NO    = 0x70000018, // Number of entries
   1147                                           // in DT_MIPS_DELTA_CLASS.
   1148   DT_MIPS_DELTA_INSTANCE    = 0x70000019, // Delta C++ class instances.
   1149   DT_MIPS_DELTA_INSTANCE_NO = 0x7000001A, // Number of entries
   1150                                           // in DT_MIPS_DELTA_INSTANCE.
   1151   DT_MIPS_DELTA_RELOC       = 0x7000001B, // Delta relocations.
   1152   DT_MIPS_DELTA_RELOC_NO    = 0x7000001C, // Number of entries
   1153                                           // in DT_MIPS_DELTA_RELOC.
   1154   DT_MIPS_DELTA_SYM         = 0x7000001D, // Delta symbols that Delta
   1155                                           // relocations refer to.
   1156   DT_MIPS_DELTA_SYM_NO      = 0x7000001E, // Number of entries
   1157                                           // in DT_MIPS_DELTA_SYM.
   1158   DT_MIPS_DELTA_CLASSSYM    = 0x70000020, // Delta symbols that hold
   1159                                           // class declarations.
   1160   DT_MIPS_DELTA_CLASSSYM_NO = 0x70000021, // Number of entries
   1161                                           // in DT_MIPS_DELTA_CLASSSYM.
   1162   DT_MIPS_CXX_FLAGS         = 0x70000022, // Flags indicating information
   1163                                           // about C++ flavor.
   1164   DT_MIPS_PIXIE_INIT        = 0x70000023, // Pixie information.
   1165   DT_MIPS_SYMBOL_LIB        = 0x70000024, // Address of .MIPS.symlib
   1166   DT_MIPS_LOCALPAGE_GOTIDX  = 0x70000025, // The GOT index of the first PTE
   1167                                           // for a segment
   1168   DT_MIPS_LOCAL_GOTIDX      = 0x70000026, // The GOT index of the first PTE
   1169                                           // for a local symbol
   1170   DT_MIPS_HIDDEN_GOTIDX     = 0x70000027, // The GOT index of the first PTE
   1171                                           // for a hidden symbol
   1172   DT_MIPS_PROTECTED_GOTIDX  = 0x70000028, // The GOT index of the first PTE
   1173                                           // for a protected symbol
   1174   DT_MIPS_OPTIONS           = 0x70000029, // Address of `.MIPS.options'.
   1175   DT_MIPS_INTERFACE         = 0x7000002A, // Address of `.interface'.
   1176   DT_MIPS_DYNSTR_ALIGN      = 0x7000002B, // Unknown.
   1177   DT_MIPS_INTERFACE_SIZE    = 0x7000002C, // Size of the .interface section.
   1178   DT_MIPS_RLD_TEXT_RESOLVE_ADDR = 0x7000002D, // Size of rld_text_resolve
   1179                                               // function stored in the GOT.
   1180   DT_MIPS_PERF_SUFFIX       = 0x7000002E, // Default suffix of DSO to be added
   1181                                           // by rld on dlopen() calls.
   1182   DT_MIPS_COMPACT_SIZE      = 0x7000002F, // Size of compact relocation
   1183                                           // section (O32).
   1184   DT_MIPS_GP_VALUE          = 0x70000030, // GP value for auxiliary GOTs.
   1185   DT_MIPS_AUX_DYNAMIC       = 0x70000031, // Address of auxiliary .dynamic.
   1186   DT_MIPS_PLTGOT            = 0x70000032, // Address of the base of the PLTGOT.
   1187   DT_MIPS_RWPLT             = 0x70000034, // Points to the base
   1188                                           // of a writable PLT.
   1189   DT_MIPS_RLD_MAP_REL       = 0x70000035  // Relative offset of run time loader
   1190                                           // map, used for debugging.
   1191 };
   1192 
   1193 // DT_FLAGS values.
   1194 enum {
   1195   DF_ORIGIN     = 0x01, // The object may reference $ORIGIN.
   1196   DF_SYMBOLIC   = 0x02, // Search the shared lib before searching the exe.
   1197   DF_TEXTREL    = 0x04, // Relocations may modify a non-writable segment.
   1198   DF_BIND_NOW   = 0x08, // Process all relocations on load.
   1199   DF_STATIC_TLS = 0x10  // Reject attempts to load dynamically.
   1200 };
   1201 
   1202 // State flags selectable in the `d_un.d_val' element of the DT_FLAGS_1 entry.
   1203 enum {
   1204   DF_1_NOW        = 0x00000001, // Set RTLD_NOW for this object.
   1205   DF_1_GLOBAL     = 0x00000002, // Set RTLD_GLOBAL for this object.
   1206   DF_1_GROUP      = 0x00000004, // Set RTLD_GROUP for this object.
   1207   DF_1_NODELETE   = 0x00000008, // Set RTLD_NODELETE for this object.
   1208   DF_1_LOADFLTR   = 0x00000010, // Trigger filtee loading at runtime.
   1209   DF_1_INITFIRST  = 0x00000020, // Set RTLD_INITFIRST for this object.
   1210   DF_1_NOOPEN     = 0x00000040, // Set RTLD_NOOPEN for this object.
   1211   DF_1_ORIGIN     = 0x00000080, // $ORIGIN must be handled.
   1212   DF_1_DIRECT     = 0x00000100, // Direct binding enabled.
   1213   DF_1_TRANS      = 0x00000200,
   1214   DF_1_INTERPOSE  = 0x00000400, // Object is used to interpose.
   1215   DF_1_NODEFLIB   = 0x00000800, // Ignore default lib search path.
   1216   DF_1_NODUMP     = 0x00001000, // Object can't be dldump'ed.
   1217   DF_1_CONFALT    = 0x00002000, // Configuration alternative created.
   1218   DF_1_ENDFILTEE  = 0x00004000, // Filtee terminates filters search.
   1219   DF_1_DISPRELDNE = 0x00008000, // Disp reloc applied at build time.
   1220   DF_1_DISPRELPND = 0x00010000, // Disp reloc applied at run-time.
   1221   DF_1_NODIRECT   = 0x00020000, // Object has no-direct binding.
   1222   DF_1_IGNMULDEF  = 0x00040000,
   1223   DF_1_NOKSYMS    = 0x00080000,
   1224   DF_1_NOHDR      = 0x00100000,
   1225   DF_1_EDITED     = 0x00200000, // Object is modified after built.
   1226   DF_1_NORELOC    = 0x00400000,
   1227   DF_1_SYMINTPOSE = 0x00800000, // Object has individual interposers.
   1228   DF_1_GLOBAUDIT  = 0x01000000, // Global auditing required.
   1229   DF_1_SINGLETON  = 0x02000000  // Singleton symbols are used.
   1230 };
   1231 
   1232 // DT_MIPS_FLAGS values.
   1233 enum {
   1234   RHF_NONE                    = 0x00000000, // No flags.
   1235   RHF_QUICKSTART              = 0x00000001, // Uses shortcut pointers.
   1236   RHF_NOTPOT                  = 0x00000002, // Hash size is not a power of two.
   1237   RHS_NO_LIBRARY_REPLACEMENT  = 0x00000004, // Ignore LD_LIBRARY_PATH.
   1238   RHF_NO_MOVE                 = 0x00000008, // DSO address may not be relocated.
   1239   RHF_SGI_ONLY                = 0x00000010, // SGI specific features.
   1240   RHF_GUARANTEE_INIT          = 0x00000020, // Guarantee that .init will finish
   1241                                             // executing before any non-init
   1242                                             // code in DSO is called.
   1243   RHF_DELTA_C_PLUS_PLUS       = 0x00000040, // Contains Delta C++ code.
   1244   RHF_GUARANTEE_START_INIT    = 0x00000080, // Guarantee that .init will start
   1245                                             // executing before any non-init
   1246                                             // code in DSO is called.
   1247   RHF_PIXIE                   = 0x00000100, // Generated by pixie.
   1248   RHF_DEFAULT_DELAY_LOAD      = 0x00000200, // Delay-load DSO by default.
   1249   RHF_REQUICKSTART            = 0x00000400, // Object may be requickstarted
   1250   RHF_REQUICKSTARTED          = 0x00000800, // Object has been requickstarted
   1251   RHF_CORD                    = 0x00001000, // Generated by cord.
   1252   RHF_NO_UNRES_UNDEF          = 0x00002000, // Object contains no unresolved
   1253                                             // undef symbols.
   1254   RHF_RLD_ORDER_SAFE          = 0x00004000  // Symbol table is in a safe order.
   1255 };
   1256 
   1257 // ElfXX_VerDef structure version (GNU versioning)
   1258 enum {
   1259   VER_DEF_NONE    = 0,
   1260   VER_DEF_CURRENT = 1
   1261 };
   1262 
   1263 // VerDef Flags (ElfXX_VerDef::vd_flags)
   1264 enum {
   1265   VER_FLG_BASE = 0x1,
   1266   VER_FLG_WEAK = 0x2,
   1267   VER_FLG_INFO = 0x4
   1268 };
   1269 
   1270 // Special constants for the version table. (SHT_GNU_versym/.gnu.version)
   1271 enum {
   1272   VER_NDX_LOCAL  = 0,      // Unversioned local symbol
   1273   VER_NDX_GLOBAL = 1,      // Unversioned global symbol
   1274   VERSYM_VERSION = 0x7fff, // Version Index mask
   1275   VERSYM_HIDDEN  = 0x8000  // Hidden bit (non-default version)
   1276 };
   1277 
   1278 // ElfXX_VerNeed structure version (GNU versioning)
   1279 enum {
   1280   VER_NEED_NONE = 0,
   1281   VER_NEED_CURRENT = 1
   1282 };
   1283 
   1284 } // end namespace ELF
   1285 
   1286 } // end namespace llvm
   1287 
   1288 #endif
   1289