From 438c379b9ce4c6a6e4da445c3bf7f94458b1c816 Mon Sep 17 00:00:00 2001 From: Miquel Sabaté Solà Date: Mon, 21 Sep 2026 21:36:32 +0200 Subject: nasm: add documentation for --split-segments MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Miquel Sabaté Solà --- crates/nasm/README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/crates/nasm/README.md b/crates/nasm/README.md index 78cea2c..42ae5b2 100644 --- a/crates/nasm/README.md +++ b/crates/nasm/README.md @@ -549,3 +549,15 @@ this flag on if PRG RAM is available. If there are memory accesses to PRG RAM but the programmer did not advertise that on the header flag, then `nasm` will error out as it cannot assume that these accesses are valid. This check will happen regardless of the `-a/--asan` flag. + +## Splitting segments + +You can also tell `nasm` to split each segment into its own file. This can be +nice if you are debugging the resulting binary for some specific segments, or +you want to further manipulate them individually. For that there is the +`--split-segments` option. Use that and then a file `.out` will be +created for each segment. + +If you want to have these files into a specific directory, you can combine this +option with `-o/--out`. This time, `-o/--out` assumes that the given path is the +directory where each segment file should be placed in. -- cgit v1.2.3