mirror/stackexchange-dnscontrol
1
0
Fork 0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2024-05-11 05:55:12 +00:00
Code Issues Releases Activity

IGNORE_*: Warn about fragility (#1108)

Browse Source
This commit is contained in:
Tom Limoncelli
2021-03-28 15:17:47 -04:00
committed by GitHub
parent ef2a109207
commit 8c7ce22bf7
2 changed files with 12 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/_functions/domain/IGNORE_NAME.md
View File

@@ -1,7 +1,13 @@
--- ---
name: IGNORE_NAME name: IGNORE_NAME
parameters:
- pattern
--- ---
WARNING: The `IGNORE_*` family of functions is risky to use. The code
is brittle and has subtle bugs. Use at your own risk. Do not use these
commands with `D_EXTEND()` or use it at the domain apex.
IGNORE_NAME can be used to ignore some records present in zone. IGNORE_NAME can be used to ignore some records present in zone.
All records (independently of their type) of that name will be completely ignored. All records (independently of their type) of that name will be completely ignored.
@@ -37,4 +43,4 @@ not match `.`
* `IGNORE_NAME("{bar,[fz]oo}")` will ignore `bar`, `foo` and `zoo`. * `IGNORE_NAME("{bar,[fz]oo}")` will ignore `bar`, `foo` and `zoo`.
* `IGNORE_NAME("\\*.foo")` will ignore the literal record `*.foo`. * `IGNORE_NAME("\\*.foo")` will ignore the literal record `*.foo`.
It is considered as an error to try to manage an ignored record. It is considered as an error to try to manage an ignored record.

6
docs/_functions/domain/IGNORE_TARGET.md
View File

@@ -5,6 +5,10 @@ parameters:
- rType - rType
--- ---
WARNING: The `IGNORE_*` family of functions is risky to use. The code
is brittle and has subtle bugs. Use at your own risk. Do not use these
commands with `D_EXTEND()` or use it at the domain apex.
IGNORE_TARGET can be used to ignore some records present in zone based on the record's target and type. IGNORE_TARGET currently only supports CNAME record types. IGNORE_TARGET can be used to ignore some records present in zone based on the record's target and type. IGNORE_TARGET currently only supports CNAME record types.
IGNORE_TARGET is like NO_PURGE except it acts only on some specific records instead of the whole zone. IGNORE_TARGET is like NO_PURGE except it acts only on some specific records instead of the whole zone.
@@ -31,4 +35,4 @@ IGNORE_TARGET also supports glob patterns in the style of the [gobwas/glob](http
* `IGNORE_TARGET("**.bar", "CNAME")` will ignore all CNAME records with target subdomains of `bar`, including double subdomains such as `www.foo.bar`. * `IGNORE_TARGET("**.bar", "CNAME")` will ignore all CNAME records with target subdomains of `bar`, including double subdomains such as `www.foo.bar`.
* `IGNORE_TARGET("dev.*.foo", "CNAME")` will ignore all CNAME records with targets in the style of `dev.bar.foo`, but will not ignore records with targets using a double subdomain, such as `dev.foo.bar.foo`. * `IGNORE_TARGET("dev.*.foo", "CNAME")` will ignore all CNAME records with targets in the style of `dev.bar.foo`, but will not ignore records with targets using a double subdomain, such as `dev.foo.bar.foo`.
It is considered as an error to try to manage an ignored record. It is considered as an error to try to manage an ignored record.