For x86 eXecute-In-Place (XIP) pre-memory `.data` section support, we
have to use an extra segment as the VMA/LMA of the data is different
than the VMA/LMA of the code.
To support this requirement, this patch makes cbfstool:
1. Allow the load of an ELF with an extra segment
2. Makes add-stage for XIP (cf. parse_elf_to_xip_stage()) write its
   content to the output binary.
To prevent the creation of unsuitable binaries, cbfstool verifies that
the LMA addresses of the segments are consecutives.
TEST=XIP pre-memory stages with a `.data` section have the `.data`
     section covered by a second segment properly included right after
     the code.
Change-Id: I480b4b047546c8aa4e12dfb688e0299f80283234
Signed-off-by: Jeremy Compostella <jeremy.compostella@intel.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/77584
Reviewed-by: Julius Werner <jwerner@chromium.org>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
		
	
		
			
				
	
	
		
			88 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			88 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /* SPDX-License-Identifier: GPL-2.0-only */
 | |
| 
 | |
| #ifndef TOOL_RMODULE_H
 | |
| #define TOOL_RMODULE_H
 | |
| 
 | |
| #include "elfparsing.h"
 | |
| #include "common.h"
 | |
| 
 | |
| struct arch_ops {
 | |
| 	int arch;
 | |
| 	/* Determine if relocation is a valid type for the architecture. */
 | |
| 	int (*valid_type)(Elf64_Rela *rel);
 | |
| 	/* Determine if relocation should be emitted. */
 | |
| 	int (*should_emit)(Elf64_Rela *rel);
 | |
| };
 | |
| 
 | |
| /*
 | |
|  * The fields in rmod_context are read-only to the user. These are
 | |
|  * exposed for easy shareability.
 | |
|  */
 | |
| struct rmod_context {
 | |
| 	/* Ops to process relocations. */
 | |
| 	const struct arch_ops *ops;
 | |
| 
 | |
| 	/* endian conversion ops */
 | |
| 	struct xdr *xdr;
 | |
| 
 | |
| 	/* Parsed ELF structure. */
 | |
| 	struct parsed_elf pelf;
 | |
| 	/* Program segment. */
 | |
| 	Elf64_Phdr *phdr;
 | |
| 	/* Number of loadable segments. */
 | |
| 	size_t nsegments;
 | |
| 	/* Symbol string table. */
 | |
| 	char *strtab;
 | |
| 
 | |
| 	/* Collection of relocation addresses fixup in the module. */
 | |
| 	Elf64_Xword nrelocs;
 | |
| 	Elf64_Addr *emitted_relocs;
 | |
| 
 | |
| 	/* The following fields are addresses within the linked program.  */
 | |
| 	Elf64_Addr parameters_begin;
 | |
| 	Elf64_Addr parameters_end;
 | |
| 	Elf64_Addr bss_begin;
 | |
| 	Elf64_Addr bss_end;
 | |
| };
 | |
| 
 | |
| struct reloc_filter {
 | |
| 	/* Return < 0 on error. 0 to ignore relocation and 1 to include
 | |
| 	 * relocation. */
 | |
| 	int (*filter)(struct reloc_filter *f, const Elf64_Rela *r);
 | |
| 	/* Pointer for filter provides */
 | |
| 	void *context;
 | |
| };
 | |
| 
 | |
| /*
 | |
|  * Parse an ELF file within the elfin buffer and fill in the elfout buffer
 | |
|  * with a created rmodule in ELF format. Return 0 on success, < 0 on error.
 | |
|  */
 | |
| int rmodule_create(const struct buffer *elfin, struct buffer *elfout);
 | |
| 
 | |
| /*
 | |
|  * Initialize an rmodule context from an ELF buffer. Returns 0 on scucess, < 0
 | |
|  * on error.
 | |
|  */
 | |
| int rmodule_init(struct rmod_context *ctx, const struct buffer *elfin);
 | |
| 
 | |
| /*
 | |
|  * Collect all the relocations that apply to the program in
 | |
|  * nrelocs/emitted_relocs. One can optionally provide a reloc_filter object
 | |
|  * to help in relocation filtering. The filter function will be called twice:
 | |
|  * once for counting and once for emitting. The same response should be
 | |
|  * provided for each call. Returns 0 on success, < 0 on error.
 | |
|  */
 | |
| int rmodule_collect_relocations(struct rmod_context *c, struct reloc_filter *f);
 | |
| 
 | |
| /* Clean up the memory consumed by the rmodule context. */
 | |
| void rmodule_cleanup(struct rmod_context *ctx);
 | |
| 
 | |
| /*
 | |
|  * Create an ELF file from the passed in rmodule in the buffer. The buffer
 | |
|  * contents will be replaced with an ELF file. Returns 1 if buff doesn't
 | |
|  * contain an rmodule and < 0 on failure, 0 on success.
 | |
|  */
 | |
| int rmodule_stage_to_elf(Elf64_Ehdr *ehdr, struct buffer *buff);
 | |
| 
 | |
| #endif /* TOOL_RMODULE_H */
 |