Skip to main content

EntropyReceiver

Struct EntropyReceiver 

Source
pub struct EntropyReceiver { /* private fields */ }
Expand description

Entropy receiver driver.

§Examples

use std::path::PathBuf;
use std::sync::Arc;
use dynomite::entropy::{
    receive::RedisReplaySink, EntropyConfig, EntropyReceiver,
};

let cfg = EntropyConfig {
    key_file: PathBuf::from("conf/recon_key.pem"),
    iv_file: PathBuf::from("conf/recon_iv.pem"),
    listen_addr: "127.0.0.1:8105".parse().unwrap(),
    send_addr: None,
    peer_endpoint: "127.0.0.1:8105".parse().unwrap(),
    buffer_size: 16 * 1024,
    header_size: 1024,
    encrypt: true,
};
let sink = Arc::new(RedisReplaySink::default());
let handle = EntropyReceiver::run(cfg, sink).await.unwrap();
handle.abort();

Implementations§

Source§

impl EntropyReceiver

Source

pub async fn run( cfg: EntropyConfig, sink: BoxedSnapshotSink, ) -> EntropyResult<JoinHandle<EntropyResult<()>>>

Bind a receiver to cfg.listen_addr and spawn the accept loop on a tokio task.

Each accepted connection is handled in line on the same task, mirroring the reference engine’s single-threaded entropy loop. The returned handle resolves to Ok(()) only after the listener is shut down (e.g. by aborting the task) or to an error if the bind fails.

§Errors

Forwards anything from key loading or socket bind.

Source

pub async fn bind( cfg: EntropyConfig, sink: BoxedSnapshotSink, ) -> EntropyResult<Self>

Bind without spawning. Used by tests that want to drive the accept loop on the caller’s task.

§Errors

Forwards anything from key loading or socket bind.

Source

pub fn local_addr(&self) -> Result<SocketAddr>

Local address the receiver is bound to. Useful for tests that bind to :0 and then dial the kernel-assigned port.

§Errors

Forwarded from the underlying socket call.

Source

pub async fn accept_one(self) -> EntropyResult<usize>

Accept exactly one connection, process it, and return.

§Errors

Forwards I/O, protocol, and crypto errors from the worker.

Source

pub async fn accept_loop(self) -> EntropyResult<()>

Accept connections until the task is aborted.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> FutureExt for T

Source§

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
Source§

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more
Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,