Skip to content

miekg/dns

Folders and files

NameName
Last commit message
Last commit date

Latest commit

97c29ff · Jan 24, 2025
Aug 13, 2024
Jan 14, 2023
Dec 6, 2017
Oct 15, 2013
Feb 10, 2014
Dec 9, 2019
Sep 29, 2017
Sep 11, 2014
Nov 12, 2022
Nov 23, 2017
Feb 25, 2021
Jan 24, 2025
Nov 2, 2023
Jun 13, 2024
Jun 19, 2023
Jun 16, 2023
Mar 12, 2023
Mar 19, 2023
Feb 2, 2017
Feb 15, 2024
Feb 1, 2021
Mar 9, 2019
Apr 27, 2023
Jan 24, 2025
Mar 16, 2021
Jan 15, 2024
Mar 16, 2021
Jan 24, 2025
Jan 5, 2023
Feb 14, 2020
Mar 2, 2023
Oct 11, 2020
Sep 11, 2014
Aug 21, 2024
Dec 23, 2021
Apr 15, 2022
Mar 12, 2019
Mar 12, 2019
Jan 5, 2023
Feb 25, 2021
Jan 15, 2024
Mar 19, 2023
Jan 24, 2025
Jan 24, 2025
Mar 12, 2022
Oct 16, 2020
Jan 6, 2023
Sep 12, 2023
Nov 1, 2018
Oct 16, 2020
Jan 24, 2025
Jan 24, 2025
Mar 29, 2024
Nov 6, 2023
Nov 6, 2023
Mar 28, 2023
May 27, 2020
Feb 10, 2021
Jan 14, 2023
Feb 14, 2020
Nov 28, 2018
Jun 13, 2024
Jan 15, 2024
Apr 28, 2020
Jan 4, 2019
Oct 15, 2018
Jan 4, 2019
Nov 8, 2017
Mar 29, 2024
Jun 13, 2024
Jun 13, 2024
Aug 20, 2020
Sep 27, 2018
Aug 21, 2024
Jan 24, 2025
Jan 24, 2025
Mar 12, 2022
Jan 4, 2019
Jun 13, 2024
Jun 13, 2024
Jan 4, 2019
Jun 16, 2023
Jun 16, 2023
Jan 5, 2023
Jun 21, 2022
Jun 21, 2022
Aug 3, 2024
Nov 6, 2023
Mar 18, 2023
Jan 5, 2023
Jan 5, 2023
Mar 12, 2023
Jul 18, 2021
Sep 12, 2023
Jan 24, 2025
Feb 14, 2020
Jun 13, 2024
Feb 14, 2024
Aug 3, 2024
Aug 3, 2024
Aug 3, 2024

Repository files navigation

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
  • 1183 - ISDN, X25 and other deprecated records
  • 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
  • 3596 - AAAA record
  • 3597 - Unknown RRs
  • 4025 - A Method for Storing IPsec Keying Material in DNS
  • 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
  • 8777 - DNS Reverse IP Automatic Multicast Tunneling (AMT) Discovery
  • 8914 - Extended DNS Errors
  • 8976 - Message Digest for DNS Zones (ZONEMD RR)
  • 9460 - Service Binding and Parameter Specification via the DNS
  • 9461 - Service Binding Mapping for DNS Servers
  • 9462 - Discovery of Designated Resolvers

Loosely Based Upon