Struct libafl::feedbacks::map::MapFeedback

pub struct MapFeedback<I, N, O, R, S, T> where
    T: PartialEq + Default + Copy + 'static + Serialize + DeserializeOwned + Debug,
    R: Reducer<T>,
    O: MapObserver<Entry = T>,
    for<'it> O: AsIter<'it, Item = T>,
    N: IsNovel<T>,
    S: HasNamedMetadata, { /* private fields */ }

The most common AFL-like feedback type

Implementations

impl<I, N, O, R, S, T> MapFeedback<I, N, O, R, S, T> where
    T: PartialEq + Default + Copy + 'static + Serialize + DeserializeOwned + Debug,
    R: Reducer<T>,
    O: MapObserver<Entry = T>,
    for<'it> O: AsIter<'it, Item = T>,
    N: IsNovel<T>,
    I: Input,
    S: HasNamedMetadata + HasClientPerfMonitor + Debug, 

pub fn new(map_observer: &O) -> Self

Create new MapFeedback

pub fn new_tracking(
    map_observer: &O,
    track_indexes: bool,
    track_novelties: bool
) -> Self

Create new MapFeedback specifying if it must track indexes of used entries and/or novelties

pub fn with_names(name: &'static str, observer_name: &'static str) -> Self

Create new MapFeedback

pub fn with_names_tracking(
    name: &'static str,
    observer_name: &'static str,
    track_indexes: bool,
    track_novelties: bool
) -> Self

Create new MapFeedback specifying if it must track indexes of used entries and/or novelties

Trait Implementations

impl<I: Clone, N: Clone, O: Clone, R: Clone, S: Clone, T: Clone> Clone for MapFeedback<I, N, O, R, S, T> where
    T: PartialEq + Default + Copy + 'static + Serialize + DeserializeOwned + Debug,
    R: Reducer<T>,
    O: MapObserver<Entry = T>,
    for<'it> O: AsIter<'it, Item = T>,
    N: IsNovel<T>,
    S: HasNamedMetadata, 

fn clone(&self) -> MapFeedback<I, N, O, R, S, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<I: Debug, N: Debug, O: Debug, R: Debug, S: Debug, T: Debug> Debug for MapFeedback<I, N, O, R, S, T> where
    T: PartialEq + Default + Copy + 'static + Serialize + DeserializeOwned + Debug,
    R: Reducer<T>,
    O: MapObserver<Entry = T>,
    for<'it> O: AsIter<'it, Item = T>,
    N: IsNovel<T>,
    S: HasNamedMetadata, 

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

Formats the value using the given formatter.

impl<I, O, S> Feedback<I, S> for MapFeedback<I, DifferentIsNovel, O, MaxReducer, S, u8> where
    O: MapObserver<Entry = u8> + AsSlice<u8>,
    for<'it> O: AsIter<'it, Item = u8>,
    I: Input,
    S: HasNamedMetadata + HasClientPerfMonitor + Debug, 

Specialize for the common coverage map size, maximization of u8s

fn is_interesting<EM, OT>(
    &mut self,
    state: &mut S,
    manager: &mut EM,
    _input: &I,
    observers: &OT,
    _exit_kind: &ExitKind
) -> Result<bool, Error> where
    EM: EventFirer<I>,
    OT: ObserversTuple<I, S>, 

is_interesting return if an input is worth the addition to the corpus

fn init_state(&mut self, _state: &mut S) -> Result<(), Error>

Initializes the feedback state. This method is called after that the State is created.

fn append_metadata(
    &mut self,
    _state: &mut S,
    _testcase: &mut Testcase<I>
) -> Result<(), Error>

Append to the testcase the generated metadata in case of a new corpus item

fn discard_metadata(&mut self, _state: &mut S, _input: &I) -> Result<(), Error>

Discard the stored metadata in case that the testcase is not added to the corpus

impl<I, N, O, R, S, T> Feedback<I, S> for MapFeedback<I, N, O, R, S, T> where
    T: PartialEq + Default + Copy + 'static + Serialize + DeserializeOwned + Debug,
    R: Reducer<T>,
    O: MapObserver<Entry = T>,
    for<'it> O: AsIter<'it, Item = T>,
    N: IsNovel<T>,
    I: Input,
    S: HasNamedMetadata + HasClientPerfMonitor + Debug, 

fn discard_metadata(&mut self, _state: &mut S, _input: &I) -> Result<(), Error>

Discard the stored metadata in case that the testcase is not added to the corpus

fn init_state(&mut self, state: &mut S) -> Result<(), Error>

Initializes the feedback state. This method is called after that the State is created.

default fn is_interesting<EM, OT>(
    &mut self,
    state: &mut S,
    manager: &mut EM,
    input: &I,
    observers: &OT,
    exit_kind: &ExitKind
) -> Result<bool, Error> where
    EM: EventFirer<I>,
    OT: ObserversTuple<I, S>, 

is_interesting return if an input is worth the addition to the corpus

fn append_metadata(
    &mut self,
    _state: &mut S,
    testcase: &mut Testcase<I>
) -> Result<(), Error>

Append to the testcase the generated metadata in case of a new corpus item

impl<I, N, O, R, S, T> HasObserverName for MapFeedback<I, N, O, R, S, T> where
    T: PartialEq + Default + Copy + 'static + Serialize + DeserializeOwned + Debug,
    R: Reducer<T>,
    N: IsNovel<T>,
    O: MapObserver<Entry = T>,
    for<'it> O: AsIter<'it, Item = T>,
    S: HasNamedMetadata, 

fn observer_name(&self) -> &str

The name associated with the observer

impl<I, N, O, R, S, T> Named for MapFeedback<I, N, O, R, S, T> where
    T: PartialEq + Default + Copy + 'static + Serialize + DeserializeOwned + Debug,
    R: Reducer<T>,
    N: IsNovel<T>,
    O: MapObserver<Entry = T>,
    for<'it> O: AsIter<'it, Item = T>,
    S: HasNamedMetadata, 

fn name(&self) -> &str

Provide the name of this element.