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

FreeBSD Manual Pages

  
 
  

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
       image 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  con-
       tained in WIMFILE.

NOTES
       By  default,  wimdelete rebuilds	the WIM	with all unnecessary file data
       removed.	 This is different from	Microsoft's  ImageX  and  DISM,	 which
       only  will delete the directory tree metadata and XML data for this op-
       eration.	 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
	     integrity information is present.	In addition, include extra in-
	     tegrity 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  de-
	     fault behavior of rebuilding the entire WIM after deleting	an im-
	     age.  Instead, 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
	     efficient,	but in general this option should not be used  because
	     a	failed or interrupted compaction will corrupt the WIM archive.
	     For more information, 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=wimlib-imagex-delete&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help