Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
WIMDELETE(1)			  User Commands 		    WIMDELETE(1)

NAME
     wimdelete - Delete an image from a WIM archive

SYNOPSIS
     wimdelete WIMFILE IMAGE [OPTION...]

DESCRIPTION
     wimdelete,  or equivalently wimlib-imagex delete, deletes the specified im-
     age from the Windows Imaging (WIM) archive WIMFILE.

     IMAGE specifies the WIM image in WIMFILE to delete.  It may be the  1-based
     index  of	an  image, the name of an image, or the keyword "all" to specify
     all images.  You can use wiminfo(1) to list the images  contained	in  WIM-
     FILE.

NOTES
     By  default,  wimdelete rebuilds the WIM with all unnecessary file data re-
     moved.  This is different from Microsoft's ImageX and DISM, which only will
     delete the directory tree metadata and XML data for  this	operation.   Use
     --soft if you want the other kind of delete.

     wimlib allows you to delete all the images from a WIM and have a WIM with 0
     images, although such a file may not be very useful.

     wimdelete does not support split WIMs.

OPTIONS
     --check
	   Before  deleting  the  image, verify the WIM's integrity if extra in-
	   tegrity information is present.  In addition, include extra integrity
	   information in the modified WIM, even if it was not present before.

     --include-integrity
	   Include extra integrity information in the modified	WIM,  i.e.  like
	   --check but don't do any verification beforehand.

     --soft
	   Perform  a "soft delete".  Specifying this flag overrides the default
	   behavior of rebuilding the entire WIM after deleting an  image.   In-
	   stead,  only  minimal  changes to correctly remove the image from the
	   WIM will be taken.  In particular, all file resources  will	be  left
	   alone,  even  if they are no longer referenced.  This may not be what
	   you want, because no space will be saved by deleting an image in this
	   way.  However, wimoptimize can later be used to rebuild  a  WIM  file
	   that has had images soft-deleted from it.

     --unsafe-compact
	   Compact the WIM archive in-place, eliminating "holes".  This is effi-
	   cient, but in general this option should not be used because a failed
	   or interrupted compaction will corrupt the WIM archive.  For more in-
	   formation, see the documentation for this option to wimoptimize(1).

EXAMPLES
     Delete the first image from 'boot.wim':

	    wimdelete boot.wim 1

SEE ALSO
     wimlib-imagex(1) wiminfo(1) wimoptimize(1)

wimlib 1.14.4			  February 2024 		    WIMDELETE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=wimdelete&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help