various corrections
[rrq/fusefile.git] / fusefile.8
index 5dba7e47ea60b6476cff4d7f10761f0d3fbb130e..7051d94aa5277aee40ce2bf6070d685f5e5e5eb0 100644 (file)
@@ -35,6 +35,15 @@ included).
 \fIfilename/from-to\fR
 include the file from the given start position, up to the given end
 position (not included).
 \fIfilename/from-to\fR
 include the file from the given start position, up to the given end
 position (not included).
+.TP
+\fBpad=\fIfilename\fR
+
+when this is given as first argument, the fused file is set up as a
+writable random-access file, where the write events are captured
+appended to the nominated "pad" file. The new content is inserted into
+the fused file but not the original files, and fragments are split up
+and adjusted as needed so as to make the write events appear as
+insertions inteo the fused file.
 
 .SH EXAMPLES
 
 
 .SH EXAMPLES
 
@@ -61,6 +70,12 @@ file changes or reduces in size, anything may happen.
 If the mountpoint file doesn't exist, then \fBfusefile\fR creates it,
 and removes it when unmounted.
 
 If the mountpoint file doesn't exist, then \fBfusefile\fR creates it,
 and removes it when unmounted.
 
+When a "pad" file is used, it is updated as an "ar" archive where each
+write event is a new member appended at the end. The "pad" member has
+two additional, newline-terminated text lines with the insertion
+position and the member size (ascii decimal digits), before the actual
+insertion event content.
+
 .SH AUTHOR
 
 Ralph Rönnquist <ralph.ronnquist@gmail.com>
 .SH AUTHOR
 
 Ralph Rönnquist <ralph.ronnquist@gmail.com>