mirror of
https://github.com/tokio-rs/tokio.git
synced 2026-08-15 00:00:15 +02:00
Carl Lerche
08e20fcf6a
Provides a thread pool dedicated to running blocking operations (#588) and update `tokio-fs` to use this pool. In an effort to make incremental progress, this is an initial step towards a final solution. First, it provides a very basic pool implementation with the intend that the pool will be replaced before the final release. Second, it updates `tokio-fs` to always use this blocking pool instead of conditionally using `threadpool::blocking`. Issue #588 contains additional discussion around potential improvements to the "blocking for all" strategy. The implementation provided here builds on work started in #954 and continued in #1045. The general idea is th same as #1045, but the PR improves on some of the details: * The number of explicit operations tracked by `File` is reduced only to the ones that could interact. All other ops are spawned on the blocking pool without being tracked by the `File` instance. * The `seek` implementation is not backed by a trait and `poll_seek` function. This avoids the question of how to model non-blocking seeks on top of a blocking file. In this patch, `seek` is represented as an `async fn`. If the associated future is dropped before the caller observes the return value, we make no effort to define the state in which the file ends up.
55 lines
1.3 KiB
Rust
55 lines
1.3 KiB
Rust
use crate::blocking::Blocking;
|
|
|
|
use tokio_io::AsyncWrite;
|
|
|
|
use std::io;
|
|
use std::pin::Pin;
|
|
use std::task::Context;
|
|
use std::task::Poll;
|
|
|
|
/// A handle to the standard output stream of a process.
|
|
///
|
|
/// The handle implements the [`AsyncWrite`] trait, but beware that concurrent
|
|
/// writes to `Stdout` must be executed with care.
|
|
///
|
|
/// Created by the [`stdout`] function.
|
|
///
|
|
/// [`stdout`]: fn.stdout.html
|
|
/// [`AsyncWrite`]: trait.AsyncWrite.html
|
|
#[derive(Debug)]
|
|
pub struct Stdout {
|
|
std: Blocking<std::io::Stdout>,
|
|
}
|
|
|
|
/// Constructs a new handle to the standard output of the current process.
|
|
///
|
|
/// The returned handle allows writing to standard out from the within the Tokio
|
|
/// runtime.
|
|
pub fn stdout() -> Stdout {
|
|
let std = io::stdout();
|
|
Stdout {
|
|
std: Blocking::new(std),
|
|
}
|
|
}
|
|
|
|
impl AsyncWrite for Stdout {
|
|
fn poll_write(
|
|
mut self: Pin<&mut Self>,
|
|
cx: &mut Context<'_>,
|
|
buf: &[u8],
|
|
) -> Poll<io::Result<usize>> {
|
|
Pin::new(&mut self.std).poll_write(cx, buf)
|
|
}
|
|
|
|
fn poll_flush(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Result<(), io::Error>> {
|
|
Pin::new(&mut self.std).poll_flush(cx)
|
|
}
|
|
|
|
fn poll_shutdown(
|
|
mut self: Pin<&mut Self>,
|
|
cx: &mut Context<'_>,
|
|
) -> Poll<Result<(), io::Error>> {
|
|
Pin::new(&mut self.std).poll_shutdown(cx)
|
|
}
|
|
}
|