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