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 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 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<AgentDescriptor> for AgentDescriptor

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

This method tests for self and other values to be equal, and is used by ==.

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

This method 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 StructuralEq for AgentDescriptor

impl StructuralPartialEq for AgentDescriptor