mirror of
https://github.com/NLnetLabs/domain.git
synced 2026-09-13 13:27:44 +02:00
Martin HoffmannandGitHub
1d10bb6300
This PR updates all non-user visible dependencies. It also makes a slight change to the CI workflow to make it compatible with our Minimal Supported Rust Version policy.
76 lines
3.1 KiB
Markdown
76 lines
3.1 KiB
Markdown
# domain – A DNS library for Rust
|
||
|
||
[](https://crates.io/crates/domain)
|
||
[](https://docs.rs/domain)
|
||
[](https://community.nlnetlabs.nl/c/dns-libraries-tools/12)
|
||
[](https://social.nlnetlabs.nl/@nlnetlabs)
|
||
|
||
|
||
A library for interacting with the Domain Name System. The crate contains
|
||
an ever-growing set of building blocks for including DNS functionality in
|
||
applications.
|
||
|
||
|
||
Currently, these blocks include:
|
||
|
||
* basic data structures and functionality for creating and parsing DNS
|
||
data and messages,
|
||
* a simple Tokio-based stub resolver,
|
||
* experimental support for DNS client and server transports,
|
||
* experimental support for reading data from DNS zone files, storing them
|
||
in memory and answering queries,
|
||
* experimental support for zone transfer, including support for TSIG,
|
||
* experimental and as yet incomplete support for DNSSEC signing and
|
||
validation.
|
||
|
||
The library is currently under
|
||
[heavy development](https://blog.nlnetlabs.nl/domain-foundations-the-first-of-our-five-year-vision/)
|
||
and additional building blocks and features are being added.
|
||
|
||
## Applications
|
||
|
||
We are maintaining several applications that are built on top of domain,
|
||
including:
|
||
|
||
* [cascade](https://github.com/NLnetLabs/cascade) – a DNSSEC signing pipeline
|
||
* [dnsi](https://github.com/NLnetLabs/dnsi) – a command-line tool to inspect
|
||
various aspects of the DNS
|
||
* [dnst](https://nlnetlabs.nl/projects/domain/dnst/) – a set of binaries
|
||
that reimplement some of the widely used ldns utilities in Rust
|
||
* [mimir](https://github.com/NLnetLabs/mimir) – a DNS proxy and load balancer
|
||
|
||
## Minimal Supported Rust Versions
|
||
|
||
We are trying to maintain a decent balance between being able to use older
|
||
compiler versions and using new features that improve safety and usability
|
||
of the crate. We will support the latest 4 versions of stable Rust, which is
|
||
about half a year (24 weeks) past. This means our MSRV is at least 4 versions
|
||
behind the latest stable.
|
||
|
||
We will bump the MSRV when a dependency requires it (and we cannot support an
|
||
older version of the dependency) or when we require new language features. In
|
||
either case, commits bumping the MSRV will document why it occurred.
|
||
|
||
### Minimum version: 1.87.0
|
||
|
||
The `rust-version` given in `Cargo.toml` is the oldest version that can
|
||
be used to compile the crate with the minimal versions of all dependencies
|
||
selected.
|
||
|
||
You can run `cargo +nightly update -Z minimal-versions` to ask Cargo to
|
||
select these minimal versions for all dependencies.
|
||
|
||
### Current version: 1.95.0
|
||
|
||
This is the minimum Rust version required to build with latest version of
|
||
all dependencies at time of release. `Cargo.lock` contains these versions
|
||
for reference.
|
||
|
||
## Licensing
|
||
|
||
The domain crate is distributed under the terms of the BSD-3-clause
|
||
license. See the [LICENSE] file for details.
|
||
|
||
[LICENSE]: https://github.com/NLnetLabs/domain/blob/main/LICENSE
|
||
|