inflate.h 6.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122
  1. /* inflate.h -- internal inflate state definition
  2. * Copyright (C) 1995-2009 Mark Adler
  3. * For conditions of distribution and use, see copyright notice in zlib.h
  4. */
  5. /* WARNING: this file should *not* be used by applications. It is
  6. part of the implementation of the compression library and is
  7. subject to change. Applications should only use zlib.h.
  8. */
  9. /* define NO_GZIP when compiling if you want to disable gzip header and
  10. trailer decoding by inflate(). NO_GZIP would be used to avoid linking in
  11. the crc code when it is not needed. For shared libraries, gzip decoding
  12. should be left enabled. */
  13. #ifndef NO_GZIP
  14. # define GUNZIP
  15. #endif
  16. /* Possible inflate modes between inflate() calls */
  17. typedef enum {
  18. HEAD, /* i: waiting for magic header */
  19. FLAGS, /* i: waiting for method and flags (gzip) */
  20. TIME, /* i: waiting for modification time (gzip) */
  21. OS, /* i: waiting for extra flags and operating system (gzip) */
  22. EXLEN, /* i: waiting for extra length (gzip) */
  23. EXTRA, /* i: waiting for extra bytes (gzip) */
  24. NAME, /* i: waiting for end of file name (gzip) */
  25. COMMENT, /* i: waiting for end of comment (gzip) */
  26. HCRC, /* i: waiting for header crc (gzip) */
  27. DICTID, /* i: waiting for dictionary check value */
  28. DICT, /* waiting for inflateSetDictionary() call */
  29. TYPE, /* i: waiting for type bits, including last-flag bit */
  30. TYPEDO, /* i: same, but skip check to exit inflate on new block */
  31. STORED, /* i: waiting for stored size (length and complement) */
  32. COPY_, /* i/o: same as COPY below, but only first time in */
  33. COPY, /* i/o: waiting for input or output to copy stored block */
  34. TABLE, /* i: waiting for dynamic block table lengths */
  35. LENLENS, /* i: waiting for code length code lengths */
  36. CODELENS, /* i: waiting for length/lit and distance code lengths */
  37. LEN_, /* i: same as LEN below, but only first time in */
  38. LEN, /* i: waiting for length/lit/eob code */
  39. LENEXT, /* i: waiting for length extra bits */
  40. DIST, /* i: waiting for distance code */
  41. DISTEXT, /* i: waiting for distance extra bits */
  42. MATCH, /* o: waiting for output space to copy string */
  43. LIT, /* o: waiting for output space to write literal */
  44. CHECK, /* i: waiting for 32-bit check value */
  45. LENGTH, /* i: waiting for 32-bit length (gzip) */
  46. DONE, /* finished check, done -- remain here until reset */
  47. BAD, /* got a data error -- remain here until reset */
  48. MEM, /* got an inflate() memory error -- remain here until reset */
  49. SYNC /* looking for synchronization bytes to restart inflate() */
  50. } inflate_mode;
  51. /*
  52. State transitions between above modes -
  53. (most modes can go to BAD or MEM on error -- not shown for clarity)
  54. Process header:
  55. HEAD -> (gzip) or (zlib) or (raw)
  56. (gzip) -> FLAGS -> TIME -> OS -> EXLEN -> EXTRA -> NAME -> COMMENT ->
  57. HCRC -> TYPE
  58. (zlib) -> DICTID or TYPE
  59. DICTID -> DICT -> TYPE
  60. (raw) -> TYPEDO
  61. Read deflate blocks:
  62. TYPE -> TYPEDO -> STORED or TABLE or LEN_ or CHECK
  63. STORED -> COPY_ -> COPY -> TYPE
  64. TABLE -> LENLENS -> CODELENS -> LEN_
  65. LEN_ -> LEN
  66. Read deflate codes in fixed or dynamic block:
  67. LEN -> LENEXT or LIT or TYPE
  68. LENEXT -> DIST -> DISTEXT -> MATCH -> LEN
  69. LIT -> LEN
  70. Process trailer:
  71. CHECK -> LENGTH -> DONE
  72. */
  73. /* state maintained between inflate() calls. Approximately 10K bytes. */
  74. struct inflate_state {
  75. inflate_mode mode; /* current inflate mode */
  76. int last; /* true if processing last block */
  77. int wrap; /* bit 0 true for zlib, bit 1 true for gzip */
  78. int havedict; /* true if dictionary provided */
  79. int flags; /* gzip header method and flags (0 if zlib) */
  80. unsigned dmax; /* zlib header max distance (INFLATE_STRICT) */
  81. unsigned long check; /* protected copy of check value */
  82. unsigned long total; /* protected copy of output count */
  83. gz_headerp head; /* where to save gzip header information */
  84. /* sliding window */
  85. unsigned wbits; /* log base 2 of requested window size */
  86. unsigned wsize; /* window size or zero if not using window */
  87. unsigned whave; /* valid bytes in the window */
  88. unsigned wnext; /* window write index */
  89. unsigned char FAR *window; /* allocated sliding window, if needed */
  90. /* bit accumulator */
  91. unsigned long hold; /* input bit accumulator */
  92. unsigned bits; /* number of bits in "in" */
  93. /* for string and stored block copying */
  94. unsigned length; /* literal or length of data to copy */
  95. unsigned offset; /* distance back to copy string from */
  96. /* for table and code decoding */
  97. unsigned extra; /* extra bits needed */
  98. /* fixed and dynamic code tables */
  99. code const FAR *lencode; /* starting table for length/literal codes */
  100. code const FAR *distcode; /* starting table for distance codes */
  101. unsigned lenbits; /* index bits for lencode */
  102. unsigned distbits; /* index bits for distcode */
  103. /* dynamic table building */
  104. unsigned ncode; /* number of code length code lengths */
  105. unsigned nlen; /* number of length code lengths */
  106. unsigned ndist; /* number of distance code lengths */
  107. unsigned have; /* number of code lengths in lens[] */
  108. code FAR *next; /* next available space in codes[] */
  109. unsigned short lens[320]; /* temporary storage for code lengths */
  110. unsigned short work[288]; /* work area for code table building */
  111. code codes[ENOUGH]; /* space for code tables */
  112. int sane; /* if false, allow invalid distance too far */
  113. int back; /* bits back of last unprocessed length/lit */
  114. unsigned was; /* initial length of match */
  115. };