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

CHANGE: Old SOA mbox format no longer a warning (#2191)

Browse Source
This commit is contained in:
Tom Limoncelli
2023-03-16 23:14:47 -04:00
committed by GitHub
parent 2796c36a55
commit 2162e19134
3 changed files with 8 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
documentation/functions/domain/SOA.md
View File

@@ -30,11 +30,13 @@ D("example.com", REG_THIRDPARTY, DnsProvider("DNS_BIND"),
```
{% endcode %}
The email address should be specified like a normal RFC822/RFC5322 address (user@hostname.com). It will be converted into the required format (e.g. BIND format: `user.hostname.com`) by the provider as required. This has the benefit of being more human-readable plus DNSControl can properly handle escaping and other issues.
If you accidentally include an `@` in the email field DNSControl will quietly
change it to a `.`. This way you can specify a human-readable email address
when you are making it easier for spammers how to find you.
## Notes
* Previously, the accepted format for the SOA mailbox field was `hostmaster.example.org`. This has been changed to `hostmaster@example.org`
* The serial number is managed automatically. It isn't even a field in `SOA()`.
* Most providers automatically generate SOA records. They will ignore any `SOA()` statements.
* The mbox field should not be set to a real email address unless you love spam and hate your privacy.
There is more info about `SOA` in the documentation for the [BIND provider](../../providers/bind.md).