[MIPS] Add Loongson 3A2000/3A3000 proccessor support.
[deliverable/binutils-gdb.git] / elfcpp / mips.h
1 // mips.h -- ELF definitions specific to EM_MIPS -*- C++ -*-
2
3 // Copyright (C) 2012-2018 Free Software Foundation, Inc.
4 // Written by Sasa Stankovic <sasa.stankovic@imgtec.com>
5 // and Aleksandar Simeonov <aleksandar.simeonov@rt-rk.com>.
6
7 // This file is part of elfcpp.
8
9 // This program is free software; you can redistribute it and/or
10 // modify it under the terms of the GNU Library General Public License
11 // as published by the Free Software Foundation; either version 2, or
12 // (at your option) any later version.
13
14 // In addition to the permissions in the GNU Library General Public
15 // License, the Free Software Foundation gives you unlimited
16 // permission to link the compiled version of this file into
17 // combinations with other programs, and to distribute those
18 // combinations without any restriction coming from the use of this
19 // file. (The Library Public License restrictions do apply in other
20 // respects; for example, they cover modification of the file, and
21 /// distribution when not linked into a combined executable.)
22
23 // This program is distributed in the hope that it will be useful, but
24 // WITHOUT ANY WARRANTY; without even the implied warranty of
25 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
26 // Library General Public License for more details.
27
28 // You should have received a copy of the GNU Library General Public
29 // License along with this program; if not, write to the Free Software
30 // Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA
31 // 02110-1301, USA.
32
33 #ifndef ELFCPP_MIPS_H
34 #define ELFCPP_MIPS_H
35
36 // Documentation for the MIPS relocs is taken from
37 // http://math-atlas.sourceforge.net/devel/assembly/mipsabi32.pdf
38
39 namespace elfcpp
40 {
41
42 //
43 // MIPS Relocation Codes
44 //
45
46 enum
47 {
48 R_MIPS_NONE = 0,
49 R_MIPS_16 = 1,
50 R_MIPS_32 = 2, // In Elf 64: alias R_MIPS_ADD
51 R_MIPS_REL32 = 3, // In Elf 64: alias R_MIPS_REL
52 R_MIPS_26 = 4,
53 R_MIPS_HI16 = 5,
54 R_MIPS_LO16 = 6,
55 R_MIPS_GPREL16 = 7, // In Elf 64: alias R_MIPS_GPREL
56 R_MIPS_LITERAL = 8,
57 R_MIPS_GOT16 = 9, // In Elf 64: alias R_MIPS_GOT
58 R_MIPS_PC16 = 10,
59 R_MIPS_CALL16 = 11, // In Elf 64: alias R_MIPS_CALL
60 R_MIPS_GPREL32 = 12,
61 R_MIPS_UNUSED1 = 13,
62 R_MIPS_UNUSED2 = 14,
63 R_MIPS_UNUSED3 = 15,
64 R_MIPS_SHIFT5 = 16,
65 R_MIPS_SHIFT6 = 17,
66 R_MIPS_64 = 18,
67 R_MIPS_GOT_DISP = 19,
68 R_MIPS_GOT_PAGE = 20,
69 R_MIPS_GOT_OFST = 21,
70 R_MIPS_GOT_HI16 = 22,
71 R_MIPS_GOT_LO16 = 23,
72 R_MIPS_SUB = 24,
73 R_MIPS_INSERT_A = 25,
74 R_MIPS_INSERT_B = 26,
75 R_MIPS_DELETE = 27,
76 R_MIPS_HIGHER = 28,
77 R_MIPS_HIGHEST = 29,
78 R_MIPS_CALL_HI16 = 30,
79 R_MIPS_CALL_LO16 = 31,
80 R_MIPS_SCN_DISP = 32,
81 R_MIPS_REL16 = 33,
82 R_MIPS_ADD_IMMEDIATE = 34,
83 R_MIPS_PJUMP = 35,
84 R_MIPS_RELGOT = 36,
85 R_MIPS_JALR = 37,
86 // TLS relocations.
87 R_MIPS_TLS_DTPMOD32 = 38,
88 R_MIPS_TLS_DTPREL32 = 39,
89 R_MIPS_TLS_DTPMOD64 = 40,
90 R_MIPS_TLS_DTPREL64 = 41,
91 R_MIPS_TLS_GD = 42,
92 R_MIPS_TLS_LDM = 43,
93 R_MIPS_TLS_DTPREL_HI16 = 44,
94 R_MIPS_TLS_DTPREL_LO16 = 45,
95 R_MIPS_TLS_GOTTPREL = 46,
96 R_MIPS_TLS_TPREL32 = 47,
97 R_MIPS_TLS_TPREL64 = 48,
98 R_MIPS_TLS_TPREL_HI16 = 49,
99 R_MIPS_TLS_TPREL_LO16 = 50,
100 R_MIPS_GLOB_DAT = 51,
101 R_MIPS_PC21_S2 = 60,
102 R_MIPS_PC26_S2 = 61,
103 R_MIPS_PC18_S3 = 62,
104 R_MIPS_PC19_S2 = 63,
105 R_MIPS_PCHI16 = 64,
106 R_MIPS_PCLO16 = 65,
107 // These relocs are used for the mips16.
108 R_MIPS16_26 = 100,
109 R_MIPS16_GPREL = 101,
110 R_MIPS16_GOT16 = 102,
111 R_MIPS16_CALL16 = 103,
112 R_MIPS16_HI16 = 104,
113 R_MIPS16_LO16 = 105,
114 R_MIPS16_TLS_GD = 106,
115 R_MIPS16_TLS_LDM = 107,
116 R_MIPS16_TLS_DTPREL_HI16 = 108,
117 R_MIPS16_TLS_DTPREL_LO16 = 109,
118 R_MIPS16_TLS_GOTTPREL = 110,
119 R_MIPS16_TLS_TPREL_HI16 = 111,
120 R_MIPS16_TLS_TPREL_LO16 = 112,
121
122 R_MIPS_COPY = 126,
123 R_MIPS_JUMP_SLOT = 127,
124
125 // These relocations are specific to microMIPS.
126 R_MICROMIPS_26_S1 = 133,
127 R_MICROMIPS_HI16 = 134,
128 R_MICROMIPS_LO16 = 135,
129 R_MICROMIPS_GPREL16 = 136, // In Elf 64: alias R_MICROMIPS_GPREL
130 R_MICROMIPS_LITERAL = 137,
131 R_MICROMIPS_GOT16 = 138, // In Elf 64: alias R_MICROMIPS_GOT
132 R_MICROMIPS_PC7_S1 = 139,
133 R_MICROMIPS_PC10_S1 = 140,
134 R_MICROMIPS_PC16_S1 = 141,
135 R_MICROMIPS_CALL16 = 142, // In Elf 64: alias R_MICROMIPS_CALL
136 R_MICROMIPS_GOT_DISP = 145,
137 R_MICROMIPS_GOT_PAGE = 146,
138 R_MICROMIPS_GOT_OFST = 147,
139 R_MICROMIPS_GOT_HI16 = 148,
140 R_MICROMIPS_GOT_LO16 = 149,
141 R_MICROMIPS_SUB = 150,
142 R_MICROMIPS_HIGHER = 151,
143 R_MICROMIPS_HIGHEST = 152,
144 R_MICROMIPS_CALL_HI16 = 153,
145 R_MICROMIPS_CALL_LO16 = 154,
146 R_MICROMIPS_SCN_DISP = 155,
147 R_MICROMIPS_JALR = 156,
148 R_MICROMIPS_HI0_LO16 = 157,
149 // TLS relocations.
150 R_MICROMIPS_TLS_GD = 162,
151 R_MICROMIPS_TLS_LDM = 163,
152 R_MICROMIPS_TLS_DTPREL_HI16 = 164,
153 R_MICROMIPS_TLS_DTPREL_LO16 = 165,
154 R_MICROMIPS_TLS_GOTTPREL = 166,
155 R_MICROMIPS_TLS_TPREL_HI16 = 169,
156 R_MICROMIPS_TLS_TPREL_LO16 = 170,
157 // microMIPS GP- and PC-relative relocations.
158 R_MICROMIPS_GPREL7_S2 = 172,
159 R_MICROMIPS_PC23_S2 = 173,
160
161 // This was a GNU extension used by embedded-PIC. It was co-opted by
162 // mips-linux for exception-handling data. GCC stopped using it in
163 // May, 2004, then started using it again for compact unwind tables.
164 R_MIPS_PC32 = 248,
165 R_MIPS_EH = 249,
166 // This relocation is used internally by gas.
167 R_MIPS_GNU_REL16_S2 = 250,
168 // These are GNU extensions to enable C++ vtable garbage collection.
169 R_MIPS_GNU_VTINHERIT = 253,
170 R_MIPS_GNU_VTENTRY = 254
171 };
172
173 // Processor specific flags for the ELF header e_flags field.
174 enum
175 {
176 // At least one .noreorder directive appears in the source.
177 EF_MIPS_NOREORDER = 0x00000001,
178 // File contains position independent code.
179 EF_MIPS_PIC = 0x00000002,
180 // Code in file uses the standard calling sequence for calling
181 // position independent code.
182 EF_MIPS_CPIC = 0x00000004,
183 // ??? Unknown flag, set in IRIX 6's BSDdup2.o in libbsd.a.
184 EF_MIPS_XGOT = 0x00000008,
185 // Code in file uses UCODE (obsolete)
186 EF_MIPS_UCODE = 0x00000010,
187 // Code in file uses new ABI (-n32 on Irix 6).
188 EF_MIPS_ABI2 = 0x00000020,
189 // Process the .MIPS.options section first by ld
190 EF_MIPS_OPTIONS_FIRST = 0x00000080,
191 // Architectural Extensions used by this file
192 EF_MIPS_ARCH_ASE = 0x0f000000,
193 // Use MDMX multimedia extensions
194 EF_MIPS_ARCH_ASE_MDMX = 0x08000000,
195 // Use MIPS-16 ISA extensions
196 EF_MIPS_ARCH_ASE_M16 = 0x04000000,
197 // Use MICROMIPS ISA extensions.
198 EF_MIPS_ARCH_ASE_MICROMIPS = 0x02000000,
199 // Indicates code compiled for a 64-bit machine in 32-bit mode.
200 // (regs are 32-bits wide.)
201 EF_MIPS_32BITMODE = 0x00000100,
202 // 32-bit machine but FP registers are 64 bit (-mfp64).
203 EF_MIPS_FP64 = 0x00000200,
204 /// Code in file uses the IEEE 754-2008 NaN encoding convention.
205 EF_MIPS_NAN2008 = 0x00000400,
206 // MIPS dynamic
207 EF_MIPS_DYNAMIC = 0x40
208 };
209
210 // Machine variant if we know it. This field was invented at Cygnus,
211 // but it is hoped that other vendors will adopt it. If some standard
212 // is developed, this code should be changed to follow it.
213 enum
214 {
215 EF_MIPS_MACH = 0x00FF0000,
216
217 // Cygnus is choosing values between 80 and 9F;
218 // 00 - 7F should be left for a future standard;
219 // the rest are open.
220
221 E_MIPS_MACH_3900 = 0x00810000,
222 E_MIPS_MACH_4010 = 0x00820000,
223 E_MIPS_MACH_4100 = 0x00830000,
224 E_MIPS_MACH_4650 = 0x00850000,
225 E_MIPS_MACH_4120 = 0x00870000,
226 E_MIPS_MACH_4111 = 0x00880000,
227 E_MIPS_MACH_SB1 = 0x008a0000,
228 E_MIPS_MACH_OCTEON = 0x008b0000,
229 E_MIPS_MACH_XLR = 0x008c0000,
230 E_MIPS_MACH_OCTEON2 = 0x008d0000,
231 E_MIPS_MACH_OCTEON3 = 0x008e0000,
232 E_MIPS_MACH_5400 = 0x00910000,
233 E_MIPS_MACH_5900 = 0x00920000,
234 E_MIPS_MACH_5500 = 0x00980000,
235 E_MIPS_MACH_9000 = 0x00990000,
236 E_MIPS_MACH_LS2E = 0x00A00000,
237 E_MIPS_MACH_LS2F = 0x00A10000,
238 E_MIPS_MACH_GS464 = 0x00A20000,
239 E_MIPS_MACH_GS464E = 0x00A30000,
240 };
241
242 // MIPS architecture
243 enum
244 {
245 // Four bit MIPS architecture field.
246 EF_MIPS_ARCH = 0xf0000000,
247 // -mips1 code.
248 E_MIPS_ARCH_1 = 0x00000000,
249 // -mips2 code.
250 E_MIPS_ARCH_2 = 0x10000000,
251 // -mips3 code.
252 E_MIPS_ARCH_3 = 0x20000000,
253 // -mips4 code.
254 E_MIPS_ARCH_4 = 0x30000000,
255 // -mips5 code.
256 E_MIPS_ARCH_5 = 0x40000000,
257 // -mips32 code.
258 E_MIPS_ARCH_32 = 0x50000000,
259 // -mips64 code.
260 E_MIPS_ARCH_64 = 0x60000000,
261 // -mips32r2 code.
262 E_MIPS_ARCH_32R2 = 0x70000000,
263 // -mips64r2 code.
264 E_MIPS_ARCH_64R2 = 0x80000000,
265 // -mips32r6 code.
266 E_MIPS_ARCH_32R6 = 0x90000000,
267 // -mips64r6 code.
268 E_MIPS_ARCH_64R6 = 0xa0000000,
269 };
270
271 // Values for the xxx_size bytes of an ABI flags structure.
272 enum
273 {
274 // No registers.
275 AFL_REG_NONE = 0x00,
276 // 32-bit registers.
277 AFL_REG_32 = 0x01,
278 // 64-bit registers.
279 AFL_REG_64 = 0x02,
280 // 128-bit registers.
281 AFL_REG_128 = 0x03
282 };
283
284 // Masks for the ases word of an ABI flags structure.
285 enum
286 {
287 // DSP ASE.
288 AFL_ASE_DSP = 0x00000001,
289 // DSP R2 ASE.
290 AFL_ASE_DSPR2 = 0x00000002,
291 // Enhanced VA Scheme.
292 AFL_ASE_EVA = 0x00000004,
293 // MCU (MicroController) ASE.
294 AFL_ASE_MCU = 0x00000008,
295 // MDMX ASE.
296 AFL_ASE_MDMX = 0x00000010,
297 // MIPS-3D ASE.
298 AFL_ASE_MIPS3D = 0x00000020,
299 // MT ASE.
300 AFL_ASE_MT = 0x00000040,
301 // SmartMIPS ASE.
302 AFL_ASE_SMARTMIPS = 0x00000080,
303 // VZ ASE.
304 AFL_ASE_VIRT = 0x00000100,
305 // MSA ASE.
306 AFL_ASE_MSA = 0x00000200,
307 // MIPS16 ASE.
308 AFL_ASE_MIPS16 = 0x00000400,
309 // MICROMIPS ASE.
310 AFL_ASE_MICROMIPS = 0x00000800,
311 // XPA ASE.
312 AFL_ASE_XPA = 0x00001000,
313 // Loongson EXT ASE.
314 AFL_ASE_LOONGSON_EXT = 0x00002000
315 };
316
317 // Values for the isa_ext word of an ABI flags structure.
318 enum
319 {
320 // RMI Xlr instruction.
321 AFL_EXT_XLR = 1,
322 // Cavium Networks Octeon2.
323 AFL_EXT_OCTEON2 = 2,
324 // Cavium Networks OcteonP.
325 AFL_EXT_OCTEONP = 3,
326 // Loongson 3A.
327 AFL_EXT_LOONGSON_3A = 4,
328 // Cavium Networks Octeon.
329 AFL_EXT_OCTEON = 5,
330 // MIPS R5900 instruction.
331 AFL_EXT_5900 = 6,
332 // MIPS R4650 instruction.
333 AFL_EXT_4650 = 7,
334 // LSI R4010 instruction.
335 AFL_EXT_4010 = 8,
336 // NEC VR4100 instruction.
337 AFL_EXT_4100 = 9,
338 // Toshiba R3900 instruction.
339 AFL_EXT_3900 = 10,
340 // MIPS R10000 instruction.
341 AFL_EXT_10000 = 11,
342 // Broadcom SB-1 instruction.
343 AFL_EXT_SB1 = 12,
344 // NEC VR4111/VR4181 instruction.
345 AFL_EXT_4111 = 13,
346 // NEC VR4120 instruction.
347 AFL_EXT_4120 = 14,
348 // NEC VR5400 instruction.
349 AFL_EXT_5400 = 15,
350 // NEC VR5500 instruction.
351 AFL_EXT_5500 = 16,
352 // ST Microelectronics Loongson 2E.
353 AFL_EXT_LOONGSON_2E = 17,
354 // ST Microelectronics Loongson 2F.
355 AFL_EXT_LOONGSON_2F = 18,
356 // Cavium Networks Octeon3.
357 AFL_EXT_OCTEON3 = 19
358 };
359
360 // Masks for the flags1 word of an ABI flags structure.
361 enum
362 {
363 // Uses odd single-precision registers.
364 AFL_FLAGS1_ODDSPREG = 1
365 };
366
367 // Object attribute tags.
368 enum
369 {
370 // 0-3 are generic.
371 // Floating-point ABI used by this object file.
372 Tag_GNU_MIPS_ABI_FP = 4,
373 // MSA ABI used by this object file.
374 Tag_GNU_MIPS_ABI_MSA = 8
375 };
376
377 // Object attribute values.
378 enum
379 {
380 // Values defined for Tag_GNU_MIPS_ABI_FP.
381 // Not tagged or not using any ABIs affected by the differences.
382 Val_GNU_MIPS_ABI_FP_ANY = 0,
383 // Using hard-float -mdouble-float.
384 Val_GNU_MIPS_ABI_FP_DOUBLE = 1,
385 // Using hard-float -msingle-float.
386 Val_GNU_MIPS_ABI_FP_SINGLE = 2,
387 // Using soft-float.
388 Val_GNU_MIPS_ABI_FP_SOFT = 3,
389 // Using -mips32r2 -mfp64.
390 Val_GNU_MIPS_ABI_FP_OLD_64 = 4,
391 // Using -mfpxx
392 Val_GNU_MIPS_ABI_FP_XX = 5,
393 // Using -mips32r2 -mfp64.
394 Val_GNU_MIPS_ABI_FP_64 = 6,
395 // Using -mips32r2 -mfp64 -mno-odd-spreg.
396 Val_GNU_MIPS_ABI_FP_64A = 7,
397 // This is reserved for backward-compatibility with an earlier
398 // implementation of the MIPS NaN2008 functionality.
399 Val_GNU_MIPS_ABI_FP_NAN2008 = 8,
400
401 // Values defined for Tag_GNU_MIPS_ABI_MSA.
402 // Not tagged or not using any ABIs affected by the differences.
403 Val_GNU_MIPS_ABI_MSA_ANY = 0,
404 // Using 128-bit MSA.
405 Val_GNU_MIPS_ABI_MSA_128 = 1
406 };
407
408 enum
409 {
410 // Mask to extract ABI version, not really a flag value.
411 EF_MIPS_ABI = 0x0000F000,
412
413 // The original o32 abi.
414 E_MIPS_ABI_O32 = 0x00001000,
415 // O32 extended to work on 64 bit architectures
416 E_MIPS_ABI_O64 = 0x00002000,
417 // EABI in 32 bit mode
418 E_MIPS_ABI_EABI32 = 0x00003000,
419 // EABI in 64 bit mode
420 E_MIPS_ABI_EABI64 = 0x00004000,
421 };
422
423 // Dynamic section MIPS flags
424 enum
425 {
426 // None
427 RHF_NONE = 0x00000000,
428 // Use shortcut pointers
429 RHF_QUICKSTART = 0x00000001,
430 // Hash size not power of two
431 RHF_NOTPOT = 0x00000002,
432 // Ignore LD_LIBRARY_PATH
433 RHF_NO_LIBRARY_REPLACEMENT = 0x00000004
434 };
435
436 // Special values for the st_other field in the symbol table.
437 enum
438 {
439 // Two topmost bits denote the MIPS ISA for .text symbols:
440 // + 00 -- standard MIPS code,
441 // + 10 -- microMIPS code,
442 // + 11 -- MIPS16 code; requires the following two bits to be set too.
443 // Note that one of the MIPS16 bits overlaps with STO_MIPS_PIC.
444 STO_MIPS_ISA = 0xc0,
445
446 // The mask spanning the rest of MIPS psABI flags. At most one is expected
447 // to be set except for STO_MIPS16.
448 STO_MIPS_FLAGS = ~(STO_MIPS_ISA | 0x3),
449
450 // The MIPS psABI was updated in 2008 with support for PLTs and copy
451 // relocs. There are therefore two types of nonzero SHN_UNDEF functions:
452 // PLT entries and traditional MIPS lazy binding stubs. We mark the former
453 // with STO_MIPS_PLT to distinguish them from the latter.
454 STO_MIPS_PLT = 0x8,
455
456 // This value is used to mark PIC functions in an object that mixes
457 // PIC and non-PIC. Note that this bit overlaps with STO_MIPS16,
458 // although MIPS16 symbols are never considered to be MIPS_PIC.
459 STO_MIPS_PIC = 0x20,
460
461 // This value is used for a mips16 .text symbol.
462 STO_MIPS16 = 0xf0,
463
464 // This value is used for a microMIPS .text symbol. To distinguish from
465 // STO_MIPS16, we set top two bits to be 10 to denote STO_MICROMIPS. The
466 // mask is STO_MIPS_ISA.
467 STO_MICROMIPS = 0x80
468 };
469
470 // Values for base offsets for thread-local storage
471 enum
472 {
473 TP_OFFSET = 0x7000,
474 DTP_OFFSET = 0x8000
475 };
476
477
478 bool
479 elf_st_is_mips16(unsigned char st_other)
480 { return (st_other & elfcpp::STO_MIPS16) == elfcpp::STO_MIPS16; }
481
482 bool
483 elf_st_is_micromips(unsigned char st_other)
484 { return (st_other & elfcpp::STO_MIPS_ISA) == elfcpp::STO_MICROMIPS; }
485
486 // Whether the ABI is N32.
487 bool
488 abi_n32(elfcpp::Elf_Word e_flags)
489 { return (e_flags & elfcpp::EF_MIPS_ABI2) != 0; }
490
491 // Whether the ISA is R6.
492 bool
493 r6_isa(elfcpp::Elf_Word e_flags)
494 {
495 return ((e_flags & elfcpp::EF_MIPS_ARCH) == elfcpp::E_MIPS_ARCH_32R6)
496 || ((e_flags & elfcpp::EF_MIPS_ARCH) == elfcpp::E_MIPS_ARCH_64R6);
497 }
498
499 // Whether the file has microMIPS code.
500 bool
501 is_micromips(elfcpp::Elf_Word e_flags)
502 { return (e_flags & elfcpp::EF_MIPS_ARCH_ASE_MICROMIPS) != 0; }
503
504 // Values which may appear in the kind field of an Elf_Options structure.
505 enum
506 {
507 // Undefined.
508 ODK_NULL = 0,
509 // Register usage and GP value.
510 ODK_REGINFO = 1,
511 // Exception processing information.
512 ODK_EXCEPTIONS = 2,
513 // Section padding information.
514 ODK_PAD = 3,
515 // Hardware workarounds performed.
516 ODK_HWPATCH = 4,
517 // Fill value used by the linker.
518 ODK_FILL = 5,
519 // Reserved space for desktop tools.
520 ODK_TAGS = 6,
521 // Hardware workarounds, AND bits when merging.
522 ODK_HWAND = 7,
523 // Hardware workarounds, OR bits when merging.
524 ODK_HWOR = 8,
525 // GP group to use for text/data sections.
526 ODK_GP_GROUP = 9,
527 // ID information.
528 ODK_IDENT = 10
529 };
530
531 } // End namespace elfcpp.
532
533 #endif // !defined(ELFCPP_MIPS_H)
This page took 0.042657 seconds and 5 git commands to generate.