2010-12-30 23:42:52 +11:00
|
|
|
// Copyright 2009 The Go Authors. All rights reserved.
|
|
|
|
// Use of this source code is governed by a BSD-style
|
|
|
|
// license that can be found in the LICENSE file.
|
|
|
|
// Extended and bugfixes by Miek Gieben
|
|
|
|
|
|
|
|
// Package dns implements a full featured interface to the DNS.
|
|
|
|
// Supported RFCs and features include:
|
2010-12-31 00:13:28 +11:00
|
|
|
// * 1982 - Serial Arithmetic
|
2011-01-01 00:11:52 +11:00
|
|
|
// * 1034/1035
|
2010-12-31 06:50:31 +11:00
|
|
|
// * 1876 - LOC record (incomplete)
|
2011-01-01 00:11:52 +11:00
|
|
|
// * 1995 - IXFR
|
2010-12-30 23:42:52 +11:00
|
|
|
// * 2671 - EDNS
|
2011-01-01 01:10:42 +11:00
|
|
|
// * 2845 - TSIG
|
2010-12-31 06:50:31 +11:00
|
|
|
// * 2915 - NAPTR record (incomplete)
|
2010-12-31 04:42:40 +11:00
|
|
|
// * 3225 - DO bit (DNSSEC OK)
|
2010-12-30 23:42:52 +11:00
|
|
|
// * 4033/4034/4035 - DNSSEC + validation functions
|
2010-12-31 00:13:28 +11:00
|
|
|
// * 5011 - NSID
|
2011-01-01 00:11:52 +11:00
|
|
|
// * 5936 - AXFR
|
2010-12-30 23:42:52 +11:00
|
|
|
// * IP6 support
|
|
|
|
// The package allows full control over what is send out to the DNS.
|
|
|
|
//
|
|
|
|
package dns
|
|
|
|
|
2010-12-31 06:50:31 +11:00
|
|
|
import (
|
|
|
|
"strconv"
|
|
|
|
)
|
2010-12-30 23:42:52 +11:00
|
|
|
|
|
|
|
const Year68 = 2 << (32 - 1)
|
|
|
|
|
|
|
|
type RR interface {
|
2010-12-31 06:50:31 +11:00
|
|
|
Header() *RR_Header
|
|
|
|
String() string
|
2010-12-30 23:42:52 +11:00
|
|
|
}
|
|
|
|
|
|
|
|
// An RRset is a slice of RRs.
|
|
|
|
type RRset []RR
|
|
|
|
|
|
|
|
func (r RRset) Len() int { return len(r) }
|
|
|
|
func (r RRset) Less(i, j int) bool { return r[i].Header().Name < r[j].Header().Name }
|
|
|
|
func (r RRset) Swap(i, j int) { r[i], r[j] = r[j], r[i] }
|
|
|
|
|
|
|
|
// DNS resource records.
|
|
|
|
// There are many types of messages,
|
|
|
|
// but they all share the same header.
|
|
|
|
type RR_Header struct {
|
2010-12-31 06:50:31 +11:00
|
|
|
Name string "domain-name"
|
|
|
|
Rrtype uint16
|
|
|
|
Class uint16
|
|
|
|
Ttl uint32
|
|
|
|
Rdlength uint16 // length of data after header
|
2010-12-30 23:42:52 +11:00
|
|
|
}
|
|
|
|
|
|
|
|
func (h *RR_Header) Header() *RR_Header {
|
2010-12-31 06:50:31 +11:00
|
|
|
return h
|
2010-12-30 23:42:52 +11:00
|
|
|
}
|
|
|
|
|
|
|
|
func (h *RR_Header) String() string {
|
2010-12-31 06:50:31 +11:00
|
|
|
var s string
|
2010-12-30 23:42:52 +11:00
|
|
|
|
2010-12-31 06:50:31 +11:00
|
|
|
if h.Rrtype == TypeOPT {
|
|
|
|
s = ";"
|
|
|
|
// and maybe other things
|
|
|
|
}
|
2010-12-30 23:42:52 +11:00
|
|
|
|
2010-12-31 06:50:31 +11:00
|
|
|
if len(h.Name) == 0 {
|
|
|
|
s += ".\t"
|
|
|
|
} else {
|
|
|
|
s += h.Name + "\t"
|
|
|
|
}
|
|
|
|
s = s + strconv.Itoa(int(h.Ttl)) + "\t"
|
|
|
|
s = s + Class_str[h.Class] + "\t"
|
|
|
|
s = s + Rr_str[h.Rrtype] + "\t"
|
|
|
|
return s
|
2010-12-30 23:42:52 +11:00
|
|
|
}
|
|
|
|
|
|
|
|
// Or expose the pack/unpack functions??
|
|
|
|
|
2010-12-31 00:13:28 +11:00
|
|
|
// Return the wiredata of rdata portion of a RR.
|
2010-12-30 23:42:52 +11:00
|
|
|
func WireRdata(r RR) ([]byte, bool) {
|
2010-12-31 06:50:31 +11:00
|
|
|
buf := make([]byte, 4096) // Too large, need to FIX TODO(mg)
|
|
|
|
off1, ok := packRR(r, buf, 0)
|
|
|
|
if !ok {
|
|
|
|
return nil, false
|
|
|
|
}
|
|
|
|
start := off1 - int(r.Header().Rdlength)
|
|
|
|
end := start + int(r.Header().Rdlength)
|
|
|
|
buf = buf[start:end]
|
|
|
|
return buf, true
|
2010-12-30 23:42:52 +11:00
|
|
|
}
|
|
|
|
|
2010-12-31 00:13:28 +11:00
|
|
|
// Return the wiredata of a domainname (sans compressions).
|
2010-12-30 23:42:52 +11:00
|
|
|
func WireDomainName(s string) ([]byte, bool) {
|
2010-12-31 06:50:31 +11:00
|
|
|
buf := make([]byte, 255)
|
|
|
|
off, ok := packDomainName(s, buf, 0)
|
|
|
|
if !ok {
|
|
|
|
return nil, ok
|
|
|
|
}
|
|
|
|
buf = buf[:off]
|
|
|
|
return buf, ok
|
2010-12-30 23:42:52 +11:00
|
|
|
}
|
|
|
|
|
2010-12-31 00:13:28 +11:00
|
|
|
// Return the wiredata of a complete Resource Record.
|
2010-12-30 23:42:52 +11:00
|
|
|
func WireRR(r RR) ([]byte, bool) {
|
2010-12-31 06:50:31 +11:00
|
|
|
buf := make([]byte, 4096)
|
|
|
|
off, ok := packRR(r, buf, 0)
|
|
|
|
if !ok {
|
|
|
|
return nil, false
|
|
|
|
}
|
|
|
|
buf = buf[:off]
|
|
|
|
return buf, ok
|
2010-12-30 23:42:52 +11:00
|
|
|
}
|