Skip to main content

ClientConfig

Struct ClientConfig 

Source
pub struct ClientConfig {
    pub address_family: AddressFamily,
    pub socket: SocketConfig,
    pub request: SessionRequest,
    pub open: OpenPolicy,
    pub auth: Authentication,
    pub probe_timeout: Duration,
    pub max_pending_probes: usize,
}
Expand description

Configuration for opening and running an IRTT client session.

This type describes both the protocol parameters sent in the IRTT open request and the local client behavior used to drive the UDP socket. Values that are negotiated by the server are available after opening the session through NegotiationResult.

§Example

Configure a finite run with larger probes and accept documented server restrictions. Use duration: None for continuous mode, or RunMode::NoTest for negotiation without probes.

use std::time::Duration;

use irtt_client::{ClientConfig, NegotiationPolicy, OpenPolicy, SessionRequest};

let config = ClientConfig {
    request: SessionRequest {
        duration: Some(Duration::from_secs(10)),
        interval: Duration::from_millis(250),
        length: 1200,
        ..SessionRequest::default()
    },
    open: OpenPolicy {
        negotiation: NegotiationPolicy::Loose,
        ..OpenPolicy::default()
    },
    ..ClientConfig::default()
};

assert_eq!(config.request.duration, Some(Duration::from_secs(10)));
assert_eq!(config.request.interval, Duration::from_millis(250));
assert_eq!(config.request.length, 1200);

Fields§

§address_family: AddressFamily

Remote address families allowed during resolution and socket creation.

§socket: SocketConfig

Local UDP socket properties.

§request: SessionRequest

Protocol and session values requested from the server.

§open: OpenPolicy

Open retry timeouts and negotiation policy.

§auth: Authentication

Concrete authentication for open, echo, and close packets.

HMAC peers must use the same key. An empty HMAC key remains authenticated.

§probe_timeout: Duration

Time after sending a probe before the client reports it as lost.

This timeout is local client behavior; it is not negotiated with the server. It must be greater than zero.

§max_pending_probes: usize

Maximum number of probes tracked as pending/timed-out/completed.

This bounds memory used for reply classification and must be greater than zero. A very small value can reject sends when replies are still outstanding.

Trait Implementations§

Source§

impl Clone for ClientConfig

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ClientConfig

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for ClientConfig

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Eq for ClientConfig

Source§

impl PartialEq for ClientConfig

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for ClientConfig

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> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

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

Source§

type Error = !

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

fn try_from(value: U) -> Result<T, !>

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.