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

   1 .TH WIMDELETE "1" "August 2016" "wimlib 1.10.0" "User Commands"
   2 .SH NAME
   3 wimdelete \- Delete an image from a WIM archive
   4 .SH SYNOPSIS
   5 \fBwimdelete\fR \fIWIMFILE\fR \fIIMAGE\fR [\fIOPTION\fR...]
   6 .SH DESCRIPTION
   7 \fBwimdelete\fR, or equivalently \fBwimlib-imagex delete\fR, deletes the
   8 specified image from the Windows Imaging (WIM) archive \fIWIMFILE\fR.
   9 .PP
  10 \fIIMAGE\fR specifies the WIM image in \fIWIMFILE\fR to delete.  It may be the
  11 1-based index of an image, the name of an image, or the keyword "all" to specify
  12 all images.  You can use \fBwiminfo\fR(1) to list the images contained in
  13 \fIWIMFILE\fR.
  14 .SH NOTES
  15 By default, \fBwimdelete\fR rebuilds the WIM with all unnecessary file data
  16 removed.  This is different from Microsoft's ImageX and DISM, which only will
  17 delete the directory tree metadata and XML data for this operation.  Use
  18 \fB--soft\fR if you want the other kind of delete.
  19 .PP
  20 wimlib allows you to delete all the images from a WIM and have a WIM with 0
  21 images, although such a file may not be very useful.
  22 .PP
  23 \fBwimdelete\fR does not support split WIMs.
  24 .SH OPTIONS
  25 .TP 6
  26 \fB--check\fR
  27 Before deleting the image, verify the WIM's integrity if extra integrity
  28 information is present.  In addition, include extra integrity information in the
  29 modified WIM, even if it was not present before.
  30 .TP 6
  31 \fB--soft\fR
  32 Perform a "soft delete".  Specifying this flag overrides the default behavior of
  33 rebuilding the entire WIM after deleting an image.  Instead, only minimal
  34 changes to correctly remove the image from the WIM will be taken.  In
  35 particular, all file resources will be left alone, even if they are no longer
  36 referenced.  This may not be what you want, because no space will be saved by
  37 deleting an image in this way.  However, \fBwimoptimize\fR can later be used to
  38 rebuild a WIM file that has had images soft-deleted from it.
  39 .TP
  40 \fB--unsafe-compact\fR
  41 Compact the WIM archive in-place, eliminating "holes".  This is efficient, but
  42 in general this option should \fInot\fR be used because a failed or interrupted
  43 compaction will corrupt the WIM archive.  For more information, see the
  44 documentation for this option to \fBwimoptimize\fR(1).
  45 .SH EXAMPLES
  46 Delete the first image from 'boot.wim':
  47 .RS
  48 .PP
  49 wimdelete boot.wim 1
  50 .RE
  51 .PP
  52 .SH SEE ALSO
  53 .BR wimlib-imagex (1)
  54 .BR wiminfo (1)
  55 .BR wimoptimize (1)