1ARCHIVEMOUNT(1) User Commands ARCHIVEMOUNT(1)
3
7 archivemount - mounts an archive for access as a file system
8
10 archivemount [-hVdfs] [-o options] archivepath mountpoint
11
13 The archivemount command mounts the file tree contained in the archive
14 archivepath on the directory mountpoint. The archive's contents can
15 subsequently be accessed inside mountpoint as a file system. The
16 umount(8) command performs the corresponding unmount operation.
17 archivemount is known to work under both linux and Mac OS X (via Mac‐
19 FUSE).
20
24 Consider the gzipped tar archive ``files.tgz'' containing files
25 ``file1'' and ``file2'', and an empty directory ``mnt''.
26 $ ls
28 files.tgz mnt/
29 $ archivemount files.tgz mnt
31 $ ls mnt
33 file1 file2
34 [... Perform desired read/write operations on the archive via mnt/ ...]
36 $ umount mnt
38 [... Any changes are saved to the archive ...]
40
43 Archive format support is provided by the libarchive(3) library. Read
44 operations are supported for:
45 · old-style tar archives,
47 · most variants of the POSIX ``ustar'' format,
49 · the POSIX ``pax interchange'' format,
51 · GNU-format tar archives,
53 · most common cpio archive formats,
55 · ISO9660 CD images (with or without RockRidge extensions),
57 · Zip archives.
59 Archives compressed with gzip(1), bzip2(1), or compress(1) are automat‐
61 ically detected and transparently decompressed.
62 The following formats can be written:
64 · POSIX-standard ``ustar'' archives,
66 · POSIX ``pax interchange format'' archives,
68 · POSIX octet-oriented cpio archives,
70 · two different variants of shar archives.
72 Before writing, the original archive is renamed with a ``.orig'' exten‐
74 sion appended to it. More detail about the read/write support can be
75 found in the libarchive(3) documentation.
76
80 archivemount is built upon the FUSE (Filesystem in Userspace) library,
81 and the complete set of available options depends upon the specific
82 FUSE implementation. Execute archivemount -h to retrieve a definitive
83 list.
84 general options
87 -o opt,[opt...]
88 mount options
89 -h --help
91 print help
92 -V --version
94 print version
95 archivemount mount options
98 -o readonly
99 disable write support
100 -o nobackup
102 remove archive file backups
103 FUSE mount options
106 These options are available to linux users using standard FUSE.
107 -d -o debug
110 enable debug output (implies -f)
111 -f foreground operation
113 -s disable multi-threaded operation
115 -o allow_other
117 allow access to other users
118 -o allow_root
120 allow access to root
121 -o nonempty
123 allow mounts over non-empty file/dir
124 -o default_permissions enable permission checking by kernel
126 -o fsname=NAME
128 set filesystem name
129 -o subtype=NAME
131 set filesystem type
132 -o large_read
134 issue large read requests (2.4 only)
135 -o max_read=N
137 set maximum size of read requests
138 -o hard_remove
140 immediate removal (don't hide files)
141 -o use_ino
143 let filesystem set inode numbers
144 -o readdir_ino
146 try to fill in d_ino in readdir
147 -o direct_io
149 use direct I/O
150 -o kernel_cache
152 cache files in kernel
153 -o [no]auto_cache
155 enable caching based on modification times
156 -o umask=M
158 set file permissions (octal)
159 -o uid=N
161 set file owner
162 -o gid=N
164 set file group
165 -o entry_timeout=T
167 cache timeout for names (1.0s)
168 -o negative_timeout=T
170 cache timeout for deleted names (0.0s)
171 -o attr_timeout=T
173 cache timeout for attributes (1.0s)
174 -o ac_attr_timeout=T
176 auto cache timeout for attributes (attr_timeout)
177 -o intr
179 allow requests to be interrupted
180 -o intr_signal=NUM
182 signal to send on interrupt (10)
183 -o modules=M1[:M2...]
185 names of modules to push onto filesystem stack
186 -o max_write=N
188 set maximum size of write requests
189 -o max_readahead=N
191 set maximum readahead
192 -o async_read
194 perform reads asynchronously (default)
195 -o sync_read
197 perform reads synchronously
198 -o atomic_o_trunc
200 enable atomic open+truncate support
201 MacFUSE mount options
205 These options are available to Mac users using MacFUSE.
206 -o allow_other
209 allow access to others besides the user who mounted
210 the file system
211 -o allow_recursion
213 allow a mount point that itself resides on a MacFUSE volume (by
214 default, such mounting is disallowed)
215 -o allow_root
217 allow access to root (can't be used with allow_other)
218 -o auto_xattr
220 handle extended attributes entirely through ._ files
221 -o blocksize=SIZE
223 specify block size in bytes of "storage"
224 -o case_insensitive
226 enable case-insensitive mode
227 -o daemon_timeout=T
229 timeout in seconds for kernel calls to daemon
230 -o debug
232 turn on debug information printing
233 -o default_permissions
235 let the kernel handle permission checks locally
236 -o defer_permissions
238 defer permission checks to file operations themselves
239 -o direct_io
241 use alternative (direct) path for kernel-user I/O
242 -o extended_security
244 turn on Mac OS X extended security (ACLs)
245 -o fsid=FSID
247 set the second 32-bit component of the fsid
248 -o fsname=NAME
250 set the file system's name
251 -o fssubtype=NUM
253 set the file system's fssubtype identifier
254 -o fstypename=NAME
256 set the file system's type name
257 -o iosize=SIZE
259 specify maximum I/O size in bytes
260 -o jail_symlinks
262 contain symbolic links within the mount
263 -o kill_on_unmount
265 kernel will send a signal (SIGKILL by default) to the daemon
266 after unmount finishes
267 -o local
269 mark the volume as ``local'' (default is ``nonlocal'')
270 -o negative_vncache
272 enable vnode name caching of non-existent objects
273 -o volname=NAME
275 set the file system's volume name
276 -o noalerts
279 disable all graphical alerts (if any) in MacFUSE Core
280 -o noappledouble
282 ignore Apple Double (._) and .DS_Store files entirely
283 -o noapplexattr
285 ignore all ``com.apple.*'' extended attributes
286 -o nobrowse
288 mark the volume as non-browsable by the Finder
289 -o nolocalcaches
291 meta option equivalent to noreadahead,noubc,novncache
292 -o noping_diskarb
294 do not ping Disk Arbitration (pings by default)
295 -o noreadahead
297 disable I/O read-ahead behavior for this file system
298 -o nosynconclose
300 disable sync-on-close behavior (enabled by default)
301 -o nosyncwrites
303 disable synchronous-writes behavior (dangerous)
304 -o noubc
306 disable the unified buffer cache for this file system
307 -o novncache
309 disable the vnode name cache for this file system
310 -o hard_remove
313 immediate removal (don't hide files)
314 -o use_ino
316 let filesystem set inode numbers
317 -o readdir_ino
319 try to fill in d_ino in readdir
320 -o direct_io
322 use direct I/O
323 -o kernel_cache
325 cache files in kernel
326 -o [no]auto_cache
328 enable caching based on modification times
329 -o umask=M
331 set file permissions (octal)
332 -o uid=N
334 set file owner
335 -o gid=N
337 set file group
338 -o entry_timeout=T
340 cache timeout for names (1.0s)
341 -o negative_timeout=T
343 cache timeout for deleted names (0.0s)
344 -o attr_timeout=T
346 cache timeout for attributes (1.0s)
347 -o ac_attr_timeout=T
349 auto cache timeout for attributes (attr_timeout)
350 -o intr
352 allow requests to be interrupted
353 -o intr_signal=NUM
355 signal to send on interrupt (30)
356 -o modules=M1[:M2...]
358 names of modules to push onto filesystem stack
359 -o max_write=N
362 set maximum size of write requests
363 -o max_readahead=N
365 set maximum readahead
366 -o async_read
368 perform reads asynchronously (default)
369 -o sync_read
371 perform reads synchronously
372 Module options
375 [subdir]
376 -o subdir=DIR
378 prepend this directory to all paths (mandatory)
379 -o [no]rellinks
381 transform absolute symlinks to relative
382 [iconv]
384 -o from_code=CHARSET
386 original encoding of file names (default: UTF-8)
387 -o to_code=CHARSET
389 new encoding of the file names (default: ISO-8859-2)
390
394 This sofware is free software; you can redistribute it and/or modify it
395 under the terms of the GNU Library General Public License as published
396 by the Free Software Foundation; either version 2 of the License, or
397 (at your option) any later version.
398 This software is distributed in the hope that it will be useful, but
400 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
401 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library
402 General Public License for more details.
403 You should have received a copy of the GNU Library General Public
405 License along with this software; if not, write to the Free Software
406 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
407 USA
408
412 This is beta software and should be treated as such. Bug reports to
413 the AUTHORS listed below would be appreciated.
414 archivemount is forced to run a single-thread mode for now. Support for
416 stable multithreading is planned in a future release.
417
421 bzip2(1), compress(1), cpio(1), gzip(1), libarchive(3), pax(1), tar(1),
422 umount(8), and zip(1)
423 ``Filesystem in Userspace'': http://fuse.sourceforge.net/
425 ``MacFUSE'': http://code.google.com/p/macfuse/
427
430 Archivemount is written and maintained by Andre Landwehr <andrel@cyber‐
431 noia.de>.
432 This man page was written by Tom Duck <tom.duck@dal.ca> with material
434 drawn from the page for libarchive(3).
435ARCHIVEMOUNT version 0.6.1 1 November 2008 ARCHIVEMOUNT(1)