Struct Backoff 

#[non_exhaustive]
pub struct Backoff {
    pub initial: Duration,
    pub multiplier: u32,
    pub max: Duration,
    pub timeout: Duration,
}

Exponential backoff configuration for reconnection attempts.

This decides how long to wait between reconnect attempts and when to give up. The delays carry jitter, so a fleet knocked offline together doesn’t reconnect in lockstep.

timeout is what ends a hopeless loop: every failure rides the same backoff, and the short default budget is what surfaces a broken target instead of hiding it. The only failures short-circuited are answers a server actually gave (an auth rejection, or a CONNECT status that isn’t an invitation to retry). A zero timeout removes the backstop, so it belongs only where an unattended process must outlive an outage of any length.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

initial: Duration

Initial delay before first reconnect attempt.

multiplier: u32

Multiplier applied to delay after each failure.

max: Duration

Maximum delay between reconnect attempts.

timeout: Duration

Maximum time to spend retrying before giving up. Resets after a stable connection (one that outlives the initial backoff), so a flapping session that reconnects then immediately drops still counts toward the timeout. Set to 0 for unlimited retries.

Implementations

impl Backoff

pub fn linger(&self) -> Duration

How long broadcasts fed by a reconnecting session should outlive a session drop (see moq_net::origin::Info::linger): slightly past the give-up timeout, so when the loop does give up its error surfaces before the broadcasts tear down. A zero timeout retries forever, so the broadcasts linger forever too.

Trait Implementations

impl Args for Backoff

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Clone for Backoff

fn clone(&self) -> Backoff

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Backoff

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Backoff

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Backoff

where Backoff: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FromArgMatches for Backoff

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Serialize for Backoff

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.