.mso www.tmac
.TH fusefile 8
.SH NAME
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. 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
variations:
.TP
\fIfilename\fR
include all of the file.
.TP
\fIfilename/\fR
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.
.TP
\fIfilename/from\fR
include the file from the given start position, to end.
.TP
\fIfilename/-to\fR
include the file from beginning to the given end position (not
included).
.TP
\fIfilename/from-to\fR
include the file from the given start position, up to the given end
position (not included).

.SH EXAMPLES

Insert file "y" into file "x" at position 1200:
.RS
\fB$ fusefile -ononempty x x/-1200 y x/1200\fR
.RE
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:
.RS
\fB$ fusefile y x/2442 x/-2442\fR
.RE

.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
remain open, but the source fragments are not recomputed. If a source
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.

.SH AUTHOR

Ralph Rönnquist <ralph.ronnquist@gmail.com>