Struct darkfi::net::hosts::HostContainer
source · pub struct HostContainer {
pub(super) hostlists: [RwLock<Vec<(Url, u64)>>; 5],
}
Expand description
A Container for managing Grey, White, Gold and Black hostlists. Exposes a common interface for writing to and querying hostlists.
Fields§
§hostlists: [RwLock<Vec<(Url, u64)>>; 5]
Implementations§
source§impl HostContainer
impl HostContainer
fn new() -> Self
sourcefn store(&self, color: usize, addr: Url, last_seen: u64)
fn store(&self, color: usize, addr: Url, last_seen: u64)
Append host to a hostlist. Called when initalizing the hostlist in load_hosts().
sourcefn store_or_update(&self, color: HostColor, addr: Url, last_seen: u64)
fn store_or_update(&self, color: HostColor, addr: Url, last_seen: u64)
Stores an address on a hostlist or updates its last_seen field if we already have the address.
sourcepub fn update_last_seen(&self, color: usize, addr: Url, last_seen: u64)
pub fn update_last_seen(&self, color: usize, addr: Url, last_seen: u64)
Update the last_seen field of a peer on a hostlist.
sourcepub fn fetch_all(&self, color: HostColor) -> Vec<(Url, u64)>
pub fn fetch_all(&self, color: HostColor) -> Vec<(Url, u64)>
Return all known hosts on a hostlist.
sourcepub fn fetch_last(&self, color: HostColor) -> Option<(Url, u64)>
pub fn fetch_last(&self, color: HostColor) -> Option<(Url, u64)>
Get the oldest entry from a hostlist.
sourcepub(super) fn fetch(
&self,
color: HostColor,
transports: &[String],
transport_mixing: bool,
) -> Vec<(Url, u64)>
pub(super) fn fetch( &self, color: HostColor, transports: &[String], transport_mixing: bool, ) -> Vec<(Url, u64)>
Fetch addresses that match the provided transports or acceptable mixed transports. Will return an empty Vector if no such addresses were found.
sourcefn fetch_with_schemes(
&self,
color: usize,
schemes: &[String],
limit: Option<usize>,
) -> Vec<(Url, u64)>
fn fetch_with_schemes( &self, color: usize, schemes: &[String], limit: Option<usize>, ) -> Vec<(Url, u64)>
Get up to limit peers that match the given transport schemes from a hostlist. If limit was not provided, return all matching peers.
sourcefn fetch_excluding_schemes(
&self,
color: usize,
schemes: &[String],
limit: Option<usize>,
) -> Vec<(Url, u64)>
fn fetch_excluding_schemes( &self, color: usize, schemes: &[String], limit: Option<usize>, ) -> Vec<(Url, u64)>
Get up to limit peers that don’t match the given transport schemes from a hostlist. If limit was not provided, return all matching peers.
sourcepub(super) fn fetch_random_with_schemes(
&self,
color: HostColor,
schemes: &[String],
) -> Option<((Url, u64), usize)>
pub(super) fn fetch_random_with_schemes( &self, color: HostColor, schemes: &[String], ) -> Option<((Url, u64), usize)>
Get a random peer from a hostlist that matches the given transport schemes.
sourcepub(super) fn fetch_n_random(&self, color: HostColor, n: u32) -> Vec<(Url, u64)>
pub(super) fn fetch_n_random(&self, color: HostColor, n: u32) -> Vec<(Url, u64)>
Get up to n random peers. Schemes are not taken into account.
sourcepub(super) fn fetch_n_random_with_schemes(
&self,
color: HostColor,
schemes: &[String],
n: u32,
) -> Vec<(Url, u64)>
pub(super) fn fetch_n_random_with_schemes( &self, color: HostColor, schemes: &[String], n: u32, ) -> Vec<(Url, u64)>
Get up to n random peers that match the given transport schemes.
sourcepub(super) fn fetch_n_random_excluding_schemes(
&self,
color: HostColor,
schemes: &[String],
n: u32,
) -> Vec<(Url, u64)>
pub(super) fn fetch_n_random_excluding_schemes( &self, color: HostColor, schemes: &[String], n: u32, ) -> Vec<(Url, u64)>
Get up to n random peers that don’t match the given transport schemes from a hostlist.
sourcepub fn remove_if_exists(&self, color: HostColor, addr: &Url)
pub fn remove_if_exists(&self, color: HostColor, addr: &Url)
Remove an entry from a hostlist if it exists.
sourcepub fn get_index_at_addr(&self, color: usize, addr: Url) -> Option<usize>
pub fn get_index_at_addr(&self, color: usize, addr: Url) -> Option<usize>
Get the index for a given addr on a hostlist.
sourcepub fn get_last_seen(&self, color: usize, addr: &Url) -> Option<u64>
pub fn get_last_seen(&self, color: usize, addr: &Url) -> Option<u64>
Get the last_seen field for a given entry on a hostlist.
sourcefn sort_by_last_seen(&self, color: usize)
fn sort_by_last_seen(&self, color: usize)
Sort a hostlist by last_seen.
Auto Trait Implementations§
impl !Freeze for HostContainer
impl RefUnwindSafe for HostContainer
impl Send for HostContainer
impl Sync for HostContainer
impl Unpin for HostContainer
impl UnwindSafe for HostContainer
Blanket Implementations§
§impl<T> ArchivePointee for T
impl<T> ArchivePointee for T
§type ArchivedMetadata = ()
type ArchivedMetadata = ()
§fn pointer_metadata(
_: &<T as ArchivePointee>::ArchivedMetadata,
) -> <T as Pointee>::Metadata
fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata, ) -> <T as Pointee>::Metadata
§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
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<T> Conv for T
impl<T> Conv for T
§impl<F, W, T, D> Deserialize<With<T, W>, D> for F
impl<F, W, T, D> Deserialize<With<T, W>, D> for F
§fn deserialize(
&self,
deserializer: &mut D,
) -> Result<With<T, W>, <D as Fallible>::Error>
fn deserialize( &self, deserializer: &mut D, ) -> Result<With<T, W>, <D as Fallible>::Error>
§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.§impl<T> DowncastSync for T
impl<T> DowncastSync 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> 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> LayoutRaw for T
impl<T> LayoutRaw for T
§fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>
fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>
§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> 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.