dog

dog is a command-line DNS client.

---

Maintained by 965 and DeepSeek V4 Pro

---

Fork Changes / 分支变更

This fork includes the following improvements over the upstream ogham/dog:

本分支相比上游 ogham/dog 包含以下改进：

Change / 变更	Description / 说明
TLS: OpenSSL → rustls 0.23	Removed native-tls / OpenSSL dependency. Replaced with pure-Rust rustls 0.23, eliminating the need for external OpenSSL libraries. / 移除 native-tls / OpenSSL 依赖，替换为纯 Rust 的 rustls 0.23，无需外部 OpenSSL 库。
Windows DNS resolution fix / Windows DNS 解析修复	Fixed os error 11001 (WSAHOST_NOT_FOUND) on Windows. Upgraded ipconfig 0.2→0.3, rewrote adapter discovery with three-tier fallback, and added bracketless IPv6 address parsing. / 修复 Windows 上 os error 11001 错误。升级 ipconfig 0.2→0.3，重写适配器发现逻辑（三层回退），并添加无括号 IPv6 地址解析。
IPv6 transport support / IPv6 传输支持	UDP transport now binds the correct socket family (IPv4/IPv6) based on the target address, fixing WSAEAFNOSUPPORT errors. Added resolve_socket_addr() for robust address parsing. / UDP 传输层根据目标地址族绑定正确的套接字类型，修复 WSAEAFNOSUPPORT 错误。添加 resolve_socket_addr() 进行鲁棒地址解析。
--verbose flag / --verbose 标志	Added --verbose diagnostic mode showing adapter discovery, nameserver selection, and request/response details. Gate-controlled via verbose!() macro; no output in normal mode. / 添加 --verbose 诊断模式，显示网卡发现、DNS 服务器选择、请求/响应详情。通过 verbose!() 宏门控，正常模式无输出。
Chinese localization / 中文支持	Auto-detects system language on Windows (GetUserDefaultUILanguage) and Unix (LANG). 23+ translated messages (status codes, wire errors, resolver errors, help text). Fallback to English when locale is not Chinese. / 自动检测系统语言（Windows: GetUserDefaultUILanguage，Unix: LANG）。翻译 23+ 条消息（状态码、数据包错误、解析器错误、帮助文本）。非中文环境下回退到英文。
Dependency updates / 依赖更新	Upgraded: base64 0.13→0.22, unic-idna→idna 1.1, atty→is-terminal 0.4, byteorder 1.3→1.5, ipconfig 0.2→0.3, pretty_assertions 0.7→1, rustls 0.19→0.23, webpki-roots 0.21→0.26. / 升级多个过时依赖。

---

Dogs can look up!

dog is a command-line DNS client, like dig. It has colourful output, understands normal command-line argument syntax, supports the DNS-over-TLS and DNS-over-HTTPS protocols, and can emit JSON.

dog example.net                          Query a domain using default settings
dog example.net MX                       ...looking up MX records instead
dog example.net MX @1.1.1.1              ...using a specific nameserver instead
dog example.net MX @1.1.1.1 -T           ...using TCP rather than UDP
dog -q example.net -t MX -n 1.1.1.1 -T   As above, but using explicit arguments

<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
--class=CLASS            Network class of the DNS record being queried (IN, CH, HS)

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

-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

-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

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.

• For Arch Linux, install the dog package.
• For Homebrew on macOS, install the dog formula.
• For NixOS, install the dogdns package.

Binary downloads of dog 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.

dog is written in Rust. You will need rustc version 1.45.0 or higher. 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. Run just --list to get an overview of what’s available.

• If you are compiling a copy for yourself, be sure to run cargo build --release or just build-release to benefit from release-mode optimisations. Copy the resulting binary, which will be in the target/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 the target/man directory. To use them, copy them into a directory that man will read. /usr/local/share/man is usually a good choice.

To build the container image of dog, you can use Docker or Kaniko. Here an example using Docker:

$ docker build -t dog .

You can then run it using the following command:

$ docker run -it --rm dog

To run dog directly, you can then define the following alias:

$ alias dog="docker run -it --rm dog"

dog 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 dog returns the correct results and does not crash. Note that this will expose your IP address. For more information, read the xtests README.

dog has three Cargo features that can be switched off to remove functionality. While doing so makes dog 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 processing
• with_tls, which enables DNS-over-TLS
• with_https, which enables DNS-over-HTTPS (requires with_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.

For documentation on how to use dog, see the website: https://dns.lookup.dog/

mutt, tail, sleep, roff

dog’s source code is licenced under the European Union Public Licence.