]> wimlib.net Git - wimlib/blobdiff - doc/man1/wimcapture.1
Make absolute ExclusionException patterns include ancestor directories
[wimlib] / doc / man1 / wimcapture.1
index da90c6a3c24536e9ff72e71feab467967f38746d..9426c81320619277e47360d1c49c9f5591675802 100644 (file)
@@ -1,4 +1,4 @@
-.TH WIMCAPTURE "1" "January 2017" "wimlib 1.11.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.
@@ -284,8 +291,13 @@ bracketed sections.  Currently, the following sections are recognized:
 [ExclusionList] ---  contains a list of path globs to exclude from capture.  If
 a directory is matched, both the directory and its contents are excluded.
 .IP \[bu]
-[ExclusionException] --- contains a list of path globs to include in the
-capture, even when the file or directory also matches a glob in [ExclusionList].
+[ExclusionException] --- contains a list of path globs to include, even when the
+file or directory also matches a glob in [ExclusionList].  If a directory is
+matched, then all its contents are included as well.  Files or directories
+\fIwithin\fR a directory excluded by [ExclusionList] may even be included using
+this, though currently it only works for absolute globs (those that begin with
+"/" or "\\"); for example, "/dir/file" can be included while "/dir" can be
+excluded, but including simply "file" won't work in that case.
 .IP \[bu]
 [PrepopulateList] --- this does not affect capture, but if the image is applied
 later with \fB--wimboot\fR, these are globs of files that shall be extracted