5 - Fixed potential crash when writing WIM XML data, introduced in v1.14.0.
7 - Improved some documentation.
9 - Fixed the Windows build script to avoid an unnecessary DLL dependency when
10 building with MSYS2 MINGW32 or MSYS2 MINGW64.
14 - Fixed a bug introduced in v1.14.0 where non-ASCII characters stopped being
15 accepted in image names and descriptions. This bug only affected UNIX-like
16 systems that use `signed char`, e.g. x86 Linux systems.
20 - Fixed a bug introduced in v1.14.0 where a crash would sometimes occur if a
21 Delphi application or Visual Studio compiled application called into the
22 32-bit x86 build of the library.
24 - Fixed an issue where some WIM images written by wimlib weren't accepted by
25 some MS software versions. wimlib-written WIM images containing directory
26 reparse points (e.g. junctions) weren't accepted by some versions of the
27 Windows 8 setup wizard. Also, recent versions of DISM had stopped accepting
28 wimlib-written WIM images containing directories with named data streams.
30 - Commands passed to wimupdate on standard input are now interpreted as UTF-8 or
31 UTF-16LE (autodetected), just like wimcapture config files and wimextract path
32 list files. Previously, on Windows the Windows code page was used instead of
33 UTF-8, which made it hard to specify non-ASCII file paths in wimupdate
34 commands. The same change also applies to wimcapture source list files.
38 - Fixed a bug introduced in v1.14.0 where wimlib would crash on older CPUs.
42 - Removed libxml2 and libcrypto (OpenSSL) as dependencies of wimlib. Also
43 removed winpthreads as a dependency of wimlib on Windows.
45 - Upgraded the support for mounting WIM images on Linux from fuse2 to fuse3.
46 fuse2 is no longer supported.
48 - Converted the README, README.WINDOWS, and NEWS files to Markdown.
50 - Simplified the process of building wimlib for Windows. See README.WINDOWS for
51 the updated instructions, which use MSYS2 instead of Cygwin. Windows ARM64
52 builds are now supported (experimentally) as well.
54 - Improved performance on CPUs that have SHA-1 instructions in cases where
55 wimlib wasn't using OpenSSL, e.g. the Windows binaries.
57 - Fixed a bug in `wimsplit` where it didn't accept part sizes of 4 GiB or larger
58 on Windows and on 32-bit platforms.
60 - `wimupdate` now supports the `--ref` option. It should be specified when
61 updating a delta WIM to avoid two minor issues.
63 - `wimoptimize` now has better default behavior when converting to and from
64 solid archives, i.e. WIM <=> ESD. It now is consistent with `wimcapture` and
65 `wimexport`. For WIM => ESD, `wimoptimize --solid` now works. Before, the
66 needed command was `wimoptimize --solid --compress=LZMS --chunk-size=128K`.
67 For ESD => WIM, `wimoptimize --compress=LZX` now works. Before, the needed
68 command was `wimoptimize --compress=LZX --chunk-size=32K`.
70 - Removed support for Windows XP.
72 - Added a GitHub Actions workflow that tests wimlib.
76 - `wimsplit` no longer prints a success message on failure.
78 - `wimlib_iterate_dir_tree()` no longer hashes files that haven't yet been
79 written to the WIM file.
81 - Reduced the maximum number of file descriptors that wimlib can use when
82 extracting files from a WIM image on macOS.
84 - The files that used the CC0 public domain dedication now use the MIT license
87 - Removed some configuration options (`--disable-assertions`,
88 `--disable-error-messages`, and `--disable-multithreaded-compression`) that
89 probably weren't being used by anyone.
93 - Exporting "all" images from a WIM file no longer fails if multiple
94 images in that WIM file have the same name.
96 - wimlib now warns rather than aborts if two files have the same SHA-1
97 hash but different sizes.
99 - Fixed build errors with the latest version of MinGW-w64.
103 - wimsplit now prints progress messages regularly rather than just once per WIM
106 - Added support for a data recovery mode which causes files to be extracted even
107 if they are corrupted. The option is `--recover-data` for `wimapply` and
108 `wimextract`, and `WIMLIB_EXTRACT_FLAG_RECOVER_DATA` for the library. Note
109 that this option won't help with all types of corruption; some types of
110 corruption will still cause a fatal error.
114 - On Windows, improved performance of capturing an entire drive in some cases.
116 - On Windows, fixed leaking a directory handle (or triggering a SEH exception
117 when running under a debugger) when referencing WIM files.
119 - On Windows, when applying a Windows OS image using the `--compact` flag,
120 bootloader files can now be compressed with stronger compression algorithms if
121 the version of Windows is recent enough to support it.
123 - Clarified the license text.
127 - Prevented miscompilation with gcc 10 at -O3 due to [a gcc
128 bug](https://gcc.gnu.org/bugzilla/show_bug.cgi?id=94994).
130 - Avoided some compiler warnings with gcc 9 and later.
132 - The `mkwinpeimg` script now also looks for syslinux modules in
133 `/usr/share/syslinux`, to handle where openSUSE installs them.
135 - Removed obsolete packaging files from the source tree.
139 - Fixed a crash or incorrect output during LZMS compression with a compression
140 level greater than 50 and a chunk size greater than 64 MiB. This affected
141 wimlib v1.8.0 and later. In the unlikely event that you used all these
142 non-default compression settings in combination, e.g. `wimcapture --solid
143 --solid-compress=LZMS:100 --solid-chunk-size=128M`, run `wimverify` on your
144 archives to verify your data is intact.
148 - On Windows, wimlib now supports capturing and applying extended attributes
149 (EAs). It is compatible with DISM with the `/EA` option, available since
150 Windows 10 version 1607. wimlib's EA support is on by default and works on
151 older versions of Windows too.
153 - Partially fixed a bug where `[ExclusionException]` entries didn't take effect
154 when the containing directory is matched by `[ExclusionList]`. It now works
155 when the `[ExclusionException]` patterns are absolute. For example, listing
156 `/dir/file` in `[ExclusionException]` now works even if `/dir` is matched by
159 - Added a `--create` option to `wimappend` which makes it create the WIM
160 file (like `wimcapture`) if it doesn't exist yet.
162 - Added an `--include-integrity` option to various `wimlib-imagex` commands.
163 `--include-integrity` is like `--check`, but it will just include an integrity
164 table in the output WIM(s), while skipping verification of any existing
165 integrity tables. This can be useful to avoid unwanted verification of large
166 WIM files, e.g. WIMs given by `--delta-from`.
168 - `wimextract` now reads a pathlist file from standard input when `@-` is given
171 - `wimsplit` (API: `wimlib_split()`) now correctly handles a dot in the path to
172 the first split WIM part, prior to the filename extension.
174 - `wimlib-imagex --version` now shows the version of the library it is actually
175 using (in case it is different from `wimlib-imagex`'s version).
179 - Fixed a bug that was causing the LZMS decompressor to be miscompiled with GCC
180 7 (this broke extracting "solid" archives).
182 - The Windows 10 Recycle Bin directory (`\$RECYCLE.BIN`) has been added to the
183 default exclusion list.
185 - Added a `--quiet` option to `wimlib-imagex`.
187 - The `mkwinpeimg` script now also looks for the syslinux BIOS modules in the
188 directory `/usr/lib/syslinux/modules/bios`.
190 - Files with timestamps before the year 1970 are now extracted correctly to
191 UNIX-style filesystems, are displayed correctly by `wimdir --detailed`, and
192 show up correctly in mounted WIM images.
194 - Files with timestamps after the year 2038 are now displayed correctly by the
195 32-bit Windows build of wimlib.
199 - Fixed a data corruption bug (incorrect compression) when storing an already
200 highly-compressed file in an LZX-compressed WIM with a chunk size greater than
201 or equal to 64K. Note that this is not the default setting and such WIMs are
202 not supported by Microsoft's WIM software, so only users who used the
203 `--chunk-size` option to `wimlib-imagex` or the
204 `wimlib_set_output_chunk_size()` API function may have been affected. This
205 bug was introduced in wimlib v1.10.0. See [this forum
206 thread](https://wimlib.net/forums/viewtopic.php?f=1&t=300) for more details.
208 - On all platforms, sparse files are now extracted as sparse.
210 - Sparse files captured from UNIX-style filesystems are now marked as sparse in
211 the resulting WIM image.
213 - Added support for storing Linux-style extended attributes in WIM images. When
214 the `--unix-data` option is used on Linux, `wimlib-imagex` now captures and
215 applies extended attributes, in addition to the already-supported standard
216 UNIX file permissions (owner/group/mode) and special files.
218 - `--delta-from` is now supported by `wimappend`. (Previously it was only
219 supported by `wimcapture`.)
221 - On Windows, improved the way in which files deduplicated with Windows' Data
222 Deduplication feature are captured.
224 - The development files needed to link with wimlib using Visual Studio are now
225 included in the Windows release archives.
227 - `wimlib.h` can now be included by Visual Studio without errors.
229 - The example programs can now be compiled in C++ mode, and they also now work
232 - Updated `mkwinpeimg` to work correctly on images that have a `windows`
233 (lower case) directory rather than a `Windows` (upper case) directory.
235 - Fixed configuring with `--enable-ssse3-sha1` from release tarball (the file
236 `nasm_lt.sh` was missing).
238 - Made some documentation improvements.
242 - The LZX compression ratio has been slightly improved. The default mode, LZX
243 level 50, is now almost as good as the old LZX level 100, while being nearly
244 the same speed as before.
246 - Decompression performance has been slightly improved.
248 - Filenames are now always listed in NTFS collation order.
250 - On UNIX-like systems, wimlib can now process Windows filenames that are
251 not valid Unicode due to the presence of unpaired surrogates.
253 - On UNIX-like systems, wimlib now always assumes UTF-8 encoding with the
254 addition of surrogate codepoints. Consequently, the environmental variable
255 `WIMLIB_IMAGEX_USE_UTF8` and the flag `WIMLIB_INIT_FLAG_ASSUME_UTF8` no longer
258 - wimlib no longer depends on iconv.
260 - Reduced memory usage slightly.
262 - When a WIM image is applied in NTFS-3G mode, security descriptors are now
263 created in NTFS v3.0 format when supported by the volume.
265 - Workarounds for bugs in libntfs-3g version 2013.1.13 and earlier have been
266 removed. Users are advised to upgrade to a later version of libntfs-3g.
268 - On Windows, wimlib now supports case-sensitive filename extraction when
269 supported by the underlying operating system and filesystem (operating system
270 support requires a registry setting).
274 - On UNIX, wimlib can now overwrite readonly files when extracting.
276 - On Windows, fixed a bug where wimlib could leave a null DACL (a.k.a. "no NTFS
277 permissions") set on some existing directories after extraction.
279 - On Windows, when applying a WIM image in "WIMBoot mode" when the WOF driver is
280 not loaded, wimlib can now correctly register a new WIM file with the target
281 volume when the target volume previously had had WIM files unregistered.
283 - Added a new testing program.
285 - Clarified the main license text and updated public domain dedications for
286 certain files to be more thorough.
290 - Object IDs are now saved and restored on Windows and in NTFS-3G mode.
292 - Reduced memory usage when exporting large numbers of WIM images.
294 - Non UTF-8 locales are now detected correctly.
296 - Addressed compiler warnings and enabled "silent" make rules by default.
298 - Windows-specific updates:
300 - Fixed a bug where duplicate backslashes could be generated in link targets
301 when extracting symbolic links and junctions.
303 - Fixed a bug where the `.cmd` shortcuts for `wimlib-imagex` wouldn't work if
304 their full path contained a space.
306 - Fixed bugs related to scanning SMB filesystems.
308 - Added warning message about known issue with WindowsApps folder.
310 - Added instructions for building from source on Windows.
312 - VSS support is no longer marked "experimental".
314 - Added missing license file for libdivsufsort-lite.
318 - Added experimental support for Windows VSS (Volume Shadow Copy Service). The
319 new `--snapshot` argument to `wimcapture` makes wimlib automatically create
320 and use a temporary VSS snapshot when capturing a WIM image.
322 - Implemented setting of Windows-specific XML information, such as architecture,
323 system root, and version details. This information is now automatically set
324 in newly captured WIM images, when appropriate.
326 - Improved performance of directory tree scans on Windows.
328 - On Windows, to improve capture performance, wimlib now sometimes opens files
329 by inode number rather than by path. This is enabled for `wimcapture` and
330 `wimappend`, but for now other applications have to opt-in.
332 - The progress messages printed by `wimlib-imagex` while writing WIM files have
333 been slightly tweaked.
335 - Progress information for directory tree scans now counts all hard links.
336 Also, on Windows `\\?\` is no longer stripped from the current path.
338 - Added a new `--image-property` option to `wimcapture`, `wimappend`, and
339 `wiminfo`. This option lets you assign values to elements in a WIM file's XML
342 - The `wimlib_get_image_property()` and `wimlib_set_image_property()` API
343 functions now support numerically indexed elements.
345 - Fixed a bug where, on Windows, wimlib would change the security descriptor of
346 the target directory of an extraction even when the `--no-acls` option was
351 - Fixed a bug with libntfs-3g extraction present since v1.8.1. Sometimes, some
352 Microsoft software would not correctly recognize data in the resulting
355 - Made some small improvements to the compression algorithms:
356 - LZX compression ratio was slightly improved.
357 - XPRESS compression ratio and speed was slightly improved.
358 - LZMS compression speed was slightly improved.
360 - Improved handling of WIM XML data. wimlib no longer drops unrecognized
361 elements when exporting images. In addition, two API functions were added for
362 better access to elements in the XML document: `wimlib_get_image_property()`
363 and `wimlib_set_image_property()`.
365 - Added support for (unsafe) in-place compaction of WIM files.
367 - Improved performance of image export by reusing metadata resources
368 instead of always rebuilding and recompressing them.
370 - Improved performance of `wimlib_update_image()` by delaying the update to the
371 WIM's XML document until a write is requested.
373 - On Windows, the target of an extraction may now be a reparse point
374 (which will be dereferenced).
376 - On Windows, wimlib now correctly restores non-Microsoft reparse points.
377 However, this remains broken in NTFS-3G mode due to a libntfs-3g bug.
379 - On Windows, wimlib now has improved performance when archiving files
380 from a filesystem backed by a WIM (a "WIMBoot" setup).
382 - Several improvements to System Compression (compact mode) support:
384 - `wof.sys` (or `wofadk.sys`) is now automatically attached to the target
387 - Compact-mode extractions now work correctly with `wofadk.sys` on older
390 - For compatibility with the Windows bootloader, the requested compression
391 format now is overridden on certain files.
393 - Other minor bugfixes.
397 - This release primarily contains various minor bug fixes and improvements,
400 - Improved handling of deep directory structures.
402 - Fixed a bug where on 32-bit systems, the library could enter an infinite
403 loop if a WIM file was malformed in a specific way.
405 - Added a workaround for a case where libntfs-3g may report duplicate streams
408 - Windows symbolic links and junctions in mounted WIM images are now
409 automatically rewritten to be valid in the mounted location.
411 - Reparse point fixes: correctly handle the "ReparseReserved" field, and
412 correctly handle "empty" (data-less) reparse points.
414 - On Windows, wimlib now acquires SeManageVolumePrivilege, which is needed to
415 create externally backed files using the `wofadk.sys` driver.
417 - Improved validation of filenames.
419 - Improved LZMS decompression speed.
421 - The configure script now honors alternate pkg-config settings.
423 - Links have been updated to point to the new website.
425 - In addition, experimental support has been added for compressing extracted
426 files using System Compression on Windows 10. This functionality is available
427 through the new `--compact` option to `wimapply` and `wimextract` as well as
432 - Fixed a bug in the LZX decompressor: malicious input data could cause out of
433 bounds writes to memory (since wimlib v1.2.2).
435 - The output of the `wiminfo` command now consolidates various boolean flags
436 (such as "Relative path junction") into a single line.
438 - A file can now have both an unnamed data stream ("file contents") and a
439 reparse point stream. Such files can exist as a result of the use of certain
440 Windows features, such as offline storage, including "OneDrive". wimlib will
441 now store and restore both streams on Windows as well as in NTFS-3G mode.
442 Microsoft's WIMGAPI also has this behavior.
444 - On Windows, named data streams of encrypted files are no longer stored twice
447 - On Windows, named data streams are now correctly extracted to existing
448 "readonly" directories. Before, an error would be reported.
450 - On Windows, it is now possible to do a "WIMBoot mode" extraction with
451 non-standalone WIMs such as delta WIMs.
453 - On Windows, when doing an extraction in "WIMBoot mode", files larger
454 than 4 gigabytes are now never extracted as externally backed. This
455 works around a bug in Microsoft's "WOF" driver.
457 - The `--enable-verify-compression` configure option has been removed. If you
458 want to verify a WIM file, use the `wimverify` program.
460 - The way the "file count", "directory count", "total bytes", and "hard link
461 bytes" image statistics (stored in the WIM XML data) is calculated has been
464 - In mounted WIM images, the disk usage provided for each file (`st_blocks`) is
465 now the compressed size rather than the uncompressed size.
467 - The performance of the NTFS-3G and Windows capture modes has been slightly
470 - On UNIX-like systems, symbolic links whose targets contain the backslash
471 character are now handled correctly (losslessly).
475 - Improved the LZX compressor. It is now 15-20% faster than before and provides
476 a slightly better compression ratio.
478 - Improved the LZMS compressor. It now provides a compression ratio slightly
479 better than WIMGAPI while still being faster and using slightly less memory.
481 - The compression chunk size in solid resources, e.g. when capturing or
482 exporting a WIM file using the `--solid` option, now defaults to 64 MiB
483 (67108864 bytes) instead of 32 MiB (33554432 bytes). This provides a better
484 compression ratio and is the same value that WIMGAPI uses. The memory usage
485 is less than 50% higher than wimlib v1.7.4 and is slightly lower than
486 WIMGAPI's memory usage, but if it is too much, it is still possible to choose
487 a lower value, e.g. with the `--solid-chunk-size` option to `wimlib-imagex`.
489 - The `--chunk-size` and `--solid-chunk-size` options to `wimlib-imagex` now
490 accept the 'K', 'M', and 'G' suffixes.
492 - Files are now sorted by name extension when creating a solid WIM file.
494 - Fixed various issues related to capture/apply of EFS-encrypted files on
497 - The file list printed by `wimdir` is now sorted by the platform-specific
498 case sensitivity setting, rather than always case sensitively. This
499 also affects the library function `wimlib_iterate_dir_tree()`.
501 - On Windows, some error and warning messages have been improved.
505 - The Windows binary distribution no longer contains third party DLLs. These
506 dependencies are instead compiled directly into the libwim DLL.
508 - Added more fixes for wimlib on non-x86 architectures such as ARM.
510 - Extracting files to a Windows PE in-memory filesystem no longer fails if
511 the target files do not yet exist.
513 - Improved the performance of XPRESS compression and LZMS decompression.
515 - Enabled SSSE3 accelerated SHA-1 computation in `x86_64` Windows builds. It
516 will automatically be faster on newer Intel and AMD processors.
518 - Removed the `--with-imagex-progname` and `--enable-more-assertions` configure
523 - Fix for very slow export from solid WIM / ESD files.
525 - Fix for LZX and LZMS algorithms on non-x86 architectures, such as ARM.
527 - New progress message: `WIMLIB_PROGRESS_MSG_HANDLE_ERROR`. Applications may
528 use this to treat some types of errors as non-fatal.
530 - The library now permits making in-memory changes to a WIMStruct backed by a
533 - Fixes for "WIMBoot" extraction mode (Windows only):
535 - When not using the WOF driver, extraction no longer fails if the disk
536 containing the WIM file has too many partitions.
538 - When matching patterns in `[PrepopulateList]`, all hard links of each file
541 - The system registry files are now automatically treated as being in
544 - Added a hack to try to work around an intermittent bug in Microsoft's WOF
545 (Windows Overlay Filesystem) driver.
549 - Made more improvements to the XPRESS, LZX, and LZMS compressors.
551 - A number of improvements to the Windows port:
553 - Fixes for setting short filenames.
555 - Faster "WIMBoot" extraction.
557 - Updated and slimmed down the dependent DLLs.
559 - ACL inheritence bits are now restored.
561 - Mandatory integrity labels are now backed up and restored.
563 - Added a workaround for an issue where in rare cases, wimlib could create a
564 compressed data stream that could not be read correctly by Windows after an
565 extraction in "WIMBoot" mode.
569 - Added file count progress data for
570 `WIMLIB_PROGRESS_MSG_EXTRACT_FILE_STRUCTURE` and
571 `WIMLIB_PROGRESS_MSG_EXTRACT_METADATA`.
573 - Added support for testing file exclusions via the user-provided progress
576 - Some documentation improvements.
578 - Made some clarifications to the license text in the COPYING file.
582 - Made more improvements to the XPRESS, LZX, and LZMS compressors.
584 - The default compression mode for wimcapture is now LZX compression in its
585 default mode, which is the same as `--compress=maximum`.
587 - You can now specify an optional integer compression level to the
588 `--compress` option; e.g. `--compress=lzx:75`.
590 - Made a minor change to the LZMS compressor and decompressor to fix an
591 incompatibility with the Microsoft implementation. In the unlikely event that
592 you created an LZMS-compressed WIM with wimlib v1.7.0 or earlier and a
593 checksum error is reported when extracting files from it with wimlib v1.7.1,
594 decompress it with v1.7.0 then compress it with v1.7.1.
596 - Added `verify` subcommand to `wimlib-imagex`.
598 - Notable library changes:
600 - Custom compressor parameters have been removed from the library in favor of
601 the simpler level-based API.
603 - Decompressor parameters have been removed entirely.
605 - Library users can now specify a custom file for warning and error messages
606 to be sent to, rather than the default of standard error.
608 - New progress messages: `WIMLIB_PROGRESS_MSG_EXTRACT_FILE_STRUCTURE`,
609 `WIMLIB_PROGRESS_MSG_EXTRACT_METADATA`.
611 New function: `wimlib_verify_wim()`.
615 - Improved compression, decompression, and extraction performance.
617 - Improved compatibility with version 3584 WIM / ESD files:
619 - Add support for reading and writing multiple solid blocks per archive, which
620 WIMGAPI/DISM can create when appending an image.
622 - Correctly create solid blocks larger than 4 GiB.
624 - `add` commands passed to wimupdate will now replace existing nondirectory
625 files by default. Use the `--no-replace` option to get the old behavior.
627 - The license for the library now contains an exception that allows using it
628 under the LGPL. See the COPYING file for details.
630 - In reparse-point fixup mode (the default for capture), symbolic links and
631 junctions that point outside the tree being captured are no longer excluded
634 - Added support for "WIMBoot" capture and extraction. See the documentation for
635 the new `--wimboot` option to wimcapture and wimapply for more information.
637 - On UNIX-like systems, you can now backup and restore device nodes, named
638 pipes, and sockets. In addition, 32-bit user and group IDs are now supported.
640 - The way that UNIX data is stored in WIM files has been changed. If you
641 captured any WIMs with the `--unix-data` option, to upgrade them you'll need
642 to apply them with `--unix-data` using `wimlib-imagex` v1.6.2, then re-capture
643 them with `--unix-data` using this version.
645 - wimlib now understands tagged metadata items, such as object IDs, that
646 can be stored in WIM directory entries.
648 - Removed the `--hardlink` and `--symlink` options to wimapply, since I don't
649 think they are too useful and they got in the way of improving the code.
651 - WIMs will now retain their GUIDs when rebuilt (e.g. with wimoptimize).
653 - The `mkwinpeimg` script now supports writing the ISO image to standard output.
655 - The `<ARCH>` element in WIM XML data is now exported correctly.
657 - On Windows, sparse file attributes are no longer set on extracted files.
658 Oddly enough, this actually saves disk space in some cases.
660 - On UNIX, configuring with `--disable-xattr` or `--enable-xattr` is no longer
661 supported. Mounting WIM images now always requires extended attribute
662 support. Use `--without-fuse` to disable support for mounting WIM images;
663 this will also disable the need for extended attribute support.
665 - Configuring with `--enable-ssse3-sha1` now works correctly.
667 - The shared library version has been bumped up. The main incompatibilities
670 - `WIMLIB_COMPRESSION_TYPE_XPRESS` is now 1 and `WIMLIB_COMPRESSION_TYPE_LZX`
671 is now 2 (so it's the same as WIMGAPI).
673 - User-provided progress functions are now registered using a separate
674 function, `wimlib_register_progress_function()`. The `progress_func`
675 argument to many functions no longer exists.
677 - The return value from user-provided progress functions is now significant.
679 - A context argument has been added to the prototype of user-provided progress
682 - `struct wimlib_capture_config` has been removed. The library now takes the
683 path to the configuration file directly. This affects `wimlib_add_image()`,
684 `wimlib_add_image_multisource()`, and `wimlib_update_image()`. However, a
685 NULL value passed in the argument retains the same meaning.
687 - Removed deprecated functions: some (de)compression functions,
688 `wimlib_extract_files()`, and `wimlib_print_metadata()`.
690 - Removed extraction flags: `WIMLIB_EXTRACT_FLAG_HARDLINK`,
691 `WIMLIB_EXTRACT_FLAG_SYMLINK`, `WIMLIB_EXTRACT_FLAG_FILE_ORDER`, and
692 `WIMLIB_EXTRACT_FLAG_SEQUENTIAL`.
694 - Removed some progress messages: `WIMLIB_PROGRESS_MSG_APPLY_TIMESTAMPS`,
695 `WIMLIB_PROGRESS_MSG_EXTRACT_DIR_STRUCTURE_BEGIN`,
696 `WIMLIB_PROGRESS_MSG_EXTRACT_DIR_STRUCTURE_END`. Numbering stays the same.
698 - Removed some error codes. Numbering stays the same.
700 - Replaced `WIMLIB_UNMOUNT_FLAG_LAZY` with `WIMLIB_UNMOUNT_FLAG_FORCE`.
702 - WIM paths passed to progress functions now have a leading slash.
706 - Case-insensitive comparisons of strings (e.g. filenames) containing UTF-16
707 codepoints above 32767 are now done correctly.
709 - Fixed build failure on Mac OS X.
711 - `wimunmount` now provides the `--new-image` option to cause changes to a
712 read-write mounted image to be committed as a new image rather than as an
713 update of the mounted image. (The corresponding new library flag is
714 `WIMLIB_UNMOUNT_FLAG_NEW_IMAGE`.)
716 - The LZMS ("recovery") compression chunk size, or "dictionary size", may now be
717 up to 1 GiB (1,073,741,824 bytes).
719 - The performance of LZX ("maximum") and LZMS ("recovery") compression with
720 large chunk sizes has been slightly improved.
724 - Stored files with size exactly 4 GiB (4,294,967,296 bytes) are now
725 decompressed correctly.
727 - Fixed a bug in the LZX compressor introduced in v1.5.3. The bug occurred in
728 an unlikely case, and due to validity checks it did not affect successfully
731 - Fixed a minor compatibility issue with the LZMS compressor and decompressor.
732 This is *not* the default compression type and was only introduced in v1.6.0.
733 In the unlikely event that you created an LZMS-compressed WIM with v1.6.0 and
734 a checksum error is reported when applying it with v1.6.1, decompress it with
735 v1.6.0 then compress it with v1.6.1.
737 - Memory usage for LZMS and LZX compression has been decreased.
739 - wimextract now allows wildcard characters in paths specified on the command
740 line. Also, the `--strict-wildcards` option has been removed and replaced
741 with the inverse option `--nullglob`. See the documentation for wimextract
742 for more details and changes.
744 - The `wimlib_extract_files()` function is now considered deprecated in favor of
745 `wimlib_extract_paths()`.
747 - Fixed more permissions problems when extracting files on Windows.
749 - A new `--no-attributes` option has been added to `wimapply` and `wimextract`.
750 The library flag is `WIMLIB_EXTRACT_FLAG_NO_ATTRIBUTES`.
752 - The default chunk size is now set correctly when changing the compression type
753 of a WIM, for example with `wimoptimize`.
755 - The `--metadata` option to `wiminfo` has been replaced with the `--detailed`
758 - In relevant `wimlib-imagex` commands, `--solid` may now be used as an alias
759 for `--pack-streams`.
763 - Support for extracting and updating the new version 3584 WIMs has been added.
764 These WIMs typically pack many streams ("files") together into a single
765 compressed resource, thereby saving space. This degrades the performance of
766 random access (such as that which occurs on a mounted image), but
767 optimizations have been implemented for extraction. These new WIM files also
768 typically use a new compression format (LZMS), which is similar to LZMA and
769 can offer a better compression ratio than LZX. These new WIM files can be
770 created using `wimcapture` with the `--compress=lzms --pack-streams` options.
771 Note: this new WIM format is used by the Windows 8 web downloader, but
772 important segments of the raw `.esd` files are encrypted, so wimlib will not
773 be able to extract such files until they are first decrypted.
775 - wimlib now supports extracting files and directories from a WIM image based on
776 a "listfile" that itself contains the list of paths to extract. For
777 `wimextract`, the syntax is to specify `@LISTFILE` instead of a `PATH`, and
778 for the library itself, the new APIs are `wimlib_extract_pathlist()` and
779 `wimlib_extract_paths()`. Path globs containing wildcard characters are
782 - For searching WIM files, wimlib now has configurable case sensitivity. The
783 default on Windows is still case-insensitive and the default on UNIX-like
784 systems is still case-sensitive, but this can be overridden on either platform
785 through flags to `wimlib_global_init()`. For `wimlib-imagex`, the
786 environmental variable `WIMLIB_IMAGEX_IGNORE_CASE` can be set to 1 or 0 for
787 case-insensitive or case-sensitive behavior, respectively.
789 - Support for compression chunk sizes greater than the default of 32768
790 bytes has been added. A larger chunk size typically results in a better
791 compression ratio. However, the MS implementation is seemingly not
792 compatible with all chunk sizes, especially for LZX compression, so the
793 defaults remain unchanged, with the exception of the new LZMS-compressed
794 WIMs, which use a larger chunk size by default.
796 - The compression/decompression API exported by wimlib has been changed. Now
797 one set of functions handles all supported compression formats.
799 - `wimcapture` and `wimappend` will now display the progress of scanning the
800 directory tree to capture, in addition to the progress of writing data to the
801 WIM. The `--verbose` option no longer does anything. The library API change
802 for this is the addition of several members to `struct
803 wimlib_progress_info_scan` available to progress callbacks.
805 - `mkwinpeimg` now correctly handles the `--start-script` option when the start
806 script is not in the working directory.
808 - Sequential extraction, previously requested by using
809 `WIMLIB_EXTRACT_FLAG_SEQUENTIAL`, is now the default.
810 `WIMLIB_EXTRACT_FLAG_FILE_ORDER` can be used to get the old default behavior
811 (extract in file order).
815 - The new LZX compressor added in v1.5.2 has been improved and is now enabled by
816 default, except when `wimcapture` or `wimappend` is run *without* the
817 `--compress` option, in which case the faster LZX compressor is used (the same
818 as before). This behavior is reasonably consistent with ImageX which actually
819 uses "fast" (XPRESS) compression by default. In those cases, use
820 `--compress=maximum` to explicitly capture a WIM image using the new (slower
821 but better) LZX compressor.
823 The `--compress-slow` option still exists to `wimlib-imagex optimize`, but its
824 new behavior is to tweak the new LZX compressor even more to produce an even
825 better compression ratio at the cost of more time spent compressing.
827 - `wimlib-imagex optimize` now supports the `--compress=TYPE` option, which
828 recompresses the WIM file using the specified compression TYPE. The new
829 library API function used for this is `wimlib_set_output_compression_type()`.
831 - Added the `wimlib_get_xml_data()` function to allow library clients to easily
832 retrieve the raw XML data from a WIM file if needed.
834 - Fixed a bug that could cause an error code to be incorrectly returned when
835 writing XML data containing a `<WINDOWS>` element.
837 - Mounted WIM images will now correctly show the default file stream even if
838 appears in the alternate data stream entries of the corresponding WIM
843 - Added a new experimental LZX compressor which can be enabled by passing
844 `--compress-slow` to `wimlib-imagex capture` or `wimlib-imagex optimize`.
845 (The latter is only applicable if the WIM is already LZX-compressed and the
846 `--recompress` option is also given.) The experimental compressor is much
847 slower but compresses the data slightly more --- currently usually to within a
848 fraction of a percent of the results from WIMGAPI/ImageX.
850 - A workaround has been added for compatibility with versions of WinPE that
851 interpret alternate data stream entries in the boot WIM incorrectly.
853 - An alignment bug that caused a crash in the LZX decompressor on some builds
856 - wimlib now attempts to clear the `WIM_HDR_FLAG_WRITE_IN_PROGRESS` flag in the
857 WIM header when restoring the previous state of a WIM it failed to
860 - Added a workaround to avoid an access denied error on Windows when replacing a
861 WIM file that another process has opened.
865 - wimlib can now open WinPE WIMs from WAIK v2.1, which had a quirk that needed
868 - A bug in the interpretation of negative `IMAGE` indices in the
869 `--update-of=[WIMFILE:]IMAGE` option to `wimlib-imagex capture` and
870 `wimlib-imagex append` has been fixed.
872 - A workaround has been added to successfully apply security descriptors with
873 empty DACLs when the NTFS-3G apply mode is being used with NTFS-3G 2013.1.13
876 - `wimlib-imagex capture` can now accept the `--delta-from` option multiple
881 - Added support for "pipable" WIMs. Pipable WIMs allow capturing images to
882 standard output and applying images from standard input, but they are not
883 compatible with Microsoft's software and are not created by default. See the
884 documentation for `--pipable` flag of `wimlib-imagex capture` for more
887 - To better support incremental backups, added support for declaring an image as
888 a modified form of another image. See the documentation for the `--update-of`
889 option of `wimlib-imagex append` and `wimlib-imagex capture`.
891 - Added supported for "delta" WIMs. See the documentation for the
892 `--delta-from` option of `wimlib-imagex capture`.
894 - The library support for managing split WIMs has been changed to support other
895 arrangements, such as delta WIMs, and be easier to use. This change is
896 visible in `wimlib-imagex`, which also can now accept the `--ref` option
897 multiple times, and also now supports "delta" WIMs as mentioned above.
899 - wimlib now preserves WIM integrity tables by default, even if
900 `WIMLIB_WRITE_FLAG_CHECK_INTEGRITY` is not specified. This changes the
901 behavior of `wimlib-imagex` whenever the WIM being operated on contains
902 an integrity table and the `--check` option is not specified.
904 - `wimlib-imagex capture` now creates LZX-compressed WIMs by default (when
905 `--compress` is not specified). This provides the best compression ratio by
906 default, which is usually what is desired, at a cost of some speed.
908 - `wimlib-imagex` now supports being invoked as `wimCOMMAND`, where `COMMAND` is
909 the command as in `wimlib-imagex COMMAND`; for example, it can be invoked as
910 `wimapply` as an alternative to `wimlib-imagex apply`. The appropriate hard
911 links are created in UNIX installations of `wimlib-imagex`, while for the
912 Windows distribution of `wimlib-imagex`, batch files that emulate this
913 behavior are generated.
915 - Security descriptors are now extracted correctly on Windows.
917 - Fixed archiving DOS names in NTFS-3G capture mode.
919 - The extraction code has been rewritten and it will now be easier to support
920 new features on all supported backends (currently Win32, UNIX, and NTFS-3G).
921 For example, hard-linked extraction mode (`--hardlink`) is now supported on
922 all backends, not just UNIX.
924 - `mkwinpeimg` now supports grabbing files from the WAIK supplement rather
925 than the WAIK itself.
927 - `wimlib_global_init()` now, by default, attempts to acquire additional
928 privileges on Windows, so library clients need not do this.
930 - This update bumps the shared library version number up to 9, since it is not
931 binary compatibible with previous releases.
935 - Fixed bug in `wimlib-imagex export` that made it impossible to export an image
936 from a WIM that is readonly at the filesystem level.
938 - Return error code rather than segfaulting when trying to list files from a
939 non-first part of a split WIM.
941 - Joining a WIM will now preserve the `RP_FIX` and `READONLY` flags.
945 - On Windows, paths given to `wimlib-imagex` are now treated case insensitively.
947 - Improved behavior regarding invalid filenames; in particular, on Windows,
948 `wimlib-imagex` will, when extracting, now omit (with an option to override
949 this default) filenames differing only in case, or filenames containing
950 characters not valid on Windows.
952 - On Windows, wimlib now supports capturing and extracting long paths (longer
953 than the so-called `MAX_PATH`).
955 - On Windows, `wimlib-imagex update` now acquires proper privileges when running
958 - `wimlib-imagex update` will now complain if no image is specified when trying
959 to update a multi-image WIM.
961 - `wimlib-imagex update` now supports specifying a single update command
962 directly on the command line using the `--command` option.
964 - `wimlib-imagex` will now choose different units for progress messages,
965 depending on the amount of data that needs to be processed.
967 - `wimlib-imagex append` will now generate a unique WIM image name if no name is
968 specified and the defaulted name already exists in the WIM.
970 - wimlib now allows you to create unnamed WIM images, which can then only be
971 referred to by index.
973 - wimlib now allows you to explicitly declare you want write access to a WIM by
974 providing the `WIMLIB_OPEN_FLAG_WRITE_ACCESS` flag to `wimlib_open_wim()`.
976 - wimlib now respects the `WIM_HDR_FLAG_READONLY` flag when set in the WIM header.
978 - Progress callbacks have been added to wimlib's `wimlib_update_image()`
981 - Added `wimlib_get_wim_info()`, `wimlib_set_wim_info()`,
982 `wimlib_iterate_dir_tree()`, and `wimlib_iterate_lookup_table()` functions to
985 - NTFS-3G capture now only warns about two conditions previously treated as
988 - Fixed a couple issues with using `wimlib-imagex` on UDF filesystems on
991 - wimlib now correctly detects and returns an error when reading a WIM image
992 with a cyclic directory structure. (Fun fact: such a WIM will crash
993 Microsoft's software.)
997 - Added new "extract" and "update" subcommands to `wimlib-imagex`, along with
998 associated APIs in the library. These commands are intended mainly for
999 Windows use but can be used on UNIX as well.
1001 - Many documentation improvements.
1003 - Fixed a bug in the Windows build where relative symbolic links were not
1004 captured in reparse-point fixup mode.
1006 - Fixed a bug in the Windows build where file handles were left open to the WIM
1007 file, causing `wimlib-imagex optimize` to fail in some cases.
1009 - Fixed a bug in the Windows build of `wimlib-imagex` where globbing split-WIM
1010 parts could cause the program to crash.
1012 - Fixed a bug where the creation time of WIM images would be shown instead of
1013 the last modification time.
1015 - With the Windows build it is now possible to restore a WIM containing symbolic
1016 links as a non-Administrator; however you will receive warnings about not
1017 being able to extract the symbolic links.
1021 - Capturing a WIM image should now be significantly faster in most cases due to
1022 improved use of the operating system's cache and avoiding reading files twice
1025 - The Windows build should now work on Windows XP.
1027 - The Windows build now supports capturing and restoring hidden, compressed,
1028 sparse, and encrypted files.
1030 - The Windows build now supports capturing and applying WIM images from
1031 filesystems other than NTFS (with some reduced functionality).
1033 - The Windows build now extracts short names correctly.
1035 - Added support for "reparse-point" fixups (i.e. fixing up of symbolic links).
1036 See docs for `--rpfix` and `--norpfix` flags of `wimlib-imagex capture` and
1037 `wimlib-imagex apply`.
1039 - The performance of splitting and joining WIMs should be slightly improved.
1041 - The LZX and XPRESS compression and decompression functions are now exported
1046 - Improvements and bugfixes for the Windows build.
1048 - Added `--strict-acls` options.
1050 - Fixed the way that wimlib determines the order of images in the WIM.
1054 - Since wimlib can now be used on Windows, wimlib's implementation of ImageX has
1055 been renamed to `wimlib-imagex` to avoid confusion with Microsoft's
1056 implementation of ImageX, which would have the same file name (`imagex.exe`).
1057 If you really don't like this you can pass the `--with-imagex-progname` option
1058 to `configure` to choose a different name, or even simply rename the binary
1059 yourself (but the former way will configure the man pages to use the chosen
1062 - Various bugs fixed in the Windows build. Mainly to do with capturing and
1063 restoring alternate data streams correctly in weird cases, and requesting the
1064 correct privileges when opening files. Also added the `--noacls` options to
1065 `wimlib-imagex` capture, append, and apply.
1067 - Windows build again: `FindFirstStreamW()` and `FindNextStreamW()` are now
1068 dynamically loaded, so this may make the library compatible with Windows XP
1069 (however, there may still be other problems).
1073 - Added experimental support for native Windows builds. Binaries can be
1074 downloaded from the SourceForge page.
1076 - `--source-list` option added to `imagex capture` and `imagex append`.
1078 - Better support for different character encodings.
1082 - Storing UNIX file owners, groups, and modes in WIM images is now
1083 - possible using `imagex capture` with the `--unix-data` flag.
1085 - Minor bug fixes and documentation fixes.
1089 - NTFS capture: Fixed capturing duplicate reparse points.
1091 - NTFS capture: Capture first unnamed stream if there are more than one (print
1092 warning instead of error).
1094 - Allow multiple test cases to execute concurrently (e.g. `make -j2 check`).
1098 - Added `--arch` switch to mkwinpeimg script to support getting AMD64 WinPE from
1101 - Update to work with ntfs-3g version 2013.1.13.
1105 - Fixed truncating file to shorter but non-zero length on read-write mounted WIM
1108 - Various code cleanups and minor documentation fixes.
1112 - LZX and XPRESS decompression have received some additional optimizations and
1113 should now be even faster. (Although, they were already pretty fast --- much
1114 faster than typical I/O speeds.)
1116 - Fixed a bug introduced in v1.2.1 that would cause a directory tree containing
1117 hard links to be captured incorrectly in some cases.
1121 - By default, unmounting a read-write mounted WIM with `imagex unmount --commit`
1122 will now change the WIM in-place without needing to write the entire WIM
1123 again. Use `imagex unmount --commit --rebuild` to get the old behavior.
1125 - `imagex unmount` no longer has a hard-coded limit of 10 minutes to wait for a
1126 response from the daemon servicing the mounted WIM. Instead, every second
1127 `imagex unmount` will check if the daemon is still alive, and keep waiting if
1128 so, otherwise terminate with an error.
1130 - `imagex unmount --commit` on a read-write mounted WIM will now print progress
1131 information regarding the writing of new or modified streams the WIM, just
1132 like when capturing or appending a WIM.
1134 - A small change has been made to XPRESS compression and it should improve the
1135 compression ratio slightly.
1137 - A change was made that may improve performance slightly when applying a WIM
1138 image to a NTFS volume.
1140 - Microsoft has managed to introduce even more bugs into their software, and now
1141 the WIMs for Windows 8 have incorrect (too low) reference counts for some
1142 streams. This is unsafe because such streams can be removed when they are in
1143 actuality still referenced in the WIM (perhaps by a different image). wimlib
1144 will now work around this problem by fixing the stream reference counts. This
1145 is only done when `wimlib_delete_image()` is called (`imagex delete`) or when
1146 `wimlib_mount_image()` is called with `WIMLIB_MOUNT_FLAG_READWRITE` (`imagex
1147 mountrw`). Please note that this requires reading the metadata for all images
1148 in the WIM, so this will make these operations noticably slower on WIMs with
1151 - Various other bugfixes.
1155 - Appending images to a WIM is now be done by default without re-building the
1156 whole WIM. Use the `--rebuild` flag to get the old behavior (which was to
1157 re-build the entire WIM when a new image is appended).
1159 - A new command `imagex optimize` is now available to manually re-build a WIM
1160 that has wasted space due to repeated appends.
1162 - Progress information has been improved, and now arbitrary callback functions
1163 can be used to show the progress of a WIM operation.
1165 - A possible bug with changing the bootable image of a WIM was fixed.
1167 - Some advisory locking is now done to prevent two processes from modifying a
1168 WIM at the same time (but only in some cases). For example, you cannot mount
1169 two images from a WIM read-write at the same time.
1171 - Some functions have been reorganized:
1172 - `wimlib_mount()` renamed to `wimlib_mount_image()`.
1173 - `wimlib_unmount()` renamed to `wimlib_unmount_image()`.
1174 - `wimlib_overwrite_xml_and_header()` removed as `wimlib_overwrite()` suffices
1176 - `wimlib_apply_image_to_ntfs_volume()` removed as `wimlib_extract_image()`
1178 - `wimlib_add_image_from_ntfs_volume()` removed as `wimlib_add_image()`
1181 - Previously, the soname of libwim.so has been 0.0.0, despite many interface
1182 changes. The soname is now updated to 1.0.0 and will now be updated each
1187 - Resources will now be compressed using multiple threads by default. (This
1188 applies to `imagex capture`, `imagex append`, and `imagex export`).
1190 - Some performance improvements in mounted WIMs.
1192 - More progress information is shown when capturing a WIM.
1196 - Lots of minor fixes, code cleanups, and some documentation updates. Nothing
1197 in particular is really noteworthy.
1201 - LZX and XPRESS compression improvements.
1203 - Fixed calculation of Directory Count, File Count, Total Bytes, and Hard Link
1208 - Fixed bug when capturing NTFS file with multiple named data streams.
1210 - Internally, we are now using inode structures, even though these don't appear
1211 literally in the WIM file. This simplifies some of the code (mainly for WIM
1212 mounting) and likely fixed a few problems, although it needs more testing.
1216 - Fixed problem when exporting images from XPRESS to LZX compressed WIM or vice
1221 - Enough changes to call it version 1.0.0!
1223 - Capturing a WIM directly from a NTFS volume, and applying a WIM directly to a
1224 NTFS volume, is now supported.
1226 - Hard links and symbolic links have much improved support. They are supported
1227 for WIM capture, WIM application, and mounted WIMs (you can even make them on
1228 read-write mounted WIMs).
1230 - Alternate data streams are now supported on mounted WIMs through an xattr or a
1231 Windows-style stream interface. Also they are supported when capturing a WIM
1232 from NTFS or applying a WIM to NTFS.
1234 - Split WIMs are better supported. You may now apply an image directly from a
1235 split WIM, mount an image from a split WIM read-only, or export an image from
1238 - Using a capture configuration file is now supported (but not fully yet).
1240 - SHA1 message digests are checked in more places, so we can make sure applied
1241 and captured data is correct.
1243 - Man pages have been updated and consolidated.
1247 - Fixed segfault when unmounting read-only WIM.
1251 - Support for joining and splitting WIMs.
1253 - Also, security data is now preserved by default.
1257 - Can now build with older gcc and system headers, like on CentOS 5.
1261 - Fixed bug that made it impossible to overwrite files in read-write mount.
1265 - Write byte-order mark before WIM XML data. (`imagex.exe` requires this to be