1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
|
.\" SPDX-License-Identifier: LGPL-2.0-or-later
.\"
.Dd
.Dt ARCHIVEMOUNT 1
.Os
.
.Sh NAME
.Nm archivemount
.Nd mount an archive for access as a filesystem
.Sh SYNOPSIS
.Nm
.Op Fl hVdf
.Oo Fl o Ar option Ns Oo , Ns Ar option Oc Ns … Oc Ns …
.Ar archive
.Ar mountpoint
.
.Sh DESCRIPTION
Mounts, through
.Xr fuse 8 ,
a file tree contained in
.Ar archive
on directory
.Ar mountpoint .
.ie t .br
.Nm umount
and
.Nm fusermount Fl u
can undo this mapping.
.
.Sh EXAMPLES
.ie t \{ .
.mk
.Bd -literal -compact -offset 42n
.Li $ Nm tar Fl tf Pa voreutils.tar.gz
src/ src/…
man/ man/aliases man/basename.1
README.md
.Li $ Nm Fl o Cm subtree Ns = Ns Ar man Li \e
.Li " " " " Pa voreutils.tar.gz mnt
.Li $ Nm ls Pa mnt
aliases basename.1 …
.Ed
.rt
.Bd -literal -compact
.Li $ Nm ls
files.tar.gz mnt/
.Li $ Nm tar Fl tf Pa files.tar.gz
file1 file2
.Li $ Nm Pa files.tar.gz mnt
.Li $ Nm ls Pa mnt
file1 file2
.Li $ Ic echo Li zupa > Pa mnt/file3
.Li $ Nm rm Pa mnt/file1
.Li $ Nm umount Pa mnt
.Li $ Nm ls
files.tar.gz files.tar.gz.orig mnt/
.Li $ Nm tar Fl tf Pa files.tar.gz
file2 file3
.Ed
. \}
.el \{ .
.Bd -literal -compact
.Li $ Nm ls
files.tar.gz mnt/
.Li $ Nm tar Fl tf Pa files.tar.gz
file1 file2
.Li $ Nm Pa files.tar.gz mnt
.Li $ Nm ls mnt
file1 file2
.Li $ Ic echo Li zupa > Pa mnt/file3
.Li $ Nm rm Pa mnt/file1
.Li $ Nm umount Pa mnt
.Li $ Nm ls
files.tar.gz files.tar.gz.orig mnt/
.Li $ Nm tar Fl tf Pa files.tar.gz
file2 file3
.Ed
.Pp
.Bd -literal -compact
.Li $ Nm tar Fl tf Pa voreutils.tar.gz
src/ src/…
man/ man/aliases man/basename.1
README.md
.Li $ Nm Fl o Cm subtree Ns = Ns Ar man Pa voreutils.tar.gz mnt
.Li $ Nm ls Pa mnt
aliases basename.1
.Ed
. \}
.
.Sh OPTIONS
See
.Xr fuse 8
for a complete list of the baseline FUSE options supported.
.if t .br
The following options are handled specially by
.Nm :
.Bl -tag -compact -width ".Fl o Cm subtree Ns = Ns Ar regex"
.It Fl h , -help
Write usage and all available options to standard error stream, then exit.
.
.It Fl V , -version
Write version of
.Nm ,
libarchive,
and FUSE to the standard output stream, then exit.
.Pp
.
.It Fl r , Fl o Cm ro , Fl o Cm readonly Ns : Disable writes entirely.
.
.It Fl o Cm password
Prompt for archive passphrase.
.
.It Fl o Cm nobackup
When saving writes, the original
.Ar archive
is moved to
.Qq Ar archive Ns Li .orig .
This flag removes that file afterward.
.
.It Fl o Cm nosave
Allow writes in memory, but don't actually write them out on unmount.
.Pp
.
.It Fl o Cm subtree Ns = Ns Ar regex
Hide files not matching
.Ar regex ,
and on those that do match, remove the matched prefix (cf. second example above).
.Ar regex
is a basic regular expression that behaves as-if prepended with the equivalent of
.Qq Li ^.? .
Implies
.Fl r .
.
.It Fl o Cm formatraw
.Ar archive
is actually a compressed file, made available under
.Ar mounpoint Ns Pa / Ns Ar saved-filename
or
.Ar mounpoint Ns Pa /data .
Implies
.Fl r .
.El
.
.Sh BUGS
Writing archives, probably.
.
.Sh ARCHIVE FORMATS
See
.Xr libarchive 3
for a definitive list, but
all kinds of
.Nm tar Ns / Ns No ustar Ns / Ns Nm pax Ns / Ns Nm cpio
archives, 7-Zip, ISO9660,
.Nm ar ,
and RAR/Zip may be read.
These may be compressed with
.Xr gzip 1 ,
.Xr xz 1 ,
.Xr zstd 1 ,
&c. and are processed transparently.
The same applies for writing (except you can't write RARs).
.
.Sh SEE ALSO
.Xr fusermount 1 ,
.Xr libarchive 3 ,
.Xr regex 7 ,
.Xr fuse 8 ,
.Xr umount 8
|
