diff options
Diffstat (limited to 'src/detect-tcp-flags.c')
-rw-r--r-- | src/detect-tcp-flags.c | 1420 |
1 files changed, 1420 insertions, 0 deletions
diff --git a/src/detect-tcp-flags.c b/src/detect-tcp-flags.c new file mode 100644 index 0000000..183ae96 --- /dev/null +++ b/src/detect-tcp-flags.c @@ -0,0 +1,1420 @@ +/* Copyright (C) 2007-2020 Open Information Security Foundation + * + * You can copy, redistribute or modify this Program under the terms of + * the GNU General Public License version 2 as published by the Free + * Software Foundation. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * version 2 along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301, USA. + */ + +/** + * \file + * + * \author Breno Silva <breno.silva@gmail.com> + * + * Implements the flags keyword + */ + +#include "suricata-common.h" +#include "suricata.h" +#include "decode.h" + +#include "detect.h" +#include "detect-parse.h" +#include "detect-engine-prefilter.h" +#include "detect-engine-prefilter-common.h" + +#include "flow-var.h" +#include "decode-events.h" + +#include "detect-tcp-flags.h" +#include "util-unittest.h" + +#include "util-debug.h" + +/** + * Regex (by Brian Rectanus) + * flags: [!+*](SAPRFU120)[,SAPRFU12] + */ +#define PARSE_REGEX "^\\s*(?:([\\+\\*!]))?\\s*([SAPRFU120CE\\+\\*!]+)(?:\\s*,\\s*([SAPRFU12CE]+))?\\s*$" + +/** + * Flags args[0] *(3) +(2) !(1) + * + */ + +#define MODIFIER_NOT 1 +#define MODIFIER_PLUS 2 +#define MODIFIER_ANY 3 + +static DetectParseRegex parse_regex; + +static int DetectFlagsMatch (DetectEngineThreadCtx *, Packet *, + const Signature *, const SigMatchCtx *); +static int DetectFlagsSetup (DetectEngineCtx *, Signature *, const char *); +static void DetectFlagsFree(DetectEngineCtx *, void *); + +static bool PrefilterTcpFlagsIsPrefilterable(const Signature *s); +static int PrefilterSetupTcpFlags(DetectEngineCtx *de_ctx, SigGroupHead *sgh); +#ifdef UNITTESTS +static void FlagsRegisterTests(void); +#endif + +/** + * \brief Registration function for flags: keyword + */ + +void DetectFlagsRegister (void) +{ + sigmatch_table[DETECT_FLAGS].name = "tcp.flags"; + sigmatch_table[DETECT_FLAGS].alias = "flags"; + sigmatch_table[DETECT_FLAGS].desc = "detect which flags are set in the TCP header"; + sigmatch_table[DETECT_FLAGS].url = "/rules/header-keywords.html#tcp-flags"; + sigmatch_table[DETECT_FLAGS].Match = DetectFlagsMatch; + sigmatch_table[DETECT_FLAGS].Setup = DetectFlagsSetup; + sigmatch_table[DETECT_FLAGS].Free = DetectFlagsFree; +#ifdef UNITTESTS + sigmatch_table[DETECT_FLAGS].RegisterTests = FlagsRegisterTests; +#endif + sigmatch_table[DETECT_FLAGS].SupportsPrefilter = PrefilterTcpFlagsIsPrefilterable; + sigmatch_table[DETECT_FLAGS].SetupPrefilter = PrefilterSetupTcpFlags; + + DetectSetupParseRegexes(PARSE_REGEX, &parse_regex); +} + +static inline int FlagsMatch(const uint8_t pflags, const uint8_t modifier, + const uint8_t dflags, const uint8_t iflags) +{ + if (!dflags && pflags) { + if(modifier == MODIFIER_NOT) { + SCReturnInt(1); + } + + SCReturnInt(0); + } + + const uint8_t flags = pflags & iflags; + + switch (modifier) { + case MODIFIER_ANY: + if ((flags & dflags) > 0) { + SCReturnInt(1); + } + SCReturnInt(0); + + case MODIFIER_PLUS: + if (((flags & dflags) == dflags)) { + SCReturnInt(1); + } + SCReturnInt(0); + + case MODIFIER_NOT: + if ((flags & dflags) != dflags) { + SCReturnInt(1); + } + SCReturnInt(0); + + default: + SCLogDebug("flags %"PRIu8" and de->flags %"PRIu8"", flags, dflags); + if (flags == dflags) { + SCReturnInt(1); + } + } + + SCReturnInt(0); +} + +/** + * \internal + * \brief This function is used to match flags on a packet with those passed via flags: + * + * \param t pointer to thread vars + * \param det_ctx pointer to the pattern matcher thread + * \param p pointer to the current packet + * \param s pointer to the Signature + * \param m pointer to the sigmatch + * + * \retval 0 no match + * \retval 1 match + */ +static int DetectFlagsMatch (DetectEngineThreadCtx *det_ctx, Packet *p, + const Signature *s, const SigMatchCtx *ctx) +{ + SCEnter(); + + if (!(PKT_IS_TCP(p)) || PKT_IS_PSEUDOPKT(p)) { + SCReturnInt(0); + } + + const DetectFlagsData *de = (const DetectFlagsData *)ctx; + const uint8_t flags = p->tcph->th_flags; + + return FlagsMatch(flags, de->modifier, de->flags, de->ignored_flags); +} + +/** + * \internal + * \brief This function is used to parse flags options passed via flags: keyword + * + * \param rawstr Pointer to the user provided flags options + * + * \retval de pointer to DetectFlagsData on success + * \retval NULL on failure + */ +static DetectFlagsData *DetectFlagsParse (const char *rawstr) +{ + SCEnter(); + + int found = 0, ignore = 0; + char *ptr; + DetectFlagsData *de = NULL; + + char arg1[16] = ""; + char arg2[16] = ""; + char arg3[16] = ""; + + pcre2_match_data *match = NULL; + int ret = DetectParsePcreExec(&parse_regex, &match, rawstr, 0, 0); + SCLogDebug("input '%s', pcre said %d", rawstr, ret); + if (ret < 3) { + SCLogError("pcre match failed"); + goto error; + } + + size_t pcre2len = sizeof(arg1); + int res = SC_Pcre2SubstringCopy(match, 1, (PCRE2_UCHAR8 *)arg1, &pcre2len); + if (res < 0) { + SCLogError("pcre2_substring_copy_bynumber failed"); + goto error; + } + if (ret >= 2) { + pcre2len = sizeof(arg2); + res = pcre2_substring_copy_bynumber(match, 2, (PCRE2_UCHAR8 *)arg2, &pcre2len); + if (res < 0) { + SCLogError("pcre2_substring_copy_bynumber failed"); + goto error; + } + } + if (ret >= 3) { + pcre2len = sizeof(arg3); + res = SC_Pcre2SubstringCopy(match, 3, (PCRE2_UCHAR8 *)arg3, &pcre2len); + if (res < 0) { + SCLogError("pcre2_substring_copy_bynumber failed"); + goto error; + } + } + SCLogDebug("args '%s', '%s', '%s'", arg1, arg2, arg3); + + if (strlen(arg2) == 0) { + SCLogDebug("empty argument"); + goto error; + } + + de = SCMalloc(sizeof(DetectFlagsData)); + if (unlikely(de == NULL)) + goto error; + memset(de, 0, sizeof(DetectFlagsData)); + de->ignored_flags = 0xff; + + /** First parse args1 */ + ptr = arg1; + while (*ptr != '\0') { + switch (*ptr) { + case 'S': + case 's': + de->flags |= TH_SYN; + found++; + break; + case 'A': + case 'a': + de->flags |= TH_ACK; + found++; + break; + case 'F': + case 'f': + de->flags |= TH_FIN; + found++; + break; + case 'R': + case 'r': + de->flags |= TH_RST; + found++; + break; + case 'P': + case 'p': + de->flags |= TH_PUSH; + found++; + break; + case 'U': + case 'u': + de->flags |= TH_URG; + found++; + break; + case '1': + de->flags |= TH_CWR; + found++; + break; + case '2': + de->flags |= TH_ECN; + found++; + break; + case 'C': + case 'c': + de->flags |= TH_CWR; + found++; + break; + case 'E': + case 'e': + de->flags |= TH_ECN; + found++; + break; + case '0': + de->flags = 0; + found++; + break; + + case '!': + de->modifier = MODIFIER_NOT; + break; + case '+': + de->modifier = MODIFIER_PLUS; + break; + case '*': + de->modifier = MODIFIER_ANY; + break; + } + ptr++; + } + + /** Second parse first set of flags */ + if (strlen(arg2) > 0) { + ptr = arg2; + while (*ptr != '\0') { + switch (*ptr) { + case 'S': + case 's': + de->flags |= TH_SYN; + found++; + break; + case 'A': + case 'a': + de->flags |= TH_ACK; + found++; + break; + case 'F': + case 'f': + de->flags |= TH_FIN; + found++; + break; + case 'R': + case 'r': + de->flags |= TH_RST; + found++; + break; + case 'P': + case 'p': + de->flags |= TH_PUSH; + found++; + break; + case 'U': + case 'u': + de->flags |= TH_URG; + found++; + break; + case '1': + case 'C': + case 'c': + de->flags |= TH_CWR; + found++; + break; + case '2': + case 'E': + case 'e': + de->flags |= TH_ECN; + found++; + break; + case '0': + de->flags = 0; + found++; + break; + + case '!': + if (de->modifier != 0) { + SCLogError("\"flags\" supports only" + " one modifier at a time"); + goto error; + } + de->modifier = MODIFIER_NOT; + SCLogDebug("NOT modifier is set"); + break; + case '+': + if (de->modifier != 0) { + SCLogError("\"flags\" supports only" + " one modifier at a time"); + goto error; + } + de->modifier = MODIFIER_PLUS; + SCLogDebug("PLUS modifier is set"); + break; + case '*': + if (de->modifier != 0) { + SCLogError("\"flags\" supports only" + " one modifier at a time"); + goto error; + } + de->modifier = MODIFIER_ANY; + SCLogDebug("ANY modifier is set"); + break; + default: + break; + } + ptr++; + } + + if (found == 0) + goto error; + } + + /** Finally parse ignored flags */ + if (strlen(arg3) > 0) { + ptr = arg3; + + while (*ptr != '\0') { + switch (*ptr) { + case 'S': + case 's': + de->ignored_flags &= ~TH_SYN; + ignore++; + break; + case 'A': + case 'a': + de->ignored_flags &= ~TH_ACK; + ignore++; + break; + case 'F': + case 'f': + de->ignored_flags &= ~TH_FIN; + ignore++; + break; + case 'R': + case 'r': + de->ignored_flags &= ~TH_RST; + ignore++; + break; + case 'P': + case 'p': + de->ignored_flags &= ~TH_PUSH; + ignore++; + break; + case 'U': + case 'u': + de->ignored_flags &= ~TH_URG; + ignore++; + break; + case '1': + de->ignored_flags &= ~TH_CWR; + ignore++; + break; + case '2': + de->ignored_flags &= ~TH_ECN; + ignore++; + break; + case 'C': + case 'c': + de->ignored_flags &= ~TH_CWR; + ignore++; + break; + case 'E': + case 'e': + de->ignored_flags &= ~TH_ECN; + ignore++; + break; + case '0': + break; + default: + break; + } + ptr++; + } + + if (ignore == 0) { + SCLogDebug("ignore == 0"); + goto error; + } + } + + pcre2_match_data_free(match); + SCLogDebug("found %"PRId32" ignore %"PRId32"", found, ignore); + SCReturnPtr(de, "DetectFlagsData"); + +error: + if (de) { + SCFree(de); + } + if (match) { + pcre2_match_data_free(match); + } + SCReturnPtr(NULL, "DetectFlagsData"); +} + +/** + * \internal + * \brief this function is used to add the parsed flags into the current signature + * + * \param de_ctx pointer to the Detection Engine Context + * \param s pointer to the Current Signature + * \param m pointer to the Current SigMatch + * \param rawstr pointer to the user provided flags options + * + * \retval 0 on Success + * \retval -1 on Failure + */ +static int DetectFlagsSetup (DetectEngineCtx *de_ctx, Signature *s, const char *rawstr) +{ + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + + de = DetectFlagsParse(rawstr); + if (de == NULL) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + SigMatchAppendSMToList(s, sm, DETECT_SM_LIST_MATCH); + s->flags |= SIG_FLAG_REQUIRE_PACKET; + + return 0; + +error: + if (de) SCFree(de); + if (sm) SCFree(sm); + return -1; +} + +/** + * \internal + * \brief this function will free memory associated with DetectFlagsData + * + * \param de pointer to DetectFlagsData + */ +static void DetectFlagsFree(DetectEngineCtx *de_ctx, void *de_ptr) +{ + DetectFlagsData *de = (DetectFlagsData *)de_ptr; + if(de) SCFree(de); +} + +int DetectFlagsSignatureNeedsSynPackets(const Signature *s) +{ + const SigMatch *sm; + for (sm = s->init_data->smlists[DETECT_SM_LIST_MATCH] ; sm != NULL; sm = sm->next) { + switch (sm->type) { + case DETECT_FLAGS: + { + const DetectFlagsData *fl = (const DetectFlagsData *)sm->ctx; + + if (!(fl->modifier == MODIFIER_NOT) && (fl->flags & TH_SYN)) { + return 1; + } + break; + } + } + } + return 0; +} + +int DetectFlagsSignatureNeedsSynOnlyPackets(const Signature *s) +{ + const SigMatch *sm; + for (sm = s->init_data->smlists[DETECT_SM_LIST_MATCH] ; sm != NULL; sm = sm->next) { + switch (sm->type) { + case DETECT_FLAGS: + { + const DetectFlagsData *fl = (const DetectFlagsData *)sm->ctx; + + if (!(fl->modifier == MODIFIER_NOT) && (fl->flags == TH_SYN)) { + return 1; + } + break; + } + } + } + return 0; +} + +static void +PrefilterPacketFlagsMatch(DetectEngineThreadCtx *det_ctx, Packet *p, const void *pectx) +{ + if (!(PKT_IS_TCP(p)) || PKT_IS_PSEUDOPKT(p)) { + SCReturn; + } + + const PrefilterPacketHeaderCtx *ctx = pectx; + if (!PrefilterPacketHeaderExtraMatch(ctx, p)) + return; + + const uint8_t flags = p->tcph->th_flags; + if (FlagsMatch(flags, ctx->v1.u8[0], ctx->v1.u8[1], ctx->v1.u8[2])) + { + SCLogDebug("packet matches TCP flags %02x", ctx->v1.u8[1]); + PrefilterAddSids(&det_ctx->pmq, ctx->sigs_array, ctx->sigs_cnt); + } +} + +static void +PrefilterPacketFlagsSet(PrefilterPacketHeaderValue *v, void *smctx) +{ + const DetectFlagsData *a = smctx; + v->u8[0] = a->modifier; + v->u8[1] = a->flags; + v->u8[2] = a->ignored_flags; + SCLogDebug("v->u8[0] = %02x", v->u8[0]); +} + +static bool +PrefilterPacketFlagsCompare(PrefilterPacketHeaderValue v, void *smctx) +{ + const DetectFlagsData *a = smctx; + if (v.u8[0] == a->modifier && + v.u8[1] == a->flags && + v.u8[2] == a->ignored_flags) + return true; + return false; +} + +static int PrefilterSetupTcpFlags(DetectEngineCtx *de_ctx, SigGroupHead *sgh) +{ + return PrefilterSetupPacketHeader(de_ctx, sgh, DETECT_FLAGS, + PrefilterPacketFlagsSet, + PrefilterPacketFlagsCompare, + PrefilterPacketFlagsMatch); + +} + +static bool PrefilterTcpFlagsIsPrefilterable(const Signature *s) +{ + const SigMatch *sm; + for (sm = s->init_data->smlists[DETECT_SM_LIST_MATCH] ; sm != NULL; sm = sm->next) { + switch (sm->type) { + case DETECT_FLAGS: + return true; + } + } + return false; +} + +/* + * ONLY TESTS BELOW THIS COMMENT + */ + +#ifdef UNITTESTS +/** + * \test FlagsTestParse01 is a test for a valid flags value + * + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse01 (void) +{ + DetectFlagsData *de = DetectFlagsParse("S"); + FAIL_IF_NULL(de); + FAIL_IF_NOT(de->flags == TH_SYN); + DetectFlagsFree(NULL, de); + PASS; +} + +/** + * \test FlagsTestParse02 is a test for an invalid flags value + * + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse02 (void) +{ + DetectFlagsData *de = NULL; + de = DetectFlagsParse("G"); + if (de) { + DetectFlagsFree(NULL, de); + return 0; + } + + return 1; +} + +/** + * \test FlagsTestParse03 test if ACK and PUSH are set. Must return success + * + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse03 (void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_ACK|TH_PUSH|TH_SYN|TH_RST; + + de = DetectFlagsParse("AP+"); + + if (de == NULL || (de->flags != (TH_ACK|TH_PUSH)) ) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if(ret) { + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 1; + } + +error: + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 0; +} + +/** + * \test FlagsTestParse04 check if ACK bit is set. Must fails. + * + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse04 (void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_SYN; + + de = DetectFlagsParse("A"); + + if (de == NULL || de->flags != TH_ACK) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if(ret) { + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 0; + } + + /* Error expected. */ +error: + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 1; +} + +/** + * \test FlagsTestParse05 test if ACK+PUSH and more flags are set. Ignore SYN and RST bits. + * Must fails. + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse05 (void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_ACK|TH_PUSH|TH_SYN|TH_RST; + + de = DetectFlagsParse("+AP,SR"); + + if (de == NULL || (de->modifier != MODIFIER_PLUS) || (de->flags != (TH_ACK|TH_PUSH)) || (de->ignored_flags != (TH_SYN|TH_RST))) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if(ret) { + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 0; + } + + /* Error expected. */ +error: + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 1; +} + +/** + * \test FlagsTestParse06 test if ACK+PUSH and more flags are set. Ignore URG and RST bits. + * Must return success. + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse06 (void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_ACK|TH_PUSH|TH_SYN|TH_RST; + + de = DetectFlagsParse("+AP,UR"); + + if (de == NULL || (de->modifier != MODIFIER_PLUS) || (de->flags != (TH_ACK|TH_PUSH)) || ((0xff - de->ignored_flags) != (TH_URG|TH_RST))) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if(ret) { + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 1; + } + +error: + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 0; +} + +/** + * \test FlagsTestParse07 test if SYN or RST are set. Must fails. + * + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse07 (void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_SYN|TH_RST; + + de = DetectFlagsParse("*AP"); + + if (de == NULL || (de->modifier != MODIFIER_ANY) || (de->flags != (TH_ACK|TH_PUSH))) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if(ret) { + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 0; + } + + /* Error expected. */ +error: + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 1; +} + +/** + * \test FlagsTestParse08 test if SYN or RST are set. Must return success. + * + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse08 (void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_SYN|TH_RST; + + de = DetectFlagsParse("*SA"); + + if (de == NULL || (de->modifier != MODIFIER_ANY) || (de->flags != (TH_ACK|TH_SYN))) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if(ret) { + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 1; + } + +error: + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 0; +} + +/** + * \test FlagsTestParse09 test if SYN and RST are not set. Must fails. + * + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse09 (void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_SYN|TH_RST; + + de = DetectFlagsParse("!PA"); + + if (de == NULL || (de->modifier != MODIFIER_NOT) || (de->flags != (TH_ACK|TH_PUSH))) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if(ret) { + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 1; + } + +error: + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 0; +} + +/** + * \test FlagsTestParse10 test if ACK and PUSH are not set. Must return success. + * + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse10 (void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_SYN|TH_RST; + + de = DetectFlagsParse("!AP"); + + if (de == NULL || (de->modifier != MODIFIER_NOT) || (de->flags != (TH_ACK|TH_PUSH))) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if(ret) { + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 1; + } + +error: + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 0; +} + +/** + * \test FlagsTestParse11 test if ACK or PUSH are set. Ignore SYN and RST. Must fails. + * + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse11 (void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_SYN|TH_RST|TH_URG; + + de = DetectFlagsParse("*AP,SR"); + + if (de == NULL || (de->modifier != MODIFIER_ANY) || (de->flags != (TH_ACK|TH_PUSH)) || ((0xff - de->ignored_flags) != (TH_SYN|TH_RST))) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if(ret) { + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 0; + } + + /* Expected. */ +error: + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 1; +} + +/** + * \test FlagsTestParse12 check if no flags are set. Must fails. + * + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse12 (void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_SYN; + + de = DetectFlagsParse("0"); + + if (de == NULL || de->flags != 0) { + printf("de setup: "); + goto error; + } + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if(ret) { + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 0; + } + + /* Expected. */ +error: + if (de) SCFree(de); + if (sm) SCFree(sm); + SCFree(p); + return 1; +} + +/** + * \test test for a valid flags value + * + * \retval 1 on success + * \retval 0 on failure + */ +static int FlagsTestParse13 (void) +{ + DetectFlagsData *de = NULL; + de = DetectFlagsParse("+S*"); + if (de != NULL) { + DetectFlagsFree(NULL, de); + return 0; + } + + return 1; +} + +/** + * \test Parse 'C' and 'E' flags. + * + * \retval 1 on success. + * \retval 0 on failure. + */ +static int FlagsTestParse14(void) +{ + DetectFlagsData *de = DetectFlagsParse("CE"); + if (de != NULL && (de->flags == (TH_CWR | TH_ECN)) ) { + DetectFlagsFree(NULL, de); + return 1; + } + + return 0; +} + +static int FlagsTestParse15(void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_ECN | TH_CWR | TH_SYN | TH_RST; + + de = DetectFlagsParse("EC+"); + + if (de == NULL || (de->flags != (TH_ECN | TH_CWR)) ) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if (ret) { + if (de) + SCFree(de); + if (sm) + SCFree(sm); + SCFree(p); + return 1; + } + +error: + if (de) + SCFree(de); + if (sm) + SCFree(sm); + SCFree(p); + return 0; +} + +static int FlagsTestParse16(void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_ECN | TH_SYN | TH_RST; + + de = DetectFlagsParse("EC*"); + + if (de == NULL || (de->flags != (TH_ECN | TH_CWR)) ) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if (ret) { + if (de) + SCFree(de); + if (sm) + SCFree(sm); + SCFree(p); + return 1; + } + +error: + if (de) + SCFree(de); + if (sm) + SCFree(sm); + SCFree(p); + return 0; +} + +/** + * \test Negative test. + */ +static int FlagsTestParse17(void) +{ + Packet *p = PacketGetFromAlloc(); + if (unlikely(p == NULL)) + return 0; + ThreadVars tv; + int ret = 0; + DetectFlagsData *de = NULL; + SigMatch *sm = NULL; + IPV4Hdr ipv4h; + TCPHdr tcph; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&ipv4h, 0, sizeof(IPV4Hdr)); + memset(&tcph, 0, sizeof(TCPHdr)); + + p->ip4h = &ipv4h; + p->tcph = &tcph; + p->tcph->th_flags = TH_ECN | TH_SYN | TH_RST; + + de = DetectFlagsParse("EC+"); + + if (de == NULL || (de->flags != (TH_ECN | TH_CWR)) ) + goto error; + + sm = SigMatchAlloc(); + if (sm == NULL) + goto error; + + sm->type = DETECT_FLAGS; + sm->ctx = (SigMatchCtx *)de; + + ret = DetectFlagsMatch(NULL, p, NULL, sm->ctx); + + if (ret == 0) { + if (de) + SCFree(de); + if (sm) + SCFree(sm); + SCFree(p); + return 1; + } + +error: + if (de) + SCFree(de); + if (sm) + SCFree(sm); + SCFree(p); + return 0; +} + +/** + * \brief this function registers unit tests for Flags + */ +static void FlagsRegisterTests(void) +{ + UtRegisterTest("FlagsTestParse01", FlagsTestParse01); + UtRegisterTest("FlagsTestParse02", FlagsTestParse02); + UtRegisterTest("FlagsTestParse03", FlagsTestParse03); + UtRegisterTest("FlagsTestParse04", FlagsTestParse04); + UtRegisterTest("FlagsTestParse05", FlagsTestParse05); + UtRegisterTest("FlagsTestParse06", FlagsTestParse06); + UtRegisterTest("FlagsTestParse07", FlagsTestParse07); + UtRegisterTest("FlagsTestParse08", FlagsTestParse08); + UtRegisterTest("FlagsTestParse09", FlagsTestParse09); + UtRegisterTest("FlagsTestParse10", FlagsTestParse10); + UtRegisterTest("FlagsTestParse11", FlagsTestParse11); + UtRegisterTest("FlagsTestParse12", FlagsTestParse12); + UtRegisterTest("FlagsTestParse13", FlagsTestParse13); + UtRegisterTest("FlagsTestParse14", FlagsTestParse14); + UtRegisterTest("FlagsTestParse15", FlagsTestParse15); + UtRegisterTest("FlagsTestParse16", FlagsTestParse16); + UtRegisterTest("FlagsTestParse17", FlagsTestParse17); +} +#endif /* UNITTESTS */ |