archivemount

ARCHIVEMOUNT(1) General Commands Manual ARCHIVEMOUNT(1)

NAME

   archivemount  mount an archive for access as a filesystem

SYNOPSIS

   archivemount [-hVdf] [-o option[,option]] archive mountpoint

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
   $ archivemount files.tar.gz mnt
   $ ls mnt
   file1           file2
   $ echo zupa > mnt/file3
   $ rm mnt/file1
   $ umount mnt
   $ ls
   files.tar.gz    files.tar.gz.orig       mnt/
   $ tar -tf files.tar.gz
   file2           file3

   $ tar -tf voreutils.tar.gz
   src/            src/
   man/            man/aliases              man/basename.1
   README.md
   $ archivemount -o subtree=man voreutils.tar.gz mnt
   $ ls mnt
   aliases         basename.1

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)

archivemount-ng 1b-1 May 14, 2025 ARCHIVEMOUNT(1)