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 32cce1f248 [SKIP CI] feat(goreleaser): Target termux too		2023-05-16 18:27:42 +02:00
.github	chore(deps): update actions/setup-go action to v4	2023-03-28 20:18:02 +00:00
completions	feat: Trace (#162 )	2022-12-10 17:51:49 +00:00
coverage	(refactor) Draw the rest of the owl (#38 )	2022-07-26 00:32:31 +00:00
doc	fix(doc): fix literally unusable typo in manpage	2023-03-01 16:16:21 +01:00
internal	fix(trace): Remove wrong error message	2023-05-01 17:39:35 +02:00
pkg	fix(resolvers): QUIC: close as soon as the writing is done	2023-03-09 23:39:00 +01:00
snap	misc: Snapcraft support (#87 )	2022-09-28 18:32:20 +00:00
.drone.jsonnet	feat(ci): use my new package utility instead of pages	2023-05-16 18:27:42 +02: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	[SKIP CI] feat(goreleaser): Target termux too	2023-05-16 18:27:42 +02: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	[SKIP CI] docs(readme): Update packaging location	2023-05-16 18:27:42 +02:00
docs.go	(feat)Completions and documentation (#78 )	2022-09-04 23:28:47 +00:00
go.mod	fix(deps): update module golang.org/x/net to v0.10.0	2023-05-16 18:27:42 +02:00
go.sum	fix(deps): update module golang.org/x/net to v0.10.0	2023-05-16 18:27:42 +02:00
main.go	refactor: move config and cmd to internal	2023-04-18 16:36:37 +02:00
main_test.go	feat: Trace (#162 )	2022-12-10 17:51:49 +00:00
mkfile	[SKIP CI] misc: makefile refactoring (#100 )	2022-09-16 23:38:46 +00:00
renovate.json	Another "minor refactor" (#61 )	2022-08-11 07:25:36 +00:00
template.mk	fix(make): use correct tag when version is greater than 10	2022-12-05 15:25:24 +01:00

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

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

dnf config-manager --add-repo https://git.froth.zone/api/packages/sam/rpm/sam.repo
dnf 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