xref: /openbmc/u-boot/lib/bzip2/bzlib_private.h (revision e91610da)
1 /*
2  * This file is a modified version of bzlib_private.h from the bzip2-1.0.2
3  * distribution which can be found at http://sources.redhat.com/bzip2/
4  */
5 
6 /*-------------------------------------------------------------*/
7 /*--- Private header file for the library.                  ---*/
8 /*---                                       bzlib_private.h ---*/
9 /*-------------------------------------------------------------*/
10 
11 /*--
12   This file is a part of bzip2 and/or libbzip2, a program and
13   library for lossless, block-sorting data compression.
14 
15   Copyright (C) 1996-2002 Julian R Seward.  All rights reserved.
16 
17   Redistribution and use in source and binary forms, with or without
18   modification, are permitted provided that the following conditions
19   are met:
20 
21   1. Redistributions of source code must retain the above copyright
22      notice, this list of conditions and the following disclaimer.
23 
24   2. The origin of this software must not be misrepresented; you must
25      not claim that you wrote the original software.  If you use this
26      software in a product, an acknowledgment in the product
27      documentation would be appreciated but is not required.
28 
29   3. Altered source versions must be plainly marked as such, and must
30      not be misrepresented as being the original software.
31 
32   4. The name of the author may not be used to endorse or promote
33      products derived from this software without specific prior written
34      permission.
35 
36   THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
37   OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
38   WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
39   ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
40   DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
41   DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
42   GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
43   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
44   WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
45   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
46   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
47 
48   Julian Seward, Cambridge, UK.
49   jseward@acm.org
50   bzip2/libbzip2 version 1.0 of 21 March 2000
51 
52   This program is based on (at least) the work of:
53      Mike Burrows
54      David Wheeler
55      Peter Fenwick
56      Alistair Moffat
57      Radford Neal
58      Ian H. Witten
59      Robert Sedgewick
60      Jon L. Bentley
61 
62   For more information on these sources, see the manual.
63 --*/
64 
65 
66 #ifndef _BZLIB_PRIVATE_H
67 #define _BZLIB_PRIVATE_H
68 
69 #include <malloc.h>
70 
71 #include "bzlib.h"
72 
73 #ifndef BZ_NO_STDIO
74 #include <stdio.h>
75 #include <ctype.h>
76 #include <string.h>
77 #endif
78 
79 
80 /*-- General stuff. --*/
81 
82 #define BZ_VERSION  "1.0.2, 30-Dec-2001"
83 
84 typedef char            Char;
85 typedef unsigned char   Bool;
86 typedef unsigned char   UChar;
87 typedef int             Int32;
88 typedef unsigned int    UInt32;
89 typedef short           Int16;
90 typedef unsigned short  UInt16;
91 
92 #define True  ((Bool)1)
93 #define False ((Bool)0)
94 
95 #ifndef __GNUC__
96 #define __inline__  /* */
97 #endif
98 
99 #ifndef BZ_NO_STDIO
100 extern void BZ2_bz__AssertH__fail ( int errcode );
101 #define AssertH(cond,errcode) \
102    { if (!(cond)) BZ2_bz__AssertH__fail ( errcode ); }
103 #if BZ_DEBUG
104 #define AssertD(cond,msg) \
105    { if (!(cond)) {       \
106       fprintf ( stderr,   \
107 	"\n\nlibbzip2(debug build): internal error\n\t%s\n", msg );\
108       exit(1); \
109    }}
110 #else
111 #define AssertD(cond,msg) /* */
112 #endif
113 #define VPrintf0(zf) \
114    fprintf(stderr,zf)
115 #define VPrintf1(zf,za1) \
116    fprintf(stderr,zf,za1)
117 #define VPrintf2(zf,za1,za2) \
118    fprintf(stderr,zf,za1,za2)
119 #define VPrintf3(zf,za1,za2,za3) \
120    fprintf(stderr,zf,za1,za2,za3)
121 #define VPrintf4(zf,za1,za2,za3,za4) \
122    fprintf(stderr,zf,za1,za2,za3,za4)
123 #define VPrintf5(zf,za1,za2,za3,za4,za5) \
124    fprintf(stderr,zf,za1,za2,za3,za4,za5)
125 #else
126 extern void bz_internal_error ( int errcode );
127 #define AssertH(cond,errcode) \
128    { if (!(cond)) bz_internal_error ( errcode ); }
129 #define AssertD(cond,msg) /* */
130 #define VPrintf0(zf) /* */
131 #define VPrintf1(zf,za1) /* */
132 #define VPrintf2(zf,za1,za2) /* */
133 #define VPrintf3(zf,za1,za2,za3) /* */
134 #define VPrintf4(zf,za1,za2,za3,za4) /* */
135 #define VPrintf5(zf,za1,za2,za3,za4,za5) /* */
136 #endif
137 
138 
139 #define BZALLOC(nnn) (strm->bzalloc)(strm->opaque,(nnn),1)
140 #define BZFREE(ppp)  (strm->bzfree)(strm->opaque,(ppp))
141 
142 
143 /*-- Header bytes. --*/
144 
145 #define BZ_HDR_B 0x42   /* 'B' */
146 #define BZ_HDR_Z 0x5a   /* 'Z' */
147 #define BZ_HDR_h 0x68   /* 'h' */
148 #define BZ_HDR_0 0x30   /* '0' */
149 
150 /*-- Constants for the back end. --*/
151 
152 #define BZ_MAX_ALPHA_SIZE 258
153 #define BZ_MAX_CODE_LEN    23
154 
155 #define BZ_RUNA 0
156 #define BZ_RUNB 1
157 
158 #define BZ_N_GROUPS 6
159 #define BZ_G_SIZE   50
160 #define BZ_N_ITERS  4
161 
162 #define BZ_MAX_SELECTORS (2 + (900000 / BZ_G_SIZE))
163 
164 
165 /*-- Stuff for randomising repetitive blocks. --*/
166 
167 extern Int32 BZ2_rNums[512];
168 
169 #define BZ_RAND_DECLS                          \
170    Int32 rNToGo;                               \
171    Int32 rTPos                                 \
172 
173 #define BZ_RAND_INIT_MASK                      \
174    s->rNToGo = 0;                              \
175    s->rTPos  = 0                               \
176 
177 #define BZ_RAND_MASK ((s->rNToGo == 1) ? 1 : 0)
178 
179 #define BZ_RAND_UPD_MASK                       \
180    if (s->rNToGo == 0) {                       \
181       s->rNToGo = BZ2_rNums[s->rTPos];         \
182       s->rTPos++;                              \
183       if (s->rTPos == 512) s->rTPos = 0;       \
184    }                                           \
185    s->rNToGo--;
186 
187 
188 /*-- Stuff for doing CRCs. --*/
189 
190 extern UInt32 BZ2_crc32Table[256];
191 
192 #define BZ_INITIALISE_CRC(crcVar)              \
193 {                                              \
194    crcVar = 0xffffffffL;                       \
195 }
196 
197 #define BZ_FINALISE_CRC(crcVar)                \
198 {                                              \
199    crcVar = ~(crcVar);                         \
200 }
201 
202 #define BZ_UPDATE_CRC(crcVar,cha)              \
203 {                                              \
204    crcVar = (crcVar << 8) ^                    \
205 	    BZ2_crc32Table[(crcVar >> 24) ^    \
206 			   ((UChar)cha)];      \
207 }
208 
209 
210 /*-- States and modes for compression. --*/
211 
212 #define BZ_M_IDLE      1
213 #define BZ_M_RUNNING   2
214 #define BZ_M_FLUSHING  3
215 #define BZ_M_FINISHING 4
216 
217 #define BZ_S_OUTPUT    1
218 #define BZ_S_INPUT     2
219 
220 #define BZ_N_RADIX 2
221 #define BZ_N_QSORT 12
222 #define BZ_N_SHELL 18
223 #define BZ_N_OVERSHOOT (BZ_N_RADIX + BZ_N_QSORT + BZ_N_SHELL + 2)
224 
225 
226 /*-- Structure holding all the compression-side stuff. --*/
227 
228 typedef
229    struct {
230       /* pointer back to the struct bz_stream */
231       bz_stream* strm;
232 
233       /* mode this stream is in, and whether inputting */
234       /* or outputting data */
235       Int32    mode;
236       Int32    state;
237 
238       /* remembers avail_in when flush/finish requested */
239       UInt32   avail_in_expect;
240 
241       /* for doing the block sorting */
242       UInt32*  arr1;
243       UInt32*  arr2;
244       UInt32*  ftab;
245       Int32    origPtr;
246 
247       /* aliases for arr1 and arr2 */
248       UInt32*  ptr;
249       UChar*   block;
250       UInt16*  mtfv;
251       UChar*   zbits;
252 
253       /* for deciding when to use the fallback sorting algorithm */
254       Int32    workFactor;
255 
256       /* run-length-encoding of the input */
257       UInt32   state_in_ch;
258       Int32    state_in_len;
259       BZ_RAND_DECLS;
260 
261       /* input and output limits and current posns */
262       Int32    nblock;
263       Int32    nblockMAX;
264       Int32    numZ;
265       Int32    state_out_pos;
266 
267       /* map of bytes used in block */
268       Int32    nInUse;
269       Bool     inUse[256];
270       UChar    unseqToSeq[256];
271 
272       /* the buffer for bit stream creation */
273       UInt32   bsBuff;
274       Int32    bsLive;
275 
276       /* block and combined CRCs */
277       UInt32   blockCRC;
278       UInt32   combinedCRC;
279 
280       /* misc administratium */
281       Int32    verbosity;
282       Int32    blockNo;
283       Int32    blockSize100k;
284 
285       /* stuff for coding the MTF values */
286       Int32    nMTF;
287       Int32    mtfFreq    [BZ_MAX_ALPHA_SIZE];
288       UChar    selector   [BZ_MAX_SELECTORS];
289       UChar    selectorMtf[BZ_MAX_SELECTORS];
290 
291       UChar    len     [BZ_N_GROUPS][BZ_MAX_ALPHA_SIZE];
292       Int32    code    [BZ_N_GROUPS][BZ_MAX_ALPHA_SIZE];
293       Int32    rfreq   [BZ_N_GROUPS][BZ_MAX_ALPHA_SIZE];
294       /* second dimension: only 3 needed; 4 makes index calculations faster */
295       UInt32   len_pack[BZ_MAX_ALPHA_SIZE][4];
296 
297    }
298    EState;
299 
300 
301 /*-- externs for compression. --*/
302 
303 extern void
304 BZ2_blockSort ( EState* );
305 
306 extern void
307 BZ2_compressBlock ( EState*, Bool );
308 
309 extern void
310 BZ2_bsInitWrite ( EState* );
311 
312 extern void
313 BZ2_hbAssignCodes ( Int32*, UChar*, Int32, Int32, Int32 );
314 
315 extern void
316 BZ2_hbMakeCodeLengths ( UChar*, Int32*, Int32, Int32 );
317 
318 
319 /*-- states for decompression. --*/
320 
321 #define BZ_X_IDLE        1
322 #define BZ_X_OUTPUT      2
323 
324 #define BZ_X_MAGIC_1     10
325 #define BZ_X_MAGIC_2     11
326 #define BZ_X_MAGIC_3     12
327 #define BZ_X_MAGIC_4     13
328 #define BZ_X_BLKHDR_1    14
329 #define BZ_X_BLKHDR_2    15
330 #define BZ_X_BLKHDR_3    16
331 #define BZ_X_BLKHDR_4    17
332 #define BZ_X_BLKHDR_5    18
333 #define BZ_X_BLKHDR_6    19
334 #define BZ_X_BCRC_1      20
335 #define BZ_X_BCRC_2      21
336 #define BZ_X_BCRC_3      22
337 #define BZ_X_BCRC_4      23
338 #define BZ_X_RANDBIT     24
339 #define BZ_X_ORIGPTR_1   25
340 #define BZ_X_ORIGPTR_2   26
341 #define BZ_X_ORIGPTR_3   27
342 #define BZ_X_MAPPING_1   28
343 #define BZ_X_MAPPING_2   29
344 #define BZ_X_SELECTOR_1  30
345 #define BZ_X_SELECTOR_2  31
346 #define BZ_X_SELECTOR_3  32
347 #define BZ_X_CODING_1    33
348 #define BZ_X_CODING_2    34
349 #define BZ_X_CODING_3    35
350 #define BZ_X_MTF_1       36
351 #define BZ_X_MTF_2       37
352 #define BZ_X_MTF_3       38
353 #define BZ_X_MTF_4       39
354 #define BZ_X_MTF_5       40
355 #define BZ_X_MTF_6       41
356 #define BZ_X_ENDHDR_2    42
357 #define BZ_X_ENDHDR_3    43
358 #define BZ_X_ENDHDR_4    44
359 #define BZ_X_ENDHDR_5    45
360 #define BZ_X_ENDHDR_6    46
361 #define BZ_X_CCRC_1      47
362 #define BZ_X_CCRC_2      48
363 #define BZ_X_CCRC_3      49
364 #define BZ_X_CCRC_4      50
365 
366 
367 /*-- Constants for the fast MTF decoder. --*/
368 
369 #define MTFA_SIZE 4096
370 #define MTFL_SIZE 16
371 
372 
373 /*-- Structure holding all the decompression-side stuff. --*/
374 
375 typedef
376    struct {
377       /* pointer back to the struct bz_stream */
378       bz_stream* strm;
379 
380       /* state indicator for this stream */
381       Int32    state;
382 
383       /* for doing the final run-length decoding */
384       UChar    state_out_ch;
385       Int32    state_out_len;
386       Bool     blockRandomised;
387       BZ_RAND_DECLS;
388 
389       /* the buffer for bit stream reading */
390       UInt32   bsBuff;
391       Int32    bsLive;
392 
393       /* misc administratium */
394       Int32    blockSize100k;
395       Bool     smallDecompress;
396       Int32    currBlockNo;
397       Int32    verbosity;
398 
399       /* for undoing the Burrows-Wheeler transform */
400       Int32    origPtr;
401       UInt32   tPos;
402       Int32    k0;
403       Int32    unzftab[256];
404       Int32    nblock_used;
405       Int32    cftab[257];
406       Int32    cftabCopy[257];
407 
408       /* for undoing the Burrows-Wheeler transform (FAST) */
409       UInt32   *tt;
410 
411       /* for undoing the Burrows-Wheeler transform (SMALL) */
412       UInt16   *ll16;
413       UChar    *ll4;
414 
415       /* stored and calculated CRCs */
416       UInt32   storedBlockCRC;
417       UInt32   storedCombinedCRC;
418       UInt32   calculatedBlockCRC;
419       UInt32   calculatedCombinedCRC;
420 
421       /* map of bytes used in block */
422       Int32    nInUse;
423       Bool     inUse[256];
424       Bool     inUse16[16];
425       UChar    seqToUnseq[256];
426 
427       /* for decoding the MTF values */
428       UChar    mtfa   [MTFA_SIZE];
429       Int32    mtfbase[256 / MTFL_SIZE];
430       UChar    selector   [BZ_MAX_SELECTORS];
431       UChar    selectorMtf[BZ_MAX_SELECTORS];
432       UChar    len  [BZ_N_GROUPS][BZ_MAX_ALPHA_SIZE];
433 
434       Int32    limit  [BZ_N_GROUPS][BZ_MAX_ALPHA_SIZE];
435       Int32    base   [BZ_N_GROUPS][BZ_MAX_ALPHA_SIZE];
436       Int32    perm   [BZ_N_GROUPS][BZ_MAX_ALPHA_SIZE];
437       Int32    minLens[BZ_N_GROUPS];
438 
439       /* save area for scalars in the main decompress code */
440       Int32    save_i;
441       Int32    save_j;
442       Int32    save_t;
443       Int32    save_alphaSize;
444       Int32    save_nGroups;
445       Int32    save_nSelectors;
446       Int32    save_EOB;
447       Int32    save_groupNo;
448       Int32    save_groupPos;
449       Int32    save_nextSym;
450       Int32    save_nblockMAX;
451       Int32    save_nblock;
452       Int32    save_es;
453       Int32    save_N;
454       Int32    save_curr;
455       Int32    save_zt;
456       Int32    save_zn;
457       Int32    save_zvec;
458       Int32    save_zj;
459       Int32    save_gSel;
460       Int32    save_gMinlen;
461       Int32*   save_gLimit;
462       Int32*   save_gBase;
463       Int32*   save_gPerm;
464 
465    }
466    DState;
467 
468 
469 /*-- Macros for decompression. --*/
470 
471 #define BZ_GET_FAST(cccc)                     \
472     s->tPos = s->tt[s->tPos];                 \
473     cccc = (UChar)(s->tPos & 0xff);           \
474     s->tPos >>= 8;
475 
476 #define BZ_GET_FAST_C(cccc)                   \
477     c_tPos = c_tt[c_tPos];                    \
478     cccc = (UChar)(c_tPos & 0xff);            \
479     c_tPos >>= 8;
480 
481 #define SET_LL4(i,n)                                          \
482    { if (((i) & 0x1) == 0)                                    \
483 	s->ll4[(i) >> 1] = (s->ll4[(i) >> 1] & 0xf0) | (n); else    \
484 	s->ll4[(i) >> 1] = (s->ll4[(i) >> 1] & 0x0f) | ((n) << 4);  \
485    }
486 
487 #define GET_LL4(i)                             \
488    ((((UInt32)(s->ll4[(i) >> 1])) >> (((i) << 2) & 0x4)) & 0xF)
489 
490 #define SET_LL(i,n)                          \
491    { s->ll16[i] = (UInt16)(n & 0x0000ffff);  \
492      SET_LL4(i, n >> 16);                    \
493    }
494 
495 #define GET_LL(i) \
496    (((UInt32)s->ll16[i]) | (GET_LL4(i) << 16))
497 
498 #define BZ_GET_SMALL(cccc)                            \
499       cccc = BZ2_indexIntoF ( s->tPos, s->cftab );    \
500       s->tPos = GET_LL(s->tPos);
501 
502 
503 /*-- externs for decompression. --*/
504 
505 extern Int32
506 BZ2_indexIntoF ( Int32, Int32* );
507 
508 extern Int32
509 BZ2_decompress ( DState* );
510 
511 extern void
512 BZ2_hbCreateDecodeTables ( Int32*, Int32*, Int32*, UChar*,
513 			   Int32,  Int32, Int32 );
514 
515 
516 #endif
517 
518 
519 /*-- BZ_NO_STDIO seems to make NULL disappear on some platforms. --*/
520 
521 #ifdef BZ_NO_STDIO
522 #ifndef NULL
523 #define NULL 0
524 #endif
525 #endif
526 
527 
528 /*-------------------------------------------------------------*/
529 /*--- end                                   bzlib_private.h ---*/
530 /*-------------------------------------------------------------*/
531