summaryrefslogtreecommitdiff
path: root/tools/com-plugin/README.md
diff options
context:
space:
mode:
authorTharo <tharo10600@gmail.com>2026-05-06 22:33:03 +0100
committerGitHub <noreply@github.com>2026-05-06 23:33:03 +0200
commit2c481eaeebcfe2d78efa305d3e1b908100bebf14 (patch)
treef06c98329359fc04189040eeb3e056c150dd47ee /tools/com-plugin/README.md
parent70701b8ac9b5f41a2cc71a8ce59a211c137aa298 (diff)
Partial linking of spec segments (#2661)
* Partial linking of overlay segments, relax linker script alignment * Partial linking of all spec segments * Fix update, remove _RomPos from linker script * iQue version working pending COM-plugin update * Add plf map file resolution to sym_info.py, local symbol merging is broken * git subrepo pull tools/com-plugin subrepo: subdir: "tools/com-plugin" merged: "c4f3ba845" upstream: origin: "git@github.com:Thar0/com-plugin.git" branch: "main" commit: "c4f3ba845" git-subrepo: version: "0.4.6" origin: "https://github.com/ingydotnet/git-subrepo" commit: "110b9eb" * Make tools compatible with partial linking Co-authored-by: Anghelo Carvajal <angheloalf95@gmail.com> * Remove unused files * Fix some makefile bits * mkspecrules cleanup * Comment on the makerom linker layout in mkldscript * Revert linker padding strategy back to pad_text spec directives * Comment on objcopy elf -> rom step * Adjust tool descriptions * Fix compressed builds * rm reloc_prereq, no longer used * Makefile merge fix Co-authored-by: Dragorn421 <Dragorn421@users.noreply.github.com> --------- Co-authored-by: Anghelo Carvajal <angheloalf95@gmail.com> Co-authored-by: Dragorn421 <Dragorn421@users.noreply.github.com>
Diffstat (limited to 'tools/com-plugin/README.md')
-rw-r--r--tools/com-plugin/README.md2
1 files changed, 2 insertions, 0 deletions
diff --git a/tools/com-plugin/README.md b/tools/com-plugin/README.md
index 1db9e481e..923e67c05 100644
--- a/tools/com-plugin/README.md
+++ b/tools/com-plugin/README.md
@@ -10,6 +10,8 @@ The plugin expects a symbol order txt file listing the COMMON symbols in order o
Add `-plugin common-plugin.so -plugin-opt order=bss_order.txt` to the linker invocation, replacing `bss_order.txt` with an alternative path if desired.
+An optional argument `-plugin-opt min_align=N` can specify the minimum alignment for the bss output files. If unset, the minimum alignment is 0: the resulting section alignment is equal to the minimum alignment required by the symbols.
+
Also add any bss output files mentioned in the order file to the linker script (e.g. `bss.o` would be added as `*bss.o(.bss*)`) so that the additional input file is not discarded, if required.
### **Symbol order file syntax**