lz4frame.h File Reference

#include <stddef.h>

Go to the source code of this file.

Classes
struct	LZ4F_frameInfo_t
struct	LZ4F_preferences_t
struct	LZ4F_compressOptions_t
struct	LZ4F_decompressOptions_t

Macros
#define	LZ4FLIB_VISIBILITY
#define	LZ4FLIB_API   LZ4FLIB_VISIBILITY
#define	LZ4F_DEPRECATE(x)   x /* no deprecation warning for this compiler */
#define	LZ4F_OBSOLETE_ENUM(x)
#define	LZ4F_INIT_FRAMEINFO   { LZ4F_default, LZ4F_blockLinked, LZ4F_noContentChecksum, LZ4F_frame, 0ULL, 0U, LZ4F_noBlockChecksum } /* v1.8.3+ */
#define	LZ4F_INIT_PREFERENCES   { LZ4F_INIT_FRAMEINFO, 0, 0u, 0u, { 0u, 0u, 0u } } /* v1.8.3+ */
#define	LZ4F_VERSION   100 /* This number can be used to check for an incompatible API breaking change */
#define	LZ4F_HEADER_SIZE_MIN   7 /* LZ4 Frame header size can vary, depending on selected paramaters */
#define	LZ4F_HEADER_SIZE_MAX   19
#define	LZ4F_BLOCK_HEADER_SIZE   4
#define	LZ4F_BLOCK_CHECKSUM_SIZE   4
#define	LZ4F_CONTENT_CHECKSUM_SIZE   4
#define	LZ4F_MIN_SIZE_TO_KNOW_HEADER_LENGTH   5

Typedefs
typedef size_t	LZ4F_errorCode_t
typedef struct LZ4F_cctx_s	LZ4F_cctx
typedef LZ4F_cctx *	LZ4F_compressionContext_t
typedef struct LZ4F_dctx_s	LZ4F_dctx
typedef LZ4F_dctx *	LZ4F_decompressionContext_t

Enumerations
enum	LZ4F_blockSizeID_t {   LZ4F_default =0 , LZ4F_max64KB =4 , LZ4F_max256KB =5 , LZ4F_max1MB =6 ,   LZ4F_max4MB =7 }
enum	LZ4F_blockMode_t { LZ4F_blockLinked =0 , LZ4F_blockIndependent }
enum	LZ4F_contentChecksum_t { LZ4F_noContentChecksum =0 , LZ4F_contentChecksumEnabled }
enum	LZ4F_blockChecksum_t { LZ4F_noBlockChecksum =0 , LZ4F_blockChecksumEnabled }
enum	LZ4F_frameType_t { LZ4F_frame =0 , LZ4F_skippableFrame }

Functions
LZ4FLIB_API unsigned	LZ4F_isError (LZ4F_errorCode_t code)
LZ4FLIB_API const char *	LZ4F_getErrorName (LZ4F_errorCode_t code)
LZ4FLIB_API int	LZ4F_compressionLevel_max (void)
LZ4FLIB_API size_t	LZ4F_compressFrameBound (size_t srcSize, const LZ4F_preferences_t *preferencesPtr)
LZ4FLIB_API size_t	LZ4F_compressFrame (void *dstBuffer, size_t dstCapacity, const void *srcBuffer, size_t srcSize, const LZ4F_preferences_t *preferencesPtr)
LZ4FLIB_API unsigned	LZ4F_getVersion (void)
LZ4FLIB_API LZ4F_errorCode_t	LZ4F_createCompressionContext (LZ4F_cctx **cctxPtr, unsigned version)
LZ4FLIB_API LZ4F_errorCode_t	LZ4F_freeCompressionContext (LZ4F_cctx *cctx)
LZ4FLIB_API size_t	LZ4F_compressBegin (LZ4F_cctx *cctx, void *dstBuffer, size_t dstCapacity, const LZ4F_preferences_t *prefsPtr)
LZ4FLIB_API size_t	LZ4F_compressBound (size_t srcSize, const LZ4F_preferences_t *prefsPtr)
LZ4FLIB_API size_t	LZ4F_compressUpdate (LZ4F_cctx *cctx, void *dstBuffer, size_t dstCapacity, const void *srcBuffer, size_t srcSize, const LZ4F_compressOptions_t *cOptPtr)
LZ4FLIB_API size_t	LZ4F_flush (LZ4F_cctx *cctx, void *dstBuffer, size_t dstCapacity, const LZ4F_compressOptions_t *cOptPtr)
LZ4FLIB_API size_t	LZ4F_compressEnd (LZ4F_cctx *cctx, void *dstBuffer, size_t dstCapacity, const LZ4F_compressOptions_t *cOptPtr)
LZ4FLIB_API LZ4F_errorCode_t	LZ4F_createDecompressionContext (LZ4F_dctx **dctxPtr, unsigned version)
LZ4FLIB_API LZ4F_errorCode_t	LZ4F_freeDecompressionContext (LZ4F_dctx *dctx)
LZ4FLIB_API size_t	LZ4F_headerSize (const void *src, size_t srcSize)
LZ4FLIB_API size_t	LZ4F_getFrameInfo (LZ4F_dctx *dctx, LZ4F_frameInfo_t *frameInfoPtr, const void *srcBuffer, size_t *srcSizePtr)
LZ4FLIB_API size_t	LZ4F_decompress (LZ4F_dctx *dctx, void *dstBuffer, size_t *dstSizePtr, const void *srcBuffer, size_t *srcSizePtr, const LZ4F_decompressOptions_t *dOptPtr)
LZ4FLIB_API void	LZ4F_resetDecompressionContext (LZ4F_dctx *dctx)

Macro Definition Documentation

LZ4F_BLOCK_CHECKSUM_SIZE

#define LZ4F_BLOCK_CHECKSUM_SIZE   4

Definition at line 266 of file lz4frame.h.

LZ4F_BLOCK_HEADER_SIZE

#define LZ4F_BLOCK_HEADER_SIZE   4

Definition at line 263 of file lz4frame.h.

LZ4F_CONTENT_CHECKSUM_SIZE

#define LZ4F_CONTENT_CHECKSUM_SIZE   4

Definition at line 269 of file lz4frame.h.

LZ4F_DEPRECATE

#define LZ4F_DEPRECATE

(

x

)

x /* no deprecation warning for this compiler */

Definition at line 95 of file lz4frame.h.

LZ4F_HEADER_SIZE_MAX

#define LZ4F_HEADER_SIZE_MAX   19

Definition at line 260 of file lz4frame.h.

LZ4F_HEADER_SIZE_MIN

#define LZ4F_HEADER_SIZE_MIN   7 /* LZ4 Frame header size can vary, depending on selected paramaters */

Definition at line 259 of file lz4frame.h.

LZ4F_INIT_FRAMEINFO

#define LZ4F_INIT_FRAMEINFO   { LZ4F_default, LZ4F_blockLinked, LZ4F_noContentChecksum, LZ4F_frame, 0ULL, 0U, LZ4F_noBlockChecksum } /* v1.8.3+ */

Definition at line 185 of file lz4frame.h.

LZ4F_INIT_PREFERENCES

#define LZ4F_INIT_PREFERENCES   { LZ4F_INIT_FRAMEINFO, 0, 0u, 0u, { 0u, 0u, 0u } } /* v1.8.3+ */

Definition at line 200 of file lz4frame.h.

LZ4F_MIN_SIZE_TO_KNOW_HEADER_LENGTH

#define LZ4F_MIN_SIZE_TO_KNOW_HEADER_LENGTH   5

Definition at line 374 of file lz4frame.h.

LZ4F_OBSOLETE_ENUM

#define LZ4F_OBSOLETE_ENUM

(

x

)

Definition at line 116 of file lz4frame.h.

LZ4F_VERSION

#define LZ4F_VERSION   100 /* This number can be used to check for an incompatible API breaking change */

Definition at line 242 of file lz4frame.h.

LZ4FLIB_API

#define LZ4FLIB_API   LZ4FLIB_VISIBILITY

Definition at line 84 of file lz4frame.h.

LZ4FLIB_VISIBILITY

#define LZ4FLIB_VISIBILITY

Introduction

lz4frame.h implements LZ4 frame specification (doc/lz4_Frame_format.md). lz4frame.h provides frame compression functions that take care of encoding standard metadata alongside LZ4-compressed blocks.

Definition at line 76 of file lz4frame.h.

Typedef Documentation

LZ4F_cctx

typedef struct LZ4F_cctx_s LZ4F_cctx

Definition at line 224 of file lz4frame.h.

LZ4F_compressionContext_t

typedef LZ4F_cctx* LZ4F_compressionContext_t

Definition at line 233 of file lz4frame.h.

LZ4F_dctx

typedef struct LZ4F_dctx_s LZ4F_dctx

Definition at line 338 of file lz4frame.h.

LZ4F_decompressionContext_t

typedef LZ4F_dctx* LZ4F_decompressionContext_t

Definition at line 347 of file lz4frame.h.

LZ4F_errorCode_t

typedef size_t LZ4F_errorCode_t

Definition at line 103 of file lz4frame.h.

Enumeration Type Documentation

LZ4F_blockChecksum_t

enum LZ4F_blockChecksum_t

Enumerator
LZ4F_noBlockChecksum
LZ4F_blockChecksumEnabled

Definition at line 152 of file lz4frame.h.

             {
    LZ4F_noBlockChecksum=0,
    LZ4F_blockChecksumEnabled
} LZ4F_blockChecksum_t;

LZ4F_blockMode_t

enum LZ4F_blockMode_t

Enumerator
LZ4F_blockLinked
LZ4F_blockIndependent

Definition at line 138 of file lz4frame.h.

             {
    LZ4F_blockLinked=0,
    LZ4F_blockIndependent
    LZ4F_OBSOLETE_ENUM(blockLinked)
    LZ4F_OBSOLETE_ENUM(blockIndependent)
} LZ4F_blockMode_t;

LZ4F_blockSizeID_t

enum LZ4F_blockSizeID_t

Enumerator
LZ4F_default
LZ4F_max64KB
LZ4F_max256KB
LZ4F_max1MB
LZ4F_max4MB

