Struct puffin::trace::Trace

pub struct Trace<PT: ProtocolTypes> {
    pub descriptors: Vec<AgentDescriptor>,
    pub steps: Vec<Step<PT>>,
    pub prior_traces: Vec<Trace<PT>>,
}

Fields

descriptors: Vec<AgentDescriptor>

steps: Vec<Step<PT>>

prior_traces: Vec<Trace<PT>>

Implementations

impl<PT: ProtocolTypes> Trace<PT>

pub fn dot_graph(&self, tree_mode: bool) -> String

pub fn dot_subgraphs(&self, tree_mode: bool) -> Vec<String>

impl<PT: ProtocolTypes> Trace<PT>

pub fn count_functions_by_name(&self, find_name: &'static str) -> usize

pub fn count_functions(&self) -> usize

pub fn write_plots(&self, i: u16)

impl<PT: ProtocolTypes> Trace<PT>

A Trace consists of several Steps. Each has either a OutputAction or an InputAction. Each Steps references an Agent by name. Furthermore, a trace also has a list of AgentDescriptors which 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.

fn spawn_agents<PB: ProtocolBehavior>( &self, ctx: &mut TraceContext<PB>, ) -> Result<(), Error>

pub fn execute<PB>(&self, ctx: &mut TraceContext<PB>) -> Result<(), Error>

where PB: ProtocolBehavior<ProtocolTypes = PT>,

pub fn serialize_postcard(&self) -> Result<Vec<u8>, Error>

pub fn deserialize_postcard(slice: &[u8]) -> Result<Trace<PT>, Error>

Trait Implementations

impl<PT: ProtocolTypes> AsRef<Trace<PT>> for Trace<PT>

fn as_ref(&self) -> &Trace<PT>

Converts this type into a shared reference of the (usually inferred) input type.

impl<PT: Clone + ProtocolTypes> Clone for Trace<PT>

fn clone(&self) -> Trace<PT>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<PT: ProtocolTypes> Debug for Trace<PT>

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

Formats the value using the given formatter.

impl<'de, PT> Deserialize<'de> for Trace<PT>

where PT: ProtocolTypes,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<PT: ProtocolTypes> Display for Trace<PT>

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

Formats the value using the given formatter.

impl<PT: ProtocolTypes> HasLen for Trace<PT>

fn len(&self) -> usize

The length

fn is_empty(&self) -> bool

Returns true if it has no elements.

impl<PT: Hash + ProtocolTypes> Hash for Trace<PT>

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<PT: ProtocolTypes> Input for Trace<PT>

fn generate_name(&self, _idx: usize) -> String

Generate a name for this input, the user is responsible for making each name of testcase unique.

fn to_file<P>(&self, path: P) -> Result<(), Error>

where P: AsRef<Path>,

Write this input to the file

fn from_file<P>(path: P) -> Result<Self, Error>

where P: AsRef<Path>,

Load the content of this input from a file

fn wrapped_as_testcase(&mut self)

An hook executed if the input is stored as Testcase

impl<S, PT: ProtocolTypes> Mutator<Trace<PT>, S> for GenerateMutator<S, PT>

where S: HasRand,

fn mutate( &mut self, state: &mut S, trace: &mut Trace<PT>, _stage_idx: i32, ) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec( &mut self, _state: &mut S, _stage_idx: i32, _corpus_idx: Option<CorpusId>, ) -> Result<(), Error>

Post-process given the outcome of the execution

impl<S, PT: ProtocolTypes> Mutator<Trace<PT>, S> for RemoveAndLiftMutator<S>

where S: HasRand,

fn mutate( &mut self, state: &mut S, trace: &mut Trace<PT>, _stage_idx: i32, ) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec( &mut self, _state: &mut S, _stage_idx: i32, _corpus_idx: Option<CorpusId>, ) -> Result<(), Error>

Post-process given the outcome of the execution

impl<S, PT: ProtocolTypes> Mutator<Trace<PT>, S> for RepeatMutator<S>

where S: HasRand,

fn mutate( &mut self, state: &mut S, trace: &mut Trace<PT>, _stage_idx: i32, ) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec( &mut self, _state: &mut S, _stage_idx: i32, _corpus_idx: Option<CorpusId>, ) -> Result<(), Error>

Post-process given the outcome of the execution

impl<S, PT: ProtocolTypes> Mutator<Trace<PT>, S> for ReplaceMatchMutator<S, PT>

where S: HasRand,

fn mutate( &mut self, state: &mut S, trace: &mut Trace<PT>, _stage_idx: i32, ) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec( &mut self, _state: &mut S, _stage_idx: i32, _corpus_idx: Option<CorpusId>, ) -> Result<(), Error>

Post-process given the outcome of the execution

impl<S, PT: ProtocolTypes> Mutator<Trace<PT>, S> for ReplaceReuseMutator<S>

where S: HasRand,

fn mutate( &mut self, state: &mut S, trace: &mut Trace<PT>, _stage_idx: i32, ) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec( &mut self, _state: &mut S, _stage_idx: i32, _corpus_idx: Option<CorpusId>, ) -> Result<(), Error>

Post-process given the outcome of the execution

impl<S, PT: ProtocolTypes> Mutator<Trace<PT>, S> for SkipMutator<S>

where S: HasRand,

fn mutate( &mut self, state: &mut S, trace: &mut Trace<PT>, _stage_idx: i32, ) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec( &mut self, _state: &mut S, _stage_idx: i32, _corpus_idx: Option<CorpusId>, ) -> Result<(), Error>

Post-process given the outcome of the execution

impl<S, PT: ProtocolTypes> Mutator<Trace<PT>, S> for SwapMutator<S>

where S: HasRand,

fn mutate( &mut self, state: &mut S, trace: &mut Trace<PT>, _stage_idx: i32, ) -> Result<MutationResult, Error>

Mutate a given input

fn post_exec( &mut self, _state: &mut S, _stage_idx: i32, _corpus_idx: Option<CorpusId>, ) -> Result<(), Error>

Post-process given the outcome of the execution

impl<PT> Serialize for Trace<PT>

where PT: ProtocolTypes,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.