summaryrefslogtreecommitdiff
path: root/Documentation/rmodules.md
diff options
context:
space:
mode:
authorNicholas Chin <nic.c3.14@gmail.com>2024-09-06 21:54:08 -0600
committerNico Huber <nico.h@gmx.de>2024-09-09 21:09:02 +0000
commit26f5b5f3d060c726b695d84625316aad4bf255be (patch)
treeb7ee639831f9551ebce4511b346b091ecff7d9ff /Documentation/rmodules.md
parentf79a50a655a3a48bbdb7a13fb6e80a48a7ad8a88 (diff)
Doc/rmodules.md: Change header levels
Increase the header levels of headers following the initial "Relocatable Modules (rmodules)" so that there is only one title for the page with the other headings as subheadings. Also fix header capitalization while we're here. Change-Id: I72ae99ba10bf5b2386da2cc702efaf25328d6811 Signed-off-by: Nicholas Chin <nic.c3.14@gmail.com> Reviewed-on: https://review.coreboot.org/c/coreboot/+/84239 Reviewed-by: Nico Huber <nico.h@gmx.de> Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Diffstat (limited to 'Documentation/rmodules.md')
-rw-r--r--Documentation/rmodules.md10
1 files changed, 5 insertions, 5 deletions
diff --git a/Documentation/rmodules.md b/Documentation/rmodules.md
index 520d184ddc..8a707b8a54 100644
--- a/Documentation/rmodules.md
+++ b/Documentation/rmodules.md
@@ -15,9 +15,9 @@ done by fixing up all relocation entries in the relocatable module
based on the location of the binary (which was returned by CBMEM
at runtime).
-# Implementation Details
+## Implementation Details
-## build time
+### Build Time
At build time the rmodtool (util/cbfstool/rmodtool.c) is used to
create relocatable modules. The rmodtool basically takes an ELF
@@ -44,7 +44,7 @@ which are all created by the rmodtool.
2. program (.program)
3. relocation entries (.relocs)
-## runtime
+### Runtime
Either rmodule\_load (lib/rmodule.c) is used directly or through the
rmodule\_stage\_load (lib/rmodule.c) wrapper. It is used to load the
@@ -59,7 +59,7 @@ address pointing to a location that needs relocation. The relocation
itself is just a simple addition, that adds an offset from where the
image was "supposed" to be at link time, to where it is now relocated.
-## module\_parameters
+### module\_parameters
module\_parameters is a section inside the rmodule ELF file. Its
basically a way to pass runtime information to an rmodule
@@ -73,7 +73,7 @@ volatile __attribute((aligned(4), __section__(".module_parameters")))
struct smm_runtime smm_runtime;
```
-# x86 why rmodules
+## x86 why rmodules
//TODO
x86: postcar and ramstage cannot conflict with payload regarding
memory placement. Therefore payload location is usually fixed and