community
/
dns
3
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
This is a clone/fork of https://github.com/miekg/dns
1,760 Commits 1 Branch 67 Tags 17 MiB
Go 100%
Go to file
Miek Gieben 07f206352a Add writebuf 2012-08-05 21:15:15 +02:00
ex Fix attempts in the client 2012-08-05 18:36:36 +02:00
t Put this in a example test function 2012-02-17 20:37:19 +01:00
.gitignore Tweak gitignore 2012-02-11 17:44:14 +01:00
LICENSE update license date 2012-02-18 15:52:11 +01:00
README.markdown small tweaks 2012-05-20 20:46:25 +02:00
TODO.markdown update 2012-07-04 07:51:56 +02:00
anchor.go Tweaks for get a secure lookup going 2012-06-05 09:31:50 +02:00
client.go Fix attempts in the client 2012-08-05 18:36:36 +02:00
client_test.go gofmt 2012-05-26 10:28:40 +02:00
clientconfig.go More preparation for the root 2012-06-03 09:35:39 +02:00
defaults.go Fix some faults 2012-08-04 14:16:29 -07:00
dns.go fqdn the handlers 2012-08-04 19:40:09 -07:00
dns_test.go Fix the test: EDNS0 is done completely different 2012-05-31 21:40:49 +02:00
dnssec.go tweaks to give more power to unbound package 2012-07-01 20:58:54 +02:00
dnssec_test.go more tests 2012-04-18 12:13:44 +02:00
dyn_test.go Fix test 2012-05-26 14:58:24 +02:00
edns.go Return the correct code 2012-07-05 12:53:45 +02:00
keygen.go fmt 2012-05-05 17:37:48 +02:00
kscan.go fmt 2012-05-05 17:37:48 +02:00
labels.go Fix IsSubDomain 2012-07-16 19:16:36 +02:00
labels_test.go more radix stuff 2012-08-01 07:30:45 -07:00
msg.go Remove unused stuff 2012-08-05 21:11:41 +02:00
nsec3_test.go Make all tests fully qualified 2012-01-08 15:34:42 +01:00
nsecx.go tweaks to give more power to unbound package 2012-07-01 20:58:54 +02:00
parse_test.go remove 2012-05-20 18:10:25 +02:00
rawmsg.go documentation updates 2012-05-03 08:53:38 +02:00
scanner.go go fmt and line nr tweak 2012-02-21 22:43:24 +01:00
server.go Add writebuf 2012-08-05 21:15:15 +02:00
server_test.go remove NewClient from the code 2012-05-26 10:28:32 +02:00
tsig.go tweaks to give more power to unbound package 2012-07-01 20:58:54 +02:00
types.go revert this too 2012-06-30 14:49:37 +02:00
update.go Remove NewUpdate, we already have the simpler SetUpdate 2012-05-26 14:56:23 +02:00
xfr.go gofmt -w 2012-06-20 20:16:36 +02:00
zgenerate.go gofmt 2012-05-22 08:48:26 +02:00
zone.go Use Radix tree for the mux 2012-08-05 08:13:09 +02:00
zscan.go make origin an fqdn 2012-07-16 19:46:16 +02:00
zscan_rr.go gofmt -w 2012-06-20 20:16:36 +02:00

README.markdown

Alternative (more granular) approach to a DNS library.

Less is more.

Complete and usable DNS library. All 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. Server side and client side programming is supported, i.e. you can build servers and resolvers with it.

Goals

  • KISS;
  • Symmetric API: client and server side should be very similar;
  • Small API, if its easy to code in Go, don't make a function for it.

Features

  • UDP/TCP queries, IPv4 and IPv6;
  • RFC 1035 zone file parsing ($INCLUDE, $ORIGIN, $TTL and $GENERATE [for all record types] are supported);
  • Fast:
    • Reply speed around 35/40K qps (faster hardware results in more qps);
    • Parsing RRs (zone files) with 95/100K RR/s, that's 5M records in about 50 seconds;
  • Client and server side programming (mimicking the net/http package);
  • Asynchronous queries/replies for client and server;
  • DNSSEC: signing, validating and key generation for DSA, RSA and ECDSA;
  • EDNS0, NSID;
  • AXFR/IXFR;
  • TSIG;
  • DNS name compression.

Have fun!

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

Building

Building is done with the go tool. If you have setup your GOPATH correctly the following should work:

go build dns

Sample programs can be found in the ex directory. They can be build with: make -C ex, or also with the go tool.

Supported RFCs

all of them

  • 103{4,5} - DNS standard
  • 1982 - Serial Arithmetic
  • 1876 - LOC record
  • 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 record
  • 2782 - SRV record
  • 2845 - TSIG record
  • 2915 - NAPTR record
  • 3110 - RSASHA1 DNS keys
  • 3225 - DO bit (DNSSEC OK)
  • 340{1,2,3} - NAPTR record
  • 3445 - Limiting the scope of (DNS)KEY
  • 3597 - Unkown RRs
  • 403{3,4,5} - DNSSEC + validation functions
  • 4255 - SSHFP record
  • 4408 - SPF record
  • 4509 - SHA256 Hash in DS
  • 4592 - Wildcards in the DNS
  • 4635 - HMAC SHA TSIG
  • 4701 - DHCID
  • 4892 - id.server
  • 5001 - NSID
  • 5155 - NSEC3 record
  • 5205 - HIP record
  • 5702 - SHA2 in the DNS
  • 5936 - AXFR
  • 6605 - ECDSA
  • xxxx - URI record (draft)

Loosely based upon:

  • ldns
  • NSD
  • Net::DNS
  • GRONG