Streaming Buffer API. More...

#include "suricata-common.h"
#include "util-streaming-buffer.h"
#include "util-unittest.h"
#include "util-print.h"
#include "util-validate.h"
#include "util-debug.h"
#include "util-error.h"
#include "app-layer-htp-mem.h"
#include "conf-yaml-loader.h"
#include "app-layer-htp.h"

Include dependency graph for util-streaming-buffer.c:

Go to the source code of this file.

Macros
#define	DUMP_REGIONS 0

#define	CALLOC(cfg, n, s) (cfg)->Calloc ? (cfg)->Calloc((n), (s)) : CallocFunc((n), (s))

#define	REALLOC(cfg, ptr, orig_s, s) (cfg)->Realloc ? (cfg)->Realloc((ptr), (orig_s), (s)) : ReallocFunc((ptr), (s))

#define	FREE(cfg, ptr, s) (cfg)->Free ? (cfg)->Free((ptr), (s)) : SCFree((ptr))

Functions
	RB_GENERATE (SBB, StreamingBufferBlock, rb, SBBCompare)

int	SBBCompare (struct StreamingBufferBlock a, struct StreamingBufferBlock b)

StreamingBufferBlock *	SBB_RB_FIND_INCLUSIVE (struct SBB head, StreamingBufferBlock elm)

StreamingBuffer *	StreamingBufferInit (const StreamingBufferConfig *cfg)

void	StreamingBufferClear (StreamingBuffer sb, const StreamingBufferConfig cfg)

void	StreamingBufferFree (StreamingBuffer sb, const StreamingBufferConfig cfg)

void	StreamingBufferSlideToOffset (StreamingBuffer sb, const StreamingBufferConfig cfg, uint64_t offset)
	slide to absolute offset

int	StreamingBufferAppend (StreamingBuffer sb, const StreamingBufferConfig cfg, StreamingBufferSegment seg, const uint8_t data, uint32_t data_len)

int	StreamingBufferAppendNoTrack (StreamingBuffer sb, const StreamingBufferConfig cfg, const uint8_t *data, uint32_t data_len)
	add data w/o tracking a segment

int	StreamingBufferInsertAt (StreamingBuffer sb, const StreamingBufferConfig cfg, StreamingBufferSegment seg, const uint8_t data, uint32_t data_len, uint64_t offset)

int	StreamingBufferSegmentIsBeforeWindow (const StreamingBuffer sb, const StreamingBufferSegment seg)

void	StreamingBufferSBBGetData (const StreamingBuffer sb, const StreamingBufferBlock sbb, const uint8_t *data, uint32_t data_len)
	get the data for one SBB

void	StreamingBufferSBBGetDataAtOffset (const StreamingBuffer sb, const StreamingBufferBlock sbb, const uint8_t *data, uint32_t data_len, uint64_t offset)
	get the data for one SBB

void	StreamingBufferSegmentGetData (const StreamingBuffer sb, const StreamingBufferSegment seg, const uint8_t *data, uint32_t data_len)

int	StreamingBufferSegmentCompareRawData (const StreamingBuffer sb, const StreamingBufferSegment seg, const uint8_t *rawdata, uint32_t rawdata_len)

int	StreamingBufferGetData (const StreamingBuffer sb, const uint8_t data, uint32_t data_len, uint64_t *stream_offset)

int	StreamingBufferGetDataAtOffset (const StreamingBuffer sb, const uint8_t data, uint32_t data_len, uint64_t offset)

int	StreamingBufferCompareRawData (const StreamingBuffer sb, const uint8_t rawdata, uint32_t rawdata_len)

void	StreamingBufferRegisterTests (void)

Detailed Description

Streaming Buffer API.

Author: Victor Julien victo.nosp@m.r@in.nosp@m.linia.nosp@m.c.ne.nosp@m.t

Definition in file util-streaming-buffer.c.

Macro Definition Documentation

◆ CALLOC

#define CALLOC	(	cfg,
		n,
		s
	)	(cfg)->Calloc ? (cfg)->Calloc((n), (s)) : CallocFunc((n), (s))

Definition at line 63 of file util-streaming-buffer.c.

◆ DUMP_REGIONS

#define DUMP_REGIONS 0

Definition at line 32 of file util-streaming-buffer.c.

◆ FREE

#define FREE	(	cfg,
		ptr,
		s
	)	(cfg)->Free ? (cfg)->Free((ptr), (s)) : SCFree((ptr))

Definition at line 66 of file util-streaming-buffer.c.

◆ REALLOC

#define REALLOC	(	cfg,
		ptr,
		orig_s,
		s
	)	(cfg)->Realloc ? (cfg)->Realloc((ptr), (orig_s), (s)) : ReallocFunc((ptr), (s))

Definition at line 64 of file util-streaming-buffer.c.

Function Documentation

◆ RB_GENERATE()

RB_GENERATE	(	SBB	,
		StreamingBufferBlock	,
		rb	,
		SBBCompare
	)

◆ SBB_RB_FIND_INCLUSIVE()

StreamingBufferBlock * SBB_RB_FIND_INCLUSIVE	(	struct SBB *	head,
		StreamingBufferBlock *	elm
	)

Definition at line 104 of file util-streaming-buffer.c.

References head, StreamingBufferBlock::len, StreamingBufferBlock::offset, RB_LEFT, RB_RIGHT, RB_ROOT, and SCLogDebug.

◆ SBBCompare()

int SBBCompare	(	struct StreamingBufferBlock *	a,
		struct StreamingBufferBlock *	b
	)

Definition at line 73 of file util-streaming-buffer.c.

References StreamingBufferBlock::len, StreamingBufferBlock::offset, SCLogDebug, and SCReturnInt.

◆ StreamingBufferAppend()

int StreamingBufferAppend	(	StreamingBuffer *	sb,
		const StreamingBufferConfig *	cfg,
		StreamingBufferSegment *	seg,
		const uint8_t *	data,
		uint32_t	data_len
	)

Definition at line 1100 of file util-streaming-buffer.c.

References BIT_U32, StreamingBufferRegion_::buf, StreamingBufferRegion_::buf_offset, StreamingBufferRegion_::buf_size, DEBUG_VALIDATE_BUG_ON, RB_EMPTY, StreamingBuffer_::region, StreamingBuffer_::sbb_tree, SC_OK, and StreamingBufferRegion_::stream_offset.

Referenced by HtpBodyAppendChunk(), and UTHAddStreamToFlow().

Here is the caller graph for this function:

◆ StreamingBufferAppendNoTrack()

int StreamingBufferAppendNoTrack	(	StreamingBuffer *	sb,
		const StreamingBufferConfig *	cfg,
		const uint8_t *	data,
		uint32_t	data_len
	)

add data w/o tracking a segment

Definition at line 1144 of file util-streaming-buffer.c.

References BIT_U32, StreamingBufferRegion_::buf, StreamingBufferRegion_::buf_offset, StreamingBufferRegion_::buf_size, DEBUG_VALIDATE_BUG_ON, RB_EMPTY, StreamingBuffer_::region, StreamingBuffer_::sbb_tree, and SC_OK.

◆ StreamingBufferClear()

void StreamingBufferClear	(	StreamingBuffer *	sb,
		const StreamingBufferConfig *	cfg
	)

Definition at line 271 of file util-streaming-buffer.c.

References StreamingBufferRegion_::buf, StreamingBufferRegion_::buf_size, FREE, StreamingBuffer_::max_regions, next, StreamingBufferRegion_::next, StreamingBuffer_::region, StreamingBuffer_::regions, and SCLogDebug.

Referenced by StreamingBufferFree(), StreamTcpPruneSession(), and StreamTcpStreamCleanup().

Here is the caller graph for this function:

◆ StreamingBufferCompareRawData()

int StreamingBufferCompareRawData	(	const StreamingBuffer *	sb,
		const uint8_t *	rawdata,
		uint32_t	rawdata_len
	)

Return values

1	data is the same
0	data is different

Definition at line 1853 of file util-streaming-buffer.c.

References offset, PrintRawDataFp(), SCLogDebug, and StreamingBufferGetData().

Here is the call graph for this function:

◆ StreamingBufferFree()

void StreamingBufferFree	(	StreamingBuffer *	sb,
		const StreamingBufferConfig *	cfg
	)

Definition at line 294 of file util-streaming-buffer.c.

References FREE, and StreamingBufferClear().

Referenced by HtpBodyFree().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ StreamingBufferGetData()

int StreamingBufferGetData	(	const StreamingBuffer *	sb,
		const uint8_t **	data,
		uint32_t *	data_len,
		uint64_t *	stream_offset
	)

