1
0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2024-05-11 05:55:12 +00:00

DOCS: add dhcid RR docs (#2715)

This commit is contained in:
Florian Ritterhoff
2023-12-11 13:25:27 +01:00
committed by GitHub
parent 9e1cb0fefd
commit a5a1facdaf
5 changed files with 43 additions and 4 deletions

View File

@ -642,6 +642,21 @@ declare function D(name: string, registrar: string, ...modifiers: DomainModifier
*/ */
declare function DEFAULTS(...modifiers: DomainModifier[]): void; declare function DEFAULTS(...modifiers: DomainModifier[]): void;
/**
* DHCID adds a DHCID record to the domain.
*
* Digest should be a string.
*
* ```javascript
* D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
* DHCID("example.com", "ABCDEFG")
* );
* ```
*
* @see https://docs.dnscontrol.org/language-reference/domain-modifiers/dhcid
*/
declare function DHCID(name: string, digest: string, ...modifiers: RecordModifier[]): DomainModifier;
/** /**
* `DISABLE_IGNORE_SAFETY_CHECK()` disables the safety check. Normally it is an * `DISABLE_IGNORE_SAFETY_CHECK()` disables the safety check. Normally it is an
* error to insert records that match an `IGNORE()` pattern. This disables that * error to insert records that match an `IGNORE()` pattern. This disables that

View File

@ -37,6 +37,7 @@
* [CAA](functions/domain/CAA.md) * [CAA](functions/domain/CAA.md)
* [CAA_BUILDER](functions/domain/CAA_BUILDER.md) * [CAA_BUILDER](functions/domain/CAA_BUILDER.md)
* [CNAME](functions/domain/CNAME.md) * [CNAME](functions/domain/CNAME.md)
* [DHCID](functions/domain/DHCID.md)
* [DISABLE_IGNORE_SAFETY_CHECK](functions/domain/DISABLE_IGNORE_SAFETY_CHECK.md) * [DISABLE_IGNORE_SAFETY_CHECK](functions/domain/DISABLE_IGNORE_SAFETY_CHECK.md)
* [DMARC_BUILDER](functions/domain/DMARC_BUILDER.md) * [DMARC_BUILDER](functions/domain/DMARC_BUILDER.md)
* [DS](functions/domain/DS.md) * [DS](functions/domain/DS.md)

View File

@ -0,0 +1,23 @@
---
name: DHCID
parameters:
- name
- digest
- modifiers...
parameter_types:
name: string
digest: string
"modifiers...": RecordModifier[]
---
DHCID adds a DHCID record to the domain.
Digest should be a string.
{% code title="dnsconfig.js" %}
```javascript
D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
DHCID("example.com", "ABCDEFG")
);
```
{% endcode %}

View File

@ -1539,10 +1539,10 @@ func makeTests(t *testing.T) []*TestGroup {
// ns("another-child", "ns101.cloudns.net."), // ns("another-child", "ns101.cloudns.net."),
//), //),
), ),
testgroup("DHCPID", testgroup("DHCID",
requires(providers.CanUseDHCID), requires(providers.CanUseDHCID),
tc("Create DHCPID record", dhcid("test", "AAIBY2/AuCccgoJbsaxcQc9TUapptP69lOjxfNuVAA2kjEA=")), tc("Create DHCID record", dhcid("test", "AAIBY2/AuCccgoJbsaxcQc9TUapptP69lOjxfNuVAA2kjEA=")),
tc("Modify DHCPID record", dhcid("test", "Test/AuCccgoJbsaxcQc9TUapptP69lOjxfNuVAA2kjEA=")), tc("Modify DHCID record", dhcid("test", "Test/AuCccgoJbsaxcQc9TUapptP69lOjxfNuVAA2kjEA=")),
), ),
//// Vendor-specific record types //// Vendor-specific record types

View File

@ -133,7 +133,7 @@ func (dc *DomainConfig) Punycode() error {
rec.SetTarget(t) rec.SetTarget(t)
case "CF_REDIRECT", "CF_TEMP_REDIRECT", "CF_WORKER_ROUTE": case "CF_REDIRECT", "CF_TEMP_REDIRECT", "CF_WORKER_ROUTE":
rec.SetTarget(rec.GetTargetField()) rec.SetTarget(rec.GetTargetField())
case "A", "AAAA", "CAA", "DHCPID", "DS", "LOC", "NAPTR", "SOA", "SSHFP", "TXT", "TLSA", "AZURE_ALIAS": case "A", "AAAA", "CAA", "DHCID", "DS", "LOC", "NAPTR", "SOA", "SSHFP", "TXT", "TLSA", "AZURE_ALIAS":
// Nothing to do. // Nothing to do.
default: default:
return fmt.Errorf("Punycode rtype %v unimplemented", rec.Type) return fmt.Errorf("Punycode rtype %v unimplemented", rec.Type)