Struct puffin::agent::AgentDescriptor

pub struct AgentDescriptor {
    pub name: AgentName,
    pub tls_version: TLSVersion,
    pub typ: AgentType,
    pub try_reuse: bool,
    pub client_authentication: bool,
    pub server_authentication: bool,
}

AgentDescriptors act like a blueprint to spawn Agents with a corresponding server or client role and a specific TLs version. Essentially they are an Agent without a stream.

The difference between an AgentDescriptor and a crate::put::PutDescriptor is that values of the AgentDescriptor are required for seed traces to succeed. They are the same for every invocation of the seed. Values in the crate::put::PutDescriptor are supposed to differ between invocations.

Fields

name: AgentName

tls_version: TLSVersion

typ: AgentType

Whether the agent which holds this descriptor is a server.

try_reuse: bool

Whether we want to try to reuse a previous agent. This is needed for TLS session resumption as openssl agents rotate ticket keys if they are recreated.

client_authentication: bool

If agent is a server: Make client auth. a requirement. If agent is a client: Send a static certificate.

Default: false

server_authentication: bool

If agent is a server: No effect, servers always send certificates in TLS. If agent is a client: Make server auth. a requirement.

Default: true

Implementations

impl AgentDescriptor

pub fn new_reusable_server(name: AgentName, tls_version: TLSVersion) -> Self

pub fn new_reusable_client(name: AgentName, tls_version: TLSVersion) -> Self

pub fn new_server(name: AgentName, tls_version: TLSVersion) -> Self

pub fn new_client(name: AgentName, tls_version: TLSVersion) -> Self

Trait Implementations

impl Clone for AgentDescriptor

fn clone(&self) -> AgentDescriptor

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for AgentDescriptor

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

Formats the value using the given formatter.

impl Default for AgentDescriptor

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AgentDescriptor

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for AgentDescriptor

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for AgentDescriptor

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AgentDescriptor

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for AgentDescriptor

impl StructuralPartialEq for AgentDescriptor