/* packer.h -- This file is part of the UPX executable compressor. Copyright (C) 1996-2023 Markus Franz Xaver Johannes Oberhumer Copyright (C) 1996-2023 Laszlo Molnar All Rights Reserved. UPX and the UCL library are free software; you can redistribute them and/or modify them under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; see the file COPYING. If not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. Markus F.X.J. Oberhumer Laszlo Molnar */ #pragma once #include "util/membuffer.h" class InputFile; class OutputFile; class Packer; class UiPacker; class Filter; /************************************************************************* // PackHeader // also see stub/src/include/header.S **************************************************************************/ class PackHeader final { friend class Packer; // these are strictly private to friend Packer explicit PackHeader() noexcept; void putPackHeader(SPAN_S(byte) p); bool decodePackHeaderFromBuf(SPAN_S(const byte) b, int blen); public: int getPackHeaderSize() const; public: // fields stored in compressed file // enum { magic = UPX_MAGIC_LE32 }; int version; int format; // executable format int method; // compresison method int level; // compresison level 1..10 unsigned u_len; unsigned c_len; unsigned u_adler; unsigned c_adler; unsigned u_file_size; int filter; int filter_cto; int n_mru; // FIXME: rename to filter_misc int header_checksum; // support fields for verifying decompression unsigned saved_u_adler; unsigned saved_c_adler; // info fields set by decodePackHeaderFromBuf() unsigned buf_offset; // info fields set by Packer::compress() upx_compress_result_t compress_result; // unsigned min_offset_found; unsigned max_offset_found; // unsigned min_match_found; unsigned max_match_found; // unsigned min_run_found; unsigned max_run_found; unsigned first_offset_found; // unsigned same_match_offsets_found; // info fields set by Packer::compressWithFilters() unsigned overlap_overhead; }; bool ph_skipVerify(const PackHeader &ph) noexcept; void ph_decompress(PackHeader &ph, SPAN_P(const byte) in, SPAN_P(byte) out, bool verify_checksum, Filter *ft); bool ph_testOverlappingDecompression(const PackHeader &ph, SPAN_P(const byte) buf, unsigned overlap_overhead); /************************************************************************* // abstract base class for packers // // FIXME later: this class is way too fat and badly needs a decomposition **************************************************************************/ class Packer { friend class UiPacker; protected: explicit Packer(InputFile *f); public: virtual ~Packer() noexcept; virtual void assertPacker() const; // getVersion() enables detecting forward incompatibility of unpack() // by old upx when newer upx changes the format of compressed output. virtual int getVersion() const = 0; // A unique integer ID for this executable format. See conf.h. virtual int getFormat() const = 0; virtual const char *getName() const = 0; virtual const char *getFullName(const Options *) const = 0; virtual const int *getCompressionMethods(int method, int level) const = 0; virtual const int *getFilters() const = 0; // PackMaster entries void initPackHeader(); void updatePackHeader(); void doPack(OutputFile *fo); void doUnpack(OutputFile *fo); void doTest(); void doList(); void doFileInfo(); // unpacker capabilities virtual bool canUnpackVersion(int version) const { return (version >= 8); } virtual bool canUnpackFormat(int format) const { return (format == getFormat()); } protected: // unpacker tests - these may throw exceptions virtual bool testUnpackVersion(int version) const; virtual bool testUnpackFormat(int format) const; protected: // implementation virtual void pack(OutputFile *fo) = 0; virtual void unpack(OutputFile *fo) = 0; virtual void test(); virtual void list(); virtual void fileInfo(); public: // canPack() should throw a cantPackException eplaining why it // cannot pack a recognized format. virtual bool canPack() = 0; // canUnpack() can return -1 meaning "format recognized, but file // is definitely not packed". See packmast.cpp try_unpack(). virtual int canUnpack() = 0; protected: // main compression drivers bool compress(SPAN_P(byte) i_ptr, unsigned i_len, SPAN_P(byte) o_ptr, const upx_compress_config_t *cconf = nullptr); void decompress(SPAN_P(const byte) in, SPAN_P(byte) out, bool verify_checksum = true, Filter *ft = nullptr); virtual bool checkDefaultCompressionRatio(unsigned u_len, unsigned c_len) const; virtual bool checkCompressionRatio(unsigned u_len, unsigned c_len) const; virtual bool checkFinalCompressionRatio(const OutputFile *fo) const; // high-level compression drivers void compressWithFilters(Filter *ft, const unsigned overlap_range, const upx_compress_config_t *cconf, int filter_strategy = 0, bool inhibit_compression_check = false); void compressWithFilters(Filter *ft, const unsigned overlap_range, const upx_compress_config_t *cconf, int filter_strategy, unsigned filter_buf_off, unsigned compress_ibuf_off, unsigned compress_obuf_off, byte *const hdr_ptr, unsigned hdr_len, bool inhibit_compression_check = false); // real compression driver void compressWithFilters(byte *i_ptr, unsigned i_len, // written and restored by filters byte *o_ptr, byte *f_ptr, unsigned f_len, // subset of [*i_ptr, +i_len) byte *const hdr_ptr, unsigned hdr_len, Filter *parm_ft, // updated unsigned overlap_range, upx_compress_config_t const *cconf, int filter_strategy, bool inhibit_compression_check = false); // util for verifying overlapping decompression // non-destructive test virtual bool testOverlappingDecompression(const byte *buf, const byte *tbuf, unsigned overlap_overhead) const; // non-destructive find virtual unsigned findOverlapOverhead(const byte *buf, const byte *tbuf, unsigned range = 0, unsigned upper_limit = ~0u) const; // destructive decompress + verify void verifyOverlappingDecompression(Filter *ft = nullptr); void verifyOverlappingDecompression(byte *o_ptr, unsigned o_size, Filter *ft = nullptr); // packheader handling virtual int patchPackHeader(void *b, int blen); virtual bool getPackHeader(const void *b, int blen, bool allow_incompressible = false); virtual bool readPackHeader(int len, bool allow_incompressible = false); virtual void checkAlreadyPacked(const void *b, int blen); // loader core virtual void buildLoader(const Filter *ft) = 0; virtual Linker *newLinker() const = 0; virtual void relocateLoader(); // loader util for linker virtual byte *getLoader() const; virtual int getLoaderSize() const; virtual void initLoader(const void *pdata, int plen, int small = -1, int pextra = 0); #define C const char * void addLoader(C); void addLoader(C, C); void addLoader(C, C, C); void addLoader(C, C, C, C); void addLoader(C, C, C, C, C); void addLoader(C, C, C, C, C, C); void addLoader(C, C, C, C, C, C, C); void addLoader(C, C, C, C, C, C, C, C); void addLoader(C, C, C, C, C, C, C, C, C); void addLoader(C, C, C, C, C, C, C, C, C, C); #undef C #if (ACC_CC_CLANG || ACC_CC_GNUC) void addLoaderVA(const char *s, ...) __attribute__((__sentinel__)); #else void addLoaderVA(const char *s, ...); #endif virtual bool hasLoaderSection(const char *name) const; virtual int getLoaderSection(const char *name, int *slen = nullptr) const; virtual int getLoaderSectionStart(const char *name, int *slen = nullptr) const; // compression handling [see packer_c.cpp] public: static bool isValidCompressionMethod(int method); protected: const int *getDefaultCompressionMethods_8(int method, int level, int small = -1) const; const int *getDefaultCompressionMethods_le32(int method, int level, int small = -1) const; int prepareMethods(int *methods, int ph_method, const int *all_methods) const; virtual const char *getDecompressorSections() const; virtual unsigned getDecompressorWrkmemSize() const; virtual void defineDecompressorSymbols(); // filter handling [see packer_f.cpp] virtual bool isValidFilter(int filter_id) const; virtual void optimizeFilter(Filter *, const byte *, unsigned) const {} virtual void addFilter32(int filter_id); virtual void defineFilterSymbols(const Filter *ft); // stub and overlay util static void handleStub(InputFile *fi, OutputFile *fo, unsigned size); virtual void checkOverlay(unsigned overlay); virtual void copyOverlay(OutputFile *fo, unsigned overlay, MemBuffer &buf, bool do_seek = true); // misc util virtual unsigned getRandomId() const; // patch util int patch_be16(void *b, int blen, unsigned old, unsigned new_); int patch_be16(void *b, int blen, const void *old, unsigned new_); int patch_be32(void *b, int blen, unsigned old, unsigned new_); int patch_be32(void *b, int blen, const void *old, unsigned new_); int patch_le16(void *b, int blen, unsigned old, unsigned new_); int patch_le16(void *b, int blen, const void *old, unsigned new_); int patch_le32(void *b, int blen, unsigned old, unsigned new_); int patch_le32(void *b, int blen, const void *old, unsigned new_); void checkPatch(void *b, int blen, int boff, int size); // relocation util static unsigned optimizeReloc(unsigned relocnum, SPAN_P(byte) relocs, SPAN_S(byte) out, SPAN_P(byte) image, unsigned image_size, int bits, bool bswap, int *big); static unsigned unoptimizeReloc(SPAN_S(const byte) & in, MemBuffer &out, SPAN_P(byte) image, unsigned image_size, int bits, bool bswap); // Target Endianness abstraction #if 0 // permissive version using "void *" inline unsigned get_te16(const void *p) const noexcept { return bele->get16(p); } inline unsigned get_te32(const void *p) const noexcept { return bele->get32(p); } inline upx_uint64_t get_te64(const void *p) const noexcept { return bele->get64(p); } inline void set_te16(void *p, unsigned v) noexcept { bele->set16(p, v); } inline void set_te32(void *p, unsigned v) noexcept { bele->set32(p, v); } inline void set_te64(void *p, upx_uint64_t v) noexcept { bele->set64(p, v); } #else // try to detect TE16 vs TE32 vs TE64 size mismatches; note that byte is explicitly allowed template static inline constexpr bool is_te16_type = is_same_any_v; template static inline constexpr bool is_te32_type = is_same_any_v; template static inline constexpr bool is_te64_type = is_same_any_v; template , T> > inline unsigned get_te16(const T *p) const noexcept { return bele->get16(p); } template , T> > inline unsigned get_te32(const T *p) const noexcept { return bele->get32(p); } template , T> > inline upx_uint64_t get_te64(const T *p) const noexcept { return bele->get64(p); } template , T> > inline void set_te16(T *p, unsigned v) noexcept { bele->set16(p, v); } template , T> > inline void set_te32(T *p, unsigned v) noexcept { bele->set32(p, v); } template , T> > inline void set_te64(T *p, upx_uint64_t v) noexcept { bele->set64(p, v); } #endif protected: const N_BELE_RTP::AbstractPolicy *bele = nullptr; // target endianness InputFile *fi = nullptr; union { // unnamed union upx_int64_t file_size = 0; // will get set by constructor upx_uint64_t file_size_u; // explicitly unsigned }; PackHeader ph = PackHeader{}; // must be filled by canUnpack() int ph_format = -1; int ph_version = -1; // compression buffers MemBuffer ibuf; // input MemBuffer obuf; // output unsigned ibufgood = 0; // high-water mark in ibuf (pefile.cpp) // UI handler OwningPointer(UiPacker) uip = nullptr; // owner // linker OwningPointer(Linker) linker = nullptr; // owner private: // private to checkPatch() void *last_patch = nullptr; int last_patch_len = 0; int last_patch_off = 0; private: // disable copy and move Packer(const Packer &) DELETED_FUNCTION; Packer &operator=(const Packer &) DELETED_FUNCTION; Packer(Packer &&) noexcept DELETED_FUNCTION; Packer &operator=(Packer &&) noexcept DELETED_FUNCTION; }; int force_method(int method) noexcept; // (0x80ul<<24)|method int forced_method(int method) noexcept; // (0x80ul<<24)|method ==> method int is_forced_method(int method) noexcept; // predicate /* vim:set ts=4 sw=4 et: */