Skip to content

wintbiit/dns

This branch is 1 commit ahead of, 46 commits behind miekg/dns:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

05c6877 · Dec 11, 2023
Sep 19, 2023
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
Dec 11, 2023
Nov 2, 2023
Oct 24, 2020
Jun 19, 2023
Jun 16, 2023
Mar 12, 2023
Mar 19, 2023
Feb 2, 2017
Nov 6, 2023
Feb 1, 2021
Mar 9, 2019
Apr 27, 2023
Mar 28, 2023
Mar 16, 2021
Nov 6, 2023
Mar 16, 2021
Apr 1, 2022
Jan 5, 2023
Feb 14, 2020
Mar 2, 2023
Oct 11, 2020
Sep 11, 2014
Oct 10, 2023
Dec 23, 2021
Apr 15, 2022
Mar 12, 2019
Mar 12, 2019
Jan 5, 2023
Feb 25, 2021
Nov 6, 2023
Mar 19, 2023
Nov 2, 2023
Nov 2, 2023
Mar 12, 2022
Oct 16, 2020
Jan 6, 2023
Sep 12, 2023
Nov 1, 2018
Oct 16, 2020
Nov 15, 2023
Nov 15, 2023
Nov 6, 2023
Nov 6, 2023
Nov 6, 2023
Mar 28, 2023
May 27, 2020
Feb 10, 2021
Jan 14, 2023
Feb 14, 2020
Nov 28, 2018
Sep 12, 2023
Jun 17, 2021
Apr 28, 2020
Jan 4, 2019
Oct 15, 2018
Jan 4, 2019
Nov 8, 2017
Nov 7, 2023
Nov 6, 2023
Mar 19, 2023
Aug 20, 2020
Sep 27, 2018
Nov 15, 2023
Nov 15, 2023
Mar 12, 2022
Mar 12, 2022
Jan 4, 2019
Nov 6, 2023
May 10, 2022
Jan 4, 2019
Jun 16, 2023
Jun 16, 2023
Jan 5, 2023
Jun 21, 2022
Jun 21, 2022
Sep 12, 2023
Nov 6, 2023
Mar 18, 2023
Jan 5, 2023
Jan 5, 2023
Mar 12, 2023
Jul 18, 2021
Sep 12, 2023
Nov 15, 2023
Feb 14, 2020
Nov 13, 2023
Feb 5, 2022
Feb 26, 2023
Feb 26, 2023
Mar 12, 2023

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

Loosely Based Upon

Packages

No packages published

Languages

  • Go 100.0%