suricata
detect-engine-analyzer.c
Go to the documentation of this file.
1 /* Copyright (C) 2007-2023 Open Information Security Foundation
2  *
3  * You can copy, redistribute or modify this Program under the terms of
4  * the GNU General Public License version 2 as published by the Free
5  * Software Foundation.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * version 2 along with this program; if not, write to the Free Software
14  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
15  * 02110-1301, USA.
16  */
17 
18 /**
19  * \file
20  *
21  * \author Eileen Donlon <emdonlo@gmail.com>
22  * \author Victor Julien <victor@inliniac.net>
23  *
24  * Rule analyzers for the detection engine
25  */
26 
27 #include "suricata-common.h"
28 #include "suricata.h"
29 #include "rust.h"
30 #include "action-globals.h"
31 #include "detect.h"
32 #include "detect-parse.h"
33 #include "detect-engine.h"
34 #include "detect-engine-analyzer.h"
35 #include "detect-engine-mpm.h"
36 #include "detect-engine-uint.h"
37 #include "conf.h"
38 #include "detect-content.h"
39 #include "detect-pcre.h"
40 #include "detect-bytejump.h"
41 #include "detect-bytetest.h"
42 #include "detect-flow.h"
43 #include "detect-tcp-flags.h"
44 #include "detect-tcp-ack.h"
45 #include "detect-ipopts.h"
46 #include "detect-tcp-seq.h"
47 #include "feature.h"
48 #include "util-print.h"
49 #include "util-time.h"
50 #include "util-validate.h"
51 #include "util-conf.h"
52 #include "detect-flowbits.h"
53 #include "util-var-name.h"
54 #include "detect-icmp-id.h"
55 #include "detect-tcp-window.h"
56 
57 static int rule_warnings_only = 0;
58 
59 /* Details for each buffer being tracked */
60 typedef struct DetectEngineAnalyzerItems {
61  int16_t item_id;
62  bool item_seen;
65  const char *item_name;
66  const char *display_name;
68 
69 typedef struct FpPatternStats_ {
70  uint16_t min;
71  uint16_t max;
72  uint32_t cnt;
73  uint64_t tot;
75 
76 /* Track which items require the item_seen value to be exposed */
78  const char *bufname;
80 };
81 
82 typedef struct EngineAnalysisCtx_ {
83 
86 
88  char *file_prefix;
89  pcre2_code *percent_re;
90 
91  /*
92  * This array contains the map between the `analyzer_items` array listed above and
93  * the item ids returned by DetectBufferTypeGetByName. Iterating signature's sigmatch
94  * array provides list_ids. The map converts those ids into elements of the
95  * analyzer items array.
96  *
97  * Ultimately, the g_buffer_type_hash is searched for each buffer name. The size of that
98  * hashlist is 256, so that's the value we use here.
99  */
100  int16_t analyzer_item_map[256];
102  /*
103  * Certain values must be directly accessible. This array contains items that are directly
104  * accessed when checking if they've been seen or not.
105  */
107 
110 
112  /* request keywords */
113  { 0, false, false, true, "http_uri", "http uri" },
114  { 0, false, false, false, "http_raw_uri", "http raw uri" },
115  { 0, false, true, false, "http_method", "http method" },
116  { 0, false, false, false, "http_request_line", "http request line" },
117  { 0, false, false, false, "http_client_body", "http client body" },
118  { 0, false, false, true, "http_header", "http header" },
119  { 0, false, false, false, "http_raw_header", "http raw header" },
120  { 0, false, false, true, "http_cookie", "http cookie" },
121  { 0, false, false, false, "http_user_agent", "http user agent" },
122  { 0, false, false, false, "http_host", "http host" },
123  { 0, false, false, false, "http_raw_host", "http raw host" },
124  { 0, false, false, false, "http_accept_enc", "http accept enc" },
125  { 0, false, false, false, "http_referer", "http referer" },
126  { 0, false, false, false, "http_content_type", "http content type" },
127  { 0, false, false, false, "http_header_names", "http header names" },
128 
129  /* response keywords not listed above */
130  { 0, false, false, false, "http_stat_msg", "http stat msg" },
131  { 0, false, false, false, "http_stat_code", "http stat code" },
132  { 0, false, true, false, "file_data", "http server body" },
133 
134  /* missing request keywords */
135  { 0, false, false, false, "http_request_line", "http request line" },
136  { 0, false, false, false, "http_accept", "http accept" },
137  { 0, false, false, false, "http_accept_lang", "http accept lang" },
138  { 0, false, false, false, "http_connection", "http connection" },
139  { 0, false, false, false, "http_content_len", "http content len" },
140  { 0, false, false, false, "http_protocol", "http protocol" },
141  { 0, false, false, false, "http_start", "http start" },
142 
143  /* missing response keywords; some of the missing are listed above*/
144  { 0, false, false, false, "http_response_line", "http response line" },
145  { 0, false, false, false, "http.server", "http server" },
146  { 0, false, false, false, "http.location", "http location" },
147 };
148 
149 static void FpPatternStatsAdd(FpPatternStats *fp, int list, uint16_t patlen)
150 {
151  if (list < 0 || list >= DETECT_SM_LIST_MAX)
152  return;
153 
154  FpPatternStats *f = &fp[list];
155 
156  if (f->min == 0)
157  f->min = patlen;
158  else if (patlen < f->min)
159  f->min = patlen;
160 
161  if (patlen > f->max)
162  f->max = patlen;
163 
164  f->cnt++;
165  f->tot += patlen;
166 }
167 
168 void EngineAnalysisFP(const DetectEngineCtx *de_ctx, const Signature *s, char *line)
169 {
170  int fast_pattern_set = 0;
171  int fast_pattern_only_set = 0;
172  int fast_pattern_chop_set = 0;
173  const DetectContentData *fp_cd = NULL;
174  const SigMatch *mpm_sm = s->init_data->mpm_sm;
175  const int mpm_sm_list = s->init_data->mpm_sm_list;
176 
177  if (mpm_sm != NULL) {
178  fp_cd = (DetectContentData *)mpm_sm->ctx;
179  if (fp_cd->flags & DETECT_CONTENT_FAST_PATTERN) {
180  fast_pattern_set = 1;
182  fast_pattern_only_set = 1;
183  } else if (fp_cd->flags & DETECT_CONTENT_FAST_PATTERN_CHOP) {
184  fast_pattern_chop_set = 1;
185  }
186  }
187  }
188 
189  FILE *fp = de_ctx->ea->rule_engine_analysis_fp;
190  fprintf(fp, "== Sid: %u ==\n", s->id);
191  fprintf(fp, "%s\n", line);
192 
193  fprintf(fp, " Fast Pattern analysis:\n");
194  if (s->init_data->prefilter_sm != NULL) {
195  fprintf(fp, " Prefilter on: %s\n",
197  fprintf(fp, "\n");
198  return;
199  }
200 
201  if (fp_cd == NULL) {
202  fprintf(fp, " No content present\n");
203  fprintf(fp, "\n");
204  return;
205  }
206 
207  fprintf(fp, " Fast pattern matcher: ");
208  int list_type = mpm_sm_list;
209  if (list_type == DETECT_SM_LIST_PMATCH)
210  fprintf(fp, "content\n");
211  else {
212  const char *desc = DetectEngineBufferTypeGetDescriptionById(de_ctx, list_type);
213  const char *name = DetectEngineBufferTypeGetNameById(de_ctx, list_type);
214  if (desc && name) {
215  fprintf(fp, "%s (%s)\n", desc, name);
216  }
217  }
218 
219  int flags_set = 0;
220  fprintf(fp, " Flags:");
221  if (fp_cd->flags & DETECT_CONTENT_OFFSET) {
222  fprintf(fp, " Offset");
223  flags_set = 1;
224  } if (fp_cd->flags & DETECT_CONTENT_DEPTH) {
225  fprintf(fp, " Depth");
226  flags_set = 1;
227  }
228  if (fp_cd->flags & DETECT_CONTENT_WITHIN) {
229  fprintf(fp, " Within");
230  flags_set = 1;
231  }
232  if (fp_cd->flags & DETECT_CONTENT_DISTANCE) {
233  fprintf(fp, " Distance");
234  flags_set = 1;
235  }
236  if (fp_cd->flags & DETECT_CONTENT_NOCASE) {
237  fprintf(fp, " Nocase");
238  flags_set = 1;
239  }
240  if (fp_cd->flags & DETECT_CONTENT_NEGATED) {
241  fprintf(fp, " Negated");
242  flags_set = 1;
243  }
244  if (flags_set == 0)
245  fprintf(fp, " None");
246  fprintf(fp, "\n");
247 
248  fprintf(fp, " Fast pattern set: %s\n", fast_pattern_set ? "yes" : "no");
249  fprintf(fp, " Fast pattern only set: %s\n", fast_pattern_only_set ? "yes" : "no");
250  fprintf(fp, " Fast pattern chop set: %s\n", fast_pattern_chop_set ? "yes" : "no");
251  if (fast_pattern_chop_set) {
252  fprintf(fp, " Fast pattern offset, length: %u, %u\n", fp_cd->fp_chop_offset,
253  fp_cd->fp_chop_len);
254  }
255 
256  uint16_t patlen = fp_cd->content_len;
257  uint8_t *pat = SCMalloc(fp_cd->content_len + 1);
258  if (unlikely(pat == NULL)) {
259  FatalError("Error allocating memory");
260  }
261  memcpy(pat, fp_cd->content, fp_cd->content_len);
262  pat[fp_cd->content_len] = '\0';
263  fprintf(fp, " Original content: ");
264  PrintRawUriFp(fp, pat, patlen);
265  fprintf(fp, "\n");
266 
267  if (fast_pattern_chop_set) {
268  SCFree(pat);
269  patlen = fp_cd->fp_chop_len;
270  pat = SCMalloc(fp_cd->fp_chop_len + 1);
271  if (unlikely(pat == NULL)) {
272  exit(EXIT_FAILURE);
273  }
274  memcpy(pat, fp_cd->content + fp_cd->fp_chop_offset, fp_cd->fp_chop_len);
275  pat[fp_cd->fp_chop_len] = '\0';
276  fprintf(fp, " Final content: ");
277  PrintRawUriFp(fp, pat, patlen);
278  fprintf(fp, "\n");
279 
280  FpPatternStatsAdd(&de_ctx->ea->fp_pattern_stats[0], list_type, patlen);
281  } else {
282  fprintf(fp, " Final content: ");
283  PrintRawUriFp(fp, pat, patlen);
284  fprintf(fp, "\n");
285 
286  FpPatternStatsAdd(&de_ctx->ea->fp_pattern_stats[0], list_type, patlen);
287  }
288  SCFree(pat);
289 
290  fprintf(fp, "\n");
291 }
292 
293 /**
294  * \brief Sets up the fast pattern analyzer according to the config.
295  *
296  * \retval 1 If rule analyzer successfully enabled.
297  * \retval 0 If not enabled.
298  */
299 static int SetupFPAnalyzer(DetectEngineCtx *de_ctx)
300 {
301  int fp_engine_analysis_set = 0;
302 
303  if ((ConfGetBool("engine-analysis.rules-fast-pattern",
304  &fp_engine_analysis_set)) == 0) {
305  return false;
306  }
307 
308  if (fp_engine_analysis_set == 0)
309  return false;
310 
311  const char *log_dir = ConfigGetLogDirectory();
312  char *log_path = SCMalloc(PATH_MAX);
313  if (log_path == NULL) {
314  FatalError("Unable to allocate scratch memory for rule filename");
315  }
316  snprintf(log_path, PATH_MAX, "%s/%s%s", log_dir,
317  de_ctx->ea->file_prefix ? de_ctx->ea->file_prefix : "", "rules_fast_pattern.txt");
318 
319  FILE *fp = fopen(log_path, "w");
320  if (fp == NULL) {
321  SCLogError("failed to open %s: %s", log_path, strerror(errno));
322  SCFree(log_path);
323  return false;
324  }
325 
327 
328  SCLogInfo("Engine-Analysis for fast_pattern printed to file - %s",
329  log_path);
330  SCFree(log_path);
331 
332  struct timeval tval;
333  gettimeofday(&tval, NULL);
334  struct tm local_tm;
335  struct tm *tms = SCLocalTime(tval.tv_sec, &local_tm);
336  fprintf(fp, "----------------------------------------------"
337  "---------------------\n");
338  fprintf(fp,
339  "Date: %" PRId32 "/%" PRId32 "/%04d -- "
340  "%02d:%02d:%02d\n",
341  tms->tm_mday, tms->tm_mon + 1, tms->tm_year + 1900, tms->tm_hour, tms->tm_min,
342  tms->tm_sec);
343  fprintf(fp, "----------------------------------------------"
344  "---------------------\n");
345 
346  memset(&de_ctx->ea->fp_pattern_stats[0], 0, sizeof(de_ctx->ea->fp_pattern_stats));
347  return true;
348 }
349 
350 /**
351  * \brief Compiles regex for rule analysis
352  * \retval 1 if successful
353  * \retval 0 if on error
354  */
355 static bool PerCentEncodingSetup(EngineAnalysisCtx *ea_ctx)
356 {
357 #define DETECT_PERCENT_ENCODING_REGEX "%[0-9|a-f|A-F]{2}"
358  int en;
359  PCRE2_SIZE eo = 0;
360  int opts = 0; // PCRE2_NEWLINE_ANY??
361 
362  ea_ctx->percent_re = pcre2_compile((PCRE2_SPTR8)DETECT_PERCENT_ENCODING_REGEX,
363  PCRE2_ZERO_TERMINATED, opts, &en, &eo, NULL);
364  if (ea_ctx->percent_re == NULL) {
365  PCRE2_UCHAR errbuffer[256];
366  pcre2_get_error_message(en, errbuffer, sizeof(errbuffer));
367  SCLogError("Compile of \"%s\" failed at offset %d: %s", DETECT_PERCENT_ENCODING_REGEX,
368  (int)eo, errbuffer);
369  return false;
370  }
371 
372  return true;
373 }
374 /**
375  * \brief Sets up the rule analyzer according to the config
376  * \retval 1 if rule analyzer successfully enabled
377  * \retval 0 if not enabled
378  */
379 static int SetupRuleAnalyzer(DetectEngineCtx *de_ctx)
380 {
381  ConfNode *conf = ConfGetNode("engine-analysis");
382  int enabled = 0;
383  if (conf != NULL) {
384  const char *value = ConfNodeLookupChildValue(conf, "rules");
385  if (value && ConfValIsTrue(value)) {
386  enabled = 1;
387  } else if (value && strcasecmp(value, "warnings-only") == 0) {
388  enabled = 1;
389  rule_warnings_only = 1;
390  }
391  if (enabled) {
392  const char *log_dir;
393  log_dir = ConfigGetLogDirectory();
394  char log_path[PATH_MAX];
395  snprintf(log_path, sizeof(log_path), "%s/%s%s", log_dir,
396  de_ctx->ea->file_prefix ? de_ctx->ea->file_prefix : "", "rules_analysis.txt");
397  de_ctx->ea->rule_engine_analysis_fp = fopen(log_path, "w");
398  if (de_ctx->ea->rule_engine_analysis_fp == NULL) {
399  SCLogError("failed to open %s: %s", log_path, strerror(errno));
400  return 0;
401  }
402 
403  SCLogInfo("Engine-Analysis for rules printed to file - %s",
404  log_path);
405 
406  struct timeval tval;
407  gettimeofday(&tval, NULL);
408  struct tm local_tm;
409  struct tm *tms = SCLocalTime(tval.tv_sec, &local_tm);
411  "----------------------------------------------"
412  "---------------------\n");
414  "Date: %" PRId32 "/%" PRId32 "/%04d -- "
415  "%02d:%02d:%02d\n",
416  tms->tm_mday, tms->tm_mon + 1, tms->tm_year + 1900, tms->tm_hour, tms->tm_min,
417  tms->tm_sec);
419  "----------------------------------------------"
420  "---------------------\n");
421 
422  /*compile regex's for rule analysis*/
423  if (!PerCentEncodingSetup(de_ctx->ea)) {
425  "Error compiling regex; can't check for percent encoding in normalized "
426  "http content.\n");
427  }
428  }
429  }
430  else {
431  SCLogInfo("Conf parameter \"engine-analysis.rules\" not found. "
432  "Defaulting to not printing the rules analysis report.");
433  }
434  if (!enabled) {
435  SCLogInfo("Engine-Analysis for rules disabled in conf file.");
436  return 0;
437  }
438  return 1;
439 }
440 
441 static void CleanupFPAnalyzer(DetectEngineCtx *de_ctx)
442 {
443  FILE *fp = de_ctx->ea->rule_engine_analysis_fp;
444  fprintf(fp, "============\n"
445  "Summary:\n============\n");
446 
447  for (int i = 0; i < DETECT_SM_LIST_MAX; i++) {
449  if (f->cnt == 0)
450  continue;
451 
452  fprintf(fp,
453  "%s, smallest pattern %u byte(s), longest pattern %u byte(s), number of patterns "
454  "%u, avg pattern len %.2f byte(s)\n",
455  DetectSigmatchListEnumToString(i), f->min, f->max, f->cnt,
456  (float)((double)f->tot / (float)f->cnt));
457  }
458 
461 }
462 
463 static void CleanupRuleAnalyzer(DetectEngineCtx *de_ctx)
464 {
465  if (de_ctx->ea->fp_engine_analysis_fp != NULL) {
466  fclose(de_ctx->ea->fp_engine_analysis_fp);
468  }
469  if (de_ctx->ea->percent_re != NULL) {
470  pcre2_code_free(de_ctx->ea->percent_re);
471  }
472 }
473 
474 void SetupEngineAnalysis(DetectEngineCtx *de_ctx, bool *fp_analysis, bool *rule_analysis)
475 {
476  *fp_analysis = false;
477  *rule_analysis = false;
478 
479  EngineAnalysisCtx *ea = SCCalloc(1, sizeof(EngineAnalysisCtx));
480  if (ea == NULL) {
481  FatalError("Unable to allocate per-engine analysis context");
482  }
483 
484  ea->file_prefix = NULL;
485  int cfg_prefix_len = strlen(de_ctx->config_prefix);
486  if (cfg_prefix_len > 0) {
487  /* length of prefix + NULL + "." */
488  ea->file_prefix = SCCalloc(1, cfg_prefix_len + 1 + 1);
489  if (ea->file_prefix == NULL) {
490  FatalError("Unable to allocate per-engine analysis context name buffer");
491  }
492 
493  snprintf(ea->file_prefix, cfg_prefix_len + 1 + 1, "%s.", de_ctx->config_prefix);
494  }
495 
496  de_ctx->ea = ea;
497 
498  *fp_analysis = SetupFPAnalyzer(de_ctx);
499  *rule_analysis = SetupRuleAnalyzer(de_ctx);
500 
501  if (!(*fp_analysis || *rule_analysis)) {
502  if (ea->file_prefix)
503  SCFree(ea->file_prefix);
504  if (ea->analyzer_items)
505  SCFree(ea->analyzer_items);
506  SCFree(ea);
507  }
508 }
509 
511 {
512  if (de_ctx->ea) {
513  CleanupRuleAnalyzer(de_ctx);
514  CleanupFPAnalyzer(de_ctx);
515  if (de_ctx->ea->file_prefix)
517  if (de_ctx->ea->analyzer_items)
519  SCFree(de_ctx->ea);
520  de_ctx->ea = NULL;
521  }
522 }
523 
524 /**
525  * \brief Checks for % encoding in content.
526  * \param Pointer to content
527  * \retval number of matches if content has % encoding
528  * \retval 0 if it doesn't have % encoding
529  * \retval -1 on error
530  */
531 static int PerCentEncodingMatch(EngineAnalysisCtx *ea_ctx, uint8_t *content, uint16_t content_len)
532 {
533  int ret = 0;
534 
535  pcre2_match_data *match = pcre2_match_data_create_from_pattern(ea_ctx->percent_re, NULL);
536  ret = pcre2_match(ea_ctx->percent_re, (PCRE2_SPTR8)content, content_len, 0, 0, match, NULL);
537  if (ret == -1) {
538  return 0;
539  } else if (ret < -1) {
540  SCLogError("Error parsing content - %s; error code is %d", content, ret);
541  ret = -1;
542  }
543  pcre2_match_data_free(match);
544  return ret;
545 }
546 
547 static void EngineAnalysisRulesPrintFP(const DetectEngineCtx *de_ctx, const Signature *s)
548 {
549  const DetectContentData *fp_cd = NULL;
550  const SigMatch *mpm_sm = s->init_data->mpm_sm;
551  const int mpm_sm_list = s->init_data->mpm_sm_list;
552 
553  if (mpm_sm != NULL) {
554  fp_cd = (DetectContentData *)mpm_sm->ctx;
555  }
556 
557  if (fp_cd == NULL) {
558  return;
559  }
560 
561  uint16_t patlen = fp_cd->content_len;
562  uint8_t *pat = SCMalloc(fp_cd->content_len + 1);
563  if (unlikely(pat == NULL)) {
564  FatalError("Error allocating memory");
565  }
566 
567  EngineAnalysisCtx *ea_ctx = de_ctx->ea;
568 
569  memcpy(pat, fp_cd->content, fp_cd->content_len);
570  pat[fp_cd->content_len] = '\0';
571 
573  SCFree(pat);
574  patlen = fp_cd->fp_chop_len;
575  pat = SCMalloc(fp_cd->fp_chop_len + 1);
576  if (unlikely(pat == NULL)) {
577  exit(EXIT_FAILURE);
578  }
579  memcpy(pat, fp_cd->content + fp_cd->fp_chop_offset, fp_cd->fp_chop_len);
580  pat[fp_cd->fp_chop_len] = '\0';
581  fprintf(ea_ctx->rule_engine_analysis_fp, " Fast Pattern \"");
582  PrintRawUriFp(ea_ctx->rule_engine_analysis_fp, pat, patlen);
583  } else {
584  fprintf(ea_ctx->rule_engine_analysis_fp, " Fast Pattern \"");
585  PrintRawUriFp(ea_ctx->rule_engine_analysis_fp, pat, patlen);
586  }
587  SCFree(pat);
588 
589  fprintf(ea_ctx->rule_engine_analysis_fp, "\" on \"");
590 
591  const int list_type = mpm_sm_list;
592  if (list_type == DETECT_SM_LIST_PMATCH) {
593  int payload = 0;
594  int stream = 0;
596  payload = 1;
598  stream = 1;
599  fprintf(ea_ctx->rule_engine_analysis_fp, "%s",
600  payload ? (stream ? "payload and reassembled stream" : "payload")
601  : "reassembled stream");
602  }
603  else {
604  const char *desc = DetectEngineBufferTypeGetDescriptionById(de_ctx, list_type);
605  const char *name = DetectEngineBufferTypeGetNameById(de_ctx, list_type);
606  if (desc && name) {
607  fprintf(ea_ctx->rule_engine_analysis_fp, "%s (%s)", desc, name);
608  } else if (desc || name) {
609  fprintf(ea_ctx->rule_engine_analysis_fp, "%s", desc ? desc : name);
610  }
611 
612  }
613 
614  fprintf(ea_ctx->rule_engine_analysis_fp, "\" ");
615  const DetectBufferType *bt = DetectEngineBufferTypeGetById(de_ctx, list_type);
616  if (bt && bt->transforms.cnt) {
617  fprintf(ea_ctx->rule_engine_analysis_fp, "(with %d transform(s)) ", bt->transforms.cnt);
618  }
619  fprintf(ea_ctx->rule_engine_analysis_fp, "buffer.\n");
620 }
621 
622 void EngineAnalysisRulesFailure(const DetectEngineCtx *de_ctx, char *line, char *file, int lineno)
623 {
624  fprintf(de_ctx->ea->fp_engine_analysis_fp, "== Sid: UNKNOWN ==\n");
625  fprintf(de_ctx->ea->fp_engine_analysis_fp, "%s\n", line);
626  fprintf(de_ctx->ea->fp_engine_analysis_fp, " FAILURE: invalid rule.\n");
627  fprintf(de_ctx->ea->fp_engine_analysis_fp, " File: %s.\n", file);
628  fprintf(de_ctx->ea->fp_engine_analysis_fp, " Line: %d.\n", lineno);
629  fprintf(de_ctx->ea->fp_engine_analysis_fp, "\n");
630 }
631 
632 typedef struct RuleAnalyzer {
633  JsonBuilder *js; /* document root */
634 
635  JsonBuilder *js_warnings;
636  JsonBuilder *js_notes;
638 
639 static void ATTR_FMT_PRINTF(2, 3) AnalyzerNote(RuleAnalyzer *ctx, char *fmt, ...)
640 {
641  va_list ap;
642  char str[1024];
643 
644  va_start(ap, fmt);
645  vsnprintf(str, sizeof(str), fmt, ap);
646  va_end(ap);
647 
648  if (!ctx->js_notes)
649  ctx->js_notes = jb_new_array();
650  if (ctx->js_notes)
651  jb_append_string(ctx->js_notes, str);
652 }
653 
654 static void ATTR_FMT_PRINTF(2, 3) AnalyzerWarning(RuleAnalyzer *ctx, char *fmt, ...)
655 {
656  va_list ap;
657  char str[1024];
658 
659  va_start(ap, fmt);
660  vsnprintf(str, sizeof(str), fmt, ap);
661  va_end(ap);
662 
663  if (!ctx->js_warnings)
664  ctx->js_warnings = jb_new_array();
665  if (ctx->js_warnings)
666  jb_append_string(ctx->js_warnings, str);
667 }
668 
669 #define CHECK(pat) if (strlen((pat)) <= len && memcmp((pat), buf, MIN(len, strlen((pat)))) == 0) return true;
670 
671 static bool LooksLikeHTTPMethod(const uint8_t *buf, uint16_t len)
672 {
673  CHECK("GET /");
674  CHECK("POST /");
675  CHECK("HEAD /");
676  CHECK("PUT /");
677  return false;
678 }
679 
680 static bool LooksLikeHTTPUA(const uint8_t *buf, uint16_t len)
681 {
682  CHECK("User-Agent: ");
683  CHECK("\nUser-Agent: ");
684  return false;
685 }
686 
687 static void DumpContent(JsonBuilder *js, const DetectContentData *cd)
688 {
689  char pattern_str[1024] = "";
690  DetectContentPatternPrettyPrint(cd, pattern_str, sizeof(pattern_str));
691 
692  jb_set_string(js, "pattern", pattern_str);
693  jb_set_uint(js, "length", cd->content_len);
694  jb_set_bool(js, "nocase", cd->flags & DETECT_CONTENT_NOCASE);
695  jb_set_bool(js, "negated", cd->flags & DETECT_CONTENT_NEGATED);
696  jb_set_bool(js, "starts_with", cd->flags & DETECT_CONTENT_STARTS_WITH);
697  jb_set_bool(js, "ends_with", cd->flags & DETECT_CONTENT_ENDS_WITH);
698  jb_set_bool(js, "is_mpm", cd->flags & DETECT_CONTENT_MPM);
699  jb_set_bool(js, "no_double_inspect", cd->flags & DETECT_CONTENT_NO_DOUBLE_INSPECTION_REQUIRED);
700  if (cd->flags & DETECT_CONTENT_OFFSET) {
701  jb_set_uint(js, "offset", cd->offset);
702  }
703  if (cd->flags & DETECT_CONTENT_DEPTH) {
704  jb_set_uint(js, "depth", cd->depth);
705  }
706  if (cd->flags & DETECT_CONTENT_DISTANCE) {
707  jb_set_int(js, "distance", cd->distance);
708  }
709  if (cd->flags & DETECT_CONTENT_WITHIN) {
710  jb_set_int(js, "within", cd->within);
711  }
712  jb_set_bool(js, "fast_pattern", cd->flags & DETECT_CONTENT_FAST_PATTERN);
713  jb_set_bool(js, "relative_next", cd->flags & DETECT_CONTENT_RELATIVE_NEXT);
714 }
715 
716 static void DumpPcre(JsonBuilder *js, const DetectPcreData *cd)
717 {
718  jb_set_bool(js, "relative", cd->flags & DETECT_PCRE_RELATIVE);
719  jb_set_bool(js, "relative_next", cd->flags & DETECT_PCRE_RELATIVE_NEXT);
720  jb_set_bool(js, "nocase", cd->flags & DETECT_PCRE_CASELESS);
721  jb_set_bool(js, "negated", cd->flags & DETECT_PCRE_NEGATE);
722 }
723 
724 static void DumpMatches(RuleAnalyzer *ctx, JsonBuilder *js, const SigMatchData *smd)
725 {
726  if (smd == NULL)
727  return;
728 
729  jb_open_array(js, "matches");
730  do {
731  jb_start_object(js);
732  const char *mname = sigmatch_table[smd->type].name;
733  jb_set_string(js, "name", mname);
734 
735  switch (smd->type) {
736  case DETECT_CONTENT: {
737  const DetectContentData *cd = (const DetectContentData *)smd->ctx;
738 
739  jb_open_object(js, "content");
740  DumpContent(js, cd);
742  AnalyzerNote(ctx, (char *)"'fast_pattern:only' option is silently ignored and "
743  "is interpreted as regular 'fast_pattern'");
744  }
745  if (LooksLikeHTTPMethod(cd->content, cd->content_len)) {
746  AnalyzerWarning(ctx,
747  (char *)"pattern looks like it inspects HTTP, use http.request_line or "
748  "http.method and http.uri instead for improved performance");
749  }
750  if (LooksLikeHTTPUA(cd->content, cd->content_len)) {
751  AnalyzerWarning(ctx,
752  (char *)"pattern looks like it inspects HTTP, use http.user_agent "
753  "or http.header for improved performance");
754  }
756  AnalyzerNote(ctx, (char *)"'within' option for pattern w/o previous content "
757  "was converted to 'depth'");
758  }
760  AnalyzerNote(ctx, (char *)"'distance' option for pattern w/o previous content "
761  "was converted to 'offset'");
762  }
763  jb_close(js);
764  break;
765  }
766  case DETECT_PCRE: {
767  const DetectPcreData *cd = (const DetectPcreData *)smd->ctx;
768 
769  jb_open_object(js, "pcre");
770  DumpPcre(js, cd);
771  jb_close(js);
772  if (cd->flags & DETECT_PCRE_RAWBYTES) {
773  AnalyzerNote(ctx,
774  (char *)"'/B' (rawbytes) option is a no-op and is silently ignored");
775  }
776  break;
777  }
778  case DETECT_BYTEJUMP: {
779  const DetectBytejumpData *cd = (const DetectBytejumpData *)smd->ctx;
780 
781  jb_open_object(js, "byte_jump");
782  jb_set_uint(js, "nbytes", cd->nbytes);
783  jb_set_int(js, "offset", cd->offset);
784  jb_set_uint(js, "multiplier", cd->multiplier);
785  jb_set_int(js, "post_offset", cd->post_offset);
786  switch (cd->base) {
788  jb_set_string(js, "base", "unset");
789  break;
791  jb_set_string(js, "base", "oct");
792  break;
794  jb_set_string(js, "base", "dec");
795  break;
797  jb_set_string(js, "base", "hex");
798  break;
799  }
800  jb_open_array(js, "flags");
801  if (cd->flags & DETECT_BYTEJUMP_BEGIN)
802  jb_append_string(js, "from_beginning");
803  if (cd->flags & DETECT_BYTEJUMP_LITTLE)
804  jb_append_string(js, "little_endian");
805  if (cd->flags & DETECT_BYTEJUMP_BIG)
806  jb_append_string(js, "big_endian");
807  if (cd->flags & DETECT_BYTEJUMP_STRING)
808  jb_append_string(js, "string");
810  jb_append_string(js, "relative");
811  if (cd->flags & DETECT_BYTEJUMP_ALIGN)
812  jb_append_string(js, "align");
813  if (cd->flags & DETECT_BYTEJUMP_DCE)
814  jb_append_string(js, "dce");
816  jb_append_string(js, "offset_be");
817  if (cd->flags & DETECT_BYTEJUMP_END)
818  jb_append_string(js, "from_end");
819  jb_close(js);
820  jb_close(js);
821  break;
822  }
823  case DETECT_BYTETEST: {
824  const DetectBytetestData *cd = (const DetectBytetestData *)smd->ctx;
825 
826  jb_open_object(js, "byte_test");
827  jb_set_uint(js, "nbytes", cd->nbytes);
828  jb_set_int(js, "offset", cd->offset);
829  switch (cd->base) {
831  jb_set_string(js, "base", "unset");
832  break;
834  jb_set_string(js, "base", "oct");
835  break;
837  jb_set_string(js, "base", "dec");
838  break;
840  jb_set_string(js, "base", "hex");
841  break;
842  }
843  jb_open_array(js, "flags");
844  if (cd->flags & DETECT_BYTETEST_LITTLE)
845  jb_append_string(js, "little_endian");
846  if (cd->flags & DETECT_BYTETEST_BIG)
847  jb_append_string(js, "big_endian");
848  if (cd->flags & DETECT_BYTETEST_STRING)
849  jb_append_string(js, "string");
851  jb_append_string(js, "relative");
852  if (cd->flags & DETECT_BYTETEST_DCE)
853  jb_append_string(js, "dce");
854  jb_close(js);
855  jb_close(js);
856  break;
857  }
858  case DETECT_IPOPTS: {
859  const DetectIpOptsData *cd = (const DetectIpOptsData *)smd->ctx;
860 
861  jb_open_object(js, "ipopts");
862  const char *flag = IpOptsFlagToString(cd->ipopt);
863  jb_set_string(js, "option", flag);
864  jb_close(js);
865  break;
866  }
867  case DETECT_FLOWBITS: {
868  const DetectFlowbitsData *cd = (const DetectFlowbitsData *)smd->ctx;
869 
870  jb_open_object(js, "flowbits");
871  switch (cd->cmd) {
873  jb_set_string(js, "cmd", "isset");
874  break;
876  jb_set_string(js, "cmd", "isnotset");
877  break;
879  jb_set_string(js, "cmd", "set");
880  break;
882  jb_set_string(js, "cmd", "unset");
883  break;
885  jb_set_string(js, "cmd", "toggle");
886  break;
887  }
888  bool is_or = false;
889  jb_open_array(js, "names");
890  if (cd->or_list_size == 0) {
891  jb_append_string(js, VarNameStoreSetupLookup(cd->idx, VAR_TYPE_FLOW_BIT));
892  } else if (cd->or_list_size > 0) {
893  is_or = true;
894  for (uint8_t i = 0; i < cd->or_list_size; i++) {
895  const char *varname =
897  jb_append_string(js, varname);
898  }
899  }
900  jb_close(js); // array
901  if (is_or) {
902  jb_set_string(js, "operator", "or");
903  }
904  jb_close(js); // object
905  break;
906  }
907  case DETECT_ACK: {
908  const DetectAckData *cd = (const DetectAckData *)smd->ctx;
909 
910  jb_open_object(js, "ack");
911  jb_set_uint(js, "number", cd->ack);
912  jb_close(js);
913  break;
914  }
915  case DETECT_SEQ: {
916  const DetectSeqData *cd = (const DetectSeqData *)smd->ctx;
917  jb_open_object(js, "seq");
918  jb_set_uint(js, "number", cd->seq);
919  jb_close(js);
920  break;
921  }
922  case DETECT_TCPMSS: {
923  const DetectU16Data *cd = (const DetectU16Data *)smd->ctx;
924  jb_open_object(js, "tcp_mss");
925  SCDetectU16ToJson(js, cd);
926  jb_close(js);
927  break;
928  }
929  case DETECT_ICMP_ID: {
930  const DetectIcmpIdData *cd = (const DetectIcmpIdData *)smd->ctx;
931  jb_open_object(js, "id");
932  jb_set_uint(js, "number", SCNtohs(cd->id));
933  jb_close(js);
934  break;
935  }
936  case DETECT_WINDOW: {
937  const DetectWindowData *wd = (const DetectWindowData *)smd->ctx;
938  jb_open_object(js, "window");
939  jb_set_uint(js, "size", wd->size);
940  jb_set_bool(js, "negated", wd->negated);
941  jb_close(js);
942  break;
943  }
944  case DETECT_FLOW_AGE: {
945  const DetectU32Data *cd = (const DetectU32Data *)smd->ctx;
946  jb_open_object(js, "flow_age");
947  SCDetectU32ToJson(js, cd);
948  jb_close(js);
949  break;
950  }
951  }
952  jb_close(js);
953 
954  if (smd->is_last)
955  break;
956  smd++;
957  } while (1);
958  jb_close(js);
959 }
960 
963 {
964  SCEnter();
965 
966  RuleAnalyzer ctx = { NULL, NULL, NULL };
967 
968  ctx.js = jb_new_object();
969  if (ctx.js == NULL)
970  SCReturn;
971 
972  jb_set_string(ctx.js, "raw", s->sig_str);
973  jb_set_uint(ctx.js, "id", s->id);
974  jb_set_uint(ctx.js, "gid", s->gid);
975  jb_set_uint(ctx.js, "rev", s->rev);
976  jb_set_string(ctx.js, "msg", s->msg);
977 
978  const char *alproto = AppProtoToString(s->alproto);
979  jb_set_string(ctx.js, "app_proto", alproto);
980 
981  jb_open_array(ctx.js, "requirements");
982  if (s->mask & SIG_MASK_REQUIRE_PAYLOAD) {
983  jb_append_string(ctx.js, "payload");
984  }
986  jb_append_string(ctx.js, "no_payload");
987  }
988  if (s->mask & SIG_MASK_REQUIRE_FLOW) {
989  jb_append_string(ctx.js, "flow");
990  }
992  jb_append_string(ctx.js, "tcp_flags_init_deinit");
993  }
995  jb_append_string(ctx.js, "tcp_flags_unusual");
996  }
998  jb_append_string(ctx.js, "engine_event");
999  }
1000  if (s->mask & SIG_MASK_REQUIRE_REAL_PKT) {
1001  jb_append_string(ctx.js, "real_pkt");
1002  }
1003  jb_close(ctx.js);
1004 
1005  switch (s->type) {
1006  case SIG_TYPE_NOT_SET:
1007  jb_set_string(ctx.js, "type", "unset");
1008  break;
1009  case SIG_TYPE_IPONLY:
1010  jb_set_string(ctx.js, "type", "ip_only");
1011  break;
1012  case SIG_TYPE_LIKE_IPONLY:
1013  jb_set_string(ctx.js, "type", "like_ip_only");
1014  break;
1015  case SIG_TYPE_PDONLY:
1016  jb_set_string(ctx.js, "type", "pd_only");
1017  break;
1018  case SIG_TYPE_DEONLY:
1019  jb_set_string(ctx.js, "type", "de_only");
1020  break;
1021  case SIG_TYPE_PKT:
1022  jb_set_string(ctx.js, "type", "pkt");
1023  break;
1024  case SIG_TYPE_PKT_STREAM:
1025  jb_set_string(ctx.js, "type", "pkt_stream");
1026  break;
1027  case SIG_TYPE_STREAM:
1028  jb_set_string(ctx.js, "type", "stream");
1029  break;
1030  case SIG_TYPE_APPLAYER:
1031  jb_set_string(ctx.js, "type", "app_layer");
1032  break;
1033  case SIG_TYPE_APP_TX:
1034  jb_set_string(ctx.js, "type", "app_tx");
1035  break;
1036  case SIG_TYPE_MAX:
1037  jb_set_string(ctx.js, "type", "error");
1038  break;
1039  }
1040 
1041  jb_open_array(ctx.js, "flags");
1042  if (s->flags & SIG_FLAG_SRC_ANY) {
1043  jb_append_string(ctx.js, "src_any");
1044  }
1045  if (s->flags & SIG_FLAG_DST_ANY) {
1046  jb_append_string(ctx.js, "dst_any");
1047  }
1048  if (s->flags & SIG_FLAG_SP_ANY) {
1049  jb_append_string(ctx.js, "sp_any");
1050  }
1051  if (s->flags & SIG_FLAG_DP_ANY) {
1052  jb_append_string(ctx.js, "dp_any");
1053  }
1054  if ((s->action & ACTION_ALERT) == 0) {
1055  jb_append_string(ctx.js, "noalert");
1056  }
1057  if (s->flags & SIG_FLAG_DSIZE) {
1058  jb_append_string(ctx.js, "dsize");
1059  }
1060  if (s->flags & SIG_FLAG_APPLAYER) {
1061  jb_append_string(ctx.js, "applayer");
1062  }
1063  if (s->flags & SIG_FLAG_REQUIRE_PACKET) {
1064  jb_append_string(ctx.js, "need_packet");
1065  }
1066  if (s->flags & SIG_FLAG_REQUIRE_STREAM) {
1067  jb_append_string(ctx.js, "need_stream");
1068  }
1069  if (s->flags & SIG_FLAG_MPM_NEG) {
1070  jb_append_string(ctx.js, "negated_mpm");
1071  }
1072  if (s->flags & SIG_FLAG_FLUSH) {
1073  jb_append_string(ctx.js, "flush");
1074  }
1075  if (s->flags & SIG_FLAG_REQUIRE_FLOWVAR) {
1076  jb_append_string(ctx.js, "need_flowvar");
1077  }
1078  if (s->flags & SIG_FLAG_FILESTORE) {
1079  jb_append_string(ctx.js, "filestore");
1080  }
1081  if (s->flags & SIG_FLAG_TOSERVER) {
1082  jb_append_string(ctx.js, "toserver");
1083  }
1084  if (s->flags & SIG_FLAG_TOCLIENT) {
1085  jb_append_string(ctx.js, "toclient");
1086  }
1087  if (s->flags & SIG_FLAG_TLSSTORE) {
1088  jb_append_string(ctx.js, "tlsstore");
1089  }
1090  if (s->flags & SIG_FLAG_BYPASS) {
1091  jb_append_string(ctx.js, "bypass");
1092  }
1093  if (s->flags & SIG_FLAG_PREFILTER) {
1094  jb_append_string(ctx.js, "prefilter");
1095  }
1096  if (s->flags & SIG_FLAG_SRC_IS_TARGET) {
1097  jb_append_string(ctx.js, "src_is_target");
1098  }
1099  if (s->flags & SIG_FLAG_DEST_IS_TARGET) {
1100  jb_append_string(ctx.js, "dst_is_target");
1101  }
1102  jb_close(ctx.js);
1103 
1104  const DetectEnginePktInspectionEngine *pkt_mpm = NULL;
1105  const DetectEngineAppInspectionEngine *app_mpm = NULL;
1106 
1107  jb_open_array(ctx.js, "pkt_engines");
1109  for ( ; pkt != NULL; pkt = pkt->next) {
1110  const char *name = DetectEngineBufferTypeGetNameById(de_ctx, pkt->sm_list);
1111  if (name == NULL) {
1112  switch (pkt->sm_list) {
1113  case DETECT_SM_LIST_PMATCH:
1114  name = "payload";
1115  break;
1116  case DETECT_SM_LIST_MATCH:
1117  name = "packet";
1118  break;
1119  default:
1120  name = "unknown";
1121  break;
1122  }
1123  }
1124  jb_start_object(ctx.js);
1125  jb_set_string(ctx.js, "name", name);
1126  jb_set_bool(ctx.js, "is_mpm", pkt->mpm);
1127  if (pkt->v1.transforms != NULL) {
1128  jb_open_array(ctx.js, "transforms");
1129  for (int t = 0; t < pkt->v1.transforms->cnt; t++) {
1130  jb_start_object(ctx.js);
1131  jb_set_string(ctx.js, "name",
1133  jb_close(ctx.js);
1134  }
1135  jb_close(ctx.js);
1136  }
1137  DumpMatches(&ctx, ctx.js, pkt->smd);
1138  jb_close(ctx.js);
1139  if (pkt->mpm) {
1140  pkt_mpm = pkt;
1141  }
1142  }
1143  jb_close(ctx.js);
1144  jb_open_array(ctx.js, "frame_engines");
1146  for (; frame != NULL; frame = frame->next) {
1147  const char *name = DetectEngineBufferTypeGetNameById(de_ctx, frame->sm_list);
1148  jb_start_object(ctx.js);
1149  jb_set_string(ctx.js, "name", name);
1150  jb_set_bool(ctx.js, "is_mpm", frame->mpm);
1151  if (frame->v1.transforms != NULL) {
1152  jb_open_array(ctx.js, "transforms");
1153  for (int t = 0; t < frame->v1.transforms->cnt; t++) {
1154  jb_start_object(ctx.js);
1155  jb_set_string(ctx.js, "name",
1157  jb_close(ctx.js);
1158  }
1159  jb_close(ctx.js);
1160  }
1161  DumpMatches(&ctx, ctx.js, frame->smd);
1162  jb_close(ctx.js);
1163  }
1164  jb_close(ctx.js);
1165 
1167  bool has_stream = false;
1168  bool has_client_body_mpm = false;
1169  bool has_file_data_mpm = false;
1170 
1171  jb_open_array(ctx.js, "engines");
1173  for ( ; app != NULL; app = app->next) {
1174  const char *name = DetectEngineBufferTypeGetNameById(de_ctx, app->sm_list);
1175  if (name == NULL) {
1176  switch (app->sm_list) {
1177  case DETECT_SM_LIST_PMATCH:
1178  name = "stream";
1179  break;
1180  default:
1181  name = "unknown";
1182  break;
1183  }
1184  }
1185 
1186  if (app->sm_list == DETECT_SM_LIST_PMATCH && !app->mpm) {
1187  has_stream = true;
1188  } else if (app->mpm && strcmp(name, "http_client_body") == 0) {
1189  has_client_body_mpm = true;
1190  } else if (app->mpm && strcmp(name, "file_data") == 0) {
1191  has_file_data_mpm = true;
1192  }
1193 
1194  jb_start_object(ctx.js);
1195  jb_set_string(ctx.js, "name", name);
1196  const char *direction = app->dir == 0 ? "toserver" : "toclient";
1197  jb_set_string(ctx.js, "direction", direction);
1198  jb_set_bool(ctx.js, "is_mpm", app->mpm);
1199  jb_set_string(ctx.js, "app_proto", AppProtoToString(app->alproto));
1200  jb_set_uint(ctx.js, "progress", app->progress);
1201 
1202  if (app->v2.transforms != NULL) {
1203  jb_open_array(ctx.js, "transforms");
1204  for (int t = 0; t < app->v2.transforms->cnt; t++) {
1205  jb_start_object(ctx.js);
1206  jb_set_string(ctx.js, "name",
1208  jb_close(ctx.js);
1209  }
1210  jb_close(ctx.js);
1211  }
1212  DumpMatches(&ctx, ctx.js, app->smd);
1213  jb_close(ctx.js);
1214  if (app->mpm) {
1215  app_mpm = app;
1216  }
1217  }
1218  jb_close(ctx.js);
1219 
1220  if (has_stream && has_client_body_mpm)
1221  AnalyzerNote(&ctx, (char *)"mpm in http_client_body combined with stream match leads to stream buffering");
1222  if (has_stream && has_file_data_mpm)
1223  AnalyzerNote(&ctx, (char *)"mpm in file_data combined with stream match leads to stream buffering");
1224  }
1225 
1226  jb_open_object(ctx.js, "lists");
1227  for (int i = 0; i < DETECT_SM_LIST_MAX; i++) {
1228  if (s->sm_arrays[i] != NULL) {
1229  jb_open_object(ctx.js, DetectListToHumanString(i));
1230  DumpMatches(&ctx, ctx.js, s->sm_arrays[i]);
1231  jb_close(ctx.js);
1232  }
1233  }
1234  jb_close(ctx.js);
1235 
1236  if (pkt_mpm || app_mpm) {
1237  jb_open_object(ctx.js, "mpm");
1238 
1239  int mpm_list = pkt_mpm ? DETECT_SM_LIST_PMATCH : app_mpm->sm_list;
1240  const char *name;
1241  if (mpm_list < DETECT_SM_LIST_DYNAMIC_START)
1242  name = DetectListToHumanString(mpm_list);
1243  else
1244  name = DetectEngineBufferTypeGetNameById(de_ctx, mpm_list);
1245  jb_set_string(ctx.js, "buffer", name);
1246 
1247  SigMatchData *smd = pkt_mpm ? pkt_mpm->smd : app_mpm->smd;
1248  if (smd == NULL && mpm_list == DETECT_SM_LIST_PMATCH) {
1249  smd = s->sm_arrays[mpm_list];
1250  }
1251  do {
1252  switch (smd->type) {
1253  case DETECT_CONTENT: {
1254  const DetectContentData *cd = (const DetectContentData *)smd->ctx;
1255  if (cd->flags & DETECT_CONTENT_MPM) {
1256  DumpContent(ctx.js, cd);
1257  }
1258  break;
1259  }
1260  }
1261 
1262  if (smd->is_last)
1263  break;
1264  smd++;
1265  } while (1);
1266  jb_close(ctx.js);
1267  } else if (s->init_data->prefilter_sm) {
1268  jb_open_object(ctx.js, "prefilter");
1269  int prefilter_list = SigMatchListSMBelongsTo(s, s->init_data->prefilter_sm);
1270  const char *name;
1271  if (prefilter_list < DETECT_SM_LIST_DYNAMIC_START)
1272  name = DetectListToHumanString(prefilter_list);
1273  else
1274  name = DetectEngineBufferTypeGetNameById(de_ctx, prefilter_list);
1275  jb_set_string(ctx.js, "buffer", name);
1276  const char *mname = sigmatch_table[s->init_data->prefilter_sm->type].name;
1277  jb_set_string(ctx.js, "name", mname);
1278  jb_close(ctx.js);
1279  }
1280 
1281  if (ctx.js_warnings) {
1282  jb_close(ctx.js_warnings);
1283  jb_set_object(ctx.js, "warnings", ctx.js_warnings);
1284  jb_free(ctx.js_warnings);
1285  ctx.js_warnings = NULL;
1286  }
1287  if (ctx.js_notes) {
1288  jb_close(ctx.js_notes);
1289  jb_set_object(ctx.js, "notes", ctx.js_notes);
1290  jb_free(ctx.js_notes);
1291  ctx.js_notes = NULL;
1292  }
1293  jb_close(ctx.js);
1294 
1295  const char *filename = "rules.json";
1296  const char *log_dir = ConfigGetLogDirectory();
1297  char json_path[PATH_MAX] = "";
1298  snprintf(json_path, sizeof(json_path), "%s/%s%s", log_dir,
1299  de_ctx->ea->file_prefix ? de_ctx->ea->file_prefix : "", filename);
1300 
1302  FILE *fp = fopen(json_path, "a");
1303  if (fp != NULL) {
1304  fwrite(jb_ptr(ctx.js), jb_len(ctx.js), 1, fp);
1305  fprintf(fp, "\n");
1306  fclose(fp);
1307  }
1309  jb_free(ctx.js);
1310  SCReturn;
1311 }
1312 
1314 {
1315  if (de_ctx->pattern_hash_table == NULL)
1316  return;
1317 
1318  JsonBuilder *root_jb = jb_new_object();
1319  JsonBuilder *arrays[de_ctx->buffer_type_id];
1320  memset(&arrays, 0, sizeof(JsonBuilder *) * de_ctx->buffer_type_id);
1321 
1322  jb_open_array(root_jb, "buffers");
1323 
1325  htb != NULL; htb = HashListTableGetListNext(htb)) {
1326  char str[1024] = "";
1328  DetectContentPatternPrettyPrint(p->cd, str, sizeof(str));
1329 
1330  JsonBuilder *jb = arrays[p->sm_list];
1331  if (arrays[p->sm_list] == NULL) {
1332  jb = arrays[p->sm_list] = jb_new_object();
1333  const char *name;
1335  name = DetectListToHumanString(p->sm_list);
1336  else
1338  jb_set_string(jb, "name", name);
1339  jb_set_uint(jb, "list_id", p->sm_list);
1340 
1341  jb_open_array(jb, "patterns");
1342  }
1343 
1344  jb_start_object(jb);
1345  jb_set_string(jb, "pattern", str);
1346  jb_set_uint(jb, "patlen", p->cd->content_len);
1347  jb_set_uint(jb, "cnt", p->cnt);
1348  jb_set_uint(jb, "mpm", p->mpm);
1349  jb_open_object(jb, "flags");
1350  jb_set_bool(jb, "nocase", p->cd->flags & DETECT_CONTENT_NOCASE);
1351  jb_set_bool(jb, "negated", p->cd->flags & DETECT_CONTENT_NEGATED);
1352  jb_set_bool(jb, "depth", p->cd->flags & DETECT_CONTENT_DEPTH);
1353  jb_set_bool(jb, "offset", p->cd->flags & DETECT_CONTENT_OFFSET);
1354  jb_set_bool(jb, "endswith", p->cd->flags & DETECT_CONTENT_ENDS_WITH);
1355  jb_close(jb);
1356  jb_close(jb);
1357  }
1358 
1359  for (uint32_t i = 0; i < de_ctx->buffer_type_id; i++) {
1360  JsonBuilder *jb = arrays[i];
1361  if (jb == NULL)
1362  continue;
1363 
1364  jb_close(jb); // array
1365  jb_close(jb); // object
1366 
1367  jb_append_object(root_jb, jb);
1368  jb_free(jb);
1369  }
1370  jb_close(root_jb);
1371  jb_close(root_jb);
1372 
1373  const char *filename = "patterns.json";
1374  const char *log_dir = ConfigGetLogDirectory();
1375  char json_path[PATH_MAX] = "";
1376  snprintf(json_path, sizeof(json_path), "%s/%s%s", log_dir,
1377  de_ctx->ea->file_prefix ? de_ctx->ea->file_prefix : "", filename);
1378 
1380  FILE *fp = fopen(json_path, "a");
1381  if (fp != NULL) {
1382  fwrite(jb_ptr(root_jb), jb_len(root_jb), 1, fp);
1383  fprintf(fp, "\n");
1384  fclose(fp);
1385  }
1387  jb_free(root_jb);
1388 
1390  de_ctx->pattern_hash_table = NULL;
1391 }
1392 
1393 static void EngineAnalysisItemsReset(EngineAnalysisCtx *ea_ctx)
1394 {
1395  for (size_t i = 0; i < ARRAY_SIZE(analyzer_items); i++) {
1396  ea_ctx->analyzer_items[i].item_seen = false;
1397  }
1398 }
1399 
1400 static void EngineAnalysisItemsInit(EngineAnalysisCtx *ea_ctx)
1401 {
1402  if (ea_ctx->analyzer_initialized) {
1403  EngineAnalysisItemsReset(ea_ctx);
1404  return;
1405  }
1406 
1407  ea_ctx->exposed_item_seen_list[0].bufname = "http_method";
1408  ea_ctx->exposed_item_seen_list[1].bufname = "file_data";
1409  ea_ctx->analyzer_items = SCCalloc(1, sizeof(analyzer_items));
1410  if (!ea_ctx->analyzer_items) {
1411  FatalError("Unable to allocate analysis scratch pad");
1412  }
1413  memset(ea_ctx->analyzer_item_map, -1, sizeof(ea_ctx->analyzer_item_map));
1414 
1415  for (size_t i = 0; i < ARRAY_SIZE(analyzer_items); i++) {
1416  ea_ctx->analyzer_items[i] = analyzer_items[i];
1417  DetectEngineAnalyzerItems *analyzer_item = &ea_ctx->analyzer_items[i];
1418 
1419  int item_id = DetectBufferTypeGetByName(analyzer_item->item_name);
1420  DEBUG_VALIDATE_BUG_ON(item_id < 0 || item_id > UINT16_MAX);
1421  analyzer_item->item_id = (uint16_t)item_id;
1422  if (analyzer_item->item_id == -1) {
1423  /* Mismatch between the analyzer_items array and what's supported */
1424  FatalError("unable to initialize engine-analysis table: detect buffer \"%s\" not "
1425  "recognized.",
1426  analyzer_item->item_name);
1427  }
1428  analyzer_item->item_seen = false;
1429 
1430  if (analyzer_item->export_item_seen) {
1431  for (size_t k = 0; k < ARRAY_SIZE(ea_ctx->exposed_item_seen_list); k++) {
1432  if (0 ==
1433  strcmp(ea_ctx->exposed_item_seen_list[k].bufname, analyzer_item->item_name))
1434  ea_ctx->exposed_item_seen_list[k].item_seen_ptr = &analyzer_item->item_seen;
1435  }
1436  }
1437  ea_ctx->analyzer_item_map[analyzer_item->item_id] = (int16_t)i;
1438  }
1439 
1440  ea_ctx->analyzer_initialized = true;
1441 }
1442 
1443 /**
1444  * \brief Prints analysis of loaded rules.
1445  *
1446  * Warns if potential rule issues are detected. For example,
1447  * warns if a rule uses a construct that may perform poorly,
1448  * e.g. pcre without content or with http_method content only;
1449  * warns if a rule uses a construct that may not be consistent with intent,
1450  * e.g. client side ports only, http and content without any http_* modifiers, etc.
1451  *
1452  * \param s Pointer to the signature.
1453  */
1455  const Signature *s, const char *line)
1456 {
1457  uint32_t rule_bidirectional = 0;
1458  uint32_t rule_pcre = 0;
1459  uint32_t rule_pcre_http = 0;
1460  uint32_t rule_content = 0;
1461  uint32_t rule_flow = 0;
1462  uint32_t rule_flags = 0;
1463  uint32_t rule_flow_toserver = 0;
1464  uint32_t rule_flow_toclient = 0;
1465  uint32_t rule_flow_nostream = 0;
1466  uint32_t rule_ipv4_only = 0;
1467  uint32_t rule_ipv6_only = 0;
1468  uint32_t rule_flowbits = 0;
1469  uint32_t rule_flowint = 0;
1470  uint32_t rule_content_http = 0;
1471  uint32_t rule_content_offset_depth = 0;
1472  int32_t list_id = 0;
1473  uint32_t rule_warning = 0;
1474  uint32_t stream_buf = 0;
1475  uint32_t packet_buf = 0;
1476  uint32_t file_store = 0;
1477  uint32_t warn_pcre_no_content = 0;
1478  uint32_t warn_pcre_http_content = 0;
1479  uint32_t warn_pcre_http = 0;
1480  uint32_t warn_content_http_content = 0;
1481  uint32_t warn_content_http = 0;
1482  uint32_t warn_tcp_no_flow = 0;
1483  uint32_t warn_client_ports = 0;
1484  uint32_t warn_direction = 0;
1485  uint32_t warn_method_toclient = 0;
1486  uint32_t warn_method_serverbody = 0;
1487  uint32_t warn_pcre_method = 0;
1488  uint32_t warn_encoding_norm_http_buf = 0;
1489  uint32_t warn_file_store_not_present = 0;
1490  uint32_t warn_offset_depth_pkt_stream = 0;
1491  uint32_t warn_offset_depth_alproto = 0;
1492  uint32_t warn_non_alproto_fp_for_alproto_sig = 0;
1493  uint32_t warn_no_direction = 0;
1494  uint32_t warn_both_direction = 0;
1495 
1496  EngineAnalysisItemsInit(de_ctx->ea);
1497 
1498  bool *http_method_item_seen_ptr = de_ctx->ea->exposed_item_seen_list[0].item_seen_ptr;
1499  bool *http_server_body_item_seen_ptr = de_ctx->ea->exposed_item_seen_list[1].item_seen_ptr;
1500 
1502  rule_bidirectional = 1;
1503  }
1504 
1505  if (s->flags & SIG_FLAG_REQUIRE_PACKET) {
1506  packet_buf += 1;
1507  }
1508  if (s->flags & SIG_FLAG_FILESTORE) {
1509  file_store += 1;
1510  }
1511  if (s->flags & SIG_FLAG_REQUIRE_STREAM) {
1512  stream_buf += 1;
1513  }
1514 
1515  if (s->proto.flags & DETECT_PROTO_IPV4) {
1516  rule_ipv4_only += 1;
1517  }
1518  if (s->proto.flags & DETECT_PROTO_IPV6) {
1519  rule_ipv6_only += 1;
1520  }
1521 
1522  for (list_id = 0; list_id < DETECT_SM_LIST_MAX; list_id++) {
1523  SigMatch *sm = NULL;
1524  for (sm = s->init_data->smlists[list_id]; sm != NULL; sm = sm->next) {
1525  int16_t item_slot = de_ctx->ea->analyzer_item_map[list_id];
1526  if (sm->type == DETECT_PCRE) {
1527  if (item_slot == -1) {
1528  rule_pcre++;
1529  continue;
1530  }
1531 
1532  rule_pcre_http++;
1533  de_ctx->ea->analyzer_items[item_slot].item_seen = true;
1534  } else if (sm->type == DETECT_CONTENT) {
1535  if (item_slot == -1) {
1536  rule_content++;
1537  if (list_id == DETECT_SM_LIST_PMATCH) {
1540  rule_content_offset_depth++;
1541  }
1542  }
1543  continue;
1544  }
1545 
1546  rule_content_http++;
1547  de_ctx->ea->analyzer_items[item_slot].item_seen = true;
1548 
1549  if (de_ctx->ea->analyzer_items[item_slot].check_encoding_match) {
1551  if (cd != NULL &&
1552  PerCentEncodingMatch(de_ctx->ea, cd->content, cd->content_len) > 0) {
1553  warn_encoding_norm_http_buf += 1;
1554  }
1555  }
1556  }
1557  else if (sm->type == DETECT_FLOW) {
1558  rule_flow += 1;
1559  if ((s->flags & SIG_FLAG_TOSERVER) && !(s->flags & SIG_FLAG_TOCLIENT)) {
1560  rule_flow_toserver = 1;
1561  }
1562  else if ((s->flags & SIG_FLAG_TOCLIENT) && !(s->flags & SIG_FLAG_TOSERVER)) {
1563  rule_flow_toclient = 1;
1564  }
1565  DetectFlowData *fd = (DetectFlowData *)sm->ctx;
1566  if (fd != NULL) {
1567  if (fd->flags & DETECT_FLOW_FLAG_NOSTREAM)
1568  rule_flow_nostream = 1;
1569  }
1570  }
1571  else if (sm->type == DETECT_FLOWBITS) {
1572  if (list_id == DETECT_SM_LIST_MATCH) {
1573  rule_flowbits += 1;
1574  }
1575  }
1576  else if (sm->type == DETECT_FLOWINT) {
1577  if (list_id == DETECT_SM_LIST_MATCH) {
1578  rule_flowint += 1;
1579  }
1580  }
1581  else if (sm->type == DETECT_FLAGS) {
1582  DetectFlagsData *fd = (DetectFlagsData *)sm->ctx;
1583  if (fd != NULL) {
1584  rule_flags = 1;
1585  }
1586  }
1587  } /* for (sm = s->init_data->smlists[list_id]; sm != NULL; sm = sm->next) */
1588 
1589  } /* for ( ; list_id < DETECT_SM_LIST_MAX; list_id++) */
1590 
1591  if (file_store && !RequiresFeature("output::file-store")) {
1592  rule_warning += 1;
1593  warn_file_store_not_present = 1;
1594  }
1595 
1596  if (rule_pcre > 0 && rule_content == 0 && rule_content_http == 0) {
1597  rule_warning += 1;
1598  warn_pcre_no_content = 1;
1599  }
1600 
1601  if (rule_content_http > 0 && rule_pcre > 0 && rule_pcre_http == 0) {
1602  rule_warning += 1;
1603  warn_pcre_http_content = 1;
1604  } else if (s->alproto == ALPROTO_HTTP1 && rule_pcre > 0 && rule_pcre_http == 0) {
1605  rule_warning += 1;
1606  warn_pcre_http = 1;
1607  }
1608 
1609  if (rule_content > 0 && rule_content_http > 0) {
1610  rule_warning += 1;
1611  warn_content_http_content = 1;
1612  }
1613  if (s->alproto == ALPROTO_HTTP1 && rule_content > 0 && rule_content_http == 0) {
1614  rule_warning += 1;
1615  warn_content_http = 1;
1616  }
1617  if (rule_content == 1) {
1618  //todo: warning if content is weak, separate warning for pcre + weak content
1619  }
1620  if (rule_flow == 0 && rule_flags == 0 && !(s->proto.flags & DETECT_PROTO_ANY) &&
1621  DetectProtoContainsProto(&s->proto, IPPROTO_TCP) &&
1622  (rule_content || rule_content_http || rule_pcre || rule_pcre_http || rule_flowbits ||
1623  rule_flowint)) {
1624  rule_warning += 1;
1625  warn_tcp_no_flow = 1;
1626  }
1627  if (rule_flow && !rule_bidirectional && (rule_flow_toserver || rule_flow_toclient)
1628  && !((s->flags & SIG_FLAG_SP_ANY) && (s->flags & SIG_FLAG_DP_ANY))) {
1629  if (((s->flags & SIG_FLAG_TOSERVER) && !(s->flags & SIG_FLAG_SP_ANY) && (s->flags & SIG_FLAG_DP_ANY))
1630  || ((s->flags & SIG_FLAG_TOCLIENT) && !(s->flags & SIG_FLAG_DP_ANY) && (s->flags & SIG_FLAG_SP_ANY))) {
1631  rule_warning += 1;
1632  warn_client_ports = 1;
1633  }
1634  }
1635  if (rule_flow && rule_bidirectional && (rule_flow_toserver || rule_flow_toclient)) {
1636  rule_warning += 1;
1637  warn_direction = 1;
1638  }
1639 
1640  if (*http_method_item_seen_ptr) {
1641  if (rule_flow && rule_flow_toclient) {
1642  rule_warning += 1;
1643  warn_method_toclient = 1;
1644  }
1645  if (*http_server_body_item_seen_ptr) {
1646  rule_warning += 1;
1647  warn_method_serverbody = 1;
1648  }
1649  if (rule_content == 0 && rule_content_http == 0 && (rule_pcre > 0 || rule_pcre_http > 0)) {
1650  rule_warning += 1;
1651  warn_pcre_method = 1;
1652  }
1653  }
1654  if (rule_content_offset_depth > 0 && stream_buf && packet_buf) {
1655  rule_warning += 1;
1656  warn_offset_depth_pkt_stream = 1;
1657  }
1658  if (rule_content_offset_depth > 0 && !stream_buf && packet_buf && s->alproto != ALPROTO_UNKNOWN) {
1659  rule_warning += 1;
1660  warn_offset_depth_alproto = 1;
1661  }
1662  if (s->init_data->mpm_sm != NULL && s->alproto == ALPROTO_HTTP1 &&
1664  rule_warning += 1;
1665  warn_non_alproto_fp_for_alproto_sig = 1;
1666  }
1667 
1668  if ((s->flags & (SIG_FLAG_TOSERVER|SIG_FLAG_TOCLIENT)) == 0) {
1669  warn_no_direction += 1;
1670  rule_warning += 1;
1671  }
1672 
1673  /* No warning about direction for ICMP protos */
1674  if (!(DetectProtoContainsProto(&s->proto, IPPROTO_ICMPV6) && DetectProtoContainsProto(&s->proto, IPPROTO_ICMP))) {
1676  warn_both_direction += 1;
1677  rule_warning += 1;
1678  }
1679  }
1680 
1681  if (!rule_warnings_only || (rule_warnings_only && rule_warning > 0)) {
1682  FILE *fp = de_ctx->ea->rule_engine_analysis_fp;
1683  fprintf(fp, "== Sid: %u ==\n", s->id);
1684  fprintf(fp, "%s\n", line);
1685 
1686  switch (s->type) {
1687  case SIG_TYPE_NOT_SET:
1688  break;
1689  case SIG_TYPE_IPONLY:
1690  fprintf(fp, " Rule is ip only.\n");
1691  break;
1692  case SIG_TYPE_LIKE_IPONLY:
1693  fprintf(fp, " Rule is like ip only.\n");
1694  break;
1695  case SIG_TYPE_PDONLY:
1696  fprintf(fp, " Rule is PD only.\n");
1697  break;
1698  case SIG_TYPE_DEONLY:
1699  fprintf(fp, " Rule is DE only.\n");
1700  break;
1701  case SIG_TYPE_PKT:
1702  fprintf(fp, " Rule is packet inspecting.\n");
1703  break;
1704  case SIG_TYPE_PKT_STREAM:
1705  fprintf(fp, " Rule is packet and stream inspecting.\n");
1706  break;
1707  case SIG_TYPE_STREAM:
1708  fprintf(fp, " Rule is stream inspecting.\n");
1709  break;
1710  case SIG_TYPE_APPLAYER:
1711  fprintf(fp, " Rule is app-layer inspecting.\n");
1712  break;
1713  case SIG_TYPE_APP_TX:
1714  fprintf(fp, " Rule is App-layer TX inspecting.\n");
1715  break;
1716  case SIG_TYPE_MAX:
1717  break;
1718  }
1719  if (rule_ipv6_only)
1720  fprintf(fp, " Rule is IPv6 only.\n");
1721  if (rule_ipv4_only)
1722  fprintf(fp, " Rule is IPv4 only.\n");
1723  if (packet_buf)
1724  fprintf(fp, " Rule matches on packets.\n");
1725  if (!rule_flow_nostream && stream_buf &&
1726  (rule_flow || rule_flowbits || rule_flowint || rule_content || rule_pcre)) {
1727  fprintf(fp, " Rule matches on reassembled stream.\n");
1728  }
1729  for(size_t i = 0; i < ARRAY_SIZE(analyzer_items); i++) {
1731  if (ai->item_seen) {
1732  fprintf(fp, " Rule matches on %s buffer.\n", ai->display_name);
1733  }
1734  }
1735  if (s->alproto != ALPROTO_UNKNOWN) {
1736  fprintf(fp, " App layer protocol is %s.\n", AppProtoToString(s->alproto));
1737  }
1738  if (rule_content || rule_content_http || rule_pcre || rule_pcre_http) {
1739  fprintf(fp,
1740  " Rule contains %u content options, %u http content options, %u pcre "
1741  "options, and %u pcre options with http modifiers.\n",
1742  rule_content, rule_content_http, rule_pcre, rule_pcre_http);
1743  }
1744 
1745  /* print fast pattern info */
1746  if (s->init_data->prefilter_sm) {
1747  fprintf(fp, " Prefilter on: %s.\n",
1749  } else {
1750  EngineAnalysisRulesPrintFP(de_ctx, s);
1751  }
1752 
1753  /* this is where the warnings start */
1754  if (warn_pcre_no_content /*rule_pcre > 0 && rule_content == 0 && rule_content_http == 0*/) {
1755  fprintf(fp, " Warning: Rule uses pcre without a content option present.\n"
1756  " -Consider adding a content to improve performance of this "
1757  "rule.\n");
1758  }
1759  if (warn_pcre_http_content /*rule_content_http > 0 && rule_pcre > 0 && rule_pcre_http == 0*/) {
1760  fprintf(fp, " Warning: Rule uses content options with http_* and pcre options "
1761  "without http modifiers.\n"
1762  " -Consider adding http pcre modifier.\n");
1763  }
1764  else if (warn_pcre_http /*s->alproto == ALPROTO_HTTP1 && rule_pcre > 0 && rule_pcre_http == 0*/) {
1765  fprintf(fp, " Warning: Rule app layer protocol is http, but pcre options do not "
1766  "have http modifiers.\n"
1767  " -Consider adding http pcre modifiers.\n");
1768  }
1769  if (warn_content_http_content /*rule_content > 0 && rule_content_http > 0*/) {
1770  fprintf(fp,
1771  " Warning: Rule contains content with http_* and content without http_*.\n"
1772  " -Consider adding http content modifiers.\n");
1773  }
1774  if (warn_content_http /*s->alproto == ALPROTO_HTTP1 && rule_content > 0 && rule_content_http == 0*/) {
1775  fprintf(fp, " Warning: Rule app layer protocol is http, but content options do not "
1776  "have http_* modifiers.\n"
1777  " -Consider adding http content modifiers.\n");
1778  }
1779  if (rule_content == 1) {
1780  //todo: warning if content is weak, separate warning for pcre + weak content
1781  }
1782  if (warn_encoding_norm_http_buf) {
1783  fprintf(fp, " Warning: Rule may contain percent encoded content for a normalized "
1784  "http buffer match.\n");
1785  }
1786  if (warn_tcp_no_flow /*rule_flow == 0 && rule_flags == 0
1787  && !(s->proto.flags & DETECT_PROTO_ANY) && DetectProtoContainsProto(&s->proto, IPPROTO_TCP)*/) {
1788  fprintf(fp, " Warning: TCP rule without a flow or flags option.\n"
1789  " -Consider adding flow or flags to improve performance of "
1790  "this rule.\n");
1791  }
1792  if (warn_client_ports /*rule_flow && !rule_bidirectional && (rule_flow_toserver || rule_flow_toclient)
1793  && !((s->flags & SIG_FLAG_SP_ANY) && (s->flags & SIG_FLAG_DP_ANY)))
1794  if (((s->flags & SIG_FLAG_TOSERVER) && !(s->flags & SIG_FLAG_SP_ANY) && (s->flags & SIG_FLAG_DP_ANY))
1795  || ((s->flags & SIG_FLAG_TOCLIENT) && !(s->flags & SIG_FLAG_DP_ANY) && (s->flags & SIG_FLAG_SP_ANY))*/) {
1796  fprintf(fp,
1797  " Warning: Rule contains ports or port variables only on the client side.\n"
1798  " -Flow direction possibly inconsistent with rule.\n");
1799  }
1800  if (warn_direction /*rule_flow && rule_bidirectional && (rule_flow_toserver || rule_flow_toclient)*/) {
1801  fprintf(fp, " Warning: Rule is bidirectional and has a flow option with a specific "
1802  "direction.\n");
1803  }
1804  if (warn_method_toclient /*http_method_buf && rule_flow && rule_flow_toclient*/) {
1805  fprintf(fp, " Warning: Rule uses content or pcre for http_method with "
1806  "flow:to_client or from_server\n");
1807  }
1808  if (warn_method_serverbody /*http_method_buf && http_server_body_buf*/) {
1809  fprintf(fp, " Warning: Rule uses content or pcre for http_method with content or "
1810  "pcre for http_server_body.\n");
1811  }
1812  if (warn_pcre_method /*http_method_buf && rule_content == 0 && rule_content_http == 0
1813  && (rule_pcre > 0 || rule_pcre_http > 0)*/) {
1814  fprintf(fp, " Warning: Rule uses pcre with only a http_method content; possible "
1815  "performance issue.\n");
1816  }
1817  if (warn_offset_depth_pkt_stream) {
1818  fprintf(fp, " Warning: Rule has depth"
1819  "/offset with raw content keywords. Please note the "
1820  "offset/depth will be checked against both packet "
1821  "payloads and stream. If you meant to have the offset/"
1822  "depth checked against just the payload, you can update "
1823  "the signature as \"alert tcp-pkt...\"\n");
1824  }
1825  if (warn_offset_depth_alproto) {
1826  fprintf(fp,
1827  " Warning: Rule has "
1828  "offset/depth set along with a match on a specific "
1829  "app layer protocol - %d. This can lead to FNs if we "
1830  "have a offset/depth content match on a packet payload "
1831  "before we can detect the app layer protocol for the "
1832  "flow.\n",
1833  s->alproto);
1834  }
1835  if (warn_non_alproto_fp_for_alproto_sig) {
1836  fprintf(fp, " Warning: Rule app layer "
1837  "protocol is http, but the fast_pattern is set on the raw "
1838  "stream. Consider adding fast_pattern over a http "
1839  "buffer for increased performance.");
1840  }
1841  if (warn_no_direction) {
1842  fprintf(fp, " Warning: Rule has no direction indicator.\n");
1843  }
1844  if (warn_both_direction) {
1845  fprintf(fp, " Warning: Rule is inspecting both the request and the response.\n");
1846  }
1847  if (warn_file_store_not_present) {
1848  fprintf(fp, " Warning: Rule requires file-store but the output file-store is not "
1849  "enabled.\n");
1850  }
1851  if (rule_warning == 0) {
1852  fprintf(fp, " No warnings for this rule.\n");
1853  }
1854  fprintf(fp, "\n");
1855  }
1856 }
detect-tcp-flags.h
DETECT_PCRE_CASELESS
#define DETECT_PCRE_CASELESS
Definition: detect-pcre.h:32
DETECT_CONTENT_NOCASE
#define DETECT_CONTENT_NOCASE
Definition: detect-content.h:29
SignatureHasPacketContent
int SignatureHasPacketContent(const Signature *s)
check if a signature has patterns that are to be inspected against a packets payload (as opposed to t...
Definition: detect-engine-mpm.c:796
RuleAnalyzer::js
JsonBuilder * js
Definition: detect-engine-analyzer.c:633
DetectBytejumpData_::post_offset
int32_t post_offset
Definition: detect-bytejump.h:51
HashListTableGetListData
#define HashListTableGetListData(hb)
Definition: util-hashlist.h:56
SIG_TYPE_STREAM
@ SIG_TYPE_STREAM
Definition: detect.h:72
DetectContentData_::offset
uint16_t offset
Definition: detect-content.h:107
DetectBytetestData_::flags
uint16_t flags
Definition: detect-bytetest.h:58
detect-engine-uint.h
DetectPatternTracker
Definition: detect.h:730
DetectEngineAppInspectionEngine_
Definition: detect.h:429
DETECT_CONTENT_RELATIVE_NEXT
#define DETECT_CONTENT_RELATIVE_NEXT
Definition: detect-content.h:66
DetectEngineAppInspectionEngine_::mpm
bool mpm
Definition: detect.h:433
detect-content.h
DetectFlowbitsData_::or_list_size
uint8_t or_list_size
Definition: detect-flowbits.h:38
len
uint8_t len
Definition: app-layer-dnp3.h:2
detect-engine.h
DETECT_SM_LIST_PMATCH
@ DETECT_SM_LIST_PMATCH
Definition: detect.h:116
SIG_MASK_REQUIRE_REAL_PKT
#define SIG_MASK_REQUIRE_REAL_PKT
Definition: detect.h:306
DETECT_CONTENT_FAST_PATTERN_CHOP
#define DETECT_CONTENT_FAST_PATTERN_CHOP
Definition: detect-content.h:36
SignatureInitData_::smlists
struct SigMatch_ * smlists[DETECT_SM_LIST_MAX]
Definition: detect.h:586
DetectContentData_::fp_chop_len
uint16_t fp_chop_len
Definition: detect-content.h:98
sigmatch_table
SigTableElmt * sigmatch_table
Definition: detect-parse.c:127
Signature_::sig_str
char * sig_str
Definition: detect.h:668
SIG_TYPE_APP_TX
@ SIG_TYPE_APP_TX
Definition: detect.h:75
DetectSeqData_::seq
uint32_t seq
Definition: detect-tcp-seq.h:31
DetectIcmpIdData_
Definition: detect-icmp-id.h:27
DetectEnginePktInspectionEngine
Definition: detect.h:486
DetectEngineAppInspectionEngine_::next
struct DetectEngineAppInspectionEngine_ * next
Definition: detect.h:451
DETECT_PROTO_IPV6
#define DETECT_PROTO_IPV6
Definition: detect-engine-proto.h:32
DetectFlowData_
Definition: detect-flow.h:37
DETECT_FLOW_FLAG_NOSTREAM
#define DETECT_FLOW_FLAG_NOSTREAM
Definition: detect-flow.h:33
SigTableElmt_::name
const char * name
Definition: detect.h:1304
DETECT_BYTEJUMP
@ DETECT_BYTEJUMP
Definition: detect-engine-register.h:84
DetectPatternTracker::mpm
uint32_t mpm
Definition: detect.h:734
ConfGetBool
int ConfGetBool(const char *name, int *val)
Retrieve a configuration value as a boolean.
Definition: conf.c:482
DetectListToHumanString
const char * DetectListToHumanString(int list)
Definition: detect-parse.c:160
DetectEngineCtx_::pattern_hash_table
HashListTable * pattern_hash_table
Definition: detect.h:877
DumpPatterns
void DumpPatterns(DetectEngineCtx *de_ctx)
Definition: detect-engine-analyzer.c:1313
unlikely
#define unlikely(expr)
Definition: util-optimize.h:35
DetectContentData_::within
int32_t within
Definition: detect-content.h:109
DETECT_BYTEJUMP_LITTLE
#define DETECT_BYTEJUMP_LITTLE
Definition: detect-bytejump.h:35
SetupEngineAnalysis
void SetupEngineAnalysis(DetectEngineCtx *de_ctx, bool *fp_analysis, bool *rule_analysis)
Definition: detect-engine-analyzer.c:474
DETECT_CONTENT
@ DETECT_CONTENT
Definition: detect-engine-register.h:70
SignatureInitData_::prefilter_sm
SigMatch * prefilter_sm
Definition: detect.h:567
EngineAnalysisCtx_::rule_engine_analysis_fp
FILE * rule_engine_analysis_fp
Definition: detect-engine-analyzer.c:84
DETECT_FLOW
@ DETECT_FLOW
Definition: detect-engine-register.h:54
Signature_::alproto
AppProto alproto
Definition: detect.h:606
RuleAnalyzer::js_warnings
JsonBuilder * js_warnings
Definition: detect-engine-analyzer.c:635
DETECT_BYTETEST_BASE_HEX
#define DETECT_BYTETEST_BASE_HEX
Definition: detect-bytetest.h:40
SigMatchData_::is_last
bool is_last
Definition: detect.h:360
g_rules_analyzer_write_m
SCMutex g_rules_analyzer_write_m
Definition: detect-engine-analyzer.c:961
DetectEngineAnalyzerItems::display_name
const char * display_name
Definition: detect-engine-analyzer.c:66
DETECT_CONTENT_WITHIN2DEPTH
#define DETECT_CONTENT_WITHIN2DEPTH
Definition: detect-content.h:62
EngineAnalysisCtx_::percent_re
pcre2_code * percent_re
Definition: detect-engine-analyzer.c:89
DETECT_SM_LIST_DYNAMIC_START
@ DETECT_SM_LIST_DYNAMIC_START
Definition: detect.h:135
DETECT_FLOWBITS_CMD_ISNOTSET
#define DETECT_FLOWBITS_CMD_ISNOTSET
Definition: detect-flowbits.h:31
SIG_FLAG_DEST_IS_TARGET
#define SIG_FLAG_DEST_IS_TARGET
Definition: detect.h:281
SigMatchData_::ctx
SigMatchCtx * ctx
Definition: detect.h:361
DETECT_CONTENT_NO_DOUBLE_INSPECTION_REQUIRED
#define DETECT_CONTENT_NO_DOUBLE_INSPECTION_REQUIRED
Definition: detect-content.h:55
action-globals.h
ConfGetNode
ConfNode * ConfGetNode(const char *name)
Get a ConfNode by name.
Definition: conf.c:181
EngineAnalysisCtx_
Definition: detect-engine-analyzer.c:82
DETECT_IPOPTS
@ DETECT_IPOPTS
Definition: detect-engine-register.h:39
AppProtoToString
const char * AppProtoToString(AppProto alproto)
Maps the ALPROTO_*, to its string equivalent.
Definition: app-layer-protos.c:75
ctx
struct Thresholds ctx
DETECT_BYTEJUMP_BASE_OCT
#define DETECT_BYTEJUMP_BASE_OCT
Definition: detect-bytejump.h:29
DetectEngineFrameInspectionEngine::transforms
const DetectEngineTransforms * transforms
Definition: detect.h:521
DetectFlowData_::flags
uint16_t flags
Definition: detect-flow.h:38
DetectEngineCtx_
main detection engine ctx
Definition: detect.h:841
DETECT_PROTO_ANY
#define DETECT_PROTO_ANY
Definition: detect-engine-proto.h:28
DetectEnginePktInspectionEngine::smd
SigMatchData * smd
Definition: detect.h:487
SIG_TYPE_PKT_STREAM
@ SIG_TYPE_PKT_STREAM
Definition: detect.h:71
DetectFlowbitsData_::cmd
uint8_t cmd
Definition: detect-flowbits.h:37
DetectEngineFrameInspectionEngine::mpm
bool mpm
Definition: detect.h:515
DETECT_BYTETEST_DCE
#define DETECT_BYTETEST_DCE
Definition: detect-bytetest.h:47
HashListTableGetListHead
HashListTableBucket * HashListTableGetListHead(HashListTable *ht)
Definition: util-hashlist.c:287
detect-tcp-seq.h
DetectEngineAppInspectionEngine_::v2
struct DetectEngineAppInspectionEngine_::@79 v2
EngineAnalysisCtx_::fp_pattern_stats
FpPatternStats fp_pattern_stats[DETECT_SM_LIST_MAX]
Definition: detect-engine-analyzer.c:101
DetectEngineBufferTypeGetNameById
const char * DetectEngineBufferTypeGetNameById(const DetectEngineCtx *de_ctx, const int id)
Definition: detect-engine.c:1123
SIG_FLAG_DST_ANY
#define SIG_FLAG_DST_ANY
Definition: detect.h:239
SCMutexLock
#define SCMutexLock(mut)
Definition: threads-debug.h:117
util-var-name.h
SIG_FLAG_REQUIRE_STREAM
#define SIG_FLAG_REQUIRE_STREAM
Definition: detect.h:251
DetectPatternTracker::cnt
uint32_t cnt
Definition: detect.h:733
rust.h
EngineAnalysisCtx_::fp_engine_analysis_fp
FILE * fp_engine_analysis_fp
Definition: detect-engine-analyzer.c:85
EngineAnalysisCtx_::analyzer_initialized
bool analyzer_initialized
Definition: detect-engine-analyzer.c:108
DetectEngineAnalyzerItems
Definition: detect-engine-analyzer.c:60
DETECT_BYTEJUMP_DCE
#define DETECT_BYTEJUMP_DCE
Definition: detect-bytejump.h:40
DetectPatternTracker::cd
const struct DetectContentData_ * cd
Definition: detect.h:731
VarNameStoreSetupLookup
const char * VarNameStoreSetupLookup(const uint32_t id, const enum VarTypes type)
Definition: util-var-name.c:188
SCMUTEX_INITIALIZER
#define SCMUTEX_INITIALIZER
Definition: threads-debug.h:121
Signature_::sm_arrays
SigMatchData * sm_arrays[DETECT_SM_LIST_MAX]
Definition: detect.h:654
FpPatternStats_::max
uint16_t max
Definition: detect-engine-analyzer.c:71
SignatureInitData_::init_flags
uint32_t init_flags
Definition: detect.h:553
DetectBufferType_
Definition: detect.h:454
DETECT_FLOWBITS_CMD_TOGGLE
#define DETECT_FLOWBITS_CMD_TOGGLE
Definition: detect-flowbits.h:29
DetectContentData_
Definition: detect-content.h:93
DETECT_FLOWBITS_CMD_ISSET
#define DETECT_FLOWBITS_CMD_ISSET
Definition: detect-flowbits.h:32
DetectPcreData_::flags
uint16_t flags
Definition: detect-pcre.h:46
DetectContentData_::fp_chop_offset
uint16_t fp_chop_offset
Definition: detect-content.h:100
DetectBytetestData_::nbytes
uint8_t nbytes
Definition: detect-bytetest.h:54
DetectBytetestData_
Definition: detect-bytetest.h:53
EngineAnalysisCtx_::analyzer_item_map
int16_t analyzer_item_map[256]
Definition: detect-engine-analyzer.c:100
DetectWindowData_
Definition: detect-tcp-window.h:21
SIG_FLAG_TOCLIENT
#define SIG_FLAG_TOCLIENT
Definition: detect.h:268
DETECT_BYTEJUMP_BIG
#define DETECT_BYTEJUMP_BIG
Definition: detect-bytejump.h:36
SIG_FLAG_SRC_ANY
#define SIG_FLAG_SRC_ANY
Definition: detect.h:238
SigMatchData_
Data needed for Match()
Definition: detect.h:358
DetectBytejumpData_::base
uint8_t base
Definition: detect-bytejump.h:48
detect-pcre.h
SIG_TYPE_APPLAYER
@ SIG_TYPE_APPLAYER
Definition: detect.h:74
SigMatchData_::type
uint16_t type
Definition: detect.h:359
DetectBytejumpData_
Definition: detect-bytejump.h:46
Signature_::frame_inspect
DetectEngineFrameInspectionEngine * frame_inspect
Definition: detect.h:650
DetectBytejumpData_::offset
int32_t offset
Definition: detect-bytejump.h:50
DetectEnginePktInspectionEngine::transforms
const DetectEngineTransforms * transforms
Definition: detect.h:495
ConfValIsTrue
int ConfValIsTrue(const char *val)
Check if a value is true.
Definition: conf.c:536
EngineAnalysisCtx_::analyzer_items
DetectEngineAnalyzerItems * analyzer_items
Definition: detect-engine-analyzer.c:87
DETECT_PERCENT_ENCODING_REGEX
#define DETECT_PERCENT_ENCODING_REGEX
DetectBytejumpData_::multiplier
uint16_t multiplier
Definition: detect-bytejump.h:52
SIG_FLAG_APPLAYER
#define SIG_FLAG_APPLAYER
Definition: detect.h:246
DetectBufferTypeGetByName
int DetectBufferTypeGetByName(const char *name)
Definition: detect-engine.c:1093
Signature_::gid
uint32_t gid
Definition: detect.h:637
DetectEngineAppInspectionEngine_::sm_list
uint16_t sm_list
Definition: detect.h:435
ATTR_FMT_PRINTF
#define ATTR_FMT_PRINTF(x, y)
Definition: suricata-common.h:410
DetectFlowbitsData_
Definition: detect-flowbits.h:35
HashListTableGetListNext
#define HashListTableGetListNext(hb)
Definition: util-hashlist.h:55
DetectEngineAnalyzerItems::export_item_seen
bool export_item_seen
Definition: detect-engine-analyzer.c:63
SIG_FLAG_TOSERVER
#define SIG_FLAG_TOSERVER
Definition: detect.h:267
RequiresFeature
bool RequiresFeature(const char *feature_name)
Definition: feature.c:126
DETECT_BYTETEST_RELATIVE
#define DETECT_BYTETEST_RELATIVE
Definition: detect-bytetest.h:46
SIG_TYPE_PKT
@ SIG_TYPE_PKT
Definition: detect.h:70
DetectSeqData_
seq data
Definition: detect-tcp-seq.h:30
feature.h
IpOptsFlagToString
const char * IpOptsFlagToString(uint16_t flag)
Return human readable value for ipopts flag.
Definition: detect-ipopts.c:117
EngineAnalysisCtx
struct EngineAnalysisCtx_ EngineAnalysisCtx
DETECT_CONTENT_ENDS_WITH
#define DETECT_CONTENT_ENDS_WITH
Definition: detect-content.h:42
DETECT_PCRE_RAWBYTES
#define DETECT_PCRE_RAWBYTES
Definition: detect-pcre.h:31
DETECT_CONTENT_DISTANCE
#define DETECT_CONTENT_DISTANCE
Definition: detect-content.h:30
de_ctx
DetectEngineCtx * de_ctx
Definition: fuzz_siginit.c:17
DetectEnginePktInspectionEngine::sm_list
uint16_t sm_list
Definition: detect.h:489
SIG_FLAG_INIT_BIDIREC
#define SIG_FLAG_INIT_BIDIREC
Definition: detect.h:289
DETECT_FLOWINT
@ DETECT_FLOWINT
Definition: detect-engine-register.h:63
SIG_MASK_REQUIRE_ENGINE_EVENT
#define SIG_MASK_REQUIRE_ENGINE_EVENT
Definition: detect.h:308
DETECT_FLOW_AGE
@ DETECT_FLOW_AGE
Definition: detect-engine-register.h:126
DETECT_BYTETEST_BASE_UNSET
#define DETECT_BYTETEST_BASE_UNSET
Definition: detect-bytetest.h:37
SIG_TYPE_IPONLY
@ SIG_TYPE_IPONLY
Definition: detect.h:64
DETECT_BYTEJUMP_ALIGN
#define DETECT_BYTEJUMP_ALIGN
Definition: detect-bytejump.h:39
SignatureInitData_::mpm_sm
SigMatch * mpm_sm
Definition: detect.h:565
DetectEngineBufferTypeGetDescriptionById
const char * DetectEngineBufferTypeGetDescriptionById(const DetectEngineCtx *de_ctx, const int id)
Definition: detect-engine.c:1201
SCMutexUnlock
#define SCMutexUnlock(mut)
Definition: threads-debug.h:119
SIG_FLAG_FLUSH
#define SIG_FLAG_FLUSH
Definition: detect.h:255
DetectIpOptsData_::ipopt
uint16_t ipopt
Definition: detect-ipopts.h:38
SignatureInitData_::mpm_sm_list
int mpm_sm_list
Definition: detect.h:563
DETECT_BYTETEST_BASE_DEC
#define DETECT_BYTETEST_BASE_DEC
Definition: detect-bytetest.h:39
SIG_MASK_REQUIRE_FLOW
#define SIG_MASK_REQUIRE_FLOW
Definition: detect.h:302
SIG_FLAG_BYPASS
#define SIG_FLAG_BYPASS
Definition: detect.h:272
DETECT_CONTENT_DEPTH
#define DETECT_CONTENT_DEPTH
Definition: detect-content.h:33
DETECT_CONTENT_DISTANCE2OFFSET
#define DETECT_CONTENT_DISTANCE2OFFSET
Definition: detect-content.h:63
RuleAnalyzer
Definition: detect-engine-analyzer.c:632
DETECT_BYTEJUMP_END
#define DETECT_BYTEJUMP_END
Definition: detect-bytejump.h:42
Signature_::pkt_inspect
DetectEnginePktInspectionEngine * pkt_inspect
Definition: detect.h:649
DetectEngineAnalyzerItems
struct DetectEngineAnalyzerItems DetectEngineAnalyzerItems
util-print.h
DetectWindowData_::negated
uint8_t negated
Definition: detect-tcp-window.h:22
SCEnter
#define SCEnter(...)
Definition: util-debug.h:271
detect-engine-mpm.h
detect.h
SIG_MASK_REQUIRE_FLAGS_INITDEINIT
#define SIG_MASK_REQUIRE_FLAGS_INITDEINIT
Definition: detect.h:303
DetectEngineFrameInspectionEngine::sm_list
uint16_t sm_list
Definition: detect.h:516
detect-tcp-window.h
SigMatch_::next
struct SigMatch_ * next
Definition: detect.h:353
DetectEngineAnalyzerItems::item_seen
bool item_seen
Definition: detect-engine-analyzer.c:62
DETECT_CONTENT_NEGATED
#define DETECT_CONTENT_NEGATED
Definition: detect-content.h:40
util-time.h
DETECT_ICMP_ID
@ DETECT_ICMP_ID
Definition: detect-engine-register.h:49
DETECT_SM_LIST_MATCH
@ DETECT_SM_LIST_MATCH
Definition: detect.h:114
DetectAckData_::ack
uint32_t ack
Definition: detect-tcp-ack.h:31
EngineAnalysisRules
void EngineAnalysisRules(const DetectEngineCtx *de_ctx, const Signature *s, const char *line)
Prints analysis of loaded rules.
Definition: detect-engine-analyzer.c:1454
Signature_::app_inspect
DetectEngineAppInspectionEngine * app_inspect
Definition: detect.h:648
DETECT_SEQ
@ DETECT_SEQ
Definition: detect-engine-register.h:37
SigMatch_::ctx
SigMatchCtx * ctx
Definition: detect.h:352
DETECT_ACK
@ DETECT_ACK
Definition: detect-engine-register.h:36
SIG_FLAG_REQUIRE_FLOWVAR
#define SIG_FLAG_REQUIRE_FLOWVAR
Definition: detect.h:263
Signature_::action
uint8_t action
Definition: detect.h:616
FpPatternStats_::cnt
uint32_t cnt
Definition: detect-engine-analyzer.c:72
SCReturn
#define SCReturn
Definition: util-debug.h:273
Signature_::flags
uint32_t flags
Definition: detect.h:602
DetectContentData_::depth
uint16_t depth
Definition: detect-content.h:106
ACTION_ALERT
#define ACTION_ALERT
Definition: action-globals.h:29
DETECT_BYTETEST_BIG
#define DETECT_BYTETEST_BIG
Definition: detect-bytetest.h:44
SCLocalTime
struct tm * SCLocalTime(time_t timep, struct tm *result)
Definition: util-time.c:267
detect-bytejump.h
conf.h
DetectContentData_::flags
uint32_t flags
Definition: detect-content.h:104
CHECK
#define CHECK(pat)
Definition: detect-engine-analyzer.c:669
DetectEngineFrameInspectionEngine
Definition: detect.h:511
DetectFlowbitsData_::idx
uint32_t idx
Definition: detect-flowbits.h:36
DetectEngineBufferTypeGetById
const DetectBufferType * DetectEngineBufferTypeGetById(const DetectEngineCtx *de_ctx, const int id)
Definition: detect-engine.c:1113
DETECT_BYTEJUMP_BASE_UNSET
#define DETECT_BYTEJUMP_BASE_UNSET
Definition: detect-bytejump.h:28
Signature_::init_data
SignatureInitData * init_data
Definition: detect.h:670
SIG_FLAG_SRC_IS_TARGET
#define SIG_FLAG_SRC_IS_TARGET
Definition: detect.h:279
DetectContentPatternPrettyPrint
void DetectContentPatternPrettyPrint(const DetectContentData *cd, char *str, size_t str_len)
Definition: detect-content.c:763
DetectIcmpIdData_::id
uint16_t id
Definition: detect-icmp-id.h:28
DetectEngineTransforms::transforms
TransformData transforms[DETECT_TRANSFORMS_MAX]
Definition: detect.h:409
DETECT_BYTEJUMP_BASE_HEX
#define DETECT_BYTEJUMP_BASE_HEX
Definition: detect-bytejump.h:31
SIG_TYPE_DEONLY
@ SIG_TYPE_DEONLY
Definition: detect.h:69
detect-flowbits.h
SIG_MASK_REQUIRE_PAYLOAD
#define SIG_MASK_REQUIRE_PAYLOAD
Definition: detect.h:301
SCLogInfo
#define SCLogInfo(...)
Macro used to log INFORMATIONAL messages.
Definition: util-debug.h:224
DETECT_PCRE
@ DETECT_PCRE
Definition: detect-engine-register.h:72
DetectWindowData_::size
uint16_t size
Definition: detect-tcp-window.h:23
SIG_TYPE_NOT_SET
@ SIG_TYPE_NOT_SET
Definition: detect.h:63
ExposedItemSeen::bufname
const char * bufname
Definition: detect-engine-analyzer.c:78
EngineAnalysisRulesFailure
void EngineAnalysisRulesFailure(const DetectEngineCtx *de_ctx, char *line, char *file, int lineno)
Definition: detect-engine-analyzer.c:622
DETECT_BYTEJUMP_OFFSET_BE
#define DETECT_BYTEJUMP_OFFSET_BE
Definition: detect-bytejump.h:41
DetectEngineCtx_::config_prefix
char config_prefix[64]
Definition: detect.h:960
DetectSigmatchListEnumToString
const char * DetectSigmatchListEnumToString(enum DetectSigmatchListEnum type)
Definition: detect-engine.c:4944
analyzer_items
const DetectEngineAnalyzerItems analyzer_items[]
Definition: detect-engine-analyzer.c:111
DetectEngineAppInspectionEngine_::alproto
AppProto alproto
Definition: detect.h:430
SIG_FLAG_MPM_NEG
#define SIG_FLAG_MPM_NEG
Definition: detect.h:253
detect-engine-analyzer.h
SIG_FLAG_INIT_STATE_MATCH
#define SIG_FLAG_INIT_STATE_MATCH
Definition: detect.h:292
DetectEngineAnalyzerItems::item_id
int16_t item_id
Definition: detect-engine-analyzer.c:61
DetectPatternTracker::sm_list
int sm_list
Definition: detect.h:732
DetectEngineAppInspectionEngine_::smd
SigMatchData * smd
Definition: detect.h:449
EngineAnalysisRules2
void EngineAnalysisRules2(const DetectEngineCtx *de_ctx, const Signature *s)
Definition: detect-engine-analyzer.c:962
ARRAY_SIZE
#define ARRAY_SIZE(arr)
Definition: suricata-common.h:545
DETECT_CONTENT_STARTS_WITH
#define DETECT_CONTENT_STARTS_WITH
Definition: detect-content.h:59
DetectProto_::flags
uint8_t flags
Definition: detect-engine-proto.h:37
DETECT_BYTETEST
@ DETECT_BYTETEST
Definition: detect-engine-register.h:83
DETECT_PROTO_IPV4
#define DETECT_PROTO_IPV4
Definition: detect-engine-proto.h:31
util-conf.h
SignatureHasStreamContent
int SignatureHasStreamContent(const Signature *s)
check if a signature has patterns that are to be inspected against the stream payload (as opposed to ...
Definition: detect-engine-mpm.c:826
RuleAnalyzer::js_notes
JsonBuilder * js_notes
Definition: detect-engine-analyzer.c:636
EngineAnalysisFP
void EngineAnalysisFP(const DetectEngineCtx *de_ctx, const Signature *s, char *line)
Definition: detect-engine-analyzer.c:168
FpPatternStats_::min
uint16_t min
Definition: detect-engine-analyzer.c:70
VAR_TYPE_FLOW_BIT
@ VAR_TYPE_FLOW_BIT
Definition: util-var.h:36
Signature_::proto
DetectProto proto
Definition: detect.h:620
SCNtohs
#define SCNtohs(x)
Definition: suricata-common.h:414
suricata-common.h
SIG_MASK_REQUIRE_NO_PAYLOAD
#define SIG_MASK_REQUIRE_NO_PAYLOAD
Definition: detect.h:305
SIG_FLAG_SP_ANY
#define SIG_FLAG_SP_ANY
Definition: detect.h:240
ExposedItemSeen
Definition: detect-engine-analyzer.c:77
SigMatch_::type
uint16_t type
Definition: detect.h:350
HashListTableFree
void HashListTableFree(HashListTable *ht)
Definition: util-hashlist.c:88
DetectEngineAnalyzerItems::check_encoding_match
bool check_encoding_match
Definition: detect-engine-analyzer.c:64
DetectContentData_::distance
int32_t distance
Definition: detect-content.h:108
CleanupEngineAnalysis
void CleanupEngineAnalysis(DetectEngineCtx *de_ctx)
Definition: detect-engine-analyzer.c:510
DetectBytejumpData_::nbytes
uint8_t nbytes
Definition: detect-bytejump.h:47
ALPROTO_HTTP1
@ ALPROTO_HTTP1
Definition: app-layer-protos.h:30
DetectEngineFrameInspectionEngine::next
struct DetectEngineFrameInspectionEngine * next
Definition: detect.h:524
DetectU32Data
DetectUintData_u32 DetectU32Data
Definition: detect-engine-uint.h:41
DetectEnginePktInspectionEngine::next
struct DetectEnginePktInspectionEngine * next
Definition: detect.h:497
DetectContentData_::content
uint8_t * content
Definition: detect-content.h:94
Signature_::rev
uint32_t rev
Definition: detect.h:638
DetectEngineFrameInspectionEngine::v1
struct DetectEngineFrameInspectionEngine::@83 v1
FatalError
#define FatalError(...)
Definition: util-debug.h:502
DETECT_BYTEJUMP_BASE_DEC
#define DETECT_BYTEJUMP_BASE_DEC
Definition: detect-bytejump.h:30
DetectIpOptsData_
Definition: detect-ipopts.h:37
SIG_MASK_REQUIRE_FLAGS_UNUSUAL
#define SIG_MASK_REQUIRE_FLAGS_UNUSUAL
Definition: detect.h:304
TransformData_::transform
int transform
Definition: detect.h:404
DETECT_FLOWBITS
@ DETECT_FLOWBITS
Definition: detect-engine-register.h:60
SIG_TYPE_MAX
@ SIG_TYPE_MAX
Definition: detect.h:77
DetectEngineCtx_::ea
struct EngineAnalysisCtx_ * ea
Definition: detect.h:1038
DetectEngineAppInspectionEngine_::progress
int16_t progress
Definition: detect.h:437
DETECT_BYTETEST_BASE_OCT
#define DETECT_BYTETEST_BASE_OCT
Definition: detect-bytetest.h:38
util-validate.h
detect-flow.h
PrintRawUriFp
void PrintRawUriFp(FILE *fp, uint8_t *buf, uint32_t buflen)
Definition: util-print.c:69
SCMalloc
#define SCMalloc(sz)
Definition: util-mem.h:47
ConfigGetLogDirectory
const char * ConfigGetLogDirectory(void)
Definition: util-conf.c:38
FpPatternStats
struct FpPatternStats_ FpPatternStats
detect-tcp-ack.h
str
#define str(s)
Definition: suricata-common.h:291
SCLogError
#define SCLogError(...)
Macro used to log ERROR messages.
Definition: util-debug.h:261
SigMatchListSMBelongsTo
int SigMatchListSMBelongsTo(const Signature *s, const SigMatch *key_sm)
Definition: detect-parse.c:805
SCFree
#define SCFree(p)
Definition: util-mem.h:61
DetectFlowbitsData_::or_list
uint32_t * or_list
Definition: detect-flowbits.h:39
ConfNode_
Definition: conf.h:32
Signature_::id
uint32_t id
Definition: detect.h:636
DETECT_CONTENT_OFFSET
#define DETECT_CONTENT_OFFSET
Definition: detect-content.h:32
HashListTableBucket_
Definition: util-hashlist.h:28
DETECT_FLOWBITS_CMD_UNSET
#define DETECT_FLOWBITS_CMD_UNSET
Definition: detect-flowbits.h:30
DETECT_CONTENT_FAST_PATTERN_ONLY
#define DETECT_CONTENT_FAST_PATTERN_ONLY
Definition: detect-content.h:35
DETECT_CONTENT_MPM
#define DETECT_CONTENT_MPM
Definition: detect-content.h:61
DetectBufferType_::transforms
DetectEngineTransforms transforms
Definition: detect.h:466
DetectEnginePktInspectionEngine::v1
struct DetectEnginePktInspectionEngine::@82 v1
detect-parse.h
Signature_
Signature container.
Definition: detect.h:601
SigMatch_
a single match condition for a signature
Definition: detect.h:349
DetectEngineAppInspectionEngine_::transforms
const DetectEngineTransforms * transforms
Definition: detect.h:446
DETECT_SM_LIST_MAX
@ DETECT_SM_LIST_MAX
Definition: detect.h:132
FpPatternStats_::tot
uint64_t tot
Definition: detect-engine-analyzer.c:73
DETECT_BYTETEST_STRING
#define DETECT_BYTETEST_STRING
Definition: detect-bytetest.h:45
DetectBytetestData_::offset
int32_t offset
Definition: detect-bytetest.h:60
DetectFlagsData_
Definition: detect-tcp-flags.h:37
ALPROTO_UNKNOWN
@ ALPROTO_UNKNOWN
Definition: app-layer-protos.h:29
DETECT_PCRE_RELATIVE_NEXT
#define DETECT_PCRE_RELATIVE_NEXT
Definition: detect-pcre.h:34
detect-icmp-id.h
detect-ipopts.h
DetectEngineTransforms::cnt
int cnt
Definition: detect.h:410
suricata.h
DetectPcreData_
Definition: detect-pcre.h:42
DetectEngineAppInspectionEngine_::dir
uint8_t dir
Definition: detect.h:431
DetectEngineAnalyzerItems::item_name
const char * item_name
Definition: detect-engine-analyzer.c:65
DetectContentData_::content_len
uint16_t content_len
Definition: detect-content.h:95
ExposedItemSeen::item_seen_ptr
bool * item_seen_ptr
Definition: detect-engine-analyzer.c:79
DETECT_BYTEJUMP_STRING
#define DETECT_BYTEJUMP_STRING
Definition: detect-bytejump.h:37
DetectEngineCtx_::buffer_type_id
uint32_t buffer_type_id
Definition: detect.h:990
EngineAnalysisCtx_::file_prefix
char * file_prefix
Definition: detect-engine-analyzer.c:88
DetectEnginePktInspectionEngine::mpm
bool mpm
Definition: detect.h:488
DETECT_BYTEJUMP_BEGIN
#define DETECT_BYTEJUMP_BEGIN
Definition: detect-bytejump.h:34
DETECT_PCRE_RELATIVE
#define DETECT_PCRE_RELATIVE
Definition: detect-pcre.h:29
RuleAnalyzer
struct RuleAnalyzer RuleAnalyzer
DETECT_WINDOW
@ DETECT_WINDOW
Definition: detect-engine-register.h:38
SIG_FLAG_TLSSTORE
#define SIG_FLAG_TLSSTORE
Definition: detect.h:270
DetectU16Data
DetectUintData_u16 DetectU16Data
Definition: detect-engine-uint.h:42
Signature_::msg
char * msg
Definition: detect.h:659
DETECT_CONTENT_FAST_PATTERN
#define DETECT_CONTENT_FAST_PATTERN
Definition: detect-content.h:34
SCCalloc
#define SCCalloc(nm, sz)
Definition: util-mem.h:53
DETECT_FLAGS
@ DETECT_FLAGS
Definition: detect-engine-register.h:42
DETECT_PCRE_NEGATE
#define DETECT_PCRE_NEGATE
Definition: detect-pcre.h:35
EngineAnalysisCtx_::exposed_item_seen_list
struct ExposedItemSeen exposed_item_seen_list[2]
Definition: detect-engine-analyzer.c:106
Signature_::type
enum SignatureType type
Definition: detect.h:604
FpPatternStats_
Definition: detect-engine-analyzer.c:69
DetectBytetestData_::base
uint8_t base
Definition: detect-bytetest.h:56
DETECT_BYTETEST_LITTLE
#define DETECT_BYTETEST_LITTLE
Definition: detect-bytetest.h:43
SCMutex
#define SCMutex
Definition: threads-debug.h:114
SIG_TYPE_PDONLY
@ SIG_TYPE_PDONLY
Definition: detect.h:68
DEBUG_VALIDATE_BUG_ON
#define DEBUG_VALIDATE_BUG_ON(exp)
Definition: util-validate.h:102
SIG_FLAG_PREFILTER
#define SIG_FLAG_PREFILTER
Definition: detect.h:274
DETECT_TCPMSS
@ DETECT_TCPMSS
Definition: detect-engine-register.h:291
DetectAckData_
ack data
Definition: detect-tcp-ack.h:30
SIG_FLAG_FILESTORE
#define SIG_FLAG_FILESTORE
Definition: detect.h:265
DETECT_CONTENT_WITHIN
#define DETECT_CONTENT_WITHIN
Definition: detect-content.h:31
DETECT_BYTEJUMP_RELATIVE
#define DETECT_BYTEJUMP_RELATIVE
Definition: detect-bytejump.h:38
SIG_FLAG_DP_ANY
#define SIG_FLAG_DP_ANY
Definition: detect.h:241
DETECT_FLOWBITS_CMD_SET
#define DETECT_FLOWBITS_CMD_SET
Definition: detect-flowbits.h:28
SIG_FLAG_DSIZE
#define SIG_FLAG_DSIZE
Definition: detect.h:245
DetectBytejumpData_::flags
uint16_t flags
Definition: detect-bytejump.h:49
Signature_::mask
SignatureMask mask
Definition: detect.h:612
SIG_TYPE_LIKE_IPONLY
@ SIG_TYPE_LIKE_IPONLY
Definition: detect.h:65
detect-bytetest.h
DetectProtoContainsProto
int DetectProtoContainsProto(const DetectProto *dp, int proto)
see if a DetectProto contains a certain proto
Definition: detect-engine-proto.c:135
SIG_FLAG_REQUIRE_PACKET
#define SIG_FLAG_REQUIRE_PACKET
Definition: detect.h:250
DetectEngineFrameInspectionEngine::smd
SigMatchData * smd
Definition: detect.h:523
ConfNodeLookupChildValue
const char * ConfNodeLookupChildValue(const ConfNode *node, const char *name)
Lookup the value of a child configuration node by name.
Definition: conf.c:809