Definition at line 123 of file lz4frame.h.

             {
    LZ4F_default=0,
    LZ4F_max64KB=4,
    LZ4F_max256KB=5,
    LZ4F_max1MB=6,
    LZ4F_max4MB=7
    LZ4F_OBSOLETE_ENUM(max64KB)
    LZ4F_OBSOLETE_ENUM(max256KB)
    LZ4F_OBSOLETE_ENUM(max1MB)
    LZ4F_OBSOLETE_ENUM(max4MB)
} LZ4F_blockSizeID_t;

LZ4F_contentChecksum_t

enum LZ4F_contentChecksum_t

Enumerator
LZ4F_noContentChecksum
LZ4F_contentChecksumEnabled

Definition at line 145 of file lz4frame.h.

             {
    LZ4F_noContentChecksum=0,
    LZ4F_contentChecksumEnabled
    LZ4F_OBSOLETE_ENUM(noContentChecksum)
    LZ4F_OBSOLETE_ENUM(contentChecksumEnabled)
} LZ4F_contentChecksum_t;

LZ4F_frameType_t

enum LZ4F_frameType_t

Enumerator
LZ4F_frame
LZ4F_skippableFrame

Definition at line 157 of file lz4frame.h.

             {
    LZ4F_frame=0,
    LZ4F_skippableFrame
    LZ4F_OBSOLETE_ENUM(skippableFrame)
} LZ4F_frameType_t;

Function Documentation

LZ4F_compressBegin()

LZ4FLIB_API size_t LZ4F_compressBegin	(	LZ4F_cctx *	cctxPtr,
		void *	dstBuffer,
		size_t	dstCapacity,
		const LZ4F_preferences_t *	preferencesPtr
	)

LZ4F_compressBegin() : will write the frame header into dstBuffer. dstCapacity must be >= LZ4F_HEADER_SIZE_MAX bytes. prefsPtr is optional : you can provide NULL as argument, all preferences will then be set to default.

Returns

: number of bytes written into dstBuffer for the header or an error code (which can be tested using LZ4F_isError())

LZ4F_compressBegin() : init streaming compression and writes frame header into dstBuffer. dstBuffer must be >= LZ4F_HEADER_SIZE_MAX bytes. preferencesPtr can be NULL, in which case default parameters are selected.

Returns

: number of bytes written into dstBuffer for the header or an error code (can be tested using LZ4F_isError())

Definition at line 710 of file lz4frame.c.

{
    return LZ4F_compressBegin_usingCDict(cctxPtr, dstBuffer, dstCapacity,
                                         NULL, preferencesPtr);
}

References LZ4F_compressBegin_usingCDict(), and NULL.

Referenced by basicTests(), compress_file_internal(), and fuzzerTests().

LZ4F_compressBound()

LZ4FLIB_API size_t LZ4F_compressBound	(	size_t	srcSize,
		const LZ4F_preferences_t *	prefsPtr
	)

LZ4F_compressBound() : Provides minimum dstCapacity required to guarantee success of LZ4F_compressUpdate(), given a srcSize and preferences, for a worst case scenario. When srcSize==0, LZ4F_compressBound() provides an upper bound for LZ4F_flush() and LZ4F_compressEnd() instead. Note that the result is only valid for a single invocation of LZ4F_compressUpdate(). When invoking LZ4F_compressUpdate() multiple times, if the output buffer is gradually filled up instead of emptied and re-used from its start, one must check if there is enough remaining capacity before each invocation, using LZ4F_compressBound().

Returns

is always the same for a srcSize and prefsPtr. prefsPtr is optional : when NULL is provided, preferences will be set to cover worst case scenario. tech details :

if automatic flushing is not enabled, includes the possibility that internal buffer might already be filled by up to (blockSize-1) bytes. It also includes frame footer (ending + checksum), since it might be generated by LZ4F_compressEnd().

doesn't include frame header, as it was already generated by LZ4F_compressBegin().

Definition at line 724 of file lz4frame.c.

{
    if (preferencesPtr && preferencesPtr->autoFlush) {
        return LZ4F_compressBound_internal(srcSize, preferencesPtr, 0);
    }
    return LZ4F_compressBound_internal(srcSize, preferencesPtr, (size_t)-1);
}

References LZ4F_preferences_t::autoFlush, LZ4F_compressBound_internal(), and srcSize.

Referenced by basicTests(), compress_file(), compress_file_internal(), and fuzzerTests().

LZ4F_compressEnd()

LZ4FLIB_API size_t LZ4F_compressEnd	(	LZ4F_cctx *	cctxPtr,
		void *	dstBuffer,
		size_t	dstCapacity,
		const LZ4F_compressOptions_t *	compressOptionsPtr
	)

LZ4F_compressEnd() : To properly finish an LZ4 frame, invoke LZ4F_compressEnd(). It will flush whatever data remained within cctx (like LZ4_flush()) and properly finalize the frame, with an endMark and a checksum. cOptPtr is optional : NULL can be provided, in which case all options will be set to default.

Returns

: nb of bytes written into dstBuffer, necessarily >= 4 (endMark), or an error code if it fails (which can be tested using LZ4F_isError()) Note : LZ4F_compressEnd() is guaranteed to be successful when dstCapacity >= LZ4F_compressBound(0, prefsPtr). A successful call to LZ4F_compressEnd() makes cctx available again for another compression task.

LZ4F_compressEnd() : When you want to properly finish the compressed frame, just call LZ4F_compressEnd(). It will flush whatever data remained within compressionContext (like LZ4_flush()) but also properly finalize the frame, with an endMark and an (optional) checksum. LZ4F_compressOptions_t structure is optional : you can provide NULL as argument.

Returns

: the number of bytes written into dstBuffer (necessarily >= 4 (endMark size)) or an error code if it fails (can be tested using LZ4F_isError()) The context can then be used again to compress a new frame, starting with LZ4F_compressBegin().

Definition at line 986 of file lz4frame.c.

{
    BYTE* const dstStart = (BYTE*)dstBuffer;
    BYTE* dstPtr = dstStart;
 
    size_t const flushSize = LZ4F_flush(cctxPtr, dstBuffer, dstCapacity, compressOptionsPtr);
    DEBUGLOG(5,"LZ4F_compressEnd: dstCapacity=%u", (unsigned)dstCapacity);
    if (LZ4F_isError(flushSize)) return flushSize;
    dstPtr += flushSize;
 
    assert(flushSize <= dstCapacity);
    dstCapacity -= flushSize;
 
    if (dstCapacity < 4) return err0r(LZ4F_ERROR_dstMaxSize_tooSmall);
    LZ4F_writeLE32(dstPtr, 0);
    dstPtr += 4;   /* endMark */
 
    if (cctxPtr->prefs.frameInfo.contentChecksumFlag == LZ4F_contentChecksumEnabled) {
        U32 const xxh = XXH32_digest(&(cctxPtr->xxh));
        if (dstCapacity < 8) return err0r(LZ4F_ERROR_dstMaxSize_tooSmall);
        DEBUGLOG(5,"Writing 32-bit content checksum");
        LZ4F_writeLE32(dstPtr, xxh);
        dstPtr+=4;   /* content Checksum */
    }
 
    cctxPtr->cStage = 0;   /* state is now re-usable (with identical preferences) */
    cctxPtr->maxBufferSize = 0;  /* reuse HC context */
 
    if (cctxPtr->prefs.frameInfo.contentSize) {
        if (cctxPtr->prefs.frameInfo.contentSize != cctxPtr->totalInSize)
            return err0r(LZ4F_ERROR_frameSize_wrong);
    }
 
    return (size_t)(dstPtr - dstStart);
}

References assert, LZ4F_frameInfo_t::contentChecksumFlag, LZ4F_frameInfo_t::contentSize, LZ4F_cctx_s::cStage, DEBUGLOG, err0r(), LZ4F_preferences_t::frameInfo, LZ4F_contentChecksumEnabled, LZ4F_flush(), LZ4F_isError(), LZ4F_writeLE32(), LZ4F_cctx_s::maxBufferSize, LZ4F_cctx_s::prefs, LZ4F_cctx_s::totalInSize, LZ4F_cctx_s::xxh, and XXH32_digest().

Referenced by basicTests(), compress_file_internal(), fuzzerTests(), LZ4F_compressFrame_usingCDict(), and LZ4IO_compressFilename_extRess().

LZ4F_compressFrame()

LZ4FLIB_API size_t LZ4F_compressFrame	(	void *	dstBuffer,
		size_t	dstCapacity,
		const void *	srcBuffer,
		size_t	srcSize,
		const LZ4F_preferences_t *	preferencesPtr
	)

LZ4F_compressFrame() : Compress an entire srcBuffer into a valid LZ4 frame. dstCapacity MUST be >= LZ4F_compressFrameBound(srcSize, preferencesPtr). The LZ4F_preferences_t structure is optional : you can provide NULL as argument. All preferences will be set to default.

Returns

: number of bytes written into dstBuffer. or an error code if it fails (can be tested using LZ4F_isError())

LZ4F_compressFrame() : Compress an entire srcBuffer into a valid LZ4 frame, in a single step. dstBuffer MUST be >= LZ4F_compressFrameBound(srcSize, preferencesPtr). The LZ4F_preferences_t structure is optional : you can provide NULL as argument. All preferences will be set to default.

Returns

: number of bytes written into dstBuffer. or an error code if it fails (can be tested using LZ4F_isError())

Definition at line 429 of file lz4frame.c.

