Struct libafl_bolts::staterestore::StateRestorer

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

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::ShMem) -> 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 send_exiting(&mut self)

When called from a child, informs the restarter/parent process that it should no longer respawn the child.

pub fn wants_to_exit(&self) -> bool

Returns true, if Self::send_exiting was called on this StateRestorer last. This should be checked in the parent before deciding to restore the client.

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 available. Can only be read once.

Trait Implementations

impl<SP> Clone for StateRestorer<SP>

where SP: ShMemProvider + Clone, SP::ShMem: 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 for StateRestorer<SP>

where SP: ShMemProvider + Debug, SP::ShMem: Debug,

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

Formats the value using the given formatter.