AuroraMiddleware/lz4
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

updated frame format

Browse Source 
re-wording non-full blocks,
for clarity.
This commit is contained in:
Yann Collet 2019-01-02 15:02:22 -08:00
parent 7a4e04e6a6
commit ec735ac53e
1 changed files with 10 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/lz4_Frame_format.md
View File

@ -265,20 +265,23 @@ The highest bit is “1” if data in the block is uncompressed.
The highest bit is “0” if data in the block is compressed by LZ4. The highest bit is “0” if data in the block is compressed by LZ4.
All other bits give the size, in bytes, of the following data block All other bits give the size, in bytes, of the following data block.
(the size does not include the block checksum if present). The size does not include the block checksum if present.
Block Size shall never be larger than Block Maximum Size. Block Size shall never be larger than Block Maximum Size.
Such a thing could happen for incompressible source data. Such a thing could potentially happen for non-compressible sources.
In such case, such a data block shall be passed in uncompressed format. In such a case, such data block shall be passed using uncompressed format.
__Data__ __Data__
Where the actual data to decode stands. Where the actual data to decode stands.
It might be compressed or not, depending on previous field indications. It might be compressed or not, depending on previous field indications.
Uncompressed size of Data can be any size, up to “block maximum size”.
Note that data block is not necessarily full : When compressed, the data must respect the [LZ4 block format specification](https://github.com/lz4/lz4/blob/master/doc/lz4_Block_format.md).
an arbitrary “flush” may happen anytime. Any block can be “partially filled”.
Note that the block is not necessarily full.
Uncompressed size of data can be any size, up to "Block Maximum Size”,
so it may contain less data than the maximum block size.
__Block checksum__ __Block checksum__