]> wimlib.net Git - wimlib/blob - doc/man1/wimdir.1
Use MIT license instead of CC0
[wimlib] / doc / man1 / wimdir.1
1 .TH WIMDIR "1" "December 2021" "wimlib 1.13.5" "User Commands"
2 .SH NAME
3 wimdir \- List the files contained in a WIM image
4 .SH SYNOPSIS
5 \fBwimdir\fR \fIWIMFILE\fR [\fIIMAGE\fR] [\fIOPTION\fR...]
6 .SH DESCRIPTION
7 \fBwimdir\fR, or equivalently \fBwimlib-imagex dir\fR, lists the files and
8 directories contained in the specified image of the Windows Imaging (WIM)
9 archive \fIWIMFILE\fR.
10 .PP
11 \fIIMAGE\fR specifies the image in \fIWIMFILE\fR to list.  It may be the 1-based
12 index of an image, the name of an image, or the keyword "all" to specify all
13 images.  It may be omitted if \fBWIMFILE\fR contains only one image.  You can
14 use \fBwiminfo\fR(1) to list the images contained in \fIWIMFILE\fR.
15 .SH OPTIONS
16 .TP 6
17 \fB--path\fR=\fIPATH\fR
18 List the files under \fIPATH\fR instead of under the root directory.
19 .TP
20 \fB--detailed\fR
21 List detailed information about each file.
22 .TP
23 \fB--one-file-only\fR
24 List information about the specified file only.  Intended for use with both
25 \fB--path\fR and \fB--detailed\fR.
26 .TP
27 \fB--ref\fR="\fIGLOB\fR"
28 File glob of additional WIMs or split WIM parts to reference resources from.
29 This option can be specified multiple times.  This option is only useful when
30 \fB--detailed\fR is also specified.
31 .SH NOTES
32 \fBwimdir\fR supports split WIMs, but it only works on the first part of the
33 split WIM.
34 .PP
35 Detailed metadata such as timestamps and data streams is not shown unless the
36 \fB--detailed\fR option is used.
37 .SH EXAMPLES
38 List all files and directories in the first image of 'boot.wim':
39 .RS
40 .PP
41 wimdir boot.wim 1
42 .RE
43 .PP
44 .SH SEE ALSO
45 .BR wimlib-imagex (1)
46 .BR wiminfo (1)