elftools 1.3.0 → 2.0.0

data/lib/elftools/constants/relocation.rb

@@ -0,0 +1,181 @@
+# frozen_string_literal: true
+
+require 'elftools/constants/machine'
+
+# This file is generated by `bundle exec rake gen:constants`, do not edit it.
+# Source: https://sourceware.org/cgit/binutils-gdb/tree/include/elf
+
+module ELFTools
+  module Constants
+    # Relocation types, recorded in the +r_info+ of a relocation.
+    #
+    # Every architecture numbers them on its own, so they are grouped by
+    # architecture and only loaded once one of the groups is asked for.
+    module R
+      autoload :AARCH64,    'elftools/constants/relocation/aarch64'
+      autoload :ALPHA,      'elftools/constants/relocation/alpha'
+      autoload :AMDGPU,     'elftools/constants/relocation/amdgpu'
+      autoload :ARM,        'elftools/constants/relocation/arm'
+      autoload :AVR,        'elftools/constants/relocation/avr'
+      autoload :BFIN,       'elftools/constants/relocation/bfin'
+      autoload :BPF,        'elftools/constants/relocation/bpf'
+      autoload :CR16,       'elftools/constants/relocation/cr16'
+      autoload :CRIS,       'elftools/constants/relocation/cris'
+      autoload :CRX,        'elftools/constants/relocation/crx'
+      autoload :CSKY,       'elftools/constants/relocation/csky'
+      autoload :D10V,       'elftools/constants/relocation/d10v'
+      autoload :D30V,       'elftools/constants/relocation/d30v'
+      autoload :DLX,        'elftools/constants/relocation/dlx'
+      autoload :EPIPHANY,   'elftools/constants/relocation/epiphany'
+      autoload :FR30,       'elftools/constants/relocation/fr30'
+      autoload :FRV,        'elftools/constants/relocation/frv'
+      autoload :FT32,       'elftools/constants/relocation/ft32'
+      autoload :H8,         'elftools/constants/relocation/h8'
+      autoload :HPPA,       'elftools/constants/relocation/hppa'
+      autoload :I370,       'elftools/constants/relocation/i370'
+      autoload :I386,       'elftools/constants/relocation/i386'
+      autoload :I860,       'elftools/constants/relocation/i860'
+      autoload :I960,       'elftools/constants/relocation/i960'
+      autoload :IA64,       'elftools/constants/relocation/ia64'
+      autoload :IP2K,       'elftools/constants/relocation/ip2k'
+      autoload :IQ2000,     'elftools/constants/relocation/iq2000'
+      autoload :KVX,        'elftools/constants/relocation/kvx'
+      autoload :LM32,       'elftools/constants/relocation/lm32'
+      autoload :LOONGARCH,  'elftools/constants/relocation/loongarch'
+      autoload :M32C,       'elftools/constants/relocation/m32c'
+      autoload :M32R,       'elftools/constants/relocation/m32r'
+      autoload :M68HC11,    'elftools/constants/relocation/m68hc11'
+      autoload :M68K,       'elftools/constants/relocation/m68k'
+      autoload :MCORE,      'elftools/constants/relocation/mcore'
+      autoload :MEP,        'elftools/constants/relocation/mep'
+      autoload :METAG,      'elftools/constants/relocation/metag'
+      autoload :MICROBLAZE, 'elftools/constants/relocation/microblaze'
+      autoload :MIPS,       'elftools/constants/relocation/mips'
+      autoload :MMIX,       'elftools/constants/relocation/mmix'
+      autoload :MN10200,    'elftools/constants/relocation/mn10200'
+      autoload :MN10300,    'elftools/constants/relocation/mn10300'
+      autoload :MOXIE,      'elftools/constants/relocation/moxie'
+      autoload :MSP430,     'elftools/constants/relocation/msp430'
+      autoload :MSP430X,    'elftools/constants/relocation/msp430x'
+      autoload :MT,         'elftools/constants/relocation/mt'
+      autoload :NDS32,      'elftools/constants/relocation/nds32'
+      autoload :NFP,        'elftools/constants/relocation/nfp'
+      autoload :NFP3200,    'elftools/constants/relocation/nfp3200'
+      autoload :NIOS2,      'elftools/constants/relocation/nios2'
+      autoload :OR1K,       'elftools/constants/relocation/or1k'
+      autoload :PJ,         'elftools/constants/relocation/pj'
+      autoload :PPC,        'elftools/constants/relocation/ppc'
+      autoload :PPC64,      'elftools/constants/relocation/ppc64'
+      autoload :PRU,        'elftools/constants/relocation/pru'
+      autoload :RISCV,      'elftools/constants/relocation/riscv'
+      autoload :RL78,       'elftools/constants/relocation/rl78'
+      autoload :RX,         'elftools/constants/relocation/rx'
+      autoload :S12Z,       'elftools/constants/relocation/s12z'
+      autoload :S390,       'elftools/constants/relocation/s390'
+      autoload :SCORE,      'elftools/constants/relocation/score'
+      autoload :SH,         'elftools/constants/relocation/sh'
+      autoload :SPARC,      'elftools/constants/relocation/sparc'
+      autoload :SPU,        'elftools/constants/relocation/spu'
+      autoload :TIC6X,      'elftools/constants/relocation/tic6x'
+      autoload :TILEGX,     'elftools/constants/relocation/tilegx'
+      autoload :TILEPRO,    'elftools/constants/relocation/tilepro'
+      autoload :V800,       'elftools/constants/relocation/v800'
+      autoload :V850,       'elftools/constants/relocation/v850'
+      autoload :VAX,        'elftools/constants/relocation/vax'
+      autoload :VISIUM,     'elftools/constants/relocation/visium'
+      autoload :WASM32,     'elftools/constants/relocation/wasm32'
+      autoload :X86_64,     'elftools/constants/relocation/x86_64'
+      autoload :XGATE,      'elftools/constants/relocation/xgate'
+      autoload :XSTORMY16,  'elftools/constants/relocation/xstormy16'
+      autoload :XTENSA,     'elftools/constants/relocation/xtensa'
+      autoload :Z80,        'elftools/constants/relocation/z80'
+
+      # The architecture that relocates each machine.
+      # @return [Hash{Integer => Symbol}]
+      MACHINES = {
+        EM::EM_386 => :I386,
+        EM::EM_68HC11 => :M68HC11,
+        EM::EM_68HC12 => :M68HC11,
+        EM::EM_68K => :M68K,
+        EM::EM_860 => :I860,
+        EM::EM_960 => :I960,
+        EM::EM_AARCH64 => :AARCH64,
+        EM::EM_ADAPTEVA_EPIPHANY => :EPIPHANY,
+        EM::EM_ALPHA => :ALPHA,
+        EM::EM_ALTERA_NIOS2 => :NIOS2,
+        EM::EM_AMDGPU => :AMDGPU,
+        EM::EM_ARM => :ARM,
+        EM::EM_AVR => :AVR,
+        EM::EM_BLACKFIN => :BFIN,
+        EM::EM_BPF => :BPF,
+        EM::EM_CR16 => :CR16,
+        EM::EM_CRIS => :CRIS,
+        EM::EM_CRX => :CRX,
+        EM::EM_CSKY => :CSKY,
+        EM::EM_CYGNUS_FRV => :FRV,
+        EM::EM_CYGNUS_MEP => :MEP,
+        EM::EM_D10V => :D10V,
+        EM::EM_D30V => :D30V,
+        EM::EM_DLX => :DLX,
+        EM::EM_FR30 => :FR30,
+        EM::EM_FT32 => :FT32,
+        EM::EM_H8S => :H8,
+        EM::EM_H8_300 => :H8,
+        EM::EM_H8_300H => :H8,
+        EM::EM_IAMCU => :I386,
+        EM::EM_IA_64 => :IA64,
+        EM::EM_IP2K => :IP2K,
+        EM::EM_IQ2000 => :IQ2000,
+        EM::EM_KVX => :KVX,
+        EM::EM_LATTICEMICO32 => :LM32,
+        EM::EM_LOONGARCH => :LOONGARCH,
+        EM::EM_M32C => :M32C,
+        EM::EM_M32R => :M32R,
+        EM::EM_MCORE => :MCORE,
+        EM::EM_METAG => :METAG,
+        EM::EM_MICROBLAZE => :MICROBLAZE,
+        EM::EM_MIPS => :MIPS,
+        EM::EM_MMIX => :MMIX,
+        EM::EM_MN10200 => :MN10200,
+        EM::EM_MN10300 => :MN10300,
+        EM::EM_MOXIE => :MOXIE,
+        EM::EM_MSP430 => :MSP430,
+        EM::EM_MT => :MT,
+        EM::EM_NDS32 => :NDS32,
+        EM::EM_NFP => :NFP,
+        EM::EM_OR1K => :OR1K,
+        EM::EM_PARISC => :HPPA,
+        EM::EM_PJ => :PJ,
+        EM::EM_PPC => :PPC,
+        EM::EM_PPC64 => :PPC64,
+        EM::EM_RISCV => :RISCV,
+        EM::EM_RL78 => :RL78,
+        EM::EM_RX => :RX,
+        EM::EM_S12Z => :S12Z,
+        EM::EM_S370 => :I370,
+        EM::EM_S390 => :S390,
+        EM::EM_S390_OLD => :S390,
+        EM::EM_SCORE => :SCORE,
+        EM::EM_SH => :SH,
+        EM::EM_SPARC => :SPARC,
+        EM::EM_SPARC32PLUS => :SPARC,
+        EM::EM_SPARCV9 => :SPARC,
+        EM::EM_SPU => :SPU,
+        EM::EM_TILEGX => :TILEGX,
+        EM::EM_TILEPRO => :TILEPRO,
+        EM::EM_TI_C6000 => :TIC6X,
+        EM::EM_TI_PRU => :PRU,
+        EM::EM_V800 => :V800,
+        EM::EM_V850 => :V850,
+        EM::EM_VAX => :VAX,
+        EM::EM_VISIUM => :VISIUM,
+        EM::EM_WEBASSEMBLY => :WASM32,
+        EM::EM_X86_64 => :X86_64,
+        EM::EM_XGATE => :XGATE,
+        EM::EM_XSTORMY16 => :XSTORMY16,
+        EM::EM_XTENSA => :XTENSA,
+        EM::EM_Z80 => :Z80
+      }.freeze
+    end
+  end
+end

