awl/README.md

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 (any .deb consuming distro should work):

  # Add PGP key
  sudo curl https://git.froth.zone/api/packages/sam/debian/repository.key -o /usr/share/keyrings/git-froth-zone.asc
  # Add repo
  echo "deb [signed-by=/usr/share/keyrings/git-froth-zone.asc]  https://git.froth.zone/api/packages/sam/debian sid main" | sudo tee /etc/apt/sources.list.d/git-froth-zone.list
  sudo apt update
  sudo apt install awl-dns
  

• Fedora (any .rpm consuming distro should work but will run into problems updating, not recommended):

  echo '[git-froth-zone-sam]
  name=sam - Froth Git
  baseurl=https://git.froth.zone/api/packages/sam/rpm
  enabled=1
  gpgcheck=0
  gpgkey=https://git.froth.zone/api/packages/sam/rpm/repository.key' | sudo tee /etc/yum.repos.d/git-froth-zone-sam.repo
  sudo yum install awl-dns
  

• Alpine (any .apk consuming distro should work):

  echo "https://git.froth.zone/api/packages/sam/alpine/edge/main" | sudo tee -a /etc/apk/repositories
  sudo curl -JO https://git.froth.zone/api/packages/sam/alpine/key --output-dir /etc/apk/keys
  sudo apk add awl-dns
  

• 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