{
    size_t result;
#if (LZ4F_HEAPMODE)
    LZ4F_cctx_t *cctxPtr;
    result = LZ4F_createCompressionContext(&cctxPtr, LZ4F_VERSION);
    if (LZ4F_isError(result)) return result;
#else
    LZ4F_cctx_t cctx;
    LZ4_stream_t lz4ctx;
    LZ4F_cctx_t *cctxPtr = &cctx;
 
    DEBUGLOG(4, "LZ4F_compressFrame");
    MEM_INIT(&cctx, 0, sizeof(cctx));
    cctx.version = LZ4F_VERSION;
    cctx.maxBufferSize = 5 MB;   /* mess with real buffer size to prevent dynamic allocation; works only because autoflush==1 & stableSrc==1 */
    if (preferencesPtr == NULL ||
        preferencesPtr->compressionLevel < LZ4HC_CLEVEL_MIN)
    {
        LZ4_initStream(&lz4ctx, sizeof(lz4ctx));
        cctxPtr->lz4CtxPtr = &lz4ctx;
        cctxPtr->lz4CtxAlloc = 1;
        cctxPtr->lz4CtxState = 1;
    }
#endif
 
    result = LZ4F_compressFrame_usingCDict(cctxPtr, dstBuffer, dstCapacity,
                                           srcBuffer, srcSize,
                                           NULL, preferencesPtr);
 
#if (LZ4F_HEAPMODE)
    LZ4F_freeCompressionContext(cctxPtr);
#else
    if (preferencesPtr != NULL &&
        preferencesPtr->compressionLevel >= LZ4HC_CLEVEL_MIN)
    {
        FREEMEM(cctxPtr->lz4CtxPtr);
    }
#endif
    return result;
}

References LZ4F_preferences_t::compressionLevel, DEBUGLOG, FREEMEM, LZ4_initStream(), LZ4F_cctx_s::lz4CtxAlloc, LZ4F_cctx_s::lz4CtxPtr, LZ4F_cctx_s::lz4CtxState, LZ4F_compressFrame_usingCDict(), LZ4F_createCompressionContext(), LZ4F_freeCompressionContext(), LZ4F_isError(), LZ4F_VERSION, LZ4HC_CLEVEL_MIN, LZ4F_cctx_s::maxBufferSize, MB, MEM_INIT, NULL, srcSize, and LZ4F_cctx_s::version.

Referenced by basicTests(), fullSpeedBench(), fuzzerTests(), LLVMFuzzerTestOneInput(), and local_LZ4F_compressFrame().

LZ4F_compressFrameBound()

LZ4FLIB_API size_t LZ4F_compressFrameBound	(	size_t	srcSize,
		const LZ4F_preferences_t *	preferencesPtr
	)

LZ4F_compressFrameBound() : Returns the maximum possible compressed size with LZ4F_compressFrame() given srcSize and preferences. preferencesPtr is optional. It can be replaced by NULL, in which case, the function will assume default preferences. Note : this result is only usable with LZ4F_compressFrame(). It may also be used with LZ4F_compressUpdate() if no flush() operation is performed.

Definition at line 351 of file lz4frame.c.

{
    LZ4F_preferences_t prefs;
    size_t const headerSize = maxFHSize;      /* max header size, including optional fields */
 
    if (preferencesPtr!=NULL) prefs = *preferencesPtr;
    else MEM_INIT(&prefs, 0, sizeof(prefs));
    prefs.autoFlush = 1;
 
    return headerSize + LZ4F_compressBound_internal(srcSize, &prefs, 0);;
}

References LZ4F_preferences_t::autoFlush, LZ4F_compressBound_internal(), maxFHSize, MEM_INIT, NULL, and srcSize.

Referenced by basicTests(), fuzzerTests(), LLVMFuzzerTestOneInput(), local_LZ4F_compressFrame(), LZ4F_compressFrame_usingCDict(), and LZ4IO_createCResources().

LZ4F_compressionLevel_max()

LZ4FLIB_API int LZ4F_compressionLevel_max

(

void

)

Definition at line 276 of file lz4frame.c.

{ return LZ4HC_CLEVEL_MAX; }

References LZ4HC_CLEVEL_MAX.

Referenced by basicTests().

LZ4F_compressUpdate()

LZ4FLIB_API size_t LZ4F_compressUpdate	(	LZ4F_cctx *	cctxPtr,
		void *	dstBuffer,
		size_t	dstCapacity,
		const void *	srcBuffer,
		size_t	srcSize,
		const LZ4F_compressOptions_t *	compressOptionsPtr
	)

LZ4F_compressUpdate() : LZ4F_compressUpdate() can be called repetitively to compress as much data as necessary. Important rule: dstCapacity MUST be large enough to ensure operation success even in worst case situations. This value is provided by LZ4F_compressBound(). If this condition is not respected, LZ4F_compress() will fail (result is an errorCode). LZ4F_compressUpdate() doesn't guarantee error recovery. When an error occurs, compression context must be freed or resized. cOptPtr is optional : NULL can be provided, in which case all options are set to default.

Returns

: number of bytes written into dstBuffer (it can be zero, meaning input data was just buffered). or an error code if it fails (which can be tested using LZ4F_isError())

LZ4F_compressUpdate() : LZ4F_compressUpdate() can be called repetitively to compress as much data as necessary. dstBuffer MUST be >= LZ4F_compressBound(srcSize, preferencesPtr). LZ4F_compressOptions_t structure is optional : you can provide NULL as argument.

Returns

: the number of bytes written into dstBuffer. It can be zero, meaning input data was just buffered. or an error code if it fails (which can be tested using LZ4F_isError())

Definition at line 825 of file lz4frame.c.

{
    LZ4F_compressOptions_t cOptionsNull;
    size_t const blockSize = cctxPtr->maxBlockSize;
    const BYTE* srcPtr = (const BYTE*)srcBuffer;
    const BYTE* const srcEnd = srcPtr + srcSize;
    BYTE* const dstStart = (BYTE*)dstBuffer;
    BYTE* dstPtr = dstStart;
    LZ4F_lastBlockStatus lastBlockCompressed = notDone;
    compressFunc_t const compress = LZ4F_selectCompression(cctxPtr->prefs.frameInfo.blockMode, cctxPtr->prefs.compressionLevel);
 
    DEBUGLOG(4, "LZ4F_compressUpdate (srcSize=%zu)", srcSize);
 
    if (cctxPtr->cStage != 1) return err0r(LZ4F_ERROR_GENERIC);
    if (dstCapacity < LZ4F_compressBound_internal(srcSize, &(cctxPtr->prefs), cctxPtr->tmpInSize))
        return err0r(LZ4F_ERROR_dstMaxSize_tooSmall);
    MEM_INIT(&cOptionsNull, 0, sizeof(cOptionsNull));
    if (compressOptionsPtr == NULL) compressOptionsPtr = &cOptionsNull;
 
    /* complete tmp buffer */
    if (cctxPtr->tmpInSize > 0) {   /* some data already within tmp buffer */
        size_t const sizeToCopy = blockSize - cctxPtr->tmpInSize;
        if (sizeToCopy > srcSize) {
            /* add src to tmpIn buffer */
            memcpy(cctxPtr->tmpIn + cctxPtr->tmpInSize, srcBuffer, srcSize);
            srcPtr = srcEnd;
            cctxPtr->tmpInSize += srcSize;
            /* still needs some CRC */
        } else {
            /* complete tmpIn block and then compress it */
            lastBlockCompressed = fromTmpBuffer;
            memcpy(cctxPtr->tmpIn + cctxPtr->tmpInSize, srcBuffer, sizeToCopy);
            srcPtr += sizeToCopy;
 
            dstPtr += LZ4F_makeBlock(dstPtr,
                                     cctxPtr->tmpIn, blockSize,
                                     compress, cctxPtr->lz4CtxPtr, cctxPtr->prefs.compressionLevel,
                                     cctxPtr->cdict,
                                     cctxPtr->prefs.frameInfo.blockChecksumFlag);
 
            if (cctxPtr->prefs.frameInfo.blockMode==LZ4F_blockLinked) cctxPtr->tmpIn += blockSize;
            cctxPtr->tmpInSize = 0;
        }
    }
 
    while ((size_t)(srcEnd - srcPtr) >= blockSize) {
        /* compress full blocks */
        lastBlockCompressed = fromSrcBuffer;
        dstPtr += LZ4F_makeBlock(dstPtr,
                                 srcPtr, blockSize,
                                 compress, cctxPtr->lz4CtxPtr, cctxPtr->prefs.compressionLevel,
                                 cctxPtr->cdict,
                                 cctxPtr->prefs.frameInfo.blockChecksumFlag);
        srcPtr += blockSize;
    }
 
    if ((cctxPtr->prefs.autoFlush) && (srcPtr < srcEnd)) {
        /* compress remaining input < blockSize */
        lastBlockCompressed = fromSrcBuffer;
        dstPtr += LZ4F_makeBlock(dstPtr,
                                 srcPtr, (size_t)(srcEnd - srcPtr),
                                 compress, cctxPtr->lz4CtxPtr, cctxPtr->prefs.compressionLevel,
                                 cctxPtr->cdict,
                                 cctxPtr->prefs.frameInfo.blockChecksumFlag);
        srcPtr  = srcEnd;
    }
 
    /* preserve dictionary if necessary */
    if ((cctxPtr->prefs.frameInfo.blockMode==LZ4F_blockLinked) && (lastBlockCompressed==fromSrcBuffer)) {
        if (compressOptionsPtr->stableSrc) {
            cctxPtr->tmpIn = cctxPtr->tmpBuff;
        } else {
            int const realDictSize = LZ4F_localSaveDict(cctxPtr);
            if (realDictSize==0) return err0r(LZ4F_ERROR_GENERIC);
            cctxPtr->tmpIn = cctxPtr->tmpBuff + realDictSize;
        }
    }
 
    /* keep tmpIn within limits */
    if ((cctxPtr->tmpIn + blockSize) > (cctxPtr->tmpBuff + cctxPtr->maxBufferSize)   /* necessarily LZ4F_blockLinked && lastBlockCompressed==fromTmpBuffer */
        && !(cctxPtr->prefs.autoFlush))
    {
        int const realDictSize = LZ4F_localSaveDict(cctxPtr);
        cctxPtr->tmpIn = cctxPtr->tmpBuff + realDictSize;
    }
 
    /* some input data left, necessarily < blockSize */
    if (srcPtr < srcEnd) {
        /* fill tmp buffer */
        size_t const sizeToCopy = (size_t)(srcEnd - srcPtr);
        memcpy(cctxPtr->tmpIn, srcPtr, sizeToCopy);
        cctxPtr->tmpInSize = sizeToCopy;
    }
 
    if (cctxPtr->prefs.frameInfo.contentChecksumFlag == LZ4F_contentChecksumEnabled)
        (void)XXH32_update(&(cctxPtr->xxh), srcBuffer, srcSize);
 
    cctxPtr->totalInSize += srcSize;
    return (size_t)(dstPtr - dstStart);
}

