Struct CachingPathManager 

pub struct CachingPathManager<F: PathFetcher = PathFetcherImpl> { /* private fields */ }

Active path manager that runs as a background task

Implementations

impl<F: PathFetcher + Send + Sync + 'static> CachingPathManager<F>

pub fn start(path_strategy: PathStrategy, fetcher: F) -> Self

Create and start an active path manager with automatic task management. The background task is spawned internally and will be cancelled when the manager is dropped. This is the recommended method for most users.

pub fn start_future( selection: PathStrategy, fetcher: F, cancellation_token: CancellationToken, ) -> (Self, impl Future<Output = ()>)

Create the manager and task future.

pub fn try_cached_path( &self, src: IsdAsn, dst: IsdAsn, now: DateTime<Utc>, ) -> Result<Option<Path<Bytes>>>

Returns a cached path if it is not expired.

Trait Implementations

impl<F: PathFetcher> Drop for CachingPathManager<F>

fn drop(&mut self)

Executes the destructor for this type.

impl<F: PathFetcher + Send + Sync + 'static> PathManager for CachingPathManager<F>

fn path_wait( &self, src: IsdAsn, dst: IsdAsn, now: DateTime<Utc>, ) -> impl ResFut<'_, Path<Bytes>, PathWaitError>

Returns a path to the destination from the path cache or requests a new path from the SCION Control Plane.

impl<F: PathFetcher + Send + Sync + 'static> PathPrefetcher for CachingPathManager<F>

fn prefetch_path(&self, src: IsdAsn, dst: IsdAsn)

Prefetch a paths for the given source and destination.

impl<F: PathFetcher + Send + Sync + 'static> SyncPathManager for CachingPathManager<F>

fn try_cached_path( &self, src: IsdAsn, dst: IsdAsn, now: DateTime<Utc>, ) -> Result<Option<Path<Bytes>>>

Returns a cached path if it is not expired or prefetches it if it is not in the cache. If the path is not in the cache, it returns Ok(None). If the cache is locked an io error WouldBlock is returned.

fn register_path( &self, src: IsdAsn, dst: IsdAsn, now: DateTime<Utc>, path: Path<Bytes>, )

Add a path to the path cache. This can be used to register reverse paths.