suricata
util-byte.h File Reference
#include <stdint.h>
#include <byteswap.h>
Include dependency graph for util-byte.h:

Go to the source code of this file.

Macros

#define BYTE_BIG_ENDIAN   0
 
#define BYTE_LITTLE_ENDIAN   1
 
#define SCByteSwap16(x)   bswap_16(x)
 
#define SCByteSwap32(x)   bswap_32(x)
 
#define SCByteSwap64(x)   bswap_64(x)
 

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 WARN_UNUSED ByteExtractUint64 (uint64_t *res, int e, uint16_t len, const uint8_t *bytes)
 
int WARN_UNUSED ByteExtractUint32 (uint32_t *res, int e, uint16_t len, const uint8_t *bytes)
 
int WARN_UNUSED ByteExtractUint16 (uint16_t *res, int e, uint16_t len, const uint8_t *bytes)
 
int WARN_UNUSED ByteExtractString (uint64_t *res, int base, size_t len, const char *str, bool strict)
 
int WARN_UNUSED ByteExtractStringUint64 (uint64_t *res, int base, size_t len, const char *str)
 
int WARN_UNUSED ByteExtractStringUint32 (uint32_t *res, int base, size_t len, const char *str)
 
int WARN_UNUSED ByteExtractStringUint16 (uint16_t *res, int base, size_t len, const char *str)
 
int WARN_UNUSED ByteExtractStringUint8 (uint8_t *res, int base, size_t len, const char *str)
 
int WARN_UNUSED ByteExtractStringSigned (int64_t *res, int base, size_t len, const char *str, bool strict)
 
int WARN_UNUSED ByteExtractStringInt64 (int64_t *res, int base, size_t len, const char *str)
 
int WARN_UNUSED ByteExtractStringInt32 (int32_t *res, int base, size_t len, const char *str)
 
int WARN_UNUSED ByteExtractStringInt16 (int16_t *res, int base, size_t len, const char *str)
 
int WARN_UNUSED ByteExtractStringInt8 (int8_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 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 WARN_UNUSED StringParseU64RangeCheck (uint64_t *res, int base, size_t len, const char *str, uint64_t min, uint64_t max)
 
int WARN_UNUSED StringParseU32RangeCheck (uint32_t *res, int base, size_t len, const char *str, uint32_t min, uint32_t max)
 
int WARN_UNUSED StringParseU16RangeCheck (uint16_t *res, int base, size_t len, const char *str, uint16_t min, uint16_t max)
 
int WARN_UNUSED StringParseU8RangeCheck (uint8_t *res, int base, size_t len, const char *str, uint8_t min, uint8_t max)
 
int WARN_UNUSED StringParseI64RangeCheck (int64_t *res, int base, size_t len, const char *str, int64_t min, int64_t max)
 
int WARN_UNUSED StringParseI32RangeCheck (int32_t *res, int base, size_t len, const char *str, int32_t min, int32_t max)
 
int WARN_UNUSED StringParseI16RangeCheck (int16_t *res, int base, size_t len, const char *str, int16_t min, int16_t max)
 
int WARN_UNUSED 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

Definition in file util-byte.h.

Macro Definition Documentation

◆ BYTE_BIG_ENDIAN

#define BYTE_BIG_ENDIAN   0

Definition at line 30 of file util-byte.h.

◆ BYTE_LITTLE_ENDIAN

#define BYTE_LITTLE_ENDIAN   1

Definition at line 31 of file util-byte.h.

◆ SCByteSwap16

#define SCByteSwap16 (   x)    bswap_16(x)

Wrappers for OS dependent byte swapping functions

Definition at line 70 of file util-byte.h.

◆ SCByteSwap32

#define SCByteSwap32 (   x)    bswap_32(x)

Definition at line 71 of file util-byte.h.

◆ SCByteSwap64

#define SCByteSwap64 (   x)    bswap_64(x)

Definition at line 72 of file util-byte.h.

Function Documentation

◆ ByteExtractString()

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

Extract unsigned integer value from a string.

Parameters
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString to extract from
boolEnable 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 WARN_UNUSED ByteExtractStringInt16 ( int16_t *  res,
int  base,
size_t  len,
const char *  str 
)

Extract signed integer value from a string as uint16_t.

Parameters
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED ByteExtractStringInt32 ( int32_t *  res,
int  base,
size_t  len,
const char *  str 
)

Extract signed integer value from a string as uint32_t.

Parameters
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED ByteExtractStringInt64 ( int64_t *  res,
int  base,
size_t  len,
const char *  str 
)

Extract signed integer value from a string as uint64_t.

Parameters
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED ByteExtractStringInt8 ( int8_t *  res,
int  base,
size_t  len,
const char *  str 
)

Extract signed integer value from a string as uint8_t.

Parameters
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED ByteExtractStringSigned ( int64_t *  res,
int  base,
size_t  len,
const char *  str,
bool  strict 
)

Extract signed integer value from a string.

Parameters
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString to extract from
boolEnable 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 WARN_UNUSED ByteExtractStringUint16 ( uint16_t *  res,
int  base,
size_t  len,
const char *  str 
)

Extract unsigned integer value from a string as uint16_t.

Parameters
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED ByteExtractStringUint32 ( uint32_t *  res,
int  base,
size_t  len,
const char *  str 
)

Extract unsigned integer value from a string as uint32_t.

Parameters
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED ByteExtractStringUint64 ( uint64_t *  res,
int  base,
size_t  len,
const char *  str 
)

Extract unsigned integer value from a string as uint64_t.

Parameters
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED ByteExtractStringUint8 ( uint8_t *  res,
int  base,
size_t  len,
const char *  str 
)

Extract unsigned integer value from a string as uint8_t.

Parameters
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED 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
resStores result
eEndianness (BYTE_BIG_ENDIAN or BYTE_LITTLE_ENDIAN)
lenNumber of bytes to extract (8 max)
bytesData 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 WARN_UNUSED 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
resStores result
eEndianness (BYTE_BIG_ENDIAN or BYTE_LITTLE_ENDIAN)
lenNumber of bytes to extract (8 max)
bytesData 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 WARN_UNUSED 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
resStores result
eEndianness (BYTE_BIG_ENDIAN or BYTE_LITTLE_ENDIAN)
lenNumber of bytes to extract (8 max)
bytesData 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
bytesbyte array
nbytesnumber 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
bytesbyte array
nbytesnumber of bytes
outstr[out]buffer to fill
outlensize 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 WARN_UNUSED 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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 WARN_UNUSED 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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
resStores result
baseBase of the number to extract
lenNumber of bytes to extract (23 max or 0 for unbounded)
strString 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: