wimlib.net Git - wimlib/blob - doc/imagex-info.1.in

   1 .TH IMAGEX "1" "August 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands"
   2 .SH NAME
   3 @IMAGEX_PROGNAME@-info \- Display information about a WIM file, or change information about
   4 an image
   5 .SH SYNOPSIS
   6 \fB@IMAGEX_PROGNAME@ info\fR \fIWIMFILE\fR [\fIIMAGE\fR [\fINEW_NAME\fR
   7 [\fINEW_DESC\fR]]] [\fIOPTION\fR...]
   8 .SH DESCRIPTION
   9 \fB@IMAGEX_PROGNAME@ info\fR displays information about \fIWIMFILE\fR, and optionally
  10 changes which image is bootable, or what the name and description of an image
  11 are.
  12 .PP
  13 If neither an image nor any flags other than \fB--check\fR are specified, some
  14 basic information about the WIM archive as well as information about the images
  15 contained in it will be printed.  If an image is specified by \fIIMAGE\fR (as a
  16 1-based image index or an image name), the printed information is restricted to
  17 that concerning the specified image.
  18 .PP
  19 Changes to the WIM are made if \fINEW_NAME\fR and/or \fB--boot\fR are specified.
  20 \fINEW_NAME\fR is taken to be the new name of the image specified by \fIIMAGE\fR
  21 while \fINEW_DESC\fR is taken to be its new description.  If \fINEW_DESC\fR is
  22 not specified, the image's description is unchanged.
  23 .PP
  24 \fB@IMAGEX_PROGNAME@ info\fR does not support modifying a split WIM, although you may
  25 display information about one.
  26 .SH OPTIONS
  27 .TP 6
  28 \fB--boot\fR
  29 Indicates that the specified image is to be made the bootable image of the WIM
  30 archive.
  31 .TP
  32 \fB--check\fR
  33 When reading \fIWIMFILE\fR, verify its integrity if the integrity table is
  34 present; additionally if an action that requires modifying the WIM archive is
  35 specified, include an integrity table in the modified WIM.  If this option is
  36 not specified and \fIWIMFILE\fR is modified, an integrity table will be included
  37 in the modified WIM if and only if there was one before.
  38 .TP
  39 \fB--nocheck\fR
  40 If an action that requires modifying the WIM archive is specified, do not
  41 include an integrity table in the modified WIM.  If this option is not specified
  42 and \fIWIMFILE\fR is modified, an integrity table will be included in the
  43 modified WIM if and only if there was one before.
  44 .TP
  45 \fB--extract-xml\fR=\fIFILE\fR
  46 Extracts the raw data from the XML resource in the WIM file to \fIFILE\fR.
  47 Note: the XML data will be encoded using UTF-16LE, and it will begin with a
  48 byte-order mark.
  49 .TP
  50 \fB--header\fR
  51 Shows detailed information from the WIM header.
  52 .TP
  53 \fB--lookup-table\fR
  54 Prints all the entries in the stream lookup table of the WIM.
  55 .TP
  56 \fB--metadata\fR
  57 Prints the metadata, including the security data and the directory entry tree
  58 but not the XML data, for the specified image.  If no image is specified, the
  59 metadata for all images is printed.  This only works on standalone WIMs or on
  60 the first part of a split WIM.
  61 .TP
  62 \fB--xml\fR
  63 Prints the raw XML data from the WIM.  Note: the XML data will be encoded using
  64 UTF-16LE, and it will begin with a byte-order mark.
  65 .SH SEE ALSO
  66 .BR @IMAGEX_PROGNAME@ (1)