References LZ4F_preferences_t::autoFlush, LZ4F_frameInfo_t::blockChecksumFlag, LZ4F_frameInfo_t::blockMode, LZ4F_cctx_s::cdict, compress(), LZ4F_preferences_t::compressionLevel, LZ4F_frameInfo_t::contentChecksumFlag, LZ4F_cctx_s::cStage, DEBUGLOG, err0r(), LZ4F_preferences_t::frameInfo, fromSrcBuffer, fromTmpBuffer, LZ4F_cctx_s::lz4CtxPtr, LZ4F_blockLinked, LZ4F_compressBound_internal(), LZ4F_contentChecksumEnabled, LZ4F_localSaveDict(), LZ4F_makeBlock(), LZ4F_selectCompression(), LZ4F_cctx_s::maxBlockSize, LZ4F_cctx_s::maxBufferSize, MEM_INIT, memcpy(), notDone, NULL, LZ4F_cctx_s::prefs, srcSize, LZ4F_compressOptions_t::stableSrc, LZ4F_cctx_s::tmpBuff, LZ4F_cctx_s::tmpIn, LZ4F_cctx_s::tmpInSize, LZ4F_cctx_s::totalInSize, LZ4F_cctx_s::xxh, and XXH32_update().

Referenced by basicTests(), compress_file_internal(), fuzzerTests(), LZ4F_compressFrame_usingCDict(), and LZ4IO_compressFilename_extRess().

LZ4F_createCompressionContext()

LZ4FLIB_API LZ4F_errorCode_t LZ4F_createCompressionContext	(	LZ4F_cctx **	LZ4F_compressionContextPtr,
		unsigned	version
	)

LZ4F_createCompressionContext() : The first thing to do is to create a compressionContext object, which will be used in all compression operations. This is achieved using LZ4F_createCompressionContext(), which takes as argument a version. The version provided MUST be LZ4F_VERSION. It is intended to track potential version mismatch, notably when using DLL. The function will provide a pointer to a fully allocated LZ4F_cctx object. If

Returns

!= zero, there was an error during context creation. Object can release its memory using LZ4F_freeCompressionContext();

LZ4F_createCompressionContext() : The first thing to do is to create a compressionContext object, which will be used in all compression operations. This is achieved using LZ4F_createCompressionContext(), which takes as argument a version and an LZ4F_preferences_t structure. The version provided MUST be LZ4F_VERSION. It is intended to track potential incompatible differences between different binaries. The function will provide a pointer to an allocated LZ4F_compressionContext_t object. If the result LZ4F_errorCode_t is not OK_NoError, there was an error during context creation. Object can release its memory using LZ4F_freeCompressionContext();

Definition at line 536 of file lz4frame.c.

{
    LZ4F_cctx_t* const cctxPtr = (LZ4F_cctx_t*)ALLOC_AND_ZERO(sizeof(LZ4F_cctx_t));
    if (cctxPtr==NULL) return err0r(LZ4F_ERROR_allocation_failed);
 
    cctxPtr->version = version;
    cctxPtr->cStage = 0;   /* Next stage : init stream */
 
    *LZ4F_compressionContextPtr = cctxPtr;
 
    return LZ4F_OK_NoError;
}

References ALLOC_AND_ZERO, LZ4F_cctx_s::cStage, err0r(), NULL, LZ4F_cctx_s::version, and version.

Referenced by basicTests(), compress_file(), fuzzerTests(), LZ4F_compressFrame(), and LZ4IO_createCResources().

LZ4F_createDecompressionContext()

LZ4FLIB_API LZ4F_errorCode_t LZ4F_createDecompressionContext	(	LZ4F_dctx **	LZ4F_decompressionContextPtr,
		unsigned	versionNumber
	)

LZ4F_createDecompressionContext() : Create an LZ4F_dctx object, to track all decompression operations. The version provided MUST be LZ4F_VERSION. The function provides a pointer to an allocated and initialized LZ4F_dctx object. The result is an errorCode, which can be tested using LZ4F_isError(). dctx memory can be released using LZ4F_freeDecompressionContext(); Result of LZ4F_freeDecompressionContext() indicates current state of decompressionContext when being released. That is, it should be == 0 if decompression has been completed fully and correctly.

LZ4F_createDecompressionContext() : Create a decompressionContext object, which will track all decompression operations. Provides a pointer to a fully allocated and initialized LZ4F_decompressionContext object. Object can later be released using LZ4F_freeDecompressionContext().

Returns

: if != 0, there was an error during context creation.

Definition at line 1069 of file lz4frame.c.

{
    LZ4F_dctx* const dctx = (LZ4F_dctx*)ALLOC_AND_ZERO(sizeof(LZ4F_dctx));
    if (dctx == NULL) {  /* failed allocation */
        *LZ4F_decompressionContextPtr = NULL;
        return err0r(LZ4F_ERROR_allocation_failed);
    }
 
    dctx->version = versionNumber;
    *LZ4F_decompressionContextPtr = dctx;
    return LZ4F_OK_NoError;
}

References ALLOC_AND_ZERO, err0r(), NULL, and LZ4F_dctx_s::version.

Referenced by basicTests(), createCResources(), decompress_file(), fullSpeedBench(), FUZZ_decompressFrame(), fuzzerTests(), LLVMFuzzerTestOneInput(), LZ4IO_createDResources(), and LZ4IO_getCompressedFileInfo().

LZ4F_decompress()

LZ4FLIB_API size_t LZ4F_decompress	(	LZ4F_dctx *	dctx,
		void *	dstBuffer,
		size_t *	dstSizePtr,
		const void *	srcBuffer,
		size_t *	srcSizePtr,
		const LZ4F_decompressOptions_t *	decompressOptionsPtr
	)

LZ4F_decompress() : Call this function repetitively to regenerate data compressed in srcBuffer.

The function requires a valid dctx state. It will read up to *srcSizePtr bytes from srcBuffer, and decompress data into dstBuffer, of capacity *dstSizePtr.

The nb of bytes consumed from srcBuffer will be written into *srcSizePtr (necessarily <= original value). The nb of bytes decompressed into dstBuffer will be written into *dstSizePtr (necessarily <= original value).

The function does not necessarily read all input bytes, so always check value in *srcSizePtr. Unconsumed source data must be presented again in subsequent invocations.

dstBuffer can freely change between each consecutive function invocation. dstBuffer content will be overwritten.

Returns

: an hint of how many srcSize bytes LZ4F_decompress() expects for next call. Schematically, it's the size of the current (or remaining) compressed block + header of next block. Respecting the hint provides some small speed benefit, because it skips intermediate buffers. This is just a hint though, it's always possible to provide any srcSize.

When a frame is fully decoded,

Returns

will be 0 (no more data expected). When provided with more bytes than necessary to decode a frame, LZ4F_decompress() will stop reading exactly at end of current frame, and

0.

If decompression failed,

Returns

is an error code, which can be tested using LZ4F_isError(). After a decompression error, the dctx context is not resumable. Use LZ4F_resetDecompressionContext() to return to clean state.

After a frame is fully decoded, dctx can be used again to decompress another frame.

LZ4F_decompress() : Call this function repetitively to regenerate compressed data in srcBuffer. The function will attempt to decode up to *srcSizePtr bytes from srcBuffer into dstBuffer of capacity *dstSizePtr.

The number of bytes regenerated into dstBuffer will be provided within *dstSizePtr (necessarily <= original value).

The number of bytes effectively read from srcBuffer will be provided within *srcSizePtr (necessarily <= original value). If number of bytes read is < number of bytes provided, then decompression operation is not complete. Remaining data will have to be presented again in a subsequent invocation.

The function result is an hint of the better srcSize to use for next call to LZ4F_decompress. Schematically, it's the size of the current (or remaining) compressed block + header of next block. Respecting the hint provides a small boost to performance, since it allows less buffer shuffling. Note that this is just a hint, and it's always possible to any srcSize value. When a frame is fully decoded,

Returns

will be 0. If decompression failed,

is an error code which can be tested using LZ4F_isError().

Definition at line 1384 of file lz4frame.c.

