Skip to content

Upgrading tokio 0.3 to 1

Breaking0.3.7 → 1.54.1Breaking20Security7Platform7Deprecated2New301Changed190Fixed283Other284

Full comparisonBack to tokio
BreakingUpgrade verdict

20 breaking changes and 7 platform requirement changes and 7 security fixes.

In plain terms
  • runtime: removed borrow from LocalOptions parameter to runtime::Builder::build_local ().
  • Removes the unused `stats` feature.
  • Removes unused `tokio_*` cfgs.
  • Removes the build script to speed up compilation.
Must act Top 5 of 36 that need code or config changes

Requires Rust 1.85 from 1.54.0 (none stated before).

What you must change

Breaking20
runtime: removed borrow from LocalOptions parameter to runtime::Builder::build_local ().
LocalOptionsruntime::Builder::build_local
1.46.0GitHub ReleaseOriginalView source
Removes the unused stats feature.
stats
1.33.0GitHub ReleaseSummarizedView source
Removes unused tokio_* cfgs.
tokio_*
1.30.0GitHub ReleaseSummarizedView source
Removes the build script to speed up compilation.
1.30.0GitHub ReleaseSummarizedView source
Removes the Send implementation from runtime::EnterGuard, fixing a bug that should not impact most users.
runtime::EnterGuard
1.29.0GitHub ReleaseSummarizedView source
Renames unstable join_one to join_next in joinset.
join_onejoin_next
1.20.0GitHub ReleaseSummarizedView source
Removes RwLockWriteGuard::map and RwLockWriteGuard::try_map to fix a soundness hole with RwLockWriteGuard::downgrade.
RwLockWriteGuard::mapRwLockWriteGuard::try_mapRwLockWriteGuard::downgrade
1.0.1GitHub ReleaseSummarizedView source
Renames AsyncFd::with_io() to try_io().
AsyncFd::with_io()AsyncFd::try_io()
1.0.0GitHub ReleaseSummarizedView source
Renames runtime::Builder::max_threads() to max_blocking_threads().
runtime::Builder::max_threads()runtime::Builder::max_blocking_threads()
1.0.0GitHub ReleaseSummarizedView source
Removes tokio::prelude.
tokio::prelude
1.0.0GitHub ReleaseSummarizedView source
Removes AsyncFd::with_poll().
AsyncFd::with_poll()
1.0.0GitHub ReleaseSummarizedView source
Removes {Tcp,Unix}Stream::shutdown() in favor of AsyncWrite::shutdown().
TcpStream::shutdown()UnixStream::shutdown()AsyncWrite::shutdown()
1.0.0GitHub ReleaseSummarizedView source
Removes mpsc try_recv() due to unexpected behavior.
try_recv()
1.0.0GitHub ReleaseSummarizedView source
Makes the unstable task::Builder::spawn* methods fallible.
task::Builder::spawn*
1.21.0GitHub ReleaseSummarizedView source
Overhauls the runtime metrics API when building with --cfg tokio_unstable.
1.16.0GitHub ReleaseSummarizedView source
Makes Sleep !Unpin.
Sleep
1.0.0GitHub ReleaseSummarizedView source
Passes SocketAddr by value.
SocketAddr
1.0.0GitHub ReleaseSummarizedView source
Changes TcpStream::poll_peek to take ReadBuf.
TcpStream::poll_peekReadBuf
1.0.0GitHub ReleaseSummarizedView source
Requires the current_thread runtime when calling time::pause().
time::pause()current_thread
1.0.0GitHub ReleaseSummarizedView source
Moves all stream utilities to tokio-stream until Stream is added to std.
tokio-streamStream
1.0.0GitHub ReleaseSummarizedView source
Security7
Race condition in tokio::time::Interval on Tokio v1.54.0
1.54.1GitHub AdvisoryOriginalView source
AsyncFd::new and related constructors violate I/O safety
1.51.6OSV advisoryOriginalView source
Broadcast channel calls clone in parallel, but does not require Sync
1.38.2GitHub AdvisoryOriginalView source
tokio::io::ReadHalf<T>::unsplit is Unsound
1.18.5GitHub AdvisoryOriginalView source
reject_remote_clients Configuration corruption
1.18.4GitHub AdvisoryOriginalView source
Fixes a data race between oneshot::Sender::send and awaiting a oneshot::Receiver when the oneshot has been closed.
oneshot::Sender::sendoneshot::Receiver
1.8.4GitHub ReleaseSummarizedView source
Task dropped in wrong thread when aborting LocalSet task
1.5.1GitHub AdvisoryOriginalView source
Platform7
Increases the minimum supported Rust version (MSRV) to 1.85.
1.54.0GitHub ReleaseSummarizedView source
Bumps the minimum supported Rust version (MSRV) to 1.70.
1.39.0GitHub ReleaseSummarizedView source
Bumps the MSRV of Tokio to 1.63.
1.30.0GitHub ReleaseSummarizedView source
Bumps the MSRV of Tokio to 1.56.
1.27.0GitHub ReleaseSummarizedView source
Removes the dependency on the once_cell crate to restore the MSRV of the 1.18.x LTS release.
once_cell
1.18.3GitHub ReleaseSummarizedView source
Updates the minimum supported Rust version to 1.49.
1.17.0GitHub ReleaseSummarizedView source
Updates the minimum supported Rust version to 1.46.
1.15.0GitHub ReleaseSummarizedView source

Deprecations to plan for

Deprecated2
Deprecates AsyncFd::new, AsyncFd::with_interest, AsyncFd::try_new and AsyncFd::try_with_interest.
AsyncFd::newAsyncFd::with_interestAsyncFd::try_newAsyncFd::try_with_interest
1.51.6GitHub ReleaseSummarizedView source
Deprecates the unused mpsc::RecvError type.
mpsc::RecvError
1.7.0GitHub ReleaseSummarizedView source