| |
| XZ Utils for Windows |
| ==================== |
| |
| Introduction |
| ------------ |
| |
| This package includes command line tools (xz.exe and a few |
| others) and the liblzma compression library from XZ Utils. |
| You can find the latest version and full source code from |
| <https://xz.tukaani.org/xz-utils/>. |
| |
| The parts of the XZ Utils source code, that are relevant to this |
| binary package, are under the BSD Zero Clause License (0BSD). |
| XZ Utils have been built using GCC and MinGW-w64 and linked |
| statically against the MinGW-w64 runtime libraries. See |
| COPYING.MinGW-w64-runtime.txt for copyright and license |
| information that applies to the MinGW-w64 runtime. |
| |
| IMPORTANT: You must include COPYING.MinGW-w64-runtime.txt |
| when distributing these XZ Utils binaries to meet |
| the license terms of the MinGW-w64 runtime! |
| |
| (The file COPYING mentions GNU getopt_long. It's *not* used when |
| XZ Utils is built with MinGW-w64. Thus GNU LGPLv2.1 doesn't apply.) |
| |
| |
| Package contents |
| ---------------- |
| |
| All executables and libraries in this package require msvcrt.dll, |
| not Universal CRT (UCRT). |
| |
| There is a SSE2 optimization in the compression code but this |
| version of XZ Utils doesn't include run-time processor detection. |
| This is why there is a separate i686-SSE2 version. |
| |
| There is one directory for each type of executable and library files: |
| |
| bin_i686 32-bit x86 (i686 and newer), Windows 2000 and later |
| bin_i686-sse2 32-bit x86 (i686 with SSE2), Windows 2000 and later |
| bin_x86-64 64-bit x86-64, Windows Vista and later |
| |
| Each of the above directories have the following files: |
| |
| *.exe Command line tools. (It's useless to double-click |
| these; use the command prompt instead.) These have |
| been linked statically against liblzma, so they |
| don't require liblzma.dll. Thus, you can copy e.g. |
| xz.exe to a directory that is in PATH without |
| copying any other files from this package. |
| |
| NOTE: xzdec.exe and lzmadec.exe are optimized for |
| size, single-threaded, and slower than xz.exe. |
| Use xz.exe unless program size is important. |
| |
| liblzma.dll Shared version of the liblzma compression library. |
| This file is mostly useful to developers, although |
| some non-developers might use it to upgrade their |
| copy of liblzma. |
| |
| The rest of the directories contain architecture-independent files: |
| |
| doc Basic documentation in the plain text (TXT) |
| format. COPYING.txt, COPYING.0BSD.txt, and |
| COPYING.MinGW-w64-runtime.txt contain |
| copyright and license information. |
| liblzma.def is in this directory too. |
| |
| doc/manuals The manuals of the command line tools in |
| plain text (TXT) and PDF formats. |
| |
| doc/api liblzma API documentation in HTML format. |
| |
| doc/examples Example programs for basic liblzma usage. |
| |
| include C header files for liblzma. These should be |
| compatible with most C and C++ compilers. |
| |
| |
| Creating an import library for MSVC / Visual Studio |
| --------------------------------------------------- |
| |
| To link against liblzma.dll, you need to create an import library |
| first. You need the "lib" command from MSVC and liblzma.def from |
| the "doc" directory of this package. Here is the command that works |
| on 32-bit x86: |
| |
| lib /def:liblzma.def /out:liblzma.lib /machine:ix86 |
| |
| On x86-64, the /machine argument has to be changed: |
| |
| lib /def:liblzma.def /out:liblzma.lib /machine:x64 |
| |
| IMPORTANT: See also the file liblzma-crt-mixing.txt. |
| |
| |
| Reporting bugs |
| -------------- |
| |
| Report bugs to <xz@tukaani.org>. |
| |