pub struct IncomingPacketInfo {
pub signals_from_sender: PacketSignals,
pub num_saved_surbs: usize,
pub num_evicted_surbs: usize,
pub min_return_path_hops: Option<u8>,
}Expand description
Holds packet transient information when ApplicationData is passed from the HOPR protocol layer to the
Application layer.
The HOPR protocol layer typically takes care of properly populating this structure as the packet arrives.
Fields§
§signals_from_sender: PacketSignalsPacket signals that were passed by the sender.
num_saved_surbs: usizeThe number of SURBs the HOPR packet was carrying along with the ApplicationData instance.
num_evicted_surbs: usizeHow many SURBs were lost on arrival: discarded because the SURB buffer for this sender was already full, or taken out of play by a change of the sender’s SURB generation (the stock a newer generation wiped, or a late batch of an older one that was refused).
Non-zero from a full buffer means the sender is producing SURBs faster than this side can hold
them, and the surplus was destroyed rather than queued; the generation part is the sender
re-planning its return paths, which is no over-production. Under PIX a destroyed share-bearing SURB also
destroys the partial SSA share it carried, since a share only reaches the reconstructor when its SURB is
used. The store gives up share-less SURBs first, so the count is an upper bound on the shares
lost; the exact number is the store’s own, reported in its eviction summary (the ring_share
value of the cache label of hopr_surb_store_evictions_count). This is not a bandwidth
statistic but a loss counter.
The Exit’s session counts these toward its SURB flow estimate — an evicted SURB has left the
buffer just as a spent one has — so the level it reports tracks what the store actually holds.
See hopr-transport-session’s BalancerStateValues::counterparty_buffer_capacity.
min_return_path_hops: Option<u8>Fewest intermediate hops on the return path of any SURB the HOPR packet was carrying, or
None if it carried none.
Declared by the SURB creator, not verified. Some(0) means a direct return path, which has no
first relayer to acknowledge a reply and so cannot deliver PIX shares.
Trait Implementations§
Source§impl Clone for IncomingPacketInfo
impl Clone for IncomingPacketInfo
Source§fn clone(&self) -> IncomingPacketInfo
fn clone(&self) -> IncomingPacketInfo
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 IncomingPacketInfo
Source§impl Debug for IncomingPacketInfo
impl Debug for IncomingPacketInfo
Source§impl Default for IncomingPacketInfo
impl Default for IncomingPacketInfo
Source§fn default() -> IncomingPacketInfo
fn default() -> IncomingPacketInfo
impl Eq for IncomingPacketInfo
Source§impl PartialEq for IncomingPacketInfo
impl PartialEq for IncomingPacketInfo
impl StructuralPartialEq for IncomingPacketInfo
Auto Trait Implementations§
impl Freeze for IncomingPacketInfo
impl RefUnwindSafe for IncomingPacketInfo
impl Send for IncomingPacketInfo
impl Sync for IncomingPacketInfo
impl Unpin for IncomingPacketInfo
impl UnsafeUnpin for IncomingPacketInfo
impl UnwindSafe for IncomingPacketInfo
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<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key and return true if they are equal.§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
§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