From: Ralph Ronnquist Date: Sat, 16 Jul 2022 10:12:25 +0000 (+1000) Subject: update for writability X-Git-Tag: 0.4~7 X-Git-Url: https://git.rrq.au/?a=commitdiff_plain;h=5e65b7ecf2c54b600c5d98f06031ecf62e5a6cec;p=rrq%2Ffusefile.git update for writability --- diff --git a/fusefile.8 b/fusefile.8 index 5dba7e4..e2577c1 100644 --- a/fusefile.8 +++ b/fusefile.8 @@ -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.