4 Copyright (c) 2010 - 2018, Intel Corporation. All rights reserved.<BR>
5 Portions copyright (c) 2013-2014, ARM Ltd. All rights reserved.<BR>
7 This program and the accompanying materials are licensed and made available
8 under the terms and conditions of the BSD License which accompanies this
9 distribution. The full text of the license may be found at
10 http://opensource.org/licenses/bsd-license.php
12 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
13 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
17 #include "WinNtInclude.h"
30 #include <Common/UefiBaseTypes.h>
31 #include <IndustryStandard/PeImage.h>
33 #include "PeCoffLib.h"
34 #include "EfiUtilityMsgs.h"
37 #include "ElfConvert.h"
38 #include "Elf64Convert.h"
49 SECTION_FILTER_TYPES FilterType
77 // Rename ELF32 strucutres to common names to help when porting to ELF64.
79 typedef Elf64_Shdr Elf_Shdr
;
80 typedef Elf64_Ehdr Elf_Ehdr
;
81 typedef Elf64_Rel Elf_Rel
;
82 typedef Elf64_Rela Elf_Rela
;
83 typedef Elf64_Sym Elf_Sym
;
84 typedef Elf64_Phdr Elf_Phdr
;
85 typedef Elf64_Dyn Elf_Dyn
;
86 #define ELFCLASS ELFCLASS64
87 #define ELF_R_TYPE(r) ELF64_R_TYPE(r)
88 #define ELF_R_SYM(r) ELF64_R_SYM(r)
91 // Well known ELF structures.
93 STATIC Elf_Ehdr
*mEhdr
;
94 STATIC Elf_Shdr
*mShdrBase
;
95 STATIC Elf_Phdr
*mPhdrBase
;
100 STATIC UINT32 mCoffAlignment
= 0x20;
103 // PE section alignment.
105 STATIC
const UINT16 mCoffNbrSections
= 4;
108 // ELF sections to offset in Coff file.
110 STATIC UINT32
*mCoffSectionsOffset
= NULL
;
113 // Offsets in COFF file
115 STATIC UINT32 mNtHdrOffset
;
116 STATIC UINT32 mTextOffset
;
117 STATIC UINT32 mDataOffset
;
118 STATIC UINT32 mHiiRsrcOffset
;
119 STATIC UINT32 mRelocOffset
;
120 STATIC UINT32 mDebugOffset
;
123 // Initialization Function
128 ELF_FUNCTION_TABLE
*ElfFunctions
132 // Initialize data pointer and structures.
134 VerboseMsg ("Set EHDR");
135 mEhdr
= (Elf_Ehdr
*) FileBuffer
;
138 // Check the ELF64 specific header information.
140 VerboseMsg ("Check ELF64 Header Information");
141 if (mEhdr
->e_ident
[EI_CLASS
] != ELFCLASS64
) {
142 Error (NULL
, 0, 3000, "Unsupported", "ELF EI_DATA not ELFCLASS64");
145 if (mEhdr
->e_ident
[EI_DATA
] != ELFDATA2LSB
) {
146 Error (NULL
, 0, 3000, "Unsupported", "ELF EI_DATA not ELFDATA2LSB");
149 if ((mEhdr
->e_type
!= ET_EXEC
) && (mEhdr
->e_type
!= ET_DYN
)) {
150 Error (NULL
, 0, 3000, "Unsupported", "ELF e_type not ET_EXEC or ET_DYN");
153 if (!((mEhdr
->e_machine
== EM_X86_64
) || (mEhdr
->e_machine
== EM_AARCH64
))) {
154 Error (NULL
, 0, 3000, "Unsupported", "ELF e_machine not EM_X86_64 or EM_AARCH64");
157 if (mEhdr
->e_version
!= EV_CURRENT
) {
158 Error (NULL
, 0, 3000, "Unsupported", "ELF e_version (%u) not EV_CURRENT (%d)", (unsigned) mEhdr
->e_version
, EV_CURRENT
);
163 // Update section header pointers
165 VerboseMsg ("Update Header Pointers");
166 mShdrBase
= (Elf_Shdr
*)((UINT8
*)mEhdr
+ mEhdr
->e_shoff
);
167 mPhdrBase
= (Elf_Phdr
*)((UINT8
*)mEhdr
+ mEhdr
->e_phoff
);
170 // Create COFF Section offset buffer and zero.
172 VerboseMsg ("Create COFF Section Offset Buffer");
173 mCoffSectionsOffset
= (UINT32
*)malloc(mEhdr
->e_shnum
* sizeof (UINT32
));
174 if (mCoffSectionsOffset
== NULL
) {
175 Error (NULL
, 0, 4001, "Resource", "memory cannot be allocated!");
178 memset(mCoffSectionsOffset
, 0, mEhdr
->e_shnum
* sizeof(UINT32
));
181 // Fill in function pointers.
183 VerboseMsg ("Fill in Function Pointers");
184 ElfFunctions
->ScanSections
= ScanSections64
;
185 ElfFunctions
->WriteSections
= WriteSections64
;
186 ElfFunctions
->WriteRelocations
= WriteRelocations64
;
187 ElfFunctions
->WriteDebug
= WriteDebug64
;
188 ElfFunctions
->SetImageSize
= SetImageSize64
;
189 ElfFunctions
->CleanUp
= CleanUp64
;
196 // Header by Index functions
204 if (Num
>= mEhdr
->e_shnum
) {
205 Error (NULL
, 0, 3000, "Invalid", "GetShdrByIndex: Index %u is too high.", Num
);
209 return (Elf_Shdr
*)((UINT8
*)mShdrBase
+ Num
* mEhdr
->e_shentsize
);
218 return (Offset
+ mCoffAlignment
- 1) & ~(mCoffAlignment
- 1);
227 return (Offset
+ 3) & ~3;
239 return (BOOLEAN
) ((Shdr
->sh_flags
& (SHF_WRITE
| SHF_ALLOC
)) == SHF_ALLOC
);
248 Elf_Shdr
*Namedr
= GetShdrByIndex(mEhdr
->e_shstrndx
);
250 return (BOOLEAN
) (strcmp((CHAR8
*)mEhdr
+ Namedr
->sh_offset
+ Shdr
->sh_name
, ELF_HII_SECTION_NAME
) == 0);
259 if (IsHiiRsrcShdr(Shdr
)) {
262 return (BOOLEAN
) (Shdr
->sh_flags
& (SHF_WRITE
| SHF_ALLOC
)) == (SHF_ALLOC
| SHF_WRITE
);
271 Elf_Shdr
*Namedr
= GetShdrByIndex(mEhdr
->e_shstrndx
);
273 return (BOOLEAN
) (strcmp((CHAR8
*)mEhdr
+ Namedr
->sh_offset
+ Shdr
->sh_name
, ELF_STRTAB_SECTION_NAME
) == 0);
283 for (i
= 0; i
< mEhdr
->e_shnum
; i
++) {
284 Elf_Shdr
*shdr
= GetShdrByIndex(i
);
285 if (IsStrtabShdr(shdr
)) {
298 Elf_Shdr
*StrtabShdr
;
299 UINT8
*StrtabContents
;
303 if (Sym
->st_name
== 0) {
307 StrtabShdr
= FindStrtabShdr();
308 if (StrtabShdr
== NULL
) {
312 assert(Sym
->st_name
< StrtabShdr
->sh_size
);
314 StrtabContents
= (UINT8
*)mEhdr
+ StrtabShdr
->sh_offset
;
317 for (i
= Sym
->st_name
; (i
< StrtabShdr
->sh_size
) && !foundEnd
; i
++) {
318 foundEnd
= (BOOLEAN
)(StrtabContents
[i
] == 0);
322 return StrtabContents
+ Sym
->st_name
;
326 // Elf functions interface implementation
336 EFI_IMAGE_DOS_HEADER
*DosHdr
;
337 EFI_IMAGE_OPTIONAL_HEADER_UNION
*NtHdr
;
340 BOOLEAN FoundSection
;
346 // Coff file start with a DOS header.
348 mCoffOffset
= sizeof(EFI_IMAGE_DOS_HEADER
) + 0x40;
349 mNtHdrOffset
= mCoffOffset
;
350 switch (mEhdr
->e_machine
) {
354 mCoffOffset
+= sizeof (EFI_IMAGE_NT_HEADERS64
);
357 VerboseMsg ("%s unknown e_machine type %hu. Assume X64", mInImageName
, mEhdr
->e_machine
);
358 mCoffOffset
+= sizeof (EFI_IMAGE_NT_HEADERS64
);
362 mTableOffset
= mCoffOffset
;
363 mCoffOffset
+= mCoffNbrSections
* sizeof(EFI_IMAGE_SECTION_HEADER
);
366 // Set mCoffAlignment to the maximum alignment of the input sections
369 for (i
= 0; i
< mEhdr
->e_shnum
; i
++) {
370 Elf_Shdr
*shdr
= GetShdrByIndex(i
);
371 if (shdr
->sh_addralign
<= mCoffAlignment
) {
374 if (IsTextShdr(shdr
) || IsDataShdr(shdr
) || IsHiiRsrcShdr(shdr
)) {
375 mCoffAlignment
= (UINT32
)shdr
->sh_addralign
;
380 // Check if mCoffAlignment is larger than MAX_COFF_ALIGNMENT
382 if (mCoffAlignment
> MAX_COFF_ALIGNMENT
) {
383 Error (NULL
, 0, 3000, "Invalid", "Section alignment is larger than MAX_COFF_ALIGNMENT.");
389 // Move the PE/COFF header right before the first section. This will help us
390 // save space when converting to TE.
392 if (mCoffAlignment
> mCoffOffset
) {
393 mNtHdrOffset
+= mCoffAlignment
- mCoffOffset
;
394 mTableOffset
+= mCoffAlignment
- mCoffOffset
;
395 mCoffOffset
= mCoffAlignment
;
399 // First text sections.
401 mCoffOffset
= CoffAlign(mCoffOffset
);
402 mTextOffset
= mCoffOffset
;
403 FoundSection
= FALSE
;
405 for (i
= 0; i
< mEhdr
->e_shnum
; i
++) {
406 Elf_Shdr
*shdr
= GetShdrByIndex(i
);
407 if (IsTextShdr(shdr
)) {
408 if ((shdr
->sh_addralign
!= 0) && (shdr
->sh_addralign
!= 1)) {
409 // the alignment field is valid
410 if ((shdr
->sh_addr
& (shdr
->sh_addralign
- 1)) == 0) {
411 // if the section address is aligned we must align PE/COFF
412 mCoffOffset
= (UINT32
) ((mCoffOffset
+ shdr
->sh_addralign
- 1) & ~(shdr
->sh_addralign
- 1));
414 Error (NULL
, 0, 3000, "Invalid", "Section address not aligned to its own alignment.");
418 /* Relocate entry. */
419 if ((mEhdr
->e_entry
>= shdr
->sh_addr
) &&
420 (mEhdr
->e_entry
< shdr
->sh_addr
+ shdr
->sh_size
)) {
421 CoffEntry
= (UINT32
) (mCoffOffset
+ mEhdr
->e_entry
- shdr
->sh_addr
);
425 // Set mTextOffset with the offset of the first '.text' section
428 mTextOffset
= mCoffOffset
;
432 mCoffSectionsOffset
[i
] = mCoffOffset
;
433 mCoffOffset
+= (UINT32
) shdr
->sh_size
;
439 Error (NULL
, 0, 3000, "Invalid", "Did not find any '.text' section.");
443 mDebugOffset
= DebugRvaAlign(mCoffOffset
);
444 mCoffOffset
= CoffAlign(mCoffOffset
);
446 if (SectionCount
> 1 && mOutImageType
== FW_EFI_IMAGE
) {
447 Warning (NULL
, 0, 0, NULL
, "Mulitple sections in %s are merged into 1 text section. Source level debug might not work correctly.", mInImageName
);
451 // Then data sections.
453 mDataOffset
= mCoffOffset
;
454 FoundSection
= FALSE
;
456 for (i
= 0; i
< mEhdr
->e_shnum
; i
++) {
457 Elf_Shdr
*shdr
= GetShdrByIndex(i
);
458 if (IsDataShdr(shdr
)) {
459 if ((shdr
->sh_addralign
!= 0) && (shdr
->sh_addralign
!= 1)) {
460 // the alignment field is valid
461 if ((shdr
->sh_addr
& (shdr
->sh_addralign
- 1)) == 0) {
462 // if the section address is aligned we must align PE/COFF
463 mCoffOffset
= (UINT32
) ((mCoffOffset
+ shdr
->sh_addralign
- 1) & ~(shdr
->sh_addralign
- 1));
465 Error (NULL
, 0, 3000, "Invalid", "Section address not aligned to its own alignment.");
470 // Set mDataOffset with the offset of the first '.data' section
473 mDataOffset
= mCoffOffset
;
476 mCoffSectionsOffset
[i
] = mCoffOffset
;
477 mCoffOffset
+= (UINT32
) shdr
->sh_size
;
483 // Make room for .debug data in .data (or .text if .data is empty) instead of
484 // putting it in a section of its own. This is explicitly allowed by the
485 // PE/COFF spec, and prevents bloat in the binary when using large values for
486 // section alignment.
488 if (SectionCount
> 0) {
489 mDebugOffset
= DebugRvaAlign(mCoffOffset
);
491 mCoffOffset
= mDebugOffset
+ sizeof(EFI_IMAGE_DEBUG_DIRECTORY_ENTRY
) +
492 sizeof(EFI_IMAGE_DEBUG_CODEVIEW_NB10_ENTRY
) +
493 strlen(mInImageName
) + 1;
495 mCoffOffset
= CoffAlign(mCoffOffset
);
496 if (SectionCount
== 0) {
497 mDataOffset
= mCoffOffset
;
500 if (SectionCount
> 1 && mOutImageType
== FW_EFI_IMAGE
) {
501 Warning (NULL
, 0, 0, NULL
, "Mulitple sections in %s are merged into 1 data section. Source level debug might not work correctly.", mInImageName
);
505 // The HII resource sections.
507 mHiiRsrcOffset
= mCoffOffset
;
508 for (i
= 0; i
< mEhdr
->e_shnum
; i
++) {
509 Elf_Shdr
*shdr
= GetShdrByIndex(i
);
510 if (IsHiiRsrcShdr(shdr
)) {
511 if ((shdr
->sh_addralign
!= 0) && (shdr
->sh_addralign
!= 1)) {
512 // the alignment field is valid
513 if ((shdr
->sh_addr
& (shdr
->sh_addralign
- 1)) == 0) {
514 // if the section address is aligned we must align PE/COFF
515 mCoffOffset
= (UINT32
) ((mCoffOffset
+ shdr
->sh_addralign
- 1) & ~(shdr
->sh_addralign
- 1));
517 Error (NULL
, 0, 3000, "Invalid", "Section address not aligned to its own alignment.");
520 if (shdr
->sh_size
!= 0) {
521 mHiiRsrcOffset
= mCoffOffset
;
522 mCoffSectionsOffset
[i
] = mCoffOffset
;
523 mCoffOffset
+= (UINT32
) shdr
->sh_size
;
524 mCoffOffset
= CoffAlign(mCoffOffset
);
525 SetHiiResourceHeader ((UINT8
*) mEhdr
+ shdr
->sh_offset
, mHiiRsrcOffset
);
531 mRelocOffset
= mCoffOffset
;
534 // Allocate base Coff file. Will be expanded later for relocations.
536 mCoffFile
= (UINT8
*)malloc(mCoffOffset
);
537 if (mCoffFile
== NULL
) {
538 Error (NULL
, 0, 4001, "Resource", "memory cannot be allocated!");
540 assert (mCoffFile
!= NULL
);
541 memset(mCoffFile
, 0, mCoffOffset
);
546 DosHdr
= (EFI_IMAGE_DOS_HEADER
*)mCoffFile
;
547 DosHdr
->e_magic
= EFI_IMAGE_DOS_SIGNATURE
;
548 DosHdr
->e_lfanew
= mNtHdrOffset
;
550 NtHdr
= (EFI_IMAGE_OPTIONAL_HEADER_UNION
*)(mCoffFile
+ mNtHdrOffset
);
552 NtHdr
->Pe32Plus
.Signature
= EFI_IMAGE_NT_SIGNATURE
;
554 switch (mEhdr
->e_machine
) {
556 NtHdr
->Pe32Plus
.FileHeader
.Machine
= EFI_IMAGE_MACHINE_X64
;
557 NtHdr
->Pe32Plus
.OptionalHeader
.Magic
= EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC
;
560 NtHdr
->Pe32Plus
.FileHeader
.Machine
= EFI_IMAGE_MACHINE_IPF
;
561 NtHdr
->Pe32Plus
.OptionalHeader
.Magic
= EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC
;
564 NtHdr
->Pe32Plus
.FileHeader
.Machine
= EFI_IMAGE_MACHINE_AARCH64
;
565 NtHdr
->Pe32Plus
.OptionalHeader
.Magic
= EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC
;
568 VerboseMsg ("%s unknown e_machine type. Assume X64", (UINTN
)mEhdr
->e_machine
);
569 NtHdr
->Pe32Plus
.FileHeader
.Machine
= EFI_IMAGE_MACHINE_X64
;
570 NtHdr
->Pe32Plus
.OptionalHeader
.Magic
= EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC
;
573 NtHdr
->Pe32Plus
.FileHeader
.NumberOfSections
= mCoffNbrSections
;
574 NtHdr
->Pe32Plus
.FileHeader
.TimeDateStamp
= (UINT32
) time(NULL
);
575 mImageTimeStamp
= NtHdr
->Pe32Plus
.FileHeader
.TimeDateStamp
;
576 NtHdr
->Pe32Plus
.FileHeader
.PointerToSymbolTable
= 0;
577 NtHdr
->Pe32Plus
.FileHeader
.NumberOfSymbols
= 0;
578 NtHdr
->Pe32Plus
.FileHeader
.SizeOfOptionalHeader
= sizeof(NtHdr
->Pe32Plus
.OptionalHeader
);
579 NtHdr
->Pe32Plus
.FileHeader
.Characteristics
= EFI_IMAGE_FILE_EXECUTABLE_IMAGE
580 | EFI_IMAGE_FILE_LINE_NUMS_STRIPPED
581 | EFI_IMAGE_FILE_LOCAL_SYMS_STRIPPED
582 | EFI_IMAGE_FILE_LARGE_ADDRESS_AWARE
;
584 NtHdr
->Pe32Plus
.OptionalHeader
.SizeOfCode
= mDataOffset
- mTextOffset
;
585 NtHdr
->Pe32Plus
.OptionalHeader
.SizeOfInitializedData
= mRelocOffset
- mDataOffset
;
586 NtHdr
->Pe32Plus
.OptionalHeader
.SizeOfUninitializedData
= 0;
587 NtHdr
->Pe32Plus
.OptionalHeader
.AddressOfEntryPoint
= CoffEntry
;
589 NtHdr
->Pe32Plus
.OptionalHeader
.BaseOfCode
= mTextOffset
;
591 NtHdr
->Pe32Plus
.OptionalHeader
.ImageBase
= 0;
592 NtHdr
->Pe32Plus
.OptionalHeader
.SectionAlignment
= mCoffAlignment
;
593 NtHdr
->Pe32Plus
.OptionalHeader
.FileAlignment
= mCoffAlignment
;
594 NtHdr
->Pe32Plus
.OptionalHeader
.SizeOfImage
= 0;
596 NtHdr
->Pe32Plus
.OptionalHeader
.SizeOfHeaders
= mTextOffset
;
597 NtHdr
->Pe32Plus
.OptionalHeader
.NumberOfRvaAndSizes
= EFI_IMAGE_NUMBER_OF_DIRECTORY_ENTRIES
;
602 if ((mDataOffset
- mTextOffset
) > 0) {
603 CreateSectionHeader (".text", mTextOffset
, mDataOffset
- mTextOffset
,
604 EFI_IMAGE_SCN_CNT_CODE
605 | EFI_IMAGE_SCN_MEM_EXECUTE
606 | EFI_IMAGE_SCN_MEM_READ
);
608 // Don't make a section of size 0.
609 NtHdr
->Pe32Plus
.FileHeader
.NumberOfSections
--;
612 if ((mHiiRsrcOffset
- mDataOffset
) > 0) {
613 CreateSectionHeader (".data", mDataOffset
, mHiiRsrcOffset
- mDataOffset
,
614 EFI_IMAGE_SCN_CNT_INITIALIZED_DATA
615 | EFI_IMAGE_SCN_MEM_WRITE
616 | EFI_IMAGE_SCN_MEM_READ
);
618 // Don't make a section of size 0.
619 NtHdr
->Pe32Plus
.FileHeader
.NumberOfSections
--;
622 if ((mRelocOffset
- mHiiRsrcOffset
) > 0) {
623 CreateSectionHeader (".rsrc", mHiiRsrcOffset
, mRelocOffset
- mHiiRsrcOffset
,
624 EFI_IMAGE_SCN_CNT_INITIALIZED_DATA
625 | EFI_IMAGE_SCN_MEM_READ
);
627 NtHdr
->Pe32Plus
.OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_RESOURCE
].Size
= mRelocOffset
- mHiiRsrcOffset
;
628 NtHdr
->Pe32Plus
.OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_RESOURCE
].VirtualAddress
= mHiiRsrcOffset
;
630 // Don't make a section of size 0.
631 NtHdr
->Pe32Plus
.FileHeader
.NumberOfSections
--;
639 SECTION_FILTER_TYPES FilterType
645 BOOLEAN (*Filter
)(Elf_Shdr
*);
648 // Initialize filter pointer
650 switch (FilterType
) {
655 Filter
= IsHiiRsrcShdr
;
665 // First: copy sections.
667 for (Idx
= 0; Idx
< mEhdr
->e_shnum
; Idx
++) {
668 Elf_Shdr
*Shdr
= GetShdrByIndex(Idx
);
669 if ((*Filter
)(Shdr
)) {
670 switch (Shdr
->sh_type
) {
673 if (Shdr
->sh_offset
+ Shdr
->sh_size
> mFileBufferSize
) {
676 memcpy(mCoffFile
+ mCoffSectionsOffset
[Idx
],
677 (UINT8
*)mEhdr
+ Shdr
->sh_offset
,
678 (size_t) Shdr
->sh_size
);
682 memset(mCoffFile
+ mCoffSectionsOffset
[Idx
], 0, (size_t) Shdr
->sh_size
);
687 // Ignore for unkown section type.
689 VerboseMsg ("%s unknown section type %x. We directly copy this section into Coff file", mInImageName
, (unsigned)Shdr
->sh_type
);
696 // Second: apply relocations.
698 VerboseMsg ("Applying Relocations...");
699 for (Idx
= 0; Idx
< mEhdr
->e_shnum
; Idx
++) {
701 // Determine if this is a relocation section.
703 Elf_Shdr
*RelShdr
= GetShdrByIndex(Idx
);
704 if ((RelShdr
->sh_type
!= SHT_REL
) && (RelShdr
->sh_type
!= SHT_RELA
)) {
709 // If this is a ET_DYN (PIE) executable, we will encounter a dynamic SHT_RELA
710 // section that applies to the entire binary, and which will have its section
711 // index set to #0 (which is a NULL section with the SHF_ALLOC bit cleared).
713 // In the absence of GOT based relocations (which we currently don't support),
714 // this RELA section will contain redundant R_xxx_RELATIVE relocations, one
715 // for every R_xxx_xx64 relocation appearing in the per-section RELA sections.
716 // (i.e., .rela.text and .rela.data)
718 if (RelShdr
->sh_info
== 0) {
723 // Relocation section found. Now extract section information that the relocations
724 // apply to in the ELF data and the new COFF data.
726 SecShdr
= GetShdrByIndex(RelShdr
->sh_info
);
727 SecOffset
= mCoffSectionsOffset
[RelShdr
->sh_info
];
730 // Only process relocations for the current filter type.
732 if (RelShdr
->sh_type
== SHT_RELA
&& (*Filter
)(SecShdr
)) {
736 // Determine the symbol table referenced by the relocation data.
738 Elf_Shdr
*SymtabShdr
= GetShdrByIndex(RelShdr
->sh_link
);
739 UINT8
*Symtab
= (UINT8
*)mEhdr
+ SymtabShdr
->sh_offset
;
742 // Process all relocation entries for this section.
744 for (RelIdx
= 0; RelIdx
< RelShdr
->sh_size
; RelIdx
+= (UINT32
) RelShdr
->sh_entsize
) {
747 // Set pointer to relocation entry
749 Elf_Rela
*Rel
= (Elf_Rela
*)((UINT8
*)mEhdr
+ RelShdr
->sh_offset
+ RelIdx
);
752 // Set pointer to symbol table entry associated with the relocation entry.
754 Elf_Sym
*Sym
= (Elf_Sym
*)(Symtab
+ ELF_R_SYM(Rel
->r_info
) * SymtabShdr
->sh_entsize
);
760 // Check section header index found in symbol table and get the section
763 if (Sym
->st_shndx
== SHN_UNDEF
764 || Sym
->st_shndx
>= mEhdr
->e_shnum
) {
765 const UINT8
*SymName
= GetSymName(Sym
);
766 if (SymName
== NULL
) {
767 SymName
= (const UINT8
*)"<unknown>";
770 Error (NULL
, 0, 3000, "Invalid",
771 "%s: Bad definition for symbol '%s'@%#llx or unsupported symbol type. "
772 "For example, absolute and undefined symbols are not supported.",
773 mInImageName
, SymName
, Sym
->st_value
);
777 SymShdr
= GetShdrByIndex(Sym
->st_shndx
);
780 // Convert the relocation data to a pointer into the coff file.
783 // r_offset is the virtual address of the storage unit to be relocated.
784 // sh_addr is the virtual address for the base of the section.
786 // r_offset in a memory address.
787 // Convert it to a pointer in the coff file.
789 Targ
= mCoffFile
+ SecOffset
+ (Rel
->r_offset
- SecShdr
->sh_addr
);
792 // Determine how to handle each relocation type based on the machine type.
794 if (mEhdr
->e_machine
== EM_X86_64
) {
795 switch (ELF_R_TYPE(Rel
->r_info
)) {
800 // Absolute relocation.
802 VerboseMsg ("R_X86_64_64");
803 VerboseMsg ("Offset: 0x%08X, Addend: 0x%016LX",
804 (UINT32
)(SecOffset
+ (Rel
->r_offset
- SecShdr
->sh_addr
)),
806 *(UINT64
*)Targ
= *(UINT64
*)Targ
- SymShdr
->sh_addr
+ mCoffSectionsOffset
[Sym
->st_shndx
];
807 VerboseMsg ("Relocation: 0x%016LX", *(UINT64
*)Targ
);
810 VerboseMsg ("R_X86_64_32");
811 VerboseMsg ("Offset: 0x%08X, Addend: 0x%08X",
812 (UINT32
)(SecOffset
+ (Rel
->r_offset
- SecShdr
->sh_addr
)),
814 *(UINT32
*)Targ
= (UINT32
)((UINT64
)(*(UINT32
*)Targ
) - SymShdr
->sh_addr
+ mCoffSectionsOffset
[Sym
->st_shndx
]);
815 VerboseMsg ("Relocation: 0x%08X", *(UINT32
*)Targ
);
818 VerboseMsg ("R_X86_64_32S");
819 VerboseMsg ("Offset: 0x%08X, Addend: 0x%08X",
820 (UINT32
)(SecOffset
+ (Rel
->r_offset
- SecShdr
->sh_addr
)),
822 *(INT32
*)Targ
= (INT32
)((INT64
)(*(INT32
*)Targ
) - SymShdr
->sh_addr
+ mCoffSectionsOffset
[Sym
->st_shndx
]);
823 VerboseMsg ("Relocation: 0x%08X", *(UINT32
*)Targ
);
828 // Treat R_X86_64_PLT32 relocations as R_X86_64_PC32: this is
829 // possible since we know all code symbol references resolve to
830 // definitions in the same module (UEFI has no shared libraries),
831 // and so there is never a reason to jump via a PLT entry,
832 // allowing us to resolve the reference using the symbol directly.
834 VerboseMsg ("Treating R_X86_64_PLT32 as R_X86_64_PC32 ...");
838 // Relative relocation: Symbol - Ip + Addend
840 VerboseMsg ("R_X86_64_PC32");
841 VerboseMsg ("Offset: 0x%08X, Addend: 0x%08X",
842 (UINT32
)(SecOffset
+ (Rel
->r_offset
- SecShdr
->sh_addr
)),
844 *(UINT32
*)Targ
= (UINT32
) (*(UINT32
*)Targ
845 + (mCoffSectionsOffset
[Sym
->st_shndx
] - SymShdr
->sh_addr
)
846 - (SecOffset
- SecShdr
->sh_addr
));
847 VerboseMsg ("Relocation: 0x%08X", *(UINT32
*)Targ
);
850 Error (NULL
, 0, 3000, "Invalid", "%s unsupported ELF EM_X86_64 relocation 0x%x.", mInImageName
, (unsigned) ELF_R_TYPE(Rel
->r_info
));
852 } else if (mEhdr
->e_machine
== EM_AARCH64
) {
854 switch (ELF_R_TYPE(Rel
->r_info
)) {
856 case R_AARCH64_ADR_PREL_PG_HI21
:
858 // AArch64 PG_H21 relocations are typically paired with ABS_LO12
859 // relocations, where a PC-relative reference with +/- 4 GB range is
860 // split into a relative high part and an absolute low part. Since
861 // the absolute low part represents the offset into a 4 KB page, we
862 // either have to convert the ADRP into an ADR instruction, or we
863 // need to use a section alignment of at least 4 KB, so that the
864 // binary appears at a correct offset at runtime. In any case, we
865 // have to make sure that the 4 KB relative offsets of both the
866 // section containing the reference as well as the section to which
867 // it refers have not been changed during PE/COFF conversion (i.e.,
868 // in ScanSections64() above).
870 if (mCoffAlignment
< 0x1000) {
872 // Attempt to convert the ADRP into an ADR instruction.
873 // This is only possible if the symbol is within +/- 1 MB.
877 // Decode the ADRP instruction
878 Offset
= (INT32
)((*(UINT32
*)Targ
& 0xffffe0) << 8);
879 Offset
= (Offset
<< (6 - 5)) | ((*(UINT32
*)Targ
& 0x60000000) >> (29 - 12));
882 // ADRP offset is relative to the previous page boundary,
883 // whereas ADR offset is relative to the instruction itself.
884 // So fix up the offset so it points to the page containing
887 Offset
-= (UINTN
)(Targ
- mCoffFile
) & 0xfff;
889 if (Offset
< -0x100000 || Offset
> 0xfffff) {
890 Error (NULL
, 0, 3000, "Invalid", "WriteSections64(): %s due to its size (> 1 MB), this module requires 4 KB section alignment.",
895 // Re-encode the offset as an ADR instruction
896 *(UINT32
*)Targ
&= 0x1000001f;
897 *(UINT32
*)Targ
|= ((Offset
& 0x1ffffc) << (5 - 2)) | ((Offset
& 0x3) << 29);
901 case R_AARCH64_ADD_ABS_LO12_NC
:
902 case R_AARCH64_LDST8_ABS_LO12_NC
:
903 case R_AARCH64_LDST16_ABS_LO12_NC
:
904 case R_AARCH64_LDST32_ABS_LO12_NC
:
905 case R_AARCH64_LDST64_ABS_LO12_NC
:
906 case R_AARCH64_LDST128_ABS_LO12_NC
:
907 if (((SecShdr
->sh_addr
^ SecOffset
) & 0xfff) != 0 ||
908 ((SymShdr
->sh_addr
^ mCoffSectionsOffset
[Sym
->st_shndx
]) & 0xfff) != 0) {
909 Error (NULL
, 0, 3000, "Invalid", "WriteSections64(): %s AARCH64 small code model requires identical ELF and PE/COFF section offsets modulo 4 KB.",
915 case R_AARCH64_ADR_PREL_LO21
:
916 case R_AARCH64_CONDBR19
:
917 case R_AARCH64_LD_PREL_LO19
:
918 case R_AARCH64_CALL26
:
919 case R_AARCH64_JUMP26
:
920 case R_AARCH64_PREL64
:
921 case R_AARCH64_PREL32
:
922 case R_AARCH64_PREL16
:
924 // The GCC toolchains (i.e., binutils) may corrupt section relative
925 // relocations when emitting relocation sections into fully linked
926 // binaries. More specifically, they tend to fail to take into
927 // account the fact that a '.rodata + XXX' relocation needs to have
928 // its addend recalculated once .rodata is merged into the .text
929 // section, and the relocation emitted into the .rela.text section.
931 // We cannot really recover from this loss of information, so the
932 // only workaround is to prevent having to recalculate any relative
933 // relocations at all, by using a linker script that ensures that
934 // the offset between the Place and the Symbol is the same in both
935 // the ELF and the PE/COFF versions of the binary.
937 if ((SymShdr
->sh_addr
- SecShdr
->sh_addr
) !=
938 (mCoffSectionsOffset
[Sym
->st_shndx
] - SecOffset
)) {
939 Error (NULL
, 0, 3000, "Invalid", "WriteSections64(): %s AARCH64 relative relocations require identical ELF and PE/COFF section offsets",
944 // Absolute relocations.
945 case R_AARCH64_ABS64
:
946 *(UINT64
*)Targ
= *(UINT64
*)Targ
- SymShdr
->sh_addr
+ mCoffSectionsOffset
[Sym
->st_shndx
];
950 Error (NULL
, 0, 3000, "Invalid", "WriteSections64(): %s unsupported ELF EM_AARCH64 relocation 0x%x.", mInImageName
, (unsigned) ELF_R_TYPE(Rel
->r_info
));
953 Error (NULL
, 0, 3000, "Invalid", "Not a supported machine type");
969 EFI_IMAGE_OPTIONAL_HEADER_UNION
*NtHdr
;
970 EFI_IMAGE_DATA_DIRECTORY
*Dir
;
972 for (Index
= 0; Index
< mEhdr
->e_shnum
; Index
++) {
973 Elf_Shdr
*RelShdr
= GetShdrByIndex(Index
);
974 if ((RelShdr
->sh_type
== SHT_REL
) || (RelShdr
->sh_type
== SHT_RELA
)) {
975 Elf_Shdr
*SecShdr
= GetShdrByIndex (RelShdr
->sh_info
);
976 if (IsTextShdr(SecShdr
) || IsDataShdr(SecShdr
)) {
979 for (RelIdx
= 0; RelIdx
< RelShdr
->sh_size
; RelIdx
+= RelShdr
->sh_entsize
) {
980 Elf_Rela
*Rel
= (Elf_Rela
*)((UINT8
*)mEhdr
+ RelShdr
->sh_offset
+ RelIdx
);
982 if (mEhdr
->e_machine
== EM_X86_64
) {
983 switch (ELF_R_TYPE(Rel
->r_info
)) {
989 VerboseMsg ("EFI_IMAGE_REL_BASED_DIR64 Offset: 0x%08X",
990 mCoffSectionsOffset
[RelShdr
->sh_info
] + (Rel
->r_offset
- SecShdr
->sh_addr
));
992 (UINT32
) ((UINT64
) mCoffSectionsOffset
[RelShdr
->sh_info
]
993 + (Rel
->r_offset
- SecShdr
->sh_addr
)),
994 EFI_IMAGE_REL_BASED_DIR64
);
998 VerboseMsg ("EFI_IMAGE_REL_BASED_HIGHLOW Offset: 0x%08X",
999 mCoffSectionsOffset
[RelShdr
->sh_info
] + (Rel
->r_offset
- SecShdr
->sh_addr
));
1001 (UINT32
) ((UINT64
) mCoffSectionsOffset
[RelShdr
->sh_info
]
1002 + (Rel
->r_offset
- SecShdr
->sh_addr
)),
1003 EFI_IMAGE_REL_BASED_HIGHLOW
);
1006 Error (NULL
, 0, 3000, "Invalid", "%s unsupported ELF EM_X86_64 relocation 0x%x.", mInImageName
, (unsigned) ELF_R_TYPE(Rel
->r_info
));
1008 } else if (mEhdr
->e_machine
== EM_AARCH64
) {
1010 switch (ELF_R_TYPE(Rel
->r_info
)) {
1011 case R_AARCH64_ADR_PREL_LO21
:
1012 case R_AARCH64_CONDBR19
:
1013 case R_AARCH64_LD_PREL_LO19
:
1014 case R_AARCH64_CALL26
:
1015 case R_AARCH64_JUMP26
:
1016 case R_AARCH64_PREL64
:
1017 case R_AARCH64_PREL32
:
1018 case R_AARCH64_PREL16
:
1019 case R_AARCH64_ADR_PREL_PG_HI21
:
1020 case R_AARCH64_ADD_ABS_LO12_NC
:
1021 case R_AARCH64_LDST8_ABS_LO12_NC
:
1022 case R_AARCH64_LDST16_ABS_LO12_NC
:
1023 case R_AARCH64_LDST32_ABS_LO12_NC
:
1024 case R_AARCH64_LDST64_ABS_LO12_NC
:
1025 case R_AARCH64_LDST128_ABS_LO12_NC
:
1027 // No fixups are required for relative relocations, provided that
1028 // the relative offsets between sections have been preserved in
1029 // the ELF to PE/COFF conversion. We have already asserted that
1030 // this is the case in WriteSections64 ().
1034 case R_AARCH64_ABS64
:
1036 (UINT32
) ((UINT64
) mCoffSectionsOffset
[RelShdr
->sh_info
]
1037 + (Rel
->r_offset
- SecShdr
->sh_addr
)),
1038 EFI_IMAGE_REL_BASED_DIR64
);
1041 case R_AARCH64_ABS32
:
1043 (UINT32
) ((UINT64
) mCoffSectionsOffset
[RelShdr
->sh_info
]
1044 + (Rel
->r_offset
- SecShdr
->sh_addr
)),
1045 EFI_IMAGE_REL_BASED_HIGHLOW
);
1049 Error (NULL
, 0, 3000, "Invalid", "WriteRelocations64(): %s unsupported ELF EM_AARCH64 relocation 0x%x.", mInImageName
, (unsigned) ELF_R_TYPE(Rel
->r_info
));
1052 Error (NULL
, 0, 3000, "Not Supported", "This tool does not support relocations for ELF with e_machine %u (processor type).", (unsigned) mEhdr
->e_machine
);
1060 // Pad by adding empty entries.
1062 while (mCoffOffset
& (mCoffAlignment
- 1)) {
1063 CoffAddFixupEntry(0);
1066 NtHdr
= (EFI_IMAGE_OPTIONAL_HEADER_UNION
*)(mCoffFile
+ mNtHdrOffset
);
1067 Dir
= &NtHdr
->Pe32Plus
.OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_BASERELOC
];
1068 Dir
->Size
= mCoffOffset
- mRelocOffset
;
1069 if (Dir
->Size
== 0) {
1070 // If no relocations, null out the directory entry and don't add the .reloc section
1071 Dir
->VirtualAddress
= 0;
1072 NtHdr
->Pe32Plus
.FileHeader
.NumberOfSections
--;
1074 Dir
->VirtualAddress
= mRelocOffset
;
1075 CreateSectionHeader (".reloc", mRelocOffset
, mCoffOffset
- mRelocOffset
,
1076 EFI_IMAGE_SCN_CNT_INITIALIZED_DATA
1077 | EFI_IMAGE_SCN_MEM_DISCARDABLE
1078 | EFI_IMAGE_SCN_MEM_READ
);
1089 EFI_IMAGE_OPTIONAL_HEADER_UNION
*NtHdr
;
1090 EFI_IMAGE_DATA_DIRECTORY
*DataDir
;
1091 EFI_IMAGE_DEBUG_DIRECTORY_ENTRY
*Dir
;
1092 EFI_IMAGE_DEBUG_CODEVIEW_NB10_ENTRY
*Nb10
;
1094 Len
= strlen(mInImageName
) + 1;
1096 Dir
= (EFI_IMAGE_DEBUG_DIRECTORY_ENTRY
*)(mCoffFile
+ mDebugOffset
);
1097 Dir
->Type
= EFI_IMAGE_DEBUG_TYPE_CODEVIEW
;
1098 Dir
->SizeOfData
= sizeof(EFI_IMAGE_DEBUG_CODEVIEW_NB10_ENTRY
) + Len
;
1099 Dir
->RVA
= mDebugOffset
+ sizeof(EFI_IMAGE_DEBUG_DIRECTORY_ENTRY
);
1100 Dir
->FileOffset
= mDebugOffset
+ sizeof(EFI_IMAGE_DEBUG_DIRECTORY_ENTRY
);
1102 Nb10
= (EFI_IMAGE_DEBUG_CODEVIEW_NB10_ENTRY
*)(Dir
+ 1);
1103 Nb10
->Signature
= CODEVIEW_SIGNATURE_NB10
;
1104 strcpy ((char *)(Nb10
+ 1), mInImageName
);
1107 NtHdr
= (EFI_IMAGE_OPTIONAL_HEADER_UNION
*)(mCoffFile
+ mNtHdrOffset
);
1108 DataDir
= &NtHdr
->Pe32Plus
.OptionalHeader
.DataDirectory
[EFI_IMAGE_DIRECTORY_ENTRY_DEBUG
];
1109 DataDir
->VirtualAddress
= mDebugOffset
;
1110 DataDir
->Size
= sizeof(EFI_IMAGE_DEBUG_DIRECTORY_ENTRY
);
1119 EFI_IMAGE_OPTIONAL_HEADER_UNION
*NtHdr
;
1124 NtHdr
= (EFI_IMAGE_OPTIONAL_HEADER_UNION
*)(mCoffFile
+ mNtHdrOffset
);
1125 NtHdr
->Pe32Plus
.OptionalHeader
.SizeOfImage
= mCoffOffset
;
1134 if (mCoffSectionsOffset
!= NULL
) {
1135 free (mCoffSectionsOffset
);