17 releases (10 breaking)
0.11.1 | Dec 23, 2022 |
---|---|
0.10.3 | Oct 4, 2022 |
0.10.2 | Jul 30, 2022 |
0.9.1 | Jan 21, 2022 |
0.9.0 | Nov 21, 2021 |
#700 in Command line utilities
75 downloads per month
57KB
1.5K
SLoC
ch4 - DNS Client Tool
ch4 is a DNS Client CLI tool built around rsdns.
ch4's primary goal is to expose rsdns's capabilities in a concise manner. It can be used as a simple substitute for dig, with which it tries to be mostly compatible.
ch4 by default uses the tokio async runtime and the
corresponding rsdns client. It can be built with all clients and async runtimes supported
by rsdns via the same set of features net-tokio
, net-async-std
, net-smol
and net-std
.
Features
- Built on Linux, Windows, and MacOS
- Auto-detection of operating system's default nameserver
Supported RFCs
- rsdns supported RFCs
- RFC 3597 - text representation of unknown record types
Installation
cargo install ch4
ch4 currently doesn't provide pre-built binaries. See rustrup.rs for installation of cargo and the Rust toolchain.
Examples
Nameserver address can be specified with the @
prefix.
$> ch4 @8.8.8.8 A docs.rs
; <<>> ch4 0.9.0 git:a9a5dc5 <<>> @8.8.8.8 docs.rs
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 32221
;; flags: qr rd ra; QUERY: 1, ANSWER: 4, AUTHORITY: 0, ADDITIONAL: 1
;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 512
;; QUESTION SECTION:
;docs.rs. IN A
;; ANSWER SECTION:
docs.rs. 60 IN A 13.226.6.17
docs.rs. 60 IN A 13.226.6.38
docs.rs. 60 IN A 13.226.6.84
docs.rs. 60 IN A 13.226.6.69
;; Query time: 95.678652ms
;; SERVER: 8.8.8.8:53
;; WHEN: Sat, 20 Nov 2021 23:50:24 +0200
;; MSG SIZE rcvd: 100
When nameserver is not specified, it is auto-detected from the OS configuration.
$> ch4 crates.io ANY
; <<>> ch4 0.9.0 git:a9a5dc5 <<>> crates.io ANY
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 23571
;; flags: qr rd ra; QUERY: 1, ANSWER: 12, AUTHORITY: 0, ADDITIONAL: 3
;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 65494
;; QUESTION SECTION:
;crates.io. IN ANY
;; ANSWER SECTION:
crates.io. 300 IN TXT "v=spf1 include:mailgun.org ~all"
crates.io. 300 IN MX 10 mxb.mailgun.org.
crates.io. 300 IN MX 10 mxa.mailgun.org.
crates.io. 900 IN SOA ns-1064.awsdns-05.org. awsdns-hostmaster.amazon.com. 1 7200 900 1209600 86400
crates.io. 60 IN A 13.226.6.20
crates.io. 60 IN A 13.226.6.118
crates.io. 60 IN A 13.226.6.62
crates.io. 60 IN A 13.226.6.11
crates.io. 60 IN NS ns-1543.awsdns-00.co.uk.
crates.io. 60 IN NS ns-817.awsdns-38.net.
crates.io. 60 IN NS ns-217.awsdns-27.com.
crates.io. 60 IN NS ns-1064.awsdns-05.org.
;; ADDITIONAL SECTION:
ns-217.awsdns-27.com. 20015 IN A 205.251.192.217
ns-817.awsdns-38.net. 19938 IN A 205.251.195.49
;; Query time: 15.686517ms
;; SERVER: 127.0.0.53:53
;; WHEN: Sat, 20 Nov 2021 23:50:36 +0200
;; MSG SIZE rcvd: 427
Options
ch4's options follow the features exposed by rsdns.
The detailed list of options is shown via --help
flag.
$> ch4 --help
ch4 0.9.0 git:a9a5dc5
DNS Client
USAGE:
ch4 [FLAGS] [OPTIONS] [positional]...
FLAGS:
-h, --help
Prints help information
--info
Prints build information
--list-nameservers
Lists system nameservers
-V, --version
Prints version information
OPTIONS:
-p, --port <port>
[default: 53]
-l, --query-lifetime <query-lifetime>
query lifetime (in msec). [default: 10000]
-t, --query-timeout <query-timeout>
query timeout (in msec). Use 0 to disable. [default: 2000]
-r, --read <read-path>
read responses from file
-s, --save <save-path>
save responses to file
ARGS:
<positional>...
Positional arguments ...
Positional arguments may be specified without any particular order.
Arguments specified later take precedence.
Arguments that are not recognized as special are treated as names
to be queried.
@<nameserver> - specifies the nameserver IP address.
If not specified, the first nameserver from OS
configuration is used.
<qtype> - query type (A, AAAA, NS ...).
An argument matching any of the supported query types
is considered as query type. Trailing dot can be
used to disambiguate a query name (A.).
+udp - sets the Udp protocol strategy. UDP is used by default.
Truncated responses are retried using TCP.
+tcp - sets the Tcp protocol strategy.
Only TCP is used for all queries.
+notcp - sets NoTcp protocol strategy. Only UDP is used.
Truncated queries are returned as is, without retry.
+[no]rec - enables (disables) recursive query.
Queries are recursive by default.
+[no]short - enables (disables) short output.
When enabled, only record data is printed,
one record on a line.
+bufsize=# - sets the EDNS0 max udp payload size [512, 65535].
[default: 4096]
+[no]edns[=#] - enables/disables EDNS0.
Optionally, sets the EDNS version [0, 255].
By default, EDNS is enabled with version 0.
+[no]rust - enables (disables) rust output.
When enabled, prints the response as a Rust array.
+[no]gen - forces generic output (RFC 3597 s. 5) on all record
types. By default, only unknown record types are
formatted this way.
The list of operating system configured nameservers is shown via the --list-nameservers
flag.
$> ch4 --list-nameservers
8.8.8.8
208.67.222.222
8.26.56.26
Build information is shown via --info
flag.
C:\> ch4.exe --info
build time: Sat, 20 Nov 2021 23:58:49 +0000
ch4 semver: 0.9.0
git hash: n/a
compiler: rustc
rustc: rustc 1.56.0 (09c42c458 2021-10-18)
cargo features: net_tokio, tokio
cargo profile: debug
cargo target: x86_64-pc-windows-msvc
endianness: little
pointer width: 64
build system name: Windows
build os version: Windows Server 2019 Datacenter
build cpu vendor: GenuineIntel
build cpu brand: Intel(R) Xeon(R) CPU E5-2673 v3 @ 2.40GHz
Changelog
The changelog is maintained in CHANGELOG.md
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~5–56MB
~1M SLoC