035c50a0086d5315fc518485cfc6c82fb416f0c1
[wimlib] / NEWS
1 Version 1.7.4-BETA:
2         The Windows binary distribution no longer contains third party DLLs.
3         These dependencies are instead compiled directly into the libwim DLL.
4
5         Added more fixes for wimlib on non-x86 architectures such as ARM.
6
7         Extracting files to a Windows PE in-memory filesystem no longer fails if
8         the target files do not yet exist.
9
10         Improved the performance of XPRESS compression and LZMS decompression.
11
12         Enabled SSSE3 accelerated SHA-1 computation in x86_64 Windows builds.
13         It will automatically be faster on newer Intel and AMD processors.
14
15         Removed the --with-imagex-progname and --enable-more-assertions
16         configure options.
17
18 Version 1.7.3:
19         Fix for very slow export from solid WIM / ESD files.
20
21         Fix for LZX and LZMS algorithms on non-x86 architectures, such as ARM.
22
23         New progress message: WIMLIB_PROGRESS_MSG_HANDLE_ERROR.  Applications
24         may use this to treat some types of errors as non-fatal.
25
26         The library now permits making in-memory changes to a WIMStruct backed
27         by a read-only WIM file.
28
29         Fixes for "WIMBoot" extraction mode (Windows only):
30
31                 When not using the WOF driver, extraction no longer fails if the
32                 disk containing the WIM file has too many partitions.
33
34                 When matching patterns in [PrepopulateList], all hard links of
35                 each file are now considered.
36
37                 The system registry files are now automatically treated as being
38                 in [PrepopulateList].
39
40                 Added a hack to try to work around an intermittent bug in
41                 Microsoft's WOF (Windows Overlay Filesystem) driver.
42
43 Version 1.7.2:
44         Made more improvements to the XPRESS, LZX, and LZMS compressors.
45
46         A number of improvements to the Windows port:
47
48                 Fixes for setting short filenames.
49
50                 Faster "WIMBoot" extraction.
51
52                 Updated and slimmed down the dependent DLLs.
53
54                 ACL inheritence bits are now restored.
55
56                 Mandatory integrity labels are now backed up and restored.
57
58         Added a workaround for an issue where in rare cases, wimlib could create
59         a compressed data stream that could not be read correctly by Windows
60         after an extraction in "WIMBoot" mode.
61
62         Library changes:
63                 Added file count progress data for
64                 WIMLIB_PROGRESS_MSG_EXTRACT_FILE_STRUCTURE and
65                 WIMLIB_PROGRESS_MSG_EXTRACT_METADATA.
66
67                 Added support for testing file exclusions via the user-provided
68                 progress function.
69
70                 Some documentation improvements.
71
72         Made some clarifications to the license text in the COPYING file.
73
74 Version 1.7.1:
75         Made more improvements to the XPRESS, LZX, and LZMS compressors.
76
77         The default compression mode for wimcapture is now LZX compression in
78         its default mode, which is the same as '--compress=maximum'.
79
80         You can now specify an optional integer compression level to the
81         '--compress' option; e.g. '--compress=lzx:75'.
82
83         Made a minor change to the LZMS compressor and decompressor to fix an
84         incompatibility with the Microsoft implementation.  In the unlikely
85         event that you created an LZMS-compressed WIM with wimlib v1.7.0 or
86         earlier and a checksum error is reported when extracting files from it
87         with wimlib v1.7.1, decompress it with v1.7.0 then compress it with
88         v1.7.1.
89
90         Added 'verify' subcommand to wimlib-imagex.
91
92         Notable library changes:
93
94                 Custom compressor parameters have been removed from the library
95                 in favor of the simpler level-based API.
96
97                 Decompressor parameters have been removed entirely.
98
99                 Library users can now specify a custom file for warning and
100                 error messages to be sent to, rather than the default of
101                 standard error.
102
103                 New progress messages:
104                 WIMLIB_PROGRESS_MSG_EXTRACT_FILE_STRUCTURE,
105                 WIMLIB_PROGRESS_MSG_EXTRACT_METADATA.
106
107                 New function: wimlib_verify_wim().
108
109 Version 1.7.0:
110         Improved compression, decompression, and extraction performance.
111
112         Improved compatibility with version 3584 WIM / ESD files:
113             - Add support for reading and writing multiple solid blocks per
114               archive, which WIMGAPI/DISM can create when appending an image.
115             - Correctly create solid blocks larger than 4 GiB.
116
117         'add' commands passed to wimupdate will now replace existing
118         nondirectory files by default.  Use the --no-replace option to get the
119         old behavior.
120
121         The license for the library now contains an exception that allows using
122         it under the LGPL.  See the COPYING file for details.
123
124         In reparse-point fixup mode (the default for capture), symbolic links
125         and junctions that point outside the tree being captured are no longer
126         excluded from capture.
127
128         Added support for "WIMBoot" capture and extraction.  See the
129         documentation for the new '--wimboot' option to wimcapture and wimapply
130         for more information.
131
132         On UNIX-like systems, you can now backup and restore device nodes, named
133         pipes, and sockets.  In addition, 32-bit user and group IDs are now
134         supported.
135
136         The way that UNIX data is stored in WIM files has been changed.  If you
137         captured any WIMs with the --unix-data option, to upgrade them you'll
138         need to apply them with --unix-data using wimlib-imagex v1.6.2, then
139         re-capture them with --unix-data using this version.
140
141         wimlib now understands tagged metadata items, such as object IDs, that
142         can be stored in WIM directory entries.
143
144         Removed the --hardlink and --symlink options to wimapply, since I don't
145         think they are too useful and they got in the way of improving the code.
146
147         WIMs will now retain their GUIDs when rebuilt (e.g. with wimoptimize).
148
149         The 'mkwinpeimg' script now supports writing the ISO image to standard
150         output.
151
152         The <ARCH> element in WIM XML data is now exported correctly.
153
154         On Windows, sparse file attributes are no longer set on extracted files.
155         Oddly enough, this actually saves disk space in some cases.
156
157         On UNIX, configuring with --disable-xattr or --enable-xattr is no longer
158         supported.  Mounting WIM images now always requires extended attribute
159         support.  Use --without-fuse to disable support for mounting WIM images;
160         this will also disable the need for extended attribute support.
161
162         Configuring with --enable-ssse3-sha1 now works correctly.
163
164         The shared library version has been bumped up.  The main
165         incompatibilities are:
166
167                 - WIMLIB_COMPRESSION_TYPE_XPRESS is now 1 and
168                   WIMLIB_COMPRESSION_TYPE_LZX is now 2 (so it's the same as
169                   WIMGAPI).
170
171                 - User-provided progress functions are now registered using a
172                   separate function, wimlib_register_progress_function().  The
173                   'progress_func' argument to many functions no longer exists.
174
175                 - The return value from user-provided progress functions is now
176                   significant.
177
178                 - A context argument has been added to the prototype of
179                   user-provided progress functions.
180
181                 - 'struct wimlib_capture_config' has been removed.  The library
182                   now takes the path to the configuration file directly.  This
183                   affects wimlib_add_image(), wimlib_add_image_multisource(),
184                   and wimlib_update_image().  However, a NULL value passed in
185                   the argument retains the same meaning.
186
187                 - Removed deprecated functions: some (de)compression functions,
188                   wimlib_extract_files(), and wimlib_print_metadata().
189
190                 - Removed extraction flags: WIMLIB_EXTRACT_FLAG_HARDLINK,
191                   WIMLIB_EXTRACT_FLAG_SYMLINK, WIMLIB_EXTRACT_FLAG_FILE_ORDER,
192                   and WIMLIB_EXTRACT_FLAG_SEQUENTIAL.
193
194                 - Removed some progress messages:
195                   WIMLIB_PROGRESS_MSG_APPLY_TIMESTAMPS,
196                   WIMLIB_PROGRESS_MSG_EXTRACT_DIR_STRUCTURE_BEGIN,
197                   WIMLIB_PROGRESS_MSG_EXTRACT_DIR_STRUCTURE_END.  Numbering
198                   stays the same.
199
200                 - Removed some error codes.  Numbering stays the same.
201
202                 - Replaced WIMLIB_UNMOUNT_FLAG_LAZY with
203                   WIMLIB_UNMOUNT_FLAG_FORCE.
204
205                 - WIM paths passed to progress functions now have a leading
206                   slash.
207
208 Version 1.6.2:
209         Case-insensitive comparisons of strings (e.g. filenames) containing
210         UTF-16 codepoints above 32767 are now done correctly.
211
212         Fixed build failure on Mac OS X.
213
214         wimunmount now provides the '--new-image' option to cause changes to a
215         read-write mounted image to be committed as a new image rather than as
216         an update of the mounted image.  (The corresponding new library flag is
217         WIMLIB_UNMOUNT_FLAG_NEW_IMAGE.)
218
219         The LZMS ("recovery") compression chunk size, or "dictionary size", may
220         now be up to 1 GiB (1,073,741,824 bytes).
221
222         The performance of LZX ("maximum") and LZMS ("recovery") compression
223         with large chunk sizes has been slightly improved.
224
225 Version 1.6.1:
226         Stored files with size exactly 4 GiB (4,294,967,296 bytes) are now
227         decompressed correctly.
228
229         Fixed a bug in the LZX compressor introduced in v1.5.3.  The bug
230         occurred in an unlikely case, and due to validity checks it did not
231         affect successfully created archives.
232
233         Fixed a minor compatibility issue with the LZMS compressor and
234         decompressor.  This is *not* the default compression type and was only
235         introduced in v1.6.0.  In the unlikely event that you created an
236         LZMS-compressed WIM with v1.6.0 and a checksum error is reported when
237         applying it with v1.6.1, decompress it with v1.6.0 then compress it with
238         v1.6.1.
239
240         Memory usage for LZMS and LZX compression has been decreased.
241
242         wimextract now allows wildcard characters in paths specified on the
243         command line.  Also, the '--strict-wildcards' option has been removed
244         and replaced with the inverse option '--nullglob'.  See the
245         documentation for wimextract for more details and changes.
246
247         The wimlib_extract_files() function is now considered deprecated in
248         favor of wimlib_extract_paths().
249
250         Fixed more permissions problems when extracting files on Windows.
251
252         A new '--no-attributes' option has been added to wimapply and
253         wimextract.  The library flag is WIMLIB_EXTRACT_FLAG_NO_ATTRIBUTES.
254
255         The default chunk size is now set correctly when changing the
256         compression type of a WIM, for example with 'wimoptimize'.
257
258         The '--metadata' option to wiminfo has been replaced with the
259         '--detailed' option to wimdir.
260
261         In relevant wimlib-imagex commands, '--solid' may now be used as an
262         alias for '--pack-streams'.
263
264 Version 1.6.0:
265         Support for extracting and updating the new version 3584 WIMs has been
266         added.  These WIMs typically pack many streams ("files") together into a
267         single compressed resource, thereby saving space.  This degrades the
268         performance of random access (such as that which occurs on a mounted
269         image), but optimizations have been implemented for extraction.  These
270         new WIM files also typically use a new compression format (LZMS), which
271         is similar to LZMA and can offer a better compression ratio than LZX.
272         These new WIM files can be created using `wimcapture' with
273         the '--compress=lzms --pack-streams' options.  Note: this new WIM format
274         is used by the Windows 8 web downloader, but important segments of the
275         raw '.esd' files are encrypted, so wimlib will not be able to extract
276         such files until they are first decrypted.
277
278         wimlib now supports extracting files and directories from a WIM image
279         based on a "listfile" that itself contains the list of paths to extract.
280         For `wimextract', the syntax is to specify @LISTFILE instead of a PATH,
281         and for the library itself, the new APIs are wimlib_extract_pathlist()
282         and wimlib_extract_paths().  Path globs containing wildcard characters
283         are supported.
284
285         For searching WIM files, wimlib now has configurable case sensitivity.
286         The default on Windows is still case-insensitive and the default on
287         UNIX-like systems is still case-sensitive, but this can be overridden
288         on either platform through flags to wimlib_global_init().  For
289         `wimlib-imagex', the environmental variable WIMLIB_IMAGEX_IGNORE_CASE
290         can be set to 1 or 0 for case-insensitive or case-sensitive behavior,
291         respectively.
292
293         Support for compression chunk sizes greater than the default of 32768
294         bytes has been added.  A larger chunk size typically results in a better
295         compression ratio.  However, the MS implementation is seemingly not
296         compatible with all chunk sizes, especially for LZX compression, so the
297         defaults remain unchanged, with the exception of the new LZMS-compressed
298         WIMs, which use a larger chunk size by default.
299
300         The compression/decompression API exported by wimlib has been changed.
301         Now one set of functions handles all supported compression formats.
302
303         `wimcapture' and `wimappend' will now display the progress of scanning
304         the directory tree to capture, in addition to the progress of writing
305         data to the WIM.  The '--verbose' option no longer does anything.  The
306         library API change for this is the addition of several members to
307         `struct wimlib_progress_info_scan' available to progress callbacks.
308
309         `mkwinpeimg' now correctly handles the '--start-script' option when the
310         start script is not in the working directory.
311
312         Sequential extraction, previously requested by using
313         WIMLIB_EXTRACT_FLAG_SEQUENTIAL, is now the default.
314         WIMLIB_EXTRACT_FLAG_FILE_ORDER can be used to get the old default
315         behavior (extract in file order).
316
317 Version 1.5.3:
318         The new LZX compressor added in v1.5.2 has been improved and is now
319         enabled by default, except when `wimcapture' or `wimappend' is run
320         *without* the '--compress' option, in which case the faster LZX
321         compressor is used (the same as before).  This behavior is reasonably
322         consistent with ImageX which actually uses "fast" (XPRESS) compression
323         by default.  In those cases, use '--compress=maximum' to explicitly
324         capture a WIM image using the new (slower but better) LZX compressor.
325
326         The '--compress-slow' option still exists to `wimlib-imagex optimize',
327         but its new behavior is to tweak the new LZX compressor even more to
328         produce an even better compression ratio at the cost of more time spent
329         compressing.
330
331         `wimlib-imagex optimize' now supports the '--compress=TYPE' option,
332         which recompresses the WIM file using the specified compression TYPE.
333         The new library API function used for this is
334         wimlib_set_output_compression_type().
335
336         Added the wimlib_get_xml_data() function to allow library clients to
337         easily retrieve the raw XML data from a WIM file if needed.
338
339         Fixed a bug that could cause an error code to be incorrectly returned
340         when writing XML data containing a <WINDOWS> element.
341
342         Mounted WIM images will now correctly show the default file stream even
343         if appears in the alternate data stream entries of the corresponding WIM
344         directory entry.
345
346 Version 1.5.2:
347         Added a new experimental LZX compressor which can be enabled by passing
348         '--compress-slow' to `wimlib-imagex capture' or `wimlib-imagex
349         optimize'.  (The latter is only applicable if the WIM is already
350         LZX-compressed and the '--recompress' option is also given.)  The
351         experimental compressor is much slower but compresses the data slightly
352         more --- currently usually to within a fraction of a percent of the
353         results from WIMGAPI/ImageX.
354
355         A workaround has been added for compatibility with versions of WinPE
356         that interpret alternate data stream entries in the boot WIM
357         incorrectly.
358
359         An alignment bug that caused a crash in the LZX decompressor on some
360         builds was fixed.
361
362         wimlib now attempts to clear the WIM_HDR_FLAG_WRITE_IN_PROGRESS flag in
363         the WIM header when restoring the previous state of a WIM it failed to
364         successfully update.
365
366         Added a workaround to avoid an access denied error on Windows when
367         replacing a WIM file that another process has opened.
368
369 Version 1.5.1:
370         wimlib can now open WinPE WIMs from WAIK v2.1, which had a quirk that
371         needed to be handled.
372
373         A bug in the interpretation of negative IMAGE indices in the
374         --update-of=[WIMFILE:]IMAGE option to `wimlib-imagex capture' and
375         `wimlib-imagex append' has been fixed.
376
377         A workaround has been added to successfully apply security descriptors
378         with empty DACLs when the NTFS-3g apply mode is being used with NTFS-3g
379         2013.1.13 or earlier.
380
381         `wimlib-imagex capture' can now accept the '--delta-from' option
382         multiple times.
383
384 Version 1.5.0:
385         Added support for "pipable" WIMs.  Pipable WIMs allow capturing images
386         to standard output and applying images from standard input, but they are
387         not compatible with Microsoft's software and are not created by default.
388         See the documentation for --pipable flag of `wimlib-imagex capture' for
389         more information.
390
391         To better support incremental backups, added support for declaring an
392         image as a modified form of another image.  See the documentation for
393         the '--update-of' option of `wimlib-imagex append' and `wimlib-imagex
394         capture'.
395
396         Added supported for "delta" WIMs.  See the documentation for the
397         '--delta-from' option of `wimlib-imagex capture'.
398
399         The library support for managing split WIMs has been changed to support
400         other arrangements, such as delta WIMs, and be easier to use.  This
401         change is visible in `wimlib-imagex', which also can now accept the
402         '--ref' option multiple times, and also now supports "delta" WIMs as
403         mentioned above.
404
405         wimlib now preserves WIM integrity tables by default, even if
406         WIMLIB_WRITE_FLAG_CHECK_INTEGRITY is not specified.  This changes the
407         behavior of `wimlib-imagex' whenever the WIM being operated on contains
408         an integrity table and the '--check' option is not specified.
409
410         `wimlib-imagex capture' now creates LZX-compressed WIMs by default
411         (when --compress is not specified).  This provides the best compression
412         ratio by default, which is usually what is desired, at a cost of some
413         speed.
414
415         `wimlib-imagex' now supports being invoked as wimCOMMAND, where COMMAND
416         is the command as in `wimlib-imagex COMMAND'; for example, it can be
417         invoked as `wimapply' as an alternative to `wimlib-imagex apply'.  The
418         appropriate hard links are created in UNIX installations of
419         `wimlib-imagex', while for the Windows distribution of `wimlib-imagex',
420         batch files that emulate this behavior are generated.
421
422         Security descriptors are now extracted correctly on Windows.
423
424         Fixed archiving DOS names in NTFS-3g capture mode.
425
426         The extraction code has been rewritten and it will now be easier to
427         support new features on all supported backends (currently Win32, UNIX,
428         and NTFS-3g).  For example, hard-linked extraction mode (--hardlink) is
429         now supported on all backends, not just UNIX.
430
431         `mkwinpeimg' now supports grabbing files from the WAIK supplement rather
432         than the WAIK itself.
433
434         wimlib_global_init() now, by default, attempts to acquire additional
435         privileges on Windows, so library clients need not do this.
436
437         This update bumps the shared library version number up to 9, since it is
438         not binary compatibible with previous releases.
439
440 Version 1.4.2:
441         Fixed bug in `wimlib-imagex export' that made it impossible to export an
442         image from a WIM that is readonly at the filesystem level.
443
444         Return error code rather than segfaulting when trying to list files from
445         a non-first part of a split WIM.
446
447         Joining a WIM will now preserve the RP_FIX and READONLY flags.
448
449 Version 1.4.1:
450         On Windows, paths given to wimlib-imagex are now treated case
451         insensitively.
452
453         Improved behavior regarding invalid filenames; in particular, on
454         Windows, wimlib-imagex will, when extracting, now omit (with an option
455         to override this default) filenames differing only in case, or filenames
456         containing characters not valid on Windows.
457
458         On Windows, wimlib now supports capturing and extracting long paths
459         (longer than the so-called MAX_PATH).
460
461         On Windows, `wimlib-imagex update' now acquires proper privileges when
462         running as an Administrator.
463
464         `wimlib-imagex update' will now complain if no image is specified when
465         trying to update a multi-image WIM.
466
467         `wimlib-imagex update' now supports specifying a single update command
468         directly on the command line using the --command option.
469
470         wimlib-imagex will now choose different units for progress messages,
471         depending on the amount of data that needs to be processed.
472
473         `wimlib-imagex append' will now generate a unique WIM image name if no
474         name is specified and the defaulted name already exists in the WIM.
475
476         wimlib now allows you to create unnamed WIM images, which can then only
477         be referred to by index.
478
479         wimlib now allows you to explicitly declare you want write access to a
480         WIM by providing the WIMLIB_OPEN_FLAG_WRITE_ACCESS flag to
481         wimlib_open_wim().
482
483         wimlib now respects the WIM_HDR_FLAG_READONLY flag when set in the WIM
484         header.
485
486         Progress callbacks have been added to wimlib's wimlib_update_image()
487         function.
488
489         Added wimlib_get_wim_info(), wimlib_set_wim_info(),
490         wimlib_iterate_dir_tree(), and wimlib_iterate_lookup_table() functions
491         to the library.
492
493         NTFS-3g capture now only warns about two conditions previously treated
494         as errors.
495
496         Fixed a couple issues with using wimlib-imagex on UDF filesystems on
497         Windows.
498
499         wimlib now correctly detects and returns an error when reading a WIM
500         image with a cyclic directory structure.  (Fun fact: such a WIM will
501         crash Microsoft's software.)
502
503 Version 1.4.0:
504         Added new "extract" and "update" subcommands to wimlib-imagex, along
505         with associated APIs in the library.  These commands are intended mainly
506         for Windows use but can be used on UNIX as well.
507
508         Many documentation improvements.
509
510         Fixed a bug in the Windows build where relative symbolic links were not
511         captured in reparse-point fixup mode.
512
513         Fixed a bug in the Windows build where file handles were left open to
514         the WIM file, causing `wimlib_imagex optimize' to fail in some cases.
515
516         Fixed a bug in the Windows build of wimlib-imagex where globbing
517         split-WIM parts could cause the program to crash.
518
519         Fixed a bug where the creation time of WIM images would be shown instead
520         of the last modification time.
521
522         With the Windows build it is now possible to restore a WIM containing
523         symbolic links as a non-Administrator; however you will receive warnings
524         about not being able to extract the symbolic links.
525
526 Version 1.3.3:
527         Capturing a WIM image should now be significantly faster in most cases
528         due to improved use of the operating system's cache and avoiding reading
529         files twice whenever possible.
530
531         The Windows build should now work on Windows XP.
532
533         The Windows build now supports capturing and restoring hidden,
534         compressed, sparse, and encrypted files.
535
536         The Windows build now supports capturing and applying WIM images from
537         filesystems other than NTFS (with some reduced functionality).
538
539         The Windows build now extracts short names correctly.
540
541         Added support for "reparse-point" fixups (i.e. fixing up of symbolic
542         links).  See docs for --rpfix and --norpfix flags of `wimlib-imagex
543         capture' and `wimlib-imagex apply'.
544
545         The performance of splitting and joining WIMs should be slightly
546         improved.
547
548         The LZX and XPRESS compression and decompression functions are now
549         exported from the library.
550
551 Version 1.3.2:
552         Improvements and bugfixes for the Windows build.
553
554         Added --strict-acls options.
555
556         Fixed the way that wimlib determines the order of images in the WIM.
557
558 Version 1.3.1:
559         Since wimlib can now be used on Windows, wimlib's implementation of
560         ImageX has been renamed to wimlib-imagex to avoid confusion with
561         Microsoft's implementation of ImageX, which would have the same file
562         name ("imagex.exe").  If you really don't like this you can pass the
563         --with-imagex-progname option to `configure' to choose a different name,
564         or even simply rename the binary yourself (but the former way will
565         configure the man pages to use the chosen name).
566
567         Various bugs fixed in the Windows build.  Mainly to do with capturing
568         and restoring alternate data streams correctly in weird cases, and
569         requesting the correct privileges when opening files.  Also added the
570         --noacls options to wimlib-imagex capture, append, and apply.
571
572         Windows build again: FindFirstStreamW() and FindNextStreamW() are now
573         dynamically loaded, so this may make the library compatible with Windows
574         XP (however, there may still be other problems).
575
576 Version 1.3.0:
577         Added experimental support for native Windows builds.  Binaries can be
578         downloaded from the SourceForge page.
579
580         --source-list option added to `imagex capture' and `imagex append'.
581
582         Better support for different character encodings.
583
584 Version 1.2.6:
585         Storing UNIX file owners, groups, and modes in WIM images is now
586         possible using `imagex capture' with the --unix-data flag.
587
588         Minor bug fixes and documentation fixes.
589
590 Version 1.2.5:
591         NTFS capture: Fixed capturing duplicate reparse points.
592
593         NTFS capture: Capture first unnamed stream if there are more than one
594         (print warning instead of error).
595
596         Allow multiple test cases to execute concurrently (e.g. make -j2 check).
597
598 Version 1.2.4:
599         Added --arch switch to mkwinpeimg script to support getting AMD64 WinPE
600         from the WAIK.
601
602         Update to work with ntfs-3g version 2013.1.13.
603
604 Version 1.2.3:
605         Fixed truncating file to shorter but non-zero length on read-write
606         mounted WIM image.
607
608         Various code cleanups and minor documentation fixes.
609
610 Version 1.2.2:
611         LZX and XPRESS decompression have received some additional optimizations
612         and should now be even faster.  (Although, they were already pretty
613         fast--- much faster than typical I/O speeds.)
614
615         Fixed a bug introduced in v1.2.1 that would cause a directory tree
616         containing hard links to be captured incorrectly in some cases.
617
618 Version 1.2.1:
619         By default, unmounting a read-write mounted WIM with 'imagex unmount
620         --commit' will now change the WIM in-place without needing to write the
621         entire WIM again.  Use 'imagex unmount --commit --rebuild' to get the
622         old behavior.
623
624         'imagex unmount' no longer has a hard-coded limit of 10 minutes to wait
625         for a response from the daemon servicing the mounted WIM.  Instead,
626         every second 'imagex unmount' will check if the daemon is still alive,
627         and keep waiting if so, otherwise terminate with an error.
628
629         'imagex unmount --commit' on a read-write mounted WIM will now print
630         progress information regarding the writing of new or modified streams
631         the WIM, just like when capturing or appending a WIM.
632
633         A small change has been made to XPRESS compression and it should improve
634         the compression ratio slightly.
635
636         A change was made that may improve performance slightly when applying a
637         WIM image to a NTFS volume.
638
639         Microsoft has managed to introduce even more bugs into their software,
640         and now the WIMs for Windows 8 have incorrect (too low) reference counts
641         for some streams.  This is unsafe because such streams can be removed
642         when they are in actuality still referenced in the WIM (perhaps by a
643         different image).  wimlib will now work around this problem by fixing
644         the stream reference counts.  This is only done when wimlib_delete_image() is
645         called ('imagex delete') or when wimlib_mount_image() is called with
646         WIMLIB_MOUNT_FLAG_READWRITE ('imagex mountrw').  Please note that this
647         requires reading the metadata for all images in the WIM, so this will
648         make these operations noticably slower on WIMs with multiple images.
649
650         Various other bugfixes.
651
652 Version 1.2.0:
653         Appending images to a WIM is now be done by default without re-building
654         the whole WIM.  Use the --rebuild flag to get the old behavior (which
655         was to re-build the entire WIM when a new image is appended).
656
657         A new command `imagex optimize' is now available to manually re-build a
658         WIM that has wasted space due to repeated appends.
659
660         Progress information has been improved, and now arbitrary callback
661         functions can be used to show the progress of a WIM operation.
662
663         A possible bug with changing the bootable image of a WIM was fixed.
664
665         Some advisory locking is now done to prevent two processes from
666         modifying a WIM at the same time (but only in some cases).  For example,
667         you cannot mount two images from a WIM read-write at the same time.
668
669         Some functions have been reorganized:
670                 * wimlib_mount() renamed to wimlib_mount_image().
671                 * wimlib_unmount() renamed to wimlib_unmount_image().
672                 * wimlib_overwrite_xml_and_header() removed as
673                 wimlib_overwrite() suffices now.
674                 * wimlib_apply_image_to_ntfs_volume() removed as
675                 wimlib_extract_image() suffices now.
676                 * wimlib_add_image_from_ntfs_volume() removed as
677                 * wimlib_add_image() suffices now.
678
679         Previously, the soname of libwim.so has been 0.0.0, despite many
680         interface changes.  The soname is now updated to 1.0.0 and will now be
681         updated each release.
682
683 Version 1.1.0:
684         Resources will now be compressed using multiple threads by default.
685         (This applies to `imagex capture', `imagex append', and `imagex
686         export').
687
688         Some performance improvements in mounted WIMs.
689
690         More progress information is shown when capturing a WIM.
691
692 Version 1.0.4:
693         Lots of minor fixes, code cleanups, and some documentation updates.
694         Nothing in particular is really noteworthy.
695
696 Version 1.0.3:
697         LZX and XPRESS compression improvements.
698
699         Fixed calculation of Directory Count, File Count, Total Bytes, and Hard
700         Link Bytes of the WIM.
701
702 Version 1.0.2:
703         Fixed bug when capturing NTFS file with multiple named data streams.
704
705         Internally, we are now using inode structures, even though these don't
706         appear literally in the WIM file.  This simplifies some of the code
707         (mainly for WIM mounting) and likely fixed a few problems, although it
708         needs more testing.
709
710 Version 1.0.1:
711         Fixed problem when exporting images from XPRESS to LZX compressed WIM or
712         vice versa
713
714 Version 1.0.0:
715         Enough changes to call it version 1.0.0!
716
717         Capturing a WIM directly from a NTFS volume, and applying a WIM directly
718         to a NTFS volume, is now supported.
719
720         Hard links and symbolic links have much improved support.  They are
721         supported for WIM capture, WIM application, and mounted WIMs (you can
722         even make them on read-write mounted WIMs).
723
724         Alternate data streams are now supported on mounted WIMs through an
725         xattr or a Windows-style stream interface.  Also they are supported when
726         capturing a WIM from NTFS or applying a WIM to NTFS.
727
728         Split WIMs are better supported.  You may now apply an image directly
729         from a split WIM, mount an image from a split WIM read-only, or export
730         an image from a split WIM.
731
732         Using a capture configuration file is now supported (but not fully yet).
733
734         SHA1 message digests are checked in more places, so we can make sure
735         applied and captured data is correct.
736
737         Man pages have been updated and consolidated.
738
739 Version 0.7.2:
740         Fixed segfault when unmounting read-only WIM.
741
742 Version 0.7.1:
743         Support for joining and splitting WIMs.
744         Also, security data is now preserved by default.
745
746 Version 0.6.3:
747         Can now build with older gcc and system headers, like on CentOS 5.
748
749 Version 0.6.2:
750         Fixed bug that made it impossible to overwrite files in read-write
751         mount.
752
753 Version 0.6.1:
754         Write byte-order mark before WIM XML data.  (imagex.exe requires this to
755         be there.)