Definition at line 1813 of file util-streaming-buffer.c.

References StreamingBufferRegion_::buf, StreamingBufferRegion_::buf_offset, StreamingBuffer_::region, stream_offset, and StreamingBufferRegion_::stream_offset.

Referenced by StreamingBufferCompareRawData().

Here is the caller graph for this function:

◆ StreamingBufferGetDataAtOffset()

int StreamingBufferGetDataAtOffset	(	const StreamingBuffer *	sb,
		const uint8_t **	data,
		uint32_t *	data_len,
		uint64_t	offset
	)

Definition at line 1830 of file util-streaming-buffer.c.

References StreamingBufferRegion_::buf, StreamingBufferRegion_::buf_offset, DEBUG_VALIDATE_BUG_ON, offset, and StreamingBufferRegion_::stream_offset.

Referenced by OutputFiledataLogFfc().

Here is the caller graph for this function:

◆ StreamingBufferInit()

StreamingBuffer * StreamingBufferInit ( const StreamingBufferConfig * cfg )

Definition at line 248 of file util-streaming-buffer.c.

References StreamingBufferConfig_::buf_size, StreamingBufferRegion_::buf_size, CALLOC, FREE, StreamingBuffer_::max_regions, StreamingBuffer_::region, StreamingBuffer_::regions, sc_errno, and SC_OK.

Referenced by HtpBodyAppendChunk().

Here is the caller graph for this function:

◆ StreamingBufferInsertAt()

int StreamingBufferInsertAt	(	StreamingBuffer *	sb,
		const StreamingBufferConfig *	cfg,
		StreamingBufferSegment *	seg,
		const uint8_t *	data,
		uint32_t	data_len,
		uint64_t	offset
	)

Parameters

offset offset relative to StreamingBuffer::stream_offset

Returns: SC_OK in case of success; SC_E* errors otherwise

Definition at line 1532 of file util-streaming-buffer.c.

References BIT_U32, StreamingBufferRegion_::buf, StreamingBufferRegion_::buf_offset, StreamingBufferRegion_::buf_size, DEBUG_VALIDATE_BUG_ON, StreamingBuffer_::head, MAX, offset, RB_EMPTY, StreamingBuffer_::region, StreamingBuffer_::sbb_tree, SC_EINVAL, SC_ELIMIT, sc_errno, SC_OK, SCLogDebug, and StreamingBufferRegion_::stream_offset.

◆ StreamingBufferRegisterTests()

void StreamingBufferRegisterTests ( void )

Definition at line 2440 of file util-streaming-buffer.c.

References UtRegisterTest().

Here is the call graph for this function:

◆ StreamingBufferSBBGetData()

void StreamingBufferSBBGetData	(	const StreamingBuffer *	sb,
		const StreamingBufferBlock *	sbb,
		const uint8_t **	data,
		uint32_t *	data_len
	)

get the data for one SBB

Definition at line 1684 of file util-streaming-buffer.c.

References StreamingBufferRegion_::buf, StreamingBufferRegion_::buf_offset, StreamingBufferRegion_::buf_size, DEBUG_VALIDATE_BUG_ON, len, StreamingBufferBlock::len, offset, StreamingBufferBlock::offset, SCLogDebug, and StreamingBufferRegion_::stream_offset.

Referenced by UTHCheckDataAtPosition().

Here is the caller graph for this function:

◆ StreamingBufferSBBGetDataAtOffset()

void StreamingBufferSBBGetDataAtOffset	(	const StreamingBuffer *	sb,
		const StreamingBufferBlock *	sbb,
		const uint8_t **	data,
		uint32_t *	data_len,
		uint64_t	offset
	)

get the data for one SBB

Definition at line 1720 of file util-streaming-buffer.c.

References StreamingBufferRegion_::buf, StreamingBufferRegion_::buf_size, DEBUG_VALIDATE_BUG_ON, StreamingBufferBlock::len, offset, StreamingBufferBlock::offset, and StreamingBufferRegion_::stream_offset.

◆ StreamingBufferSegmentCompareRawData()

int StreamingBufferSegmentCompareRawData	(	const StreamingBuffer *	sb,
		const StreamingBufferSegment *	seg,
		const uint8_t *	rawdata,
		uint32_t	rawdata_len
	)