From dfef3c51c5890f62d0bffa228942087a7975eefd Mon Sep 17 00:00:00 2001
From: Ralph Ronnquist <ralph.ronnquist@gmail.com>
Date: Sun, 3 Apr 2022 22:01:47 +1000
Subject: [PATCH] added man page for diskfile

---
 overlay-diskfile.8.adoc | 78 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 overlay-diskfile.8.adoc

diff --git a/overlay-diskfile.8.adoc b/overlay-diskfile.8.adoc
new file mode 100644
index 0000000..8f39cbb
--- /dev/null
+++ b/overlay-diskfile.8.adoc
@@ -0,0 +1,78 @@
+overlay-diskfile(8)
+===================
+:doctype: manpage
+:revdate: {sys:date "+%Y-%m-%d %H:%M:%S"}
+:COLON: :
+:EQUALS: =
+
+NAME
+----
+overlay-diskfile - Support for using diskfile filesystem.
+
+SYNOPSIS
+--------
+LOWER=!*overlay-diskfile* _mount/path_ [ _diskfile_ [ _index_ ] ]
+UPPER=!*overlay-diskfile* _mount/path_ [ _diskfile_ [ _index_ ] ]
+
+DESCRIPTION
+-----------
+
+*overlay-diskfile* is a support script for pre-mounting a diskfile to
+provide the LOWER or UPPER filesystem for a subhost. It is typically
+used in the subhost configuration to be invoked as part of determining
+the filesystem path.
+
+OPTIONS
+-------
+
+no options.
+
+EXAMPLES
+--------
+
+.Use a whole diskfile filesystem as LOWER
+====
+----
+LOWER=!overlay-diskfile mnt/ disk.img
+----
+====
+
+The above mounts the disk.img filesystem onto +mnt+ and provides that
+as the LOWER filesystem.
+
+.Use a diskfile partition 2 as LOWER
+====
+----
+LOWER=!overlay-diskfile mnt/ disk.img 2
+----
+====
+
+The above mounts the second partition onto +mnt+ and provides that as
+the LOWER filesystem.
+
+.Use a subtree of a diskfile partition 2 as LOWER
+====
+----
+LOWER=!overlay-diskfile mnt/some/path disk.img 2
+----
+====
+
+The above mounts the second partition onto +mnt+ and provides the path
++mnt/some/path+ that as the LOWER filesystem.
+
+.Use a while diskfile as UPPER and WORK.
+====
+----
+UPPER=!overlay-diskfile mnt/some/upper/path disk.img 2
+WORK= mnt/some/work/path
+----
+====
+
+The above mounts the second partition of disk.img and uses
++mnt/some/upper/path+ as UPPER and +mnt/some/work/path+ as WORK.
+
+
+SEE ALSO
+--------
+
+*overlay-boot*, *overlay-stop*
-- 
2.39.2