wimlib-imagex: add options to enable unsafe compaction
[wimlib] / doc / man1 / wimlib-imagex-dir.1
1 .TH WIMLIB-IMAGEX "1" "August 2015" "wimlib 1.8.2" "User Commands"
2 .SH NAME
3 wimlib-imagex-dir \- Show the files contained in a WIM archive
4 .SH SYNOPSIS
5 \fBwimlib-imagex dir\fR \fIWIMFILE\fR \fIIMAGE\fR [\fIOPTIONS\fR]
6 .SH DESCRIPTION
7 Lists the files and directories contained in the specified image of the Windows
8 Imaging (WIM) file \fIWIMFILE\fR.
9 This command is also available as simply \fBwimdir\fR if the appropriate hard
10 link or batch file has been installed.
11 .PP
12 \fIIMAGE\fR specifies the image in \fIWIMFILE\fR to show the files of.  It may
13 be a 1-based index of an image in \fIWIMFILE\fR, the name of an image in
14 \fIWIMFILE\fR, or the keyword "all" to indicate that files from all images in
15 \fIWIMFILE\fR are to be shown.  Use the \fBwimlib-imagex info\fR (1) command
16 to show what images a WIM file contains.
17 .SH OPTIONS
18 .TP 6
19 \fB--path\fR=\fIPATH\fR
20 List the files recursively from the \fIPATH\fR directory instead of from the
21 root directory.
22 .TP
23 \fB--detailed\fR
24 List detailed information about each file.
25 .TP
26 \fB--one-file-only\fR
27 Show information about one file only.  Intended for use with both \fB--path\fR
28 and \fB--detailed\fR.
29 .TP
30 \fB--ref\fR="\fIGLOB\fR"
31 File glob of additional WIMs or split WIM parts to reference resources from.
32 This option can be specified multiple times.  This option is only useful when
33 \fB--detailed\fR is also specified.
34 .SH NOTES
35 \fBwimlib-imagex dir\fR supports split WIMs, but it will only work on the
36 first part of the split WIM.
37 .PP
38 DOS names and alternate (named) data streams are not listed unless the
39 \fB--detailed\fR mode is used.
40 .SH EXAMPLES
41 List all files in the first image of 'boot.wim':
42 .RS
43 .PP
44 wimlib-imagex dir boot.wim 1
45 .RE
46 .PP
47 .SH SEE ALSO
48 .BR wimlib-imagex (1)
49 .BR wimlib-imagex-info (1)