This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
advanced-adblock [2023/08/05 17:29] – [Domain whitelist] -copy syntax details from blacklist custom. Will edit them for whitelist concepts hogwild | advanced-adblock [2023/08/13 17:03] (current) – [Domain whitelist] -formatting hogwild | ||
---|---|---|---|
Line 3: | Line 3: | ||
This menu contains settings to configure FreshTomato' | This menu contains settings to configure FreshTomato' | ||
- | In this documentation, | + | In documentation, |
===== v1 and v2 ===== | ===== v1 and v2 ===== | ||
Line 41: | Line 42: | ||
**Debug mode (v1)** | **Debug mode (v1)** | ||
- | Checking this box enables debug mode for dnsmasq in the log. This tells FreshTomato that you want all DNS queries routed to dnsmasq to be logged to the system log (syslog). This is useful when testing/ | + | Checking this box enables debug mode for dnsmasq in the log. This tells FreshTomato that you want all DNS queries routed to dnsmasq to be logged to the system log. This is useful when testing/ |
\\ | \\ | ||
Line 51: | Line 52: | ||
**Max Log Level (v2)**: | **Max Log Level (v2)**: | ||
- | Thew new v2 interface lets you set the maximum log level output the script will generate. | + | Thew newer v2 interface lets you set the maximum log level output the script will generate. |
Supported levels include: | Supported levels include: | ||
Line 70: | Line 71: | ||
\\ | \\ | ||
- | A good way to view the logs is to go to the [[status-log|Logs]] menu and enter 'adblock' | + | A good way to view Adblock log entries |
| | ||
Line 84: | Line 85: | ||
\\ | \\ | ||
- | This limit is calculated as 10% of physical RAM (when external storage is set). When no external storage is found, the limit is calculated as 6.5% of RAM. The limit can be also manually configured. However, if your device becomes unstable, | + | This limit is calculated as 10% of physical RAM (when external storage is set). When no external storage is found, the limit is calculated as 6.5% of RAM. The limit can be also manually configured. However, if your device becomes unstable, you should |
- | To be clear, this is a limit, not a target. There' | + | This is a limit, not a target. There' |
\\ | \\ | ||
Line 92: | Line 93: | ||
**Custom Path (v2):** | **Custom Path (v2):** | ||
- | An important v2 feature is the ability | + | An important v2 feature is the option |
\\ {{adblock-v2-custom_path.jpg? | \\ {{adblock-v2-custom_path.jpg? | ||
Line 98: | Line 99: | ||
\\ | \\ | ||
- | This is very useful when the script is re-run (manually or automatically) and there are no updated lists or configuration changes. The check for configuration changes involves controlling any modification to nvram variables since the last script run. | + | This is very useful when the script is re-run (manually or automatically) and there are no updated lists or configuration changes. The check for configuration changes involves controlling any modification to NVRAM variables since the last script run. |
When a custom path is defined, adblock will: | When a custom path is defined, adblock will: | ||
Line 114: | Line 115: | ||
This saves time and resources. | This saves time and resources. | ||
- | Here, configuration means any externally-mapped files where // | + | Here, "configuration" |
\\ | \\ | ||
Line 198: | Line 199: | ||
* A path to a local file where domains are defined. The file should contain one domain per line. \\ For example: "/ | * A path to a local file where domains are defined. The file should contain one domain per line. \\ For example: "/ | ||
* A domain prefixed with a " | * A domain prefixed with a " | ||
+ | |||
+ | \\ | ||
When adding custom entries: | When adding custom entries: | ||
Line 211: | Line 214: | ||
However, this may not be what you want. | However, this may not be what you want. | ||
- | To prevent subdomains of an entry from being filtered, prepend a "%" sign to an entry. | + | To prevent subdomains of an entry from being filtered, prepend a "+" sign to an entry. |
- | For example, if you enter "%sub.domain.com", | + | For example, if you enter "+sub.domain.com", |
- | Prepending a " | + | Prepending a " |
Any line starting with a "#" | Any line starting with a "#" | ||
+ | |||
+ | \\ | ||
**Sort a-z ↓** **:** Clicking this button sorts the contents of this field alphabetically. | **Sort a-z ↓** **:** Clicking this button sorts the contents of this field alphabetically. | ||
Line 230: | Line 235: | ||
\\ | \\ | ||
- | Domain whitelist can use: | + | === Syntaxes === |
- | * Standard domains (one entry per line) | + | The Domain |
- | * A path to a file of domains. For example: "/ | + | |
- | * A domain prepended with a " | + | |
- | * Blacklisting all subdomains may not be your goal. Whitelisting " | + | |
- | When adding custom entries: | + | * Standard domains (one entry per line). |
+ | * A path to a file of domains (one domain per line) . \\ For example: "/ | ||
+ | * Prepending a " | ||
- | If you blacklist: " | + | \\ |
- | " | + | When adding entries: |
- | "sub2.sub.domain.com" | + | If you whitelist: |
- | and all other subdomains will be blacklisted. | + | " |
- | However, this may not be what you want. | + | " |
- | To prevent | + | and all other subdomains |
- | For example, if you enter " | + | \\ |
- | Prepending | + | You can prevent subdomains of an entry from being whitelisted by prepending |
- | Any line starting with a "#" | + | For example, if you enter "%sub.domain.com": |
+ | " | ||
+ | " | ||
+ | Any line starting with a "#" | ||
+ | \\ **Sort a-z ↓** : Clicking this button sorts the field contents alphabetically. | ||
- | Any line starting with a “#” or “!” character is considered commented and ignored. | + | \\ |
- | + | ||
- | **Sort a-z ↓** : Clicking this button sorts the field content alphabetically. | + | |
- | + | ||
- | | + | |
=== Maintaining the Domain whitelist === | === Maintaining the Domain whitelist === |