util-byte.c File Reference

#include "suricata-common.h"
#include "util-byte.h"
#include "util-unittest.h"
#include "util-debug.h"
#include "util-validate.h"

Include dependency graph for util-byte.c:

Go to the source code of this file.

Functions
char *	BytesToString (const uint8_t *bytes, size_t nbytes)
	Turn byte array into string. More...
void	BytesToStringBuffer (const uint8_t *bytes, size_t nbytes, char *outstr, size_t outlen)
	Turn byte array into string. More...
int	ByteExtractUint64 (uint64_t *res, int e, uint16_t len, const uint8_t *bytes)
int	ByteExtractUint32 (uint32_t *res, int e, uint16_t len, const uint8_t *bytes)
int	ByteExtractUint16 (uint16_t *res, int e, uint16_t len, const uint8_t *bytes)
int	ByteExtractString (uint64_t *res, int base, size_t len, const char *str, bool strict)
int	ByteExtractStringUint64 (uint64_t *res, int base, size_t len, const char *str)
int	ByteExtractStringUint32 (uint32_t *res, int base, size_t len, const char *str)
int	ByteExtractStringUint16 (uint16_t *res, int base, size_t len, const char *str)
int	ByteExtractStringUint8 (uint8_t *res, int base, size_t len, const char *str)
int	StringParseUint64 (uint64_t *res, int base, size_t len, const char *str)
int	StringParseUint32 (uint32_t *res, int base, size_t len, const char *str)
int	StringParseUint16 (uint16_t *res, int base, size_t len, const char *str)
int	StringParseUint8 (uint8_t *res, int base, size_t len, const char *str)
int	StringParseU64RangeCheck (uint64_t *res, int base, size_t len, const char *str, uint64_t min, uint64_t max)
int	StringParseU32RangeCheck (uint32_t *res, int base, size_t len, const char *str, uint32_t min, uint32_t max)
int	StringParseU16RangeCheck (uint16_t *res, int base, size_t len, const char *str, uint16_t min, uint16_t max)
int	StringParseU8RangeCheck (uint8_t *res, int base, size_t len, const char *str, uint8_t min, uint8_t max)
int	ByteExtractStringSigned (int64_t *res, int base, size_t len, const char *str, bool strict)
int	ByteExtractStringInt64 (int64_t *res, int base, size_t len, const char *str)
int	ByteExtractStringInt32 (int32_t *res, int base, size_t len, const char *str)
int	ByteExtractStringInt16 (int16_t *res, int base, size_t len, const char *str)
int	ByteExtractStringInt8 (int8_t *res, int base, size_t len, const char *str)
int	StringParseInt64 (int64_t *res, int base, size_t len, const char *str)
int	StringParseInt32 (int32_t *res, int base, size_t len, const char *str)
int	StringParseInt16 (int16_t *res, int base, size_t len, const char *str)
int	StringParseInt8 (int8_t *res, int base, size_t len, const char *str)
int	StringParseI64RangeCheck (int64_t *res, int base, size_t len, const char *str, int64_t min, int64_t max)
int	StringParseI32RangeCheck (int32_t *res, int base, size_t len, const char *str, int32_t min, int32_t max)
int	StringParseI16RangeCheck (int16_t *res, int base, size_t len, const char *str, int16_t min, int16_t max)
int	StringParseI8RangeCheck (int8_t *res, int base, size_t len, const char *str, int8_t min, int8_t max)
void	ByteRegisterTests (void)

Detailed Description

Author

Brian Rectanus brect.nosp@m.anu@.nosp@m.gmail.nosp@m..com

Byte utility functions

Definition in file util-byte.c.

Function Documentation

ByteExtractString()

int ByteExtractString	(	uint64_t *	res,
		int	base,
		size_t	len,
		const char *	str,
		bool	strict
	)

Extract unsigned integer value from a string.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from
bool	Enable strict check for parsers

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 185 of file util-byte.c.

ByteExtractStringInt16()

