Rules syntax

Rules is used in a broad sense here: let's rather call them "directives". Most directives will be rules, hence I used "Your rules" in the dashboard.

Each line is a directive. Empty lines will be skipped. The # can be used for commenting, and for each line, the parser will ignore the first occurrence of # and everything following it.

A directive starts with a directive keyword, immediately followed by the : which character is used to tell a parser that we are dealing with a directive keyword.

There are currently two directives: rule: and switch:. However, the rule: directive can be omitted, because it is implicit when there is no directive. Since most directives will be rules, it would be inconvenient to be forced to use rule: for each rule.

In the documentation below the square brackets ([]) are used to denote optional fields. Curly brackets ({}) are used to denote what should appear at a specific position.

Directive rules: syntax

[rules: {white spaces}] source hostname {white spaces} destination hostname {white spaces} [request type {white spaces} [action]]

rules: is implicit, you don't have to use it (actually, currently the parser will not work if you use it...)

White spaces can be any number of space character or tab character.

source hostname is the context from which a next request is made, also known as the "scope".

destination hostname is where the net request made.

request type is the type of the net request. If omitted, the * type is assumed. Request type * means, "any type".

action is what to do when a net request matches source hostname, destination hostname and request type. Currently, the actions supported are:

• block: the request will be prevented (often referred as "blacklisted")
• allow: the request will be allowed (often referred as "whitelisted")
• inherit: the action will be inherited from another cell in the matrix, as per cell inheritance logic. It's what is often referred as "graylisted".