#include "decompress.h" #include #include #include #include #include // Based on https://fossies.org/linux/xz/doc/examples/02_decompress.c /////////////////////////////////////////////////////////////////////////////// // /// \file 02_decompress.c /// \brief Decompress .xz files to stdout /// /// Usage: ./02_decompress INPUT_FILES... > OUTFILE /// /// Example: ./02_decompress foo.xz bar.xz > foobar // // Author: Lasse Collin // // This file has been put into the public domain. // You can do whatever you want with this file. // /////////////////////////////////////////////////////////////////////////////// namespace { class IInput { public: virtual ~IInput() = default; virtual size_t Next(const ui8*& ptr) = 0; }; class TCopyInput: public IInput { public: TCopyInput(IInputStream* slave) : Slave_(slave) { } size_t Next(const ui8*& ptr) override { ptr = Inbuf_; return Slave_->Read(Inbuf_, sizeof(Inbuf_)); } private: IInputStream* Slave_; ui8 Inbuf_[4096]; }; class TZeroCopy: public IInput { public: TZeroCopy(IZeroCopyInput* slave) : Slave_(slave) { } size_t Next(const ui8*& ptr) override { return Slave_->Next(&ptr); } private: IZeroCopyInput* Slave_; }; std::unique_ptr createInput(IInputStream* slave) { return std::make_unique(slave); } std::unique_ptr createInput(IZeroCopyInput* slave) { return std::make_unique(slave); } } class TUnbufferedXzDecompress::TImpl { public: template TImpl(T* slave) : Input_(createInput(slave)) , Strm_(LZMA_STREAM_INIT) { TString err; Y_ENSURE(initDecoder(&Strm_, err), "Error initializing the decoder: " << err); Strm_.next_in = NULL; Strm_.avail_in = 0; } ~TImpl() { // Free the memory allocated for the decoder lzma_end(&Strm_); } size_t DoRead(void* buf, size_t len) { if (IsOutFinished_) { return 0; } size_t res; TString err; Y_ENSURE(decompress(buf, len, res, err), "lzma decoder error: " << err); return res; } private: bool decompress(void* buf, size_t len, size_t& outLen, TString& err) { // When LZMA_CONCATENATED flag was used when initializing the decoder, // we need to tell lzma_code() when there will be no more input. // This is done by setting action to LZMA_FINISH instead of LZMA_RUN // in the same way as it is done when encoding. // // When LZMA_CONCATENATED isn't used, there is no need to use // LZMA_FINISH to tell when all the input has been read, but it // is still OK to use it if you want. When LZMA_CONCATENATED isn't // used, the decoder will stop after the first .xz stream. In that // case some unused data may be left in strm->next_in. lzma_action action = LZMA_RUN; Strm_.next_out = (ui8*)buf; Strm_.avail_out = len; while (true) { if (Strm_.avail_in == 0 && !IsInFinished_) { size_t size = Input_->Next(Strm_.next_in); if (size == 0) { IsInFinished_ = true; } else { Strm_.avail_in = size; } // Once the end of the input file has been reached, // we need to tell lzma_code() that no more input // will be coming. As said before, this isn't required // if the LZMA_CONCATENATED flag isn't used when // initializing the decoder. if (IsInFinished_) action = LZMA_FINISH; } lzma_ret ret = lzma_code(&Strm_, action); if (ret == LZMA_STREAM_END) { // Once everything has been decoded successfully, the // return value of lzma_code() will be LZMA_STREAM_END. // // It is important to check for LZMA_STREAM_END. Do not // assume that getting ret != LZMA_OK would mean that // everything has gone well or that when you aren't // getting more output it must have successfully // decoded everything. IsOutFinished_ = true; } if (Strm_.avail_out == 0 || ret == LZMA_STREAM_END) { outLen = len - Strm_.avail_out; return true; } if (ret != LZMA_OK) { // It's not LZMA_OK nor LZMA_STREAM_END, // so it must be an error code. See lzma/base.h // (src/liblzma/api/lzma/base.h in the source package // or e.g. /usr/include/lzma/base.h depending on the // install prefix) for the list and documentation of // possible values. Many values listen in lzma_ret // enumeration aren't possible in this example, but // can be made possible by enabling memory usage limit // or adding flags to the decoder initialization. switch (ret) { case LZMA_MEM_ERROR: err = "Memory allocation failed"; break; case LZMA_FORMAT_ERROR: // .xz magic bytes weren't found. err = "The input is not in the .xz format"; break; case LZMA_OPTIONS_ERROR: // For example, the headers specify a filter // that isn't supported by this liblzma // version (or it hasn't been enabled when // building liblzma, but no-one sane does // that unless building liblzma for an // embedded system). Upgrading to a newer // liblzma might help. // // Note that it is unlikely that the file has // accidentally became corrupt if you get this // error. The integrity of the .xz headers is // always verified with a CRC32, so // unintentionally corrupt files can be // distinguished from unsupported files. err = "Unsupported compression options"; break; case LZMA_DATA_ERROR: err = "Compressed file is corrupt"; break; case LZMA_BUF_ERROR: // Typically this error means that a valid // file has got truncated, but it might also // be a damaged part in the file that makes // the decoder think the file is truncated. // If you prefer, you can use the same error // message for this as for LZMA_DATA_ERROR. err = "Compressed file is truncated or " "otherwise corrupt"; break; default: // This is most likely LZMA_PROG_ERROR. err = "Unknown error, possibly a bug"; break; } TStringOutput out(err); out << "[" << (int)ret << "]"; return false; } } } static bool initDecoder(lzma_stream* strm, TString& err) { // Initialize a .xz decoder. The decoder supports a memory usage limit // and a set of flags. // // The memory usage of the decompressor depends on the settings used // to compress a .xz file. It can vary from less than a megabyte to // a few gigabytes, but in practice (at least for now) it rarely // exceeds 65 MiB because that's how much memory is required to // decompress files created with "xz -9". Settings requiring more // memory take extra effort to use and don't (at least for now) // provide significantly better compression in most cases. // // Memory usage limit is useful if it is important that the // decompressor won't consume gigabytes of memory. The need // for limiting depends on the application. In this example, // no memory usage limiting is used. This is done by setting // the limit to UINT64_MAX. // // The .xz format allows concatenating compressed files as is: // // echo foo | xz > foobar.xz // echo bar | xz >> foobar.xz // // When decompressing normal standalone .xz files, LZMA_CONCATENATED // should always be used to support decompression of concatenated // .xz files. If LZMA_CONCATENATED isn't used, the decoder will stop // after the first .xz stream. This can be useful when .xz data has // been embedded inside another file format. // // Flags other than LZMA_CONCATENATED are supported too, and can // be combined with bitwise-or. See lzma/container.h // (src/liblzma/api/lzma/container.h in the source package or e.g. // /usr/include/lzma/container.h depending on the install prefix) // for details. lzma_ret ret = lzma_auto_decoder( strm, UINT64_MAX, LZMA_CONCATENATED); // Return successfully if the initialization went fine. if (ret == LZMA_OK) return true; // Something went wrong. The possible errors are documented in // lzma/container.h (src/liblzma/api/lzma/container.h in the source // package or e.g. /usr/include/lzma/container.h depending on the // install prefix). // // Note that LZMA_MEMLIMIT_ERROR is never possible here. If you // specify a very tiny limit, the error will be delayed until // the first headers have been parsed by a call to lzma_code(). switch (ret) { case LZMA_MEM_ERROR: err = "Memory allocation failed"; break; case LZMA_OPTIONS_ERROR: err = "Unsupported decompressor flags"; break; default: // This is most likely LZMA_PROG_ERROR indicating a bug in // this program or in liblzma. It is inconvenient to have a // separate error message for errors that should be impossible // to occur, but knowing the error code is important for // debugging. That's why it is good to print the error code // at least when there is no good error message to show. err = "Unknown error, possibly a bug"; break; } TStringOutput out(err); out << "[" << (int)ret << "]"; return false; } private: std::unique_ptr Input_; lzma_stream Strm_; bool IsInFinished_ = false; bool IsOutFinished_ = false; }; TUnbufferedXzDecompress::TUnbufferedXzDecompress(IInputStream* slave) : Impl_(std::make_unique(slave)) { } TUnbufferedXzDecompress::TUnbufferedXzDecompress(IZeroCopyInput* slave) : Impl_(std::make_unique(slave)) { } TUnbufferedXzDecompress::~TUnbufferedXzDecompress() = default; size_t TUnbufferedXzDecompress::DoRead(void* buf, size_t len) { return Impl_->DoRead(buf, len); }