Trait libafl::corpus::Corpus

pub trait Corpus: UsesInput + Serialize + for<'de> Deserialize<'de> {
    // Required methods
    fn count(&self) -> usize;
    fn count_disabled(&self) -> usize;
    fn count_all(&self) -> usize;
    fn add(
        &mut self,
        testcase: Testcase<Self::Input>
    ) -> Result<CorpusId, Error>;
    fn add_disabled(
        &mut self,
        testcase: Testcase<Self::Input>
    ) -> Result<CorpusId, Error>;
    fn replace(
        &mut self,
        idx: CorpusId,
        testcase: Testcase<Self::Input>
    ) -> Result<Testcase<Self::Input>, Error>;
    fn remove(&mut self, id: CorpusId) -> Result<Testcase<Self::Input>, Error>;
    fn get(
        &self,
        id: CorpusId
    ) -> Result<&RefCell<Testcase<Self::Input>>, Error>;
    fn get_from_all(
        &self,
        id: CorpusId
    ) -> Result<&RefCell<Testcase<Self::Input>>, Error>;
    fn current(&self) -> &Option<CorpusId>;
    fn current_mut(&mut self) -> &mut Option<CorpusId>;
    fn next(&self, id: CorpusId) -> Option<CorpusId>;
    fn prev(&self, id: CorpusId) -> Option<CorpusId>;
    fn first(&self) -> Option<CorpusId>;
    fn last(&self) -> Option<CorpusId>;
    fn nth_from_all(&self, nth: usize) -> CorpusId;
    fn load_input_into(
        &self,
        testcase: &mut Testcase<Self::Input>
    ) -> Result<(), Error>;
    fn store_input_from(
        &self,
        testcase: &Testcase<Self::Input>
    ) -> Result<(), Error>;

    // Provided methods
    fn is_empty(&self) -> bool { ... }
    fn ids(&self) -> CorpusIdIterator<'_, Self>  { ... }
    fn nth(&self, nth: usize) -> CorpusId { ... }
    fn cloned_input_for_id(&self, idx: CorpusId) -> Result<Self::Input, Error> { ... }
}

Corpus with all current Testcases, or solutions

Required Methods

fn count(&self) -> usize

Returns the number of all enabled entries

fn count_disabled(&self) -> usize

Returns the number of all disabled entries

fn count_all(&self) -> usize

Returns the number of elements including disabled entries

fn add(&mut self, testcase: Testcase<Self::Input>) -> Result<CorpusId, Error>

Add an enabled testcase to the corpus and return its index

fn add_disabled( &mut self, testcase: Testcase<Self::Input> ) -> Result<CorpusId, Error>

Add a disabled testcase to the corpus and return its index

fn replace( &mut self, idx: CorpusId, testcase: Testcase<Self::Input> ) -> Result<Testcase<Self::Input>, Error>

Replaces the Testcase at the given idx, returning the existing.

fn remove(&mut self, id: CorpusId) -> Result<Testcase<Self::Input>, Error>

Removes an entry from the corpus, returning it if it was present.

fn get(&self, id: CorpusId) -> Result<&RefCell<Testcase<Self::Input>>, Error>

Get by id; considers only enabled testcases

fn get_from_all( &self, id: CorpusId ) -> Result<&RefCell<Testcase<Self::Input>>, Error>

Get by id; considers both enabled and disabled testcases

fn current(&self) -> &Option<CorpusId>

Current testcase scheduled

fn current_mut(&mut self) -> &mut Option<CorpusId>

Current testcase scheduled (mutable)

fn next(&self, id: CorpusId) -> Option<CorpusId>

Get the next corpus id

fn prev(&self, id: CorpusId) -> Option<CorpusId>

Get the prev corpus id

fn first(&self) -> Option<CorpusId>

Get the first inserted corpus id

fn last(&self) -> Option<CorpusId>

Get the last inserted corpus id

fn nth_from_all(&self, nth: usize) -> CorpusId

Get the nth corpus id; considers both enabled and disabled testcases

fn load_input_into( &self, testcase: &mut Testcase<Self::Input> ) -> Result<(), Error>

Method to load the input for this Testcase from persistent storage, if necessary, and if was not already loaded (== Some(input)). After this call, testcase.input() must always return Some(input).

fn store_input_from( &self, testcase: &Testcase<Self::Input> ) -> Result<(), Error>

Method to store the input of this Testcase to persistent storage, if necessary.

Provided Methods

fn is_empty(&self) -> bool

Returns true, if no elements are in this corpus yet

fn ids(&self) -> CorpusIdIterator<'_, Self>

An iterator over very active corpus id

fn nth(&self, nth: usize) -> CorpusId

Get the nth corpus id; considers only enabled testcases

fn cloned_input_for_id(&self, idx: CorpusId) -> Result<Self::Input, Error>

Loads the Input for a given CorpusId from the Corpus, and returns the clone.

Object Safety

This trait is not object safe.

Implementors

impl<I> Corpus for CachedOnDiskCorpus<I>

where I: Input,

impl<I> Corpus for InMemoryCorpus<I>

where I: Input,

impl<I> Corpus for InMemoryOnDiskCorpus<I>

where I: Input,

impl<I> Corpus for NopCorpus<I>

where I: Input,

impl<I> Corpus for OnDiskCorpus<I>

where I: Input,