Struct libafl::bolts::staterestore::StateRestorer

pub struct StateRestorer<SP> where
    SP: ShMemProvider,  { /* fields omitted */ }

A StateRestorer saves and restores bytes to a shared map. If the state gets larger than the preallocated ShMem shared map, it will instead write to disk, and store the file name into the map. Writing to StateRestorer multiple times is not allowed.

Implementations

impl<SP> StateRestorer<SP> where
    SP: ShMemProvider, 

pub fn mapsize(&self) -> usize

Get the map size backing this StateRestorer.

pub fn write_to_env(&self, env_name: &str) -> Result<(), Error>

Writes this StateRestorer to env variable, to be restored later

pub fn from_env(shmem_provider: &mut SP, env_name: &str) -> Result<Self, Error>

Create a StateRestorer from env variable name

pub fn new(shmem: SP::Mem) -> Self

Create a new StateRestorer.

pub fn save<S>(&mut self, state: &S) -> Result<(), Error> where
    S: Serialize, 

Saves a state to the connected ShMem, or a tmpfile, if its serialized size get too large.

pub fn reset(&mut self)

Reset this StateRestorer to an empty state.

pub fn has_content(&self) -> bool

Returns true, if this StateRestorer has contents.

pub fn restore<S>(&self) -> Result<Option<S>, Error> where
    S: DeserializeOwned, 

Restores the contents saved in this StateRestorer, if any are availiable. Can only be read once.

Trait Implementations

impl<SP: Clone> Clone for StateRestorer<SP> where
    SP: ShMemProvider,
    SP::Mem: Clone, 

fn clone(&self) -> StateRestorer<SP>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<SP: Debug> Debug for StateRestorer<SP> where
    SP: ShMemProvider,
    SP::Mem: Debug, 

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

Formats the value using the given formatter.