A command-line DNS lookup tool that supports DNS queries over UDP, TCP, TLS, HTTPS, DNSCrypt, and QUIC. https://dns.froth.zone/awl/
Go to file
Sam Therapy 0a6d6b432c
Mirror Push / mirror (push) Successful in 11s Details
Test / test (oldstable) (push) Successful in 43s Details
Test / test (stable) (push) Successful in 38s Details
Gitea Release / release (push) Failing after 1m10s Details
fix(ci): Force goreleaser to use gitea
Signed-off-by: Sam Therapy <sam@samtherapy.net>
2023-11-08 22:04:09 +01:00
.gitea/workflows fix(ci): Force goreleaser to use gitea 2023-11-08 22:04:09 +01:00
.github misc: Cleanup before a release 2023-11-08 21:45:39 +01:00
cmd fix(deps): update module gotest.tools/v3 to v3.5.0 (#202) 2023-08-10 15:07:46 +00:00
completions feat: Trace (#162) 2022-12-10 17:51:49 +00:00
conf feat: change import URL 2023-02-17 19:18:58 +01:00
coverage (refactor) Draw the rest of the owl (#38) 2022-07-26 00:32:31 +00:00
doc misc: Cleanup before a release 2023-11-08 21:45:39 +01:00
pkg feat!(quic): Remove gccgo support 2023-11-08 21:51:44 +01:00
snap misc: Snapcraft support (#87) 2022-09-28 18:32:20 +00:00
.editorconfig refactor: Make tests less ugly (#102) 2022-09-21 23:08:31 +00:00
.gitignore fix(goreleaser): stop using universal binaries 2023-02-20 20:35:52 +01:00
.gitmodules Remove AUR submodule 2022-09-27 15:36:34 +00:00
.golangci.yaml feat: more API work 2022-09-15 11:02:43 +00:00
.goreleaser.yaml misc: Cleanup before a release 2023-11-08 21:45:39 +01:00
GNUmakefile fix(Make): stop compressing the manpages 2023-02-16 23:23:10 +01:00
LICENCE (feat)EDNS (#55) 2022-08-04 01:09:49 +00:00
Makefile fix(Make): stop compressing the manpages 2023-02-16 23:23:10 +01:00
README.md feat(goreleaser): Vastly simplify upload process (#229) 2023-11-08 18:02:34 +00:00
docs.go (feat)Completions and documentation (#78) 2022-09-04 23:28:47 +00:00
go.mod fix(deps): go get -u 2023-11-08 21:47:19 +01:00
go.sum fix(deps): go get -u 2023-11-08 21:47:19 +01:00
main.go feat: change import URL 2023-02-17 19:18:58 +01:00
main_test.go feat: Trace (#162) 2022-12-10 17:51:49 +00:00
mkfile fix(mk): Add version number in -V 2023-08-11 20:22:16 +02:00
renovate.json Another "minor refactor" (#61) 2022-08-11 07:25:36 +00:00
template.mk feat(goreleaser): Vastly simplify upload process (#229) 2023-11-08 18:02:34 +00:00

README.md

awl

Build Status

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

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/packages/scoop.git
    scoop install awl
    

From source

Dependencies:

  • Go >= 1.20
  • 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