Expand description
BridgeDescMgr - downloads and caches bridgesβ router descriptors
Re-exportsΒ§
use std::borrow::Cow;πuse std::cmp::Ordering;πuse std::collections::BinaryHeap;πuse std::collections::HashMap;πuse std::collections::HashSet;πuse std::collections::VecDeque;πuse std::fmt;πuse std::fmt::Debug;πuse std::fmt::Debug;πuse std::fmt::Display;πuse std::num::NonZeroU8;πuse std::panic::AssertUnwindSafe;πuse std::sync::Arc;πuse std::sync::Mutex;πuse std::sync::MutexGuard;πuse std::sync::Weak;πuse async_trait::async_trait;πuse derive_more::Deref;πuse derive_more::DerefMut;πuse educe::Educe;πuse futures::FutureExt;πuse futures::future;πuse futures::select;πuse futures::stream::BoxStream;πuse futures::stream::StreamExt;πuse futures::task::SpawnError;πuse tracing::debug;πuse tracing::info;πuse tracing::trace;πuse safelog::sensitive;πuse tor_basic_utils::retry::RetryDelay;πuse tor_checkable::SelfSigned;πuse tor_checkable::TimeBound;πuse tor_circmgr::CircMgr;πuse tor_error::AbsRetryTime;πuse tor_error::HasRetryTime;πuse tor_error::RetryTime;πuse tor_error::ErrorKind;πuse tor_error::HasKind;πuse tor_error::error_report;πuse tor_error::internal;πuse tor_guardmgr::bridge::BridgeConfig;πuse tor_guardmgr::bridge::BridgeDesc;πuse tor_guardmgr::bridge::BridgeDescError;πuse tor_guardmgr::bridge::BridgeDescEvent;πuse tor_guardmgr::bridge::BridgeDescList;πuse tor_guardmgr::bridge::BridgeDescProvider;πuse tor_netdoc::doc::routerdesc::RouterDesc;πuse tor_rtcompat::Runtime;πuse tor_rtcompat::SpawnExt as _;πuse web_time_compat::Duration;πuse web_time_compat::Instant;πuse web_time_compat::SystemTime;πuse crate::event::FlagPublisher;πuse crate::storage::CachedBridgeDescriptor;πuse crate::DirMgrStore;πuse crate::DynStore;π
ModulesΒ§
- mockable π
- Private module which seals
Mockableby containingMockableAPI
StructsΒ§
- Bridge
Desc Download Config - Configuration for the
BridgeDescMgr - Bridge
Desc Mgr - Downloader and cache for bridgesβ router descriptors
- Downloaded π
- If download was successful, what we obtained
- Join
Handle π - Dummy task join handle
- Manager π
- The actual manager.
- Queued
Entry π - Entry in
queued - Refetch
Entry π - Entry in one of the
*_schedules - Running
Info π - Value of the entry in
running - State π
- State: our downloaded descriptors (cache), and records of what weβre doing
- State
Guard π - Writeable reference to
State, entitling the holder to disrupt liveness properties.
EnumsΒ§
- Dormancy
- Active vs dormant state, as far as the bridge descriptor manager is concerned
- Error
- An error which occurred trying to obtain the descriptor for a particular bridge
- Startup
Error - Error which occurs during bridge descriptor manager startup
TraitsΒ§
- Mockable
- Mockable internal methods for within the
BridgeDescMgr
FunctionsΒ§
- process_
document π - Processes and analyses a textual descriptor document into a
Downloaded - timeout_
task π - Task which waits for the timeout, and requeues bridges that need to be refetched
Type AliasesΒ§
- Bridge
Key π - The key we use in all our data structures