3d5135fdd0
The Armv9-A architecture introduces the Memory Tagging Extension (MTE), which uses a dedicated memory region for tag storage. This patch adds a new memory type, BM_MEM_TAG, to allow for the proper accounting and reservation of this memory region. This ensures that the payload, e.g. depthcharge, can correctly identify and utilize the tag storage area. BUG=b:438666196 Change-Id: I2f6d2b3c2c1a8e1f0e9b2c3d4e5f6a7b8c9d0e1f Signed-off-by: Yidi Lin <yidilin@google.com> Reviewed-on: https://review.coreboot.org/c/coreboot/+/90470 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Yu-Ping Wu <yupingso@google.com>
117 lines
4.4 KiB
C
117 lines
4.4 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
|
|
#ifndef BOOTMEM_H
|
|
#define BOOTMEM_H
|
|
|
|
#include <boot/coreboot_tables.h>
|
|
#include <memrange.h>
|
|
#include <types.h>
|
|
|
|
/**
|
|
* Bootmem types match to LB_MEM tags, except for the following:
|
|
* BM_MEM_RAMSTAGE : Memory where any kind of boot firmware resides and that
|
|
* should not be touched by bootmem (by example: stack,
|
|
* TTB, program, ...).
|
|
* BM_MEM_PAYLOAD : Memory where any kind of payload resides and that should
|
|
* not be touched by bootmem.
|
|
* Start at 0x10000 to make sure that the caller doesn't provide LB_MEM tags.
|
|
*/
|
|
enum bootmem_type {
|
|
BM_MEM_INVALID = 0, /* Invalid type (used in optional arguments). */
|
|
|
|
BM_MEM_FIRST = 0x10000, /* First entry in this list */
|
|
BM_MEM_RAM, /* Memory anyone can use */
|
|
BM_MEM_RESERVED, /* Don't use this memory region */
|
|
BM_MEM_SOFT_RESERVED, /* Specific purpose memory */
|
|
BM_MEM_ACPI, /* ACPI Tables */
|
|
BM_MEM_NVS, /* ACPI NVS Memory */
|
|
BM_MEM_UNUSABLE, /* Unusable address space */
|
|
BM_MEM_VENDOR_RSVD, /* Vendor Reserved */
|
|
BM_MEM_OPENSBI, /* Risc-V OpenSBI */
|
|
BM_MEM_BL31, /* Arm64 BL31 executable */
|
|
BM_MEM_TAG, /* Armv9-A tag storage for MTE */
|
|
BM_MEM_TABLE, /* Ram configuration tables are kept in */
|
|
/* Tags below this point are ignored for the OS table. */
|
|
BM_MEM_OS_CUTOFF = BM_MEM_TABLE,
|
|
BM_MEM_RAMSTAGE,
|
|
BM_MEM_PAYLOAD,
|
|
BM_MEM_LAST, /* Last entry in this list */
|
|
};
|
|
|
|
/**
|
|
* Write memory coreboot table. Current resource map is serialized into
|
|
* memtable (LB_MEM_* types). bootmem library is unusable until this function
|
|
* is called first in the write tables path before payload is loaded.
|
|
*
|
|
* Bootmem types match to LB_MEM tags, except for the following:
|
|
* BM_MEM_RAMSTAGE : Translates to LB_MEM_RAM.
|
|
* BM_MEM_PAYLOAD : Translates to LB_MEM_RAM.
|
|
* BM_MEM_BL31 : Translates to LB_MEM_RESERVED.
|
|
* BM_MEM_OPENSBI : Translates to LB_MEM_RESERVED.
|
|
*/
|
|
void bootmem_write_memory_table(struct lb_memory *mem);
|
|
|
|
/* Architecture hook to add bootmem areas the architecture controls when
|
|
* bootmem_write_memory_table() is called. */
|
|
void bootmem_arch_add_ranges(void);
|
|
|
|
/* Platform hook to add bootmem areas the platform / board controls. */
|
|
void bootmem_platform_add_ranges(void);
|
|
|
|
/* Add a range of a given type to the bootmem address space. */
|
|
void bootmem_add_range(uint64_t start, uint64_t size,
|
|
const enum bootmem_type tag);
|
|
|
|
/*
|
|
* bootmem_add_range_from - Add a memory range of a specific type from another range
|
|
* @start: Start address of the new memory range
|
|
* @size: Size of the new memory range
|
|
* @new_tag: The new bootmem_type for the range
|
|
* @from_tag: The bootmem_type from which the new range should be carved out
|
|
*
|
|
* This function adds a memory range with `new_tag` only if it is fully
|
|
* contained within an existing range of `from_tag`. This is useful for
|
|
* carving out specific memory regions from a larger, already defined area.
|
|
*
|
|
* Return: 0 on success, or a negative error code on failure.
|
|
*/
|
|
int bootmem_add_range_from(uint64_t start, uint64_t size, const enum bootmem_type new_tag,
|
|
const enum bootmem_type from_tag);
|
|
|
|
/* Print current range map of boot memory. */
|
|
void bootmem_dump_ranges(void);
|
|
|
|
typedef bool (*range_action_t)(const struct range_entry *r, void *arg);
|
|
|
|
/**
|
|
* Walk memory tables from OS point of view and call the provided function,
|
|
* for every region. The caller has to return false to break out of the loop any
|
|
* time, or return true to continue.
|
|
*
|
|
* @param action The function to call for each memory range.
|
|
* @param arg Pointer passed to function @action. Set to NULL if unused.
|
|
* @return true if the function 'action' returned false.
|
|
*/
|
|
bool bootmem_walk_os_mem(range_action_t action, void *arg);
|
|
|
|
/**
|
|
* Walk memory tables and call the provided function, for every region.
|
|
* The caller has to return false to break out of the loop any time, or
|
|
* return true to continue.
|
|
*
|
|
* @param action The function to call for each memory range.
|
|
* @param arg Pointer passed to function @action. Set to NULL if unused.
|
|
* @return true if the function 'action' returned false.
|
|
*/
|
|
bool bootmem_walk(range_action_t action, void *arg);
|
|
|
|
/* Returns 1 if the requested memory range is all tagged as type dest_type.
|
|
* Otherwise returns 0.
|
|
*/
|
|
int bootmem_region_targets_type(uint64_t start, uint64_t size,
|
|
enum bootmem_type dest_type);
|
|
|
|
/* Allocate a temporary buffer from the unused RAM areas. */
|
|
void *bootmem_allocate_buffer(size_t size);
|
|
|
|
#endif /* BOOTMEM_H */
|