update for writability
authorRalph Ronnquist <ralph.ronnquist@gmail.com>
Sat, 16 Jul 2022 10:12:25 +0000 (20:12 +1000)
committerRalph Ronnquist <ralph.ronnquist@gmail.com>
Sat, 16 Jul 2022 10:12:25 +0000 (20:12 +1000)
fusefile.8

index 5dba7e47ea60b6476cff4d7f10761f0d3fbb130e..e2577c195a4073653d7b64a8eb1481177f7a1ad9 100644 (file)
@@ -1,17 +1,19 @@
 .mso www.tmac
 .TH fusefile 8
 .SH NAME
-fusefile \- FUSE file mount for combining file fragments read-only
+fusefile \- FUSE file mount for combining file fragments
 
 .SH SYNOPSIS
 .B fusefile \fR[fuse options\fR] \fBmountpoint\fR \fIfilename/from-to\fR ...
 
 .SH DESCRIPTION
 
-\fBfusefile\fR 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.
+\fBfusefile\fR 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. It accepts over-writing on the fused
+file which gets distributed accordingly to the fragments, but cannot
+change size.
 
 The fragment arguments include the filename of a source file, and
 optionally start and end byte positions. All in all there five
@@ -52,11 +54,12 @@ Make file y be a swap of the beginning and end of file "x", at position 2442:
 
 .SH NOTES
 
-Note that \fBfusefile\fR opens the nominated source file(s) before bind
-mounting. With the fuse option \fI-ononempty\fR it will bind over an
-non-empty file, which may be useful. The source file descriptors
+Note that \fBfusefile\fR opens the nominated source file(s) before
+bind mounting. With the fuse option \fI-ononempty\fR 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.
+file changes the fused file will present the new content. If a source
+is reduced in size, access will be inconsistent.
 
 If the mountpoint file doesn't exist, then \fBfusefile\fR creates it,
 and removes it when unmounted.