xref: /netbsd-src/external/gpl3/binutils/dist/include/elf/riscv.h (revision dd7241df2fae9da4ea2bd20a68f001fa86ecf909)
1 /* RISC-V ELF support for BFD.
2    Copyright (C) 2011-2024 Free Software Foundation, Inc.
3 
4    Contributed by Andrew Waterman (andrew@sifive.com).
5    Based on MIPS ELF support for BFD, by Ian Lance Taylor.
6 
7    This file is part of BFD, the Binary File Descriptor library.
8 
9    This program is free software; you can redistribute it and/or modify
10    it under the terms of the GNU General Public License as published by
11    the Free Software Foundation; either version 3 of the License, or
12    (at your option) any later version.
13 
14    This program is distributed in the hope that it will be useful,
15    but WITHOUT ANY WARRANTY; without even the implied warranty of
16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17    GNU General Public License for more details.
18 
19    You should have received a copy of the GNU General Public License
20    along with this program; see the file COPYING3. If not,
21    see <http://www.gnu.org/licenses/>.  */
22 
23 /* This file holds definitions specific to the RISCV ELF ABI.  Note
24    that most of this is not actually implemented by BFD.  */
25 
26 #ifndef _ELF_RISCV_H
27 #define _ELF_RISCV_H
28 
29 #include "elf/reloc-macros.h"
30 #include "libiberty.h"
31 
32 /* Relocation types.  */
33 START_RELOC_NUMBERS (elf_riscv_reloc_type)
34   /* Relocation types used by the dynamic linker.  */
35   RELOC_NUMBER (R_RISCV_NONE, 0)
36   RELOC_NUMBER (R_RISCV_32, 1)
37   RELOC_NUMBER (R_RISCV_64, 2)
38   RELOC_NUMBER (R_RISCV_RELATIVE, 3)
39   RELOC_NUMBER (R_RISCV_COPY, 4)
40   RELOC_NUMBER (R_RISCV_JUMP_SLOT, 5)
41   RELOC_NUMBER (R_RISCV_TLS_DTPMOD32, 6)
42   RELOC_NUMBER (R_RISCV_TLS_DTPMOD64, 7)
43   RELOC_NUMBER (R_RISCV_TLS_DTPREL32, 8)
44   RELOC_NUMBER (R_RISCV_TLS_DTPREL64, 9)
45   RELOC_NUMBER (R_RISCV_TLS_TPREL32, 10)
46   RELOC_NUMBER (R_RISCV_TLS_TPREL64, 11)
47 
48   /* Relocation types not used by the dynamic linker.  */
49   RELOC_NUMBER (R_RISCV_BRANCH, 16)
50   RELOC_NUMBER (R_RISCV_JAL, 17)
51   RELOC_NUMBER (R_RISCV_CALL, 18)
52   RELOC_NUMBER (R_RISCV_CALL_PLT, 19)
53   RELOC_NUMBER (R_RISCV_GOT_HI20, 20)
54   RELOC_NUMBER (R_RISCV_TLS_GOT_HI20, 21)
55   RELOC_NUMBER (R_RISCV_TLS_GD_HI20, 22)
56   RELOC_NUMBER (R_RISCV_PCREL_HI20, 23)
57   RELOC_NUMBER (R_RISCV_PCREL_LO12_I, 24)
58   RELOC_NUMBER (R_RISCV_PCREL_LO12_S, 25)
59   RELOC_NUMBER (R_RISCV_HI20, 26)
60   RELOC_NUMBER (R_RISCV_LO12_I, 27)
61   RELOC_NUMBER (R_RISCV_LO12_S, 28)
62   RELOC_NUMBER (R_RISCV_TPREL_HI20, 29)
63   RELOC_NUMBER (R_RISCV_TPREL_LO12_I, 30)
64   RELOC_NUMBER (R_RISCV_TPREL_LO12_S, 31)
65   RELOC_NUMBER (R_RISCV_TPREL_ADD, 32)
66   RELOC_NUMBER (R_RISCV_ADD8, 33)
67   RELOC_NUMBER (R_RISCV_ADD16, 34)
68   RELOC_NUMBER (R_RISCV_ADD32, 35)
69   RELOC_NUMBER (R_RISCV_ADD64, 36)
70   RELOC_NUMBER (R_RISCV_SUB8, 37)
71   RELOC_NUMBER (R_RISCV_SUB16, 38)
72   RELOC_NUMBER (R_RISCV_SUB32, 39)
73   RELOC_NUMBER (R_RISCV_SUB64, 40)
74   RELOC_NUMBER (R_RISCV_ALIGN, 43)
75   RELOC_NUMBER (R_RISCV_RVC_BRANCH, 44)
76   RELOC_NUMBER (R_RISCV_RVC_JUMP, 45)
77   RELOC_NUMBER (R_RISCV_RVC_LUI, 46)
78   RELOC_NUMBER (R_RISCV_GPREL_I, 47)
79   RELOC_NUMBER (R_RISCV_GPREL_S, 48)
80   RELOC_NUMBER (R_RISCV_TPREL_I, 49)
81   RELOC_NUMBER (R_RISCV_TPREL_S, 50)
82   RELOC_NUMBER (R_RISCV_RELAX, 51)
83   RELOC_NUMBER (R_RISCV_SUB6, 52)
84   RELOC_NUMBER (R_RISCV_SET6, 53)
85   RELOC_NUMBER (R_RISCV_SET8, 54)
86   RELOC_NUMBER (R_RISCV_SET16, 55)
87   RELOC_NUMBER (R_RISCV_SET32, 56)
88   RELOC_NUMBER (R_RISCV_32_PCREL, 57)
89   RELOC_NUMBER (R_RISCV_IRELATIVE, 58)
90   /* Reserved 59 for R_RISCV_PLT32.  */
91   RELOC_NUMBER (R_RISCV_SET_ULEB128, 60)
92   RELOC_NUMBER (R_RISCV_SUB_ULEB128, 61)
93 END_RELOC_NUMBERS (R_RISCV_max)
94 
95 /* Internal relocations used exclusively by the relaxation pass.  */
96 #define R_RISCV_DELETE  (R_RISCV_max)
97 #define R_RISCV_RVC_LUI (R_RISCV_max + 1)
98 #define R_RISCV_GPREL_I (R_RISCV_max + 2)
99 #define R_RISCV_GPREL_S (R_RISCV_max + 3)
100 #define R_RISCV_TPREL_I (R_RISCV_max + 4)
101 #define R_RISCV_TPREL_S (R_RISCV_max + 5)
102 
103 /* Processor specific flags for the ELF header e_flags field.  */
104 
105 /* File may contain compressed instructions.  */
106 #define EF_RISCV_RVC 0x0001
107 
108 /* Which floating-point ABI a file uses.  */
109 #define EF_RISCV_FLOAT_ABI 0x0006
110 
111 /* File uses the soft-float ABI.  */
112 #define EF_RISCV_FLOAT_ABI_SOFT 0x0000
113 
114 /* File uses the single-float ABI.  */
115 #define EF_RISCV_FLOAT_ABI_SINGLE 0x0002
116 
117 /* File uses the double-float ABI.  */
118 #define EF_RISCV_FLOAT_ABI_DOUBLE 0x0004
119 
120 /* File uses the quad-float ABI.  */
121 #define EF_RISCV_FLOAT_ABI_QUAD 0x0006
122 
123 /* File uses the 32E base integer instruction.  */
124 #define EF_RISCV_RVE 0x0008
125 
126 /* The name of the global pointer symbol.  */
127 #define RISCV_GP_SYMBOL "__global_pointer$"
128 
129 /* Processor specific dynamic array tags.  */
130 #define DT_RISCV_VARIANT_CC (DT_LOPROC + 1)
131 
132 /* RISC-V specific values for st_other.  */
133 #define STO_RISCV_VARIANT_CC 0x80
134 
135 /* File uses the TSO model. */
136 #define EF_RISCV_TSO 0x0010
137 
138 /* Additional section types.  */
139 #define SHT_RISCV_ATTRIBUTES 0x70000003 /* Section holds attributes.  */
140 
141 /* Processor specific program header types.  */
142 
143 /* Location of RISC-V ELF attribute section. */
144 #define PT_RISCV_ATTRIBUTES 0x70000003
145 
146 /* Object attributes.  */
147 enum
148 {
149   /* 0-3 are generic.  */
150   Tag_RISCV_stack_align = 4,
151   Tag_RISCV_arch = 5,
152   Tag_RISCV_unaligned_access = 6,
153   Tag_RISCV_priv_spec = 8,
154   Tag_RISCV_priv_spec_minor = 10,
155   Tag_RISCV_priv_spec_revision = 12
156 };
157 
158 #endif /* _ELF_RISCV_H */
159