-.TH WIMLIB-IMAGEX "1" "November 2014" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands"
+.TH WIMLIB-IMAGEX "1" "November 2014" "wimlib-imagex @VERSION@" "User Commands"
.SH NAME
-@IMAGEX_PROGNAME@-mount, @IMAGEX_PROGNAME@-mountrw, @IMAGEX_PROGNAME@-unmount \- Mount and unmount an image from a WIM archive
+wimlib-imagex-mount, wimlib-imagex-mountrw, wimlib-imagex-unmount \- Mount and unmount an image from a WIM archive
.SH SYNOPSIS
-\fB@IMAGEX_PROGNAME@ mount\fR \fIWIMFILE\fR [\fIIMAGE\fR] \fIDIRECTORY\fR [\fIOPTION\fR...]
+\fBwimlib-imagex mount\fR \fIWIMFILE\fR [\fIIMAGE\fR] \fIDIRECTORY\fR [\fIOPTION\fR...]
.br
-\fB@IMAGEX_PROGNAME@ mountrw\fR \fIWIMFILE\fR [\fIIMAGE\fR] \fIDIRECTORY\fR [\fIOPTION\fR...]
+\fBwimlib-imagex mountrw\fR \fIWIMFILE\fR [\fIIMAGE\fR] \fIDIRECTORY\fR [\fIOPTION\fR...]
.br
-\fB@IMAGEX_PROGNAME@ unmount\fR \fIDIRECTORY\fR [\fIOPTION\fR...]
+\fBwimlib-imagex unmount\fR \fIDIRECTORY\fR [\fIOPTION\fR...]
.SH DESCRIPTION
-The \fB@IMAGEX_PROGNAME@ mount\fR and \fB@IMAGEX_PROGNAME@ mountrw\fR commands
+The \fBwimlib-imagex mount\fR and \fBwimlib-imagex mountrw\fR commands
will mount the image in the Windows Imaging (WIM) file \fIWIMFILE\fR specified
by \fIIMAGE\fR on the directory \fIDIRECTORY\fR using FUSE (Filesystem in
-Userspace). \fB@IMAGEX_PROGNAME@ mount\fR will mount the image read-only, while
-\fB@IMAGEX_PROGNAME@ mountrw\fR will mount the image read-write.
+Userspace). \fBwimlib-imagex mount\fR will mount the image read-only, while
+\fBwimlib-imagex mountrw\fR will mount the image read-write.
These commands are also available as simply \fBwimmount\fR, \fBwimmountrw\fR,
and \fBwimunmount\fR if the appropriate hard links or batch files are installed.
.PP
\fIIMAGE\fR may be a 1-based index of the image in the WIM to mount, or it may
-be the name of an image in the WIM. Use the \fB@IMAGEX_PROGNAME@ info\fR (1)
+be the name of an image in the WIM. Use the \fBwimlib-imagex info\fR (1)
command to see the available images in the WIM. \fIIMAGE\fR may be omitted if
\fIWIMFILE\fR contains only one image.
.PP
-The WIM image can be unmounted using the \fB@IMAGEX_PROGNAME@ unmount\fR
+The WIM image can be unmounted using the \fBwimlib-imagex unmount\fR
command. Changes made to a WIM mounted read-write will be discarded unless the
-\fB--commit\fR flag is provided to \fB@IMAGEX_PROGNAME@ unmount\fR.
+\fB--commit\fR flag is provided to \fBwimlib-imagex unmount\fR.
.SH SPLIT WIMS
-You may use \fB@IMAGEX_PROGNAME@ mount\fR to mount an image from a split WIM
+You may use \fBwimlib-imagex mount\fR to mount an image from a split WIM
read-only. However, you may not mount an image from a split WIM read-write.
.PP
The \fIWIMFILE\fR argument must specify the first part of the split WIM, while
To mount the first image of this split WIM to the directory "dir", run:
.PP
.RS
-@IMAGEX_PROGNAME@ mount mywim.swm 1 dir --ref="mywim*.swm"
+wimlib-imagex mount mywim.swm 1 dir --ref="mywim*.swm"
.RE
.PP
.SH NOTES
If wimlib was configured using the \fB--without-fuse\fR flag, then the
-\fB@IMAGEX_PROGNAME@ mount\fR, \fB@IMAGEX_PROGNAME@ mountrw\fR, and
-\fB@IMAGEX_PROGNAME@ unmount\fR commands will not work. Also, these commands
-are not available in the Windows builds of \fB@IMAGEX_PROGNAME@\fR.
+\fBwimlib-imagex mount\fR, \fBwimlib-imagex mountrw\fR, and
+\fBwimlib-imagex unmount\fR commands will not work. Also, these commands
+are not available in the Windows builds of \fBwimlib-imagex\fR.
.PP
You can mount multiple images from a WIM file read-only at the same time, but
you can only mount one image at a time from a WIM read-write.
WIM. This is nice for big WIM files, since the entire file doesn't have to be
rebuilt to make a small change. But, if you are making many changes to a
read-write mounted WIM, especially deleting large files, it is suggested to
-provide the \fB--rebuild\fR option to \fB@IMAGEX_PROGNAME@ unmount\fR to force
-the WIM to be rebuilt, or else run \fB@IMAGEX_PROGNAME@ optimize\fR on the WIM
+provide the \fB--rebuild\fR option to \fBwimlib-imagex unmount\fR to force
+the WIM to be rebuilt, or else run \fBwimlib-imagex optimize\fR on the WIM
afterwards.
.PP
wimlib v1.6.0 and later can mount version 3584 WIMs, which usually contain
File glob of additional WIMs or split WIM parts to reference resources from.
See \fBSPLIT_WIMS\fR. This option can be specified multiple times. Note:
\fIGLOB\fR is listed in quotes because it is interpreted by
-\fB@IMAGEX_PROGNAME@\fR and may need to be quoted to protect against shell
+\fBwimlib-imagex\fR and may need to be quoted to protect against shell
expansion.
.TP
\fB--staging-dir\fR=\fIDIR\fR
Store temporary staging files in a subdirectory of the directory \fIDIR\fR.
-Only valid for \fB@IMAGEX_PROGNAME@ mountrw\fR.
+Only valid for \fBwimlib-imagex mountrw\fR.
.TP
\fB--unix-data\fR
-Honor UNIX-specific metadata that was captured by \fB@IMAGEX_PROGNAME@
-capture\fR with the \fB--unix-data option\fR. By default, \fB@IMAGEX_PROGNAME@
-mount\fR and \fB@IMAGEX_PROGNAME@ mountrw\fR will ignore both Windows-style
+Honor UNIX-specific metadata that was captured by \fBwimlib-imagex
+capture\fR with the \fB--unix-data option\fR. By default, \fBwimlib-imagex
+mount\fR and \fBwimlib-imagex mountrw\fR will ignore both Windows-style
security descriptors (which may have been set either from Windows or by
-\fB@IMAGEX_PROGNAME@ capture\fR from an NTFS-volume) and UNIX-specific metadata.
+\fBwimlib-imagex capture\fR from an NTFS-volume) and UNIX-specific metadata.
In this default mode, all files will simply be owned by the user running
-\fB@IMAGEX_PROGNAME@\fR and will have mode 0777. (Note: they will still not be
+\fBwimlib-imagex\fR and will have mode 0777. (Note: they will still not be
accessible to other users unless you also specify \fB--allow-other\fR.) If you
instead provide the \fB--unix-data\fR option, these default permissions will be
overridden on a per-file basis with the UNIX-specific data when available, and
-in the case of \fB@IMAGEX_PROGNAME@ mountrw\fR it will be possible to change the
+in the case of \fBwimlib-imagex mountrw\fR it will be possible to change the
UNIX permissions using the standard UNIX tools and functions. In addition, with
wimlib v1.7.0 and later, you can create device nodes, named pipes, and sockets
on the mounted filesystem and have them stored in the WIM image.
modified image to be committed as a new, unnamed image appended to the WIM
archive. The original image will be unmodified.
.SH IMPLEMENTATION DETAILS
-Since a WIM is an archive and not a filesystem, \fB@IMAGEX_PROGNAME@ mountrw\fR
+Since a WIM is an archive and not a filesystem, \fBwimlib-imagex mountrw\fR
creates a temporary staging directory to contain files that are created or
modified. This directory is located in the same directory as \fIWIMFILE\fR by
default, but the location can be set using the \fB--staging-dir\fR option. When
(or rebuilt completely with \fB--rebuild\fR), merging in the staging files as
needed. Then, the temporary staging directory is deleted.
.PP
-\fB@IMAGEX_PROGNAME@ unmount\fR runs in a separate process from the process that
-previously ran \fB@IMAGEX_PROGNAME@ mount\fR. When unmounting a read-write
+\fBwimlib-imagex unmount\fR runs in a separate process from the process that
+previously ran \fBwimlib-imagex mount\fR. When unmounting a read-write
mounted WIM image with \fB--commit\fR, these two processes communicate using a
POSIX message queue so that the unmount process can track the progress of the
mount process. See \fIsrc/mount_image.c\fR in the sources for details.
.SH SEE ALSO
-.BR @IMAGEX_PROGNAME@ (1)
+.BR wimlib-imagex (1)
git://wimlib.net / wimlib / blobdiff