.TH WIMLIB-IMAGEX "1" "January 2014" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands"
.SH NAME
@IMAGEX_PROGNAME@-dir \- Show the files contained in a WIM archive
.SH SYNOPSIS
\fB@IMAGEX_PROGNAME@ dir\fR \fIWIMFILE\fR \fIIMAGE\fR [\fIOPTIONS\fR]
.SH DESCRIPTION
Lists the files and directories contained in the specified image of the Windows
Imaging (WIM) file \fIWIMFILE\fR.
This command is also available as simply \fBwimdir\fR if the appropriate hard
link or batch file has been installed.
.PP
\fIIMAGE\fR specifies the image in \fIWIMFILE\fR to show the files of.  It may
be a 1-based index of an image in \fIWIMFILE\fR, the name of an image in
\fIWIMFILE\fR, or the keyword "all" to indicate that files from all images in
\fIWIMFILE\fR are to be shown.  Use the \fB@IMAGEX_PROGNAME@ info\fR (1) command
to show what images a WIM file contains.
.SH OPTIONS
.TP 6
\fB--path\fR=\fIPATH\fR
List the files recursively from the \fIPATH\fR directory instead of from the
root directory.
.SH NOTES
\fB@IMAGEX_PROGNAME@ dir\fR supports split WIMs, but it will only work on the
first part of the split WIM.
.PP
The DOS names of files are not displayed.
.PP
Alternate (named) data streams are not displayed.
.SH EXAMPLES
List all files in the first image of 'boot.wim':
.RS
.PP
@IMAGEX_PROGNAME@ dir boot.wim 1
.RE
.PP
.SH SEE ALSO
.BR @IMAGEX_PROGNAME@ (1)
.BR @IMAGEX_PROGNAME@-info (1)