{
    LZ4F_decompressOptions_t optionsNull;
    const BYTE* const srcStart = (const BYTE*)srcBuffer;
    const BYTE* const srcEnd = srcStart + *srcSizePtr;
    const BYTE* srcPtr = srcStart;
    BYTE* const dstStart = (BYTE*)dstBuffer;
    BYTE* const dstEnd = dstStart ? dstStart + *dstSizePtr : NULL;
    BYTE* dstPtr = dstStart;
    const BYTE* selectedIn = NULL;
    unsigned doAnotherStage = 1;
    size_t nextSrcSizeHint = 1;
 
 
    DEBUGLOG(5, "LZ4F_decompress : %p,%u => %p,%u",
            srcBuffer, (unsigned)*srcSizePtr, dstBuffer, (unsigned)*dstSizePtr);
    if (dstBuffer == NULL) assert(*dstSizePtr == 0);
    MEM_INIT(&optionsNull, 0, sizeof(optionsNull));
    if (decompressOptionsPtr==NULL) decompressOptionsPtr = &optionsNull;
    *srcSizePtr = 0;
    *dstSizePtr = 0;
    assert(dctx != NULL);
 
    /* behaves as a state machine */
 
    while (doAnotherStage) {
 
        switch(dctx->dStage)
        {
 
        case dstage_getFrameHeader:
            DEBUGLOG(6, "dstage_getFrameHeader");
            if ((size_t)(srcEnd-srcPtr) >= maxFHSize) {  /* enough to decode - shortcut */
                size_t const hSize = LZ4F_decodeHeader(dctx, srcPtr, (size_t)(srcEnd-srcPtr));  /* will update dStage appropriately */
                if (LZ4F_isError(hSize)) return hSize;
                srcPtr += hSize;
                break;
            }
            dctx->tmpInSize = 0;
            if (srcEnd-srcPtr == 0) return minFHSize;   /* 0-size input */
            dctx->tmpInTarget = minFHSize;   /* minimum size to decode header */
            dctx->dStage = dstage_storeFrameHeader;
            /* fall-through */
 
        case dstage_storeFrameHeader:
            DEBUGLOG(6, "dstage_storeFrameHeader");
            {   size_t const sizeToCopy = MIN(dctx->tmpInTarget - dctx->tmpInSize, (size_t)(srcEnd - srcPtr));
                memcpy(dctx->header + dctx->tmpInSize, srcPtr, sizeToCopy);
                dctx->tmpInSize += sizeToCopy;
                srcPtr += sizeToCopy;
            }
            if (dctx->tmpInSize < dctx->tmpInTarget) {
                nextSrcSizeHint = (dctx->tmpInTarget - dctx->tmpInSize) + BHSize;   /* rest of header + nextBlockHeader */
                doAnotherStage = 0;   /* not enough src data, ask for some more */
                break;
            }
            {   size_t const hSize = LZ4F_decodeHeader(dctx, dctx->header, dctx->tmpInTarget);  /* will update dStage appropriately */
                if (LZ4F_isError(hSize)) return hSize;
            }
            break;
 
        case dstage_init:
            DEBUGLOG(6, "dstage_init");
            if (dctx->frameInfo.contentChecksumFlag) (void)XXH32_reset(&(dctx->xxh), 0);
            /* internal buffers allocation */
            {   size_t const bufferNeeded = dctx->maxBlockSize
                    + ((dctx->frameInfo.blockMode==LZ4F_blockLinked) ? 128 KB : 0);
                if (bufferNeeded > dctx->maxBufferSize) {   /* tmp buffers too small */
                    dctx->maxBufferSize = 0;   /* ensure allocation will be re-attempted on next entry*/
                    FREEMEM(dctx->tmpIn);
                    dctx->tmpIn = (BYTE*)ALLOC(dctx->maxBlockSize + BFSize /* block checksum */);
                    if (dctx->tmpIn == NULL)
                        return err0r(LZ4F_ERROR_allocation_failed);
                    FREEMEM(dctx->tmpOutBuffer);
                    dctx->tmpOutBuffer= (BYTE*)ALLOC(bufferNeeded);
                    if (dctx->tmpOutBuffer== NULL)
                        return err0r(LZ4F_ERROR_allocation_failed);
                    dctx->maxBufferSize = bufferNeeded;
            }   }
            dctx->tmpInSize = 0;
            dctx->tmpInTarget = 0;
            dctx->tmpOut = dctx->tmpOutBuffer;
            dctx->tmpOutStart = 0;
            dctx->tmpOutSize = 0;
 
            dctx->dStage = dstage_getBlockHeader;
            /* fall-through */
 
        case dstage_getBlockHeader:
            if ((size_t)(srcEnd - srcPtr) >= BHSize) {
                selectedIn = srcPtr;
                srcPtr += BHSize;
            } else {
                /* not enough input to read cBlockSize field */
                dctx->tmpInSize = 0;
                dctx->dStage = dstage_storeBlockHeader;
            }
 
            if (dctx->dStage == dstage_storeBlockHeader)   /* can be skipped */
        case dstage_storeBlockHeader:
            {   size_t const remainingInput = (size_t)(srcEnd - srcPtr);
                size_t const wantedData = BHSize - dctx->tmpInSize;
                size_t const sizeToCopy = MIN(wantedData, remainingInput);
                memcpy(dctx->tmpIn + dctx->tmpInSize, srcPtr, sizeToCopy);
                srcPtr += sizeToCopy;
                dctx->tmpInSize += sizeToCopy;
 
                if (dctx->tmpInSize < BHSize) {   /* not enough input for cBlockSize */
                    nextSrcSizeHint = BHSize - dctx->tmpInSize;
                    doAnotherStage  = 0;
                    break;
                }
                selectedIn = dctx->tmpIn;
            }   /* if (dctx->dStage == dstage_storeBlockHeader) */
 
        /* decode block header */
            {   U32 const blockHeader = LZ4F_readLE32(selectedIn);
                size_t const nextCBlockSize = blockHeader & 0x7FFFFFFFU;
                size_t const crcSize = dctx->frameInfo.blockChecksumFlag * BFSize;
                if (blockHeader==0) {  /* frameEnd signal, no more block */
                    DEBUGLOG(5, "end of frame");
                    dctx->dStage = dstage_getSuffix;
                    break;
                }
                if (nextCBlockSize > dctx->maxBlockSize) {
                    return err0r(LZ4F_ERROR_maxBlockSize_invalid);
                }
                if (blockHeader & LZ4F_BLOCKUNCOMPRESSED_FLAG) {
                    /* next block is uncompressed */
                    dctx->tmpInTarget = nextCBlockSize;
                    DEBUGLOG(5, "next block is uncompressed (size %u)", (U32)nextCBlockSize);
                    if (dctx->frameInfo.blockChecksumFlag) {
                        (void)XXH32_reset(&dctx->blockChecksum, 0);
                    }
                    dctx->dStage = dstage_copyDirect;
                    break;
                }
                /* next block is a compressed block */
                dctx->tmpInTarget = nextCBlockSize + crcSize;
                dctx->dStage = dstage_getCBlock;
                if (dstPtr==dstEnd || srcPtr==srcEnd) {
                    nextSrcSizeHint = BHSize + nextCBlockSize + crcSize;
                    doAnotherStage = 0;
                }
                break;
            }
 
        case dstage_copyDirect:   /* uncompressed block */
            DEBUGLOG(6, "dstage_copyDirect");
            {   size_t sizeToCopy;
                if (dstPtr == NULL) {
                    sizeToCopy = 0;
                } else {
                    size_t const minBuffSize = MIN((size_t)(srcEnd-srcPtr), (size_t)(dstEnd-dstPtr));
                    sizeToCopy = MIN(dctx->tmpInTarget, minBuffSize);
                    memcpy(dstPtr, srcPtr, sizeToCopy);
                    if (dctx->frameInfo.blockChecksumFlag) {
                        (void)XXH32_update(&dctx->blockChecksum, srcPtr, sizeToCopy);
                    }
                    if (dctx->frameInfo.contentChecksumFlag)
                        (void)XXH32_update(&dctx->xxh, srcPtr, sizeToCopy);
                    if (dctx->frameInfo.contentSize)
                        dctx->frameRemainingSize -= sizeToCopy;
 
                    /* history management (linked blocks only)*/
                    if (dctx->frameInfo.blockMode == LZ4F_blockLinked) {
                        LZ4F_updateDict(dctx, dstPtr, sizeToCopy, dstStart, 0);
                }   }
 
                srcPtr += sizeToCopy;
                dstPtr += sizeToCopy;
                if (sizeToCopy == dctx->tmpInTarget) {   /* all done */
                    if (dctx->frameInfo.blockChecksumFlag) {
                        dctx->tmpInSize = 0;
                        dctx->dStage = dstage_getBlockChecksum;
                    } else
                        dctx->dStage = dstage_getBlockHeader;  /* new block */
                    break;
                }
                dctx->tmpInTarget -= sizeToCopy;  /* need to copy more */
            }
            nextSrcSizeHint = dctx->tmpInTarget +
                            +(dctx->frameInfo.blockChecksumFlag ? BFSize : 0)
                            + BHSize /* next header size */;
            doAnotherStage = 0;
            break;
 
        /* check block checksum for recently transferred uncompressed block */
        case dstage_getBlockChecksum:
            DEBUGLOG(6, "dstage_getBlockChecksum");
            {   const void* crcSrc;
                if ((srcEnd-srcPtr >= 4) && (dctx->tmpInSize==0)) {
                    crcSrc = srcPtr;
                    srcPtr += 4;
                } else {
                    size_t const stillToCopy = 4 - dctx->tmpInSize;
                    size_t const sizeToCopy = MIN(stillToCopy, (size_t)(srcEnd-srcPtr));
                    memcpy(dctx->header + dctx->tmpInSize, srcPtr, sizeToCopy);
                    dctx->tmpInSize += sizeToCopy;
                    srcPtr += sizeToCopy;
                    if (dctx->tmpInSize < 4) {  /* all input consumed */
                        doAnotherStage = 0;
                        break;
                    }
                    crcSrc = dctx->header;
                }
                {   U32 const readCRC = LZ4F_readLE32(crcSrc);
                    U32 const calcCRC = XXH32_digest(&dctx->blockChecksum);
#ifndef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION
                    DEBUGLOG(6, "compare block checksum");
                    if (readCRC != calcCRC) {
                        DEBUGLOG(4, "incorrect block checksum: %08X != %08X",
                                readCRC, calcCRC);
                        return err0r(LZ4F_ERROR_blockChecksum_invalid);
                    }
#else
                    (void)readCRC;
                    (void)calcCRC;
#endif
            }   }
            dctx->dStage = dstage_getBlockHeader;  /* new block */
            break;
 
        case dstage_getCBlock:
            DEBUGLOG(6, "dstage_getCBlock");
            if ((size_t)(srcEnd-srcPtr) < dctx->tmpInTarget) {
                dctx->tmpInSize = 0;
                dctx->dStage = dstage_storeCBlock;
                break;
            }
            /* input large enough to read full block directly */
            selectedIn = srcPtr;
            srcPtr += dctx->tmpInTarget;
 
            if (0)  /* always jump over next block */
        case dstage_storeCBlock:
            {   size_t const wantedData = dctx->tmpInTarget - dctx->tmpInSize;
                size_t const inputLeft = (size_t)(srcEnd-srcPtr);
                size_t const sizeToCopy = MIN(wantedData, inputLeft);
                memcpy(dctx->tmpIn + dctx->tmpInSize, srcPtr, sizeToCopy);
                dctx->tmpInSize += sizeToCopy;
                srcPtr += sizeToCopy;
                if (dctx->tmpInSize < dctx->tmpInTarget) { /* need more input */
                    nextSrcSizeHint = (dctx->tmpInTarget - dctx->tmpInSize)
                                    + (dctx->frameInfo.blockChecksumFlag ? BFSize : 0)
                                    + BHSize /* next header size */;
                    doAnotherStage = 0;
                    break;
                }
                selectedIn = dctx->tmpIn;
            }
 
            /* At this stage, input is large enough to decode a block */
            if (dctx->frameInfo.blockChecksumFlag) {
                dctx->tmpInTarget -= 4;
                assert(selectedIn != NULL);  /* selectedIn is defined at this stage (either srcPtr, or dctx->tmpIn) */
                {   U32 const readBlockCrc = LZ4F_readLE32(selectedIn + dctx->tmpInTarget);
                    U32 const calcBlockCrc = XXH32(selectedIn, dctx->tmpInTarget, 0);
#ifndef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION
                    if (readBlockCrc != calcBlockCrc)
                        return err0r(LZ4F_ERROR_blockChecksum_invalid);
#else
                    (void)readBlockCrc;
                    (void)calcBlockCrc;
#endif
            }   }
 
            if ((size_t)(dstEnd-dstPtr) >= dctx->maxBlockSize) {
                const char* dict = (const char*)dctx->dict;
                size_t dictSize = dctx->dictSize;
                int decodedSize;
                assert(dstPtr != NULL);
                if (dict && dictSize > 1 GB) {
                    /* the dictSize param is an int, avoid truncation / sign issues */
                    dict += dictSize - 64 KB;
                    dictSize = 64 KB;
                }
                /* enough capacity in `dst` to decompress directly there */
                decodedSize = LZ4_decompress_safe_usingDict(
                        (const char*)selectedIn, (char*)dstPtr,
                        (int)dctx->tmpInTarget, (int)dctx->maxBlockSize,
                        dict, (int)dictSize);
                if (decodedSize < 0) return err0r(LZ4F_ERROR_GENERIC);   /* decompression failed */
                if (dctx->frameInfo.contentChecksumFlag)
                    XXH32_update(&(dctx->xxh), dstPtr, (size_t)decodedSize);
                if (dctx->frameInfo.contentSize)
                    dctx->frameRemainingSize -= (size_t)decodedSize;
 
                /* dictionary management */
                if (dctx->frameInfo.blockMode==LZ4F_blockLinked) {
                    LZ4F_updateDict(dctx, dstPtr, (size_t)decodedSize, dstStart, 0);
                }
 
                dstPtr += decodedSize;
                dctx->dStage = dstage_getBlockHeader;
                break;
            }
 
            /* not enough place into dst : decode into tmpOut */
            /* ensure enough place for tmpOut */
            if (dctx->frameInfo.blockMode == LZ4F_blockLinked) {
                if (dctx->dict == dctx->tmpOutBuffer) {
                    if (dctx->dictSize > 128 KB) {
                        memcpy(dctx->tmpOutBuffer, dctx->dict + dctx->dictSize - 64 KB, 64 KB);
                        dctx->dictSize = 64 KB;
                    }
                    dctx->tmpOut = dctx->tmpOutBuffer + dctx->dictSize;
                } else {  /* dict not within tmp */
                    size_t const reservedDictSpace = MIN(dctx->dictSize, 64 KB);
                    dctx->tmpOut = dctx->tmpOutBuffer + reservedDictSpace;
            }   }
 
            /* Decode block */
            {   const char* dict = (const char*)dctx->dict;
                size_t dictSize = dctx->dictSize;
                int decodedSize;
                if (dict && dictSize > 1 GB) {
                    /* the dictSize param is an int, avoid truncation / sign issues */
                    dict += dictSize - 64 KB;
                    dictSize = 64 KB;
                }
                decodedSize = LZ4_decompress_safe_usingDict(
                        (const char*)selectedIn, (char*)dctx->tmpOut,
                        (int)dctx->tmpInTarget, (int)dctx->maxBlockSize,
                        dict, (int)dictSize);
                if (decodedSize < 0)  /* decompression failed */
                    return err0r(LZ4F_ERROR_decompressionFailed);
                if (dctx->frameInfo.contentChecksumFlag)
                    XXH32_update(&(dctx->xxh), dctx->tmpOut, (size_t)decodedSize);
                if (dctx->frameInfo.contentSize)
                    dctx->frameRemainingSize -= (size_t)decodedSize;
                dctx->tmpOutSize = (size_t)decodedSize;
                dctx->tmpOutStart = 0;
                dctx->dStage = dstage_flushOut;
            }
            /* fall-through */
 
        case dstage_flushOut:  /* flush decoded data from tmpOut to dstBuffer */
            DEBUGLOG(6, "dstage_flushOut");
            if (dstPtr != NULL) {
                size_t const sizeToCopy = MIN(dctx->tmpOutSize - dctx->tmpOutStart, (size_t)(dstEnd-dstPtr));
                memcpy(dstPtr, dctx->tmpOut + dctx->tmpOutStart, sizeToCopy);
 
                /* dictionary management */
                if (dctx->frameInfo.blockMode == LZ4F_blockLinked)
                    LZ4F_updateDict(dctx, dstPtr, sizeToCopy, dstStart, 1 /*withinTmp*/);
 
                dctx->tmpOutStart += sizeToCopy;
                dstPtr += sizeToCopy;
            }
            if (dctx->tmpOutStart == dctx->tmpOutSize) { /* all flushed */
                dctx->dStage = dstage_getBlockHeader;  /* get next block */
                break;
            }
            /* could not flush everything : stop there, just request a block header */
            doAnotherStage = 0;
            nextSrcSizeHint = BHSize;
            break;
 
        case dstage_getSuffix:
            if (dctx->frameRemainingSize)
                return err0r(LZ4F_ERROR_frameSize_wrong);   /* incorrect frame size decoded */
            if (!dctx->frameInfo.contentChecksumFlag) {  /* no checksum, frame is completed */
                nextSrcSizeHint = 0;
                LZ4F_resetDecompressionContext(dctx);
                doAnotherStage = 0;
                break;
            }
            if ((srcEnd - srcPtr) < 4) {  /* not enough size for entire CRC */
                dctx->tmpInSize = 0;
                dctx->dStage = dstage_storeSuffix;
            } else {
                selectedIn = srcPtr;
                srcPtr += 4;
            }
 
            if (dctx->dStage == dstage_storeSuffix)   /* can be skipped */
        case dstage_storeSuffix:
            {   size_t const remainingInput = (size_t)(srcEnd - srcPtr);
                size_t const wantedData = 4 - dctx->tmpInSize;
                size_t const sizeToCopy = MIN(wantedData, remainingInput);
                memcpy(dctx->tmpIn + dctx->tmpInSize, srcPtr, sizeToCopy);
                srcPtr += sizeToCopy;
                dctx->tmpInSize += sizeToCopy;
                if (dctx->tmpInSize < 4) { /* not enough input to read complete suffix */
                    nextSrcSizeHint = 4 - dctx->tmpInSize;
                    doAnotherStage=0;
                    break;
                }
                selectedIn = dctx->tmpIn;
            }   /* if (dctx->dStage == dstage_storeSuffix) */
 
        /* case dstage_checkSuffix: */   /* no direct entry, avoid initialization risks */
            {   U32 const readCRC = LZ4F_readLE32(selectedIn);
                U32 const resultCRC = XXH32_digest(&(dctx->xxh));
#ifndef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION
                if (readCRC != resultCRC)
                    return err0r(LZ4F_ERROR_contentChecksum_invalid);
#else
                (void)readCRC;
                (void)resultCRC;
#endif
                nextSrcSizeHint = 0;
                LZ4F_resetDecompressionContext(dctx);
                doAnotherStage = 0;
                break;
            }
 
        case dstage_getSFrameSize:
            if ((srcEnd - srcPtr) >= 4) {
                selectedIn = srcPtr;
                srcPtr += 4;
            } else {
                /* not enough input to read cBlockSize field */
                dctx->tmpInSize = 4;
                dctx->tmpInTarget = 8;
                dctx->dStage = dstage_storeSFrameSize;
            }
 
            if (dctx->dStage == dstage_storeSFrameSize)
        case dstage_storeSFrameSize:
            {   size_t const sizeToCopy = MIN(dctx->tmpInTarget - dctx->tmpInSize,
                                             (size_t)(srcEnd - srcPtr) );
                memcpy(dctx->header + dctx->tmpInSize, srcPtr, sizeToCopy);
                srcPtr += sizeToCopy;
                dctx->tmpInSize += sizeToCopy;
                if (dctx->tmpInSize < dctx->tmpInTarget) {
                    /* not enough input to get full sBlockSize; wait for more */
                    nextSrcSizeHint = dctx->tmpInTarget - dctx->tmpInSize;
                    doAnotherStage = 0;
                    break;
                }
                selectedIn = dctx->header + 4;
            }   /* if (dctx->dStage == dstage_storeSFrameSize) */
 
        /* case dstage_decodeSFrameSize: */   /* no direct entry */
            {   size_t const SFrameSize = LZ4F_readLE32(selectedIn);
                dctx->frameInfo.contentSize = SFrameSize;
                dctx->tmpInTarget = SFrameSize;
                dctx->dStage = dstage_skipSkippable;
                break;
            }
 
        case dstage_skipSkippable:
            {   size_t const skipSize = MIN(dctx->tmpInTarget, (size_t)(srcEnd-srcPtr));
                srcPtr += skipSize;
                dctx->tmpInTarget -= skipSize;
                doAnotherStage = 0;
                nextSrcSizeHint = dctx->tmpInTarget;
                if (nextSrcSizeHint) break;  /* still more to skip */
                /* frame fully skipped : prepare context for a new frame */
                LZ4F_resetDecompressionContext(dctx);
                break;
            }
        }   /* switch (dctx->dStage) */
    }   /* while (doAnotherStage) */
 
    /* preserve history within tmp whenever necessary */
    LZ4F_STATIC_ASSERT((unsigned)dstage_init == 2);
    if ( (dctx->frameInfo.blockMode==LZ4F_blockLinked)  /* next block will use up to 64KB from previous ones */
      && (dctx->dict != dctx->tmpOutBuffer)             /* dictionary is not already within tmp */
      && (dctx->dict != NULL)                           /* dictionary exists */
      && (!decompressOptionsPtr->stableDst)             /* cannot rely on dst data to remain there for next call */
      && ((unsigned)(dctx->dStage)-2 < (unsigned)(dstage_getSuffix)-2) )  /* valid stages : [init ... getSuffix[ */
    {
        if (dctx->dStage == dstage_flushOut) {
            size_t const preserveSize = (size_t)(dctx->tmpOut - dctx->tmpOutBuffer);
            size_t copySize = 64 KB - dctx->tmpOutSize;
            const BYTE* oldDictEnd = dctx->dict + dctx->dictSize - dctx->tmpOutStart;
            if (dctx->tmpOutSize > 64 KB) copySize = 0;
            if (copySize > preserveSize) copySize = preserveSize;
            assert(dctx->tmpOutBuffer != NULL);
 
            memcpy(dctx->tmpOutBuffer + preserveSize - copySize, oldDictEnd - copySize, copySize);
 
            dctx->dict = dctx->tmpOutBuffer;
            dctx->dictSize = preserveSize + dctx->tmpOutStart;
        } else {
            const BYTE* const oldDictEnd = dctx->dict + dctx->dictSize;
            size_t const newDictSize = MIN(dctx->dictSize, 64 KB);
 
            memcpy(dctx->tmpOutBuffer, oldDictEnd - newDictSize, newDictSize);
 
            dctx->dict = dctx->tmpOutBuffer;
            dctx->dictSize = newDictSize;
            dctx->tmpOut = dctx->tmpOutBuffer + newDictSize;
        }
    }
 
    *srcSizePtr = (size_t)(srcPtr - srcStart);
    *dstSizePtr = (size_t)(dstPtr - dstStart);
    return nextSrcSizeHint;
}

