Keyword Filtering

Each rule filter can include one or more keywords in the format:


keyword:argument

where keyword is one of the keywords in the following table and argument is a single, case-insensitive, alphanumeric string to search for in the specific field or fields relevant to the keyword.

Arguments for all keywords except gid and sid are treated as partial strings. For example, the argument 123 returns "12345", "41235", "45123", and so on. The arguments for gid and sid return only exact matches; for example, sid:3080 returns only SID 3080.

Tip

You can search for a partial SID by filtering with one or more character strings.

The following table describes the specific filtering keywords and arguments you can use to filter rules.

Rule Filter Keywords

Keyword

Description

Example


arachnids

Returns one or more rules based on all or part of the Arachnids ID in a rule reference.


arachnids:181

bugtraq

Returns one or more rules based on all or part of the Bugtraq ID in a rule reference.


bugtraq:2120

cve

Returns one or more rules based on all or part of the CVE number in a rule reference.


cve:2003-0109

gid

The argument 1 returns standard text rules. The argument 3 returns shared object rules.


gid:3

mcafee

Returns one or more rules based on all or part of the McAfee ID in a rule reference.


mcafee:10566

msg

Returns one or more rules based on all or part of the rule Message field, also known as the event message.


msg:chat

nessus

Returns one or more rules based on all or part of the Nessus ID in a rule reference.


nessus:10737

ref

Returns one or more rules based on all or part of a single alphanumeric string in a rule reference or in the rule Message field.


ref:MS03-039

sid

Returns the rule with the exact Snort ID.


sid:235

url

Returns one or more rules based on all or part of the URL in a rule reference.


url:faqs.org