data/lib/elftools/constants.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'elftools/constants/machine'
+require 'elftools/constants/relocation'
+
 module ELFTools
   # Define constants from elf.h.
   # Mostly refer from https://github.com/torvalds/linux/blob/master/include/uapi/linux/elf.h
@@ -8,6 +11,70 @@ module ELFTools
     # ELF magic header
     ELFMAG = "\x7FELF"
 
+    # Names a value after the constants that define it, for the modules where
+    # several of them may define one value.
+    #
+    # A machine defines names of its own, and a name may mark where a range of
+    # values begins or ends, or how many of them are defined, rather than name
+    # one of them.
+    module Naming
+      # Architectures a constant can be named after, the longest first so that
+      # a name is read as the architecture it spells out in full.
+      ARCHITECTURES = (R.constants - [:MACHINES]).sort_by { |name| -name.length }.freeze
+
+      # Return the name of +value+.
+      #
+      # Names of a machine other than +machine+ are passed over, as are the
+      # ones that mark a range or a count instead of naming a value.
+      # @param [Integer?] machine Value of +e_machine+.
+      # @param [Integer] value The value to name.
+      # @return [String] The name.
+      # @example
+      #   Constants::STT.mapping(Constants::EM_ARM, 13)
+      #   #=> 'STT_ARM_TFUNC'
+      #   Constants::STT.mapping(Constants::EM_X86_64, 13)
+      #   #=> '<unknown>: 0xd'
+      def mapping(machine, value)
+        architecture = R::MACHINES[machine]
+        name = names_by_value.fetch(value, []).find do |constant|
+          !marker?(constant) && [nil, architecture].include?(architecture_of(constant))
+        end
+        name ? name.to_s : format('<unknown>: 0x%x', value)
+      end
+
+      private
+
+      # The constants defining each value, in the order they are defined.
+      # @return [Hash{Integer => Array<Symbol>}] The constants.
+      def names_by_value
+        @names_by_value ||= constants.group_by { |constant| const_get(constant) }
+      end
+
+      # The architecture a constant is named after.
+      # @example
+      #   architecture_of(:SHN_MIPS_ACOMMON)
+      #   #=> :MIPS
+      #   architecture_of(:SHN_ABS)
+      #   #=> nil
+      # @return [Symbol?] The architecture, +nil+ if the name spells out none.
+      def architecture_of(constant)
+        rest = constant.to_s.sub(/\A#{name.split('::').last}_/, '')
+        ARCHITECTURES.find { |architecture| rest.start_with?("#{architecture}_") }
+      end
+
+      # Whether a constant marks where a range of values begins or ends, or
+      # how many of them are defined, rather than naming one of them.
+      # @example
+      #   marker?(:STT_LOPROC)
+      #   #=> true
+      #   marker?(:STT_FUNC)
+      #   #=> false
+      # @return [Boolean] The answer.
+      def marker?(constant)
+        constant.to_s.match?(/_((LO|HI)(OS|PROC|RESERVE)|NUM)\z/)
+      end
+    end
+
     # Values of `d_un.d_val' in the DT_FLAGS and DT_FLAGS_1 entry.
     module DF
       DF_ORIGIN       = 0x00000001 # Object may use DF_ORIGIN
@@ -52,6 +119,8 @@ module ELFTools
 
     # Dynamic table types, records in +d_tag+.
     module DT
+      extend Naming
+
       DT_NULL                       = 0 # marks the end of the _DYNAMIC array
       DT_NEEDED                     = 1 # libraries need to be linked by loader
       DT_PLTRELSZ                   = 2 # total size of relocation entries
@@ -193,255 +262,62 @@ module ELFTools
     include DT
 
     # These constants define the various ELF target machines.
+    #
+    # Constants are defined in +elftools/constants/machine+.
     module EM
-      EM_NONE            = 0      # none
-      EM_M32             = 1      # AT&T WE 32100
-      EM_SPARC           = 2      # SPARC
-      EM_386             = 3      # Intel 80386
-      EM_68K             = 4      # Motorola 68000
-      EM_88K             = 5      # Motorola 88000
-      EM_486             = 6      # Intel 80486
-      EM_860             = 7      # Intel 80860
-      EM_MIPS            = 8      # MIPS R3000 (officially, big-endian only)
-      EM_S370            = 9      # IBM System/370
-
-      # Next two are historical and binaries and
-      # modules of these types will be rejected by Linux.
-      EM_MIPS_RS3_LE     = 10     # MIPS R3000 little-endian
-      EM_MIPS_RS4_BE     = 10     # MIPS R4000 big-endian
-
-      EM_PARISC          = 15     # HPPA
-      EM_VPP500          = 17     # Fujitsu VPP500 (also some older versions of PowerPC)
-      EM_SPARC32PLUS     = 18     # Sun's "v8plus"
-      EM_960             = 19     # Intel 80960
-      EM_PPC             = 20     # PowerPC
-      EM_PPC64           = 21     # PowerPC64
-      EM_S390            = 22     # IBM S/390
-      EM_SPU             = 23     # Cell BE SPU
-      EM_V800            = 36     # NEC V800 series
-      EM_FR20            = 37     # Fujitsu FR20
-      EM_RH32            = 38     # TRW RH32
-      EM_RCE             = 39     # Motorola M*Core
-      EM_ARM             = 40     # ARM 32 bit
-      EM_SH              = 42     # SuperH
-      EM_SPARCV9         = 43     # SPARC v9 64-bit
-      EM_TRICORE         = 44     # Siemens Tricore embedded processor
-      EM_ARC             = 45     # ARC Cores
-      EM_H8_300          = 46     # Renesas H8/300
-      EM_H8_300H         = 47     # Renesas H8/300H
-      EM_H8S             = 48     # Renesas H8S
-      EM_H8_500          = 49     # Renesas H8/500H
-      EM_IA_64           = 50     # HP/Intel IA-64
-      EM_MIPS_X          = 51     # Stanford MIPS-X
-      EM_COLDFIRE        = 52     # Motorola Coldfire
-      EM_68HC12          = 53     # Motorola M68HC12
-      EM_MMA             = 54     # Fujitsu Multimedia Accelerator
-      EM_PCP             = 55     # Siemens PCP
-      EM_NCPU            = 56     # Sony nCPU embedded RISC processor
-      EM_NDR1            = 57     # Denso NDR1 microprocessor
-      EM_STARCORE        = 58     # Motorola Star*Core processor
-      EM_ME16            = 59     # Toyota ME16 processor
-      EM_ST100           = 60     # STMicroelectronics ST100 processor
-      EM_TINYJ           = 61     # Advanced Logic Corp. TinyJ embedded processor
-      EM_X86_64          = 62     # AMD x86-64
-      EM_PDSP            = 63     # Sony DSP Processor
-      EM_PDP10           = 64     # Digital Equipment Corp. PDP-10
-      EM_PDP11           = 65     # Digital Equipment Corp. PDP-11
-      EM_FX66            = 66     # Siemens FX66 microcontroller
-      EM_ST9PLUS         = 67     # STMicroelectronics ST9+ 8/16 bit microcontroller
-      EM_ST7             = 68     # STMicroelectronics ST7 8-bit microcontroller
-      EM_68HC16          = 69     # Motorola MC68HC16 Microcontroller
-      EM_68HC11          = 70     # Motorola MC68HC11 Microcontroller
-      EM_68HC08          = 71     # Motorola MC68HC08 Microcontroller
-      EM_68HC05          = 72     # Motorola MC68HC05 Microcontroller
-      EM_SVX             = 73     # Silicon Graphics SVx
-      EM_ST19            = 74     # STMicroelectronics ST19 8-bit cpu
-      EM_VAX             = 75     # Digital VAX
-      EM_CRIS            = 76     # Axis Communications 32-bit embedded processor
-      EM_JAVELIN         = 77     # Infineon Technologies 32-bit embedded cpu
-      EM_FIREPATH        = 78     # Element 14 64-bit DSP processor
-      EM_ZSP             = 79     # LSI Logic's 16-bit DSP processor
-      EM_MMIX            = 80     # Donald Knuth's educational 64-bit processor
-      EM_HUANY           = 81     # Harvard's machine-independent format
-      EM_PRISM           = 82     # SiTera Prism
-      EM_AVR             = 83     # Atmel AVR 8-bit microcontroller
-      EM_FR30            = 84     # Fujitsu FR30
-      EM_D10V            = 85     # Mitsubishi D10V
-      EM_D30V            = 86     # Mitsubishi D30V
-      EM_V850            = 87     # Renesas V850
-      EM_M32R            = 88     # Renesas M32R
-      EM_MN10300         = 89     # Matsushita MN10300
-      EM_MN10200         = 90     # Matsushita MN10200
-      EM_PJ              = 91     # picoJava
-      EM_OPENRISC        = 92     # OpenRISC 32-bit embedded processor
-      EM_ARC_COMPACT     = 93     # ARC International ARCompact processor
-      EM_XTENSA          = 94     # Tensilica Xtensa Architecture
-      EM_VIDEOCORE       = 95     # Alphamosaic VideoCore processor
-      EM_TMM_GPP         = 96     # Thompson Multimedia General Purpose Processor
-      EM_NS32K           = 97     # National Semiconductor 32000 series
-      EM_TPC             = 98     # Tenor Network TPC processor
-      EM_SNP1K           = 99     # Trebia SNP 1000 processor
-      EM_ST200           = 100    # STMicroelectronics ST200 microcontroller
-      EM_IP2K            = 101    # Ubicom IP2022 micro controller
-      EM_MAX             = 102    # MAX Processor
-      EM_CR              = 103    # National Semiconductor CompactRISC
-      EM_F2MC16          = 104    # Fujitsu F2MC16
-      EM_MSP430          = 105    # TI msp430 micro controller
-      EM_BLACKFIN        = 106    # ADI Blackfin Processor
-      EM_SE_C33          = 107    # S1C33 Family of Seiko Epson processors
-      EM_SEP             = 108    # Sharp embedded microprocessor
-      EM_ARCA            = 109    # Arca RISC Microprocessor
-      EM_UNICORE         = 110    # Microprocessor series from PKU-Unity Ltd. and MPRC of Peking University
-      EM_EXCESS          = 111    # eXcess: 16/32/64-bit configurable embedded CPU
-      EM_DXP             = 112    # Icera Semiconductor Inc. Deep Execution Processor
-      EM_ALTERA_NIOS2    = 113    # Altera Nios II soft-core processor
-      EM_CRX             = 114    # National Semiconductor CRX
-      EM_XGATE           = 115    # Motorola XGATE embedded processor
-      EM_C116            = 116    # Infineon C16x/XC16x processor
-      EM_M16C            = 117    # Renesas M16C series microprocessors
-      EM_DSPIC30F        = 118    # Microchip Technology dsPIC30F Digital Signal Controller
-      EM_CE              = 119    # Freescale Communication Engine RISC core
-      EM_M32C            = 120    # Freescale Communication Engine RISC core
-      EM_TSK3000         = 131    # Altium TSK3000 core
-      EM_RS08            = 132    # Freescale RS08 embedded processor
-      EM_SHARC           = 133    # Analog Devices SHARC family of 32-bit DSP processors
-      EM_ECOG2           = 134    # Cyan Technology eCOG2 microprocessor
-      EM_SCORE7          = 135    # Sunplus S+core7 RISC processor
-      EM_DSP24           = 136    # New Japan Radio (NJR) 24-bit DSP Processor
-      EM_VIDEOCORE3      = 137    # Broadcom VideoCore III processor
-      EM_LATTICEMICO32   = 138    # RISC processor for Lattice FPGA architecture
-      EM_SE_C17          = 139    # Seiko Epson C17 family
-      EM_TI_C6000        = 140    # The Texas Instruments TMS320C6000 DSP family
-      EM_TI_C2000        = 141    # The Texas Instruments TMS320C2000 DSP family
-      EM_TI_C5500        = 142    # The Texas Instruments TMS320C55x DSP family
-      EM_TI_ARP32        = 143    # Texas Instruments Application Specific RISC Processor, 32bit fetch
-      EM_TI_PRU          = 144    # Texas Instruments Programmable Realtime Unit
-      EM_MMDSP_PLUS      = 160    # STMicroelectronics 64bit VLIW Data Signal Processor
-      EM_CYPRESS_M8C     = 161    # Cypress M8C microprocessor
-      EM_R32C            = 162    # Renesas R32C series microprocessors
-      EM_TRIMEDIA        = 163    # NXP Semiconductors TriMedia architecture family
-      EM_QDSP6           = 164    # QUALCOMM DSP6 Processor
-      EM_8051            = 165    # Intel 8051 and variants
-      EM_STXP7X          = 166    # STMicroelectronics STxP7x family
-      EM_NDS32           = 167    # Andes Technology compact code size embedded RISC processor family
-      EM_ECOG1           = 168    # Cyan Technology eCOG1X family
-      EM_ECOG1X          = 168    # Cyan Technology eCOG1X family
-      EM_MAXQ30          = 169    # Dallas Semiconductor MAXQ30 Core Micro-controllers
-      EM_XIMO16          = 170    # New Japan Radio (NJR) 16-bit DSP Processor
-      EM_MANIK           = 171    # M2000 Reconfigurable RISC Microprocessor
-      EM_CRAYNV2         = 172    # Cray Inc. NV2 vector architecture
-      EM_RX              = 173    # Renesas RX family
-      EM_METAG           = 174    # Imagination Technologies Meta processor architecture
-      EM_MCST_ELBRUS     = 175    # MCST Elbrus general purpose hardware architecture
-      EM_ECOG16          = 176    # Cyan Technology eCOG16 family
-      EM_CR16            = 177    # National Semiconductor CompactRISC 16-bit processor
-      EM_ETPU            = 178    # Freescale Extended Time Processing Unit
-      EM_SLE9X           = 179    # Infineon Technologies SLE9X core
-      EM_L1OM            = 180    # Intel L1OM
-      EM_K1OM            = 181    # Intel K1OM
-      EM_AARCH64         = 183    # ARM 64 bit
-      EM_AVR32           = 185    # Atmel Corporation 32-bit microprocessor family
-      EM_STM8            = 186    # STMicroeletronics STM8 8-bit microcontroller
-      EM_TILE64          = 187    # Tilera TILE64 multicore architecture family
-      EM_TILEPRO         = 188    # Tilera TILEPro
-      EM_MICROBLAZE      = 189    # Xilinx MicroBlaze
-      EM_CUDA            = 190    # NVIDIA CUDA architecture
-      EM_TILEGX          = 191    # Tilera TILE-Gx
-      EM_CLOUDSHIELD     = 192    # CloudShield architecture family
-      EM_COREA_1ST       = 193    # KIPO-KAIST Core-A 1st generation processor family
-      EM_COREA_2ND       = 194    # KIPO-KAIST Core-A 2nd generation processor family
-      EM_ARC_COMPACT2    = 195    # Synopsys ARCompact V2
-      EM_OPEN8           = 196    # Open8 8-bit RISC soft processor core
-      EM_RL78            = 197    # Renesas RL78 family
-      EM_VIDEOCORE5      = 198    # Broadcom VideoCore V processor
-      EM_78K0R           = 199    # Renesas 78K0R
-      EM_56800EX         = 200    # Freescale 56800EX Digital Signal Controller (DSC)
-      EM_BA1             = 201    # Beyond BA1 CPU architecture
-      EM_BA2             = 202    # Beyond BA2 CPU architecture
-      EM_XCORE           = 203    # XMOS xCORE processor family
-      EM_MCHP_PIC        = 204    # Microchip 8-bit PIC(r) family
-      EM_INTELGT         = 205    # Intel Graphics Technology
-      EM_KM32            = 210    # KM211 KM32 32-bit processor
-      EM_KMX32           = 211    # KM211 KMX32 32-bit processor
-      EM_KMX16           = 212    # KM211 KMX16 16-bit processor
-      EM_KMX8            = 213    # KM211 KMX8 8-bit processor
-      EM_KVARC           = 214    # KM211 KVARC processor
-      EM_CDP             = 215    # Paneve CDP architecture family
-      EM_COGE            = 216    # Cognitive Smart Memory Processor
-      EM_COOL            = 217    # Bluechip Systems CoolEngine
-      EM_NORC            = 218    # Nanoradio Optimized RISC
-      EM_CSR_KALIMBA     = 219    # CSR Kalimba architecture family
-      EM_Z80             = 220    # Zilog Z80
-      EM_VISIUM          = 221    # Controls and Data Services VISIUMcore processor
-      EM_FT32            = 222    # FTDI Chip FT32 high performance 32-bit RISC architecture
-      EM_MOXIE           = 223    # Moxie processor family
-      EM_AMDGPU          = 224    # AMD GPU architecture
-      EM_LANAI           = 244    # Lanai 32-bit processor
-      EM_CEVA            = 245    # CEVA Processor Architecture Family
-      EM_CEVA_X2         = 246    # CEVA X2 Processor Family
-      EM_BPF             = 247    # Linux BPF - in-kernel virtual machine
-      EM_GRAPHCORE_IPU   = 248    # Graphcore Intelligent Processing Unit
-      EM_IMG1            = 249    # Imagination Technologies
-      EM_NFP             = 250    # Netronome Flow Processor (NFP)
-      EM_VE              = 251    # NEC Vector Engine
-      EM_CSKY            = 252    # C-SKY processor family
-      EM_ARC_COMPACT3_64 = 253    # Synopsys ARCv2.3 64-bit
-      EM_MCS6502         = 254    # MOS Technology MCS 6502 processor
-      EM_ARC_COMPACT3    = 255    # Synopsys ARCv2.3 32-bit
-      EM_KVX             = 256    # Kalray VLIW core of the MPPA processor family
-      EM_65816           = 257    # WDC 65816/65C816
-      EM_LOONGARCH       = 258    # LoongArch
-      EM_KF32            = 259    # ChipON KungFu32
-      EM_U16_U8CORE      = 260    # LAPIS nX-U16/U8
-      EM_TACHYUM         = 261    # Tachyum
-      EM_56800EF         = 262    # NXP 56800EF Digital Signal Controller (DSC)
-
-      EM_FRV             = 0x5441 # Fujitsu FR-V
-
-      # This is an interim value that we will use until the committee comes up with a final number.
-      EM_ALPHA           = 0x9026
-
-      # Bogus old m32r magic number, used by old tools.
-      EM_CYGNUS_M32R     = 0x9041
-      # This is the old interim value for S/390 architecture
-      EM_S390_OLD        = 0xA390
-      # Also Panasonic/MEI MN10300, AM33
-      EM_CYGNUS_MN10300  = 0xbeef
+      # Names are only loaded when a name is asked for.
+      autoload :NAMES, 'elftools/constants/machine_names'
 
       # Return the architecture name according to +val+.
       # Used by {ELFTools::ELFFile#machine}.
-      #
-      # Only supports famous archs.
       # @param [Integer] val Value of +e_machine+.
       # @return [String]
       #   Name of architecture.
       # @example
       #   mapping(3)
       #   #=> 'Intel 80386'
-      #   mapping(6)
-      #   #=> 'Intel 80386'
       #   mapping(62)
-      #   #=> 'Advanced Micro Devices X86-64'
+      #   #=> 'Advanced Micro Devices X86-64 processor'
+      #   mapping(243)
+      #   #=> 'RISC-V'
       #   mapping(1337)
       #   #=> '<unknown>: 0x539'
       def self.mapping(val)
-        case val
-        when EM_NONE then 'None'
-        when EM_386, EM_486 then 'Intel 80386'
-        when EM_860 then 'Intel 80860'
-        when EM_MIPS then 'MIPS R3000'
-        when EM_PPC then 'PowerPC'
-        when EM_PPC64 then 'PowerPC64'
-        when EM_ARM then 'ARM'
-        when EM_IA_64 then 'Intel IA-64'
-        when EM_AARCH64 then 'AArch64'
-        when EM_X86_64 then 'Advanced Micro Devices X86-64'
-        else format('<unknown>: 0x%x', val)
-        end
+        NAMES.fetch(val) { format('<unknown>: 0x%x', val) }
       end
     end
     include EM
 
+    # Relocation types, see +elftools/constants/relocation+ for the constants.
+    module R
+      # Return the name of a relocation type.
+      #
+      # A type only means something together with the machine that recorded it,
+      # both of them are needed to name it.
+      # @param [Integer?] machine Value of +e_machine+.
+      # @param [Integer] type The relocation type.
+      # @return [String] Name of the relocation type.
+      # @example
+      #   mapping(Constants::EM_X86_64, 7)
+      #   #=> 'R_X86_64_JUMP_SLOT'
+      #   mapping(Constants::EM_ARM, 7)
+      #   #=> 'R_ARM_THM_ABS5'
+      #   mapping(Constants::EM_X86_64, 1337)
+      #   #=> '<unknown>: 0x539'
+      def self.mapping(machine, type)
+        architecture = MACHINES[machine]
+        names = architecture && names_of(const_get(architecture))
+        names&.fetch(type, nil) || format('<unknown>: 0x%x', type)
+      end
+
+      # Names of every relocation type an architecture defines.
+      # @return [Hash{Integer => String}]
+      def self.names_of(architecture)
+        @names_of ||= {}
+        @names_of[architecture] ||= architecture.constants.to_h { |name| [architecture.const_get(name), name.to_s] }
+      end
+    end
+
     # This module defines ELF file types.
     module ET
       ET_NONE = 0 # no file type
@@ -518,6 +394,8 @@ module ELFTools
     # Special indices to section. These are used when there is no valid index to section header.
     # The meaning of these values is left upto the embedding header.
     module SHN
+      extend Naming
+
       SHN_UNDEF           = 0      # undefined section
       SHN_LORESERVE       = 0xff00 # start of reserved indices
 
@@ -674,6 +552,8 @@ module ELFTools
 
     # Symbol binding from Sym st_info field.
     module STB
+      extend Naming
+
       STB_LOCAL      = 0 # Local symbol
       STB_GLOBAL     = 1 # Global symbol
       STB_WEAK       = 2 # Weak symbol
@@ -688,6 +568,8 @@ module ELFTools
 
     # Symbol types from Sym st_info field.
     module STT
+      extend Naming
+
       STT_NOTYPE         = 0 # Symbol type is unspecified
       STT_OBJECT         = 1 # Symbol is a data object
       STT_FUNC           = 2 # Symbol is a code object
@@ -718,5 +600,16 @@ module ELFTools
       STT_ARM_16BIT      = 15 # ARM: a THUMB label.
     end
     include STT
+
+    # Symbol visibility from Sym st_other field.
+    module STV
+      extend Naming
+
+      STV_DEFAULT   = 0 # Visibility is specified by binding type
+      STV_INTERNAL  = 1 # OS specific version of {STV_HIDDEN}
+      STV_HIDDEN    = 2 # Can only be seen inside currently compilation unit
+      STV_PROTECTED = 3 # Symbol is visible but cannot be preempted
+    end
+    include STV
   end
 end