References ALLOC, assert, BFSize, BHSize, LZ4F_dctx_s::blockChecksum, LZ4F_frameInfo_t::blockChecksumFlag, LZ4F_frameInfo_t::blockMode, LZ4F_frameInfo_t::contentChecksumFlag, LZ4F_frameInfo_t::contentSize, DEBUGLOG, LZ4F_dctx_s::dict, LZ4F_dctx_s::dictSize, LZ4F_dctx_s::dStage, dstage_copyDirect, dstage_flushOut, dstage_getBlockChecksum, dstage_getBlockHeader, dstage_getCBlock, dstage_getFrameHeader, dstage_getSFrameSize, dstage_getSuffix, dstage_init, dstage_skipSkippable, dstage_storeBlockHeader, dstage_storeCBlock, dstage_storeFrameHeader, dstage_storeSFrameSize, dstage_storeSuffix, err0r(), LZ4F_dctx_s::frameInfo, LZ4F_dctx_s::frameRemainingSize, FREEMEM, GB, LZ4F_dctx_s::header, if(), KB, LZ4_decompress_safe_usingDict(), LZ4F_blockLinked, LZ4F_BLOCKUNCOMPRESSED_FLAG, LZ4F_decodeHeader(), LZ4F_isError(), LZ4F_readLE32(), LZ4F_resetDecompressionContext(), LZ4F_STATIC_ASSERT, LZ4F_updateDict(), LZ4F_dctx_s::maxBlockSize, LZ4F_dctx_s::maxBufferSize, maxFHSize, MEM_INIT, memcpy(), MIN, minFHSize, NULL, LZ4F_decompressOptions_t::stableDst, LZ4F_dctx_s::tmpIn, LZ4F_dctx_s::tmpInSize, LZ4F_dctx_s::tmpInTarget, LZ4F_dctx_s::tmpOut, LZ4F_dctx_s::tmpOutBuffer, LZ4F_dctx_s::tmpOutSize, LZ4F_dctx_s::tmpOutStart, LZ4F_dctx_s::xxh, XXH32(), XXH32_digest(), XXH32_reset(), and XXH32_update().

