2011-09-12 04:47:25 +10:00
|
|
|
// DYNAMIC UPDATES
|
2013-05-06 04:30:44 +10:00
|
|
|
//
|
2012-01-17 07:44:49 +11:00
|
|
|
// Dynamic updates reuses the DNS message format, but renames three of
|
2011-09-12 04:47:25 +10:00
|
|
|
// the sections. Question is Zone, Answer is Prerequisite, Authority is
|
|
|
|
// Update, only the Additional is not renamed. See RFC 2136 for the gory details.
|
|
|
|
//
|
|
|
|
// You can set a rather complex set of rules for the existence of absence of
|
|
|
|
// certain resource records or names in a zone to specify if resource records
|
2013-05-06 04:30:44 +10:00
|
|
|
// should be added or removed. The table from RFC 2136 supplemented with the Go
|
2011-09-12 04:47:25 +10:00
|
|
|
// DNS function shows which functions exist to specify the prerequisites.
|
|
|
|
//
|
|
|
|
// 3.2.4 - Table Of Metavalues Used In Prerequisite Section
|
|
|
|
//
|
2012-01-14 21:08:42 +11:00
|
|
|
// CLASS TYPE RDATA Meaning Function
|
|
|
|
// --------------------------------------------------------------
|
2014-07-30 16:35:06 +10:00
|
|
|
// ANY ANY empty Name is in use dns.NameUsed
|
|
|
|
// ANY rrset empty RRset exists (value indep) dns.RRsetUsed
|
|
|
|
// NONE ANY empty Name is not in use dns.NameNotUsed
|
|
|
|
// NONE rrset empty RRset does not exist dns.RRsetNotUsed
|
|
|
|
// zone rrset rr RRset exists (value dep) dns.Used
|
2013-05-06 04:30:44 +10:00
|
|
|
//
|
2011-09-12 04:47:25 +10:00
|
|
|
// The prerequisite section can also be left empty.
|
2012-01-17 07:44:49 +11:00
|
|
|
// If you have decided on the prerequisites you can tell what RRs should
|
2011-09-12 04:47:25 +10:00
|
|
|
// be added or deleted. The next table shows the options you have and
|
2012-01-17 07:44:49 +11:00
|
|
|
// what functions to call.
|
|
|
|
//
|
2011-09-12 04:47:25 +10:00
|
|
|
// 3.4.2.6 - Table Of Metavalues Used In Update Section
|
2013-05-06 04:30:44 +10:00
|
|
|
//
|
2012-01-14 21:08:42 +11:00
|
|
|
// CLASS TYPE RDATA Meaning Function
|
|
|
|
// ---------------------------------------------------------------
|
2014-07-30 16:35:06 +10:00
|
|
|
// ANY ANY empty Delete all RRsets from name dns.RemoveName
|
|
|
|
// ANY rrset empty Delete an RRset dns.RemoveRRset
|
|
|
|
// NONE rrset rr Delete an RR from RRset dns.Remove
|
|
|
|
// zone rrset rr Add to an RRset dns.Insert
|
2013-05-06 04:30:44 +10:00
|
|
|
//
|
2011-08-22 22:51:10 +10:00
|
|
|
package dns
|
|
|
|
|
2011-08-22 23:16:24 +10:00
|
|
|
// NameUsed sets the RRs in the prereq section to
|
2011-08-22 22:51:10 +10:00
|
|
|
// "Name is in use" RRs. RFC 2136 section 2.4.4.
|
2011-12-10 06:56:59 +11:00
|
|
|
func (u *Msg) NameUsed(rr []RR) {
|
2011-08-22 23:16:24 +10:00
|
|
|
u.Answer = make([]RR, len(rr))
|
2011-08-22 22:51:10 +10:00
|
|
|
for i, r := range rr {
|
2012-12-10 05:23:25 +11:00
|
|
|
u.Answer[i] = &ANY{Hdr: RR_Header{Name: r.Header().Name, Ttl: 0, Rrtype: TypeANY, Class: ClassANY}}
|
2011-08-22 22:51:10 +10:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2011-08-22 23:16:24 +10:00
|
|
|
// NameNotUsed sets the RRs in the prereq section to
|
2011-08-22 22:51:10 +10:00
|
|
|
// "Name is in not use" RRs. RFC 2136 section 2.4.5.
|
2011-12-10 06:56:59 +11:00
|
|
|
func (u *Msg) NameNotUsed(rr []RR) {
|
2011-08-22 23:16:24 +10:00
|
|
|
u.Answer = make([]RR, len(rr))
|
2011-08-22 22:51:10 +10:00
|
|
|
for i, r := range rr {
|
2012-12-10 05:23:25 +11:00
|
|
|
u.Answer[i] = &ANY{Hdr: RR_Header{Name: r.Header().Name, Ttl: 0, Rrtype: TypeANY, Class: ClassNONE}}
|
2011-08-22 22:51:10 +10:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2012-10-16 19:41:20 +11:00
|
|
|
// Used sets the RRs in the prereq section to
|
2011-08-22 22:51:10 +10:00
|
|
|
// "RRset exists (value dependent -- with rdata)" RRs. RFC 2136 section 2.4.2.
|
2012-10-16 19:41:20 +11:00
|
|
|
func (u *Msg) Used(rr []RR) {
|
2011-12-10 06:56:59 +11:00
|
|
|
if len(u.Question) == 0 {
|
2012-08-29 02:21:23 +10:00
|
|
|
panic("dns: empty question section")
|
2011-09-09 03:41:26 +10:00
|
|
|
}
|
2011-08-22 23:16:24 +10:00
|
|
|
u.Answer = make([]RR, len(rr))
|
2011-08-22 22:51:10 +10:00
|
|
|
for i, r := range rr {
|
2011-08-22 23:43:52 +10:00
|
|
|
u.Answer[i] = r
|
2011-12-10 06:56:59 +11:00
|
|
|
u.Answer[i].Header().Class = u.Question[0].Qclass
|
2011-08-22 22:51:10 +10:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2012-10-16 01:50:39 +11:00
|
|
|
// RRsetUsed sets the RRs in the prereq section to
|
2011-08-22 22:51:10 +10:00
|
|
|
// "RRset exists (value independent -- no rdata)" RRs. RFC 2136 section 2.4.1.
|
2012-10-16 01:50:39 +11:00
|
|
|
func (u *Msg) RRsetUsed(rr []RR) {
|
2011-08-22 23:16:24 +10:00
|
|
|
u.Answer = make([]RR, len(rr))
|
2011-08-22 22:51:10 +10:00
|
|
|
for i, r := range rr {
|
2011-08-22 23:43:52 +10:00
|
|
|
u.Answer[i] = r
|
|
|
|
u.Answer[i].Header().Class = ClassANY
|
|
|
|
u.Answer[i].Header().Ttl = 0
|
|
|
|
u.Answer[i].Header().Rdlength = 0
|
2011-08-22 22:51:10 +10:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2011-08-22 23:16:24 +10:00
|
|
|
// RRsetNotUsed sets the RRs in the prereq section to
|
2011-08-22 22:51:10 +10:00
|
|
|
// "RRset does not exist" RRs. RFC 2136 section 2.4.3.
|
2011-12-10 06:56:59 +11:00
|
|
|
func (u *Msg) RRsetNotUsed(rr []RR) {
|
2011-08-22 23:16:24 +10:00
|
|
|
u.Answer = make([]RR, len(rr))
|
2011-08-22 22:51:10 +10:00
|
|
|
for i, r := range rr {
|
2011-08-22 23:43:52 +10:00
|
|
|
u.Answer[i] = r
|
|
|
|
u.Answer[i].Header().Class = ClassNONE
|
|
|
|
u.Answer[i].Header().Rdlength = 0
|
|
|
|
u.Answer[i].Header().Ttl = 0
|
2011-08-22 22:51:10 +10:00
|
|
|
}
|
|
|
|
}
|
2011-08-22 23:35:52 +10:00
|
|
|
|
2012-10-16 19:41:20 +11:00
|
|
|
// Insert creates a dynamic update packet that adds an complete RRset, see RFC 2136 section 2.5.1.
|
|
|
|
func (u *Msg) Insert(rr []RR) {
|
2011-12-10 06:56:59 +11:00
|
|
|
if len(u.Question) == 0 {
|
2012-08-29 02:21:23 +10:00
|
|
|
panic("dns: empty question section")
|
2011-09-09 03:41:26 +10:00
|
|
|
}
|
2011-08-22 23:43:52 +10:00
|
|
|
u.Ns = make([]RR, len(rr))
|
|
|
|
for i, r := range rr {
|
|
|
|
u.Ns[i] = r
|
2011-12-10 06:56:59 +11:00
|
|
|
u.Ns[i].Header().Class = u.Question[0].Qclass
|
2011-08-22 23:43:52 +10:00
|
|
|
}
|
2011-08-22 23:35:52 +10:00
|
|
|
}
|
|
|
|
|
2012-10-16 01:50:39 +11:00
|
|
|
// RemoveRRset creates a dynamic update packet that deletes an RRset, see RFC 2136 section 2.5.2.
|
|
|
|
func (u *Msg) RemoveRRset(rr []RR) {
|
2014-11-12 11:29:00 +11:00
|
|
|
m := make(map[RR_Header]struct{})
|
2014-11-12 20:54:56 +11:00
|
|
|
u.Ns = make([]RR, 0, len(rr))
|
2014-11-12 11:29:00 +11:00
|
|
|
for _, r := range rr {
|
2014-11-12 20:54:56 +11:00
|
|
|
h := *r.Header().copyHeader()
|
|
|
|
h.Class = ClassANY
|
|
|
|
h.Ttl = 0
|
|
|
|
h.Rdlength = 0
|
|
|
|
if _, ok := m[h]; ok {
|
|
|
|
continue
|
|
|
|
}
|
|
|
|
m[h] = struct{}{}
|
|
|
|
u.Ns = append(u.Ns, &ANY{h})
|
2011-08-22 23:43:52 +10:00
|
|
|
}
|
2011-08-22 23:35:52 +10:00
|
|
|
}
|
|
|
|
|
2012-10-16 01:50:39 +11:00
|
|
|
// RemoveName creates a dynamic update packet that deletes all RRsets of a name, see RFC 2136 section 2.5.3
|
|
|
|
func (u *Msg) RemoveName(rr []RR) {
|
2011-08-22 23:43:52 +10:00
|
|
|
u.Ns = make([]RR, len(rr))
|
|
|
|
for i, r := range rr {
|
2012-12-10 05:23:25 +11:00
|
|
|
u.Ns[i] = &ANY{Hdr: RR_Header{Name: r.Header().Name, Ttl: 0, Rrtype: TypeANY, Class: ClassANY}}
|
2011-08-22 23:43:52 +10:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2012-10-16 19:41:20 +11:00
|
|
|
// Remove creates a dynamic update packet deletes RR from the RRSset, see RFC 2136 section 2.5.4
|
|
|
|
func (u *Msg) Remove(rr []RR) {
|
2011-08-22 23:43:52 +10:00
|
|
|
u.Ns = make([]RR, len(rr))
|
|
|
|
for i, r := range rr {
|
|
|
|
u.Ns[i] = r
|
|
|
|
u.Ns[i].Header().Class = ClassNONE
|
2011-12-06 21:59:28 +11:00
|
|
|
u.Ns[i].Header().Ttl = 0
|
2011-08-22 23:43:52 +10:00
|
|
|
}
|
2011-08-22 23:35:52 +10:00
|
|
|
}
|