From 65ae35024a360a568e3a84b3e4d94859e0757c33 Mon Sep 17 00:00:00 2001
From: Boof <97455552+hexahigh@users.noreply.github.com>
Date: Thu, 27 Mar 2025 15:06:00 +0100
Subject: [PATCH] Update README.md

---
 README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.md b/README.md
index 88e20ee7..31a48f62 100644
--- a/README.md
+++ b/README.md
@@ -2519,6 +2519,18 @@ namely `compress` for compression, `scanner` for scanning, `ordering` for
 input ordering, and `blockify` for segmenting. `blockify` is what you would
 typically want to run on your "performance" cores.
 
+### Specifying file system offset and size
+
+You can specify the byte offset at which the filesystem is located in the file using the `-o offset=N` option.
+This can be useful when mounting images where there is some preceding data before the filesystem or when mounting merged/concatenated images.
+When combined with the `-o imagesize=N` option you can mount merged filesystems, i.e. multiple filesystems stored in a single file.
+
+Here is an example, you have two filesystems concatenated into a single file and you want to mount both of them, you can achieve this by running
+```sh
+dwarfs merged.dwarfs /mnt/fs1 -oimagesize=9231
+dwarfs merged.dwarfs /mnt/fs2 -ooffset=9231,imagesize=7999
+```
+
 ## Stargazers over Time
 
 [![Stargazers over Time](https://starchart.cc/mhx/dwarfs.svg?variant=adaptive)](https://starchart.cc/mhx/dwarfs)