pub struct AcknowledgementStateConfig {
pub mode: AcknowledgementMode,
pub expected_packet_latency: Duration,
pub backoff_base: f64,
pub max_incoming_frame_retries: usize,
pub max_outgoing_frame_retries: usize,
pub acknowledgement_delay: Duration,
pub lookbehind_segments: usize,
pub max_frame_age: Option<Duration>,
pub min_frame_retransmission_interval: Option<Duration>,
pub max_frame_retransmission_services: usize,
pub max_frame_retransmission_burst: usize,
pub frame_retransmission_refill_interval: Option<Duration>,
}Expand description
Configuration object of the AcknowledgementState.
Fields§
§mode: AcknowledgementModeMode of frame acknowledgement.
Default is AcknowledgementMode::Both
expected_packet_latency: DurationThe expected (average) latency of a packet (= single frame segment).
Default is 20 ms
backoff_base: f64Backoff base applied for segment or frame retransmissions.
Default is 1.2
max_incoming_frame_retries: usizeThe maximum number of receiver-driven segment retransmission requests.
Default is 3
max_outgoing_frame_retries: usizeThe maximum number of sender-driven full-frame retransmissions.
Default is 3
acknowledgement_delay: DurationDelay between acknowledgement batches.
Default is 50 ms
lookbehind_segments: usizeNumber of segments to hold back for retransmission upon other party’s request. Minimum is 1024.
Default is 16 384.
max_frame_age: Option<Duration>Maximum age of an outgoing frame before it is retired as lost instead of retransmitted.
Bounds how stale data on the wire may be after a stall, and feeds the retirement to the honest delivery clock so flow control sees the stall as loss.
None (default) bounds frames only by Self::max_outgoing_frame_retries and backoff.
min_frame_retransmission_interval: Option<Duration>Minimum interval between two peer-driven retransmission services of the same frame.
Bounds the egress (and SURB/ticket) cost a single peer can induce by replaying
segment retransmission requests. Deliberately HALF the RTO base
(Self::expected_packet_latency): an honest peer’s requests for the same frame arrive
RTO + jitter apart, so an interval equal to the RTO could marginally throttle it.
None (default) or ZERO derives expected_packet_latency / 2, so the bound cannot be
disabled by accident. Internal defaults only; not operator-visible.
max_frame_retransmission_services: usizeMaximum number of times a single frame may be served on a peer’s request.
0 (default) derives
max_incoming_frame_retries.max(1) * SegmentRequest::<C>::MAX_MISSING_SEGMENTS_PER_FRAME,
i.e. an 8x margin over the at most max_incoming_frame_retries requests the receiver
itself could ever have issued for the same frame.
Internal defaults only; not operator-visible.
max_frame_retransmission_burst: usizeMaximum number of frames served across a Self::frame_retransmission_refill_interval.
Caps the total amplification one peer’s request stream can induce, regardless of how many
distinct frames it names. 0 (default) derives 2 * SegmentRequest::<C>::MAX_ENTRIES
(a full request is worth at most MAX_ENTRIES frames).
Internal defaults only; not operator-visible.
frame_retransmission_refill_interval: Option<Duration>Interval over which the Self::max_frame_retransmission_burst allowance refills.
None (default) derives expected_packet_latency. Internal defaults only; not
operator-visible.
Implementations§
Source§impl AcknowledgementStateConfig
impl AcknowledgementStateConfig
fn normalize<const C: usize>(self) -> AcknowledgementStateConfig
Trait Implementations§
Source§impl Clone for AcknowledgementStateConfig
impl Clone for AcknowledgementStateConfig
Source§fn clone(&self) -> AcknowledgementStateConfig
fn clone(&self) -> AcknowledgementStateConfig
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreimpl Copy for AcknowledgementStateConfig
Source§impl Debug for AcknowledgementStateConfig
impl Debug for AcknowledgementStateConfig
Source§impl Default for AcknowledgementStateConfig
impl Default for AcknowledgementStateConfig
Source§fn default() -> Self
fn default() -> Self
Return AcknowledgementStateConfig { mode: Default::default(), expected_packet_latency: Duration::from_millis(20), backoff_base: 1.2, max_incoming_frame_retries: 3, max_outgoing_frame_retries: 3, acknowledgement_delay: Duration::from_millis(50), lookbehind_segments: 16384, max_frame_age: None, min_frame_retransmission_interval: None, max_frame_retransmission_services: 0, max_frame_retransmission_burst: 0, frame_retransmission_refill_interval: None }
impl StructuralPartialEq for AcknowledgementStateConfig
Auto Trait Implementations§
impl Freeze for AcknowledgementStateConfig
impl RefUnwindSafe for AcknowledgementStateConfig
impl Send for AcknowledgementStateConfig
impl Sync for AcknowledgementStateConfig
impl Unpin for AcknowledgementStateConfig
impl UnsafeUnpin for AcknowledgementStateConfig
impl UnwindSafe for AcknowledgementStateConfig
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> Conv for T
impl<T> Conv for T
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self to use its Binary implementation when Debug-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self to use its Display implementation when
Debug-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self to use its LowerExp implementation when
Debug-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self to use its LowerHex implementation when
Debug-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self to use its Octal implementation when Debug-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self to use its Pointer implementation when
Debug-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self to use its UpperExp implementation when
Debug-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self to use its UpperHex implementation when
Debug-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
§impl<T> FutureExt for T
impl<T> FutureExt for T
§fn with_context(self, otel_cx: Context) -> WithContext<Self>
fn with_context(self, otel_cx: Context) -> WithContext<Self>
§fn with_current_context(self) -> WithContext<Self>
fn with_current_context(self) -> WithContext<Self>
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self, then passes self.as_ref() into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self, then passes self.as_mut() into the pipe
function.§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self, then passes self.deref() into the pipe function.§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> Read<Exclusive, BecauseExclusive> for Twhere
T: ?Sized,
§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B> of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B> of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R> view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R> view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap() only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut() only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow() only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut() only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref() only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut() only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref() only in debug builds, and is erased in release
builds.