2011-02-10 08:01:43 +00:00
|
|
|
# Alternative (more granular) approach to a DNS library.
|
2010-12-28 14:44:19 +00:00
|
|
|
|
2012-01-28 00:14:55 +00:00
|
|
|
> Less is more.
|
|
|
|
|
2012-01-27 07:51:24 +00:00
|
|
|
Complete and usable DNS library. Most widely used Resource Records are
|
|
|
|
supported, including the DNSSEC types. It follows a lean and mean philosophy.
|
2012-01-11 21:01:40 +00:00
|
|
|
If there is stuff you should know as a DNS programmer there isn't a convenience
|
2012-01-28 00:14:55 +00:00
|
|
|
function for it.
|
2011-07-05 17:54:20 +00:00
|
|
|
|
2012-01-26 22:00:37 +00:00
|
|
|
Goals:
|
2012-02-15 09:34:35 +00:00
|
|
|
|
2012-01-26 22:00:37 +00:00
|
|
|
* KISS;
|
2012-02-15 09:24:58 +00:00
|
|
|
* Symmetric API: client and server side should be very similar;
|
2012-01-26 22:00:37 +00:00
|
|
|
* Small API;
|
2012-02-13 20:39:27 +00:00
|
|
|
* If its easy to code in Go, don't make a function for it.
|
2012-01-26 22:00:37 +00:00
|
|
|
|
2011-09-12 08:13:50 +00:00
|
|
|
Features:
|
2011-07-05 17:54:20 +00:00
|
|
|
|
2011-09-12 08:13:50 +00:00
|
|
|
* UDP/TCP queries, IPv4 and IPv6;
|
2012-01-26 22:00:37 +00:00
|
|
|
* RFC 1035 zone file parsing;
|
|
|
|
* Fast:
|
2012-01-28 00:14:07 +00:00
|
|
|
* reply speed around 35K qps (Faster hardware -> more qps);
|
2012-02-13 20:39:27 +00:00
|
|
|
* Parsing RRs (zone files) with 35K RR/s, that 5M records in about 142 seconds;
|
2012-01-26 22:00:37 +00:00
|
|
|
* This is expected to be optimized further.
|
2012-02-13 21:02:36 +00:00
|
|
|
* Client and server side programming (mimicking the net/http package);
|
2012-02-15 09:24:58 +00:00
|
|
|
* Asynchronous queries/replies for client and server;
|
2012-01-14 10:08:42 +00:00
|
|
|
* DNSSEC;
|
2012-02-13 21:02:36 +00:00
|
|
|
* EDNS0, NSID;
|
2011-09-12 08:13:50 +00:00
|
|
|
* AXFR/IXFR;
|
2012-01-14 10:08:42 +00:00
|
|
|
* TSIG;
|
2012-01-26 22:00:37 +00:00
|
|
|
* DNS name compression.
|
2010-12-28 14:44:19 +00:00
|
|
|
|
2012-02-05 10:04:21 +00:00
|
|
|
Building is done with the `go` tool. If you have setup your GOPATH
|
|
|
|
correctly the following should work:
|
2011-01-01 21:07:47 +00:00
|
|
|
|
2012-02-05 10:04:21 +00:00
|
|
|
go build dns
|
|
|
|
|
|
|
|
Sample programs can be found in the `ex` directory. They can
|
2012-02-14 12:48:07 +00:00
|
|
|
be build with: `make -C ex` (after the dns package has been installed)
|
2012-01-23 20:05:13 +00:00
|
|
|
|
2010-12-28 14:44:19 +00:00
|
|
|
Have fun!
|
2011-02-10 11:26:26 +00:00
|
|
|
|
2012-01-11 21:01:40 +00:00
|
|
|
Miek Gieben - 2010-2012 - miek@miek.nl
|
2010-12-18 22:46:37 +00:00
|
|
|
|
2012-01-15 15:29:01 +00:00
|
|
|
## Supported RFCs
|
2011-01-27 08:29:11 +00:00
|
|
|
|
2012-01-26 22:00:37 +00:00
|
|
|
All of them:
|
|
|
|
|
2011-03-09 18:41:52 +00:00
|
|
|
* 103{4,5} - DNS standard
|
2011-01-27 08:29:11 +00:00
|
|
|
* 1982 - Serial Arithmetic
|
|
|
|
* 1876 - LOC record (incomplete)
|
|
|
|
* 1995 - IXFR
|
|
|
|
* 1996 - DNS notify
|
2011-08-24 13:39:26 +00:00
|
|
|
* 2136 - DNS Update (dynamic updates)
|
2011-01-27 08:29:11 +00:00
|
|
|
* 2181 - RRset definition
|
|
|
|
* 2537 - RSAMD5 DNS keys
|
|
|
|
* 2065 - DNSSEC (updated in later RFCs)
|
|
|
|
* 2671 - EDNS
|
|
|
|
* 2782 - SRV
|
|
|
|
* 2845 - TSIG
|
|
|
|
* 2915 - NAPTR
|
|
|
|
* 3110 - RSASHA1 DNS keys
|
|
|
|
* 3225 - DO bit (DNSSEC OK)
|
2011-03-09 18:41:52 +00:00
|
|
|
* 340{1,2,3} - NAPTR
|
2012-02-16 22:34:09 +00:00
|
|
|
* 3445 - Limiting the scope of (DNS)KEY
|
2011-02-21 15:24:14 +00:00
|
|
|
* 3597 - Unkown RRs
|
2011-03-09 18:41:52 +00:00
|
|
|
* 403{3,4,5} - DNSSEC + validation functions
|
2011-01-27 08:29:11 +00:00
|
|
|
* 4255 - SSHFP
|
|
|
|
* 4408 - SPF
|
2011-03-22 08:44:33 +00:00
|
|
|
* 4509 - SHA256 Hash in DS
|
2012-02-15 09:28:55 +00:00
|
|
|
* 4592 - Wildcards in the DNS
|
2011-03-14 11:28:04 +00:00
|
|
|
* 4635 - HMAC SHA TSIG
|
2011-07-29 10:24:41 +00:00
|
|
|
* 4892 - id.server
|
2011-01-27 08:29:11 +00:00
|
|
|
* 5001 - NSID
|
2012-01-14 10:08:42 +00:00
|
|
|
* 5155 - NSEC3
|
2012-02-18 19:07:25 +00:00
|
|
|
* 5205 - HIP
|
2011-07-07 08:00:42 +00:00
|
|
|
* 5933 - GOST
|
2011-01-27 08:29:11 +00:00
|
|
|
* 5936 - AXFR
|
2011-07-22 21:28:04 +00:00
|
|
|
* xxxx - ECDSA
|
2010-12-21 13:41:48 +00:00
|
|
|
|
2011-02-10 11:26:26 +00:00
|
|
|
## Loosely based upon:
|
|
|
|
|
|
|
|
* `ldns`
|
|
|
|
* `NSD`
|
|
|
|
* `Net::DNS`
|
|
|
|
* `GRONG`
|