int ByteExtractStringInt16	(	int16_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract signed integer value from a string as uint16_t.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 567 of file util-byte.c.

ByteExtractStringInt32()

int ByteExtractStringInt32	(	int32_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract signed integer value from a string as uint32_t.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 542 of file util-byte.c.

ByteExtractStringInt64()

int ByteExtractStringInt64	(	int64_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract signed integer value from a string as uint64_t.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 537 of file util-byte.c.

ByteExtractStringInt8()

int ByteExtractStringInt8	(	int8_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract signed integer value from a string as uint8_t.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 592 of file util-byte.c.

ByteExtractStringSigned()

int ByteExtractStringSigned	(	int64_t *	res,
		int	base,
		size_t	len,
		const char *	str,
		bool	strict
	)

Extract signed integer value from a string.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from
bool	Enable strict check for parsers

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 491 of file util-byte.c.

ByteExtractStringUint16()

int ByteExtractStringUint16	(	uint16_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract unsigned integer value from a string as uint16_t.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 262 of file util-byte.c.

Referenced by LLVMFuzzerInitialize().

Here is the caller graph for this function:

ByteExtractStringUint32()

int ByteExtractStringUint32	(	uint32_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract unsigned integer value from a string as uint32_t.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 239 of file util-byte.c.

Referenced by SCGetGroupID(), and SCGetUserID().

Here is the caller graph for this function:

ByteExtractStringUint64()

int ByteExtractStringUint64	(	uint64_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract unsigned integer value from a string as uint64_t.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 234 of file util-byte.c.

Referenced by DetectByteExtractDoMatch().

Here is the caller graph for this function:

ByteExtractStringUint8()

int ByteExtractStringUint8	(	uint8_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract unsigned integer value from a string as uint8_t.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 285 of file util-byte.c.

Referenced by DetectProtoParse().

Here is the caller graph for this function:

ByteExtractUint16()

int ByteExtractUint16	(	uint16_t *	res,
		int	e,
		uint16_t	len,
		const uint8_t *	bytes
	)

Extract bytes from a byte string and convert to a unint16_t.

Parameters

res	Stores result
e	Endianness (BYTE_BIG_ENDIAN or BYTE_LITTLE_ENDIAN)
len	Number of bytes to extract (8 max)
bytes	Data to extract from

Returns

n Number of bytes extracted on success

-1 On error

Todo:

Need standard return values

Definition at line 164 of file util-byte.c.

References len.

ByteExtractUint32()

int ByteExtractUint32	(	uint32_t *	res,
		int	e,
		uint16_t	len,
		const uint8_t *	bytes
	)

Extract bytes from a byte string and convert to a uint32_t.

Parameters

res	Stores result
e	Endianness (BYTE_BIG_ENDIAN or BYTE_LITTLE_ENDIAN)
len	Number of bytes to extract (8 max)
bytes	Data to extract from

Returns

n Number of bytes extracted on success

-1 On error

Todo:

Need standard return values

Definition at line 143 of file util-byte.c.

References len.

ByteExtractUint64()

int ByteExtractUint64	(	uint64_t *	res,
		int	e,
		uint16_t	len,
		const uint8_t *	bytes
	)

Extract bytes from a byte string and convert to a unint64_t.

Parameters

res	Stores result
e	Endianness (BYTE_BIG_ENDIAN or BYTE_LITTLE_ENDIAN)
len	Number of bytes to extract (8 max)
bytes	Data to extract from

Returns

n Number of bytes extracted on success

-1 On error

Todo:

Need standard return values

Definition at line 122 of file util-byte.c.

References len.

Referenced by DetectByteExtractDoMatch().

Here is the caller graph for this function:

ByteRegisterTests()

void ByteRegisterTests

(

void

)

Definition at line 1034 of file util-byte.c.

References UtRegisterTest().

Here is the call graph for this function:

BytesToString()

char* BytesToString	(	const uint8_t *	bytes,
		size_t	nbytes
	)

Turn byte array into string.

All non-printables are copied over, except for '\0', which is turned into literal \0 in the string.

Parameters

bytes	byte array
nbytes	number of bytes

Returns

string nul-terminated string or NULL on error

Definition at line 41 of file util-byte.c.

References dst, and SCCalloc.

BytesToStringBuffer()

void BytesToStringBuffer	(	const uint8_t *	bytes,
		size_t	nbytes,
		char *	outstr,
		size_t	outlen
	)

Turn byte array into string.

All non-printables are copied over, except for '\0', which is turned into literal \0 in the string.

Parameters

bytes	byte array
nbytes	number of bytes
outstr[out]	buffer to fill
outlen	size of outstr. Must be at least 2 * nbytes + 1 in size

Definition at line 85 of file util-byte.c.

References DEBUG_VALIDATE_BUG_ON, dst, and strlcpy().

Here is the call graph for this function:

StringParseI16RangeCheck()

int StringParseI16RangeCheck	(	int16_t *	res,
		int	base,
		size_t	len,
		const char *	str,
		int16_t	min,
		int16_t	max
	)

Extract signed integer value from a string as int16_t strictly within the range.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 746 of file util-byte.c.

StringParseI32RangeCheck()

int StringParseI32RangeCheck	(	int32_t *	res,
		int	base,
		size_t	len,
		const char *	str,
		int32_t	min,
		int32_t	max
	)

Extract signed integer value from a string as int32_t strictly within the range.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 716 of file util-byte.c.

StringParseI64RangeCheck()

int StringParseI64RangeCheck	(	int64_t *	res,
		int	base,
		size_t	len,
		const char *	str,
		int64_t	min,
		int64_t	max
	)

Extract signed integer value from a string as int64_t strictly within the range.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 697 of file util-byte.c.

StringParseI8RangeCheck()

int StringParseI8RangeCheck	(	int8_t *	res,
		int	base,
		size_t	len,
		const char *	str,
		int8_t	min,
		int8_t	max
	)

Extract signed integer value from a string as int8_t strictly within the range.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 776 of file util-byte.c.

StringParseInt16()

int StringParseInt16	(	int16_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract signed integer value from a string as int16_t strictly.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 647 of file util-byte.c.

StringParseInt32()

int StringParseInt32	(	int32_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract signed integer value from a string as int32_t strictly.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 622 of file util-byte.c.

Referenced by SCKernelVersionIsAtLeast().

Here is the caller graph for this function:

StringParseInt64()

int StringParseInt64	(	int64_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract signed integer value from a string as int64_t strictly.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 617 of file util-byte.c.

Referenced by UtilCpuGetNumProcessorsConfigured().

Here is the caller graph for this function:

StringParseInt8()

int StringParseInt8	(	int8_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract signed integer value from a string as int8_t strictly.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 672 of file util-byte.c.

StringParseU16RangeCheck()

int StringParseU16RangeCheck	(	uint16_t *	res,
		int	base,
		size_t	len,
		const char *	str,
		uint16_t	min,
		uint16_t	max
	)

Extract unsigned integer value from a string as uint16_t strictly within the range.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 433 of file util-byte.c.

StringParseU32RangeCheck()

int StringParseU32RangeCheck	(	uint32_t *	res,
		int	base,
		size_t	len,
		const char *	str,
		uint32_t	min,
		uint32_t	max
	)

Extract unsigned integer value from a string as uint32_t strictly within the range.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 404 of file util-byte.c.

StringParseU64RangeCheck()

int StringParseU64RangeCheck	(	uint64_t *	res,
		int	base,
		size_t	len,
		const char *	str,
		uint64_t	min,
		uint64_t	max
	)

Extract unsigned integer value from a string as uint64_t strictly within the range.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 385 of file util-byte.c.

StringParseU8RangeCheck()

int StringParseU8RangeCheck	(	uint8_t *	res,
		int	base,
		size_t	len,
		const char *	str,
		uint8_t	min,
		uint8_t	max
	)

Extract unsigned integer value from a string as uint8_t strictly within the range.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 462 of file util-byte.c.

Referenced by SCRadixAddKeyIPV4String(), and SCRadixAddKeyIPV6String().

Here is the caller graph for this function:

StringParseUint16()

int StringParseUint16	(	uint16_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract unsigned integer value from a string as uint16_t strictly.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 337 of file util-byte.c.

Referenced by IPFWRegisterQueue(), and PostConfLoadedSetup().

Here is the caller graph for this function:

StringParseUint32()

int StringParseUint32	(	uint32_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract unsigned integer value from a string as uint32_t strictly.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 313 of file util-byte.c.

Referenced by FlowInitConfig(), FlowInitFlowProto(), HttpRangeContainersInit(), and SCConfLogOpenGeneric().

Here is the caller graph for this function:

StringParseUint64()

int StringParseUint64	(	uint64_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract unsigned integer value from a string as uint64_t strictly.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 308 of file util-byte.c.

StringParseUint8()

int StringParseUint8	(	uint8_t *	res,
		int	base,
		size_t	len,
		const char *	str
	)

Extract unsigned integer value from a string as uint8_t strictly.

Parameters

res	Stores result
base	Base of the number to extract
len	Number of bytes to extract (23 max or 0 for unbounded)
str	String to extract from

Returns

n Number of bytes extracted on success

-1 On error

Definition at line 361 of file util-byte.c.

Referenced by IPv4AddressStringIsValid().

Here is the caller graph for this function: