NAME¶

archivemount — mount an archive for access as a filesystem

SYNOPSIS¶

DESCRIPTION¶

Mounts, through fuse(8), a file tree contained in archive on directory mountpoint. umount and fusermount -u can undo this mapping.

EXAMPLES¶

$ ls
files.tar.gz    mnt/
$ tar -tf files.tar.gz
file1           file2
$ 

$ tar -tf voreutils.tar.gz
src/            src/…
man/            man/aliases              man/basename.1
README.md
$ 

OPTIONS¶

See fuse(8) for a complete list of the baseline FUSE options supported. The following options are handled specially by archivemount:

-h, --help

Write usage and all available options to standard error stream, then exit.

-V, --version

Write version of archivemount, libarchive, and FUSE to the standard output stream, then exit.

-r, -o ro, -o readonly: Disable writes entirely.

 

-o password

Prompt for archive passphrase.

-o nobackup

When saving writes, the original archive is moved to "archive.orig". This flag removes that file afterward.

-o nosave

Allow writes in memory, but don't actually write them out on unmount.

-o subtree=regex

Hide files not matching regex, and on those that do match, remove the matched prefix (cf. second example above). regex is a basic regular expression that behaves as-if prepended with the equivalent of "^.?". Implies -r.

-o formatraw

archive is actually a compressed file, made available under mounpoint/saved-filename or mounpoint/data. Implies -r.

BUGS¶

Writing archives, probably.

ARCHIVE FORMATS¶

See libarchive(3) for a definitive list, but all kinds of tar/ustar/pax/cpio archives, 7-Zip, ISO9660, ar, and RAR/Zip may be read. These may be compressed with gzip(1), xz(1), zstd(1), &c. and are processed transparently. The same applies for writing (except you can't write RARs).

SEE ALSO¶

fusermount(1), libarchive(3), regex(7), fuse(8), umount(8)