Struct puffin::trace::Trace

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

Fields

descriptors: Vec<AgentDescriptor<PT::PUTConfig>>

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.

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

where PB: ProtocolBehavior<ProtocolTypes = PT> + ProtocolBehavior,

pub fn execute_until_step_wrap<PB>( &self, ctx: &mut TraceContext<PB>, stop_at_step: usize, trace_number: &mut usize, ) -> Result<(), Error>

where PB: ProtocolBehavior<ProtocolTypes = PT>,

pub fn execute_until_step<PB>( &self, ctx: &mut TraceContext<PB>, stop_at_step: usize, trace_number: &mut usize, ) -> Result<(), Error>

where PB: ProtocolBehavior<ProtocolTypes = PT>,

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

where PB: ProtocolBehavior<ProtocolTypes = PT>,

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

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

pub fn all_payloads(&self) -> Vec<&Payloads>

pub fn all_payloads_mut(&mut self) -> Vec<&mut Payloads>

pub fn is_symbolic(&self) -> bool

pub fn truncate_at_step(&mut self, after_step: usize)

Remove the steps after (excluding) after_step

pub fn size(&self) -> usize

Size of trace (summing all input sizes, counting one for output)

Trait Implementations

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

fn as_ref(&self) -> &Self

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

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

where PT::PUTConfig: Clone,

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

fn default() -> Self

Returns the “default value” for a type.

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>

where PT::PUTConfig: Hash,

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<'a, S, PB: ProtocolBehavior> Mutator<Trace<<PB as ProtocolBehavior>::ProtocolTypes>, S> for GenerateMutator<'a, S, PB>

where S: HasRand,

fn mutate( &mut self, state: &mut S, trace: &mut Trace<PB::ProtocolTypes>, _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> Mutator<Trace<PT>, S> for BitFlipMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for ByteAddMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for ByteDecMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for ByteFlipMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for ByteIncMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for ByteInterestingMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for ByteNegMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for ByteRandMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for BytesCopyMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for BytesDeleteMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for BytesExpandMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for BytesInsertCopyMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for BytesInsertMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for BytesLargeExpandMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for BytesRandInsertMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for BytesRandSetMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for BytesSetMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for BytesSwapMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for CrossoverInsertMutatorDY<S>

where S: HasCorpus + HasRand + HasMaxSize + UsesInput<Input = Trace<PT>>, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for CrossoverReplaceMutatorDY<S>

where S: HasCorpus + HasRand + HasMaxSize + UsesInput<Input = Trace<PT>>, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for DwordAddMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for DwordInterestingMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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<'a, S, PT: ProtocolTypes, PB> Mutator<Trace<PT>, S> for MakeMessage<'a, PB>

where S: HasRand, PB: ProtocolBehavior<ProtocolTypes = PT>,

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> Mutator<Trace<PT>, S> for QwordAddMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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<'a, S, PT: ProtocolTypes, PB> Mutator<Trace<PT>, S> for ReadMessage<'a, PB>

where S: HasRand, PB: ProtocolBehavior<ProtocolTypes = PT>,

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> Mutator<Trace<PT>, S> for SpliceMutatorDY<S>

where S: HasCorpus + HasRand + HasMaxSize + UsesInput<Input = Trace<PT>>, PT: ProtocolTypes,

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<S, PT> Mutator<Trace<PT>, S> for WordAddMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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> Mutator<Trace<PT>, S> for WordInterestingMutatorDY<S>

where S: HasRand + HasMaxSize, PT: ProtocolTypes,

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.