This is a clone/fork of https://github.com/miekg/dns
Go to file
Spencer Comfort d8fbd0a755
Update actions & add go 1.19.x and 1.20.x to go workflow (#1414)
* Update actions

* Update go.yml

* Update go.yml

* Update go.yml
2023-02-02 19:52:49 +01:00
.github/workflows Update actions & add go 1.19.x and 1.20.x to go workflow (#1414) 2023-02-02 19:52:49 +01:00
dnsutil Fix typos (#1413) 2023-01-14 08:19:09 +01:00
.codecov.yml Add codecov yaml to not fail the build (#600) 2017-12-06 10:36:23 +00:00
.gitignore gitignore update 2013-10-15 13:22:35 +00:00
AUTHORS add AUTHOR file 2014-02-10 17:15:49 +00:00
CODEOWNERS Add CODEOWNERS (#1042) 2019-12-09 11:50:19 +00:00
CONTRIBUTORS Correctly set the Source IP to the received Destination IP (#524) 2017-09-29 10:38:26 +01:00
COPYRIGHT Remove all copyright notices 2014-09-11 20:57:37 +01:00
LICENSE Restructure license so Github will recognize it. (#1397) 2022-11-12 12:37:31 +01:00
Makefile.fuzz Add fuzzing framework (#580) 2017-11-23 09:34:31 +00:00
Makefile.release Spelling (#1222) 2021-02-25 17:08:05 +01:00
README.md readme: add some very thankful users (#1415) 2023-01-22 16:52:13 +01:00
acceptfunc.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
acceptfunc_test.go Support generic net.PacketConn's for the Server (#1174) 2020-10-25 02:23:01 +10:30
client.go Fix typos (#1413) 2023-01-14 08:19:09 +01:00
client_test.go Add back support for *net.UnixCon with seqpacket type (#1378) 2022-06-08 14:03:24 +02:00
clientconfig.go Use for range loops instead of manual for loops (#937) 2019-03-18 07:06:44 +00:00
clientconfig_test.go fix: panicing on options parsing. (#642) 2018-03-01 06:22:09 -08:00
dane.go Improve performance by addressing some low hanging fruit. (#444) 2017-02-02 07:33:49 +00:00
defaults.go Disallow names that start with '.' in IsDomainName() (#1376) 2022-05-26 15:06:08 +02:00
dns.go Fix Rdlength related parsing bug in RFC3597 records (#1214) 2021-02-01 09:10:38 +01:00
dns_bench_test.go ZoneParser: error on parsing an IPv6 address in an A record (#923) 2019-03-09 09:02:18 +00:00
dns_test.go Properly calculate compressed message lengths (#833) 2018-11-30 10:03:41 +10:30
dnssec.go Fix RSAMD5 keytag calucation. (#1353) 2022-04-01 14:01:47 +02:00
dnssec_keygen.go Use ed25519 from Go standard lib (#1243) 2021-03-16 15:37:10 +01:00
dnssec_keyscan.go Use ed25519 from Go standard lib (#1243) 2021-03-16 15:37:10 +01:00
dnssec_privkey.go Use ed25519 from Go standard lib (#1243) 2021-03-16 15:37:10 +01:00
dnssec_test.go Fix RSAMD5 keytag calucation. (#1353) 2022-04-01 14:01:47 +02:00
doc.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
duplicate.go Doc updates (#1075) 2020-02-14 22:47:21 +01:00
duplicate_generate.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
duplicate_test.go Implement SVCB (#1067) 2020-10-11 09:09:36 +02:00
dyn_test.go Remove all copyright notices 2014-09-11 20:57:37 +01:00
edns.go Update edns.go (#1409) 2023-01-06 08:54:28 +01:00
edns_test.go Fix edns keepalive (#1317) 2021-12-23 09:45:02 +01:00
example_test.go Fix examples by using net.JoinHostPort (#1368) 2022-04-15 10:13:08 +02:00
format.go Add checks on data length for A and AAAA records (#919) 2019-03-12 16:31:33 +00:00
format_test.go Add checks on data length for A and AAAA records (#919) 2019-03-12 16:31:33 +00:00
fuzz.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
fuzz_test.go Spelling (#1222) 2021-02-25 17:08:05 +01:00
generate.go Fix potentially truncated int casts in $GENERATE code (#1212) 2021-01-30 10:07:06 +01:00
generate_test.go Fix potentially truncated int casts in $GENERATE code (#1212) 2021-01-30 10:07:06 +01:00
go.mod Fix go generate missing required go.mod entry (#1290) 2021-09-14 16:59:49 +02:00
go.sum Fix go generate missing required go.mod entry (#1290) 2021-09-14 16:59:49 +02:00
hash.go Add indentityHash for algos that don't need hashing (#1340) 2022-03-12 09:41:21 +01:00
issue_test.go tests: reduce timeouts and iterations (#1175) 2020-10-16 09:10:36 +02:00
labels.go Remove space between NextLabel func and doc comment (#1410) 2023-01-06 08:51:52 +01:00
labels_test.go Disallow names that start with '.' in IsDomainName() (#1376) 2022-05-26 15:06:08 +02:00
leak_test.go Revert doh (#800) 2018-11-01 20:16:39 +00:00
length_test.go Make the 900 number lower in this test (#1176) 2020-10-16 11:55:29 +02:00
listen_no_reuseport.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
listen_reuseport.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
msg.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
msg_generate.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
msg_helpers.go Add more detail to NSEC packing errors (#1374) 2022-05-27 11:01:25 +02:00
msg_helpers_test.go Invalid NSEC/3 bitmap on non-zero buffer (#1338) 2022-04-01 14:01:05 +02:00
msg_test.go Add test for forward compression pointer (#1123) 2020-05-27 08:05:25 +00:00
msg_truncate.go Update Truncate doc with compress behaviour (#1217) 2021-02-10 07:41:26 +01:00
msg_truncate_test.go Fix typos (#1413) 2023-01-14 08:19:09 +01:00
nsecx.go Doc updates (#1075) 2020-02-14 22:47:21 +01:00
nsecx_test.go Add a HashName benchmark 2018-11-29 10:28:29 +10:30
parse_test.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
privaterr.go small cleans from go report card (#1268) 2021-06-17 11:05:49 +02:00
privaterr_test.go refactor: remove ParseZone and parseZone (#1099) 2020-04-28 09:24:18 +02:00
reverse.go Move all reversed map creation into reverse.go (#889) 2019-01-04 08:10:15 +00:00
rr_test.go Eliminate lexer goroutines (#792) 2018-10-15 17:42:31 +10:30
sanitize.go Avoid calling RR.Header more than once per RR (#891) 2019-01-04 08:12:32 +00:00
sanitize_test.go Tests updates (#556) 2017-11-08 10:01:19 +00:00
scan.go zoneparser: document not checking syntax (#1245) 2021-03-22 16:21:34 +01:00
scan_rr.go small cleans from go report card (#1268) 2021-06-17 11:05:49 +02:00
scan_test.go Fix Rdlength related parsing bug in RFC3597 records (#1214) 2021-02-01 09:10:38 +01:00
serve_mux.go answer queries with no matching handler with RcodeRefused (#1151) 2020-08-20 08:41:45 +02:00
serve_mux_test.go Rework and optimise ServeMux (#754) 2018-09-27 07:48:02 +01:00
server.go Fix typos (#1413) 2023-01-14 08:19:09 +01:00
server_test.go Add back support for *net.UnixCon with seqpacket type (#1378) 2022-06-08 14:03:24 +02:00
sig0.go Add indentityHash for algos that don't need hashing (#1340) 2022-03-12 09:41:21 +01:00
sig0_test.go Add indentityHash for algos that don't need hashing (#1340) 2022-03-12 09:41:21 +01:00
singleinflight.go Prevent timeout in TestConcurrentExchanges (#862) 2018-12-04 07:29:08 +00:00
smimea.go Simplify and unify various returns (#893) 2019-01-04 10:19:42 +00:00
svcb.go Fix typos (#1413) 2023-01-14 08:19:09 +01:00
svcb_test.go Properly parse alpn values in SVCB (#1363) 2022-05-10 18:40:09 +02:00
tlsa.go Simplify and unify various returns (#893) 2019-01-04 10:19:42 +00:00
tools.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
tsig.go Make tsigGenerateProvider/TsigVerifyProvider public (#1382) 2022-06-21 10:37:36 +02:00
tsig_test.go Make tsigGenerateProvider/TsigVerifyProvider public (#1382) 2022-06-21 10:37:36 +02:00
types.go small cleans from go report card (#1268) 2021-06-17 11:05:49 +02:00
types_generate.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
types_test.go Be consistent about domain name label character escaping (#1122) 2020-07-06 10:07:56 +02:00
udp.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
udp_test.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
udp_windows.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
update.go fix Msg.Used TTL must be zero (#1280) 2021-07-18 09:24:05 +02:00
update_test.go Fix typos (#1413) 2023-01-14 08:19:09 +01:00
version.go Release 1.1.50 2022-06-21 10:38:26 +02:00
version_test.go Doc updates (#1075) 2020-02-14 22:47:21 +01:00
xfr.go Run gofmt -w -s *.go (#1408) 2023-01-05 07:53:57 +01:00
xfr_test.go Support TsigProvider for Server and Transfer (#1331) 2022-02-05 00:23:49 +00:00
zduplicate.go Implementation of zone digest (ZONEMD) (#1208) 2021-02-26 16:35:05 +01:00
zmsg.go Implementation of zone digest (ZONEMD) (#1208) 2021-02-26 16:35:05 +01:00
ztypes.go Implementation of zone digest (ZONEMD) (#1208) 2021-02-26 16:35:05 +01:00

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 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
  • 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

Have fun!

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

Building

This library uses Go modules and uses semantic versioning. Building is done with the go tool, so 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
  • 3123 - APL record
  • 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
  • 6944 - DNSSEC DNSKEY Algorithm Status
  • 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
  • 8080 - EdDSA for DNSSEC
  • 8499 - DNS Terminology
  • 8659 - DNS Certification Authority Authorization (CAA) Resource Record
  • 8914 - Extended DNS Errors
  • 8976 - Message Digest for DNS Zones (ZONEMD RR)

Loosely Based Upon