5b2a2d008f
As per internal discussion, there's no "ChromiumOS Authors" that's meaningful outside the Chromium OS project, so change everything to the contemporary "Google LLC." While at it, also ensure consistency in the LLC variants (exactly one trailing period). "Google Inc" does not need to be touched, so leave them alone. Change-Id: Ia0780e31cdab879d2aaef62a2f0403e3db0a4ac8 Signed-off-by: Patrick Georgi <pgeorgi@google.com> Reviewed-on: https://review.coreboot.org/28756 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Joel Kitching <kitching@google.com>
80 lines
2.5 KiB
C
80 lines
2.5 KiB
C
/*
|
|
* This file is part of the coreboot project.
|
|
*
|
|
* Copyright (C) 2012 Google LLC
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; version 2 of the License.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*/
|
|
#ifndef RMODULE_H
|
|
#define RMODULE_H
|
|
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
#include <string.h>
|
|
#include <commonlib/rmodule-defs.h>
|
|
|
|
enum {
|
|
RMODULE_TYPE_SMM,
|
|
RMODULE_TYPE_SIPI_VECTOR,
|
|
RMODULE_TYPE_STAGE,
|
|
RMODULE_TYPE_VBOOT,
|
|
};
|
|
|
|
struct rmodule;
|
|
|
|
/* Public API for loading rmdoules. */
|
|
int rmodule_parse(void *ptr, struct rmodule *m);
|
|
void *rmodule_parameters(const struct rmodule *m);
|
|
void *rmodule_entry(const struct rmodule *m);
|
|
int rmodule_entry_offset(const struct rmodule *m);
|
|
int rmodule_memory_size(const struct rmodule *m);
|
|
int rmodule_load(void *loc, struct rmodule *m);
|
|
int rmodule_load_alignment(const struct rmodule *m);
|
|
/* rmodule_calc_region() calculates the region size, offset to place an
|
|
* rmodule in memory, and load address offset based off of a region allocator
|
|
* with an alignment of region_alignment. This function helps place an rmodule
|
|
* in the same location in RAM it will run from. The offset to place the
|
|
* rmodule into the region allocated of size region_size is returned. The
|
|
* load_offset is the address to load and relocate the rmodule.
|
|
* region_alignment must be a power of 2. */
|
|
int rmodule_calc_region(unsigned int region_alignment, size_t rmodule_size,
|
|
size_t *region_size, int *load_offset);
|
|
|
|
/* Support for loading rmodule stages. This API is only available when
|
|
* using dynamic cbmem because it uses the dynamic cbmem API to obtain
|
|
* the backing store region for the stage. */
|
|
struct prog;
|
|
|
|
struct rmod_stage_load {
|
|
uint32_t cbmem_id;
|
|
struct prog *prog;
|
|
void *params;
|
|
};
|
|
|
|
/* Both of the following functions return 0 on success, -1 on error. */
|
|
int rmodule_stage_load(struct rmod_stage_load *rsl);
|
|
|
|
struct rmodule {
|
|
void *location;
|
|
struct rmodule_header *header;
|
|
const void *payload;
|
|
int payload_size;
|
|
void *relocations;
|
|
};
|
|
|
|
#if IS_ENABLED(CONFIG_RELOCATABLE_MODULES)
|
|
/* Rmodules have an entry point of named _start. */
|
|
#define RMODULE_ENTRY(entry_) \
|
|
void _start(void *) __attribute__((alias(STRINGIFY(entry_))))
|
|
#else
|
|
#define RMODULE_ENTRY(entry_)
|
|
#endif
|
|
|
|
#endif /* RMODULE_H */
|