X-Git-Url: https://wimlib.net/git/?p=wimlib;a=blobdiff_plain;f=NEWS;h=89b5b93da6aa857c9ef38890dc0ddd5e2a712992;hp=f9ae5ef84fea9c3300623d5c94d703836dd4c497;hb=d6fc4b4b31c5d85847b5f471988e5ce734c31a70;hpb=9c65a5d8e7c2282a5c944dde998f05f005ab480d diff --git a/NEWS b/NEWS index f9ae5ef8..89b5b93d 100644 --- a/NEWS +++ b/NEWS @@ -1,12 +1,264 @@ Only the most important changes more recent than version 0.6 are noted here. -Version 1.3.4: +Version 1.6.0: + Support for extracting and updating the new version 3584 WIMs has been + added. These WIMs typically pack many streams ("files") together into a + single compressed resource, thereby saving space. This degrades the + performance of random access (such as that which occurs on a mounted + image), but optimizations have been implemented for extraction. These + new WIM files also typically use a new compression format (LZMS), which + is similar to LZMA and can offer a better compression ratio than LZX. + These new WIM files can be created with Dism using '/compress recovery', + or using `wimcapture' using '--pack-streams', although wimlib's LZMS + compressor is not yet very good, the latter is not recommended. Note: + this new WIM format is used by the Windows 8 web downloader, but + important segments of the raw '.esd' files are encrypted, so wimlib will + not be able to extract such files until they are first decrypted. + + wimlib now supports extracting files and directories from a WIM image + based on a "listfile" that itself contains the list of paths to extract. + For `wimextract', the syntax is to specify @LISTFILE instead of a PATH, + and for the library itself, the new APIs are wimlib_extract_pathlist() + and wimlib_extract_paths(). Path globs containing wildcard characters + are supported. + + For searching WIM files, wimlib now has configurable case sensitivity. + The default on Windows is still case-insensitive and the default on + UNIX-like systems is still case-sensitive, but this can be overwridden + on either platform through flags to wimlib_global_init(). For + `wimlib-imagex', the environmental variable WIMLIB_IMAGEX_IGNORE_CASE + can be set to 1 or 0 for case-insensitive or case-sensitive behavior, + respectively. + + Support for compression chunk sizes greater than the default of 32768 + bytes has been added. A larger chunk size typically results in a better + compression ratio. However, the MS implementation is seemingly not + compatible with all chunk sizes, especially for LZX compression, so the + defaults remain unchanged, with the exception of the new LZMS-compressed + WIMs, which use a larger chunk size by default. + + The compression/decompression API exported by wimlib has been changed. + Now one set of functions handles all supported compression formats. + + `wimcapture' and `wimappend' will now display the progress of scanning + the directory tree to capture, in addition to the progress of writing + data to the WIM. The '--verbose' option no longer does anything. The + library API change for this is the addition of several members to + `struct wimlib_progress_info_scan' available to progress callbacks. + + `mkwinpeimg' now correctly handles the '--start-script' option when the + start script is not in the working directory. + + Sequential extraction, previously requested by using + WIMLIB_EXTRACT_FLAG_SEQUENTIAL, is now the default. + WIMLIB_EXTRACT_FLAG_FILE_ORDER can be used to get the old default + behavior (extract in file order). + +Version 1.5.3: + The new LZX compressor added in v1.5.2 has been improved and is now + enabled by default, except when `wimcapture' or `wimappend' is run + *without* the '--compress' option, in which case the faster LZX + compressor is used (the same as before). This behavior is reasonably + consistent with ImageX which actually uses "fast" (XPRESS) compression + by default. In those cases, use '--compress=maximum' to explicitly + capture a WIM image using the new (slower but better) LZX compressor. + + The '--compress-slow' option still exists to `wimlib-imagex optimize', + but its new behavior is to tweak the new LZX compressor even more to + produce an even better compression ratio at the cost of more time spent + compressing. + + `wimlib-imagex optimize' now supports the '--compress=TYPE' option, + which recompresses the WIM file using the specified compression TYPE. + The new library API function used for this is + wimlib_set_output_compression_type(). + + Added the wimlib_get_xml_data() function to allow library clients to + easily retrieve the raw XML data from a WIM file if needed. + + Fixed a bug that could cause an error code to be incorrectly returned + when writing XML data containing a element. + + Mounted WIM images will now correctly show the default file stream even + if appears in the alternate data stream entries of the corresponding WIM + directory entry. + +Version 1.5.2: + Added a new experimental LZX compressor which can be enabled by passing + '--compress-slow' to `wimlib-imagex capture' or `wimlib-imagex + optimize'. (The latter is only applicable if the WIM is already + LZX-compressed and the '--recompress' option is also given.) The + experimental compressor is much slower but compresses the data slightly + more --- currently usually to within a fraction of a percent of the + results from WIMGAPI/ImageX. + + A workaround has been added for compatibility with versions of WinPE + that interpret alternate data stream entries in the boot WIM + incorrectly. + + An alignment bug that caused a crash in the LZX decompressor on some + builds was fixed. + + wimlib now attempts to clear the WIM_HDR_FLAG_WRITE_IN_PROGRESS flag in + the WIM header when restoring the previous state of a WIM it failed to + successfully update. + + Added a workaround to avoid an access denied error on Windows when + replacing a WIM file that another process has opened. + +Version 1.5.1: + wimlib can now open WinPE WIMs from WAIK v2.1, which had a quirk that + needed to be handled. + + A bug in the interpretation of negative IMAGE indices in the + --update-of=[WIMFILE:]IMAGE option to `wimlib-imagex capture' and + `wimlib-imagex append' has been fixed. + + A workaround has been added to successfully apply security descriptors + with empty DACLs when the NTFS-3g apply mode is being used with NTFS-3g + 2013.1.13 or earlier. + + `wimlib-imagex capture' can now accept the '--delta-from' option + multiple times. + +Version 1.5.0: + Added support for "pipable" WIMs. Pipable WIMs allow capturing images + to standard output and applying images from standard input, but they are + not compatible with Microsoft's software and are not created by default. + See the documentation for --pipable flag of `wimlib-imagex capture' for + more information. + + To better support incremental backups, added support for declaring an + image as a modified form of another image. See the documentation for + the '--update-of' option of `wimlib-imagex append' and `wimlib-imagex + capture'. + + Added supported for "delta" WIMs. See the documentation for the + '--delta-from' option of `wimlib-imagex capture'. + + The library support for managing split WIMs has been changed to support + other arrangements, such as delta WIMs, and be easier to use. This + change is visible in `wimlib-imagex', which also can now accept the + '--ref' option multiple times, and also now supports "delta" WIMs as + mentioned above. + + wimlib now preserves WIM integrity tables by default, even if + WIMLIB_WRITE_FLAG_CHECK_INTEGRITY is not specified. This changes the + behavior of `wimlib-imagex' whenever the WIM being operated on contains + an integrity table and the '--check' option is not specified. + + `wimlib-imagex capture' now creates LZX-compressed WIMs by default + (when --compress is not specified). This provides the best compression + ratio by default, which is usually what is desired, at a cost of some + speed. + + `wimlib-imagex' now supports being invoked as wimCOMMAND, where COMMAND + is the command as in `wimlib-imagex COMMAND'; for example, it can be + invoked as `wimapply' as an alternative to `wimlib-imagex apply'. The + appropriate hard links are created in UNIX installations of + `wimlib-imagex', while for the Windows distribution of `wimlib-imagex', + batch files that emulate this behavior are generated. + + Security descriptors are now extracted correctly on Windows. + + Fixed archiving DOS names in NTFS-3g capture mode. + + The extraction code has been rewritten and it will now be easier to + support new features on all supported backends (currently Win32, UNIX, + and NTFS-3g). For example, hard-linked extraction mode (--hardlink) is + now supported on all backends, not just UNIX. + + `mkwinpeimg' now supports grabbing files from the WAIK supplement rather + than the WAIK itself. + + wimlib_global_init() now, by default, attempts to acquire additional + privileges on Windows, so library clients need not do this. + + This update bumps the shared library version number up to 9, since it is + not binary compatibible with previous releases. + +Version 1.4.2: + Fixed bug in `wimlib-imagex export' that made it impossible to export an + image from a WIM that is readonly at the filesystem level. + + Return error code rather than segfaulting when trying to list files from + a non-first part of a split WIM. + + Joining a WIM will now preserve the RP_FIX and READONLY flags. + +Version 1.4.1: + On Windows, paths given to wimlib-imagex are now treated case + insensitively. + + Improved behavior regarding invalid filenames; in particular, on + Windows, wimlib-imagex will, when extracting, now omit (with an option + to override this default) filenames differing only in case, or filenames + containing characters not valid on Windows. + + On Windows, wimlib now supports capturing and extracting long paths + (longer than the so-called MAX_PATH). + + On Windows, `wimlib-imagex update' now acquires proper privileges when + running as an Administrator. + + `wimlib-imagex update' will now complain if no image is specified when + trying to update a multi-image WIM. + + `wimlib-imagex update' now supports specifying a single update command + directly on the command line using the --command option. + + wimlib-imagex will now choose different units for progress messages, + depending on the amount of data that needs to be processed. + + `wimlib-imagex append' will now generate a unique WIM image name if no + name is specified and the defaulted name already exists in the WIM. + + wimlib now allows you to create unnamed WIM images, which can then only + be referred to by index. + + wimlib now allows you to explicitly declare you want write access to a + WIM by providing the WIMLIB_OPEN_FLAG_WRITE_ACCESS flag to + wimlib_open_wim(). + + wimlib now respects the WIM_HDR_FLAG_READONLY flag when set in the WIM + header. + + Progress callbacks have been added to wimlib's wimlib_update_image() + function. + + Added wimlib_get_wim_info(), wimlib_set_wim_info(), + wimlib_iterate_dir_tree(), and wimlib_iterate_lookup_table() functions + to the library. + + NTFS-3g capture now only warns about two conditions previously treated + as errors. + + Fixed a couple issues with using wimlib-imagex on UDF filesystems on + Windows. + + wimlib now correctly detects and returns an error when reading a WIM + image with a cyclic directory structure. (Fun fact: such a WIM will + crash Microsoft's software.) + +Version 1.4.0: + Added new "extract" and "update" subcommands to wimlib-imagex, along + with associated APIs in the library. These commands are intended mainly + for Windows use but can be used on UNIX as well. + + Many documentation improvements. + Fixed a bug in the Windows build where relative symbolic links were not captured in reparse-point fixup mode. Fixed a bug in the Windows build where file handles were left open to the WIM file, causing `wimlib_imagex optimize' to fail in some cases. + Fixed a bug in the Windows build of wimlib-imagex where globbing + split-WIM parts could cause the program to crash. + + Fixed a bug where the creation time of WIM images would be shown instead + of the last modification time. + With the Windows build it is now possible to restore a WIM containing symbolic links as a non-Administrator; however you will receive warnings about not being able to extract the symbolic links.