Go
Clone or download
Permalink
Failed to load latest commit information.
dnsutil util.TrimDomainName() fails when origin doesn't end in dot (#559) Nov 8, 2017
vendor/golang.org/x dep ensure -update (#697) Jun 7, 2018
.codecov.yml Add codecov yaml to not fail the build (#600) Dec 6, 2017
.gitignore gitignore update Oct 15, 2013
.travis.yml Add go1.10.x to Travis (#718) Aug 4, 2018
AUTHORS add AUTHOR file Feb 10, 2014
CONTRIBUTORS Correctly set the Source IP to the received Destination IP (#524) Sep 29, 2017
COPYRIGHT Remove all copyright notices Sep 11, 2014
Gopkg.lock dep ensure -update (#697) Jun 7, 2018
Gopkg.toml 458+dep (#591) Nov 27, 2017
LICENSE Update the copy right for the original GO files May 12, 2013
Makefile.fuzz Add fuzzing framework (#580) Nov 23, 2017
Makefile.release Release: plain push is also needed Jan 10, 2018
README.md readme: add dnstrace to Users section (#721) Aug 10, 2018
client.go Fix DialTimeout for direct call of Dial (#691) Jun 4, 2018
client_test.go tests: remove t.Log(f) when nothing is failing (#698) Jun 7, 2018
clientconfig.go fix: panicing on options parsing. (#642) Mar 1, 2018
clientconfig_test.go fix: panicing on options parsing. (#642) Mar 1, 2018
compress_generate.go Fixed len computation when size just goes beyond 14 bits (#668) May 16, 2018
dane.go Improve performance by addressing some low hanging fruit. (#444) Feb 2, 2017
defaults.go ClassANY: don't convert CLASS255 to ANY (#618) Jan 7, 2018
dns.go copyHeader is redundant (#672) May 10, 2018
dns_bench_test.go Tests updates (#556) Nov 8, 2017
dns_test.go tests: remove t.Log(f) when nothing is failing (#698) Jun 7, 2018
dnssec.go Harden RSA public key unpacking (#693) Jun 5, 2018
dnssec_keygen.go 458+dep (#591) Nov 27, 2017
dnssec_keyscan.go Use RFC 8032 functions added to x/crypto/ed25519 (#715) Jul 25, 2018
dnssec_privkey.go Use RFC 8032 functions added to x/crypto/ed25519 (#715) Jul 25, 2018
dnssec_test.go Fix unpacking RSA exponent and tighten exponent validation (#692) Jun 4, 2018
doc.go ExchangeWithDialer does not exist anymore (#666) Apr 6, 2018
duplicate.go Add IsDuplicate function (#699) Jun 23, 2018
duplicate_generate.go Add IsDuplicate function (#699) Jun 23, 2018
duplicate_test.go Add IsDuplicate function (#699) Jun 23, 2018
dyn_test.go Remove all copyright notices Sep 11, 2014
edns.go Revert 6f3c0a1 (#682) May 21, 2018
edns_test.go Fix EDNS Extended RCODE (#517) Oct 13, 2017
example_test.go fix a stupid mistake "undefined: zone" Sep 30, 2015
format.go Remove WKS support Jun 5, 2016
fuzz.go Add fuzzing framework (#580) Nov 23, 2017
generate.go Correctly handle $GENERATE modifiers (#703) Jun 23, 2018
generate_test.go Correctly handle $GENERATE modifiers (#703) Jun 23, 2018
issue_test.go Tests updates (#556) Nov 8, 2017
labels.go Optimize CompareDomainName (#535) Oct 15, 2017
labels_test.go Cleanup: gofmt -w -s *.go (#548) Nov 3, 2017
leak_test.go WIP: DNS-over-HTTPS support for Client.Exchange API (#671) May 16, 2018
length_test.go Fixed len computation when size just goes beyond 14 bits (#668) May 16, 2018
msg.go Small comment tweaks (#678) May 16, 2018
msg_generate.go Lint: use ignore-this on generated files (#596) Dec 6, 2017
msg_helpers.go Don't use padding in base32 helpers (#683) May 21, 2018
msg_helpers_test.go Add testcases to validate consistency of packDataNsec (#714) Jul 23, 2018
msg_test.go do not modify dns.Rcode when packing to wire format (#675) May 13, 2018
nsecx.go NSEC/3 Cover+Match cleanup (#479) Apr 12, 2017
nsecx_test.go Handle empty NSEC3 salt in scanner (#677) May 14, 2018
parse_test.go ClassANY: don't convert CLASS255 to ANY (#618) Jan 7, 2018
privaterr.go copyHeader is redundant (#672) May 10, 2018
privaterr_test.go Test: remove all Logf/Log (#547) Nov 3, 2017
rawmsg.go Cleanup and removals (#377) Jun 13, 2016
remote_test.go Add remote test Aug 22, 2015
reverse.go Golint fixes (#456) Feb 15, 2017
rr_test.go Tests updates (#556) Nov 8, 2017
sanitize.go Add IsDuplicate function (#699) Jun 23, 2018
sanitize_test.go Tests updates (#556) Nov 8, 2017
scan.go ClassANY: don't convert CLASS255 to ANY (#618) Jan 7, 2018
scan_rr.go Handle empty NSEC3 salt in scanner (#677) May 14, 2018
scan_test.go Correctly handle $GENERATE modifiers (#703) Jun 23, 2018
scanner.go txt parser: fix goroutine leak (#570) Nov 17, 2017
server.go Simplify unlocking dance in *Serve functions (#719) Aug 10, 2018
server_test.go Test that Shutdown does not surface closed errors (#624) Feb 28, 2018
sig0.go Improve performance by addressing some low hanging fruit. (#444) Feb 2, 2017
sig0_test.go Lowercase all error msg from the tests Nov 26, 2015
singleinflight.go Implement outstanding query detection. Aug 24, 2013
smimea.go Golint fixes (#456) Feb 15, 2017
tlsa.go Fix for miekg/dns issue #289: support the SMIMEA record (#410) Oct 17, 2016
tsig.go Fix TSIG bug releated to ID substitution (#504) Aug 12, 2017
tsig_test.go Fix TSIG bug releated to ID substitution (#504) Aug 12, 2017
types.go Remove compression from AFSDB (#704) Jun 23, 2018
types_generate.go copyHeader is redundant (#672) May 10, 2018
types_test.go Tests: add ListenAndServe tests (#562) Nov 10, 2017
udp.go Cleanup udp.go somewhat (#662) Apr 6, 2018
udp_test.go Skip UDP OOB tests on unsupported architectures (#661) Apr 6, 2018
udp_windows.go Use and vendor golang.org/x/net/ipv4 and golang.org/x/net/ipv6 (#594) Dec 4, 2017
update.go An update msg can have multiple, different prerequests and also multi… Feb 27, 2016
update_test.go ClassANY: don't convert CLASS255 to ANY (#618) Jan 7, 2018
version.go Release 1.0.8 Jun 4, 2018
version_test.go Add semver (#595) Dec 6, 2017
xfr.go TSIG name must be presented in canonical form (#574) Nov 17, 2017
zcompress.go Remove compression from AFSDB (#704) Jun 23, 2018
zduplicate.go Add IsDuplicate function (#699) Jun 23, 2018
zmsg.go Remove compression from AFSDB (#704) Jun 23, 2018
ztypes.go copyHeader is redundant (#672) May 10, 2018

README.md

Build Status Code Coverage Go Report Card

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.

We try to keep the "master" branch as sane as possible and at the bleeding edge of standards, avoiding breaking changes wherever reasonable. We support the last two versions of Go.

Goals

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

Users

A not-so-up-to-date-list-that-may-be-actually-current:

Send pull request if you want to be listed here.

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 ~ 80K qps (faster hardware results in more qps);
    • Parsing RRs ~ 100K RR/s, that's 5M records in about 50 seconds;
  • Server side programming (mimicking the net/http package);
  • Client side programming;
  • DNSSEC: signing, validating and key generation for DSA, RSA, ECDSA and Ed25519;
  • EDNS0, NSID, Cookies;
  • AXFR/IXFR;
  • TSIG, SIG(0);
  • DNS over TLS: optional encrypted connection between client and server;
  • DNS name compression;
  • Depends only on the standard library.

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 get github.com/miekg/dns
go build github.com/miekg/dns

Examples

A short "how to use the API" is at the beginning of doc.go (this also will show when you call godoc github.com/miekg/dns).

Example programs can be found in the github.com/miekg/exdns repository.

Supported RFCs

all of them

  • 103{4,5} - DNS standard
  • 1348 - NSAP record (removed the record)
  • 1982 - Serial Arithmetic
  • 1876 - LOC record
  • 1995 - IXFR
  • 1996 - DNS notify
  • 2136 - DNS Update (dynamic updates)
  • 2181 - RRset definition - there is no RRset type though, just []RR
  • 2537 - RSAMD5 DNS keys
  • 2065 - DNSSEC (updated in later RFCs)
  • 2671 - EDNS record
  • 2782 - SRV record
  • 2845 - TSIG record
  • 2915 - NAPTR record
  • 2929 - DNS IANA Considerations
  • 3110 - RSASHA1 DNS keys
  • 3225 - DO bit (DNSSEC OK)
  • 340{1,2,3} - NAPTR record
  • 3445 - Limiting the scope of (DNS)KEY
  • 3597 - Unknown RRs
  • 403{3,4,5} - DNSSEC + validation functions
  • 4255 - SSHFP record
  • 4343 - Case insensitivity
  • 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
  • 5966 - TCP implementation recommendations
  • 6605 - ECDSA
  • 6725 - IANA Registry Update
  • 6742 - ILNP DNS
  • 6840 - Clarifications and Implementation Notes for DNS Security
  • 6844 - CAA record
  • 6891 - EDNS0 update
  • 6895 - DNS IANA considerations
  • 6975 - Algorithm Understanding in DNSSEC
  • 7043 - EUI48/EUI64 records
  • 7314 - DNS (EDNS) EXPIRE Option
  • 7477 - CSYNC RR
  • 7828 - edns-tcp-keepalive EDNS0 Option
  • 7553 - URI record
  • 7858 - DNS over TLS: Initiation and Performance Considerations
  • 7871 - EDNS0 Client Subnet
  • 7873 - Domain Name System (DNS) Cookies (draft-ietf-dnsop-cookies)
  • 8080 - EdDSA for DNSSEC

Loosely based upon

  • ldns
  • NSD
  • Net::DNS
  • GRONG