Referenced by basicTests(), decompress(), decompress_file_internal(), frameCheck(), FUZZ_decompressFrame(), local_LZ4F_decompress(), local_LZ4F_decompress_followHint(), local_LZ4F_decompress_noHint(), LZ4F_decompress_usingDict(), LZ4F_getFrameInfo(), and test_lz4f_decompression_wBuffers().

LZ4F_flush()

LZ4FLIB_API size_t LZ4F_flush	(	LZ4F_cctx *	cctxPtr,
		void *	dstBuffer,
		size_t	dstCapacity,
		const LZ4F_compressOptions_t *	compressOptionsPtr
	)

LZ4F_flush() : When data must be generated and sent immediately, without waiting for a block to be completely filled, it's possible to call LZ4_flush(). It will immediately compress any data buffered within cctx. dstCapacity must be large enough to ensure the operation will be successful. cOptPtr is optional : it's possible to provide NULL, all options will be set to default.

Returns

: nb of bytes written into dstBuffer (can be zero, when there is no data stored within cctx) or an error code if it fails (which can be tested using LZ4F_isError()) Note : LZ4F_flush() is guaranteed to be successful when dstCapacity >= LZ4F_compressBound(0, prefsPtr).

LZ4F_flush() : When compressed data must be sent immediately, without waiting for a block to be filled, invoke LZ4_flush(), which will immediately compress any remaining data stored within LZ4F_cctx. The result of the function is the number of bytes written into dstBuffer. It can be zero, this means there was no data left within LZ4F_cctx. The function outputs an error code if it fails (can be tested using LZ4F_isError()) LZ4F_compressOptions_t* is optional. NULL is a valid argument.

Definition at line 938 of file lz4frame.c.

{
    BYTE* const dstStart = (BYTE*)dstBuffer;
    BYTE* dstPtr = dstStart;
    compressFunc_t compress;
 
    if (cctxPtr->tmpInSize == 0) return 0;   /* nothing to flush */
    if (cctxPtr->cStage != 1) return err0r(LZ4F_ERROR_GENERIC);
    if (dstCapacity < (cctxPtr->tmpInSize + BHSize + BFSize))
        return err0r(LZ4F_ERROR_dstMaxSize_tooSmall);
    (void)compressOptionsPtr;   /* not yet useful */
 
    /* select compression function */
    compress = LZ4F_selectCompression(cctxPtr->prefs.frameInfo.blockMode, cctxPtr->prefs.compressionLevel);
 
    /* compress tmp buffer */
    dstPtr += LZ4F_makeBlock(dstPtr,
                             cctxPtr->tmpIn, cctxPtr->tmpInSize,
                             compress, cctxPtr->lz4CtxPtr, cctxPtr->prefs.compressionLevel,
                             cctxPtr->cdict,
                             cctxPtr->prefs.frameInfo.blockChecksumFlag);
    assert(((void)"flush overflows dstBuffer!", (size_t)(dstPtr - dstStart) <= dstCapacity));
 
    if (cctxPtr->prefs.frameInfo.blockMode == LZ4F_blockLinked)
        cctxPtr->tmpIn += cctxPtr->tmpInSize;
    cctxPtr->tmpInSize = 0;
 
    /* keep tmpIn within limits */
    if ((cctxPtr->tmpIn + cctxPtr->maxBlockSize) > (cctxPtr->tmpBuff + cctxPtr->maxBufferSize)) {  /* necessarily LZ4F_blockLinked */
        int const realDictSize = LZ4F_localSaveDict(cctxPtr);
        cctxPtr->tmpIn = cctxPtr->tmpBuff + realDictSize;
    }
 
    return (size_t)(dstPtr - dstStart);
}

References assert, BFSize, BHSize, LZ4F_frameInfo_t::blockChecksumFlag, LZ4F_frameInfo_t::blockMode, LZ4F_cctx_s::cdict, compress(), LZ4F_preferences_t::compressionLevel, LZ4F_cctx_s::cStage, err0r(), LZ4F_preferences_t::frameInfo, LZ4F_cctx_s::lz4CtxPtr, LZ4F_blockLinked, LZ4F_localSaveDict(), LZ4F_makeBlock(), LZ4F_selectCompression(), LZ4F_cctx_s::maxBlockSize, LZ4F_cctx_s::maxBufferSize, LZ4F_cctx_s::prefs, LZ4F_cctx_s::tmpBuff, LZ4F_cctx_s::tmpIn, and LZ4F_cctx_s::tmpInSize.

Referenced by fuzzerTests(), and LZ4F_compressEnd().

LZ4F_freeCompressionContext()

LZ4FLIB_API LZ4F_errorCode_t LZ4F_freeCompressionContext

(

LZ4F_cctx *

cctx

)

Definition at line 550 of file lz4frame.c.

{
    if (cctxPtr != NULL) {  /* support free on NULL */
       FREEMEM(cctxPtr->lz4CtxPtr);  /* note: LZ4_streamHC_t and LZ4_stream_t are simple POD types */
       FREEMEM(cctxPtr->tmpBuff);
       FREEMEM(cctxPtr);
    }
 
    return LZ4F_OK_NoError;
}

References FREEMEM, LZ4F_cctx_s::lz4CtxPtr, NULL, and LZ4F_cctx_s::tmpBuff.

Referenced by basicTests(), compress_file(), fuzzerTests(), LZ4F_compressFrame(), and LZ4IO_freeCResources().

LZ4F_freeDecompressionContext()

LZ4FLIB_API LZ4F_errorCode_t LZ4F_freeDecompressionContext

(

LZ4F_dctx *

dctx

)

Definition at line 1082 of file lz4frame.c.

{
    LZ4F_errorCode_t result = LZ4F_OK_NoError;
    if (dctx != NULL) {   /* can accept NULL input, like free() */
      result = (LZ4F_errorCode_t)dctx->dStage;
      FREEMEM(dctx->tmpIn);
      FREEMEM(dctx->tmpOutBuffer);
      FREEMEM(dctx);
    }
    return result;
}

References LZ4F_dctx_s::dStage, FREEMEM, NULL, LZ4F_dctx_s::tmpIn, and LZ4F_dctx_s::tmpOutBuffer.

Referenced by basicTests(), decompress_file(), freeCResources(), fullSpeedBench(), FUZZ_decompressFrame(), fuzzerTests(), LLVMFuzzerTestOneInput(), LZ4IO_freeDResources(), and LZ4IO_getCompressedFileInfo().

LZ4F_getErrorName()

LZ4FLIB_API const char* LZ4F_getErrorName

(

LZ4F_errorCode_t

code

)

return error code string; for debugging

Definition at line 254 of file lz4frame.c.

{
    static const char* codeError = "Unspecified error code";
    if (LZ4F_isError(code)) return LZ4F_errorStrings[-(int)(code)];
    return codeError;
}

