123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144 |
- // gzip.h - originally written and placed in the public domain by Wei Dai
- /// \file gzip.h
- /// \brief GZIP compression and decompression (RFC 1952)
- #ifndef CRYPTOPP_GZIP_H
- #define CRYPTOPP_GZIP_H
- #include "cryptlib.h"
- #include "zdeflate.h"
- #include "zinflate.h"
- #include "crc.h"
- NAMESPACE_BEGIN(CryptoPP)
- /// \brief GZIP Compression (RFC 1952)
- class Gzip : public Deflator
- {
- public:
- /// \brief Construct a Gzip compressor
- /// \param attachment an attached transformation
- /// \param deflateLevel the deflate level
- /// \param log2WindowSize the window size
- /// \param detectUncompressible flag to detect if data is compressible
- /// \details detectUncompressible makes it faster to process uncompressible files, but
- /// if a file has both compressible and uncompressible parts, it may fail to compress
- /// some of the compressible parts.
- Gzip(BufferedTransformation *attachment=NULLPTR, unsigned int deflateLevel=DEFAULT_DEFLATE_LEVEL, unsigned int log2WindowSize=DEFAULT_LOG2_WINDOW_SIZE, bool detectUncompressible=true)
- : Deflator(attachment, deflateLevel, log2WindowSize, detectUncompressible), m_totalLen(0), m_filetime(0) { }
- /// \brief Construct a Gzip compressor
- /// \param parameters a set of NameValuePairs to initialize this object
- /// \param attachment an attached transformation
- /// \details Possible parameter names: Log2WindowSize, DeflateLevel, DetectUncompressible
- Gzip(const NameValuePairs ¶meters, BufferedTransformation *attachment=NULLPTR)
- : Deflator(parameters, attachment), m_totalLen(0), m_filetime(0)
- {
- IsolatedInitialize(parameters);
- }
- /// \param filetime the filetime to set in the header. The application is responsible for setting it.
- void SetFiletime(word32 filetime) { m_filetime = filetime; }
- /// \param filename the original filename to set in the header. The application is responsible for setting it.
- /// RFC 1952 requires a ISO/IEC 8859-1 encoding.
- /// \param throwOnEncodingError if throwOnEncodingError is true, then the filename is checked to ensure it is
- /// ISO/IEC 8859-1 encoded. If the filename does not adhere to ISO/IEC 8859-1, then a InvalidDataFormat
- /// is thrown. If throwOnEncodingError is false then the filename is not checked.
- void SetFilename(const std::string& filename, bool throwOnEncodingError = false);
- /// \param comment the comment to set in the header. The application is responsible for setting it.
- /// RFC 1952 requires a ISO/IEC 8859-1 encoding.
- /// \param throwOnEncodingError if throwOnEncodingError is true, then the comment is checked to ensure it is
- /// ISO/IEC 8859-1 encoded. If the comment does not adhere to ISO/IEC 8859-1, then a InvalidDataFormat
- /// is thrown. If throwOnEncodingError is false then the comment is not checked.
- void SetComment(const std::string& comment, bool throwOnEncodingError = false);
- void IsolatedInitialize(const NameValuePairs ¶meters);
- protected:
- enum {MAGIC1=0x1f, MAGIC2=0x8b, // flags for the header
- DEFLATED=8, FAST=4, SLOW=2};
- enum FLAG_MASKS {
- FILENAME=8, COMMENTS=16};
- void WritePrestreamHeader();
- void ProcessUncompressedData(const byte *string, size_t length);
- void WritePoststreamTail();
- word32 m_totalLen;
- CRC32 m_crc;
- word32 m_filetime;
- std::string m_filename;
- std::string m_comment;
- };
- /// \brief GZIP Decompression (RFC 1952)
- class Gunzip : public Inflator
- {
- public:
- typedef Inflator::Err Err;
- /// \brief Exception thrown when a header decoding error occurs
- class HeaderErr : public Err {public: HeaderErr() : Err(INVALID_DATA_FORMAT, "Gunzip: header decoding error") {}};
- /// \brief Exception thrown when the tail is too short
- class TailErr : public Err {public: TailErr() : Err(INVALID_DATA_FORMAT, "Gunzip: tail too short") {}};
- /// \brief Exception thrown when a CRC error occurs
- class CrcErr : public Err {public: CrcErr() : Err(DATA_INTEGRITY_CHECK_FAILED, "Gunzip: CRC check error") {}};
- /// \brief Exception thrown when a length error occurs
- class LengthErr : public Err {public: LengthErr() : Err(DATA_INTEGRITY_CHECK_FAILED, "Gunzip: length check error") {}};
- /// \brief Construct a Gunzip decompressor
- /// \param attachment an attached transformation
- /// \param repeat decompress multiple compressed streams in series
- /// \param autoSignalPropagation 0 to turn off MessageEnd signal
- Gunzip(BufferedTransformation *attachment = NULLPTR, bool repeat = false, int autoSignalPropagation = -1);
- /// \return the filetime of the stream as set in the header. The application is responsible for setting it on the decompressed file.
- word32 GetFiletime() const { return m_filetime; }
- /// \return the filename of the stream as set in the header. The application is responsible for setting it on the decompressed file.
- /// \param throwOnEncodingError if throwOnEncodingError is true, then the filename is checked to ensure it is
- /// ISO/IEC 8859-1 encoded. If the filename does not adhere to ISO/IEC 8859-1, then a InvalidDataFormat is thrown.
- /// If throwOnEncodingError is false then the filename is not checked.
- const std::string& GetFilename(bool throwOnEncodingError = false) const;
- /// \return the comment of the stream as set in the header.
- /// \param throwOnEncodingError if throwOnEncodingError is true, then the comment is checked to ensure it is
- /// ISO/IEC 8859-1 encoded. If the comment does not adhere to ISO/IEC 8859-1, then a InvalidDataFormat is thrown.
- /// If throwOnEncodingError is false then the comment is not checked.
- const std::string& GetComment(bool throwOnEncodingError = false) const;
- protected:
- enum {
- /// \brief First header magic value
- MAGIC1=0x1f,
- /// \brief Second header magic value
- MAGIC2=0x8b,
- /// \brief Deflated flag
- DEFLATED=8
- };
- enum FLAG_MASKS {
- CONTINUED=2, EXTRA_FIELDS=4, FILENAME=8, COMMENTS=16, ENCRYPTED=32};
- unsigned int MaxPrestreamHeaderSize() const {return 1024;}
- void ProcessPrestreamHeader();
- void ProcessDecompressedData(const byte *string, size_t length);
- unsigned int MaxPoststreamTailSize() const {return 8;}
- void ProcessPoststreamTail();
- word32 m_length;
- CRC32 m_crc;
- word32 m_filetime;
- std::string m_filename;
- std::string m_comment;
- };
- NAMESPACE_END
- #endif
|