suricata
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
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 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
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 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
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 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
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 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
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 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
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 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
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 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
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 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
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 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
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 288 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
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 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
Greaterthan 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
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 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
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:

◆ 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
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 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
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 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
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 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
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 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
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 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
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 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
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 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
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 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
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 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
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 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
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 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
Greaterthan 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
Greaterthan 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
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 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
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 311 of file util-byte.c.

◆ StringParseUint8()

int StringParseUint8 ( uint8_t *  res,
int  base,
size_t  len,
const char *  str 
)
Return values
Greaterthan 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: