Build system / directory cleanups
[wimlib] / doc / imagex-mountrw.1.in
1 .TH IMAGEX "1" "May 2012" "imagex (wimlib) wimlib @VERSION@" "User Commands"
2 .SH NAME
3 imagex mountrw \- Mount an image from a WIM archive read-write
4
5 .SH SYNOPSIS
6 \fBimagex mountrw\fR \fIWIMFILE\fR (\fIIMAGE_NUM\fR | \fIIMAGE_NAME\fR)  \
7 \fIDIRECTORY\fR [--check]
8
9 .SH DESCRIPTION
10 .PP
11
12 \fBimagex mountrw\fR mounts the image specified by \fIIMAGE_NUM\fR or
13 \fIIMAGE_NAME\fR on the directory \fIDIRECTORY\fR using FUSE (Filesystem in
14 UserSpace).  It is mounted read-write.  
15
16 It is permissible to omit the \fIIMAGE_NUM\fR or \fIIMAGE_NAME\fR only if
17 \fIWIMFILE\fR contains only one image.
18
19 A temporary directory is created to stage files.  Whenever a new file is created
20 in the mounted filesystem, it is created in the staging directory.  Also,
21 whenever a file in the WIM file itself is modified, it is copied to the
22 staging directory.  When the WIM is unmounted with the \fBimagex unmount
23 --commit\fR command, file resources are collected from the original WIM as well
24 as the staging directory to create the new WIM file.  When the new WIM file is
25 completely written, the old WIM file is overwritten with it.
26
27 .SH OPTIONS
28 .TP 6
29 \fB--check\fR
30 When reading \fIWIMFILE\fR, verify its integrity if the integrity table is
31 present. 
32
33 .SH SEE ALSO
34 .BR imagex (1)
35