3 releases
new 0.2.6 | Apr 19, 2024 |
---|---|
0.2.5 | Feb 22, 2024 |
#158 in Command line utilities
184 downloads per month
3.5MB
2.5K
SLoC
Doge can look up!
doge is a command-line DNS client, like dig
forked from the amazing work done here.
It has colourful output, understands normal command-line argument syntax, supports the DNS-over-TLS and DNS-over-HTTPS protocols, and can emit JSON. I belive this is an amazing project and should be improved on.
Examples
doge example.net Query a domain using default settings
doge example.net MX ...looking up MX records instead
doge example.net MX @1.1.1.1 ...using a specific nameserver instead
doge example.net MX @1.1.1.1 -T ...using TCP rather than UDP
doge exapple.net MX @1.1.1.1 -p 53 ...using a nonstandart port
doge -q example.net -t MX -n 1.1.1.1 -T As above, but using explicit arguments
Command-line options
Query options
<arguments> Human-readable host names, nameservers, types, or classes
-q, --query=HOST Host name or domain name to query
-t, --type=TYPE Type of the DNS record being queried (A, MX, NS...)
-n, --nameserver=ADDR Address of the nameserver to send packets to
-p, --port=PORT Port options for sending queries on nonstandart ports
--class=CLASS Network class of the DNS record being queried (IN, CH, HS)
Sending options
--edns=SETTING Whether to OPT in to EDNS (disable, hide, show)
--txid=NUMBER Set the transaction ID to a specific value
-Z=TWEAKS Set uncommon protocol-level tweaks
Protocol options
-U, --udp Use the DNS protocol over UDP
-T, --tcp Use the DNS protocol over TCP
-S, --tls Use the DNS-over-TLS protocol
-H, --https Use the DNS-over-HTTPS protocol
Output options
-1, --short Short mode: display nothing but the first result
-J, --json Display the output as JSON
--color, --colour=WHEN When to colourise the output (always, automatic, never)
--seconds Do not format durations, display them as seconds
--time Print how long the response took to arrive
Installation
Currently: To install dog, you can download a pre-compiled binary, or you can compile it from source. You may be able to install dog using your OS’s package manager, depending on your platform.
Project existence
I am not a rust expert at all, Honestly I'm the opposite, just learning codding. I used [`dog`](https://github.com/ogham/dog) on my arch system and a few random *nix
Laptops that I perpetually fix and break . As such part of this progect will be outside of my skill set or ability to work on currently. Things such as :
*Windows support as a whole
*MACOS support as a whole (I'm never buying a mac so this won't be touched by me) I'll merge PRs if thats you thing
*Docker is magic as far as im concerned. I'm working on learning how to practically use it, but for now I wouldn't hold my breath
If any of these are things you want to see make a PR and I'll read and merge it, Be on the lookout for some potentially dumb questions from me.
Packages
This is currelty a Work in progress
$ cargo install dns-doge
Downloads
Binary downloads of doge are available from the releases section on GitHub for 64-bit Windows, macOS, and Linux targets. They contain the compiled executable, the manual page, and shell completions.
Compilation
doge is written in Rust. I working on rustc version 1.76.0 you should be running this version or newer. The recommended way to install Rust for development is from the official download page, using rustup.
To build, download the source code and run:
$ cargo build
$ cargo test
-
The just command runner can be used to run some helpful development commands, in a manner similar to
make
. Runjust --list
to get an overview of what’s available. -
If you are compiling a copy for yourself, be sure to run
cargo build --release
orjust build-release
to benefit from release-mode optimisations. Copy the resulting binary, which will be in thetarget/release
directory, into a folder in your$PATH
./usr/local/bin
is usually a good choice. -
To compile and install the manual pages, you will need pandoc. The
just man
command will compile the Markdown into manual pages, which it will place in thetarget/man
directory. To use them, copy them into a directory thatman
will read./usr/local/share/man
is usually a good choice.
Container image
These may still work but they will be unstable as I might break them.
To build the container image of doge, you can use Docker or Kaniko. Here an example using Docker:
$ docker build -t doge .
You can then run it using the following command:
$ docker run -it --rm doge
To run dog directly, you can then define the following alias:
$ alias doge="docker run -it --rm doge"
End-to-end testing
doge has an integration test suite written as Specsheet check documents. If you have a copy installed, you can run:
$ just xtests
Specsheet will test the compiled binary by making DNS requests over the network, checking that doge returns the correct results and does not crash. Note that this will expose your IP address. For more information, read the xtests README.
Feature toggles
doge has three Cargo features that can be switched off to remove functionality. While doing so makes doge less useful, it results in a smaller binary that takes less time to build.
There are three feature toggles available, all of which are active by default:
with_idna
, which enables IDNA processingwith_tls
, which enables DNS-over-TLSwith_https
, which enables DNS-over-HTTPS (requireswith_tls
)
Use cargo
to build a binary that uses feature toggles. For example, to disable TLS and HTTPS support but keep IDNA support enabled, you can run:
$ cargo build --no-default-features --features=with_idna
The list of features that have been disabled can be checked at runtime as part of the --version
string.
Documentation
For documentation on how to use doge, see the dog website: https://dns.lookup.dog/ Eventually I will make a new one
Licence
doge’s source code is licenced under the MIT. If this is wrong please email me at dwhitfield@ramfield.net
Dependencies
~1–15MB
~184K SLoC