use super::copy::CopyBuffer; use crate::io::{AsyncRead, AsyncWrite}; use std::future::Future; use std::io; use std::pin::Pin; use std::task::{Context, Poll}; enum TransferState { Running(CopyBuffer), ShuttingDown(u64), Done(u64), } struct CopyBidirectional<'a, A: ?Sized, B: ?Sized> { a: &'a mut A, b: &'a mut B, a_to_b: TransferState, b_to_a: TransferState, } fn transfer_one_direction( cx: &mut Context<'_>, state: &mut TransferState, r: &mut A, w: &mut B, ) -> Poll> where A: AsyncRead + AsyncWrite + Unpin + ?Sized, B: AsyncRead + AsyncWrite + Unpin + ?Sized, { let mut r = Pin::new(r); let mut w = Pin::new(w); loop { match state { TransferState::Running(buf) => { let count = ready!(buf.poll_copy(cx, r.as_mut(), w.as_mut()))?; *state = TransferState::ShuttingDown(count); } TransferState::ShuttingDown(count) => { ready!(w.as_mut().poll_shutdown(cx))?; *state = TransferState::Done(*count); } TransferState::Done(count) => return Poll::Ready(Ok(*count)), } } } impl<'a, A, B> Future for CopyBidirectional<'a, A, B> where A: AsyncRead + AsyncWrite + Unpin + ?Sized, B: AsyncRead + AsyncWrite + Unpin + ?Sized, { type Output = io::Result<(u64, u64)>; fn poll(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll { // Unpack self into mut refs to each field to avoid borrow check issues. let CopyBidirectional { a, b, a_to_b, b_to_a, } = &mut *self; let a_to_b = transfer_one_direction(cx, a_to_b, &mut *a, &mut *b)?; let b_to_a = transfer_one_direction(cx, b_to_a, &mut *b, &mut *a)?; // It is not a problem if ready! returns early because transfer_one_direction for the // other direction will keep returning TransferState::Done(count) in future calls to poll let a_to_b = ready!(a_to_b); let b_to_a = ready!(b_to_a); Poll::Ready(Ok((a_to_b, b_to_a))) } } /// Copies data in both directions between `a` and `b`. /// /// This function returns a future that will read from both streams, /// writing any data read to the opposing stream. /// This happens in both directions concurrently. /// /// If an EOF is observed on one stream, [`shutdown()`] will be invoked on /// the other, and reading from that stream will stop. Copying of data in /// the other direction will continue. /// /// The future will complete successfully once both directions of communication has been shut down. /// A direction is shut down when the reader reports EOF, /// at which point [`shutdown()`] is called on the corresponding writer. When finished, /// it will return a tuple of the number of bytes copied from a to b /// and the number of bytes copied from b to a, in that order. /// /// [`shutdown()`]: crate::io::AsyncWriteExt::shutdown /// /// # Errors /// /// The future will immediately return an error if any IO operation on `a` /// or `b` returns an error. Some data read from either stream may be lost (not /// written to the other stream) in this case. /// /// # Return value /// /// Returns a tuple of bytes copied `a` to `b` and bytes copied `b` to `a`. #[cfg_attr(docsrs, doc(cfg(feature = "io-util")))] pub async fn copy_bidirectional(a: &mut A, b: &mut B) -> Result<(u64, u64), std::io::Error> where A: AsyncRead + AsyncWrite + Unpin + ?Sized, B: AsyncRead + AsyncWrite + Unpin + ?Sized, { CopyBidirectional { a, b, a_to_b: TransferState::Running(CopyBuffer::new()), b_to_a: TransferState::Running(CopyBuffer::new()), } .await }