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 */
 |