This is a clone/fork of https://github.com/miekg/dns
Go to file
Miek Gieben ff55b5253a Updates for the latest weekly: weekly.2012-01-27 2012-01-27 08:39:41 +01:00
examples start thinking about tsig 2012-01-26 20:29:04 +01:00
t Add these ldns generated keys 2012-01-22 20:45:09 +01:00
.gitignore add gitignore file 2011-09-20 10:21:17 +02:00
LICENSE add TSIG axfr test, still needs work though 2011-07-05 20:52:35 +02:00
Makefile Fixje 2012-01-19 19:56:36 +01:00
README.markdown update the readme 2012-01-26 23:00:37 +01:00
TODO.markdown This bug is fixed 2012-01-23 21:01:50 +01:00
client.go Updates for the latest weekly: weekly.2012-01-27 2012-01-27 08:39:41 +01:00
client_test.go gofmt 2012-01-12 23:17:34 +01:00
clientconfig.go gofmt 2011-12-09 21:45:57 +01:00
defaults.go add a dot 2012-01-26 22:47:54 +01:00
dns.go Add a nsec3 Match() function 2012-01-22 10:52:06 +01:00
dns_test.go Shorter function for SetUpdate and doc 2012-01-15 16:13:20 +01:00
dnssec.go Some more tweaks into verifying nsec3 messages 2012-01-22 16:12:10 +01:00
dnssec_test.go Fix NSEC(3) with no bitmap 2012-01-23 11:30:26 +01:00
dnssex.nl.signed Add a testzone 2011-12-14 09:27:53 +01:00
dyn_test.go gofmt 2011-12-09 21:45:57 +01:00
edns.go gofmt 2012-01-20 12:24:20 +01:00
gb.cfg Add support for go-gb 2012-01-26 13:29:04 +11:00
keygen.go Fixes for weekly.2012-01-20 2012-01-20 12:24:05 +01:00
kscan.go support $INCLUDE 2012-01-21 23:36:54 +01:00
label_test.go gofmt 2012-01-12 23:17:34 +01:00
labels.go Remove this function again 2012-01-11 08:51:43 +01:00
msg.go Docs 2012-01-26 22:52:29 +01:00
nsec3.go This bug is fixed 2012-01-23 21:01:50 +01:00
nsec3_test.go Make all tests fully qualified 2012-01-08 15:34:42 +01:00
parse_test.go More tests 2012-01-22 20:44:52 +01:00
rawmsg.go dont need this either 2012-01-12 21:33:14 +01:00
server.go gofmt 2012-01-20 12:24:20 +01:00
server_test.go Make the udp msg size configurable 2012-01-12 22:47:36 +01:00
test.zone.miek.nl.signed Revert "Use larger buffer to speed things up" 2012-01-05 13:24:11 +01:00
tsig.go tsig without the typos 2012-01-26 20:27:30 +01:00
types.go Add tlsa 2012-01-16 10:11:05 +01:00
update.go Docs 2012-01-26 22:52:29 +01:00
xfr.go Fix the tests, but they now fail 2012-01-11 14:44:54 +01:00
zscan.go More tests 2012-01-22 20:44:52 +01:00
zscan_rr.go remove debugging 2012-01-22 14:59:31 +01:00

README.markdown

Alternative (more granular) approach to a DNS library.

Completely usable DNS library. Most widely used Resource Records are supported including the DNSSEC types. It follows a lean and mean philosophy. If there is stuff you should know as a DNS programmer there isn't a convenience function for it. For instance I'm pondering if a zone-like structure should be implemented in the library.

Goals:

  • KISS;
  • Small API;
  • If its easy to code in Go, don't make a function of it.

Features:

  • UDP/TCP queries, IPv4 and IPv6;
  • RFC 1035 zone file parsing;
  • Fast:
    • reply speed around 30K qps (Faster hardware -> more qps);
    • Parsing RRs (zone files) with 25K RR/s;
    • This is expected to be optimized further.
  • Client and server side programming (mimicking the http package);
  • Asynchronous queries for client and server;
  • DNSSEC;
  • EDNS0;
  • AXFR/IXFR;
  • TSIG;
  • DNS name compression.

Sample programs can be found in the examples directory. They can be build with: make examples (after the dns package has been installed)

See this mini howto to get things going (including Go itself).

Have fun!

Miek Gieben - 2010-2012 - miek@miek.nl

Supported RFCs

All of them:

  • 103{4,5} - DNS standard
  • 1982 - Serial Arithmetic
  • 1876 - LOC record (incomplete)
  • 1995 - IXFR
  • 1996 - DNS notify
  • 2136 - DNS Update (dynamic updates)
  • 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)
  • 340{1,2,3} - NAPTR
  • 3597 - Unkown RRs
  • 403{3,4,5} - DNSSEC + validation functions
  • 4255 - SSHFP
  • 4408 - SPF
  • 4509 - SHA256 Hash in DS
  • 4635 - HMAC SHA TSIG
  • 4892 - id.server
  • 5001 - NSID
  • 5155 - NSEC3
  • 5933 - GOST
  • 5936 - AXFR
  • xxxx - ECDSA

Loosely based upon:

  • ldns
  • NSD
  • Net::DNS
  • GRONG