1use std::collections::VecDeque;
4use std::fmt;
5use std::fs::File;
6use std::sync::Arc;
7use std::sync::atomic::{AtomicU64, Ordering};
8use std::time::{Duration, Instant};
9
10use crate::buf::{Buffer, BufferPool};
11use crate::completer::Completer;
12use crate::error::{CloseReason, LimitKind, NetError, RefusalCause, TimeoutKind};
13use crate::gate::KillHandle;
14use crate::id::WorkerId;
15use crate::info::{ConnectionInfo, GateTag};
16use crate::limits::SizeClass;
17use crate::link::Link;
18
19pub trait Session: Send + 'static {
46 fn on_open(&mut self, cx: &mut SessionContext<'_>) -> Step {
48 let _ = cx;
49 Step::Read
50 }
51
52 fn on_data(&mut self, cx: &mut SessionContext<'_>, input: &mut Input) -> Step;
54
55 fn on_writable(&mut self, cx: &mut SessionContext<'_>) -> Step {
57 let _ = cx;
58 Step::Read
59 }
60
61 fn on_wake(&mut self, cx: &mut SessionContext<'_>, token: u32, value: u64) -> Step {
63 let _ = (cx, token, value);
64 Step::Abort
65 }
66
67 fn on_timeout(&mut self, cx: &mut SessionContext<'_>, which: TimeoutKind) -> Step {
70 let _ = (cx, which);
71 Step::Close
72 }
73
74 fn on_peer_closed(&mut self, cx: &mut SessionContext<'_>) -> Step {
76 let _ = cx;
77 Step::Close
78 }
79
80 fn on_denied(&mut self, code: u16, output: &mut Output) {
83 let _ = (code, output);
84 }
85
86 fn on_close(&mut self, info: &ConnectionInfo, reason: CloseReason) {
88 let _ = (info, reason);
89 }
90}
91
92pub trait SessionFactory: Send + Sync + 'static {
123 type Session: Session;
125
126 fn open(&self, info: &ConnectionInfo) -> Result<Self::Session, RefusalCause>;
132}
133
134impl<F, S> SessionFactory for F
135where
136 F: Fn(&ConnectionInfo) -> S + Send + Sync + 'static,
137 S: Session,
138{
139 type Session = S;
140 fn open(&self, info: &ConnectionInfo) -> Result<S, RefusalCause> {
141 Ok(self(info))
142 }
143}
144
145#[non_exhaustive]
151#[derive(Clone, Copy, Debug, PartialEq, Eq)]
152pub enum Step {
153 Read,
156 Write,
158 Park {
160 until: Option<Instant>,
162 },
163 Close,
165 Abort,
167}
168
169#[derive(Clone, Copy, Debug, PartialEq, Eq, Default)]
175pub enum Phase {
176 #[default]
178 Idle,
179 Receiving,
181 Sending,
183}
184
185#[non_exhaustive]
191#[derive(Clone, Copy, Debug, PartialEq, Eq)]
192pub enum SwapError {
193 ClassMismatch,
195 NotEmpty,
197 Busy,
199}
200
201impl fmt::Display for SwapError {
202 fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
203 f.write_str(match self {
204 SwapError::ClassMismatch => "the buffers are of different size classes",
205 SwapError::NotEmpty => "the incoming buffer is not empty",
206 SwapError::Busy => "a driver operation holds the buffer",
207 })
208 }
209}
210
211impl std::error::Error for SwapError {}
212
213#[derive(Debug)]
222pub struct Input {
223 pub(crate) buf: Buffer,
224 pub(crate) start: usize,
225 pub(crate) changed: bool,
226 lent: bool,
229}
230
231impl Input {
232 pub(crate) fn new(buf: Buffer) -> Input {
233 Input {
234 buf,
235 lent: false,
236 start: 0,
237 changed: false,
238 }
239 }
240
241 #[must_use]
243 pub fn from_bytes(bytes: &[u8]) -> Input {
244 let class = (bytes.len() as u32)
245 .max(1024)
246 .next_power_of_two()
247 .max(SizeClass::SMALL.bytes());
248 let class = SizeClass::new(class.min(1 << 20)).unwrap_or(SizeClass::LARGE);
249 let mut pool = BufferPool::standalone(u64::from(class.bytes()));
250 let mut input = Input::new(match pool.take(class) {
251 Some(b) => b,
252 None => return Input::new(Buffer::detached(class)),
253 });
254 let n = bytes.len().min(input.buf.capacity());
255 input.buf.spare()[..n].copy_from_slice(&bytes[..n]);
256 input.buf.set_len(n);
257 input
258 }
259
260 #[must_use]
262 pub fn bytes(&self) -> &[u8] {
263 self.buf.as_slice().get(self.start..).unwrap_or(&[])
264 }
265
266 pub fn consume(&mut self, n: usize) {
268 let n = n.min(self.buf.len() - self.start);
269 self.start += n;
270 if n > 0 {
271 self.changed = true;
272 }
273 if self.start == self.buf.len() {
274 self.buf.clear();
275 self.start = 0;
276 }
277 }
278
279 #[must_use]
281 pub fn is_full(&self) -> bool {
282 !self.lent && self.buf.len() == self.buf.capacity() && self.start == 0
283 }
284
285 #[must_use]
287 pub fn class(&self) -> SizeClass {
288 self.buf.class()
289 }
290
291 pub fn swap(&mut self, other: &mut Buffer) -> Result<(), SwapError> {
309 if other.class() != self.buf.class() {
310 return Err(SwapError::ClassMismatch);
311 }
312 if !other.is_empty() {
313 return Err(SwapError::NotEmpty);
314 }
315 if self.start > 0 {
316 self.buf.compact(self.start);
317 self.start = 0;
318 }
319 std::mem::swap(&mut self.buf, other);
320 self.changed = true;
321 Ok(())
322 }
323
324 pub(crate) fn spare_for_read(&mut self) -> &mut [u8] {
326 let free = self.buf.capacity() - self.buf.len();
327 if self.start > 0 && free < self.buf.capacity() / 4 {
328 self.buf.compact(self.start);
329 self.start = 0;
330 }
331 self.buf.spare()
332 }
333
334 #[cfg(feature = "reactor")]
337 pub(crate) fn lend(&mut self) -> Buffer {
338 let _ = self.spare_for_read();
339 self.lent = true;
340 std::mem::replace(&mut self.buf, Buffer::placeholder())
341 }
342
343 #[cfg(feature = "reactor")]
345 pub(crate) fn give_back(&mut self, buf: Buffer) {
346 self.buf = buf;
347 self.lent = false;
348 }
349
350 #[cfg(feature = "reactor")]
352 pub(crate) fn lent(&self) -> bool {
353 self.lent
354 }
355
356 pub(crate) fn filled(&mut self, n: usize) {
357 let len = self.buf.len() + n;
358 self.buf.set_len(len);
359 self.changed = true;
360 }
361}
362
363#[derive(Clone, Copy, Debug, PartialEq, Eq)]
369pub struct OutputFull;
370
371impl fmt::Display for OutputFull {
372 fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
373 f.write_str("the connection's output budget is full")
374 }
375}
376
377impl std::error::Error for OutputFull {}
378
379#[derive(Debug)]
380pub(crate) enum Chunk {
381 Pooled(Buffer, usize),
382 Static(&'static [u8], usize),
383 File {
385 file: Arc<File>,
386 offset: u64,
387 left: u64,
388 },
389}
390
391impl Chunk {
392 pub(crate) fn remaining(&self) -> &[u8] {
394 match self {
395 Chunk::Pooled(b, off) => &b.as_slice()[*off..],
396 Chunk::Static(s, off) => &s[*off..],
397 Chunk::File { .. } => &[],
398 }
399 }
400
401 pub(crate) fn len(&self) -> usize {
403 match self {
404 Chunk::File { left, .. } => usize::try_from(*left).unwrap_or(usize::MAX),
405 other => other.remaining().len(),
406 }
407 }
408
409 pub(crate) fn is_file(&self) -> bool {
410 matches!(self, Chunk::File { .. })
411 }
412
413 pub(crate) fn advance(&mut self, n: usize) {
415 match self {
416 Chunk::Pooled(_, off) | Chunk::Static(_, off) => *off += n,
417 Chunk::File { offset, left, .. } => {
418 *offset += n as u64;
419 *left -= n as u64;
420 }
421 }
422 }
423}
424
425#[derive(Debug)]
434pub struct Output {
435 pub(crate) chunks: VecDeque<Chunk>,
436 free: Vec<Buffer>,
437 budget: Arc<AtomicU64>,
438 limit: u32,
439 used: u32,
440 wipe: bool,
441 refused: bool,
443 pub(crate) response_open: bool,
444 pub(crate) response_tag: Option<GateTag>,
445 pub(crate) bytes_since_begin: u64,
446}
447
448const OUTPUT_CLASS: SizeClass = SizeClass::MEDIUM;
449const MAX_CHUNKS: usize = 64;
450const FREE_MAX: usize = 4;
452
453impl Output {
454 pub(crate) fn new(budget: Arc<AtomicU64>, limit: u32, wipe: bool) -> Output {
455 Output {
456 chunks: VecDeque::with_capacity(MAX_CHUNKS),
457 free: Vec::new(),
458 budget,
459 limit,
460 used: 0,
461 wipe,
462 refused: false,
463 response_open: false,
464 response_tag: None,
465 bytes_since_begin: 0,
466 }
467 }
468
469 #[must_use]
471 pub fn standalone(limit: u32) -> Output {
472 Output::new(Arc::new(AtomicU64::new(u64::from(limit))), limit, true)
473 }
474
475 fn take_buffer(&mut self) -> Option<Buffer> {
476 if let Some(b) = self.free.pop() {
477 return Some(b);
478 }
479 let bytes = u64::from(OUTPUT_CLASS.bytes());
480 let mut left = self.budget.load(Ordering::Relaxed);
481 loop {
482 if left < bytes {
483 self.refused = true;
484 return None;
485 }
486 match self.budget.compare_exchange_weak(
487 left,
488 left - bytes,
489 Ordering::AcqRel,
490 Ordering::Relaxed,
491 ) {
492 Ok(_) => return Some(Buffer::detached(OUTPUT_CLASS)),
493 Err(actual) => left = actual,
494 }
495 }
496 }
497
498 pub(crate) fn refill(&mut self, pool: &mut BufferPool) {
503 while self.free.len() < FREE_MAX {
504 match pool.take_cached(OUTPUT_CLASS) {
505 Some(b) => self.free.push(b),
506 None => return,
507 }
508 }
509 }
510
511 pub(crate) fn take_refused(&mut self) -> bool {
514 std::mem::take(&mut self.refused)
515 }
516
517 fn room(&self) -> usize {
518 let tail = match self.chunks.back() {
519 Some(Chunk::Pooled(b, _)) => b.capacity() - b.len(),
520 _ => 0,
521 };
522 let more = (self.limit.saturating_sub(self.used) / OUTPUT_CLASS.bytes()) as usize
523 * OUTPUT_CLASS.bytes() as usize;
524 tail + more
525 }
526
527 pub fn push_partial(&mut self, mut bytes: &[u8]) -> usize {
529 let mut taken = 0;
530 while !bytes.is_empty() {
531 if let Some(Chunk::Pooled(b, _)) = self.chunks.back_mut() {
532 let spare = b.spare();
533 if !spare.is_empty() {
534 let n = spare.len().min(bytes.len());
535 spare[..n].copy_from_slice(&bytes[..n]);
536 let len = b.len() + n;
537 b.set_len(len);
538 bytes = &bytes[n..];
539 taken += n;
540 continue;
541 }
542 }
543 if self.chunks.len() >= MAX_CHUNKS
544 || self.used.saturating_add(OUTPUT_CLASS.bytes()) > self.limit
545 {
546 break;
547 }
548 match self.take_buffer() {
549 Some(b) => {
550 self.used += OUTPUT_CLASS.bytes();
551 self.chunks.push_back(Chunk::Pooled(b, 0));
552 }
553 None => break,
554 }
555 }
556 taken
557 }
558
559 pub fn push(&mut self, bytes: &[u8]) -> Result<(), OutputFull> {
565 if bytes.len() > self.room() {
566 return Err(OutputFull);
567 }
568 let n = self.push_partial(bytes);
569 if n == bytes.len() {
570 Ok(())
571 } else {
572 Err(OutputFull)
573 }
574 }
575
576 pub fn push_buffer(&mut self, buffer: Buffer) -> Result<(), OutputFull> {
582 let size = u32::try_from(buffer.capacity()).unwrap_or(u32::MAX);
583 if self.chunks.len() >= MAX_CHUNKS || self.used.saturating_add(size) > self.limit {
584 return Err(OutputFull);
585 }
586 self.used += size;
587 self.chunks.push_back(Chunk::Pooled(buffer, 0));
588 Ok(())
589 }
590
591 pub fn push_static(&mut self, bytes: &'static [u8]) -> Result<(), OutputFull> {
597 if self.chunks.len() >= MAX_CHUNKS {
598 return Err(OutputFull);
599 }
600 if !bytes.is_empty() {
601 self.chunks.push_back(Chunk::Static(bytes, 0));
602 }
603 Ok(())
604 }
605
606 pub fn push_file(&mut self, file: Arc<File>, offset: u64, len: u64) -> Result<(), OutputFull> {
616 if self.chunks.len() >= MAX_CHUNKS {
617 return Err(OutputFull);
618 }
619 if len > 0 {
620 self.chunks.push_back(Chunk::File {
621 file,
622 offset,
623 left: len,
624 });
625 }
626 Ok(())
627 }
628
629 pub(crate) fn front_file(&self) -> Option<(Arc<File>, u64, u64)> {
631 match self.chunks.front() {
632 Some(Chunk::File { file, offset, left }) => Some((file.clone(), *offset, *left)),
633 _ => None,
634 }
635 }
636
637 #[cfg(feature = "reactor")]
640 pub(crate) fn pull_file(&mut self) -> Result<(), crate::error::CloseReason> {
641 use crate::error::{CloseReason, LimitKind, OsErrorClass};
642 let Some((file, offset, left)) = self.front_file() else {
643 return Ok(());
644 };
645 let Some(mut b) = self.take_buffer() else {
646 return Err(CloseReason::Limit(LimitKind::BufferBudget));
647 };
648 let spare = b.spare();
649 let take = usize::try_from(left).unwrap_or(usize::MAX).min(spare.len());
650 let read = crate::sys::read_file_at(&file, &mut spare[..take], offset);
651 let n = match read {
652 Ok(0) => {
653 self.release_chunk(b);
654 return Err(CloseReason::Io(OsErrorClass::FileTruncated));
655 }
656 Ok(n) => n,
657 Err(e) => {
658 self.release_chunk(b);
659 return Err(CloseReason::Io(OsErrorClass::from_io(&e)));
660 }
661 };
662 b.set_len(n);
663 self.used += OUTPUT_CLASS.bytes();
664 if let Some(front) = self.chunks.front_mut() {
665 front.advance(n);
666 if front.len() == 0 {
667 self.chunks.pop_front();
668 }
669 }
670 self.chunks.push_front(Chunk::Pooled(b, 0));
671 Ok(())
672 }
673
674 pub fn begin_response(&mut self) {
676 self.response_open = true;
677 self.response_tag = None;
678 self.bytes_since_begin = 0;
679 }
680
681 pub fn begin_tagged_response(&mut self, tag: GateTag) {
683 self.begin_response();
684 self.response_tag = Some(tag);
685 }
686
687 pub fn end_response(&mut self) {
689 self.response_open = false;
690 self.response_tag = None;
691 }
692
693 #[must_use]
695 pub fn pending(&self) -> usize {
696 self.chunks.iter().map(Chunk::len).sum()
697 }
698
699 #[must_use]
701 pub fn is_empty(&self) -> bool {
702 self.chunks.is_empty()
703 }
704
705 pub fn wipe_all(&mut self) {
707 while let Some(chunk) = self.chunks.pop_front() {
708 if let Chunk::Pooled(mut b, _) = chunk {
709 b.wipe();
710 self.release_chunk(b);
711 }
712 }
713 self.used = 0;
714 }
715
716 fn release_chunk(&mut self, mut b: Buffer) {
717 self.used = self
718 .used
719 .saturating_sub(u32::try_from(b.capacity()).unwrap_or(u32::MAX));
720 if self.wipe {
721 b.wipe();
722 } else {
723 b.clear();
724 }
725 if b.class() == OUTPUT_CLASS && self.free.len() < FREE_MAX {
726 self.free.push(b);
727 } else {
728 self.budget
730 .fetch_add(b.capacity() as u64, Ordering::Release);
731 }
732 }
733
734 pub(crate) fn return_spares(&mut self, pool: &mut BufferPool) {
738 while self.free.len() > 1 {
739 if let Some(b) = self.free.pop() {
740 pool.put(b);
741 }
742 }
743 }
744
745 #[cfg(feature = "reactor")]
747 pub(crate) fn pending_in_send(&self) -> usize {
748 self.chunks
749 .iter()
750 .take(crate::sys::MAX_SLICES)
751 .take_while(|c| !c.is_file())
752 .map(Chunk::len)
753 .sum()
754 }
755
756 #[cfg(feature = "reactor")]
758 pub(crate) fn fill_slices<'a>(&'a self, out: &mut [std::io::IoSlice<'a>]) -> usize {
759 let mut n = 0;
760 for chunk in self
761 .chunks
762 .iter()
763 .take(out.len())
764 .take_while(|c| !c.is_file())
765 {
766 out[n] = std::io::IoSlice::new(chunk.remaining());
767 n += 1;
768 }
769 n
770 }
771
772 pub(crate) fn advance(&mut self, mut n: usize) {
774 while let Some(front) = self.chunks.front_mut() {
775 let rem = front.len();
776 if n < rem {
777 front.advance(n);
778 return;
779 }
780 n -= rem;
781 if let Some(Chunk::Pooled(b, _)) = self.chunks.pop_front() {
782 self.release_chunk(b);
783 }
784 }
785 }
786
787 pub(crate) fn reset(&mut self) {
789 self.wipe_all();
790 self.response_open = false;
791 self.response_tag = None;
792 self.bytes_since_begin = 0;
793 self.refused = false;
794 }
795}
796
797pub struct SessionContext<'a> {
799 pub(crate) link: &'a mut Link,
800 pub(crate) output: &'a mut Output,
801 pub(crate) pool: &'a mut BufferPool,
802 pub(crate) completer: &'a Completer,
803 pub(crate) draining: bool,
804 pub(crate) pressure: f32,
805 pub(crate) worker: WorkerId,
806 pub(crate) grow_to: Option<SizeClass>,
807}
808
809impl SessionContext<'_> {
810 #[must_use]
812 pub fn info(&self) -> &ConnectionInfo {
813 &self.link.info
814 }
815
816 pub fn output(&mut self) -> &mut Output {
818 if self.output.free.len() < FREE_MAX {
821 self.output.refill(self.pool);
822 }
823 self.output
824 }
825
826 #[must_use]
828 pub fn now(&self) -> Instant {
829 self.link.now()
830 }
831
832 pub fn set_phase(&mut self, phase: crate::session::Phase) {
834 self.link.set_phase(phase);
835 }
836
837 pub fn set_exchange_deadline(&mut self, at: Option<Instant>) {
839 self.link.set_exchange_deadline(at);
840 }
841
842 pub fn set_idle_timeout(&mut self, timeout: Option<Duration>) {
863 self.link.set_idle_timeout(timeout);
864 }
865
866 #[must_use]
868 pub fn draining(&self) -> bool {
869 self.draining
870 }
871
872 #[must_use]
874 pub fn pressure(&self) -> f32 {
875 self.pressure
876 }
877
878 #[must_use]
880 pub fn kill_handle(&self) -> KillHandle {
881 KillHandle {
882 slot: self.link.slot.clone(),
883 generation: self.link.generation,
884 id: self.link.info.id,
885 }
886 }
887
888 #[must_use]
892 pub fn completer(&self) -> Completer {
893 self.link.wakeable.set(true);
894 self.completer.clone()
895 }
896
897 #[must_use]
899 pub fn worker(&self) -> WorkerId {
900 self.worker
901 }
902
903 pub fn buffers(&mut self) -> &mut BufferPool {
905 self.pool
906 }
907
908 pub fn release(&mut self, buffer: Buffer) {
910 self.pool.put(buffer);
911 }
912
913 pub fn grow_input(&mut self, class: SizeClass) -> Result<(), NetError> {
919 if class > self.link.limits.read_class_max {
920 return Err(NetError::Limit {
921 which: LimitKind::ReadBuffer,
922 });
923 }
924 self.grow_to = Some(class);
925 Ok(())
926 }
927}
928
929impl fmt::Debug for SessionContext<'_> {
930 fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
931 f.debug_struct("SessionContext")
932 .field("id", &self.link.info.id)
933 .field("draining", &self.draining)
934 .finish()
935 }
936}
937
938#[cfg(test)]
939mod tests {
940 use super::*;
941
942 #[test]
943 fn test_input_consume_saturates_and_resets() {
944 let mut i = Input::from_bytes(b"abc");
945 i.consume(10);
946 assert!(i.bytes().is_empty());
947 assert_eq!(i.start, 0);
948 }
949
950 #[test]
951 fn test_input_swap_rules() {
952 let mut i = Input::from_bytes(b"xyz");
953 let mut pool = BufferPool::standalone(1 << 22);
954 let mut wrong = pool.take(SizeClass::LARGE).unwrap();
955 assert_eq!(i.swap(&mut wrong), Err(SwapError::ClassMismatch));
956 let mut full = pool.take(i.class()).unwrap();
957 full.set_len(1);
958 assert_eq!(i.swap(&mut full), Err(SwapError::NotEmpty));
959 let mut empty = pool.take(i.class()).unwrap();
960 i.consume(1);
961 i.swap(&mut empty).unwrap();
962 assert_eq!(empty.as_slice(), b"yz");
963 }
964
965 #[test]
966 fn test_output_push_all_or_nothing_and_partial() {
967 let mut o = Output::standalone(OUTPUT_CLASS.bytes());
968 let big = vec![7u8; OUTPUT_CLASS.bytes() as usize + 1];
969 assert_eq!(o.push(&big), Err(OutputFull));
970 assert!(o.is_empty());
971 assert_eq!(o.push_partial(&big), OUTPUT_CLASS.bytes() as usize);
972 assert_eq!(o.pending(), OUTPUT_CLASS.bytes() as usize);
973 }
974
975 #[test]
976 fn test_output_advance_releases_chunks() {
977 let mut o = Output::standalone(1 << 20);
978 o.push(b"hello").unwrap();
979 o.push_static(b" world").unwrap();
980 o.advance(7);
981 assert_eq!(o.pending(), 4);
982 assert_eq!(o.chunks.len(), 1);
983 assert_eq!(o.used, 0);
984 o.advance(4);
985 assert!(o.is_empty());
986 }
987
988 #[test]
989 fn test_output_response_markers() {
990 let mut o = Output::standalone(1 << 20);
991 o.begin_tagged_response(GateTag(3));
992 assert_eq!(o.response_tag, Some(GateTag(3)));
993 o.end_response();
994 assert_eq!(o.response_tag, None);
995 }
996
997 #[test]
1000 fn prop_output_stream_matches_accepted_pushes() {
1001 use crate::testing::Gen;
1002 static TEXT: [u8; 4096] = {
1003 let mut t = [0u8; 4096];
1004 let mut i = 0;
1005 while i < t.len() {
1006 t[i] = (i % 251) as u8;
1007 i += 1;
1008 }
1009 t
1010 };
1011 let mut g = Gen::new(0x0047_0041);
1012 for round in 0..if cfg!(miri) { 3 } else { 300 } {
1013 let mut o = Output::standalone(64 * 1024);
1014 let mut expected = Vec::new();
1015 let mut sent = Vec::new();
1016 for _ in 0..200 {
1017 match g.below(4) {
1018 0 => {
1019 let n = g.below(40_000) as usize;
1020 let data: Vec<u8> = (0..n).map(|_| g.next_u64() as u8).collect();
1021 let took = o.push_partial(&data);
1022 expected.extend_from_slice(&data[..took]);
1023 }
1024 1 => {
1025 let n = g.below(3000) as usize;
1026 let data: Vec<u8> = (0..n).map(|_| g.next_u64() as u8).collect();
1027 if o.push(&data).is_ok() {
1028 expected.extend_from_slice(&data);
1029 }
1030 }
1031 2 => {
1032 let start = g.below(TEXT.len() as u64) as usize;
1033 let piece = &TEXT[start..];
1034 if o.push_static(piece).is_ok() {
1035 expected.extend_from_slice(piece);
1036 }
1037 }
1038 _ => {
1039 let mut want = g.below(70_000) as usize;
1041 let mut taken = 0;
1042 for chunk in o.chunks.iter() {
1043 if want == 0 {
1044 break;
1045 }
1046 let r = chunk.remaining();
1047 let n = r.len().min(want);
1048 sent.extend_from_slice(&r[..n]);
1049 want -= n;
1050 taken += n;
1051 }
1052 o.advance(taken);
1053 }
1054 }
1055 }
1056 while !o.is_empty() {
1057 let n = o.chunks.front().map_or(0, |c| c.remaining().len());
1058 if let Some(c) = o.chunks.front() {
1059 sent.extend_from_slice(c.remaining());
1060 }
1061 o.advance(n);
1062 }
1063 assert!(sent == expected, "round {round}: stream differs");
1064 assert_eq!(o.used, 0, "round {round}: budget not returned");
1065 assert_eq!(o.pending(), 0);
1066 }
1067 }
1068}