wimlib.net Git - wimlib/blob - doc/man1/wimdir.1

   1 .TH WIMDIR "1" "November 2018" "wimlib 1.13.0" "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)