docs: establish the MSRV policy (current is 1.89) (#1157)

CBenoit · web-flow · commit c10e6ff16cc4 · 2026-03-09T15:49:34.000Z
The MSRV is the oldest stable Rust release that is at least 6 months
old, bounded by the Rust version available in Debian stable-backports
and Fedora stable.
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
@@ -299,6 +299,30 @@ The expectation is that, if `cargo xtask ci` passes locally, the CI will be gree
 **Architecture Invariant**: `cargo xtask ci` and CI workflow must be logically equivalents. It must
 be the case that a successful `cargo xtask ci` run implies a successful CI workflow run and vice versa.
 
+### MSRV policy
+
+IronRDP libraries follow a conservative MSRV (Minimum Supported Rust Version) policy.
+
+**Definition**: The MSRV is the oldest of:
+
+- the latest stable Rust release that is at least 6 months old;
+- the Rust version packaged by the [latest Fedora stable release](https://packages.fedoraproject.org/pkgs/rust/rust/); or
+- the Rust version available in [Debian stable-backports](https://packages.debian.org/search?suite=all&arch=any&searchon=names&keywords=rust).
+
+**Toolchain and CI**: The Rust toolchain pinned in `rust-toolchain.toml` is both the project toolchain and the MSRV validated by CI.
+The `rust-version` key in each published crate's `Cargo.toml` is kept in sync with this toolchain version.
+The workspace is compiled once using the pinned toolchain to keep CI efficient; there are no separate CI jobs dedicated to validating older Rust versions.
+
+**Architecture Invariant**: The MSRV is not validated by a separately configured toolchain or a dedicated CI job.
+The pinned toolchain in `rust-toolchain.toml` serves as the single source of truth.
+
+**Bumping the MSRV**: The MSRV may be bumped when:
+
+- a dependency requires a newer version of Rust; or
+- a newer Rust feature offers a clear maintenance, correctness, or performance benefit.
+
+MSRV bumps must be documented in the release notes and must not occur in patch releases.
+
 ### Testing
 
 #### Test at the boundaries (test features, not code)
diff --git a/README.md b/README.md
@@ -64,6 +64,13 @@ Alternatively, you may change a few group policies using `gpedit.msc`:
 
 5. Reboot.
 
+## Rust version (MSRV)
+
+IronRDP libraries follow a conservative Minimum Supported Rust Version (MSRV) policy.
+The MSRV is the oldest stable Rust release that is at least 6 months old, bounded by the Rust version available in [Debian stable-backports](https://packages.debian.org/search?suite=all&arch=any&searchon=names&keywords=rust) and [Fedora stable](https://packages.fedoraproject.org/pkgs/rust/rust/).
+The pinned toolchain in `rust-toolchain.toml` is both the project toolchain and the MSRV validated by CI.
+See [ARCHITECTURE.md](./ARCHITECTURE.md#msrv-policy) for the full policy.
+
 ## Architecture
 
 See the [ARCHITECTURE.md](https://github.com/Devolutions/IronRDP/blob/master/ARCHITECTURE.md) document.
diff --git a/crates/iron-remote-desktop/Cargo.toml b/crates/iron-remote-desktop/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.7.0"
 readme = "README.md"
 description = "Helper crate for building WASM modules compatible with iron-remote-desktop WebComponent"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-acceptor/Cargo.toml b/crates/ironrdp-acceptor/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.8.0"
 readme = "README.md"
 description = "State machines to drive an RDP connection acceptance sequence"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-ainput/Cargo.toml b/crates/ironrdp-ainput/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.5.0"
 readme = "README.md"
 description = "AInput dynamic channel implementation"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-async/Cargo.toml b/crates/ironrdp-async/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.8.0"
 readme = "README.md"
 description = "Provides `Future`s wrapping the IronRDP state machines conveniently"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-blocking/Cargo.toml b/crates/ironrdp-blocking/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.8.0"
 readme = "README.md"
 description = "Blocking I/O abstraction wrapping the IronRDP state machines conveniently"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-bulk/Cargo.toml b/crates/ironrdp-bulk/Cargo.toml
@@ -3,6 +3,7 @@ name = "ironrdp-bulk"
 version = "0.1.0"
 description = "Bulk compression algorithms (MPPC, XCRUSH, NCRUSH) for IronRDP"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-cfg/Cargo.toml b/crates/ironrdp-cfg/Cargo.toml
@@ -5,6 +5,7 @@ readme = "README.md"
 description = "IronRDP utilities for ironrdp-cfgstore"
 publish = false # TODO: publish
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-client-glutin/Cargo.toml b/crates/ironrdp-client-glutin/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.1.0"
 readme = "README.md"
 description = "GPU-accelerated RDP client using glutin"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-cliprdr-format/Cargo.toml b/crates/ironrdp-cliprdr-format/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.1.4"
 readme = "README.md"
 description = "CLIPRDR format conversion library"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-cliprdr-native/Cargo.toml b/crates/ironrdp-cliprdr-native/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.5.0"
 readme = "README.md"
 description = "Native CLIPRDR static channel backend implementations for IronRDP"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-cliprdr/Cargo.toml b/crates/ironrdp-cliprdr/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.5.0"
 readme = "README.md"
 description = "CLIPRDR static channel for clipboard implemented as described in MS-RDPECLIP"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-connector/Cargo.toml b/crates/ironrdp-connector/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.8.0"
 readme = "README.md"
 description = "State machines to drive an RDP connection sequence"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-core/Cargo.toml b/crates/ironrdp-core/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.1.5"
 readme = "README.md"
 description = "IronRDP common traits and types"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-displaycontrol/Cargo.toml b/crates/ironrdp-displaycontrol/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.5.0"
 readme = "README.md"
 description = "Display control dynamic channel extension implementation"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-dvc-com-plugin/Cargo.toml b/crates/ironrdp-dvc-com-plugin/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.1.0"
 readme = "README.md"
 description = "DVC COM client plugin loader for IronRDP (Windows)"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-dvc-pipe-proxy/Cargo.toml b/crates/ironrdp-dvc-pipe-proxy/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.3.0"
 readme = "README.md"
 description = "DVC named pipe proxy for IronRDP"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-dvc/Cargo.toml b/crates/ironrdp-dvc/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.5.0"
 readme = "README.md"
 description = "DRDYNVC static channel implementation and traits to implement dynamic virtual channels"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-echo/Cargo.toml b/crates/ironrdp-echo/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.1.0"
 readme = "README.md"
 description = "Virtual channel echo extension implementation"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-egfx/Cargo.toml b/crates/ironrdp-egfx/Cargo.toml
@@ -5,6 +5,7 @@ readme = "README.md"
 description = "Graphics pipeline dynamic channel extension implementation"
 publish = false # TODO: publish
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-error/Cargo.toml b/crates/ironrdp-error/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.1.3"
 readme = "README.md"
 description = "IronPDU generic error definition"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-futures/Cargo.toml b/crates/ironrdp-futures/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.6.0"
 readme = "README.md"
 description = "`Framed*` traits implementation above futures’s traits"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-glutin-renderer/Cargo.toml b/crates/ironrdp-glutin-renderer/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.1.0"
 readme = "README.md"
 description = "`glutin` primitives for OpenGL rendering"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-graphics/Cargo.toml b/crates/ironrdp-graphics/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.7.0"
 readme = "README.md"
 description = "RDP image processing primitives"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-input/Cargo.toml b/crates/ironrdp-input/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.5.0"
 readme = "README.md"
 description = "Utilities to manage and build RDP input packets"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-mstsgu/Cargo.toml b/crates/ironrdp-mstsgu/Cargo.toml
@@ -5,6 +5,7 @@ readme = "README.md"
 description = "Terminal Services Gateway Server Protocol"
 publish = false # TODO: publish
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-pdu/Cargo.toml b/crates/ironrdp-pdu/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.7.0"
 readme = "README.md"
 description = "RDP PDU encoding and decoding"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-propertyset/Cargo.toml b/crates/ironrdp-propertyset/Cargo.toml
@@ -5,6 +5,7 @@ readme = "README.md"
 description = "A key-value store for configuration options"
 publish = false # TODO: publish
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-rdcleanpath/Cargo.toml b/crates/ironrdp-rdcleanpath/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.2.1"
 readme = "README.md"
 description = "RDCleanPath PDU structure used by IronRDP web client and Devolutions Gateway"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-rdpdr-native/Cargo.toml b/crates/ironrdp-rdpdr-native/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.5.0"
 readme = "README.md"
 description = "Native RDPDR static channel backend implementations for IronRDP"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-rdpdr/Cargo.toml b/crates/ironrdp-rdpdr/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.5.0"
 readme = "README.md"
 description = "RDPDR channel implementation."
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-rdpfile/Cargo.toml b/crates/ironrdp-rdpfile/Cargo.toml
@@ -5,6 +5,7 @@ readme = "README.md"
 description = "Parser and writer for .RDP file format"
 publish = false # TODO: publish
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-rdpsnd-native/Cargo.toml b/crates/ironrdp-rdpsnd-native/Cargo.toml
@@ -3,6 +3,7 @@ name = "ironrdp-rdpsnd-native"
 version = "0.5.0"
 description = "Native RDPSND static channel backend implementations for IronRDP"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-rdpsnd/Cargo.toml b/crates/ironrdp-rdpsnd/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.7.0"
 readme = "README.md"
 description = "RDPSND static channel for audio output implemented as described in MS-RDPEA"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-replay-client/Cargo.toml b/crates/ironrdp-replay-client/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.1.0"
 readme = "README.md"
 description = "Utility tool to replay RDP graphics pipeline for debugging purposes"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-server/Cargo.toml b/crates/ironrdp-server/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.10.0"
 readme = "README.md"
 description = "Extendable skeleton for implementing custom RDP servers"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-session/Cargo.toml b/crates/ironrdp-session/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.8.0"
 readme = "README.md"
 description = "State machines to drive an RDP session"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-svc/Cargo.toml b/crates/ironrdp-svc/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.6.0"
 readme = "README.md"
 description = "IronRDP traits to implement RDP static virtual channels"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-tls/Cargo.toml b/crates/ironrdp-tls/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.2.0"
 readme = "README.md"
 description = "TLS boilerplate common with most IronRDP clients"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp-tokio/Cargo.toml b/crates/ironrdp-tokio/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.8.0"
 readme = "README.md"
 description = "`Framed*` traits implementation above Tokio’s traits"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
diff --git a/crates/ironrdp/Cargo.toml b/crates/ironrdp/Cargo.toml
@@ -4,6 +4,7 @@ version = "0.14.0"
 readme = "README.md"
 description = "A meta crate re-exporting IronRDP crates for convenience"
 edition.workspace = true
+rust-version = "1.89"
 license.workspace = true
 homepage.workspace = true
 repository.workspace = true
