Skip to content

Commit

Permalink
[DOCS] Update runs syntax (#78922)
Browse files Browse the repository at this point in the history
Updates the EQL syntax docs for PR #78895.
  • Loading branch information
jrodewig authored Oct 11, 2021
1 parent 11840f0 commit e7ab7c8
Showing 1 changed file with 8 additions and 9 deletions.
17 changes: 8 additions & 9 deletions docs/reference/eql/syntax.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -695,17 +695,17 @@ until [ process where event.type == "stop" ]
====

[discrete]
[[eql-runs-keyword]]
=== `runs` keyword
[[eql-with-runs-statement]]
=== `with runs` statement

Use a `runs` statement to run the same event criteria successively within a
Use a `with runs` statement to run the same event criteria successively within a
sequence query. For example:

[source,eql]
----
sequence
[ process where event.type == "creation" ]
[ library where process.name == "regsvr32.exe" ] [runs=3]
[ library where process.name == "regsvr32.exe" ] with runs=3
[ registry where true ]
----

Expand All @@ -721,17 +721,16 @@ sequence
[ registry where true ]
----

A `runs` statement must be enclosed in square brackets (`[ ]`). The `runs` value
must be between `1` and `100` (inclusive).
The `runs` value must be between `1` and `100` (inclusive).

You can use a `runs` statement with the <<eql-by-keyword,`by` keyword>>. For
example:
You can use a `with runs` statement with the <<eql-by-keyword,`by` keyword>>.
For example:

[source,eql]
----
sequence
[ process where event.type == "creation" ] by process.executable
[ library where process.name == "regsvr32.exe" ] by dll.path [runs=3]
[ library where process.name == "regsvr32.exe" ] by dll.path with runs=3
----

[discrete]
Expand Down

0 comments on commit e7ab7c8

Please sign in to comment.