wimlib.net Git - wimlib/blob - src/lzx-common.c

   1 /*
   2  * lzx-common.c - Common data for LZX compression and decompression.
   3  */
   4
   5 /*
   6  * Copyright (C) 2012, 2013 Eric Biggers
   7  *
   8  * This file is free software; you can redistribute it and/or modify it under
   9  * the terms of the GNU Lesser General Public License as published by the Free
  10  * Software Foundation; either version 3 of the License, or (at your option) any
  11  * later version.
  12  *
  13  * This file is distributed in the hope that it will be useful, but WITHOUT
  14  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  15  * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
  16  * details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public License
  19  * along with this file; if not, see http://www.gnu.org/licenses/.
  20  */
  21
  22 #ifdef HAVE_CONFIG_H
  23 #  include "config.h"
  24 #endif
  25
  26 #include "wimlib/endianness.h"
  27 #include "wimlib/lzx.h"
  28 #include "wimlib/util.h"
  29
  30 #ifdef __SSE2__
  31 #  include <emmintrin.h>
  32 #endif
  33
  34 /* Mapping: offset slot => first match offset that uses that offset slot.
  35  */
  36 const u32 lzx_offset_slot_base[LZX_MAX_OFFSET_SLOTS] = {
  37         0      , 1      , 2      , 3      , 4      ,    /* 0  --- 4  */
  38         6      , 8      , 12     , 16     , 24     ,    /* 5  --- 9  */
  39         32     , 48     , 64     , 96     , 128    ,    /* 10 --- 14 */
  40         192    , 256    , 384    , 512    , 768    ,    /* 15 --- 19 */
  41         1024   , 1536   , 2048   , 3072   , 4096   ,    /* 20 --- 24 */
  42         6144   , 8192   , 12288  , 16384  , 24576  ,    /* 25 --- 29 */
  43         32768  , 49152  , 65536  , 98304  , 131072 ,    /* 30 --- 34 */
  44         196608 , 262144 , 393216 , 524288 , 655360 ,    /* 35 --- 39 */
  45         786432 , 917504 , 1048576, 1179648, 1310720,    /* 40 --- 44 */
  46         1441792, 1572864, 1703936, 1835008, 1966080,    /* 45 --- 49 */
  47         2097152                                         /* 50        */
  48 };
  49
  50 /* Mapping: offset slot => how many extra bits must be read and added to the
  51  * corresponding offset slot base to decode the match offset.  */
  52 const u8 lzx_extra_offset_bits[LZX_MAX_OFFSET_SLOTS] = {
  53         0 , 0 , 0 , 0 , 1 ,
  54         1 , 2 , 2 , 3 , 3 ,
  55         4 , 4 , 5 , 5 , 6 ,
  56         6 , 7 , 7 , 8 , 8 ,
  57         9 , 9 , 10, 10, 11,
  58         11, 12, 12, 13, 13,
  59         14, 14, 15, 15, 16,
  60         16, 17, 17, 17, 17,
  61         17, 17, 17, 17, 17,
  62         17, 17, 17, 17, 17,
  63         17
  64 };
  65
  66 /* Round the specified compression block size (not LZX block size) up to the
  67  * next valid LZX window size, and return its order (log2).  Or, if the block
  68  * size is 0 or greater than the largest valid LZX window size, return 0.  */
  69 unsigned
  70 lzx_get_window_order(size_t max_block_size)
  71 {
  72         unsigned order;
  73
  74         if (max_block_size == 0 || max_block_size > LZX_MAX_WINDOW_SIZE)
  75                 return 0;
  76
  77         order = bsr32(max_block_size);
  78
  79         if (((u32)1 << order) != max_block_size)
  80                 order++;
  81
  82         return max(order, LZX_MIN_WINDOW_ORDER);
  83 }
  84
  85 /* Given a valid LZX window order, return the number of symbols that will exist
  86  * in the main Huffman code.  */
  87 unsigned
  88 lzx_get_num_main_syms(unsigned window_order)
  89 {
  90         u32 window_size = (u32)1 << window_order;
  91
  92         /* NOTE: the calculation *should* be as follows:
  93          *
  94          * u32 max_offset = window_size - LZX_MIN_MATCH_LEN;
  95          * u32 max_adjusted_offset = max_offset + LZX_OFFSET_OFFSET;
  96          * u32 num_offset_slots = 1 + lzx_get_offset_slot_raw(max_adjusted_offset);
  97          *
  98          * However since LZX_MIN_MATCH_LEN == LZX_OFFSET_OFFSET, we would get
  99          * max_adjusted_offset == window_size, which would bump the number of
 100          * offset slots up by 1 since every valid LZX window size is equal to a
 101          * offset slot base value.  The format doesn't do this, and instead
 102          * disallows matches with minimum length and maximum offset.  This sets
 103          * max_adjusted_offset = window_size - 1, so instead we must calculate:
 104          *
 105          * num_offset_slots = 1 + lzx_get_offset_slot_raw(window_size - 1);
 106          *
 107          * ... which is the same as
 108          *
 109          * num_offset_slots = lzx_get_offset_slot_raw(window_size);
 110          *
 111          * ... since every valid window size is equal to an offset base value.
 112          */
 113         unsigned num_offset_slots = lzx_get_offset_slot_raw(window_size);
 114
 115         /* Now calculate the number of main symbols as LZX_NUM_CHARS literal
 116          * symbols, plus 8 symbols per offset slot (since there are 8 possible
 117          * length headers, and we need all (offset slot, length header)
 118          * combinations).  */
 119         return LZX_NUM_CHARS + (num_offset_slots << 3);
 120 }
 121
 122 static void
 123 do_translate_target(sle32 *target, s32 input_pos)
 124 {
 125         s32 abs_offset, rel_offset;
 126
 127         /* XXX: This assumes unaligned memory accesses are okay.  */
 128         rel_offset = le32_to_cpu(*target);
 129         if (rel_offset >= -input_pos && rel_offset < LZX_WIM_MAGIC_FILESIZE) {
 130                 if (rel_offset < LZX_WIM_MAGIC_FILESIZE - input_pos) {
 131                         /* "good translation" */
 132                         abs_offset = rel_offset + input_pos;
 133                 } else {
 134                         /* "compensating translation" */
 135                         abs_offset = rel_offset - LZX_WIM_MAGIC_FILESIZE;
 136                 }
 137                 *target = cpu_to_le32(abs_offset);
 138         }
 139 }
 140
 141 static void
 142 undo_translate_target(sle32 *target, s32 input_pos)
 143 {
 144         s32 abs_offset, rel_offset;
 145
 146         /* XXX: This assumes unaligned memory accesses are okay.  */
 147         abs_offset = le32_to_cpu(*target);
 148         if (abs_offset >= 0) {
 149                 if (abs_offset < LZX_WIM_MAGIC_FILESIZE) {
 150                         /* "good translation" */
 151                         rel_offset = abs_offset - input_pos;
 152
 153                         *target = cpu_to_le32(rel_offset);
 154                 }
 155         } else {
 156                 if (abs_offset >= -input_pos) {
 157                         /* "compensating translation" */
 158                         rel_offset = abs_offset + LZX_WIM_MAGIC_FILESIZE;
 159
 160                         *target = cpu_to_le32(rel_offset);
 161                 }
 162         }
 163 }
 164
 165 /*
 166  * Do or undo the 'E8' preprocessing used in LZX.  Before compression, the
 167  * uncompressed data is preprocessed by changing the targets of x86 CALL
 168  * instructions from relative offsets to absolute offsets.  After decompression,
 169  * the translation is undone by changing the targets of x86 CALL instructions
 170  * from absolute offsets to relative offsets.
 171  *
 172  * Note that despite its intent, E8 preprocessing can be done on any data even
 173  * if it is not actually x86 machine code.  In fact, E8 preprocessing appears to
 174  * always be used in LZX-compressed resources in WIM files; there is no bit to
 175  * indicate whether it is used or not, unlike in the LZX compressed format as
 176  * used in cabinet files, where a bit is reserved for that purpose.
 177  *
 178  * E8 preprocessing is disabled in the last 6 bytes of the uncompressed data,
 179  * which really means the 5-byte call instruction cannot start in the last 10
 180  * bytes of the uncompressed data.  This is one of the errors in the LZX
 181  * documentation.
 182  *
 183  * E8 preprocessing does not appear to be disabled after the 32768th chunk of a
 184  * WIM resource, which apparently is another difference from the LZX compression
 185  * used in cabinet files.
 186  *
 187  * E8 processing is supposed to take the file size as a parameter, as it is used
 188  * in calculating the translated jump targets.  But in WIM files, this file size
 189  * is always the same (LZX_WIM_MAGIC_FILESIZE == 12000000).
 190  */
 191 static
 192 #ifndef __SSE2__
 193 inline  /* Although inlining the 'process_target' function still speeds up the
 194            SSE2 case, it bloats the binary more.  */
 195 #endif
 196 void
 197 lzx_e8_filter(u8 *data, u32 size, void (*process_target)(sle32 *, s32))
 198 {
 199 #ifdef __SSE2__
 200         /* SSE2 vectorized implementation for x86_64.  This speeds up LZX
 201          * decompression by about 5-8% overall.  (Usually --- the performance
 202          * actually regresses slightly in the degenerate case that the data
 203          * consists entirely of 0xe8 bytes.  Also, this optimization affects
 204          * compression as well, but the percentage improvement is less because
 205          * LZX compression is much slower than LZX decompression. ) */
 206         __m128i *p128 = (__m128i *)data;
 207         u32 valid_mask = 0xFFFFFFFF;
 208
 209         if (size >= 32 && (uintptr_t)data % 16 == 0) {
 210                 __m128i * const end128 = p128 + size / 16 - 1;
 211
 212                 /* Create a vector of all 0xe8 bytes  */
 213                 const __m128i e8_bytes = _mm_set1_epi8(0xe8);
 214
 215                 /* Iterate through the 16-byte vectors in the input.  */
 216                 do {
 217                         /* Compare the current 16-byte vector with the vector of
 218                          * all 0xe8 bytes.  This produces 0xff where the byte is
 219                          * 0xe8 and 0x00 where it is not.  */
 220                         __m128i cmpresult = _mm_cmpeq_epi8(*p128, e8_bytes);
 221
 222                         /* Map the comparison results into a single 16-bit
 223                          * number.  It will contain a 1 bit when the
 224                          * corresponding byte in the current 16-byte vector is
 225                          * an e8 byte.  Note: the low-order bit corresponds to
 226                          * the first (lowest address) byte.  */
 227                         u32 e8_mask = _mm_movemask_epi8(cmpresult);
 228
 229                         if (!e8_mask) {
 230                                 /* If e8_mask is 0, then none of these 16 bytes
 231                                  * have value 0xe8.  No e8 translation is
 232                                  * needed, and there is no restriction that
 233                                  * carries over to the next 16 bytes.  */
 234                                 valid_mask = 0xFFFFFFFF;
 235                         } else {
 236                                 /* At least one byte has value 0xe8.
 237                                  *
 238                                  * The AND with valid_mask accounts for the fact
 239                                  * that we can't start an e8 translation that
 240                                  * overlaps the previous one.  */
 241                                 while ((e8_mask &= valid_mask)) {
 242
 243                                         /* Count the number of trailing zeroes
 244                                          * in e8_mask.  This will produce the
 245                                          * index of the byte, within the 16, at
 246                                          * which the next e8 translation should
 247                                          * be done.  */
 248                                         u32 bit = __builtin_ctz(e8_mask);
 249
 250                                         /* Do (or undo) the e8 translation.  */
 251                                         u8 *p8 = (u8 *)p128 + bit;
 252                                         (*process_target)((sle32 *)(p8 + 1),
 253                                                           p8 - data);
 254
 255                                         /* Don't start an e8 translation in the
 256                                          * next 4 bytes.  */
 257                                         valid_mask &= ~((u32)0x1F << bit);
 258                                 }
 259                                 /* Moving on to the next vector.  Shift and set
 260                                  * valid_mask accordingly.  */
 261                                 valid_mask >>= 16;
 262                                 valid_mask |= 0xFFFF0000;
 263                         }
 264                 } while (++p128 < end128);
 265         }
 266
 267         u8 *p8 = (u8 *)p128;
 268         while (!(valid_mask & 1)) {
 269                 p8++;
 270                 valid_mask >>= 1;
 271         }
 272 #else /* __SSE2__  */
 273         u8 *p8 = data;
 274 #endif /* !__SSE2__  */
 275
 276         if (size > 10) {
 277                 /* Finish any bytes that weren't processed by the vectorized
 278                  * implementation.  */
 279                 u8 *p8_end = data + size - 10;
 280                 do {
 281                         if (*p8 == 0xe8) {
 282                                 (*process_target)((sle32 *)(p8 + 1), p8 - data);
 283                                 p8 += 5;
 284                         } else {
 285                                 p8++;
 286                         }
 287                 } while (p8 < p8_end);
 288         }
 289 }
 290
 291 void
 292 lzx_do_e8_preprocessing(u8 *data, u32 size)
 293 {
 294         lzx_e8_filter(data, size, do_translate_target);
 295 }
 296
 297 void
 298 lzx_undo_e8_preprocessing(u8 *data, u32 size)
 299 {
 300         lzx_e8_filter(data, size, undo_translate_target);
 301 }