added
authorRalph Ronnquist <ralph.ronnquist@gmail.com>
Mon, 11 Mar 2019 03:14:15 +0000 (14:14 +1100)
committerRalph Ronnquist <ralph.ronnquist@gmail.com>
Mon, 11 Mar 2019 03:14:15 +0000 (14:14 +1100)
README.md [new file with mode: 0644]

diff --git a/README.md b/README.md
new file mode 100644 (file)
index 0000000..0828e87
--- /dev/null
+++ b/README.md
@@ -0,0 +1,56 @@
+fusefile
+========
+FUSE file mount for combining file fragments read-only.
+## SYNOPSIS
+ **fusefile** [__fuse options__] **mountpoint** __filename/from-to__ ...
+
+## DESCRIPTION
+
+**fusefile** is FUSE file mount that presents a series of fragments of
+other files as a contiguous concatenation. It bind mounts a driver on
+top of the file mountpoint to present the nominated file fragments as
+a single, contiguous file.
+
+The fragment arguments include the filename of a source file, and
+optionally start and end byte positions. All in all there five
+variations:
+
+ * __filename__ include all of the file.
+
+ * __filename/__ include all of the file named with "/" in the pathname. This case requires a final "/", since the last "/" separates the filename from the position details.
+
+ * __filename/from__ include the file from the given start position, to end.
+
+ * __filename/-to__ include the file from beginning to the given end position (not included).
+
+ * __filename/from-to__ include the file from the given start position, up to the given end position (not included). 
+
+## EXAMPLES
+
+Insert file "y" into file "x" at position 1200:
+  
+    $ fusefile -ononempty x x/-1200 y x/1200
+The bind mount shadows the original file "x", and presents the
+composite instead.
+
+Make file y be a swap of the beginning and end of file "x", at
+position 2442:
+
+    $ fusefile y x/2442 x/-2442
+
+## NOTES
+
+Note that **fusefile** opens the nominated source file(s) before bind
+mounting. With the fuse option __-ononempty__ it will bind over an
+non-empty file, which may be useful. The source file descriptors
+remain open, but the source fragments are not recomputed. If a source
+file changes or reduces in size, anything may happen.
+
+If the mountpoint file doesn't exist, then **fusefile** creates it,
+and removes it when unmounted.
+
+## AUTHOR
+
+Ralph Rönnquist <ralph.ronnquist@gmail.com>