X-Git-Url: https://wimlib.net/git/?a=blobdiff_plain;f=doc%2Fimagex-capture.1.in;h=c38758a05d0ba7983bbd0737bbb38570d128b4dd;hb=fe6c34ebb7d5adeeceeed22142e080965d85a1eb;hp=95fdd763b345a64e15167df34c74f748ba943b96;hpb=09d5c7b390a18d5cc29a87853dce0c4681e8f153;p=wimlib diff --git a/doc/imagex-capture.1.in b/doc/imagex-capture.1.in index 95fdd763..c38758a0 100644 --- a/doc/imagex-capture.1.in +++ b/doc/imagex-capture.1.in @@ -180,27 +180,32 @@ capture mode. Specifies a configuration file for capturing the new image. The configuration file specifies files that are to be treated specially during the image capture. -The format of the configuration file is a number of sections containing file +The format of the configuration file is a number of sections containing path globs one per line, where each section begins with the tag [ExclusionList], [ExclusionException], [CompressionExclusionList], or [AlignmentList]. Currently, only the [ExclusionList] and [ExclusionException] sections are -implemented. The [ExclusionList] section specifies a list of file globs to +implemented. The [ExclusionList] section specifies a list of path globs to exclude from capture, while the [ExclusionException] section specifies a list of -file globs to include in the capture even if the matched file or directory name +path globs to include in the capture even if the matched file or directory name also appears in the [ExclusionList]. -Relative globs with only one path component match against a filename in any -directory. Relative globs with multiple path components, as well as absolute -globs, are treated as paths starting at the root directory of capture, or the -root of the NTFS volume for NTFS capture mode. If a directory is matched by a -glob in the [ExclusionList], the entire directory tree rooted at that directory -is excluded from the capture, unless \fB--dereference\fR is specified and there -is another path into that directory through a symbolic link. +Relative globs with only one path component (e.g. *.mp3) match against a filename in any +directory. Relative globs with multiple path components (e.g. dir/file), +as well as absolute globs (e.g. /dir/file), are treated as paths starting at the +root directory of capture, or the root of the NTFS volume for NTFS capture mode. +If a directory is matched by a glob in the [ExclusionList], the entire directory +tree rooted at that directory is excluded from the capture, unless +\fB--dereference\fR is specified and there is another path into that directory +through a symbolic link. For compatibility with Windows, the path separators in the globs may be either forward slashes or backslashes, and the line separators may be either UNIX-style -or DOS-style. However, globs with spaces in them currently must not be quoted. -Empty lines are ignored. +or DOS-style. Globs with spaces in them must be quoted, and leading and +trailing whitespace is not significant. Empty lines and lines beginning with +'#' or whitespace followed by '#' are ignored. + +Paths may not have drive letters in them, as they are all relative to the root +of capture and not absolute external paths. If this option is not specified the following default configuration file is used: @@ -213,15 +218,9 @@ used: \\$ntfs.log \\hiberfil.sys \\pagefile.sys -\\System Volume Information +"\\System Volume Information" \\RECYCLER \\Windows\\CSC - -[CompressionExclusionList] -*.mp3 -*.zip -*.cab -\\WINDOWS\\inf\\*.pnf .RE .RE @@ -234,10 +233,19 @@ for convenience only, in case you want to use \fB@IMAGEX_PROGNAME@\fR to archive UNIX. Microsoft's software will not understand this special information. .TP -\fB--noacls\fR +\fB--no-acls\fR In the NTFS capture mode, do not capture security descriptors. This flag is -also available in the native Win32 build of wimlib and may be useful when -running \fB@IMAGEX_PROGNAME@\fR as a non-administrator. +also available in the native Win32 build of wimlib. +.TP +\fB--strict-acls\fR +In the Win32 native build of wimlib, fail immediately if the full security +descriptor of any file or directory cannot be read. The default behavior +without this option is to first try omitting the SACL from the security +descriptor, then to try omitting the security descriptor entirely. The purpose +of this is to capture as much data as possible without always requiring +Administrator privileges. However, if you desire that all security descriptors +be captured exactly, you may with to provide this option, although the +Administrator should have permission to read everything anyway. .TP \fB--source-list\fR \fB@IMAGEX_PROGNAME@ capture\fR and \fB@IMAGEX_PROGNAME@ append\fR, as of wimlib 1.3.0, support a new