Struct libafl::bolts::llmp::LlmpSender

pub struct LlmpSender<SP> where
    SP: ShMemProvider,  {
    pub id: u32,
    pub last_msg_sent: *const LlmpMsg,
    pub out_maps: Vec<LlmpSharedMap<SP::Mem>>,
    pub keep_pages_forever: bool,
    // some fields omitted
}

Sending end on a (unidirectional) sharedmap channel

Fields

id: u32

ID of this sender.

last_msg_sent: *const LlmpMsg

Ref to the last message this sender sent on the last page. If null, a new page (just) started.

out_maps: Vec<LlmpSharedMap<SP::Mem>>

A vec of page wrappers, each containing an intialized AfShmem

keep_pages_forever: bool

If true, pages will never be pruned. The broker uses this feature. By keeping the message history around, new clients may join at any time in the future.

Implementations

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

An actor on the sending part of the shared map

pub fn new(
    shmem_provider: SP,
    id: u32,
    keep_pages_forever: bool
) -> Result<Self, Error>

Create a new LlmpSender using a given ShMemProvider, and id. If keep_pages_forever is true, ShMem will never be freed. If it is false, the pages will be unmapped once they are full, and have been mapped by at least one LlmpReceiver.

pub unsafe fn reset(&mut self)

Completely reset the current sender map. Afterwards, no receiver should read from it at a different location. This is only useful if all connected llmp parties start over, for example after a crash.

Safety

Only safe if you really really restart the page on everything connected

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

Reattach to a vacant out_map, to with a previous sender stored the information in an env before.

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

Store the info to this sender to env. A new client can reattach to it using LlmpSender::on_existing_from_env().

pub fn await_save_to_unmap_blocking(&self)

Waits for this sender to be save to unmap. If a receiver is involved, this function should always be called.

pub fn save_to_unmap(&self) -> bool

If we are allowed to unmap this client

pub fn on_existing_map(
    shmem_provider: SP,
    current_out_map: SP::Mem,
    last_msg_sent_offset: Option<u64>
) -> Result<Self, Error>

Reattach to a vacant out_map. It is essential, that the receiver (or someone else) keeps a pointer to this map else reattach will get a new, empty page, from the OS, or fail.

pub fn alloc_next(&mut self, buf_len: usize) -> Result<*mut LlmpMsg, Error>

Allocates the next space on this sender page

pub unsafe fn cancel_send(&mut self, msg: *mut LlmpMsg)

Cancel send of the next message, this allows us to allocate a new message without sending this one.

Safety

They msg pointer may no longer be used after cancel_send

pub unsafe fn shrink_alloced(
    &mut self,
    msg: *mut LlmpMsg,
    shrinked_len: usize
) -> Result<(), Error>

Shrinks the allocated LlmpMsg to a given size.

Safety

The msg pointer will be dereferenced, if it’s not null.

pub fn send_buf(&mut self, tag: Tag, buf: &[u8]) -> Result<(), Error>

Allocates a message of the given size, tags it, and sends it off.

pub fn send_buf_with_flags(
    &mut self,
    tag: Tag,
    flags: Flags,
    buf: &[u8]
) -> Result<(), Error>

Send a buf with the given flags.

pub fn describe(&self) -> Result<LlmpDescription, Error>

Describe this LlmpClient in a way that it can be restored later, using Self::on_existing_from_description.

pub fn on_existing_from_description(
    shmem_provider: SP,
    description: &LlmpDescription
) -> Result<Self, Error>

Create this client on an existing map from the given description. Acquired with [self.describe].

Trait Implementations

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

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

Formats the value using the given formatter.