Merge pull request #27 from pi-hole/tweak/regex.list

Remove BLOCKINGREGEX description (replaced by regex.list)
This commit is contained in:
Mark Drobnak
2018-05-28 17:26:12 -04:00
committed by GitHub
2 changed files with 1 additions and 12 deletions
-7
View File
@@ -78,11 +78,4 @@ How should `FTL` reply to blocked queries?
**[More details](blockingmode.md)**
### BLOCKINGREGEX
`BLOCKINGREGEX=...`
If defined, `FTL` will block all incoming queries which match this RegEx.
**[More details](regex.md)**
{!abbreviations.md!}
+1 -5
View File
@@ -4,11 +4,7 @@ We implement the ERE flavor similar to the one used by the UNIX `egrep` (or `gre
Our implementation is computationally inexpensive as each domain is only checked once for a match (if you query `google.com`, it will be checked against your RegEx. Any subsequent query to the same domain will not be checked again until you restart `pihole-FTL`).
## How to use regular expressions for blocking
Add a line
```
BLOCKINGREGEX=^abc$
```
in your `/etc/pihole/pihole-FTL.conf` and restart `pihole-FTL`. **Note: this is subject to change (we plan to support a list of regular expressions for blocking in the near future).**
*FTL*DNS reads in regular expression filters from `/etc/pihole/regex.list` (one expression per line).
## Pi-hole regular expressions tutorial
We provide a short but thorough introduction to our regular expressions implementation. This may come in handy if you are designing blocking rules (see also our cheat sheet below!). In our implementation, all characters match themselves except for the following special characters: `.[{}()\*+?|^$`. If you want to match those, you need to escape them like `\.` for a literal period, but no rule without exception (see character groups below for further details).