Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated Documentation for Signals #5459

Merged
merged 3 commits into from Feb 26, 2023
Merged

Conversation

ericmcbride
Copy link
Contributor

Motivation

Resolve Issue #5430 and to update the documentation to point to how to create Streams, using the Tokio-stream crate

Solution

Update documentation for Windows + Unix signals to not include "streams" since they do not implement the Stream Trait, and give a link to the acceptable Tokio-stream wrapper.

Comment on lines 69 to 73
/// `None` is returned if no more events can be received by this stream.
/// `None` is returned if no more events can be received by the `RxFuture`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should say "the CtrlC". The RxFuture type is an internal implementation detail.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

or "this listener"

@Darksonn Darksonn added T-docs Topic: documentation A-tokio Area: The main tokio crate M-signal Module: tokio/signal labels Feb 17, 2023
Copy link
Contributor

@brodybits brodybits left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In general I would favor using "listener" rather than "event". The term "event" sounds to me like something that we would expect to receive or receive from only once.

I think we should update the documentation for some other Windows signal listener types as well:

  • CtrlBreak
  • CtrlClose
  • ctrl_shutdown
  • ctrl_logoff

Comment on lines 295 to 297
/// An event for receiving a particular type of OS signal.
///
/// The signal can be turned into a `Stream` using [`SignalStream`].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// An event for receiving a particular type of OS signal.
///
/// The signal can be turned into a `Stream` using [`SignalStream`].
/// A listener for receiving a particular type of OS signal.
///
/// The listener can be turned into a `Stream` using [`SignalStream`].

@@ -360,7 +361,7 @@ pub struct Signal {
inner: RxFuture,
}

/// Creates a new stream which will receive notifications when the current
/// Creates a new signal which will receive notifications when the current
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// Creates a new signal which will receive notifications when the current
/// Creates a new listener which will receive notifications when the current

@@ -22,7 +22,7 @@ pub(crate) use self::imp::{OsExtraData, OsStorage};
#[path = "windows/stub.rs"]
mod imp;

/// Creates a new stream which receives "ctrl-c" notifications sent to the
/// Creates a new event which receives "ctrl-c" notifications sent to the
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// Creates a new event which receives "ctrl-c" notifications sent to the
/// Creates a new listener which receives "ctrl-c" notifications sent to the

@@ -50,14 +50,18 @@ pub fn ctrl_c() -> io::Result<CtrlC> {
})
}

/// Represents a stream which receives "ctrl-c" notifications sent to the process
/// Represents an event which receives "ctrl-c" notifications sent to the process
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// Represents an event which receives "ctrl-c" notifications sent to the process
/// Represents a listener which receives "ctrl-c" notifications sent to the process

Comment on lines 310 to 312
/// Put another way, any element pulled off the returned stream corresponds to
/// *at least one* signal, but possibly more.
///
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

-///   Put another way, any element pulled off the returned stream corresponds to
-///   *at least one* signal, but possibly more.
+///   Put another way, any element pulled off the returned listener corresponds to
+///   *at least one* signal, but possibly more.

/// via `SetConsoleCtrlHandler`.
///
/// A notification to this process notifies *all* streams listening for
/// This event can be turned into a `Stream` using [`CtrlCStream`].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// This event can be turned into a `Stream` using [`CtrlCStream`].
/// This listener can be turned into a `Stream` using [`CtrlCStream`].

/// then the stream may only receive one item about the two notifications.
#[must_use = "streams do nothing unless polled"]
/// then the receiver may only receive one item about the two notifications.
#[must_use = "events do nothing unless polled"]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would favor using "listener" on these 2 lines as well.

Comment on lines 69 to 73
/// `None` is returned if no more events can be received by this stream.
/// `None` is returned if no more events can be received by the `RxFuture`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

or "this listener"

