]> wimlib.net Git - wimlib/blobdiff - doc/man1/wimcapture.1
wimlib-imagex: add --include-integrity option
[wimlib] / doc / man1 / wimcapture.1
index 1615ea7f7f189d15234622a387cec73c3cda03f9..990c04c2754e19cee37b5389abfe5cb720201993 100644 (file)
@@ -1,4 +1,4 @@
-.TH WIMCAPTURE "1" "August 2016" "wimlib 1.10.0" "User Commands"
+.TH WIMCAPTURE "1" "July 2017" "wimlib 1.12.0" "User Commands"
 .SH NAME
 wimcapture, wimappend \- Capture or append a WIM image
 .SH SYNOPSIS
@@ -90,6 +90,8 @@ However, the main limitations of this mode are:
 .IP \[bu] 4
 Encrypted files are excluded.
 .IP \[bu]
+Extended attributes (EAs) are not stored yet.
+.IP \[bu]
 Sparse files will be flagged as such, but their full data will still be stored,
 subject to the usual compression.
 .IP \[bu]
@@ -137,8 +139,8 @@ considered an error condition.
 Hard links, if supported by the source filesystem.
 .IP \[bu]
 Object IDs, if supported by the source filesystem.
-.PP
-There is no support yet for capturing NTFS extended attributes.
+.IP \[bu]
+Extended attributes (EAs), if supported by the source filesystem.
 .SH REPARSE POINTS AND SYMLINKS
 A "symbolic link" (or "symlink") is a special file which "points to" some other
 file or directory.  On Windows, a "reparse point" is a generalization of a
@@ -171,7 +173,12 @@ WIM.
 .TP
 \fB--check\fR
 Include extra integrity information in the resulting WIM.  With \fBwimappend\fR,
-also check the integrity of the WIM before appending to it.
+also check the integrity of the WIM before appending to it.  Also verify the
+integrity of any WIMs specified by \fB--update-of\fR and/or \fB--delta-from\fR.
+.TP
+\fB--include-integrity\fR
+Include extra integrity information in the resulting WIM, i.e. like
+\fB--check\fR but don't do any verification beforehand.
 .TP
 \fB--compress\fR=\fITYPE\fR[:\fILEVEL\fR]
 With \fBwimcapture\fR, use the specified compression format in the new WIM file.
@@ -317,6 +324,8 @@ used:
 \\swapfile.sys
 \\System Volume Information
 \\RECYCLER
+\\$RECYCLE.BIN
+\\$Recycle.Bin
 \\Windows\\CSC
 .RE
 .RE
@@ -473,10 +482,10 @@ performance and does not change the resulting WIM image (but see note below).
 .IP ""
 As shown, the full syntax for the argument to this option is to specify the WIM
 file, a colon, and the image; for example, "--update-of mywim.wim:1".  However,
-the WIM file and colon may be omitted, in which case the WIM file will default
-to the WIM file being appended to for append operations, or the WIM file from
-which a delta is being taken (only if \fB--delta-from\fR is specified exactly
-once) for capture operations.
+the WIM file and colon may be omitted if \fB--delta-from\fR is specified exactly
+once, in which case the WIM defaults to that specified in \fB--delta-from\fR, or
+if the operation is \fBwimappend\fR rather \fBwimcapture\fR, in which case the
+WIM defaults to the one being appended to.
 .IP ""
 Note: in the Windows version of wimlib, it has been observed that
 \fB--update-of\fR mode is not completely reliable at detecting changes in file
@@ -494,11 +503,11 @@ other operating systems such as Linux which maintain files' last modification
 timestamps correctly.
 .TP
 \fB--delta-from\fR=\fIWIMFILE\fR
-With \fBwimcapture\fR, capture the new WIM as a "delta" from \fIWIMFILE\fR.  Any
-file data that would ordinarily need to be archived in the new WIM is omitted if
-it is already present in the \fIWIMFILE\fR on which the delta is being based.
-The new WIM will still contain a full copy of the image metadata, but this is
-typically only a small fraction of a WIM's total size.
+Capture or append the new image as a "delta" from \fIWIMFILE\fR.  Any file data
+that would ordinarily need to be archived in the new or updated WIM is omitted
+if it is already present in the \fIWIMFILE\fR on which the delta is being based.
+The resulting WIM will still contain a full copy of the image metadata, but this
+is typically only a small fraction of a WIM's total size.
 .IP ""
 This option can be specified multiple times, in which case the resulting delta
 WIM will only contain file data not present in any of the specified base WIMs.
@@ -537,6 +546,8 @@ WIM, the second backup could have simply been appended to the WIM as new image
 using \fBwimappend\fR.  Delta WIMs should be used only if it's desired to base
 the backups or images on a separate, large file that is rarely modified.
 .IP ""
+\fB--delta-from\fR is supported by both \fBwimcapture\fR and \fBwimappend\fR.
+.IP ""
 Delta WIMs are compatible with Microsoft's WIM software.  For example, you can
 use the /ref option of ImageX to reference the base WIM(s), similar to above.
 .IP ""