X-Git-Url: https://wimlib.net/git/?a=blobdiff_plain;f=doc%2Fimagex.1.in;h=b913c45e52cbb31fd7667eba892f0567d53a2f61;hb=61db93f82eca3fe9f7676355c709c58cc425a6ad;hp=a9ef7b14ac52e21a9770127e09734c3d41e84d8a;hpb=ee742f0a166d4aa4a1ab5c495aaa5029d8cf8e66;p=wimlib diff --git a/doc/imagex.1.in b/doc/imagex.1.in index a9ef7b14..b913c45e 100644 --- a/doc/imagex.1.in +++ b/doc/imagex.1.in @@ -1,4 +1,4 @@ -.TH IMAGEX 1 "May 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" +.TH IMAGEX 1 "August 2013" "@IMAGEX_PROGNAME@ @VERSION@" "User Commands" .SH NAME @IMAGEX_PROGNAME@ \- Create, modify, extract, mount, or unmount a WIM (Windows Imaging Format) archive .SH SYNOPSIS @@ -48,12 +48,18 @@ but not Windows): .IP \[bu] 4 Create a stand-alone WIM from a directory or NTFS volume (\fB@IMAGEX_PROGNAME@ capture\fR) .IP \[bu] +Capture a WIM image directly to standard output in a special pipable format +(\fB@IMAGEX_PROGNAME@ capture\fR) +.IP \[bu] Append a directory or NTFS volume onto a stand-alone WIM as a new image (\fB@IMAGEX_PROGNAME@ append\fR) .IP \[bu] Apply an image from a stand-alone or split WIM to a directory or NTFS volume (\fB@IMAGEX_PROGNAME@ apply\fR) .IP \[bu] +Apply an image from a special pipable WIM format sent over standard input +(\fB@IMAGEX_PROGNAME@ apply\fR) +.IP \[bu] Mount an image from a stand-alone or split WIM read-only (\fB@IMAGEX_PROGNAME@ mount\fR) .IP \[bu] Mount an image from a stand-alone WIM read-write (\fB@IMAGEX_PROGNAME@ mountrw\fR) @@ -92,6 +98,16 @@ thus, much functionality was designed around this. .IP \[bu] The command-line syntax of the two programs is similar but not exactly the same. .IP \[bu] +As of wimlib v1.5.0, for convenience \fB@IMAGEX_PROGNAME@\fR automatically +preserves the integrity table in WIMs that have one, even when \fB--check\fR is +not specified. +.IP \[bu] +As of wimlib v1.5.0, a special "pipable" WIM format that is not compatible with +Microsoft's software is supported. This allows capturing and applying images +directly to standard output or from standard input, respectively; this can be +used to pipe images to or from a server over the network to implement fast +filesystem imaging and restore. +.IP \[bu] On UNIX, because Microsoft designed the WIM file format to accomodate Windows-specific and NTFS-specific features, wimlib must have two separate image capture and application modes (although the \fB@IMAGEX_PROGNAME@\fR subcommands @@ -156,6 +172,12 @@ character encodings. .PP On UNIX, wimlib works primarily in the locale-dependent multibyte encoding, which you are strongly recommended to set to UTF-8 to avoid any problems. +.SH CASE SENSITIVITY +The case sensitivity of \fB@IMAGEX_PROGNAME@\fR differs somewhat between UNIX +and Windows. \fB@IMAGEX_PROGNAME@\fR internally treats filenames as +case-sensitive, but on Windows it will treat paths actually provided by the user +as case-insensitive in order to get the "expected" behavior. Otherwise, options +and non-path arguments should be specified in lower case. .SH WARNING Note: \fBwimlib\fR and \fB@IMAGEX_PROGNAME@\fR are experimental. Use Microsoft's imagex.exe if you have to make sure your WIM files are made "correctly". Feel