1 //===-- ARMMachObjectWriter.cpp - ARM Mach Object Writer ------------------===//
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 #include "MCTargetDesc/ARMMCTargetDesc.h"
11 #include "MCTargetDesc/ARMBaseInfo.h"
12 #include "MCTargetDesc/ARMFixupKinds.h"
13 #include "llvm/ADT/Twine.h"
14 #include "llvm/MC/MCAsmLayout.h"
15 #include "llvm/MC/MCAssembler.h"
16 #include "llvm/MC/MCContext.h"
17 #include "llvm/MC/MCExpr.h"
18 #include "llvm/MC/MCFixup.h"
19 #include "llvm/MC/MCFixupKindInfo.h"
20 #include "llvm/MC/MCMachObjectWriter.h"
21 #include "llvm/MC/MCSection.h"
22 #include "llvm/MC/MCValue.h"
23 #include "llvm/Support/ErrorHandling.h"
24 #include "llvm/Support/MachO.h"
25 using namespace llvm;
26
27 namespace {
28 class ARMMachObjectWriter : public MCMachObjectTargetWriter {
29 void RecordARMScatteredRelocation(MachObjectWriter *Writer,
30 const MCAssembler &Asm,
31 const MCAsmLayout &Layout,
32 const MCFragment *Fragment,
33 const MCFixup &Fixup,
34 MCValue Target,
35 unsigned Type,
36 unsigned Log2Size,
37 uint64_t &FixedValue);
38 void RecordARMScatteredHalfRelocation(MachObjectWriter *Writer,
39 const MCAssembler &Asm,
40 const MCAsmLayout &Layout,
41 const MCFragment *Fragment,
42 const MCFixup &Fixup, MCValue Target,
43 uint64_t &FixedValue);
44
45 bool requiresExternRelocation(MachObjectWriter *Writer,
46 const MCAssembler &Asm,
47 const MCFragment &Fragment, unsigned RelocType,
48 const MCSymbol &S, uint64_t FixedValue);
49
50 public:
ARMMachObjectWriter(bool Is64Bit,uint32_t CPUType,uint32_t CPUSubtype)51 ARMMachObjectWriter(bool Is64Bit, uint32_t CPUType, uint32_t CPUSubtype)
52 : MCMachObjectTargetWriter(Is64Bit, CPUType, CPUSubtype) {}
53
54 void recordRelocation(MachObjectWriter *Writer, MCAssembler &Asm,
55 const MCAsmLayout &Layout, const MCFragment *Fragment,
56 const MCFixup &Fixup, MCValue Target,
57 uint64_t &FixedValue) override;
58 };
59 }
60
getARMFixupKindMachOInfo(unsigned Kind,unsigned & RelocType,unsigned & Log2Size)61 static bool getARMFixupKindMachOInfo(unsigned Kind, unsigned &RelocType,
62 unsigned &Log2Size) {
63 RelocType = unsigned(MachO::ARM_RELOC_VANILLA);
64 Log2Size = ~0U;
65
66 switch (Kind) {
67 default:
68 return false;
69
70 case FK_Data_1:
71 Log2Size = llvm::Log2_32(1);
72 return true;
73 case FK_Data_2:
74 Log2Size = llvm::Log2_32(2);
75 return true;
76 case FK_Data_4:
77 Log2Size = llvm::Log2_32(4);
78 return true;
79 case FK_Data_8:
80 Log2Size = llvm::Log2_32(8);
81 return true;
82
83 // These fixups are expected to always be resolvable at assembly time and
84 // have no relocations supported.
85 case ARM::fixup_arm_ldst_pcrel_12:
86 case ARM::fixup_arm_pcrel_10:
87 case ARM::fixup_arm_adr_pcrel_12:
88 case ARM::fixup_arm_thumb_br:
89 return false;
90
91 // Handle 24-bit branch kinds.
92 case ARM::fixup_arm_condbranch:
93 case ARM::fixup_arm_uncondbranch:
94 case ARM::fixup_arm_uncondbl:
95 case ARM::fixup_arm_condbl:
96 case ARM::fixup_arm_blx:
97 RelocType = unsigned(MachO::ARM_RELOC_BR24);
98 // Report as 'long', even though that is not quite accurate.
99 Log2Size = llvm::Log2_32(4);
100 return true;
101
102 case ARM::fixup_t2_uncondbranch:
103 case ARM::fixup_arm_thumb_bl:
104 case ARM::fixup_arm_thumb_blx:
105 RelocType = unsigned(MachO::ARM_THUMB_RELOC_BR22);
106 Log2Size = llvm::Log2_32(4);
107 return true;
108
109 // For movw/movt r_type relocations they always have a pair following them and
110 // the r_length bits are used differently. The encoding of the r_length is as
111 // follows:
112 // low bit of r_length:
113 // 0 - :lower16: for movw instructions
114 // 1 - :upper16: for movt instructions
115 // high bit of r_length:
116 // 0 - arm instructions
117 // 1 - thumb instructions
118 case ARM::fixup_arm_movt_hi16:
119 RelocType = unsigned(MachO::ARM_RELOC_HALF);
120 Log2Size = 1;
121 return true;
122 case ARM::fixup_t2_movt_hi16:
123 RelocType = unsigned(MachO::ARM_RELOC_HALF);
124 Log2Size = 3;
125 return true;
126
127 case ARM::fixup_arm_movw_lo16:
128 RelocType = unsigned(MachO::ARM_RELOC_HALF);
129 Log2Size = 0;
130 return true;
131 case ARM::fixup_t2_movw_lo16:
132 RelocType = unsigned(MachO::ARM_RELOC_HALF);
133 Log2Size = 2;
134 return true;
135 }
136 }
137
138 void ARMMachObjectWriter::
RecordARMScatteredHalfRelocation(MachObjectWriter * Writer,const MCAssembler & Asm,const MCAsmLayout & Layout,const MCFragment * Fragment,const MCFixup & Fixup,MCValue Target,uint64_t & FixedValue)139 RecordARMScatteredHalfRelocation(MachObjectWriter *Writer,
140 const MCAssembler &Asm,
141 const MCAsmLayout &Layout,
142 const MCFragment *Fragment,
143 const MCFixup &Fixup,
144 MCValue Target,
145 uint64_t &FixedValue) {
146 uint32_t FixupOffset = Layout.getFragmentOffset(Fragment)+Fixup.getOffset();
147 unsigned IsPCRel = Writer->isFixupKindPCRel(Asm, Fixup.getKind());
148 unsigned Type = MachO::ARM_RELOC_HALF;
149
150 // See <reloc.h>.
151 const MCSymbol *A = &Target.getSymA()->getSymbol();
152
153 if (!A->getFragment()) {
154 Asm.getContext().reportError(Fixup.getLoc(),
155 "symbol '" + A->getName() +
156 "' can not be undefined in a subtraction expression");
157 return;
158 }
159
160 uint32_t Value = Writer->getSymbolAddress(*A, Layout);
161 uint32_t Value2 = 0;
162 uint64_t SecAddr = Writer->getSectionAddress(A->getFragment()->getParent());
163 FixedValue += SecAddr;
164
165 if (const MCSymbolRefExpr *B = Target.getSymB()) {
166 const MCSymbol *SB = &B->getSymbol();
167
168 if (!SB->getFragment()) {
169 Asm.getContext().reportError(Fixup.getLoc(),
170 "symbol '" + B->getSymbol().getName() +
171 "' can not be undefined in a subtraction expression");
172 return;
173 }
174
175 // Select the appropriate difference relocation type.
176 Type = MachO::ARM_RELOC_HALF_SECTDIFF;
177 Value2 = Writer->getSymbolAddress(B->getSymbol(), Layout);
178 FixedValue -= Writer->getSectionAddress(SB->getFragment()->getParent());
179 }
180
181 // Relocations are written out in reverse order, so the PAIR comes first.
182 // ARM_RELOC_HALF and ARM_RELOC_HALF_SECTDIFF abuse the r_length field:
183 //
184 // For these two r_type relocations they always have a pair following them and
185 // the r_length bits are used differently. The encoding of the r_length is as
186 // follows:
187 // low bit of r_length:
188 // 0 - :lower16: for movw instructions
189 // 1 - :upper16: for movt instructions
190 // high bit of r_length:
191 // 0 - arm instructions
192 // 1 - thumb instructions
193 // the other half of the relocated expression is in the following pair
194 // relocation entry in the low 16 bits of r_address field.
195 unsigned ThumbBit = 0;
196 unsigned MovtBit = 0;
197 switch ((unsigned)Fixup.getKind()) {
198 default: break;
199 case ARM::fixup_arm_movt_hi16:
200 MovtBit = 1;
201 // The thumb bit shouldn't be set in the 'other-half' bit of the
202 // relocation, but it will be set in FixedValue if the base symbol
203 // is a thumb function. Clear it out here.
204 if (Asm.isThumbFunc(A))
205 FixedValue &= 0xfffffffe;
206 break;
207 case ARM::fixup_t2_movt_hi16:
208 if (Asm.isThumbFunc(A))
209 FixedValue &= 0xfffffffe;
210 MovtBit = 1;
211 // Fallthrough
212 case ARM::fixup_t2_movw_lo16:
213 ThumbBit = 1;
214 break;
215 }
216
217 if (Type == MachO::ARM_RELOC_HALF_SECTDIFF) {
218 uint32_t OtherHalf = MovtBit
219 ? (FixedValue & 0xffff) : ((FixedValue & 0xffff0000) >> 16);
220
221 MachO::any_relocation_info MRE;
222 MRE.r_word0 = ((OtherHalf << 0) |
223 (MachO::ARM_RELOC_PAIR << 24) |
224 (MovtBit << 28) |
225 (ThumbBit << 29) |
226 (IsPCRel << 30) |
227 MachO::R_SCATTERED);
228 MRE.r_word1 = Value2;
229 Writer->addRelocation(nullptr, Fragment->getParent(), MRE);
230 }
231
232 MachO::any_relocation_info MRE;
233 MRE.r_word0 = ((FixupOffset << 0) |
234 (Type << 24) |
235 (MovtBit << 28) |
236 (ThumbBit << 29) |
237 (IsPCRel << 30) |
238 MachO::R_SCATTERED);
239 MRE.r_word1 = Value;
240 Writer->addRelocation(nullptr, Fragment->getParent(), MRE);
241 }
242
RecordARMScatteredRelocation(MachObjectWriter * Writer,const MCAssembler & Asm,const MCAsmLayout & Layout,const MCFragment * Fragment,const MCFixup & Fixup,MCValue Target,unsigned Type,unsigned Log2Size,uint64_t & FixedValue)243 void ARMMachObjectWriter::RecordARMScatteredRelocation(MachObjectWriter *Writer,
244 const MCAssembler &Asm,
245 const MCAsmLayout &Layout,
246 const MCFragment *Fragment,
247 const MCFixup &Fixup,
248 MCValue Target,
249 unsigned Type,
250 unsigned Log2Size,
251 uint64_t &FixedValue) {
252 uint32_t FixupOffset = Layout.getFragmentOffset(Fragment)+Fixup.getOffset();
253 unsigned IsPCRel = Writer->isFixupKindPCRel(Asm, Fixup.getKind());
254
255 // See <reloc.h>.
256 const MCSymbol *A = &Target.getSymA()->getSymbol();
257
258 if (!A->getFragment()) {
259 Asm.getContext().reportError(Fixup.getLoc(),
260 "symbol '" + A->getName() +
261 "' can not be undefined in a subtraction expression");
262 return;
263 }
264
265 uint32_t Value = Writer->getSymbolAddress(*A, Layout);
266 uint64_t SecAddr = Writer->getSectionAddress(A->getFragment()->getParent());
267 FixedValue += SecAddr;
268 uint32_t Value2 = 0;
269
270 if (const MCSymbolRefExpr *B = Target.getSymB()) {
271 assert(Type == MachO::ARM_RELOC_VANILLA && "invalid reloc for 2 symbols");
272 const MCSymbol *SB = &B->getSymbol();
273
274 if (!SB->getFragment()) {
275 Asm.getContext().reportError(Fixup.getLoc(),
276 "symbol '" + B->getSymbol().getName() +
277 "' can not be undefined in a subtraction expression");
278 return;
279 }
280
281 // Select the appropriate difference relocation type.
282 Type = MachO::ARM_RELOC_SECTDIFF;
283 Value2 = Writer->getSymbolAddress(B->getSymbol(), Layout);
284 FixedValue -= Writer->getSectionAddress(SB->getFragment()->getParent());
285 }
286
287 // Relocations are written out in reverse order, so the PAIR comes first.
288 if (Type == MachO::ARM_RELOC_SECTDIFF ||
289 Type == MachO::ARM_RELOC_LOCAL_SECTDIFF) {
290 MachO::any_relocation_info MRE;
291 MRE.r_word0 = ((0 << 0) |
292 (MachO::ARM_RELOC_PAIR << 24) |
293 (Log2Size << 28) |
294 (IsPCRel << 30) |
295 MachO::R_SCATTERED);
296 MRE.r_word1 = Value2;
297 Writer->addRelocation(nullptr, Fragment->getParent(), MRE);
298 }
299
300 MachO::any_relocation_info MRE;
301 MRE.r_word0 = ((FixupOffset << 0) |
302 (Type << 24) |
303 (Log2Size << 28) |
304 (IsPCRel << 30) |
305 MachO::R_SCATTERED);
306 MRE.r_word1 = Value;
307 Writer->addRelocation(nullptr, Fragment->getParent(), MRE);
308 }
309
requiresExternRelocation(MachObjectWriter * Writer,const MCAssembler & Asm,const MCFragment & Fragment,unsigned RelocType,const MCSymbol & S,uint64_t FixedValue)310 bool ARMMachObjectWriter::requiresExternRelocation(MachObjectWriter *Writer,
311 const MCAssembler &Asm,
312 const MCFragment &Fragment,
313 unsigned RelocType,
314 const MCSymbol &S,
315 uint64_t FixedValue) {
316 // Most cases can be identified purely from the symbol.
317 if (Writer->doesSymbolRequireExternRelocation(S))
318 return true;
319 int64_t Value = (int64_t)FixedValue; // The displacement is signed.
320 int64_t Range;
321 switch (RelocType) {
322 default:
323 return false;
324 case MachO::ARM_RELOC_BR24:
325 // PC pre-adjustment of 8 for these instructions.
326 Value -= 8;
327 // ARM BL/BLX has a 25-bit offset.
328 Range = 0x1ffffff;
329 break;
330 case MachO::ARM_THUMB_RELOC_BR22:
331 // PC pre-adjustment of 4 for these instructions.
332 Value -= 4;
333 // Thumb BL/BLX has a 24-bit offset.
334 Range = 0xffffff;
335 }
336 // BL/BLX also use external relocations when an internal relocation
337 // would result in the target being out of range. This gives the linker
338 // enough information to generate a branch island.
339 Value += Writer->getSectionAddress(&S.getSection());
340 Value -= Writer->getSectionAddress(Fragment.getParent());
341 // If the resultant value would be out of range for an internal relocation,
342 // use an external instead.
343 if (Value > Range || Value < -(Range + 1))
344 return true;
345 return false;
346 }
347
recordRelocation(MachObjectWriter * Writer,MCAssembler & Asm,const MCAsmLayout & Layout,const MCFragment * Fragment,const MCFixup & Fixup,MCValue Target,uint64_t & FixedValue)348 void ARMMachObjectWriter::recordRelocation(MachObjectWriter *Writer,
349 MCAssembler &Asm,
350 const MCAsmLayout &Layout,
351 const MCFragment *Fragment,
352 const MCFixup &Fixup, MCValue Target,
353 uint64_t &FixedValue) {
354 unsigned IsPCRel = Writer->isFixupKindPCRel(Asm, Fixup.getKind());
355 unsigned Log2Size;
356 unsigned RelocType = MachO::ARM_RELOC_VANILLA;
357 if (!getARMFixupKindMachOInfo(Fixup.getKind(), RelocType, Log2Size)) {
358 // If we failed to get fixup kind info, it's because there's no legal
359 // relocation type for the fixup kind. This happens when it's a fixup that's
360 // expected to always be resolvable at assembly time and not have any
361 // relocations needed.
362 Asm.getContext().reportError(Fixup.getLoc(),
363 "unsupported relocation on symbol");
364 return;
365 }
366
367 // If this is a difference or a defined symbol plus an offset, then we need a
368 // scattered relocation entry. Differences always require scattered
369 // relocations.
370 if (Target.getSymB()) {
371 if (RelocType == MachO::ARM_RELOC_HALF)
372 return RecordARMScatteredHalfRelocation(Writer, Asm, Layout, Fragment,
373 Fixup, Target, FixedValue);
374 return RecordARMScatteredRelocation(Writer, Asm, Layout, Fragment, Fixup,
375 Target, RelocType, Log2Size,
376 FixedValue);
377 }
378
379 // Get the symbol data, if any.
380 const MCSymbol *A = nullptr;
381 if (Target.getSymA())
382 A = &Target.getSymA()->getSymbol();
383
384 // FIXME: For other platforms, we need to use scattered relocations for
385 // internal relocations with offsets. If this is an internal relocation with
386 // an offset, it also needs a scattered relocation entry.
387 //
388 // Is this right for ARM?
389 uint32_t Offset = Target.getConstant();
390 if (IsPCRel && RelocType == MachO::ARM_RELOC_VANILLA)
391 Offset += 1 << Log2Size;
392 if (Offset && A && !Writer->doesSymbolRequireExternRelocation(*A))
393 return RecordARMScatteredRelocation(Writer, Asm, Layout, Fragment, Fixup,
394 Target, RelocType, Log2Size,
395 FixedValue);
396
397 // See <reloc.h>.
398 uint32_t FixupOffset = Layout.getFragmentOffset(Fragment)+Fixup.getOffset();
399 unsigned Index = 0;
400 unsigned Type = 0;
401 const MCSymbol *RelSymbol = nullptr;
402
403 if (Target.isAbsolute()) { // constant
404 // FIXME!
405 report_fatal_error("FIXME: relocations to absolute targets "
406 "not yet implemented");
407 } else {
408 // Resolve constant variables.
409 if (A->isVariable()) {
410 int64_t Res;
411 if (A->getVariableValue()->evaluateAsAbsolute(
412 Res, Layout, Writer->getSectionAddressMap())) {
413 FixedValue = Res;
414 return;
415 }
416 }
417
418 // Check whether we need an external or internal relocation.
419 if (requiresExternRelocation(Writer, Asm, *Fragment, RelocType, *A,
420 FixedValue)) {
421 RelSymbol = A;
422
423 // For external relocations, make sure to offset the fixup value to
424 // compensate for the addend of the symbol address, if it was
425 // undefined. This occurs with weak definitions, for example.
426 if (!A->isUndefined())
427 FixedValue -= Layout.getSymbolOffset(*A);
428 } else {
429 // The index is the section ordinal (1-based).
430 const MCSection &Sec = A->getSection();
431 Index = Sec.getOrdinal() + 1;
432 FixedValue += Writer->getSectionAddress(&Sec);
433 }
434 if (IsPCRel)
435 FixedValue -= Writer->getSectionAddress(Fragment->getParent());
436
437 // The type is determined by the fixup kind.
438 Type = RelocType;
439 }
440
441 // struct relocation_info (8 bytes)
442 MachO::any_relocation_info MRE;
443 MRE.r_word0 = FixupOffset;
444 MRE.r_word1 =
445 (Index << 0) | (IsPCRel << 24) | (Log2Size << 25) | (Type << 28);
446
447 // Even when it's not a scattered relocation, movw/movt always uses
448 // a PAIR relocation.
449 if (Type == MachO::ARM_RELOC_HALF) {
450 // The other-half value only gets populated for the movt and movw
451 // relocation entries.
452 uint32_t Value = 0;
453 switch ((unsigned)Fixup.getKind()) {
454 default: break;
455 case ARM::fixup_arm_movw_lo16:
456 case ARM::fixup_t2_movw_lo16:
457 Value = (FixedValue >> 16) & 0xffff;
458 break;
459 case ARM::fixup_arm_movt_hi16:
460 case ARM::fixup_t2_movt_hi16:
461 Value = FixedValue & 0xffff;
462 break;
463 }
464 MachO::any_relocation_info MREPair;
465 MREPair.r_word0 = Value;
466 MREPair.r_word1 = ((0xffffff << 0) |
467 (Log2Size << 25) |
468 (MachO::ARM_RELOC_PAIR << 28));
469
470 Writer->addRelocation(nullptr, Fragment->getParent(), MREPair);
471 }
472
473 Writer->addRelocation(RelSymbol, Fragment->getParent(), MRE);
474 }
475
createARMMachObjectWriter(raw_pwrite_stream & OS,bool Is64Bit,uint32_t CPUType,uint32_t CPUSubtype)476 MCObjectWriter *llvm::createARMMachObjectWriter(raw_pwrite_stream &OS,
477 bool Is64Bit, uint32_t CPUType,
478 uint32_t CPUSubtype) {
479 return createMachObjectWriter(new ARMMachObjectWriter(Is64Bit,
480 CPUType,
481 CPUSubtype),
482 OS, /*IsLittleEndian=*/true);
483 }
484