]> wimlib.net Git - wimlib/blob - doc/imagex-dir.1.in
bba3a9aa554341589e2e0026dd7f3074168b73cc
[wimlib] / doc / imagex-dir.1.in
1 .TH IMAGEX "1" "August 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands"
2 .SH NAME
3 @IMAGEX_PROGNAME@-dir \- Show the files contained in a WIM archive
4 .SH SYNOPSIS
5 \fB@IMAGEX_PROGNAME@ dir\fR \fIWIMFILE\fR \fIIMAGE\fR [\fIOPTIONS\fR]
6 .SH DESCRIPTION
7 Lists all the files and directories contained in the specified image of the
8 Windows Imaging (WIM) file \fIWIMFILE\fR.
9 This command is also available as simply \fBwiminfo\fR if the appropriate hard
10 link is installed.
11 .PP
12 \fIIMAGE\fR specifies the WIM image to show the files of.  It may be a 1-based
13 index of an image in the WIM, the name of an image in the WIM, or the keyword
14 "all" to indicate that files from all images are to be shown.  Use the
15 \fB@IMAGEX_PROGNAME@ info\fR (1) command to show what images a WIM file
16 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 .SH NOTES
23 \fB@IMAGEX_PROGNAME@ dir\fR supports split WIMs, but it will only work on the
24 first part of the split WIM.
25 .PP
26 The DOS names of files are not displayed.
27 .PP
28 Alternate data streams are not displayed.
29 .SH EXAMPLES
30 List all files in the first image of 'boot.wim':
31 .RS
32 .PP
33 @IMAGEX_PROGNAME@ dir boot.wim 1
34 .RE
35 .PP
36 .SH SEE ALSO
37 .BR @IMAGEX_PROGNAME@ (1)
38 .BR @IMAGEX_PROGNAME@-info (1)