xenial (1) wimlib-imagex-delete.1.gz

Provided by: wimtools_1.9.0-2_amd64 bug

NAME

       wimlib-imagex-delete - Delete an image from a WIM archive

SYNOPSIS

       wimlib-imagex delete WIMFILE IMAGE [OPTION...]

DESCRIPTION

       wimlib-imagex  delete  deletes  the  specified  image  from the Windows Imaging (WIM) file WIMFILE.  This
       command is also available as simply wimdelete if the  appropriate  hard  link  or  batch  file  has  been
       installed.

       IMAGE  specifies  the  WIM image in WIMFILE to delete.  It may be a 1-based index of an image in the WIM,
       the name of an image in the WIM, or the keyword "all" to indicate that all images are to be deleted.  Use
       the wimlib-imagex info (1) command to show what images a WIM file contains.

NOTES

       By  default,  the  WIM  file  is  rebuilt 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
       operation.  (See the --soft option for the other kind of delete).

       Also  wimlib allows you to delete all the images from a WIM and have a WIM with 0 images, although such a
       file wouldn't be very useful.

       wimlib-imagex delete does not support split WIMs.

OPTIONS

       --check
             When reading WIMFILE, verify its integrity if the integrity table is  present;  additionally,  when
             rewriting  WIMFILE after the specified image was deleted, always write an integrity table.  If this
             option is not specified, the integrity of WIMFILE will not be checked  when  it's  opened,  but  an
             integrity table will be written in the updated WIM if and only if one was present before.

       --soft
             Perform  a  "soft  delete".   Specifying this flag overrides the default behavior of rebuilding the
             entire WIM after deleting an image.  Instead, only minimal changes to correctly  remove  the  image
             from  the  WIM  will  be taken.  In particular, all streams will be left alone, even if they are no
             longer referenced.  This is probably not what you want, because no space will be saved by  deleting
             an image in this way.

             You  may  use  wimlib-imagex optimize to delete unreferenced streams from a WIM that has had images
             soft-deleted from it.

       --unsafe-compact
             See the documentation for this option in wimlib-imagex-optimize (1).

EXAMPLES

       Delete the first image from 'boot.wim':

              wimlib-imagex delete boot.wim 1

SEE ALSO

       wimlib-imagex(1) wimlib-imagex-info(1) wimlib-imagex-optimize(1)