awl

README

awl

awl is a command-line DNS client, much like drill, dig, dog, doggo, or q.

awl is designed to be a drop-in replacement for the venerable dig, but support newer RFC query types, such as DNS-over-HTTPS and DNS-over-QUIC.

Usage

• Feature wiki
• Manpage

Building and installing

From releases

Grab a prebuilt binary from the release section.

Package Managers

• AUR: awl-dns-git

• Debian/Ubuntu:

  # Add PGP key
  curl -sL https://packages.freecumextremist.finance/key.asc | sudo tee /usr/share/keyrings/awl.asc >/dev/null
  # Add repo
  echo "deb [signed-by=/usr/share/keyrings/awl.asc] https://packages.freecumextremist.finance/awl/apt awl main" | sudo tee /etc/apt/sources.list.d/awl.list >/dev/null
  sudo apt update
  sudo apt install awl
  

• Homebrew:

  brew install SamTherapy/tap/awl
  

• Scoop:

  scoop bucket add froth https://git.froth.zone/sam/scoop.git
  scoop install awl
  

From source

Dependencies:

• Go >= 1.18
• GNU/BSD make or Plan 9 mk (if using the makefile/mkfile)
• scdoc (optional, for man page)

Using go install:

go install dns.froth.zone/awl@latest

Using the makefile:

make && sudo make install

Contributing

Send a pull request our way. Prefer emails? Send a patch to the mailing list.

Found a bug or want a new feature? Create an issue here.

Licence

Revised BSD, See LICENCE

Documentation

Overview

awl is a DNS lookup tool written in Go, similar to (and heavily inspired by) drill.

It runs and displays similar outputs to drill, without any frills. Options are given to print with JSON, XML and YAML.

Supports results from DNS-over-[UDP, TCP, TLS, HTTPS, QUIC] servers

Why use this over the alternatives? Good question.