@@ -127,11 +130,15 @@ impl CtrlC {
/// Represents a stream which receives "ctrl-break" notifications sent to the process
/// via `SetConsoleCtrlHandler`.
///
/// A notification to this process notifies *all* streams listening for
/// This event can be turned into a `Stream` using [`CtrlBreakStream`].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
/// This event can be turned into a `Stream` using [`CtrlBreakStream`].
/// This listener can be turned into a `Stream` using [`CtrlBreakStream`].

@ericmcbride
Copy link
Contributor Author

I'll update these suggestions I wanted to do that on my initial go, but for some reason, event stuck with me.

Copy link
Contributor

@Darksonn Darksonn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you.

@Darksonn Darksonn enabled auto-merge (squash) February 26, 2023 19:19
@brodybits
Copy link
Contributor

👍 👍 - much better from an outsider perspective

@Darksonn Darksonn merged commit e23c6f3 into tokio-rs:master Feb 26, 2023
amab8901 pushed a commit to amab8901/tokio that referenced this pull request Feb 27, 2023
Noah-Kennedy added a commit that referenced this pull request Mar 1, 2023
# 1.26.0 (March 1st, 2023)

### Fixed

- sync: don't leak tracing spans in mutex guards ([#5469])
- sync: drop wakers after unlocking the mutex in Notify ([#5471])
- sync: drop wakers outside lock in semaphore ([#5475])
- macros: fix empty `join!` and `try_join!` ([#5504])

### Added

- fs: add `fs::try_exists` ([#4299])
- net: add types for named unix pipes ([#5351])
- sync: add `MappedOwnedMutexGuard` ([#5474])

### Documented

- task: clarify what happens to spawned work during runtime shutdown ([#5394])
- task: clarify `process::Command` docs (#5406) ([#5413])
- sync: add doc aliases for `blocking_*` methods ([#5448])
- task: fix wording with 'unsend' ([#5452])
- signal: updated Documentation for Signals ([#5459])
- sync: fix docs for Send/Sync bounds in broadcast ([#5480])
- io: improve AsyncFd example ([#5481])
- tokio: document supported platforms ([#5483])
- runtime: document the nature of the main future ([#5494])
- sync: document drop behavior for channels ([#5497])
- time: document immediate completion guarantee for timeouts ([#5509])
- runtime: remove extra period in docs ([#5511])

### Changed

- net: use Message Read Mode for named pipes ([#5350])
- chore: update windows-sys to 0.45 ([#5386])
- sync: mark lock guards with `#[clippy::has_significant_drop]` ([#5422])
- sync: reduce contention in watch channel ([#5464])
- time: remove cache padding in timer entries ([#5468])
- time: Improve `Instant::now()` perf with test-util ([#5513])

### Internal Changes
- tests: port proptest fuzz harnesses to use cargo-fuzz ([#5392])
- time: don't store deadline twice in sleep entries ([#5410])
- rt: remove Arc from Clock ([#5434])
- sync: make `notify_waiters` calls atomic ([#5458])
- net: refactor named pipe builders to not use bitfields ([#5477])
- io: use `poll_fn` in `copy_bidirectional` ([#5486])
- fs: add more tests for filesystem functionality ([#5493])
- net: fix test compilation failure ([#5506])
- io: ignore SplitByUtf8BoundaryIfWindows test on miri ([#5507])

### Unstable

- metrics: add a new metric for budget exhaustion yields ([#5517])

[#4299]: #4299
[#5350]: #5350
[#5351]: #5351
[#5386]: #5386
[#5392]: #5392
[#5394]: #5394
[#5410]: #5410
[#5413]: #5413
[#5422]: #5422
[#5434]: #5434
[#5448]: #5448
[#5452]: #5452
[#5458]: #5458
[#5459]: #5459
[#5464]: #5464
[#5468]: #5468
[#5469]: #5469
[#5471]: #5471
[#5474]: #5474
[#5475]: #5475
[#5477]: #5477
[#5480]: #5480
[#5481]: #5481
[#5483]: #5483
[#5486]: #5486
[#5493]: #5493
[#5494]: #5494
[#5497]: #5497
[#5504]: #5504
[#5506]: #5506
[#5507]: #5507
[#5509]: #5509
[#5511]: #5511
[#5513]: #5513
[#5517]: #5517
Noah-Kennedy added a commit that referenced this pull request Mar 1, 2023
# 1.26.0 (March 1st, 2023)

### Fixed

- macros: fix empty `join!` and `try_join!` ([#5504])
- sync: don't leak tracing spans in mutex guards ([#5469])
- sync: drop wakers after unlocking the mutex in Notify ([#5471])
- sync: drop wakers outside lock in semaphore ([#5475])

### Added

- fs: add `fs::try_exists` ([#4299])
- net: add types for named unix pipes ([#5351])
- sync: add `MappedOwnedMutexGuard` ([#5474])

### Changed

- chore: update windows-sys to 0.45 ([#5386])
- net: use Message Read Mode for named pipes ([#5350])
- sync: mark lock guards with `#[clippy::has_significant_drop]` ([#5422])
- sync: reduce contention in watch channel ([#5464])
- time: remove cache padding in timer entries ([#5468])
- time: Improve `Instant::now()` perf with test-util ([#5513])

### Internal Changes

- io: use `poll_fn` in `copy_bidirectional` ([#5486])
- net: refactor named pipe builders to not use bitfields ([#5477])
- rt: remove Arc from Clock ([#5434])
- sync: make `notify_waiters` calls atomic ([#5458])
- time: don't store deadline twice in sleep entries ([#5410])

### Unstable

- metrics: add a new metric for budget exhaustion yields ([#5517])

### Documented

- io: improve AsyncFd example ([#5481])
- runtime: document the nature of the main future ([#5494])
- runtime: remove extra period in docs ([#5511])
- signal: updated Documentation for Signals ([#5459])
- sync: add doc aliases for `blocking_*` methods ([#5448])
- sync: fix docs for Send/Sync bounds in broadcast ([#5480])
- sync: document drop behavior for channels ([#5497])
- task: clarify what happens to spawned work during runtime shutdown ([#5394])
- task: clarify `process::Command` docs ([#5413])
- task: fix wording with 'unsend' ([#5452])
- time: document immediate completion guarantee for timeouts ([#5509])
- tokio: document supported platforms ([#5483])

[#4299]: #4299
[#5350]: #5350
[#5351]: #5351
[#5386]: #5386
[#5394]: #5394
[#5410]: #5410
[#5413]: #5413
[#5422]: #5422
[#5434]: #5434
[#5448]: #5448
[#5452]: #5452
[#5458]: #5458
[#5459]: #5459
[#5464]: #5464
[#5468]: #5468
[#5469]: #5469
[#5471]: #5471
[#5474]: #5474
[#5475]: #5475
[#5477]: #5477
[#5480]: #5480
[#5481]: #5481
[#5483]: #5483
[#5486]: #5486
[#5494]: #5494
[#5497]: #5497
[#5504]: #5504
[#5509]: #5509
[#5511]: #5511
[#5513]: #5513
[#5517]: #5517
Noah-Kennedy added a commit that referenced this pull request Mar 1, 2023
# 1.26.0 (March 1st, 2023)

### Fixed

- macros: fix empty `join!` and `try_join!` ([#5504])
- sync: don't leak tracing spans in mutex guards ([#5469])
- sync: drop wakers after unlocking the mutex in Notify ([#5471])
- sync: drop wakers outside lock in semaphore ([#5475])

### Added

- fs: add `fs::try_exists` ([#4299])
- net: add types for named unix pipes ([#5351])
- sync: add `MappedOwnedMutexGuard` ([#5474])

### Changed

- chore: update windows-sys to 0.45 ([#5386])
- net: use Message Read Mode for named pipes ([#5350])
- sync: mark lock guards with `#[clippy::has_significant_drop]` ([#5422])
- sync: reduce contention in watch channel ([#5464])
- time: remove cache padding in timer entries ([#5468])
- time: Improve `Instant::now()` perf with test-util ([#5513])

### Internal Changes

- io: use `poll_fn` in `copy_bidirectional` ([#5486])
- net: refactor named pipe builders to not use bitfields ([#5477])
- rt: remove Arc from Clock ([#5434])
- sync: make `notify_waiters` calls atomic ([#5458])
- time: don't store deadline twice in sleep entries ([#5410])

### Unstable

- metrics: add a new metric for budget exhaustion yields ([#5517])

### Documented

- io: improve AsyncFd example ([#5481])
- runtime: document the nature of the main future ([#5494])
- runtime: remove extra period in docs ([#5511])
- signal: updated Documentation for Signals ([#5459])
- sync: add doc aliases for `blocking_*` methods ([#5448])
- sync: fix docs for Send/Sync bounds in broadcast ([#5480])
- sync: document drop behavior for channels ([#5497])
- task: clarify what happens to spawned work during runtime shutdown ([#5394])
- task: clarify `process::Command` docs ([#5413])
- task: fix wording with 'unsend' ([#5452])
- time: document immediate completion guarantee for timeouts ([#5509])
- tokio: document supported platforms ([#5483])

[#4299]: #4299
[#5350]: #5350
[#5351]: #5351
[#5386]: #5386
[#5394]: #5394
[#5410]: #5410
[#5413]: #5413
[#5422]: #5422
[#5434]: #5434
[#5448]: #5448
[#5452]: #5452
[#5458]: #5458
[#5459]: #5459
[#5464]: #5464
[#5468]: #5468
[#5469]: #5469
[#5471]: #5471
[#5474]: #5474
[#5475]: #5475
[#5477]: #5477
[#5480]: #5480
[#5481]: #5481
[#5483]: #5483
[#5486]: #5486
[#5494]: #5494
[#5497]: #5497
[#5504]: #5504
[#5509]: #5509
[#5511]: #5511
[#5513]: #5513
[#5517]: #5517
renovate bot added a commit to smartive/zitadel-rust that referenced this pull request May 2, 2024
[![Mend
Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [tokio](https://tokio.rs)
([source](https://togithub.com/tokio-rs/tokio)) | dev-dependencies |
minor | `1` -> `1.37.0` |
| [tokio](https://tokio.rs)
([source](https://togithub.com/tokio-rs/tokio)) | dependencies | minor |
`1` -> `1.37.0` |

---

### Release Notes

<details>
<summary>tokio-rs/tokio (tokio)</summary>

###
[`v1.37.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.37.0):
Tokio v1.37.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.36.0...tokio-1.37.0)

### 1.37.0 (March 28th, 2024)

##### Added

-   fs: add `set_max_buf_size` to `tokio::fs::File` ([#&#8203;6411])
- io: add `try_new` and `try_with_interest` to `AsyncFd`
([#&#8203;6345])
-   sync: add `forget_permits` method to semaphore ([#&#8203;6331])
- sync: add `is_closed`, `is_empty`, and `len` to mpsc receivers
([#&#8203;6348])
- sync: add a `rwlock()` method to owned `RwLock` guards
([#&#8203;6418])
- sync: expose strong and weak counts of mpsc sender handles
([#&#8203;6405])
-   sync: implement `Clone` for `watch::Sender` ([#&#8203;6388])
-   task: add `TaskLocalFuture::take_value` ([#&#8203;6340])
-   task: implement `FromIterator` for `JoinSet` ([#&#8203;6300])

##### Changed

- io: make `io::split` use a mutex instead of a spinlock
([#&#8203;6403])

##### Fixed

-   docs: fix docsrs build without net feature ([#&#8203;6360])
-   macros: allow select with only else branch ([#&#8203;6339])
- runtime: fix leaking registration entries when os registration fails
([#&#8203;6329])

##### Documented

- io: document cancel safety of `AsyncBufReadExt::fill_buf`
([#&#8203;6431])
- io: document cancel safety of `AsyncReadExt`'s primitive read
functions ([#&#8203;6337])
- runtime: add doc link from `Runtime` to `#[tokio::main]`
([#&#8203;6366])
-   runtime: make the `enter` example deterministic ([#&#8203;6351])
- sync: add Semaphore example for limiting the number of outgoing
requests ([#&#8203;6419])
-   sync: fix missing period in broadcast docs ([#&#8203;6377])
- sync: mark `mpsc::Sender::downgrade` with `#[must_use]`
([#&#8203;6326])
-   sync: reorder `const_new` before `new_with` ([#&#8203;6392])
-   sync: update watch channel docs ([#&#8203;6395])
-   task: fix documentation links ([#&#8203;6336])

##### Changed (unstable)

-   runtime: include task `Id` in taskdumps ([#&#8203;6328])
- runtime: panic if `unhandled_panic` is enabled when not supported
([#&#8203;6410])

[#&#8203;6300]: https://togithub.com/tokio-rs/tokio/pull/6300

[#&#8203;6326]: https://togithub.com/tokio-rs/tokio/pull/6326

[#&#8203;6328]: https://togithub.com/tokio-rs/tokio/pull/6328

[#&#8203;6329]: https://togithub.com/tokio-rs/tokio/pull/6329

[#&#8203;6331]: https://togithub.com/tokio-rs/tokio/pull/6331

[#&#8203;6336]: https://togithub.com/tokio-rs/tokio/pull/6336

[#&#8203;6337]: https://togithub.com/tokio-rs/tokio/pull/6337

[#&#8203;6339]: https://togithub.com/tokio-rs/tokio/pull/6339

[#&#8203;6340]: https://togithub.com/tokio-rs/tokio/pull/6340

[#&#8203;6345]: https://togithub.com/tokio-rs/tokio/pull/6345

[#&#8203;6348]: https://togithub.com/tokio-rs/tokio/pull/6348

[#&#8203;6351]: https://togithub.com/tokio-rs/tokio/pull/6351

[#&#8203;6360]: https://togithub.com/tokio-rs/tokio/pull/6360

[#&#8203;6366]: https://togithub.com/tokio-rs/tokio/pull/6366

[#&#8203;6377]: https://togithub.com/tokio-rs/tokio/pull/6377

[#&#8203;6388]: https://togithub.com/tokio-rs/tokio/pull/6388

[#&#8203;6392]: https://togithub.com/tokio-rs/tokio/pull/6392

[#&#8203;6395]: https://togithub.com/tokio-rs/tokio/pull/6395

[#&#8203;6403]: https://togithub.com/tokio-rs/tokio/pull/6403

[#&#8203;6405]: https://togithub.com/tokio-rs/tokio/pull/6405

[#&#8203;6410]: https://togithub.com/tokio-rs/tokio/pull/6410

[#&#8203;6411]: https://togithub.com/tokio-rs/tokio/pull/6411

[#&#8203;6418]: https://togithub.com/tokio-rs/tokio/pull/6418

[#&#8203;6419]: https://togithub.com/tokio-rs/tokio/pull/6419

[#&#8203;6431]: https://togithub.com/tokio-rs/tokio/pull/6431

###
[`v1.36.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.36.0):
Tokio v1.36.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.35.1...tokio-1.36.0)

### 1.36.0 (February 2nd, 2024)

##### Added

-   io: add `tokio::io::Join` ([#&#8203;6220])
-   io: implement `AsyncWrite` for `Empty` ([#&#8203;6235])
-   net: add support for anonymous unix pipes ([#&#8203;6127])
-   net: add `UnixSocket` ([#&#8203;6290])
-   net: expose keepalive option on `TcpSocket` ([#&#8203;6311])
- sync: add `{Receiver,UnboundedReceiver}::poll_recv_many`
([#&#8203;6236])
-   sync: add `Sender::{try_,}reserve_many` ([#&#8203;6205])
-   sync: add `watch::Receiver::mark_unchanged` ([#&#8203;6252])
-   task: add `JoinSet::try_join_next` ([#&#8203;6280])

##### Changed

-   io: make `copy` cooperative ([#&#8203;6265])
-   io: make `repeat` and `sink` cooperative ([#&#8203;6254])
-   io: simplify check for empty slice ([#&#8203;6293])
-   process: use pidfd on Linux when available ([#&#8203;6152])
-   sync: use AtomicBool in broadcast channel future ([#&#8203;6298])

##### Documented

-   io: clarify `clear_ready` docs ([#&#8203;6304])
- net: document that `*Fd` traits on `TcpSocket` are unix-only
([#&#8203;6294])
- sync: document FIFO behavior of `tokio::sync::Mutex` ([#&#8203;6279])
-   chore: typographic improvements ([#&#8203;6262])
-   runtime: remove obsolete comment ([#&#8203;6303])
-   task: fix typo ([#&#8203;6261])

[#&#8203;6220]: https://togithub.com/tokio-rs/tokio/pull/6220

[#&#8203;6235]: https://togithub.com/tokio-rs/tokio/pull/6235

[#&#8203;6127]: https://togithub.com/tokio-rs/tokio/pull/6127

[#&#8203;6290]: https://togithub.com/tokio-rs/tokio/pull/6290

[#&#8203;6311]: https://togithub.com/tokio-rs/tokio/pull/6311

[#&#8203;6236]: https://togithub.com/tokio-rs/tokio/pull/6236

[#&#8203;6205]: https://togithub.com/tokio-rs/tokio/pull/6205

[#&#8203;6252]: https://togithub.com/tokio-rs/tokio/pull/6252

[#&#8203;6280]: https://togithub.com/tokio-rs/tokio/pull/6280

[#&#8203;6265]: https://togithub.com/tokio-rs/tokio/pull/6265

[#&#8203;6254]: https://togithub.com/tokio-rs/tokio/pull/6254

[#&#8203;6293]: https://togithub.com/tokio-rs/tokio/pull/6293

[#&#8203;6238]: https://togithub.com/tokio-rs/tokio/pull/6238

[#&#8203;6152]: https://togithub.com/tokio-rs/tokio/pull/6152

[#&#8203;6298]: https://togithub.com/tokio-rs/tokio/pull/6298

[#&#8203;6262]: https://togithub.com/tokio-rs/tokio/pull/6262

[#&#8203;6303]: https://togithub.com/tokio-rs/tokio/pull/6303

[#&#8203;6261]: https://togithub.com/tokio-rs/tokio/pull/6261

[#&#8203;6304]: https://togithub.com/tokio-rs/tokio/pull/6304

[#&#8203;6294]: https://togithub.com/tokio-rs/tokio/pull/6294

[#&#8203;6279]: https://togithub.com/tokio-rs/tokio/pull/6279

###
[`v1.35.1`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.35.1):
Tokio v1.35.1

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.35.0...tokio-1.35.1)

### 1.35.1 (December 19, 2023)

This is a forward part of a change that was backported to 1.25.3.

##### Fixed

- io: add budgeting to `tokio::runtime::io::registration::async_io`
([#&#8203;6221])

[#&#8203;6221]: https://togithub.com/tokio-rs/tokio/pull/6221

###
[`v1.35.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.35.0):
Tokio v1.35.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.34.0...tokio-1.35.0)

### 1.35.0 (December 8th, 2023)

##### Added

-   net: add Apple watchOS support ([#&#8203;6176])

##### Changed

- io: drop the `Sized` requirements from `AsyncReadExt.read_buf`
([#&#8203;6169])
-   runtime: make `Runtime` unwind safe ([#&#8203;6189])
-   runtime: reduce the lock contention in task spawn ([#&#8203;6001])
-   tokio: update nix dependency to 0.27.1 ([#&#8203;6190])

##### Fixed

-   chore: make `--cfg docsrs` work without net feature ([#&#8203;6166])
-   chore: use relaxed load for `unsync_load` on miri ([#&#8203;6179])
-   runtime: handle missing context on wake ([#&#8203;6148])
-   taskdump: fix taskdump cargo config example ([#&#8203;6150])
-   taskdump: skip notified tasks during taskdumps ([#&#8203;6194])
- tracing: avoid creating resource spans with current parent, use a None
parent instead ([#&#8203;6107])
-   tracing: make task span explicit root ([#&#8203;6158])

##### Documented

-   io: flush in `AsyncWriteExt` examples ([#&#8203;6149])
- runtime: document fairness guarantees and current behavior
([#&#8203;6145])
- task: document cancel safety of `LocalSet::run_until` ([#&#8203;6147])

[#&#8203;6001]: https://togithub.com/tokio-rs/tokio/pull/6001

[#&#8203;6107]: https://togithub.com/tokio-rs/tokio/pull/6107

[#&#8203;6144]: https://togithub.com/tokio-rs/tokio/pull/6144

[#&#8203;6145]: https://togithub.com/tokio-rs/tokio/pull/6145

[#&#8203;6147]: https://togithub.com/tokio-rs/tokio/pull/6147

[#&#8203;6148]: https://togithub.com/tokio-rs/tokio/pull/6148

[#&#8203;6149]: https://togithub.com/tokio-rs/tokio/pull/6149

[#&#8203;6150]: https://togithub.com/tokio-rs/tokio/pull/6150

[#&#8203;6158]: https://togithub.com/tokio-rs/tokio/pull/6158

[#&#8203;6166]: https://togithub.com/tokio-rs/tokio/pull/6166

[#&#8203;6169]: https://togithub.com/tokio-rs/tokio/pull/6169

[#&#8203;6176]: https://togithub.com/tokio-rs/tokio/pull/6176

[#&#8203;6179]: https://togithub.com/tokio-rs/tokio/pull/6179

[#&#8203;6189]: https://togithub.com/tokio-rs/tokio/pull/6189

[#&#8203;6190]: https://togithub.com/tokio-rs/tokio/pull/6190

[#&#8203;6194]: https://togithub.com/tokio-rs/tokio/pull/6194

###
[`v1.34.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.34.0):
Tokio v1.34.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.33.0...tokio-1.34.0)

##### Fixed

- io: allow `clear_readiness` after io driver shutdown ([#&#8203;6067])
-   io: fix integer overflow in `take` ([#&#8203;6080])
-   io: fix I/O resource hang ([#&#8203;6134])
-   sync: fix `broadcast::channel` link ([#&#8203;6100])

##### Changed

- macros: use `::core` qualified imports instead of `::std` inside
`tokio::test` macro ([#&#8203;5973])

##### Added

- fs: update cfg attr in `fs::read_dir` to include `aix`
([#&#8203;6075])
-   sync: add `mpsc::Receiver::recv_many` ([#&#8203;6010])
-   tokio: added vita target support ([#&#8203;6094])

[#&#8203;5973]: https://togithub.com/tokio-rs/tokio/pull/5973

[#&#8203;6067]: https://togithub.com/tokio-rs/tokio/pull/6067

[#&#8203;6080]: https://togithub.com/tokio-rs/tokio/pull/6080

[#&#8203;6134]: https://togithub.com/tokio-rs/tokio/pull/6134

[#&#8203;6100]: https://togithub.com/tokio-rs/tokio/pull/6100

[#&#8203;6075]: https://togithub.com/tokio-rs/tokio/pull/6075

[#&#8203;6010]: https://togithub.com/tokio-rs/tokio/pull/6010

[#&#8203;6094]: https://togithub.com/tokio-rs/tokio/pull/6094

###
[`v1.33.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.33.0):
Tokio v1.33.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.32.1...tokio-1.33.0)

### 1.33.0 (October 9, 2023)

##### Fixed

-   io: mark `Interest::add` with `#[must_use]` ([#&#8203;6037])
-   runtime: fix cache line size for RISC-V ([#&#8203;5994])
- sync: prevent lock poisoning in `watch::Receiver::wait_for`
([#&#8203;6021])
-   task: fix `spawn_local` source location ([#&#8203;5984])

##### Changed

- sync: use Acquire/Release orderings instead of SeqCst in `watch`
([#&#8203;6018])

##### Added

-   fs: add vectored writes to `tokio::fs::File` ([#&#8203;5958])
-   io: add `Interest::remove` method ([#&#8203;5906])
-   io: add vectored writes to `DuplexStream` ([#&#8203;5985])
-   net: add Apple tvOS support ([#&#8203;6045])
- sync: add `?Sized` bound to `{MutexGuard,OwnedMutexGuard}::map`
([#&#8203;5997])
- sync: add `watch::Receiver::mark_unseen` ([#&#8203;5962],
[#&#8203;6014], [#&#8203;6017])
-   sync: add `watch::Sender::new` ([#&#8203;5998])
-   sync: add const fn `OnceCell::from_value` ([#&#8203;5903])

##### Removed

-   remove unused `stats` feature ([#&#8203;5952])

##### Documented

- add missing backticks in code examples ([#&#8203;5938],
[#&#8203;6056])
-   fix typos ([#&#8203;5988], [#&#8203;6030])
-   process: document that `Child::wait` is cancel safe ([#&#8203;5977])
- sync: add examples for `Semaphore` ([#&#8203;5939], [#&#8203;5956],
[#&#8203;5978], [#&#8203;6031], [#&#8203;6032], [#&#8203;6050])
- sync: document that `broadcast` capacity is a lower bound
([#&#8203;6042])
-   sync: document that `const_new` is not instrumented ([#&#8203;6002])
- sync: improve cancel-safety documentation for `mpsc::Sender::send`
([#&#8203;5947])
-   sync: improve docs for `watch` channel ([#&#8203;5954])
-   taskdump: render taskdump documentation on docs.rs ([#&#8203;5972])

##### Unstable

-   taskdump: fix potential deadlock ([#&#8203;6036])

[#&#8203;5903]: https://togithub.com/tokio-rs/tokio/pull/5903

[#&#8203;5906]: https://togithub.com/tokio-rs/tokio/pull/5906

[#&#8203;5938]: https://togithub.com/tokio-rs/tokio/pull/5938

[#&#8203;5939]: https://togithub.com/tokio-rs/tokio/pull/5939

[#&#8203;5947]: https://togithub.com/tokio-rs/tokio/pull/5947

[#&#8203;5952]: https://togithub.com/tokio-rs/tokio/pull/5952

[#&#8203;5954]: https://togithub.com/tokio-rs/tokio/pull/5954

[#&#8203;5956]: https://togithub.com/tokio-rs/tokio/pull/5956

[#&#8203;5958]: https://togithub.com/tokio-rs/tokio/pull/5958

[#&#8203;5960]: https://togithub.com/tokio-rs/tokio/pull/5960

[#&#8203;5962]: https://togithub.com/tokio-rs/tokio/pull/5962

[#&#8203;5971]: https://togithub.com/tokio-rs/tokio/pull/5971

[#&#8203;5972]: https://togithub.com/tokio-rs/tokio/pull/5972

[#&#8203;5977]: https://togithub.com/tokio-rs/tokio/pull/5977

[#&#8203;5978]: https://togithub.com/tokio-rs/tokio/pull/5978

[#&#8203;5984]: https://togithub.com/tokio-rs/tokio/pull/5984

[#&#8203;5985]: https://togithub.com/tokio-rs/tokio/pull/5985

[#&#8203;5988]: https://togithub.com/tokio-rs/tokio/pull/5988

[#&#8203;5994]: https://togithub.com/tokio-rs/tokio/pull/5994

[#&#8203;5997]: https://togithub.com/tokio-rs/tokio/pull/5997

[#&#8203;5998]: https://togithub.com/tokio-rs/tokio/pull/5998

[#&#8203;6002]: https://togithub.com/tokio-rs/tokio/pull/6002

[#&#8203;6014]: https://togithub.com/tokio-rs/tokio/pull/6014

[#&#8203;6017]: https://togithub.com/tokio-rs/tokio/pull/6017

[#&#8203;6018]: https://togithub.com/tokio-rs/tokio/pull/6018

[#&#8203;6021]: https://togithub.com/tokio-rs/tokio/pull/6021

[#&#8203;6030]: https://togithub.com/tokio-rs/tokio/pull/6030

[#&#8203;6031]: https://togithub.com/tokio-rs/tokio/pull/6031

[#&#8203;6032]: https://togithub.com/tokio-rs/tokio/pull/6032

[#&#8203;6036]: https://togithub.com/tokio-rs/tokio/pull/6036

[#&#8203;6037]: https://togithub.com/tokio-rs/tokio/pull/6037

[#&#8203;6042]: https://togithub.com/tokio-rs/tokio/pull/6042

[#&#8203;6045]: https://togithub.com/tokio-rs/tokio/pull/6045

[#&#8203;6050]: https://togithub.com/tokio-rs/tokio/pull/6050

[#&#8203;6056]: https://togithub.com/tokio-rs/tokio/pull/6056

[#&#8203;6058]: https://togithub.com/tokio-rs/tokio/pull/6058

###
[`v1.32.1`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.32.1):
Tokio v1.32.1

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.32.0...tokio-1.32.1)

### 1.32.1 (December 19, 2023)

This is a forward part of a change that was backported to 1.25.3.

##### Fixed

- io: add budgeting to `tokio::runtime::io::registration::async_io`
([#&#8203;6221])

[#&#8203;6221]: https://togithub.com/tokio-rs/tokio/pull/6221

###
[`v1.32.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.32.0):
Tokio v1.32.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.31.0...tokio-1.32.0)

##### Fixed

- sync: fix potential quadratic behavior in `broadcast::Receiver`
([#&#8203;5925])

##### Added

-   process: stabilize `Command::raw_arg` ([#&#8203;5930])
-   io: enable awaiting error readiness ([#&#8203;5781])

##### Unstable

- rt(alt): improve the scalability of alt runtime as the number of cores
grows ([#&#8203;5935])

[#&#8203;5925]: https://togithub.com/tokio-rs/tokio/pull/5925

[#&#8203;5930]: https://togithub.com/tokio-rs/tokio/pull/5930

[#&#8203;5781]: https://togithub.com/tokio-rs/tokio/pull/5781

[#&#8203;5935]: https://togithub.com/tokio-rs/tokio/pull/5935

###
[`v1.31.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.31.0):
Tokio v1.31.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.30.0...tokio-1.31.0)

##### Fixed

-   io: delegate `WriteHalf::poll_write_vectored` ([#&#8203;5914])

##### Unstable

- rt(unstable): fix memory leak in unstable next-gen scheduler prototype
([#&#8203;5911])
-   rt: expose mean task poll time metric ([#&#8203;5927])

[#&#8203;5914]: https://togithub.com/tokio-rs/tokio/pull/5914

[#&#8203;5911]: https://togithub.com/tokio-rs/tokio/pull/5911

[#&#8203;5927]: https://togithub.com/tokio-rs/tokio/pull/5927

###
[`v1.30.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.30.0):
Tokio v1.30.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.29.1...tokio-1.30.0)

### 1.30.0 (August 9, 2023)

This release bumps the MSRV of Tokio to 1.63. ([#&#8203;5887])

##### Changed

-   tokio: reduce LLVM code generation ([#&#8203;5859])
- io: support `--cfg mio_unsupported_force_poll_poll` flag
([#&#8203;5881])
-   sync: make `const_new` methods always available ([#&#8203;5885])
-   sync: avoid false sharing in mpsc channel ([#&#8203;5829])
-   rt: pop at least one task from inject queue ([#&#8203;5908])

##### Added

-   sync: add `broadcast::Sender::new` ([#&#8203;5824])
-   net: implement `UCred` for espidf ([#&#8203;5868])
-   fs: add `File::options()` ([#&#8203;5869])
-   time: implement extra reset variants for `Interval` ([#&#8203;5878])
-   process: add `{ChildStd*}::into_owned_{fd, handle}` ([#&#8203;5899])

##### Removed

-   tokio: removed unused `tokio_*` cfgs ([#&#8203;5890])
-   remove build script to speed up compilation ([#&#8203;5887])

##### Documented

-   sync: mention lagging in docs for `broadcast::send` ([#&#8203;5820])
-   runtime: expand on sharing runtime docs ([#&#8203;5858])
- io: use vec in example for `AsyncReadExt::read_exact` ([#&#8203;5863])
-   time: mark `Sleep` as `!Unpin` in docs ([#&#8203;5916])
-   process: fix `raw_arg` not showing up in docs ([#&#8203;5865])

##### Unstable

-   rt: add runtime ID ([#&#8203;5864])
-   rt: initial implementation of new threaded runtime ([#&#8203;5823])

[#&#8203;5820]: https://togithub.com/tokio-rs/tokio/pull/5820

[#&#8203;5823]: https://togithub.com/tokio-rs/tokio/pull/5823

[#&#8203;5824]: https://togithub.com/tokio-rs/tokio/pull/5824

[#&#8203;5829]: https://togithub.com/tokio-rs/tokio/pull/5829

[#&#8203;5858]: https://togithub.com/tokio-rs/tokio/pull/5858

[#&#8203;5859]: https://togithub.com/tokio-rs/tokio/pull/5859

[#&#8203;5863]: https://togithub.com/tokio-rs/tokio/pull/5863

[#&#8203;5864]: https://togithub.com/tokio-rs/tokio/pull/5864

[#&#8203;5865]: https://togithub.com/tokio-rs/tokio/pull/5865

[#&#8203;5868]: https://togithub.com/tokio-rs/tokio/pull/5868

[#&#8203;5869]: https://togithub.com/tokio-rs/tokio/pull/5869

[#&#8203;5878]: https://togithub.com/tokio-rs/tokio/pull/5878

[#&#8203;5881]: https://togithub.com/tokio-rs/tokio/pull/5881

[#&#8203;5885]: https://togithub.com/tokio-rs/tokio/pull/5885

[#&#8203;5887]: https://togithub.com/tokio-rs/tokio/pull/5887

[#&#8203;5890]: https://togithub.com/tokio-rs/tokio/pull/5890

[#&#8203;5899]: https://togithub.com/tokio-rs/tokio/pull/5899

[#&#8203;5908]: https://togithub.com/tokio-rs/tokio/pull/5908

[#&#8203;5916]: https://togithub.com/tokio-rs/tokio/pull/5916

###
[`v1.29.1`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.29.1):
Tokio v1.29.1

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.29.0...tokio-1.29.1)

##### Fixed

- rt: fix nesting two `block_in_place` with a `block_on` between
([#&#8203;5837])

[#&#8203;5837]: https://togithub.com/tokio-rs/tokio/pull/5837

###
[`v1.29.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.29.0):
Tokio v1.29.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.28.2...tokio-1.29.0)

Technically a breaking change, the `Send` implementation is removed from
`runtime::EnterGuard`. This change fixes a bug and should not impact
most users.

##### Breaking

-   rt: `EnterGuard` should not be `Send` ([#&#8203;5766])

##### Fixed

-   fs: reduce blocking ops in `fs::read_dir` ([#&#8203;5653])
-   rt: fix possible starvation ([#&#8203;5686], [#&#8203;5712])
-   rt: fix stacked borrows issue in `JoinSet` ([#&#8203;5693])
-   rt: panic if `EnterGuard` dropped incorrect order ([#&#8203;5772])
-   time: do not overflow to signal value ([#&#8203;5710])
-   fs: wait for in-flight ops before cloning `File` ([#&#8203;5803])

##### Changed

- rt: reduce time to poll tasks scheduled from outside the runtime
([#&#8203;5705], [#&#8203;5720])

##### Added

-   net: add uds doc alias for unix sockets ([#&#8203;5659])
-   rt: add metric for number of tasks ([#&#8203;5628])
-   sync: implement more traits for channel errors ([#&#8203;5666])
-   net: add nodelay methods on TcpSocket ([#&#8203;5672])
-   sync: add `broadcast::Receiver::blocking_recv` ([#&#8203;5690])
-   process: add `raw_arg` method to `Command` ([#&#8203;5704])
-   io: support PRIORITY epoll events ([#&#8203;5566])
-   task: add `JoinSet::poll_join_next` ([#&#8203;5721])
-   net: add support for Redox OS ([#&#8203;5790])

##### Unstable

- rt: add the ability to dump task backtraces ([#&#8203;5608],
[#&#8203;5676], [#&#8203;5708], [#&#8203;5717])
-   rt: instrument task poll times with a histogram ([#&#8203;5685])

[#&#8203;5766]: https://togithub.com/tokio-rs/tokio/pull/5766

[#&#8203;5653]: https://togithub.com/tokio-rs/tokio/pull/5653

[#&#8203;5686]: https://togithub.com/tokio-rs/tokio/pull/5686

[#&#8203;5712]: https://togithub.com/tokio-rs/tokio/pull/5712

[#&#8203;5693]: https://togithub.com/tokio-rs/tokio/pull/5693

[#&#8203;5772]: https://togithub.com/tokio-rs/tokio/pull/5772

[#&#8203;5710]: https://togithub.com/tokio-rs/tokio/pull/5710

[#&#8203;5803]: https://togithub.com/tokio-rs/tokio/pull/5803

[#&#8203;5705]: https://togithub.com/tokio-rs/tokio/pull/5705

[#&#8203;5720]: https://togithub.com/tokio-rs/tokio/pull/5720

[#&#8203;5659]: https://togithub.com/tokio-rs/tokio/pull/5659

[#&#8203;5628]: https://togithub.com/tokio-rs/tokio/pull/5628

[#&#8203;5666]: https://togithub.com/tokio-rs/tokio/pull/5666

[#&#8203;5672]: https://togithub.com/tokio-rs/tokio/pull/5672

[#&#8203;5690]: https://togithub.com/tokio-rs/tokio/pull/5690

[#&#8203;5704]: https://togithub.com/tokio-rs/tokio/pull/5704

[#&#8203;5566]: https://togithub.com/tokio-rs/tokio/pull/5566

[#&#8203;5721]: https://togithub.com/tokio-rs/tokio/pull/5721

[#&#8203;5790]: https://togithub.com/tokio-rs/tokio/pull/5790

[#&#8203;5608]: https://togithub.com/tokio-rs/tokio/pull/5608

[#&#8203;5676]: https://togithub.com/tokio-rs/tokio/pull/5676

[#&#8203;5708]: https://togithub.com/tokio-rs/tokio/pull/5708

[#&#8203;5717]: https://togithub.com/tokio-rs/tokio/pull/5717

[#&#8203;5685]: https://togithub.com/tokio-rs/tokio/pull/5685

###
[`v1.28.2`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.28.2):
Tokio v1.28.2

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.28.1...tokio-1.28.2)

### 1.28.2 (May 28, 2023)

Forward ports 1.18.6 changes.

##### Fixed

-   deps: disable default features for mio ([#&#8203;5728])

[#&#8203;5728]: https://togithub.com/tokio-rs/tokio/pull/5728

###
[`v1.28.1`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.28.1):
Tokio v1.28.1

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.28.0...tokio-1.28.1)

### 1.28.1 (May 10th, 2023)

This release fixes a mistake in the build script that makes `AsFd`
implementations unavailable on Rust 1.63. ([#&#8203;5677])

[#&#8203;5677]: https://togithub.com/tokio-rs/tokio/pull/5677

###
[`v1.28.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.28.0):
Tokio v1.28.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.27.0...tokio-1.28.0)

### 1.28.0 (April 25th, 2023)

##### Added

-   io: add `AsyncFd::async_io` ([#&#8203;5542])
-   io: impl BufMut for ReadBuf ([#&#8203;5590])
- net: add `recv_buf` for `UdpSocket` and `UnixDatagram`
([#&#8203;5583])
-   sync: add `OwnedSemaphorePermit::semaphore` ([#&#8203;5618])
-   sync: add `same_channel` to broadcast channel ([#&#8203;5607])
-   sync: add `watch::Receiver::wait_for` ([#&#8203;5611])
- task: add `JoinSet::spawn_blocking` and `JoinSet::spawn_blocking_on`
([#&#8203;5612])

##### Changed

-   deps: update windows-sys to 0.48 ([#&#8203;5591])
-   io: make `read_to_end` not grow unnecessarily ([#&#8203;5610])
-   macros: make entrypoints more efficient ([#&#8203;5621])
-   sync: improve Debug impl for `RwLock` ([#&#8203;5647])
-   sync: reduce contention in `Notify` ([#&#8203;5503])

##### Fixed

-   net: support `get_peer_cred` on AIX ([#&#8203;5065])
- sync: avoid deadlocks in `broadcast` with custom wakers
([#&#8203;5578])

##### Documented

-   sync: fix typo in `Semaphore::MAX_PERMITS` ([#&#8203;5645])
-   sync: fix typo in `tokio::sync::watch::Sender` docs ([#&#8203;5587])

[#&#8203;5065]: https://togithub.com/tokio-rs/tokio/pull/5065

[#&#8203;5503]: https://togithub.com/tokio-rs/tokio/pull/5503

[#&#8203;5542]: https://togithub.com/tokio-rs/tokio/pull/5542

[#&#8203;5578]: https://togithub.com/tokio-rs/tokio/pull/5578

[#&#8203;5583]: https://togithub.com/tokio-rs/tokio/pull/5583

[#&#8203;5587]: https://togithub.com/tokio-rs/tokio/pull/5587

[#&#8203;5590]: https://togithub.com/tokio-rs/tokio/pull/5590

[#&#8203;5591]: https://togithub.com/tokio-rs/tokio/pull/5591

[#&#8203;5607]: https://togithub.com/tokio-rs/tokio/pull/5607

[#&#8203;5610]: https://togithub.com/tokio-rs/tokio/pull/5610

[#&#8203;5611]: https://togithub.com/tokio-rs/tokio/pull/5611

[#&#8203;5612]: https://togithub.com/tokio-rs/tokio/pull/5612

[#&#8203;5618]: https://togithub.com/tokio-rs/tokio/pull/5618

[#&#8203;5621]: https://togithub.com/tokio-rs/tokio/pull/5621

[#&#8203;5645]: https://togithub.com/tokio-rs/tokio/pull/5645

[#&#8203;5647]: https://togithub.com/tokio-rs/tokio/pull/5647

###
[`v1.27.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.27.0):
Tokio v1.27.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.26.0...tokio-1.27.0)

### 1.27.0 (March 27th, 2023)

This release bumps the MSRV of Tokio to 1.56. ([#&#8203;5559])

##### Added

-   io: add `async_io` helper method to sockets ([#&#8203;5512])
- io: add implementations of `AsFd`/`AsHandle`/`AsSocket`
([#&#8203;5514], [#&#8203;5540])
-   net: add `UdpSocket::peek_sender()` ([#&#8203;5520])
- sync: add `RwLockWriteGuard::{downgrade_map, try_downgrade_map}`
([#&#8203;5527])
-   task: add `JoinHandle::abort_handle` ([#&#8203;5543])

##### Changed

-   io: use `memchr` from `libc` ([#&#8203;5558])
- macros: accept path as crate rename in `#[tokio::main]`
([#&#8203;5557])
-   macros: update to syn 2.0.0 ([#&#8203;5572])
- time: don't register for a wakeup when `Interval` returns `Ready`
([#&#8203;5553])

##### Fixed

-   fs: fuse std iterator in `ReadDir` ([#&#8203;5555])
-   tracing: fix `spawn_blocking` location fields ([#&#8203;5573])
-   time: clean up redundant check in `Wheel::poll()` ([#&#8203;5574])

##### Documented

-   macros: define cancellation safety ([#&#8203;5525])
-   io: add details to docs of `tokio::io::copy[_buf]` ([#&#8203;5575])
- io: refer to `ReaderStream` and `StreamReader` in module docs
([#&#8203;5576])

[#&#8203;5512]: https://togithub.com/tokio-rs/tokio/pull/5512

[#&#8203;5514]: https://togithub.com/tokio-rs/tokio/pull/5514

[#&#8203;5520]: https://togithub.com/tokio-rs/tokio/pull/5520

[#&#8203;5525]: https://togithub.com/tokio-rs/tokio/pull/5525

[#&#8203;5527]: https://togithub.com/tokio-rs/tokio/pull/5527

[#&#8203;5540]: https://togithub.com/tokio-rs/tokio/pull/5540

[#&#8203;5543]: https://togithub.com/tokio-rs/tokio/pull/5543

[#&#8203;5553]: https://togithub.com/tokio-rs/tokio/pull/5553

[#&#8203;5555]: https://togithub.com/tokio-rs/tokio/pull/5555

[#&#8203;5557]: https://togithub.com/tokio-rs/tokio/pull/5557

[#&#8203;5558]: https://togithub.com/tokio-rs/tokio/pull/5558

[#&#8203;5559]: https://togithub.com/tokio-rs/tokio/pull/5559

[#&#8203;5572]: https://togithub.com/tokio-rs/tokio/pull/5572

[#&#8203;5573]: https://togithub.com/tokio-rs/tokio/pull/5573

[#&#8203;5574]: https://togithub.com/tokio-rs/tokio/pull/5574

[#&#8203;5575]: https://togithub.com/tokio-rs/tokio/pull/5575

[#&#8203;5576]: https://togithub.com/tokio-rs/tokio/pull/5576

###
[`v1.26.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.26.0):
Tokio v1.26.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.25.3...tokio-1.26.0)

##### Fixed

- macros: fix empty `join!` and `try_join!`
([[https://github.com/tokio-rs/tokio/pull/5504](https://togithub.com/tokio-rs/tokio/pull/5504)])
- sync: don't leak tracing spans in mutex guards
([[https://github.com/tokio-rs/tokio/pull/5469](https://togithub.com/tokio-rs/tokio/pull/5469)])
- sync: drop wakers after unlocking the mutex in Notify
([[https://github.com/tokio-rs/tokio/pull/5471](https://togithub.com/tokio-rs/tokio/pull/5471)])
- sync: drop wakers outside lock in semaphore
([[https://github.com/tokio-rs/tokio/pull/5475](https://togithub.com/tokio-rs/tokio/pull/5475)])

##### Added

- fs: add `fs::try_exists`
([[https://github.com/tokio-rs/tokio/pull/4299](https://togithub.com/tokio-rs/tokio/pull/4299)])
- net: add types for named unix pipes
([[https://github.com/tokio-rs/tokio/pull/5351](https://togithub.com/tokio-rs/tokio/pull/5351)])
- sync: add `MappedOwnedMutexGuard`
([[https://github.com/tokio-rs/tokio/pull/5474](https://togithub.com/tokio-rs/tokio/pull/5474)])

##### Changed

- chore: update windows-sys to 0.45
([[https://github.com/tokio-rs/tokio/pull/5386](https://togithub.com/tokio-rs/tokio/pull/5386)])
- net: use Message Read Mode for named pipes
([[https://github.com/tokio-rs/tokio/pull/5350](https://togithub.com/tokio-rs/tokio/pull/5350)])
- sync: mark lock guards with `#[clippy::has_significant_drop]`
([[https://github.com/tokio-rs/tokio/pull/5422](https://togithub.com/tokio-rs/tokio/pull/5422)])
- sync: reduce contention in watch channel
([[https://github.com/tokio-rs/tokio/pull/5464](https://togithub.com/tokio-rs/tokio/pull/5464)])
- time: remove cache padding in timer entries
([[https://github.com/tokio-rs/tokio/pull/5468](https://togithub.com/tokio-rs/tokio/pull/5468)])
- time: Improve `Instant::now()` perf with test-util
([[https://github.com/tokio-rs/tokio/pull/5513](https://togithub.com/tokio-rs/tokio/pull/5513)])

##### Internal Changes

- io: use `poll_fn` in `copy_bidirectional`
([[https://github.com/tokio-rs/tokio/pull/5486](https://togithub.com/tokio-rs/tokio/pull/5486)])
- net: refactor named pipe builders to not use bitfields
([[https://github.com/tokio-rs/tokio/pull/5477](https://togithub.com/tokio-rs/tokio/pull/5477)])
- rt: remove Arc from Clock
([[https://github.com/tokio-rs/tokio/pull/5434](https://togithub.com/tokio-rs/tokio/pull/5434)])
- sync: make `notify_waiters` calls atomic
([[https://github.com/tokio-rs/tokio/pull/5458](https://togithub.com/tokio-rs/tokio/pull/5458)])
- time: don't store deadline twice in sleep entries
([[https://github.com/tokio-rs/tokio/pull/5410](https://togithub.com/tokio-rs/tokio/pull/5410)])

##### Unstable

- metrics: add a new metric for budget exhaustion yields
([[https://github.com/tokio-rs/tokio/pull/5517](https://togithub.com/tokio-rs/tokio/pull/5517)])

##### Documented

- io: improve AsyncFd example
([[https://github.com/tokio-rs/tokio/pull/5481](https://togithub.com/tokio-rs/tokio/pull/5481)])
- runtime: document the nature of the main future
([[https://github.com/tokio-rs/tokio/pull/5494](https://togithub.com/tokio-rs/tokio/pull/5494)])
- runtime: remove extra period in docs
([[https://github.com/tokio-rs/tokio/pull/5511](https://togithub.com/tokio-rs/tokio/pull/5511)])
- signal: updated Documentation for Signals
([[https://github.com/tokio-rs/tokio/pull/5459](https://togithub.com/tokio-rs/tokio/pull/5459)])
- sync: add doc aliases for `blocking_*` methods
([[https://github.com/tokio-rs/tokio/pull/5448](https://togithub.com/tokio-rs/tokio/pull/5448)])
- sync: fix docs for Send/Sync bounds in broadcast
([[https://github.com/tokio-rs/tokio/pull/5480](https://togithub.com/tokio-rs/tokio/pull/5480)])
- sync: document drop behavior for channels
([[https://github.com/tokio-rs/tokio/pull/5497](https://togithub.com/tokio-rs/tokio/pull/5497)])
- task: clarify what happens to spawned work during runtime shutdown
([[https://github.com/tokio-rs/tokio/pull/5394](https://togithub.com/tokio-rs/tokio/pull/5394)])
- task: clarify `process::Command` docs
([[https://github.com/tokio-rs/tokio/pull/5413](https://togithub.com/tokio-rs/tokio/pull/5413)])
- task: fix wording with 'unsend'
([[https://github.com/tokio-rs/tokio/pull/5452](https://togithub.com/tokio-rs/tokio/pull/5452)])
- time: document immediate completion guarantee for timeouts
([[https://github.com/tokio-rs/tokio/pull/5509](https://togithub.com/tokio-rs/tokio/pull/5509)])
- tokio: document supported platforms
([[https://github.com/tokio-rs/tokio/pull/5483](https://togithub.com/tokio-rs/tokio/pull/5483)])

[https://github.com/tokio-rs/tokio/pull/4299]:
https://togithub.com/tokio-rs/tokio/pull/4299

[https://github.com/tokio-rs/tokio/pull/5350]:
https://togithub.com/tokio-rs/tokio/pull/5350

[https://github.com/tokio-rs/tokio/pull/5351]:
https://togithub.com/tokio-rs/tokio/pull/5351

[https://github.com/tokio-rs/tokio/pull/5386]:
https://togithub.com/tokio-rs/tokio/pull/5386

[https://github.com/tokio-rs/tokio/pull/5394]:
https://togithub.com/tokio-rs/tokio/pull/5394

[https://github.com/tokio-rs/tokio/pull/5410]:
https://togithub.com/tokio-rs/tokio/pull/5410

[https://github.com/tokio-rs/tokio/pull/5413]:
https://togithub.com/tokio-rs/tokio/pull/5413

[https://github.com/tokio-rs/tokio/pull/5422]:
https://togithub.com/tokio-rs/tokio/pull/5422

[https://github.com/tokio-rs/tokio/pull/5434]:
https://togithub.com/tokio-rs/tokio/pull/5434

[https://github.com/tokio-rs/tokio/pull/5448]:
https://togithub.com/tokio-rs/tokio/pull/5448

[https://github.com/tokio-rs/tokio/pull/5452]:
https://togithub.com/tokio-rs/tokio/pull/5452

[https://github.com/tokio-rs/tokio/pull/5458]:
https://togithub.com/tokio-rs/tokio/pull/5458

[https://github.com/tokio-rs/tokio/pull/5459]:
https://togithub.com/tokio-rs/tokio/pull/5459

[https://github.com/tokio-rs/tokio/pull/5464]:
https://togithub.com/tokio-rs/tokio/pull/5464

[https://github.com/tokio-rs/tokio/pull/5468]:
https://togithub.com/tokio-rs/tokio/pull/5468

[https://github.com/tokio-rs/tokio/pull/5469]:
https://togithub.com/tokio-rs/tokio/pull/5469

[https://github.com/tokio-rs/tokio/pull/5471]:
https://togithub.com/tokio-rs/tokio/pull/5471

[https://github.com/tokio-rs/tokio/pull/5474]:
https://togithub.com/tokio-rs/tokio/pull/5474

[https://github.com/tokio-rs/tokio/pull/5475]:
https://togithub.com/tokio-rs/tokio/pull/5475

[https://github.com/tokio-rs/tokio/pull/5477]:
https://togithub.com/tokio-rs/tokio/pull/5477

[https://github.com/tokio-rs/tokio/pull/5480]:
https://togithub.com/tokio-rs/tokio/pull/5480

[https://github.com/tokio-rs/tokio/pull/5481]:
https://togithub.com/tokio-rs/tokio/pull/5481

[https://github.com/tokio-rs/tokio/pull/5483]:
https://togithub.com/tokio-rs/tokio/pull/5483

[https://github.com/tokio-rs/tokio/pull/5486]:
https://togithub.com/tokio-rs/tokio/pull/5486

[https://github.com/tokio-rs/tokio/pull/5494]:
https://togithub.com/tokio-rs/tokio/pull/5494

[https://github.com/tokio-rs/tokio/pull/5497]:
https://togithub.com/tokio-rs/tokio/pull/5497

[https://github.com/tokio-rs/tokio/pull/5504]:
https://togithub.com/tokio-rs/tokio/pull/5504

[https://github.com/tokio-rs/tokio/pull/5509]:
https://togithub.com/tokio-rs/tokio/pull/5509

[https://github.com/tokio-rs/tokio/pull/5511]:
https://togithub.com/tokio-rs/tokio/pull/5511

[https://github.com/tokio-rs/tokio/pull/5513]:
https://togithub.com/tokio-rs/tokio/pull/5513

[https://github.com/tokio-rs/tokio/pull/5517]:
https://togithub.com/tokio-rs/tokio/pull/5517

###
[`v1.25.3`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.25.3):
Tokio v1.25.3

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.25.2...tokio-1.25.3)

### 1.25.3 (December 17th, 2023)

##### Fixed

- io: add budgeting to `tokio::runtime::io::registration::async_io`
([#&#8203;6221])

[#&#8203;6221]: https://togithub.com/tokio-rs/tokio/pull/6221

###
[`v1.25.2`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.25.2):
Tokio v1.25.2

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.25.1...tokio-1.25.2)

### 1.25.2 (September 22, 2023)

Forward ports 1.20.6 changes.

##### Changed

-   io: use `memchr` from `libc` ([#&#8203;5960])

[#&#8203;5960]: https://togithub.com/tokio-rs/tokio/pull/5960

###
[`v1.25.1`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.25.1):
Tokio v1.25.1

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.25.0...tokio-1.25.1)

### 1.25.1 (May 28, 2023)

Forward ports 1.18.6 changes.

##### Fixed

-   deps: disable default features for mio ([#&#8203;5728])

[#&#8203;5728]: https://togithub.com/tokio-rs/tokio/pull/5728

###
[`v1.25.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.25.0):
Tokio v1.25.0

### 1.25.0 (January 28, 2023)

##### Fixed

-   rt: fix runtime metrics reporting ([#&#8203;5330])

##### Added

-   sync: add `broadcast::Sender::len` ([#&#8203;5343])

##### Changed

-   fs: increase maximum read buffer size to 2MiB ([#&#8203;5397])

[#&#8203;5330]: https://togithub.com/tokio-rs/tokio/pull/5330

[#&#8203;5343]: https://togithub.com/tokio-rs/tokio/pull/5343

[#&#8203;5397]: https://togithub.com/tokio-rs/tokio/pull/5397

###
[`v1.24.1`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.24.1):
Tokio v1.24.1

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.24.0...tokio-1.24.1)

This release fixes a compilation failure on targets without `AtomicU64`
when using rustc older than 1.63. ([#&#8203;5356])

[#&#8203;5356]: https://togithub.com/tokio-rs/tokio/pull/5356

###
[`v1.24.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.24.0):
Tokio v1.24.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.23.1...tokio-1.24.0)

The highlight of this release is the reduction of lock contention for
all I/O operations
([#&#8203;5300](https://togithub.com/tokio-rs/tokio/issues/5300)). We
have received reports of up to a 20% improvement in CPU utilization and
increased throughput for real-world I/O heavy applications.

##### Fixed

-   rt: improve native `AtomicU64` support detection ([#&#8203;5284])

##### Added

- rt: add configuration option for max number of I/O events polled from
the OS
    per tick ([#&#8203;5186])
- rt: add an environment variable for configuring the default number of
worker
    threads per runtime instance ([#&#8203;4250])

##### Changed

-   sync: reduce MPSC channel stack usage ([#&#8203;5294])
-   io: reduce lock contention in I/O operations  ([#&#8203;5300])
-   fs: speed up `read_dir()` by chunking operations ([#&#8203;5309])
-   rt: use internal `ThreadId` implementation ([#&#8203;5329])
- test: don't auto-advance time when a `spawn_blocking` task is running
([#&#8203;5115])

[#&#8203;5186]: https://togithub.com/tokio-rs/tokio/pull/5186

[#&#8203;5294]: https://togithub.com/tokio-rs/tokio/pull/5294

[#&#8203;5284]: https://togithub.com/tokio-rs/tokio/pull/5284

[#&#8203;4250]: https://togithub.com/tokio-rs/tokio/pull/4250

[#&#8203;5300]: https://togithub.com/tokio-rs/tokio/pull/5300

[#&#8203;5329]: https://togithub.com/tokio-rs/tokio/pull/5329

[#&#8203;5115]: https://togithub.com/tokio-rs/tokio/pull/5115

[#&#8203;5309]: https://togithub.com/tokio-rs/tokio/pull/5309

###
[`v1.23.1`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.23.1):
Tokio v1.23.1

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.23.0...tokio-1.23.1)

This release forward ports changes from 1.18.4.

##### Fixed

- net: fix Windows named pipe server builder to maintain option when
toggling
    pipe mode ([#&#8203;5336]).

[#&#8203;5336]: https://togithub.com/tokio-rs/tokio/pull/5336

###
[`v1.23.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.23.0):
Tokio v1.23.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.22.0...tokio-1.23.0)

##### Fixed

-   net: fix Windows named pipe connect ([#&#8203;5208])
-   io: support vectored writes for `ChildStdin` ([#&#8203;5216])
- io: fix `async fn ready()` false positive for OS-specific events
([#&#8203;5231])

##### Changed

- runtime: `yield_now` defers task until after driver poll
([#&#8203;5223])
- runtime: reduce amount of codegen needed per spawned task
([#&#8203;5213])
- windows: replace `winapi` dependency with `windows-sys`
([#&#8203;5204])

[#&#8203;5208]: https://togithub.com/tokio-rs/tokio/pull/5208

[#&#8203;5216]: https://togithub.com/tokio-rs/tokio/pull/5216

[#&#8203;5213]: https://togithub.com/tokio-rs/tokio/pull/5213

[#&#8203;5204]: https://togithub.com/tokio-rs/tokio/pull/5204

[#&#8203;5223]: https://togithub.com/tokio-rs/tokio/pull/5223

[#&#8203;5231]: https://togithub.com/tokio-rs/tokio/pull/5231

###
[`v1.22.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.22.0):
Tokio v1.22.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.21.2...tokio-1.22.0)

##### Added

-   runtime: add `Handle::runtime_flavor` ([#&#8203;5138])
-   sync: add `Mutex::blocking_lock_owned` ([#&#8203;5130])
-   sync: add `Semaphore::MAX_PERMITS` ([#&#8203;5144])
-   sync: add `merge()` to semaphore permits ([#&#8203;4948])
-   sync: add `mpsc::WeakUnboundedSender` ([#&#8203;5189])

##### Added (unstable)

-   process: add `Command::process_group` ([#&#8203;5114])
- runtime: export metrics about the blocking thread pool
([#&#8203;5161])
-   task: add `task::id()` and `task::try_id()` ([#&#8203;5171])

##### Fixed

-   macros: don't take ownership of futures in macros ([#&#8203;5087])
- runtime: fix Stacked Borrows violation in `LocalOwnedTasks`
([#&#8203;5099])
- runtime: mitigate ABA with 32-bit queue indices when possible
([#&#8203;5042])
- task: wake local tasks to the local queue when woken by the same
thread ([#&#8203;5095])
- time: panic in release mode when `mark_pending` called illegally
([#&#8203;5093])
-   runtime: fix typo in expect message ([#&#8203;5169])
-   runtime: fix `unsync_load` on atomic types ([#&#8203;5175])
- task: elaborate safety comments in task deallocation ([#&#8203;5172])
-   runtime: fix `LocalSet` drop in thread local ([#&#8203;5179])
-   net: remove libc type leakage in a public API ([#&#8203;5191])
-   runtime: update the alignment of `CachePadded` ([#&#8203;5106])

##### Changed

- io: make `tokio::io::copy` continue filling the buffer when writer
stalls ([#&#8203;5066])
- runtime: remove `coop::budget` from `LocalSet::run_until`
([#&#8203;5155])
-   sync: make `Notify` panic safe ([#&#8203;5154])

##### Documented

-   io: fix doc for `write_i8` to use signed integers ([#&#8203;5040])
- net: fix doc typos for TCP and UDP `set_tos` methods ([#&#8203;5073])
- net: fix function name in `UdpSocket::recv` documentation
([#&#8203;5150])
- sync: typo in `TryLockError` for `RwLock::try_write` ([#&#8203;5160])
- task: document that spawned tasks execute immediately ([#&#8203;5117])
-   time: document return type of `timeout` ([#&#8203;5118])
- time: document that `timeout` checks only before poll ([#&#8203;5126])
- sync: specify return type of `oneshot::Receiver` in docs
([#&#8203;5198])

##### Internal changes

-   runtime: use const `Mutex::new` for globals ([#&#8203;5061])
- runtime: remove `Option` around `mio::Events` in io driver
([#&#8203;5078])
-   runtime: remove a conditional compilation clause ([#&#8203;5104])
-   runtime: remove a reference to internal time handle ([#&#8203;5107])
-   runtime: misc time driver cleanup ([#&#8203;5120])
-   runtime: move signal driver to runtime module ([#&#8203;5121])
-   runtime: signal driver now uses I/O driver directly ([#&#8203;5125])
-   runtime: start decoupling I/O driver and I/O handle ([#&#8203;5127])
- runtime: switch `io::handle` refs with scheduler:Handle
([#&#8203;5128])
-   runtime: remove Arc from I/O driver ([#&#8203;5134])
- runtime: use signal driver handle via `scheduler::Handle`
([#&#8203;5135])
-   runtime: move internal clock fns out of context ([#&#8203;5139])
-   runtime: remove `runtime::context` module ([#&#8203;5140])
-   runtime: keep driver cfgs in `driver.rs` ([#&#8203;5141])
- runtime: add `runtime::context` to unify thread-locals
([#&#8203;5143])
- runtime: rename some confusing internal variables/fns ([#&#8203;5151])
-   runtime: move `coop` mod into `runtime` ([#&#8203;5152])
-   runtime: move budget state to context thread-local ([#&#8203;5157])
-   runtime: move park logic into runtime module ([#&#8203;5158])
-   runtime: move `Runtime` into its own file ([#&#8203;5159])
- runtime: unify entering a runtime with `Handle::enter`
([#&#8203;5163])
- runtime: remove handle reference from each scheduler ([#&#8203;5166])
-   runtime: move `enter` into `context` ([#&#8203;5167])
-   runtime: combine context and entered thread-locals ([#&#8203;5168])
-   runtime: fix accidental unsetting of current handle ([#&#8203;5178])
-   runtime: move `CoreStage` methods to `Core` ([#&#8203;5182])
-   sync: name mpsc semaphore types ([#&#8203;5146])

[#&#8203;4948]: https://togithub.com/tokio-rs/tokio/pull/4948

[#&#8203;5040]: https://togithub.com/tokio-rs/tokio/pull/5040

[#&#8203;5042]: https://togithub.com/tokio-rs/tokio/pull/5042

[#&#8203;5061]: https://togithub.com/tokio-rs/tokio/pull/5061

[#&#8203;5066]: https://togithub.com/tokio-rs/tokio/pull/5066

[#&#8203;5073]: https://togithub.com/tokio-rs/tokio/pull/5073

[#&#8203;5078]: https://togithub.com/tokio-rs/tokio/pull/5078

[#&#8203;5087]: https://togithub.com/tokio-rs/tokio/pull/5087

[#&#8203;5093]: https://togithub.com/tokio-rs/tokio/pull/5093

[#&#8203;5095]: https://togithub.com/tokio-rs/tokio/pull/5095

[#&#8203;5099]: https://togithub.com/tokio-rs/tokio/pull/5099

[#&#8203;5104]: https://togithub.com/tokio-rs/tokio/pull/5104

[#&#8203;5106]: https://togithub.com/tokio-rs/tokio/pull/5106

[#&#8203;5107]: https://togithub.com/tokio-rs/tokio/pull/5107

[#&#8203;5114]: https://togithub.com/tokio-rs/tokio/pull/5114

[#&#8203;5117]: https://togithub.com/tokio-rs/tokio/pull/5117

[#&#8203;5118]: https://togithub.com/tokio-rs/tokio/pull/5118

[#&#8203;5120]: https://togithub.com/tokio-rs/tokio/pull/5120

[#&#8203;5121]: https://togithub.com/tokio-rs/tokio/pull/5121

[#&#8203;5125]: https://togithub.com/tokio-rs/tokio/pull/5125

[#&#8203;5126]: https://togithub.com/tokio-rs/tokio/pull/5126

[#&#8203;5127]: https://togithub.com/tokio-rs/tokio/pull/5127

[#&#8203;5128]: https://togithub.com/tokio-rs/tokio/pull/5128

[#&#8203;5130]: https://togithub.com/tokio-rs/tokio/pull/5130

[#&#8203;5134]: https://togithub.com/tokio-rs/tokio/pull/5134

[#&#8203;5135]: https://togithub.com/tokio-rs/tokio/pull/5135

[#&#8203;5138]: https://togithub.com/tokio-rs/tokio/pull/5138

[#&#8203;5138]: https://togithub.com/tokio-rs/tokio/pull/5138

[#&#8203;5139]: https://togithub.com/tokio-rs/tokio/pull/5139

[#&#8203;5140]: https://togithub.com/tokio-rs/tokio/pull/5140

[#&#8203;5141]: https://togithub.com/tokio-rs/tokio/pull/5141

[#&#8203;5143]: https://togithub.com/tokio-rs/tokio/pull/5143

[#&#8203;5144]: https://togithub.com/tokio-rs/tokio/pull/5144

[#&#8203;5144]: https://togithub.com/tokio-rs/tokio/pull/5144

[#&#8203;5146]: https://togithub.com/tokio-rs/tokio/pull/5146

[#&#8203;5150]: https://togithub.com/tokio-rs/tokio/pull/5150

[#&#8203;5151]: https://togithub.com/tokio-rs/tokio/pull/5151

[#&#8203;5152]: https://togithub.com/tokio-rs/tokio/pull/5152

[#&#8203;5154]: https://togithub.com/tokio-rs/tokio/pull/5154

[#&#8203;5155]: https://togithub.com/tokio-rs/tokio/pull/5155

[#&#8203;5157]: https://togithub.com/tokio-rs/tokio/pull/5157

[#&#8203;5158]: https://togithub.com/tokio-rs/tokio/pull/5158

[#&#8203;5159]: https://togithub.com/tokio-rs/tokio/pull/5159

[#&#8203;5160]: https://togithub.com/tokio-rs/tokio/pull/5160

[#&#8203;5161]: https://togithub.com/tokio-rs/tokio/pull/5161

[#&#8203;5163]: https://togithub.com/tokio-rs/tokio/pull/5163

[#&#8203;5166]: https://togithub.com/tokio-rs/tokio/pull/5166

[#&#8203;5167]: https://togithub.com/tokio-rs/tokio/pull/5167

[#&#8203;5168]: https://togithub.com/tokio-rs/tokio/pull/5168

[#&#8203;5169]: https://togithub.com/tokio-rs/tokio/pull/5169

[#&#8203;5171]: https://togithub.com/tokio-rs/tokio/pull/5171

[#&#8203;5172]: https://togithub.com/tokio-rs/tokio/pull/5172

[#&#8203;5175]: https://togithub.com/tokio-rs/tokio/pull/5175

[#&#8203;5178]: https://togithub.com/tokio-rs/tokio/pull/5178

[#&#8203;5179]: https://togithub.com/tokio-rs/tokio/pull/5179

[#&#8203;5182]: https://togithub.com/tokio-rs/tokio/pull/5182

[#&#8203;5189]: https://togithub.com/tokio-rs/tokio/pull/5189

[#&#8203;5191]: https://togithub.com/tokio-rs/tokio/pull/5191

[#&#8203;5198]: https://togithub.com/tokio-rs/tokio/pull/5198

###
[`v1.21.2`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.21.2):
Tokio v1.21.2

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.21.1...tokio-1.21.2)

### 1.21.2 (September 27, 2022)

This release removes the dependency on the `once_cell` crate to restore
the MSRV of 1.21.x, which is the latest minor version at the time of
release. ([#&#8203;5048])

[#&#8203;5048]: https://togithub.com/tokio-rs/tokio/pull/5048

###
[`v1.21.1`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.21.1):
Tokio v1.21.1

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.21.0...tokio-1.21.1)

### 1.21.1 (September 13, 2022)

##### Fixed

-   net: fix dependency resolution for socket2 ([#&#8203;5000])
-   task: ignore failure to set TLS in `LocalSet` Drop ([#&#8203;4976])

[#&#8203;4976]: https://togithub.com/tokio-rs/tokio/pull/4976

[#&#8203;5000]: https://togithub.com/tokio-rs/tokio/pull/5000

###
[`v1.21.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.21.0):
Tokio v1.21.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.20.6...tokio-1.21.0)

### 1.21.0 (September 2, 2022)

This release is the first release of Tokio to intentionally support
WASM. The `sync,macros,io-util,rt,time` features are stabilized on WASM.
Additionally the wasm32-wasi target is given unstable support for the
`net` feature.

##### Added

- net: add `device` and `bind_device` methods to TCP/UDP sockets
([#&#8203;4882])
- net: add `tos` and `set_tos` methods to TCP and UDP sockets
([#&#8203;4877])
- net: add security flags to named pipe `ServerOptions` ([#&#8203;4845])
-   signal: add more windows signal handlers ([#&#8203;4924])
-   sync: add `mpsc::Sender::max_capacity` method ([#&#8203;4904])
-   sync: implement Weak version of `mpsc::Sender` ([#&#8203;4595])
-   task: add `LocalSet::enter` ([#&#8203;4765])
-   task: stabilize `JoinSet` and `AbortHandle` ([#&#8203;4920])
- tokio: add `track_caller` to public APIs ([#&#8203;4805],
[#&#8203;4848], [#&#8203;4852])
-   wasm: initial support for `wasm32-wasi` target ([#&#8203;4716])

##### Fixed

- miri: improve miri compatibility by avoiding temporary references in
`linked_list::Link` impls ([#&#8203;4841])
- signal: don't register write interest on signal pipe ([#&#8203;4898])
-   sync: add `#[must_use]` to lock guards ([#&#8203;4886])
- sync: fix hang when calling `recv` on closed and reopened broadcast
channel ([#&#8203;4867])
-   task: propagate attributes on task-locals ([#&#8203;4837])

##### Changed

-   fs: change panic to error in `File::start_seek` ([#&#8203;4897])
-   io: reduce syscalls in `poll_read` ([#&#8203;4840])
- process: use blocking threadpool for child stdio I/O ([#&#8203;4824])
-   signal: make `SignalKind` methods const ([#&#8203;4956])

##### Internal changes

-   rt: extract `basic_scheduler::Config` ([#&#8203;4935])
-   rt: move I/O driver into `runtime` module ([#&#8203;4942])
-   rt: rename internal scheduler types ([#&#8203;4945])

##### Documented

- chore: fix typos and grammar ([#&#8203;4858], [#&#8203;4894],
[#&#8203;4928])
-   io: fix typo in `AsyncSeekExt::rewind` docs ([#&#8203;4893])
- net: add documentation to `try_read()` for zero-length buffers
([#&#8203;4937])
- runtime: remove incorrect panic section for `Builder::worker_threads`
([#&#8203;4849])
-   sync: doc of `watch::Sender::send` improved ([#&#8203;4959])
-   task: add cancel safety docs to `JoinHandle` ([#&#8203;4901])
-   task: expand on cancellation of `spawn_blocking` ([#&#8203;4811])
- time: clarify that the first tick of `Interval::tick` happens
immediately ([#&#8203;4951])

##### Unstable

-   rt: add unstable option to disable the LIFO slot ([#&#8203;4936])
- task: fix incorrect signature in `Builder::spawn_on` ([#&#8203;4953])
-   task: make `task::Builder::spawn*` methods fallible ([#&#8203;4823])

[#&#8203;4595]: https://togithub.com/tokio-rs/tokio/pull/4595

[#&#8203;4716]: https://togithub.com/tokio-rs/tokio/pull/4716

[#&#8203;4765]: https://togithub.com/tokio-rs/tokio/pull/4765

[#&#8203;4805]: https://togithub.com/tokio-rs/tokio/pull/4805

[#&#8203;4811]: https://togithub.com/tokio-rs/tokio/pull/4811

[#&#8203;4823]: https://togithub.com/tokio-rs/tokio/pull/4823

[#&#8203;4824]: https://togithub.com/tokio-rs/tokio/pull/4824

[#&#8203;4837]: https://togithub.com/tokio-rs/tokio/pull/4837

[#&#8203;4840]: https://togithub.com/tokio-rs/tokio/pull/4840

[#&#8203;4841]: https://togithub.com/tokio-rs/tokio/pull/4841

[#&#8203;4845]: https://togithub.com/tokio-rs/tokio/pull/4845

[#&#8203;4848]: https://togithub.com/tokio-rs/tokio/pull/4848

[#&#8203;4849]: https://togithub.com/tokio-rs/tokio/pull/4849

[#&#8203;4852]: https://togithub.com/tokio-rs/tokio/pull/4852

[#&#8203;4858]: https://togithub.com/tokio-rs/tokio/pull/4858

[#&#8203;4867]: https://togithub.com/tokio-rs/tokio/pull/4867

[#&#8203;4877]: https://togithub.com/tokio-rs/tokio/pull/4877

[#&#8203;4882]: https://togithub.com/tokio-rs/tokio/pull/4882

[#&#8203;4886]: https://togithub.com/tokio-rs/tokio/pull/4886

[#&#8203;4893]: https://togithub.com/tokio-rs/tokio/pull/4893

[#&#8203;4894]: https://togithub.com/tokio-rs/tokio/pull/4894

[#&#8203;4897]: https://togithub.com/tokio-rs/tokio/pull/4897

[#&#8203;4898]: https://togithub.com/tokio-rs/tokio/pull/4898

[#&#8203;4901]: https://togithub.com/tokio-rs/tokio/pull/4901

[#&#8203;4904]: https://togithub.com/tokio-rs/tokio/pull/4904

[#&#8203;4920]: https://togithub.com/tokio-rs/tokio/pull/4920

[#&#8203;4924]: https://togithub.com/tokio-rs/tokio/pull/4924

[#&#8203;4928]: https://togithub.com/tokio-rs/tokio/pull/4928

[#&#8203;4935]: https://togithub.com/tokio-rs/tokio/pull/4935

[#&#8203;4936]: https://togithub.com/tokio-rs/tokio/pull/4936

[#&#8203;4937]: https://togithub.com/tokio-rs/tokio/pull/4937

[#&#8203;4942]: https://togithub.com/tokio-rs/tokio/pull/4942

[#&#8203;4945]: https://togithub.com/tokio-rs/tokio/pull/4945

[#&#8203;4951]: https://togithub.com/tokio-rs/tokio/pull/4951

[#&#8203;4953]: https://togithub.com/tokio-rs/tokio/pull/4953

[#&#8203;4956]: https://togithub.com/tokio-rs/tokio/pull/4956

[#&#8203;4959]: https://togithub.com/tokio-rs/tokio/pull/4959

###
[`v1.20.6`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.20.6):
Tokio v1.20.6

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.20.5...tokio-1.20.6)

### 1.20.6 (September 22, 2023)

This is a backport of a change from 1.27.0.

##### Changed

-   io: use `memchr` from `libc` ([#&#8203;5960])

[#&#8203;5960]: https://togithub.com/tokio-rs/tokio/pull/5960

###
[`v1.20.5`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.20.5):
Tokio v1.20.5

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.20.4...tokio-1.20.5)

### 1.20.5 (May 28, 2023)

Forward ports 1.18.6 changes.

##### Fixed

-   deps: disable default features for mio ([#&#8203;5728])

[#&#8203;5728]: https://togithub.com/tokio-rs/tokio/pull/5728

###
[`v1.20.4`](https://togithub.com/tokio-rs/tokio/compare/tokio-1.20.3...tokio-1.20.4)

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.20.3...tokio-1.20.4)

###
[`v1.20.3`](https://togithub.com/tokio-rs/tokio/compare/tokio-1.20.2...tokio-1.20.3)

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.20.2...tokio-1.20.3)

###
[`v1.20.2`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.20.2):
Tokio v1.20.2

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.20.1...tokio-1.20.2)

### 1.20.2 (September 27, 2022)

This release removes the dependency on the `once_cell` crate to restore
the MSRV of the 1.20.x LTS release. ([#&#8203;5048])

[#&#8203;5048]: https://togithub.com/tokio-rs/tokio/pull/5048

###
[`v1.20.1`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.20.1):
Tokio v1.20.1

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.20.0...tokio-1.20.1)

### 1.20.1 (July 25, 2022)

##### Fixed

-   chore: fix version detection in build script ([#&#8203;4860])

[#&#8203;4860]: https://togithub.com/tokio-rs/tokio/pull/4860

###
[`v1.20.0`](https://togithub.com/tokio-rs/tokio/releases/tag/tokio-1.20.0):
Tokio v1.20.0

[Compare
Source](https://togithub.com/tokio-rs/tokio/compare/tokio-1.19.2...tokio-1.20.0)

### 1.20.0 (July 12, 2022)

##### Added

- tokio: add track_caller to public APIs ([#&#8203;4772],
[#&#8203;4791], [#&#8203;4793], [#&#8203;4806], [#&#8203;4808])
-   sync: Add `has_changed` method to `watch::Ref` ([#&#8203;4758])

##### Changed

-   time: remove `src/time/driver/wheel/stack.rs` ([#&#8203;4766])
-   rt: clean up arguments passed to basic scheduler ([#&#8203;4767])
-   net: be more specific about winapi features ([#&#8203;4764])
- tokio: use const initialized thread locals where possible
([#&#8203;4677])
-   task: various small improvements to LocalKey ([#&#8203;4795])

##### Fixed

##### Documented

-   fs: warn about performance pitfall ([#&#8203;4762])
-   chore: fix spelling ([#&#8203;4769])
-   sync: document spurious failures in oneshot ([#&#8203;4777])
-   sync: add warning for watch in non-Send futures ([#&#8203;4741])
-   chore: fix typo ([#&#8203;4798])

##### Unstable

-   joinset: rename `join_one` to `join_next` ([#&#8203;4755])
-   rt: unhandled panic conf

</details>

---

### Configuration

📅 **Schedule**: Branch creation - "after 9pm,before 6am" in timezone
Europe/Zurich, Automerge - At any time (no schedule defined).

🚦 **Automerge**: Enabled.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the
rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about these
updates again.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR has been generated by [Mend
Renovate](https://www.mend.io/free-developer-tools/renovate/). View
repository job log
[here](https://developer.mend.io/github/smartive/zitadel-rust).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNy4zMzEuMCIsInVwZGF0ZWRJblZlciI6IjM3LjMzMS4wIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6WyJkZXBlbmRlbmNpZXMiXX0=-->

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-tokio Area: The main tokio crate M-signal Module: tokio/signal T-docs Topic: documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants