This is a clone/fork of https://github.com/miekg/dns
Go to file
Miek Gieben 045ac4ec6c
Fix RSAMD5 keytag calucation. (#1353)
Of course the wording was changed (for the better) in an errata:
https://www.rfc-editor.org/errata/eid193

We still followed the original RFC4034 text. Note I haven't given this
much thought, just changed the 2 into a 3 and ran the test.

Fixes: #1352

Signed-off-by: Miek Gieben <miek@miek.nl>
2022-04-01 14:01:47 +02:00
.github/workflows Remove cifuzz (#1260) 2021-05-10 09:32:16 +02:00
dnsutil improve code quality (#1228) 2021-02-25 17:01:55 +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 Put added license bit at the bottom (#1056) 2019-12-18 06:58:51 +00: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 Add https://github.com/markdingo/autoreverse into list of users (#1319) 2021-12-24 08:09:22 +01:00
acceptfunc.go fixed documentation for DefaultMsgAcceptFunc (#1308) 2021-10-15 09:02:59 +02:00
acceptfunc_test.go Support generic net.PacketConn's for the Server (#1174) 2020-10-25 02:23:01 +10:30
client.go Support TsigProvider for Server and Transfer (#1331) 2022-02-05 00:23:49 +00:00
client_test.go Id check tests: stop using Exchange (#1343) 2022-03-02 13:52:49 +01: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 improve code quality (#1228) 2021-02-25 17:01:55 +01: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 Fix doc typo (#1328) 2022-01-17 08:58:28 +01:00
duplicate.go Doc updates (#1075) 2020-02-14 22:47:21 +01:00
duplicate_generate.go Implement SVCB (#1067) 2020-10-11 09:09:36 +02: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 Handle packing of empty RDATA correctly for EDNS0_EXPIRE (Resolves #1292) (#1293) 2022-03-12 09:42:42 +01:00
edns_test.go Fix edns keepalive (#1317) 2021-12-23 09:45:02 +01:00
example_test.go fix a stupid mistake "undefined: zone" 2015-09-30 09:42:47 -07: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 [fuzzer] Avoid fuzzing parser with line that contains "$INCLUDE" (#1026) 2019-10-10 07:12:53 +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 improve code quality (#1228) 2021-02-25 17:01:55 +01:00
labels_test.go Spelling (#1222) 2021-02-25 17:08:05 +01: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 Bump go.mod and rename reuseport files (#1259) 2021-05-07 09:30:50 +02:00
listen_reuseport.go Bump go.mod and rename reuseport files (#1259) 2021-05-07 09:30:50 +02:00
msg.go Fix location of opt pseudosection and prevent empty additional section in dig-like output (#1320) 2021-12-24 17:12:14 +00:00
msg_generate.go Implement SVCB (#1067) 2020-10-11 09:09:36 +02:00
msg_helpers.go Invalid NSEC/3 bitmap on non-zero buffer (#1338) 2022-04-01 14:01:05 +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 Set the TC bit more aggressively in Truncate (#989) 2019-06-24 16:59:43 +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 Update SVCB (#1341) 2022-04-01 14:00:53 +02: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 Support TsigProvider for Server and Transfer (#1331) 2022-02-05 00:23:49 +00:00
server_test.go Only treat a *net.UnixConn of unixgram as a packet conn (#1322) 2021-12-28 13:52:38 +00: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 Update SVCB (#1341) 2022-04-01 14:00:53 +02:00
svcb_test.go Update SVCB (#1341) 2022-04-01 14:00:53 +02:00
tlsa.go Simplify and unify various returns (#893) 2019-01-04 10:19:42 +00:00
tools.go Fix go generate missing required go.mod entry (#1290) 2021-09-14 16:59:49 +02:00
tsig.go Support TsigProvider for Server and Transfer (#1331) 2022-02-05 00:23:49 +00:00
tsig_test.go Do not sign BADKEY and BADSIG TSIG error responses (#1316) 2021-12-20 10:31:57 +01:00
types.go small cleans from go report card (#1268) 2021-06-17 11:05:49 +02:00
types_generate.go Implement SVCB (#1067) 2020-10-11 09:09:36 +02:00
types_test.go Be consistent about domain name label character escaping (#1122) 2020-07-06 10:07:56 +02:00
udp.go Rollback PR #738 because it breaks compatibility with Windows (#765) 2018-09-29 10:25:59 +01:00
udp_test.go Rollback PR #738 because it breaks compatibility with Windows (#765) 2018-09-29 10:25:59 +01:00
udp_windows.go Simplify and unify various returns (#893) 2019-01-04 10:19:42 +00:00
update.go fix Msg.Used TTL must be zero (#1280) 2021-07-18 09:24:05 +02:00
update_test.go fix Msg.Used TTL must be zero (#1280) 2021-07-18 09:24:05 +02:00
version.go Release 1.1.47 2022-03-12 10:49:06 +01:00
version_test.go Doc updates (#1075) 2020-02-14 22:47:21 +01:00
xfr.go Support TsigProvider for Server and Transfer (#1331) 2022-02-05 00:23:49 +00: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