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)
int	HexToRaw (const uint8_t *in, size_t ins, uint8_t *out, size_t outs)
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 188 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 579 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 554 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 549 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 604 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 503 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 265 of file util-byte.c.

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 242 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 237 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 288 of file util-byte.c.

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 167 of file util-byte.c.

References len.

ByteExtractUint32()

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

Return values

Greater

than 0 if successful, 0 or negative on failure.

Todo:

Need standard return values

Definition at line 146 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 1076 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:

HexToRaw()

int HexToRaw	(	const uint8_t *	in,
		size_t	ins,
		uint8_t *	out,
		size_t	outs
	)

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

References SCLogError.

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 758 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 728 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 709 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 788 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 659 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 634 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 629 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 684 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 442 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 413 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 394 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
	)

Return values

Greater

than 0 if successful, 0 or negative on failure.

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

Referenced by SCRadix4AddKeyIPV4String(), and SCRadix6AddKeyIPV6String().

Here is the caller graph for this function:

StringParseUint16()

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

Return values

Greater

than 0 if successful, 0 or negative on failure.

Definition at line 343 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 316 of file util-byte.c.

Referenced by BuildCpusetWithCallback(), 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 311 of file util-byte.c.

StringParseUint8()

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

Return values

Greater

than 0 if successful, 0 or negative on failure.

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

Referenced by IPv4AddressStringIsValid().

Here is the caller graph for this function: