Struct Retry 

pub struct Retry {
    pub max_attempts: u32,
    pub backoff: Backoff,
}

Retry configuration for SNMP requests.

Controls how the client handles timeouts on UDP transports. TCP transports ignore timeout retry configuration since the transport layer handles reliability. SNMPv3 protocol correction is separate from timeout retry policy: one authenticated time-window correction remains available with Retry::none and on reliable transports.

Each SNMPv3 timeout transmission uses a fresh outer msgID while retaining the PDU request-id, and a response to any transmission in the current exchange may correlate. Stable request-id reuse matches deployed stacks but deliberately deviates from RFC 3414 Section 11.1. A protocol correction uses fresh message and PDU IDs and resets that acceptance window.

Examples

use async_snmp::Retry;
use std::time::Duration;

// No retries
let retry = Retry::none();

// Fixed delay between retries
let retry = Retry::fixed(3, Duration::from_millis(200));

// Exponential backoff with jitter (1s, 2s, 4s, 5s, 5s)
let retry = Retry::exponential(5)
    .max_delay(Duration::from_secs(5))
    .jitter(0.25)
    .build();

Fields

max_attempts: u32

Maximum number of retry attempts (0 = no retries, request sent once)

backoff: Backoff

Backoff strategy between retries

Implementations

impl Retry

pub fn none() -> Self

No retries - request is sent once and fails on timeout.

pub fn fixed(attempts: u32, delay: Duration) -> Self

Fixed delay between retries.

Arguments

• attempts - Maximum number of retry attempts
• delay - Fixed delay before each retry

pub fn exponential(attempts: u32) -> RetryBuilder

Start building an exponential backoff retry configuration.

Returns a RetryBuilder for configuring the backoff parameters.

Arguments

• attempts - Maximum number of retry attempts

Example

use async_snmp::Retry;
use std::time::Duration;

let retry = Retry::exponential(5)
    .max_delay(Duration::from_secs(5))
    .jitter(0.25)
    .build();

pub fn compute_delay(&self, attempt: u32) -> Duration

Compute the delay before the next retry attempt.

Returns Duration::ZERO for Backoff::None.

Trait Implementations

impl Clone for Retry

fn clone(&self) -> Retry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Retry

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

Formats the value using the given formatter.

impl Default for Retry

fn default() -> Self

Default: 3 retries with 1-second fixed delay between attempts.

impl From<RetryBuilder> for Retry

fn from(builder: RetryBuilder) -> Self

Converts to this type from the input type.