1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
use crate::{IntoSplit, RawTransport, RawTransportRead, RawTransportWrite};
use std::{
ffi::{OsStr, OsString},
fmt, io,
pin::Pin,
task::{Context, Poll},
time::Duration,
};
use tokio::{
io::{AsyncRead, AsyncWrite, ReadBuf, ReadHalf, WriteHalf},
net::windows::named_pipe::ClientOptions,
};
const ERROR_PIPE_BUSY: u32 = 231;
const BUSY_PIPE_SLEEP_MILLIS: u64 = 50;
mod pipe;
pub use pipe::NamedPipe;
pub struct WindowsPipeTransport {
pub(crate) addr: OsString,
pub(crate) inner: NamedPipe,
}
impl WindowsPipeTransport {
pub async fn connect_local(name: impl AsRef<OsStr>) -> io::Result<Self> {
let mut addr = OsString::from(r"\\.\pipe\");
addr.push(name.as_ref());
Self::connect(addr).await
}
pub async fn connect(addr: impl Into<OsString>) -> io::Result<Self> {
let addr = addr.into();
let pipe = loop {
match ClientOptions::new().open(&addr) {
Ok(client) => break client,
Err(e) if e.raw_os_error() == Some(ERROR_PIPE_BUSY as i32) => (),
Err(e) => return Err(e),
}
tokio::time::sleep(Duration::from_millis(BUSY_PIPE_SLEEP_MILLIS)).await;
};
Ok(Self {
addr,
inner: NamedPipe::from(pipe),
})
}
pub fn addr(&self) -> &OsStr {
&self.addr
}
}
impl fmt::Debug for WindowsPipeTransport {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
f.debug_struct("WindowsPipeTransport")
.field("addr", &self.addr)
.finish()
}
}
impl RawTransport for WindowsPipeTransport {}
impl RawTransportRead for WindowsPipeTransport {}
impl RawTransportWrite for WindowsPipeTransport {}
impl RawTransportRead for ReadHalf<WindowsPipeTransport> {}
impl RawTransportWrite for WriteHalf<WindowsPipeTransport> {}
impl IntoSplit for WindowsPipeTransport {
type Read = ReadHalf<WindowsPipeTransport>;
type Write = WriteHalf<WindowsPipeTransport>;
fn into_split(self) -> (Self::Write, Self::Read) {
let (reader, writer) = tokio::io::split(self);
(writer, reader)
}
}
impl AsyncRead for WindowsPipeTransport {
fn poll_read(
mut self: Pin<&mut Self>,
cx: &mut Context<'_>,
buf: &mut ReadBuf<'_>,
) -> Poll<io::Result<()>> {
Pin::new(&mut self.inner).poll_read(cx, buf)
}
}
impl AsyncWrite for WindowsPipeTransport {
fn poll_write(
mut self: Pin<&mut Self>,
cx: &mut Context<'_>,
buf: &[u8],
) -> Poll<Result<usize, io::Error>> {
Pin::new(&mut self.inner).poll_write(cx, buf)
}
fn poll_flush(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Result<(), io::Error>> {
Pin::new(&mut self.inner).poll_flush(cx)
}
fn poll_shutdown(
mut self: Pin<&mut Self>,
cx: &mut Context<'_>,
) -> Poll<Result<(), io::Error>> {
Pin::new(&mut self.inner).poll_shutdown(cx)
}
}
#[cfg(test)]
mod tests {
use super::*;
use tokio::{
io::{AsyncReadExt, AsyncWriteExt},
net::windows::named_pipe::ServerOptions,
sync::oneshot,
task::JoinHandle,
};
#[tokio::test]
async fn should_fail_to_connect_if_pipe_does_not_exist() {
let name = format!("test_pipe_{}", rand::random::<usize>());
WindowsPipeTransport::connect_local(&name)
.await
.expect_err("Unexpectedly succeeded in connecting to missing pipe");
}
#[tokio::test]
async fn should_be_able_to_send_and_receive_data() {
let (tx, rx) = oneshot::channel();
let task: JoinHandle<io::Result<()>> = tokio::spawn(async move {
let addr = format!(r"\\.\pipe\test_pipe_{}", rand::random::<usize>());
let pipe = ServerOptions::new()
.first_pipe_instance(true)
.create(&addr)?;
tx.send(addr)
.map_err(|x| io::Error::new(io::ErrorKind::Other, x))?;
let mut conn = {
pipe.connect().await?;
pipe
};
conn.write_all(b"hello conn").await?;
let mut buf: [u8; 12] = [0; 12];
let _ = conn.read_exact(&mut buf).await?;
assert_eq!(&buf, b"hello server");
Ok(())
});
let address = rx.await.expect("Failed to get server address");
let mut buf: [u8; 10] = [0; 10];
let mut conn = WindowsPipeTransport::connect(&address)
.await
.expect("Conn failed to connect");
conn.read_exact(&mut buf)
.await
.expect("Conn failed to read");
assert_eq!(&buf, b"hello conn");
conn.write_all(b"hello server")
.await
.expect("Conn failed to write");
let _ = task.await.expect("Server task failed unexpectedly");
}
}