pi-hole/docs
1
0
Fork 0
mirror of https://github.com/pi-hole/docs.git synced 2024-12-06 19:27:12 +01:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Put debugging information into overview article

Browse Source 
Signed-off-by: DL6ER <dl6er@dl6er.de>
This commit is contained in:
DL6ER
2018-07-17 19:47:47 +02:00
parent 70a4a3e3e1
commit 4407bd5352
3 changed files with 15 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/ftldns/regex/debugging.md
-16
View File
@@ -1,16 +0,0 @@
# Pi-hole Regex debugging mode
To ease the usage of regular expression filters in *FTL*DNS, we offer a regex debugging mode. Set
```
REGEX_DEBUGMODE=true
```
in your `/etc/pihole/pihole-FTL.conf` and restart `pihole-FTL` to enable or disable this mode.
Once the debugging mode is enabled, each match will be logged to `/var/log/pihole-FTL.log` in the following format:
```
[2018-07-17 17:40:51.304] DEBUG: Regex in line 2 ("((^)|(\.))twitter\.") matches "whatever.twitter.com"
```
The given line number corresponds to the line in the file `/etc/pihole/regex.list`.
Note that validation is only done on the first occurrence of a domain to increase the computational efficiency of *FTL*DNS.
{!abbreviations.md!}
docs/ftldns/regex/overview.md
+15
View File
@@ -11,4 +11,19 @@ To tell *FTL*DNS to reload the list, either:
- Send `SIGHUP` to `pihole-FTL` (`sudo killall -SIGHUP pihole-FTL`)
- Restart the service (`sudo service pihole-FTL restart`)
## Pi-hole Regex debugging mode
To ease the usage of regular expression filters in *FTL*DNS, we offer a regex debugging mode. Set
```
REGEX_DEBUGMODE=true
```
in your `/etc/pihole/pihole-FTL.conf` and restart `pihole-FTL` to enable or disable this mode.
Once the debugging mode is enabled, each match will be logged to `/var/log/pihole-FTL.log` in the following format:
```
[2018-07-17 17:40:51.304] DEBUG: Regex in line 2 ("((^)|(\.))twitter\.") matches "whatever.twitter.com"
```
The given line number corresponds to the line in the file `/etc/pihole/regex.list`.
Note that validation is only done on the first occurrence of a domain to increase the computational efficiency of *FTL*DNS.
{!abbreviations.md!}
mkdocs.yml
-1
View File
@@ -47,7 +47,6 @@ pages:
- 'RegEx blocking':
- "Overview": "ftldns/regex/overview.md"
- "Tutorial": "ftldns/regex/tutorial.md"
- "Debugging": "ftldns/regex/debugging.md"
- 'Privacy levels': "ftldns/privacylevels.md"
- 'Long-term database': "ftldns/database.md"
- 'Telnet API': "ftldns/telnet-api.md"