References int, LZ4F_errorStrings, and LZ4F_isError().

Referenced by basicTests(), decompress_file(), decompress_file_allocDst(), decompress_file_internal(), frameCheck(), fuzzerTests(), LZ4IO_compressFilename_extRess(), LZ4IO_createCResources(), LZ4IO_createDResources(), LZ4IO_decompressLZ4F(), LZ4IO_freeCResources(), and LZ4IO_freeDResources().

LZ4F_getFrameInfo()

LZ4FLIB_API size_t LZ4F_getFrameInfo	(	LZ4F_dctx *	dctx,
		LZ4F_frameInfo_t *	frameInfoPtr,
		const void *	srcBuffer,
		size_t *	srcSizePtr
	)

LZ4F_getFrameInfo() : This function extracts frame parameters (max blockSize, dictID, etc.). Its usage is optional: user can call LZ4F_decompress() directly.

Extracted information will fill an existing LZ4F_frameInfo_t structure. This can be useful for allocation and dictionary identification purposes.

LZ4F_getFrameInfo() can work in the following situations :

1) At the beginning of a new frame, before any invocation of LZ4F_decompress(). It will decode header from srcBuffer, consuming the header and starting the decoding process.

Input size must be large enough to contain the full frame header. Frame header size can be known beforehand by LZ4F_headerSize(). Frame header size is variable, but is guaranteed to be >= LZ4F_HEADER_SIZE_MIN bytes, and not more than <= LZ4F_HEADER_SIZE_MAX bytes. Hence, blindly providing LZ4F_HEADER_SIZE_MAX bytes or more will always work. It's allowed to provide more input data than the header size, LZ4F_getFrameInfo() will only consume the header.

If input size is not large enough, aka if it's smaller than header size, function will fail and return an error code.

2) After decoding has been started, it's possible to invoke LZ4F_getFrameInfo() anytime to extract already decoded frame parameters stored within dctx.

Note that, if decoding has barely started, and not yet read enough information to decode the header, LZ4F_getFrameInfo() will fail.

The number of bytes consumed from srcBuffer will be updated in *srcSizePtr (necessarily <= original value). LZ4F_getFrameInfo() only consumes bytes when decoding has not yet started, and when decoding the header has been successful. Decompression must then resume from (srcBuffer + *srcSizePtr).

Returns

: a hint about how many srcSize bytes LZ4F_decompress() expects for next call, or an error code which can be tested using LZ4F_isError(). note 1 : in case of error, dctx is not modified. Decoding operation can resume from beginning safely. note 2 : frame parameters are copied into an already allocated LZ4F_frameInfo_t structure.

LZ4F_getFrameInfo() : This function extracts frame parameters (max blockSize, frame checksum, etc.). Usage is optional. Objective is to provide relevant information for allocation purposes. This function works in 2 situations :

• At the beginning of a new frame, in which case it will decode this information from srcBuffer, and start the decoding process. Amount of input data provided must be large enough to successfully decode the frame header. A header size is variable, but is guaranteed to be <= LZ4F_HEADER_SIZE_MAX bytes. It's possible to provide more input data than this minimum.
• After decoding has been started. In which case, no input is read, frame parameters are extracted from dctx. The number of bytes consumed from srcBuffer will be updated within *srcSizePtr (necessarily <= original value). Decompression must resume from (srcBuffer + *srcSizePtr).

  Returns

  : an hint about how many srcSize bytes LZ4F_decompress() expects for next call, or an error code which can be tested using LZ4F_isError() note 1 : in case of error, dctx is not modified. Decoding operations can resume from where they stopped. note 2 : frame parameters are copied into an already allocated LZ4F_frameInfo_t structure.

Definition at line 1253 of file lz4frame.c.

{
    LZ4F_STATIC_ASSERT(dstage_getFrameHeader < dstage_storeFrameHeader);
    if (dctx->dStage > dstage_storeFrameHeader) {
        /* frameInfo already decoded */
        size_t o=0, i=0;
        *srcSizePtr = 0;
        *frameInfoPtr = dctx->frameInfo;
        /* returns : recommended nb of bytes for LZ4F_decompress() */
        return LZ4F_decompress(dctx, NULL, &o, NULL, &i, NULL);
    } else {
        if (dctx->dStage == dstage_storeFrameHeader) {
            /* frame decoding already started, in the middle of header => automatic fail */
            *srcSizePtr = 0;
            return err0r(LZ4F_ERROR_frameDecoding_alreadyStarted);
        } else {
            size_t const hSize = LZ4F_headerSize(srcBuffer, *srcSizePtr);
            if (LZ4F_isError(hSize)) { *srcSizePtr=0; return hSize; }
            if (*srcSizePtr < hSize) {
                *srcSizePtr=0;
                return err0r(LZ4F_ERROR_frameHeader_incomplete);
            }
 
            {   size_t decodeResult = LZ4F_decodeHeader(dctx, srcBuffer, hSize);
                if (LZ4F_isError(decodeResult)) {
                    *srcSizePtr = 0;
                } else {
                    *srcSizePtr = decodeResult;
                    decodeResult = BHSize;   /* block header size */
                }
                *frameInfoPtr = dctx->frameInfo;
                return decodeResult;
    }   }   }
}

References BHSize, LZ4F_dctx_s::dStage, dstage_getFrameHeader, dstage_storeFrameHeader, err0r(), LZ4F_dctx_s::frameInfo, i, LZ4F_decodeHeader(), LZ4F_decompress(), LZ4F_headerSize(), LZ4F_isError(), LZ4F_STATIC_ASSERT, and NULL.

Referenced by basicTests(), decompress_file_allocDst(), frameCheck(), and LZ4IO_getCompressedFileInfo().

LZ4F_getVersion()

LZ4FLIB_API unsigned LZ4F_getVersion

(

void

)

Definition at line 274 of file lz4frame.c.

{ return LZ4F_VERSION; }

References LZ4F_VERSION.

LZ4F_headerSize()

LZ4FLIB_API size_t LZ4F_headerSize	(	const void *	src,
		size_t	srcSize
	)

LZ4F_headerSize() : v1.9.0+ Provide the header size of a frame starting at src. srcSize must be >= LZ4F_MIN_SIZE_TO_KNOW_HEADER_LENGTH, which is enough to decode the header length.

Returns

: size of frame header or an error code, which can be tested using LZ4F_isError() note : Frame header size is variable, but is guaranteed to be >= LZ4F_HEADER_SIZE_MIN bytes, and <= LZ4F_HEADER_SIZE_MAX bytes.

LZ4F_headerSize() :

Returns

: size of frame header or an error code, which can be tested using LZ4F_isError()

Definition at line 1212 of file lz4frame.c.

{
    if (src == NULL) return err0r(LZ4F_ERROR_srcPtr_wrong);
 
    /* minimal srcSize to determine header size */
    if (srcSize < LZ4F_MIN_SIZE_TO_KNOW_HEADER_LENGTH)
        return err0r(LZ4F_ERROR_frameHeader_incomplete);
 
    /* special case : skippable frames */
    if ((LZ4F_readLE32(src) & 0xFFFFFFF0U) == LZ4F_MAGIC_SKIPPABLE_START)
        return 8;
 
    /* control magic number */
#ifndef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION
    if (LZ4F_readLE32(src) != LZ4F_MAGICNUMBER)
        return err0r(LZ4F_ERROR_frameType_unknown);
#endif
 
    /* Frame Header Size */
    {   BYTE const FLG = ((const BYTE*)src)[4];
        U32 const contentSizeFlag = (FLG>>3) & _1BIT;
        U32 const dictIDFlag = FLG & _1BIT;
        return minFHSize + (contentSizeFlag?8:0) + (dictIDFlag?4:0);
    }
}

References _1BIT, err0r(), FLG, LZ4F_MAGIC_SKIPPABLE_START, LZ4F_MAGICNUMBER, LZ4F_MIN_SIZE_TO_KNOW_HEADER_LENGTH, LZ4F_readLE32(), minFHSize, NULL, src, and srcSize.

Referenced by basicTests(), LZ4F_getFrameInfo(), and LZ4IO_getCompressedFileInfo().

LZ4F_isError()

LZ4FLIB_API unsigned LZ4F_isError

(

LZ4F_errorCode_t

code

)

tells when a function result is an error code

Definition at line 249 of file lz4frame.c.

{
    return (code > (LZ4F_errorCode_t)(-LZ4F_ERROR_maxCode));
}

Referenced by basicTests(), compress_file(), compress_file_internal(), createCResources(), decompress_file(), decompress_file_allocDst(), decompress_file_internal(), frameCheck(), fullSpeedBench(), FUZZ_decompressFrame(), fuzzerTests(), LLVMFuzzerTestOneInput(), local_LZ4F_decompress_followHint(), local_LZ4F_decompress_noHint(), LZ4F_compressEnd(), LZ4F_compressFrame(), LZ4F_compressFrame_usingCDict(), LZ4F_decompress(), LZ4F_getErrorCode(), LZ4F_getErrorName(), LZ4F_getFrameInfo(), LZ4IO_compressFilename_extRess(), LZ4IO_createCResources(), LZ4IO_createDResources(), LZ4IO_decompressLZ4F(), LZ4IO_freeCResources(), LZ4IO_freeDResources(), LZ4IO_getCompressedFileInfo(), and test_lz4f_decompression_wBuffers().

LZ4F_resetDecompressionContext()

LZ4FLIB_API void LZ4F_resetDecompressionContext

(

LZ4F_dctx *

dctx

)

LZ4F_resetDecompressionContext() : added in v1.8.0 In case of an error, the context is left in "undefined" state. In which case, it's necessary to reset it, before re-using it. This method can also be used to abruptly stop any unfinished decompression, and start a new one using same context resources.

Definition at line 1097 of file lz4frame.c.

{
    dctx->dStage = dstage_getFrameHeader;
    dctx->dict = NULL;
    dctx->dictSize = 0;
}

References LZ4F_dctx_s::dict, LZ4F_dctx_s::dictSize, LZ4F_dctx_s::dStage, dstage_getFrameHeader, and NULL.

Referenced by basicTests(), decompress(), fuzzerTests(), and LZ4F_decompress().