2017-01-04 07:55:54 +00:00
|
|
|
[![Build Status](https://travis-ci.org/miekg/dns.svg?branch=master)](https://travis-ci.org/miekg/dns)
|
2017-11-07 09:35:32 +00: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 11:23:24 +00:00
|
|
|
[![Go Report Card](https://goreportcard.com/badge/github.com/miekg/dns)](https://goreportcard.com/report/miekg/dns)
|
2017-01-04 07:55:54 +00:00
|
|
|
[![](https://godoc.org/github.com/miekg/dns?status.svg)](https://godoc.org/github.com/miekg/dns)
|
2014-07-08 14:35:41 +00:00
|
|
|
|
2014-01-12 13:47:03 +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.
|
|
|
|
|
2018-11-27 14:39:19 +00:00
|
|
|
Complete and usable DNS library. All 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-05 17:54:20 +00:00
|
|
|
|
2017-11-07 17:37:25 +00: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-09 21:38:47 +00:00
|
|
|
|
2012-05-11 21:48:43 +00:00
|
|
|
# Goals
|
2012-02-15 09:34:35 +00:00
|
|
|
|
2012-01-26 22:00:37 +00:00
|
|
|
* KISS;
|
2014-04-11 13:53:48 +00:00
|
|
|
* Fast;
|
2017-03-31 06:08:51 +00:00
|
|
|
* Small API. If it's easy to code in Go, don't make a function for it.
|
2012-01-26 22:00:37 +00:00
|
|
|
|
2013-03-14 15:42:35 +00:00
|
|
|
# Users
|
|
|
|
|
|
|
|
A not-so-up-to-date-list-that-may-be-actually-current:
|
|
|
|
|
2017-03-08 07:08:31 +00:00
|
|
|
* https://github.com/coredns/coredns
|
2013-03-14 15:42:35 +00:00
|
|
|
* https://github.com/abh/geodns
|
2020-03-26 16:24:37 +00:00
|
|
|
* https://github.com/baidu/bfe
|
2013-03-14 15:42:35 +00:00
|
|
|
* http://www.statdns.com/
|
|
|
|
* http://www.dnsinspect.com/
|
2013-08-26 04:22:11 +00:00
|
|
|
* https://github.com/chuangbo/jianbing-dictionary-dns
|
2013-07-04 17:09:37 +00:00
|
|
|
* http://www.dns-lg.com/
|
|
|
|
* https://github.com/fcambus/rrda
|
2013-07-26 16:50:20 +00:00
|
|
|
* https://github.com/kenshinx/godns
|
2013-10-15 19:35:24 +00:00
|
|
|
* https://github.com/skynetservices/skydns
|
2016-02-12 21:41:29 +00:00
|
|
|
* https://github.com/hashicorp/consul
|
2014-07-02 23:21:29 +00:00
|
|
|
* https://github.com/DevelopersPL/godnsagent
|
2014-07-04 06:29:35 +00:00
|
|
|
* https://github.com/duedil-ltd/discodns
|
2015-01-25 17:39:30 +00:00
|
|
|
* https://github.com/StalkR/dns-reverse-proxy
|
2015-04-04 00:53:54 +00:00
|
|
|
* https://github.com/tianon/rawdns
|
2015-04-28 06:00:45 +00:00
|
|
|
* https://mesosphere.github.io/mesos-dns/
|
2015-08-21 20:00:50 +00:00
|
|
|
* https://github.com/fcambus/statzone
|
2015-09-01 16:12:39 +00:00
|
|
|
* https://github.com/benschw/dns-clb-go
|
2018-11-27 14:39:19 +00:00
|
|
|
* https://github.com/corny/dnscheck for <http://public-dns.info/>
|
2015-11-02 07:52:41 +00:00
|
|
|
* https://github.com/miekg/unbound
|
|
|
|
* https://github.com/miekg/exdns
|
2016-01-29 16:26:44 +00:00
|
|
|
* https://dnslookup.org
|
2016-05-03 08:16:38 +00:00
|
|
|
* https://github.com/looterz/grimd
|
2016-05-07 13:17:04 +00:00
|
|
|
* https://github.com/phamhongviet/serf-dns
|
2016-10-03 14:37:16 +00:00
|
|
|
* https://github.com/mehrdadrad/mylg
|
2016-10-06 10:00:29 +00:00
|
|
|
* https://github.com/bamarni/dockness
|
2016-10-04 17:15:48 +00:00
|
|
|
* https://github.com/fffaraz/microdns
|
2018-11-27 14:39:19 +00:00
|
|
|
* https://github.com/ipdcode/hades <https://jd.com>
|
2017-03-22 21:36:10 +00:00
|
|
|
* https://github.com/StackExchange/dnscontrol/
|
2017-06-02 11:50:00 +00:00
|
|
|
* https://www.dnsperf.com/
|
2017-06-02 11:47:46 +00:00
|
|
|
* https://dnssectest.net/
|
2017-10-18 12:32:32 +00:00
|
|
|
* https://github.com/oif/apex
|
2018-01-17 20:57:19 +00:00
|
|
|
* https://github.com/jedisct1/dnscrypt-proxy
|
|
|
|
* https://github.com/jedisct1/rpdns
|
2018-07-01 18:37:35 +00:00
|
|
|
* https://github.com/xor-gate/sshfp
|
2018-08-10 19:17:47 +00:00
|
|
|
* https://github.com/rs/dnstrace
|
2018-08-16 16:06:07 +00:00
|
|
|
* https://blitiri.com.ar/p/dnss ([github mirror](https://github.com/albertito/dnss))
|
2019-01-29 07:32:45 +00:00
|
|
|
* https://render.com
|
2019-03-04 07:36:23 +00:00
|
|
|
* https://github.com/peterzen/goresolver
|
2019-06-10 06:35:38 +00:00
|
|
|
* https://github.com/folbricht/routedns
|
2020-07-08 19:09:04 +00:00
|
|
|
* https://domainr.com/
|
|
|
|
* https://zonedb.org/
|
2020-09-16 05:57:26 +00:00
|
|
|
* https://router7.org/
|
2020-10-21 06:14:38 +00:00
|
|
|
* https://github.com/fortio/dnsping
|
2020-11-06 17:31:18 +00:00
|
|
|
* https://github.com/Luzilla/dnsbl_exporter
|
2021-01-09 08:37:20 +00:00
|
|
|
* https://github.com/bodgit/tsig
|
2021-02-10 06:42:07 +00:00
|
|
|
* https://github.com/v2fly/v2ray-core (test only)
|
2021-02-23 09:54:40 +00:00
|
|
|
* https://kuma.io/
|
2021-07-07 17:22:17 +00:00
|
|
|
* https://www.misaka.io/services/dns
|
|
|
|
* https://ping.sx/dig
|
2021-09-15 06:58:44 +00:00
|
|
|
* https://fleetdeck.io/
|
2021-02-10 06:42:07 +00:00
|
|
|
|
2014-09-21 08:13:29 +00:00
|
|
|
|
|
|
|
Send pull request if you want to be listed here.
|
2013-03-14 15:42:35 +00:00
|
|
|
|
2012-05-11 21:48:43 +00:00
|
|
|
# Features
|
2011-07-05 17:54:20 +00:00
|
|
|
|
2018-11-27 14:39:19 +00:00
|
|
|
* UDP/TCP queries, IPv4 and IPv6
|
|
|
|
* RFC 1035 zone file parsing ($INCLUDE, $ORIGIN, $TTL and $GENERATE (for all record types) are supported
|
|
|
|
* Fast
|
|
|
|
* 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 (DoT): encrypted connection between client and server over TCP
|
|
|
|
* DNS name compression
|
2010-12-28 14:44:19 +00:00
|
|
|
|
2012-03-04 15:35:21 +00:00
|
|
|
Have fun!
|
|
|
|
|
2014-08-05 06:43:12 +00:00
|
|
|
Miek Gieben - 2010-2012 - <miek@miek.nl>
|
2018-11-27 14:39:19 +00:00
|
|
|
DNS Authors 2012-
|
2012-03-04 15:35:21 +00:00
|
|
|
|
2012-05-11 21:48:43 +00:00
|
|
|
# Building
|
2012-03-04 15:35:21 +00:00
|
|
|
|
2019-12-19 09:28:37 +00:00
|
|
|
This library uses Go modules and uses semantic versioning. Building is done with the `go` tool, so
|
|
|
|
the following should work:
|
2011-01-01 21:07:47 +00:00
|
|
|
|
2012-08-09 21:38:47 +00:00
|
|
|
go get github.com/miekg/dns
|
2013-10-07 20:02:55 +00:00
|
|
|
go build github.com/miekg/dns
|
2012-02-05 10:04:21 +00:00
|
|
|
|
2013-10-13 10:23:14 +00:00
|
|
|
## Examples
|
|
|
|
|
2019-01-03 16:37:57 +00:00
|
|
|
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`).
|
2013-10-13 10:23:14 +00:00
|
|
|
|
|
|
|
Example programs can be found in the `github.com/miekg/exdns` repository.
|
2013-09-20 15:15:27 +00:00
|
|
|
|
2012-01-15 15:29:01 +00:00
|
|
|
## Supported RFCs
|
2011-01-27 08:29:11 +00:00
|
|
|
|
2012-05-03 06:59:02 +00:00
|
|
|
*all of them*
|
2012-01-26 22:00:37 +00:00
|
|
|
|
2012-08-26 20:32:47 +00:00
|
|
|
* 103{4,5} - DNS standard
|
2015-08-10 06:30:50 +00:00
|
|
|
* 1348 - NSAP record (removed the record)
|
2011-01-27 08:29:11 +00:00
|
|
|
* 1982 - Serial Arithmetic
|
2012-04-30 13:47:37 +00:00
|
|
|
* 1876 - LOC record
|
2011-01-27 08:29:11 +00:00
|
|
|
* 1995 - IXFR
|
|
|
|
* 1996 - DNS notify
|
2011-08-24 13:39:26 +00:00
|
|
|
* 2136 - DNS Update (dynamic updates)
|
2014-01-28 10:56:29 +00:00
|
|
|
* 2181 - RRset definition - there is no RRset type though, just []RR
|
2011-01-27 08:29:11 +00:00
|
|
|
* 2537 - RSAMD5 DNS keys
|
|
|
|
* 2065 - DNSSEC (updated in later RFCs)
|
2012-02-18 20:49:02 +00:00
|
|
|
* 2671 - EDNS record
|
|
|
|
* 2782 - SRV record
|
|
|
|
* 2845 - TSIG record
|
|
|
|
* 2915 - NAPTR record
|
2013-04-18 09:23:53 +00:00
|
|
|
* 2929 - DNS IANA Considerations
|
2011-01-27 08:29:11 +00:00
|
|
|
* 3110 - RSASHA1 DNS keys
|
2020-01-03 12:41:45 +00:00
|
|
|
* 3123 - APL record
|
2011-01-27 08:29:11 +00:00
|
|
|
* 3225 - DO bit (DNSSEC OK)
|
2012-02-18 20:49:02 +00:00
|
|
|
* 340{1,2,3} - NAPTR record
|
2012-02-16 22:34:09 +00:00
|
|
|
* 3445 - Limiting the scope of (DNS)KEY
|
2015-01-25 10:58:30 +00:00
|
|
|
* 3597 - Unknown RRs
|
2011-03-09 18:41:52 +00:00
|
|
|
* 403{3,4,5} - DNSSEC + validation functions
|
2012-02-18 20:49:02 +00:00
|
|
|
* 4255 - SSHFP record
|
2013-09-20 15:15:27 +00:00
|
|
|
* 4343 - Case insensitivity
|
2012-02-18 20:49:02 +00:00
|
|
|
* 4408 - SPF record
|
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
|
2012-02-18 20:25:37 +00:00
|
|
|
* 4701 - DHCID
|
2011-07-29 10:24:41 +00:00
|
|
|
* 4892 - id.server
|
2013-09-20 15:15:27 +00:00
|
|
|
* 5001 - NSID
|
2012-02-18 20:49:02 +00:00
|
|
|
* 5155 - NSEC3 record
|
|
|
|
* 5205 - HIP record
|
2012-04-18 12:52:49 +00:00
|
|
|
* 5702 - SHA2 in the DNS
|
2011-01-27 08:29:11 +00:00
|
|
|
* 5936 - AXFR
|
2013-10-18 22:07:48 +00:00
|
|
|
* 5966 - TCP implementation recommendations
|
2012-05-03 06:59:02 +00:00
|
|
|
* 6605 - ECDSA
|
2014-10-23 08:12:02 +00:00
|
|
|
* 6725 - IANA Registry Update
|
2012-11-17 20:26:48 +00:00
|
|
|
* 6742 - ILNP DNS
|
2015-10-06 06:59:47 +00:00
|
|
|
* 6840 - Clarifications and Implementation Notes for DNS Security
|
2015-06-16 09:01:28 +00:00
|
|
|
* 6844 - CAA record
|
2013-04-27 15:57:33 +00:00
|
|
|
* 6891 - EDNS0 update
|
2013-10-13 12:28:48 +00:00
|
|
|
* 6895 - DNS IANA considerations
|
2019-05-20 06:44:43 +00:00
|
|
|
* 6944 - DNSSEC DNSKEY Algorithm Status
|
2014-08-30 15:46:37 +00:00
|
|
|
* 6975 - Algorithm Understanding in DNSSEC
|
2014-01-28 10:59:12 +00:00
|
|
|
* 7043 - EUI48/EUI64 records
|
2014-07-21 18:31:28 +00:00
|
|
|
* 7314 - DNS (EDNS) EXPIRE Option
|
Implement CSYNC (#585)
Implement the CSYNC record.
Fixes #290
Long overdue, lets add this record. Similar in vain as NSEC/NSEC3, we
need to implement len() our selves. Presentation format parsing and
tests are done as well.
This is CoreDNS running with CSYNC support, `dig` doesn't support this
at the moment, so:
~~~
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 40323
;; flags: qr aa rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 2, ADDITIONAL: 1
;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 4096
;; QUESTION SECTION:
;csync.example.org. IN TYPE62
;; ANSWER SECTION:
csync.example.org. 10 IN TYPE62 \# 12 000335240042000460000008
;; AUTHORITY SECTION:
example.org. 10 IN NS a.iana-servers.net.
example.org. 10 IN NS b.iana-servers.net.
~~~
2017-11-25 08:19:06 +00:00
|
|
|
* 7477 - CSYNC RR
|
2017-02-15 20:40:16 +00:00
|
|
|
* 7828 - edns-tcp-keepalive EDNS0 Option
|
2015-07-21 06:47:38 +00:00
|
|
|
* 7553 - URI record
|
2017-11-07 17:37:25 +00:00
|
|
|
* 7858 - DNS over TLS: Initiation and Performance Considerations
|
2017-11-28 07:48:19 +00:00
|
|
|
* 7871 - EDNS0 Client Subnet
|
2019-01-03 16:37:57 +00:00
|
|
|
* 7873 - Domain Name System (DNS) Cookies
|
2017-11-27 10:49:53 +00:00
|
|
|
* 8080 - EdDSA for DNSSEC
|
2019-01-03 16:37:57 +00:00
|
|
|
* 8499 - DNS Terminology
|
2021-02-23 09:10:31 +00:00
|
|
|
* 8659 - DNS Certification Authority Authorization (CAA) Resource Record
|
2021-04-08 15:11:06 +00:00
|
|
|
* 8914 - Extended DNS Errors
|
2021-02-23 09:10:31 +00:00
|
|
|
* 8976 - Message Digest for DNS Zones (ZONEMD RR)
|
2010-12-21 13:41:48 +00:00
|
|
|
|
2018-11-27 14:39:19 +00:00
|
|
|
## Loosely Based Upon
|
2011-02-10 11:26:26 +00:00
|
|
|
|
2018-11-27 14:39:19 +00:00
|
|
|
* ldns - <https://nlnetlabs.nl/projects/ldns/about/>
|
|
|
|
* NSD - <https://nlnetlabs.nl/projects/nsd/about/>
|
|
|
|
* Net::DNS - <http://www.net-dns.org/>
|
|
|
|
* GRONG - <https://github.com/bortzmeyer/grong>
|