2017-01-04 18:55:54 +11:00
|
|
|
[![Build Status](https://travis-ci.org/miekg/dns.svg?branch=master)](https://travis-ci.org/miekg/dns)
|
2017-11-07 20:35:32 +11:00
|
|
|
[![Code Coverage](https://img.shields.io/codecov/c/github/miekg/dns/master.svg)](https://codecov.io/github/miekg/dns?branch=master)
|
2017-11-07 22:23:24 +11:00
|
|
|
[![Go Report Card](https://goreportcard.com/badge/github.com/miekg/dns)](https://goreportcard.com/report/miekg/dns)
|
2017-01-04 18:55:54 +11:00
|
|
|
[![](https://godoc.org/github.com/miekg/dns?status.svg)](https://godoc.org/github.com/miekg/dns)
|
2014-07-09 00:35:41 +10:00
|
|
|
|
2014-01-13 00:47:03 +11:00
|
|
|
# Alternative (more granular) approach to a DNS library
|
2010-12-29 01:44:19 +11:00
|
|
|
|
2012-01-28 11:14:55 +11:00
|
|
|
> Less is more.
|
|
|
|
|
2017-11-08 04:37:25 +11:00
|
|
|
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.
|
2011-07-06 03:54:20 +10:00
|
|
|
|
2017-11-08 04:37:25 +11:00
|
|
|
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.
|
2012-08-10 07:38:47 +10:00
|
|
|
|
2012-05-12 07:48:43 +10:00
|
|
|
# Goals
|
2012-02-15 20:34:35 +11:00
|
|
|
|
2012-01-27 09:00:37 +11:00
|
|
|
* KISS;
|
2014-04-11 23:53:48 +10:00
|
|
|
* Fast;
|
2017-03-31 17:08:51 +11:00
|
|
|
* Small API. If it's easy to code in Go, don't make a function for it.
|
2012-01-27 09:00:37 +11:00
|
|
|
|
2013-03-15 02:42:35 +11:00
|
|
|
# Users
|
|
|
|
|
|
|
|
A not-so-up-to-date-list-that-may-be-actually-current:
|
|
|
|
|
2017-03-08 18:08:31 +11:00
|
|
|
* https://github.com/coredns/coredns
|
2015-08-07 03:58:55 +10:00
|
|
|
* https://cloudflare.com
|
2013-03-15 02:42:35 +11:00
|
|
|
* https://github.com/abh/geodns
|
|
|
|
* http://www.statdns.com/
|
|
|
|
* http://www.dnsinspect.com/
|
2013-08-26 14:22:11 +10:00
|
|
|
* https://github.com/chuangbo/jianbing-dictionary-dns
|
2013-07-05 03:09:37 +10:00
|
|
|
* http://www.dns-lg.com/
|
|
|
|
* https://github.com/fcambus/rrda
|
2013-07-27 02:50:20 +10:00
|
|
|
* https://github.com/kenshinx/godns
|
2013-10-16 06:35:24 +11:00
|
|
|
* https://github.com/skynetservices/skydns
|
2016-02-13 08:41:29 +11:00
|
|
|
* https://github.com/hashicorp/consul
|
2014-07-03 09:21:29 +10:00
|
|
|
* https://github.com/DevelopersPL/godnsagent
|
2014-07-04 16:29:35 +10:00
|
|
|
* https://github.com/duedil-ltd/discodns
|
2015-01-26 04:39:30 +11:00
|
|
|
* https://github.com/StalkR/dns-reverse-proxy
|
2015-04-04 11:53:54 +11:00
|
|
|
* https://github.com/tianon/rawdns
|
2015-04-28 16:00:45 +10:00
|
|
|
* https://mesosphere.github.io/mesos-dns/
|
2015-07-18 00:58:41 +10:00
|
|
|
* https://pulse.turbobytes.com/
|
2015-08-07 20:09:15 +10:00
|
|
|
* https://play.google.com/store/apps/details?id=com.turbobytes.dig
|
2015-08-22 06:00:50 +10:00
|
|
|
* https://github.com/fcambus/statzone
|
2015-09-02 02:12:39 +10:00
|
|
|
* https://github.com/benschw/dns-clb-go
|
2016-02-04 05:53:21 +11:00
|
|
|
* https://github.com/corny/dnscheck for http://public-dns.info/
|
2015-10-08 20:26:47 +11:00
|
|
|
* https://namesmith.io
|
2015-11-02 18:52:41 +11:00
|
|
|
* https://github.com/miekg/unbound
|
|
|
|
* https://github.com/miekg/exdns
|
2016-01-30 03:26:44 +11:00
|
|
|
* https://dnslookup.org
|
2016-05-03 18:16:38 +10:00
|
|
|
* https://github.com/looterz/grimd
|
2016-05-07 23:17:04 +10:00
|
|
|
* https://github.com/phamhongviet/serf-dns
|
2016-10-04 01:37:16 +11:00
|
|
|
* https://github.com/mehrdadrad/mylg
|
2016-10-06 21:00:29 +11:00
|
|
|
* https://github.com/bamarni/dockness
|
2016-10-05 04:15:48 +11:00
|
|
|
* https://github.com/fffaraz/microdns
|
2017-10-19 17:42:25 +11:00
|
|
|
* http://kelda.io
|
2017-02-27 21:24:07 +11:00
|
|
|
* https://github.com/ipdcode/hades (JD.COM)
|
2017-03-23 08:36:10 +11:00
|
|
|
* https://github.com/StackExchange/dnscontrol/
|
2017-06-02 21:50:00 +10:00
|
|
|
* https://www.dnsperf.com/
|
2017-06-02 21:47:46 +10:00
|
|
|
* https://dnssectest.net/
|
2017-10-18 23:32:32 +11:00
|
|
|
* https://dns.apebits.com
|
|
|
|
* https://github.com/oif/apex
|
2014-09-21 18:13:29 +10:00
|
|
|
|
|
|
|
Send pull request if you want to be listed here.
|
2013-03-15 02:42:35 +11:00
|
|
|
|
2012-05-12 07:48:43 +10:00
|
|
|
# Features
|
2011-07-06 03:54:20 +10:00
|
|
|
|
2011-09-12 18:13:50 +10:00
|
|
|
* UDP/TCP queries, IPv4 and IPv6;
|
2013-05-16 09:15:36 +10:00
|
|
|
* RFC 1035 zone file parsing ($INCLUDE, $ORIGIN, $TTL and $GENERATE (for all record types) are supported;
|
2013-05-06 05:59:43 +10:00
|
|
|
* Fast:
|
|
|
|
* Reply speed around ~ 80K qps (faster hardware results in more qps);
|
2014-04-11 23:53:48 +10:00
|
|
|
* Parsing RRs ~ 100K RR/s, that's 5M records in about 50 seconds;
|
2012-08-10 07:38:47 +10:00
|
|
|
* Server side programming (mimicking the net/http package);
|
2012-11-20 05:28:49 +11:00
|
|
|
* Client side programming;
|
2012-05-03 16:59:02 +10:00
|
|
|
* DNSSEC: signing, validating and key generation for DSA, RSA and ECDSA;
|
2016-05-04 01:19:28 +10:00
|
|
|
* EDNS0, NSID, Cookies;
|
2011-09-12 18:13:50 +10:00
|
|
|
* AXFR/IXFR;
|
2014-11-02 22:29:55 +11:00
|
|
|
* TSIG, SIG(0);
|
2016-01-11 21:40:14 +11:00
|
|
|
* DNS over TLS: optional encrypted connection between client and server;
|
2014-08-31 01:42:51 +10:00
|
|
|
* DNS name compression;
|
|
|
|
* Depends only on the standard library.
|
2010-12-29 01:44:19 +11:00
|
|
|
|
2012-03-05 02:35:21 +11:00
|
|
|
Have fun!
|
|
|
|
|
2014-08-05 16:43:12 +10:00
|
|
|
Miek Gieben - 2010-2012 - <miek@miek.nl>
|
2012-03-05 02:35:21 +11:00
|
|
|
|
2012-05-12 07:48:43 +10:00
|
|
|
# Building
|
2012-03-05 02:35:21 +11:00
|
|
|
|
2017-11-08 04:37:25 +11:00
|
|
|
Building is done with the `go` tool. If you have setup your GOPATH correctly, the following should
|
|
|
|
work:
|
2011-01-02 08:07:47 +11:00
|
|
|
|
2012-08-10 07:38:47 +10:00
|
|
|
go get github.com/miekg/dns
|
2013-10-08 07:02:55 +11:00
|
|
|
go build github.com/miekg/dns
|
2012-02-05 21:04:21 +11:00
|
|
|
|
2013-10-13 21:23:14 +11:00
|
|
|
## Examples
|
|
|
|
|
2015-03-24 17:56:56 +11:00
|
|
|
A short "how to use the API" is at the beginning of doc.go (this also will show
|
2014-01-28 21:55:31 +11:00
|
|
|
when you call `godoc github.com/miekg/dns`).
|
2013-10-13 21:23:14 +11:00
|
|
|
|
|
|
|
Example programs can be found in the `github.com/miekg/exdns` repository.
|
2013-09-21 01:15:27 +10:00
|
|
|
|
2012-01-16 02:29:01 +11:00
|
|
|
## Supported RFCs
|
2011-01-27 19:29:11 +11:00
|
|
|
|
2012-05-03 16:59:02 +10:00
|
|
|
*all of them*
|
2012-01-27 09:00:37 +11:00
|
|
|
|
2012-08-27 06:32:47 +10:00
|
|
|
* 103{4,5} - DNS standard
|
2015-08-10 16:30:50 +10:00
|
|
|
* 1348 - NSAP record (removed the record)
|
2011-01-27 19:29:11 +11:00
|
|
|
* 1982 - Serial Arithmetic
|
2012-04-30 23:47:37 +10:00
|
|
|
* 1876 - LOC record
|
2011-01-27 19:29:11 +11:00
|
|
|
* 1995 - IXFR
|
|
|
|
* 1996 - DNS notify
|
2011-08-24 23:39:26 +10:00
|
|
|
* 2136 - DNS Update (dynamic updates)
|
2014-01-28 21:56:29 +11:00
|
|
|
* 2181 - RRset definition - there is no RRset type though, just []RR
|
2011-01-27 19:29:11 +11:00
|
|
|
* 2537 - RSAMD5 DNS keys
|
|
|
|
* 2065 - DNSSEC (updated in later RFCs)
|
2012-02-19 07:49:02 +11:00
|
|
|
* 2671 - EDNS record
|
|
|
|
* 2782 - SRV record
|
|
|
|
* 2845 - TSIG record
|
|
|
|
* 2915 - NAPTR record
|
2013-04-18 19:23:53 +10:00
|
|
|
* 2929 - DNS IANA Considerations
|
2011-01-27 19:29:11 +11:00
|
|
|
* 3110 - RSASHA1 DNS keys
|
|
|
|
* 3225 - DO bit (DNSSEC OK)
|
2012-02-19 07:49:02 +11:00
|
|
|
* 340{1,2,3} - NAPTR record
|
2012-02-17 09:34:09 +11:00
|
|
|
* 3445 - Limiting the scope of (DNS)KEY
|
2015-01-25 21:58:30 +11:00
|
|
|
* 3597 - Unknown RRs
|
2011-03-10 05:41:52 +11:00
|
|
|
* 403{3,4,5} - DNSSEC + validation functions
|
2012-02-19 07:49:02 +11:00
|
|
|
* 4255 - SSHFP record
|
2013-09-21 01:15:27 +10:00
|
|
|
* 4343 - Case insensitivity
|
2012-02-19 07:49:02 +11:00
|
|
|
* 4408 - SPF record
|
2011-03-22 19:44:33 +11:00
|
|
|
* 4509 - SHA256 Hash in DS
|
2012-02-15 20:28:55 +11:00
|
|
|
* 4592 - Wildcards in the DNS
|
2011-03-14 22:28:04 +11:00
|
|
|
* 4635 - HMAC SHA TSIG
|
2012-02-19 07:25:37 +11:00
|
|
|
* 4701 - DHCID
|
2011-07-29 20:24:41 +10:00
|
|
|
* 4892 - id.server
|
2013-09-21 01:15:27 +10:00
|
|
|
* 5001 - NSID
|
2012-02-19 07:49:02 +11:00
|
|
|
* 5155 - NSEC3 record
|
|
|
|
* 5205 - HIP record
|
2012-04-18 22:52:49 +10:00
|
|
|
* 5702 - SHA2 in the DNS
|
2011-01-27 19:29:11 +11:00
|
|
|
* 5936 - AXFR
|
2013-10-19 09:07:48 +11:00
|
|
|
* 5966 - TCP implementation recommendations
|
2012-05-03 16:59:02 +10:00
|
|
|
* 6605 - ECDSA
|
2014-10-23 19:12:02 +11:00
|
|
|
* 6725 - IANA Registry Update
|
2012-11-18 07:26:48 +11:00
|
|
|
* 6742 - ILNP DNS
|
2015-10-06 17:59:47 +11:00
|
|
|
* 6840 - Clarifications and Implementation Notes for DNS Security
|
2015-06-16 19:01:28 +10:00
|
|
|
* 6844 - CAA record
|
2013-04-28 01:57:33 +10:00
|
|
|
* 6891 - EDNS0 update
|
2013-10-13 23:28:48 +11:00
|
|
|
* 6895 - DNS IANA considerations
|
2014-08-31 01:46:37 +10:00
|
|
|
* 6975 - Algorithm Understanding in DNSSEC
|
2014-01-28 21:59:12 +11:00
|
|
|
* 7043 - EUI48/EUI64 records
|
2014-07-22 04:31:28 +10:00
|
|
|
* 7314 - DNS (EDNS) EXPIRE Option
|
2017-02-16 07:40:16 +11:00
|
|
|
* 7828 - edns-tcp-keepalive EDNS0 Option
|
2015-07-21 16:47:38 +10:00
|
|
|
* 7553 - URI record
|
2017-11-08 04:37:25 +11:00
|
|
|
* 7858 - DNS over TLS: Initiation and Performance Considerations
|
2016-06-11 18:21:11 +10:00
|
|
|
* 7873 - Domain Name System (DNS) Cookies (draft-ietf-dnsop-cookies)
|
2010-12-22 00:41:48 +11:00
|
|
|
|
2012-08-27 06:32:47 +10:00
|
|
|
## Loosely based upon
|
2011-02-10 22:26:26 +11:00
|
|
|
|
|
|
|
* `ldns`
|
|
|
|
* `NSD`
|
|
|
|
* `Net::DNS`
|
|
|
|
* `GRONG`
|